Exact Git-tracked sourcedocs/MCP.md View exact source

Native MCP and outer routing

Evidence Lane exposes one package-local native MCP identity and pairs every public action one-for-one with its schema, internal SDK route, outer binding, skill workflow, authority effects, conditional tools, hooks, and receipt contract.

Current counts are derived release facts, not permanent ceilings.

Surface Current value
Canonical actions 91
Read-only 30
Write-capable 61
SDK action bindings 91
MCP action bindings 91

The 30-row SPECIALIZED_NATIVE_ACTIONS tuple is only the specialized Canon/Learning/Memory/first-class subset (9 reads and 21 writes). It is not the canonical action total.

Routing law

Agent boundary

Codex is the sole acting agent. OpenAI Agents SDK is a subordinate typed function-tool and MCP client library; it has zero independent action, lane, Plan, Goal, HIL, memory, or project authority. External model-agent planes are not part of this plugin.

Source-bound workflow map

This page is projected from the same current executable snapshot as the rest of the documentation set. The map is deliberately two-directional: each horizontal district shows peer stages while vertical edges show ownership and state progression.

flowchart TB
    subgraph InputDistrict["Input and classification"]
      direction LR
      A["Host-visible action request"] --> B["Public schema validation"] --> C["One of 91 MCP actions"]
    end
    subgraph ExecutionDistrict["Selection and execution"]
      direction TB
      D["Outer-to-internal SDK route"] --> E["Owning module operation"] --> F["Effect and annotation validation"]
    end
    subgraph EvidenceDistrict["Evidence and outcome"]
      direction LR
      G["Structured MCP receipt"] --> H["Bounded result to Codex"]
      G -. mismatch .-> I["No alias, prefix rewrite, or borrowed authority"]
    end
    C --> D
    F --> G

Contract and readback

Phase Current contract Required readback
Input Host-visible action request Exact identity, provenance, and scope
Classification Public schema validation Owning schema, action, lane, skill, or authority
Owner One of 91 MCP actions One canonical implementation owner
Route Outer-to-internal SDK route Condition-true ordered route with no hidden alias
Execution Owning module operation Real execution or a visible fail-closed result
Validation Effect and annotation validation Hash, schema, authority-effect, and negative-case checks
Receipt Structured MCP receipt Content-addressed result and provenance receipt
Downstream Bounded result to Codex Only the explicitly eligible next state
Failure No alias, prefix rewrite, or borrowed authority No inferred HIL, candidate acceptance, or pointer movement

Canonical source owners

Exact backend readback

Source contract Bytes SHA-256
mcp/mcp-manifest.v1.json 7258 BDFB8CF9043F6A3374EA91FA19566D4B8975D075159513351F40BE88274E1ED6
schemas/public-action-schemas.v001.json 360281 78BCC5C9797ECBCE3B5DAA5FCFC7B5E83E35315A912EDB5C34E7354CE4D68CED
sdk/sdk-manifest.v1.json 76103 B97D608619CE2EFD385D96F17FC655F8FDD43782F3EC8715B2C91566BA696340

Cross-surface invariants


This page is a Git-tracked documentation projection. Executable source, SQLite authorities, installed-runtime receipts, and explicit human gates remain the governing evidence.