8629ac709b
## Phase 1-3: Control Plane + Contract System - awooop_phase1_control_plane_2026-05-04.sql: 12 張核心表 + RLS - awooop_phase1_batch1_rls_2026-05-04.sql: 全部 FORCE RLS + GRANT - packages/awooop-contracts/: 六合約 JSON Schema + golden fixtures - src/models/awooop_contracts.py: Pydantic v2 contract models（extra=forbid） - src/repositories/contract_repository.py: contract lifecycle（draft→published→active） - src/services/contract_service.py: HMAC publish sig + Redis multi-sig activate - src/services/schema_validator.py: LLM output validator（retry×3, E-SCHEMA-001） ## Phase 2: Tenant Isolation - awooop_phase2_budget_ledger_2026-05-04.sql: budget_ledger + RLS - src/services/budget_service.py: Token Budget Hard Kill 三層防線 - src/core/context.py: PROJECT_ID ContextVar（31 background loop 自動繼承） - src/db/base.py + models.py: project_id 欄位 + RLS set_config 注入 - src/hermes/nl_gateway.py: project_id Redis key 前綴（Phase A 雙寫） - src/services/anomaly_counter.py: per-project 改造（Phase A fallback） ## Phase 4: Platform Shell in Shadow Mode - awooop_phase4_run_state_2026-05-04.sql: run_state + step_journal + idempotency - src/services/run_state_machine.py: 8-state FSM + SKIP LOCKED + stale reaper - src/services/platform_runtime.py: UUID v7 + W3C trace_id + shadow_execute - src/services/audit_sink.py: PII/secret redaction 9 patterns - src/api/v1/platform/runs.py: POST/GET /v1/platform/runs（Router→Service 架構） - src/workers/platform_worker.py: SKIP LOCKED worker + heartbeat + reaper loop - src/main.py: platform router + lifespan worker start/stop ## Phase 5: MCP Gateway 五閘門 - awooop_phase5_mcp_gateway_2026-05-04.sql: 4 表 + RLS - src/plugins/mcp/gateway.py: McpGateway（Gate 1~5, E-MCP-GATE-001~009） - src/plugins/mcp/redaction_middleware.py: 雙層 redaction + 16K 截斷 - src/plugins/mcp/registry.py: __provider name mangling（ADR-116） - src/plugins/mcp/credential_resolver.py: k8s secret ref 解析 - tests/test_mcp_credential_isolation.py: 10 個迴歸測試（secret leak 防再現） ## Phase 6-8: EwoooC + Channel Hub + Approval Token - awooop_phase6_ewoooc_onboarding_2026-05-04.sql: ewoooc tenant + 4 read-only MCP tools - awooop_phase7_channel_hub_2026-05-04.sql: conversation_event + outbound_message - src/services/provider_proxy.py: ProviderProxy + PlatformEnvelope（ADR-115） - src/services/channel_hub.py: Telegram inbound mirror + Progressive Feedback（30s） - src/services/awooop_approval_token.py: HS256 + jti NX replay 防護 + suggest mode Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
104 lines
3.0 KiB
JSON
104 lines
3.0 KiB
JSON
{
|
||
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||
"$id": "https://awooop.platform/contracts/v1/runtime_run_state",
|
||
"title": "Runtime Run State Contract",
|
||
"description": "AwoooP Run 狀態機合約 — 定義 run lifecycle 的有效狀態與轉換規則",
|
||
"type": "object",
|
||
"required": ["run_id", "project_id", "agent_id", "state"],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"run_id": {
|
||
"type": "string",
|
||
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
|
||
"description": "Run UUID（UUID v7 格式）"
|
||
},
|
||
"project_id": {
|
||
"type": "string",
|
||
"pattern": "^[a-z0-9][a-z0-9_-]{1,63}$",
|
||
"description": "所屬租戶"
|
||
},
|
||
"agent_id": {
|
||
"type": "string",
|
||
"description": "執行此 run 的 agent"
|
||
},
|
||
"state": {
|
||
"type": "string",
|
||
"enum": [
|
||
"pending",
|
||
"running",
|
||
"waiting_approval",
|
||
"waiting_tool",
|
||
"completed",
|
||
"failed",
|
||
"cancelled",
|
||
"timeout"
|
||
],
|
||
"description": "Run 當前狀態（FSM）"
|
||
},
|
||
"trace_id": {
|
||
"type": "string",
|
||
"description": "W3C traceparent-compatible trace ID"
|
||
},
|
||
"parent_run_id": {
|
||
"type": ["string", "null"],
|
||
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
|
||
"description": "父 run ID（sub-agent 場景）"
|
||
},
|
||
"trigger": {
|
||
"type": "object",
|
||
"required": ["trigger_type"],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"trigger_type": {
|
||
"type": "string",
|
||
"enum": ["channel_event", "schedule", "api", "sub_agent", "retry"]
|
||
},
|
||
"channel_event_id": {"type": "string"},
|
||
"schedule_id": {"type": "string"},
|
||
"triggered_by": {"type": "string"}
|
||
},
|
||
"description": "觸發此 run 的事件來源"
|
||
},
|
||
"input_sha256": {
|
||
"type": "string",
|
||
"pattern": "^[0-9a-f]{64}$",
|
||
"description": "Run 輸入 payload 的 SHA-256（artifact integrity）"
|
||
},
|
||
"output_sha256": {
|
||
"type": ["string", "null"],
|
||
"pattern": "^[0-9a-f]{64}$",
|
||
"description": "Run 輸出結果的 SHA-256（完成後填入）"
|
||
},
|
||
"started_at": {
|
||
"type": ["string", "null"],
|
||
"format": "date-time",
|
||
"description": "run 開始執行時間"
|
||
},
|
||
"completed_at": {
|
||
"type": ["string", "null"],
|
||
"format": "date-time",
|
||
"description": "run 完成/失敗時間"
|
||
},
|
||
"timeout_at": {
|
||
"type": ["string", "null"],
|
||
"format": "date-time",
|
||
"description": "run 預計超時時間"
|
||
},
|
||
"error_code": {
|
||
"type": ["string", "null"],
|
||
"description": "失敗錯誤碼（state=failed 時填入）"
|
||
},
|
||
"cost_usd": {
|
||
"type": ["number", "null"],
|
||
"minimum": 0,
|
||
"description": "此 run 累計 LLM 費用（USD）"
|
||
},
|
||
"step_count": {
|
||
"type": "integer",
|
||
"minimum": 0,
|
||
"default": 0,
|
||
"description": "已執行 LLM step 數"
|
||
}
|
||
}
|
||
}
|