toki
51de0e259e
- edge-node-runtime-wire 계약 스키마 동기화 - edge-node-execution, provider-pool-config-refresh 스펙 갱신 - provider-resource-admission-ownership-alignment 마일스톤 상태 동기화 - control-plane-portal-ops phase 신규 추가 (multi-edge-operations) - e2e-smoke: 재연결 테스트 플로우, bind timeout, reconnect 설정 반영
3.1 KiB
3.1 KiB
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, model route, model-driven passthrough/normalized routing, 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, 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/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 |
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/config.go, configs/edge.yaml, apps/edge/internal/configrefresh/*, proto/iop/runtime.proto |
agent-contract/inner/edge-config-runtime-refresh.md |