17ba5d723b
Python rewrite of the agent harness on top of deepagents 0.6.1 + langchain 1.x, replacing the abandoned TS attempt in packages/. 388 unit/integration tests pass. Steps ----- 0. Scaffolding — uv workspace, ruff/mypy/pre-commit/alembic, src/tests/docs trees with docs/schemas/ seeded from my-deepagent-seed/. 1. Core — config (pydantic-settings with MYDEEPAGENT_ env prefix and TOML source), enums (Backend, Capability, RiskLevel, ApprovalDecisionAction, ApprovalState, RunState, RunPhaseState, SessionState, ErrorClass), errors (MyDeepAgentError + BudgetExhaustedError with PEP-3134 cause + context suppression), hash (canonical JSON + sha256). 2. Persona/Workflow/Binding — pydantic v2 schemas with tuple-based deep immutability (post-construction hash drift prevented), YAML loaders, deterministic auto-select (preferred_backends → version → name → hash), override resolution with ineligibility diagnostics, PersonaConsentStore with fcntl.flock + tmp+fsync+rename atomic write. 3. Artifact schema registry — Draft202012Validator, multi-root resolution, structured ValidationFinding output. 4. Persistence — 18 SQLAlchemy 2.0 async ORM models with FK CASCADE/RESTRICT, WAL + busy_timeout + foreign_keys PRAGMA, alembic baseline + ux_active_run_repo_base partial unique index, LangGraph SqliteSaver as context manager only (lifecycle safety). 5. DeepAgent session — build_agent wires Persona → create_deep_agent with LocalShellBackend / FilesystemBackend / StateBackend / CompositeBackend, ChatOpenAI(base_url=openrouter) for openrouter: model strings, and 4 middleware classes (cost / audit-tool / safety-shell / fallback-model). Critical workarounds -------------------- - deepagents 0.6.1 rejects FilesystemPermission together with backends that implement SandboxBackendProtocol (LocalShellBackend). SafetyShellMiddleware enforces destructive-command and secret-path policy at the tool layer instead, and build_agent strips the permissions kwarg when the persona's deepagents_backend is local_shell. - FilesystemOperation in deepagents is Literal['read', 'write'] only; _map_operations collapses our richer schema (read/write/edit/ls) safely. Real OpenRouter smoke --------------------- test_openrouter_deepagents_local_shell_smoke calls DeepSeek via deepagents + LocalShellBackend + SafetyShellMiddleware end-to-end. PASS, ~$0.000001 cost, input=9 / output=1 tokens with content "OK". Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
115 lines
3.0 KiB
JSON
115 lines
3.0 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "common/final-report@1",
|
|
"title": "Common Final Report",
|
|
"description": "워크플로 실행 최종 보고서",
|
|
"type": "object",
|
|
"required": ["runId", "templateHash", "status", "phases", "endedAt"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"runId": {
|
|
"type": "string",
|
|
"format": "uuid",
|
|
"description": "실행 고유 식별자 (UUID)"
|
|
},
|
|
"templateHash": {
|
|
"type": "string",
|
|
"pattern": "^[a-f0-9]{64}$",
|
|
"description": "워크플로 템플릿의 sha256 해시 (hex)"
|
|
},
|
|
"status": {
|
|
"type": "string",
|
|
"enum": ["completed", "failed", "aborted"],
|
|
"description": "실행 최종 상태"
|
|
},
|
|
"inputs": {
|
|
"type": "object",
|
|
"description": "실행 입력값 (선택)"
|
|
},
|
|
"phases": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"required": ["key", "state"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"key": {
|
|
"type": "string",
|
|
"description": "phase 키"
|
|
},
|
|
"state": {
|
|
"type": "string",
|
|
"enum": ["pending", "running", "completed", "failed", "skipped"],
|
|
"description": "phase 실행 상태"
|
|
},
|
|
"started_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "시작 시각 (선택)"
|
|
},
|
|
"ended_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "종료 시각 (선택)"
|
|
},
|
|
"attempts": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"description": "시도 횟수 (선택)"
|
|
}
|
|
}
|
|
},
|
|
"description": "각 phase 실행 기록"
|
|
},
|
|
"approvals": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object"
|
|
},
|
|
"description": "승인 기록 목록 (선택)"
|
|
},
|
|
"findings": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object"
|
|
},
|
|
"description": "수집된 finding 목록 (선택)"
|
|
},
|
|
"artifacts": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"required": ["path", "schema"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"path": {
|
|
"type": "string",
|
|
"description": "산출물 파일 경로"
|
|
},
|
|
"schema": {
|
|
"type": "string",
|
|
"description": "산출물 JSON Schema ID"
|
|
},
|
|
"hash": {
|
|
"type": "string",
|
|
"description": "산출물 파일 해시 (선택)"
|
|
}
|
|
}
|
|
},
|
|
"description": "생성된 산출물 목록 (선택)"
|
|
},
|
|
"unresolved": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"description": "미해결 항목 목록 (선택)"
|
|
},
|
|
"endedAt": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"description": "실행 종료 시각"
|
|
}
|
|
}
|
|
}
|