toki
0ffcb88db0
- Archive provider-resource-admission-ownership milestone/SDD - Align contract: CP-edge wire, runtime refresh, node runtime, OpenAI surface - Update roadmap: phase state, priority queue - Update specs: control-plane ops, OpenAI surface, edge execution, provider pool refresh - Add node runtime supervisor bootstrapping and unit tests - Fix control-plane edge registry handler and http_views - Fix edge model queue admission and long context queue tests
3.4 KiB
3.4 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, 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 |