How placidoe/agent-deck-harness-core works
Agent Deck Harness Core is a provider-neutral runtime and SDK for reliable long-horizon agent runs. A caller starts or resumes a run; the harness asks a Manager for a bounded contract, assembles referenced context, sends it to an Executor, then submits the execution and state to an independent Auditor. It applies evidence-backed ledger updates and only completes when requirements are verified with clean integrity and no blockers; otherwise it can request human attention. State snapshots and append-only events support restart and observability. The README documents additional planned capabilities, but adapters, routing, retrieval, and scheduling are not implemented.
Main entry points: harness.ts AgentHarness · types.ts RunStore contract · store.ts Memory store · context.ts Context builder
Components 17
Run orchestration
- AgentHarness
src/harness.ts - Context builder
src/context.ts - Call metrics
src/types.ts - SDK exports
src/index.ts
Verified ledger
- Run state ledger
src/types.ts - Evidence records
src/types.ts - Requirements
src/types.ts - Facts and artifacts
src/types.ts - Blockers and attention
src/types.ts
Run persistence
- RunStore contract
src/types.ts - Memory store
src/store.ts - JSON file store
src/store.ts - Event stream
src/types.ts
Other components
- SDK caller
Connections 24
- SDK caller → SDK exports: imports SDK
- SDK exports → AgentHarness: exports
- SDK caller → AgentHarness: starts or resumes
- AgentHarness → RunStore contract: loads and saves
- RunStore contract → Memory store: implemented by
- RunStore contract → JSON file store: implemented by
- AgentHarness → Manager: requests decision
- Manager → AgentHarness: returns decision
- AgentHarness → Context builder: assembles context
- Context builder → Run state ledger: selects references
- AgentHarness → Executor: dispatches contract
- AgentHarness → Auditor: submits execution
- Auditor → AgentHarness: returns audit
- AgentHarness → Requirements: applies updates
- AgentHarness → Evidence records: records evidence
- AgentHarness → Facts and artifacts: upserts records
- AgentHarness → Blockers and attention: sets attention
- AgentHarness → Call metrics: records timings
- AgentHarness → Event stream: appends events
- AgentHarness → SDK caller: emits events
- Memory store → Run state ledger: stores snapshots
- Memory store → Event stream: stores events
- JSON file store → Run state ledger: writes snapshots
- JSON file store → Event stream: appends JSONL