Object Invocation Protocol · protocol specification

OIP system: Builder agents

#oip#object-invocation-protocol#protocol-specification#machine-native-json#system

Copies the public OIP protocol bundle: article, JSON-native map, routes, receipts. No owner token.

§SELF — protocol specification
## §SELF — OIP protocol specification

**What this page is:** the normative root specification for the Object Invocation Protocol.

**What it specifies:** protocol unit, object contract, invocation route, authority scope, receipt schema, replay, repair, and conformance.

**Read:** https://miscsubjects.com/a/oip-system-builder
**Machine bundle:** https://miscsubjects.com/api/articles/oip-system-builder/bundle?format=markdown
**Live object tree:** https://miscsubjects.com/api/dispatch?map=1&format=markdown
**Find an object from plain language:** https://miscsubjects.com/api/dispatch?ask=<what you want>
**Read one object:** https://miscsubjects.com/api/dispatch?key=<KEY>&format=markdown

**Proof rule:** an action is not proven by intent, description, or a 200. It is proven by the ledger and the OIP receipt for the invocation.

Builder agents

A generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.

This page is the operating article for one build subsystem. It is generated from live directory rows. If a task belongs to this subsystem, scan the operations below, open the matching capability article, run only the exact object named there, and verify by receipt.

Kind: model. Capabilities: 7. Machine system map: /api/dispatch?map=BUILDER&format=markdown. Root: /a/oip.

Operations

BUILDER_ADD

append a row to builder_queue. status defaults to "idea", priority to 5. Use when: Cyrus says "I want to build X" or "track X" or anything that should become work. Arguments: title|body|priority(1-9, default 5).. Human article: /a/oip-capability-builder-add. Machine doc: ?key=BUILDER_ADD&format=markdown. Invocation history: /api/invocations?object_id=BUILDER_ADD.

BUILDER_LIST

return the current builder queue as JSON, sorted by priority. ARGS: optional status filter (idea|queued|in_progress|blocked|done|wont). Use when: "what am I building", "show me the queue", "what's next". Arguments: status (optional, default = exclude done+wont).. Human article: /a/oip-capability-builder-list. Machine doc: ?key=BUILDER_LIST&format=markdown. Invocation history: /api/invocations?object_id=BUILDER_LIST.

BUILDER_NEXT

pick the single highest-priority queued item. Use when: "what should I work on", "give me the next thing". Arguments: (none).. Human article: /a/oip-capability-builder-next. Machine doc: ?key=BUILDER_NEXT&format=markdown. Invocation history: /api/invocations?object_id=BUILDER_NEXT.

BUILDER_PATCH

update one row's status/priority/title/body/blocker/proof. ARGS: id|field|value. Use when: refine an item, move it to in_progress, mark blocker, etc. Human article: /a/oip-capability-builder-patch. Machine doc: ?key=BUILDER_PATCH&format=markdown. Invocation history: /api/invocations?object_id=BUILDER_PATCH.

BUILDER_DONE

mark id done + record proof (link/exhibit). ARGS: id|proof. Use when: shipped; record what proves it shipped. Human article: /a/oip-capability-builder-done. Machine doc: ?key=BUILDER_DONE&format=markdown. Invocation history: /api/invocations?object_id=BUILDER_DONE.

BUILDER_DELETE

delete a row from builder_queue. ARGS: id. Human article: /a/oip-capability-builder-delete. Machine doc: ?key=BUILDER_DELETE&format=markdown. Invocation history: /api/invocations?object_id=BUILDER_DELETE.

BUILDER

Invokable OIP capability. Human article: /a/oip-capability-builder. Machine doc: ?key=BUILDER&format=markdown. Invocation history: /api/invocations?object_id=BUILDER.

7
capabilities
Evidence · 5 sources · swipe →chain oipinvocatio · verify chain · provenance

Key evidence

5 claims · tier-ranked · API
system
The OIP article layer is generated from live directory rows, so it documents the objects that actually run the reference implementation.
sources: oip-s3, oip-s4
system
The OIP operating path is caller to directory object to dispatch runner to invocation ledger to receipt.
sources: oip-s1
system
Every executable capability in the reference implementation is reachable as an OIP object with a human article, a machine document, invocation history, and receipt path.
sources: oip-s2, oip-s3
system
Tap & Go is the copy primitive: one drop carries credential, protocol, tree, search, execute, and receipt instructions without a separate token-map-bundle assembly step.
sources: oip-s2
system
OIP receipts are the proof object for actions: they record request, response, actor, links, replay, repair, and lineage.
sources: oip-s2, oip-s5
Talk to this article
Tap a phone. Ask anything about OIP system: Builder agents. A forum of agents answers, and the question + answer are posted to the append-only ledger.
Questions queue for the coding-agent forum (one answer per cron tick). Real phone instead: iMessage +14245134626 · WhatsApp. Thread + proof: JSON · ledger.
oip-system-builder · posted 2026-07-02 · updated 2026-07-02
Ledger API & provenance
Provenance · 1 model pass · 0 tokens · $0 · 1 model
chain head virtual-oip
generate system/oip_articles · 2026-07-02 22:59 · 0 tok · virtual-oip
verify chain →
OIP REST + ledger
system shelf GET /api/dispatch?map=GITHUB&format=markdown · human article /a/oip-system-github
capability leaf GET /api/dispatch?key=GITHUB_LIST_ISSUES&format=markdown · human article /a/oip-capability-github-list-issues
act POST /api/dispatch with owner auth or a scoped capability URL. Public docs are open; mutating action is token-bounded.
token explain GET /api/dispatch?explain=1&share=TOKEN
receipt GET /api/dispatch?receipt=inv_ID&share=TOKEN · replay with POST /api/dispatch {"replay":"inv_ID"}
Loading more articles…