Files
boshu2__agentops/docs/contracts/index.md
T
Boden Fuller b8c5a3761b feat(agentops): make 3.0 hookless-first
Add DDD skill-domain contracts, hook lease inventory, replacement ports, artifact-first RPI skill boundaries, and release exact-SHA validation. Demote ao inject to a compatibility adapter and remove prompt-only default hooks.
2026-05-16 09:43:08 -04:00

7.1 KiB

Contracts

Every inter-component boundary in AgentOps is a contract — a versioned, validatable interchange format. These are the interchange files used between skills, the runtime, and external integrations.

  • :material-play-box: Repo Execution Profile


    Repo-local bootstrap, validation, tracker, and done-criteria contract for autonomous orchestration.

  • :material-robot: Autodev Program


    Repo-local operational contract for bounded autonomous development.

  • :material-database: RPI Run Registry


    RPI run registry specification.

  • :material-server: AgentOps Daemon


    Architecture boundary for agentopsd, the daemon ledger, job queue, local trust, projections, and migration from foreground command flows.

  • :material-factory: AgentOpsd Control Plane


    Production control-plane contract for worker slots, worktree ownership, lifecycle telemetry, validation gates, yield, and operator status.

  • :material-shield-check: Factory Admission


    Daemon-owned work-order admission contract for fail-closed local factory pilots and RPI handoff.

  • :material-routes: Routing Policy


    Schema-backed model/provider/runtime lane policy, authority levels, and milestone-1 GasCity / Mt. Olympus production-routing guardrails.

  • :material-chart-timeline-variant: Factory Yield Ledger


    Baseline/treatment yield observations correlated to routing, validation, manual merge decisions, cost, latency, defects, and artifacts.

  • :material-shield-search: Factory Claim Ledger


    Machine-readable posture ledger tying public software-factory claims to evidence level, owner issue, closure gate, and anti-overclaim wording.

  • :material-lock-check: Daemon Idempotency


    Submit retry contract for request_id, idempotency_key, and daemon-submitting CLI helpers.

  • :material-file-code: JobSpec OpenAPI v0


    Machine-readable OpenAPI contract for the current agentopsd job, readiness, ledger replay, projection, and OpenClaw consumer HTTP surface.

  • :material-api: GasCity Integration


    Public GasCity API/SSE boundary, mutation headers, request IDs, readiness, replay, versioning, and adapter rules.

  • :material-lan-connect: Remote Compute


    Product-neutral RemoteTarget, RemoteSession, command ledger, recovery, and GasCity-first remote execution contract.

  • :material-robot-outline: AgentWorker Runtime


    Headless Claude/Codex worker session lifecycle contract consumed by wiki/forge and future daemon jobs.

  • :material-application-braces-outline: OpenClaw Consumer API


    Read-only projection resources, snapshot versions, mutation gates, and .agents non-ownership rules for OpenClaw clients.

  • :material-clipboard-pulse: Eval Environment


    Evaluation suite, run, scorecard, baseline, canary, and holdout contract.

  • :material-clipboard-text-clock: Eval Verdict Pipeline


    Verdict compiler pipeline from eval run manifests to learning utility and retirement signals.

  • :material-magnify-scan: Retrieval Comparison


    Deterministic search-eval backend comparison, promotion thresholds, optional rerank behavior, and deferred vector/graph-store policy.

  • :material-clipboard-check-outline: Release Readiness


    8/10 release readiness score, SIL/VIL/HIL evidence, artifact manifest requirements, and HIL waiver policy.

  • :material-brain: MemRL Policy Schema


    Deterministic retry/escalation policy profile for memory-reinforcement feedback loops.

  • :material-format-list-numbered: Next-Work Queue


    Contract for .agents/rpi/next-work.jsonl.

  • :material-magnify: Finding Registry


    Canonical intake-ledger contract for reusable findings.

  • :material-hammer-wrench: Finding Compiler


    V2 promotion ladder, executable constraint index, and lifecycle rules.

  • :material-hook: Hook Runtime Contract


    Canonical event mapping across Claude, Codex, and manual runtimes.

  • :material-tag-check: Hook Lease Inventory


    AgentOps 3.0 hook disposition inventory generated from the live hook manifest.

  • :material-console: Headless Invocation Standards


    Required flags, tool allowlists, and timeout strategy for non-interactive Claude/Codex execution.

  • :material-api: Codex Skill API


    Source of truth for Codex runtime skill structure, frontmatter, discovery paths, and multi-agent primitives.

  • :material-cube-outline: Context Assembly Interface


    Interface contract for adaptive context assembly and token budgeting.

  • :material-vector-polyline: Skill Domain Map


    V0 DDD map assigning every shared skill to one primary skill domain with ports, artifacts, and adapters.

  • :material-call-split: Skill Ports and Adapters


    V0 skill-boundary vocabulary for inbound ports, outbound ports, adapters, context packets, and guard surfaces.

  • :material-clipboard-check-outline: Skill Lease Audit


    V0 lease-on-life audit classifying every shared skill as keep, merge, split, retire, or unknown before any cut is attempted.

  • :material-shield-star: Session Intelligence Trust Model


    Artifact eligibility contract for runtime context assembly.

  • :material-moon-waning-crescent: Dream Run


    Process model, generator authoring, locking, keep-awake, and artifact floor for private overnight runs.

  • :material-file-chart: Dream Report


    Canonical summary.json and summary.md schema for Dream outputs.

  • :material-alert-octagon: Scope Escape Report


    Structured template for agent scope-escape reporting.

  • :material-clipboard-check: Dispatch Checklist


    Standard references for agent dispatch prompts.

  • :material-account-multiple-check: Swarm Evidence


    Permissive shape covering all historical swarm result files.