iop/agent-contract/index.md

Agent Contract Index

읽기 규칙

• 현재 작업이 API, wire protocol, 런타임 호출, event/config schema, 프로젝트 간 또는 내부 프로세스/컴포넌트 간 요청/응답 계약에 닿을 때만 이 문서를 사용한다.
• 매칭되는 계약 문서만 읽는다.
• 계약 문서 경로가 없으면 계약을 추정하지 않고 사용자에게 확인한다.
• 계약 원문은 agent-contract/outer/** 또는 agent-contract/inner/** 한 곳에 둔다.
• docs/, README, rules.md에는 계약 원문을 복제하지 않고 계약 원문 경로만 둔다.

Outer Contracts

id	읽는 조건	원본 경로	path
iop.openai-compatible-api	OpenAI-compatible API, Responses API, Chat Completions, legacy Completions, 오류 envelope/SSE terminal error, model route, model-driven passthrough/normalized routing, provider-pool admission/unavailable error, Codex/CLI workspace, generic authoring metadata, metadata.workspace, metadata.task_id, provider-native OpenAI-compatible extension fields such as chat_template_kwargs	apps/edge/internal/openai/*, packages/go/config/config.go, configs/edge.yaml	agent-contract/outer/openai-compatible-api.md
iop.a2a-json-rpc-api	A2A JSON-RPC API, message/send, tasks/get, tasks/cancel, A2A task state, agent card, a2a.bearer_token, Edge A2A input surface	apps/edge/internal/input/a2a/*, packages/go/config/config.go, configs/edge.yaml	agent-contract/outer/a2a-json-rpc-api.md

Inner Contracts

id	읽는 조건	원본 경로	path
iop.edge-node-runtime-wire	Edge-Node TCP/protobuf, proto-socket transport, Node initial/reconnect supervision, connection generation fencing, RegisterRequest, RegisterResponse, NodeReadyRequest, NodeReadyResponse, RunRequest, RunEvent, ProviderTunnelRequest, ProviderTunnelFrame, CancelRequest, NodeCommandRequest, NodeConfigPayload, NodeConfigRefreshRequest	proto/iop/runtime.proto, apps/edge/internal/transport/*, apps/node/internal/transport/*, apps/node/internal/bootstrap/runtime_supervisor.go, apps/edge/internal/node/mapper.go, apps/node/internal/adapters/config_set.go	agent-contract/inner/edge-node-runtime-wire.md
iop.control-plane-edge-wire	Control Plane-Edge wire, EdgeHelloRequest, EdgeStatusRequest, EdgeStatusResponse, EdgeCommandRequest, EdgeCommandEvent, Edge connection registry, configured offline Node/provider snapshot	proto/iop/control.proto, apps/control-plane/internal/wire/*, apps/edge/internal/controlplane/*	agent-contract/inner/control-plane-edge-wire.md
iop.client-control-plane-wire	Client-Control Plane wire, /client WebSocket, proto-socket WS, ClientHelloRequest, ClientHelloResponse, Flutter client wire	proto/iop/control.proto, apps/control-plane/internal/wire/client.go, apps/client/lib/iop_wire/*	agent-contract/inner/client-control-plane-wire.md
iop.edge-config-runtime-refresh	Edge config schema, configs/edge.yaml, packages/go/config, provider pool, models[], nodes[].providers[], openai.model_routes, config refresh, restart/applied classification	packages/go/config/edge_types.go, packages/go/config/provider_types.go, packages/go/config/load.go, configs/edge.yaml, apps/edge/internal/configrefresh/*, proto/iop/runtime.proto	agent-contract/inner/edge-config-runtime-refresh.md
iop.agent-runtime	Common Agent Runtime, CLI Provider, AgentTaskManager manual start/auto-resume/explicit dependency/isolated dispatch/review/serial integration, workspace guardrail admission, executable InvocationConfinement, agent provider catalog YAML, provider/model/profile discovery/readiness, Provider, ExecutionSpec, RuntimeEvent, run/stream/resume/cancel, terminal exactly-once, status/quota, typed failure codec, and Node runtime bridge	packages/go/agentruntime/*, packages/go/agenttask/*, packages/go/agentguard/*, packages/go/agentworkspace/*, packages/go/agentconfig/*, packages/go/agentprovider/cli/*, packages/go/agentprovider/catalog/*, configs/iop-agent.providers.yaml, apps/node/internal/node/runtime_bridge.go	agent-contract/inner/agent-runtime.md
iop.agent-cli-runtime	Standalone iop-agent host lifecycle; RuntimeConfig, ProjectRegistration, SelectionPolicy, and PreviewRequest; device singleton, host-local checkpoint, opaque recovery locators, and failure budgets; exact-root WorkspaceSnapshot, OverlayWorkspace, executable confinement, ChangeSet, and IntegrationRecord; ProjectLogRecord and IntegrationStatus; and the client-neutral local control boundary: LocalControlEnvelope, LocalControlRequest, LocalControlResponse, LocalControlEvent, LocalControlError, peer authorization, replay, and Flutter/Unity client-process commands (S05-S09, S11, S15, S18-S19)	S05 implementation: packages/go/agentconfig/runtime_config.go, packages/go/agentconfig/watcher.go. S09 implementation: packages/go/agentstate/store.go and packages/go/agenttask/*. S18 implementation: packages/go/agentworkspace/snapshot.go, packages/go/agentworkspace/overlay.go, and packages/go/agentworkspace/confinement*.go. Shared runtime semantics remain owned by iop.agent-runtime; remaining standalone host paths are added by S06-S08/S11/S15/S19. Design input: agent-roadmap/sdd/automation-runtime-bridge/iop-agent-cli-runtime/SDD.md	agent-contract/inner/iop-agent-cli-runtime.md