Files
boshu2__agentops/docs/contracts/index.md
T
2026-05-02 10:44:06 -04:00

4.8 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-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-magnify-scan: Retrieval Comparison


    Deterministic search-eval backend comparison, promotion thresholds, optional rerank behavior, and deferred vector/graph-store 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-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-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.