Crate atomr_agents_coding_cli_harness

Expand description

Harness that wraps local AI coding CLIs as atomr-agents Callables.

See README.md for the high-level architecture.

Structs§

CliCommand: A concrete process invocation produced by a vendor adapter.
CliRequest: Uniform request the harness accepts.
CliResult: Final shape of a headless run.
CliRunId
CliSessionId
CodingCliEventStream: Subscriber handle backed by a broadcast::Receiver. Drops missed events silently — same semantics as DeepResearchEventStream.
CodingCliHarness
CodingCliHarnessSpec: Top-level harness configuration.
ConceptProjection: Everything the harness hands a vendor adapter before a run so the adapter can materialize on-disk config.
InMemoryRunStore
InteractiveSessionHandle
McpServerInit: One MCP server the CLI loaded.
McpServerSnapshot: One MCP server entry — vendor-agnostic.
PersonaSnapshot: Identity + behavior of the agent the CLI should impersonate.
PolicySnapshot: Narrowed permissions the harness wants enforced by the CLI itself.
SkillSnapshot: One skill the CLI should be able to invoke.
ToolCallRecord: One tool the CLI invoked during the run.
ToolDescriptorInit: One tool descriptor reported by the CLI during init.
ToolSetSnapshot: A bundled set of MCP servers + standalone tool names. Materializes to .mcp.json (Claude), .cursor/mcp.json (Cursor), Codex / Antigravity settings files.
UsageSummary: Token + cost totals.
VendorRegistry

CliVendorKind: Stable identifier for a vendor adapter. Extensible — third-party adapters can use CliVendorKind::Other.
CodingCliEvent: Normalized lifecycle events. Tagged enum — serializes as {"kind": "...", ...} so the web client can switch on kind.
FinishReason: Why the run finished.
HarnessError
IsolationSpec: Where the CLI process runs.
RunMode: Whether the harness should run the CLI headlessly (parse structured events) or interactively (bridge a tmux session to a browser).
SessionEvent: Frame the harness shows to clients (over WebSocket in the web companion).
SessionTransport: Frames clients send back.

CliEventParser: A stream parser owned by the harness for the lifetime of one run.
CliRunStore
CliVendor: The integration seam each CLI adapter implements.