{"slug":"oip-system-oip","title":"OIP system: OIP capabilities","body":"## OIP capabilities\n\nA 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.\n\nThis 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.\n\nKind: `core`. Capabilities: `9`. Machine system map: [/api/dispatch?map=OIP&format=markdown](https://miscsubjects.com/api/dispatch?map=OIP&format=markdown). Root: [/a/oip](https://miscsubjects.com/a/oip).\n\n## Operations\n\n### OIP_PROTOCOL\nObject Invocation Protocol index — endpoints, schema, invariant loop.\nUse when: cold bootstrap for any client; what is OIP and how to invoke objects.\nArguments: `none`.\nHuman article: [/a/oip-capability-oip-protocol](https://miscsubjects.com/a/oip-capability-oip-protocol). Machine doc: [?key=OIP_PROTOCOL&format=markdown](https://miscsubjects.com/api/dispatch?key=OIP_PROTOCOL&format=markdown). Invocation history: [/api/invocations?object_id=OIP_PROTOCOL](https://miscsubjects.com/api/invocations?object_id=OIP_PROTOCOL).\n\n### OIP_REGISTRY\nFull OIP object registry from directory rows (type, runner, read/write paths, schemas).\nUse when: list invokable objects; category filter optional.\nArguments: `category (optional)`.\nHuman article: [/a/oip-capability-oip-registry](https://miscsubjects.com/a/oip-capability-oip-registry). Machine doc: [?key=OIP_REGISTRY&format=markdown](https://miscsubjects.com/api/dispatch?key=OIP_REGISTRY&format=markdown). Invocation history: [/api/invocations?object_id=OIP_REGISTRY](https://miscsubjects.com/api/invocations?object_id=OIP_REGISTRY).\n\n### OIP_RECEIPT\nRead one invocation back as a receipt: full recorded request + response, lineage (replay_of/repairs/repaired_by), and the verbs that act on it. A receipt is a live replayable object, not history.\nUse when: Cyrus asks \"show the receipt for inv_x\", \"what happened in inv_x\", \"why did that fail\".\nArguments: `$1 = invocation id (inv_…).`.\nHuman article: [/a/oip-capability-oip-receipt](https://miscsubjects.com/a/oip-capability-oip-receipt). Machine doc: [?key=OIP_RECEIPT&format=markdown](https://miscsubjects.com/api/dispatch?key=OIP_RECEIPT&format=markdown). Invocation history: [/api/invocations?object_id=OIP_RECEIPT](https://miscsubjects.com/api/invocations?object_id=OIP_RECEIPT).\n\n### OIP_REPLAY\nRe-fire a past invocation with its recorded input. New receipt links replay_of to the old one.\nUse when: Cyrus says \"replay that\", \"run inv_x again\", \"re-fire it as it was\".\nArguments: `$1 = invocation id (inv_…).`.\nHuman article: [/a/oip-capability-oip-replay](https://miscsubjects.com/a/oip-capability-oip-replay). Machine doc: [?key=OIP_REPLAY&format=markdown](https://miscsubjects.com/api/dispatch?key=OIP_REPLAY&format=markdown). Invocation history: [/api/invocations?object_id=OIP_REPLAY](https://miscsubjects.com/api/invocations?object_id=OIP_REPLAY).\n\n### OIP_REPAIR\nRepair a failed invocation from its receipt: inspects the failure, derives or takes the corrected key+body, fires it linked (new receipt carries repairs, old receipt gains repaired_by). Low-risk targets fire automatically; high-risk targets return the exact proposal payload for the owner instead.\nUse when: Cyrus says \"repair that failed invocation\", \"fix inv_x with NOW\", \"make that call again but corrected\".\nArguments: `$1 = failed invocation id, $2 = corrected row key (optional — derived from the failure when omitted), $3+ = corrected body (optional, may contain pipes).`.\nHuman article: [/a/oip-capability-oip-repair](https://miscsubjects.com/a/oip-capability-oip-repair). Machine doc: [?key=OIP_REPAIR&format=markdown](https://miscsubjects.com/api/dispatch?key=OIP_REPAIR&format=markdown). Invocation history: [/api/invocations?object_id=OIP_REPAIR](https://miscsubjects.com/api/invocations?object_id=OIP_REPAIR).\n\n### OIP_TREE\nReturn the recursive Object Invocation Protocol tree: root documents, API/CLI/MCP/device/model/core shelves, generated system articles, generated capability articles, ledgers, receipts, replay, repair, and token explanation surfaces.\nUse when: Cyrus or a model asks for the OIP tree, object invocation protocol docs, capability map, machine-native API tree, API/CLI/MCP documentation, or how to start from one self-explaining root and discover the whole action surface.\nArguments: `none`.\nHuman article: [/a/oip-capability-oip-tree](https://miscsubjects.com/a/oip-capability-oip-tree). Machine doc: [?key=OIP_TREE&format=markdown](https://miscsubjects.com/api/dispatch?key=OIP_TREE&format=markdown). Invocation history: [/api/invocations?object_id=OIP_TREE](https://miscsubjects.com/api/invocations?object_id=OIP_TREE).\n\n### OIP_REVIEW_SEED\nQueue OIP article clarity review tasks. Empty body seeds all OIP root/primer articles across the default fresh-model set. Raw JSON body may pass {\"slugs\":[\"oip\"],\"models\":[\"grok/grok-4.3\"]}.\nUse when: start or refill the recursive OIP article review queue.\nArguments: `$1+ optional raw JSON body`.\nHuman article: [/a/oip-capability-oip-review-seed](https://miscsubjects.com/a/oip-capability-oip-review-seed). Machine doc: [?key=OIP_REVIEW_SEED&format=markdown](https://miscsubjects.com/api/dispatch?key=OIP_REVIEW_SEED&format=markdown). Invocation history: [/api/invocations?object_id=OIP_REVIEW_SEED](https://miscsubjects.com/api/invocations?object_id=OIP_REVIEW_SEED).\n\n### OIP_ARTICLE_REVIEW\nRun one OIP article loop tick. Claims the next tasks.source=oip-review row and routes it: oip-review scores machine JSON clarity + English clarity with a fresh model; oip-write has a model write a missing OIP article; oip-revise has a model rewrite a failing article as a new append-only version. Every step lands in the ledger.\nUse when: cron or manual trigger to advance the recursive OIP documentation loop one step.\nArguments: `none`.\nHuman article: [/a/oip-capability-oip-article-review](https://miscsubjects.com/a/oip-capability-oip-article-review). Machine doc: [?key=OIP_ARTICLE_REVIEW&format=markdown](https://miscsubjects.com/api/dispatch?key=OIP_ARTICLE_REVIEW&format=markdown). Invocation history: [/api/invocations?object_id=OIP_ARTICLE_REVIEW](https://miscsubjects.com/api/invocations?object_id=OIP_ARTICLE_REVIEW).\n\n### OIP_PURIFICATION_SEED\nQueue OIP documentation purification under logical-proof-v1. Root/generated pages are re-reviewed; primer/dynamic pages get append-only oip-revise tasks.\nUse when: after content rules change or after an editorial-board decision identifies unclear/proofless OIP documentation.\nArguments: `optional raw JSON {\"slugs\":[\"oip\",\"oip-operating-model\"],\"brief\":\"...\"}`.\nHuman article: [/a/oip-capability-oip-purification-seed](https://miscsubjects.com/a/oip-capability-oip-purification-seed). Machine doc: [?key=OIP_PURIFICATION_SEED&format=markdown](https://miscsubjects.com/api/dispatch?key=OIP_PURIFICATION_SEED&format=markdown). Invocation history: [/api/invocations?object_id=OIP_PURIFICATION_SEED](https://miscsubjects.com/api/invocations?object_id=OIP_PURIFICATION_SEED).\n","hero":null,"images":[],"style":{"accent":"#16324f","measure":860},"tags":["oip","object-invocation-protocol","protocol-specification","machine-native-json","system"],"model":null,"ledger":null,"embeds":[],"widgets":[{"type":"stat","value":9,"label":"capabilities"},{"type":"note","title":"Zero-context rule","text":"A reader should understand the protocol unit, object contract, invocation route, receipt schema, and repair path from this page plus its machine bundle."},{"type":"note","title":"Machine-native rule","text":"The JSON is the executable map: object, routes, inputs, proof loop, ledger, and next article to open."}],"home":false,"claims":[{"id":"oip-c1","tier":"system","text":"The OIP article layer is generated from live directory rows, so it documents the objects that actually run the reference implementation.","who_claims":"system/oip_articles","source_ids":["oip-s3","oip-s4"]},{"id":"oip-c2","tier":"system","text":"The OIP operating path is caller to directory object to dispatch runner to invocation ledger to receipt.","who_claims":"system/oip_articles","source_ids":["oip-s1"]},{"id":"oip-c3","tier":"system","text":"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.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s3"]},{"id":"oip-c4","tier":"system","text":"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.","who_claims":"system/oip_articles","source_ids":["oip-s2"]},{"id":"oip-c5","tier":"system","text":"OIP receipts are the proof object for actions: they record request, response, actor, links, replay, repair, and lineage.","who_claims":"system/oip_articles","source_ids":["oip-s2","oip-s5"]}],"sources":[{"id":"oip-s1","type":"protocol","title":"BUILD_SPEC object invocation path","url":"https://miscsubjects.com/api/file/docs/BUILD_SPEC.md","summary":"Defines directory rows, dispatch, ledger, and the escalation path for changing the build.","quote":"Run anything: POST https://miscsubjects.com/api/dispatch {key, body}","claim_ids":["oip-c2"],"link_status":"ok","hash":"oipbuildspec0001"},{"id":"oip-s2","type":"protocol","title":"Object Invocation Protocol spec","url":"https://miscsubjects.com/api/file/docs/OIP.md","summary":"Defines OIP surfaces, invariant loop, receipt/replay/repair, and invocation envelopes.","quote":"identify, explain, invoke, ledger, yield","claim_ids":["oip-c3","oip-c4","oip-c5"],"link_status":"ok","hash":"oipspec00000002"},{"id":"oip-s3","type":"protocol","title":"Live OIP capability tree","url":"https://miscsubjects.com/api/dispatch?map=1&format=markdown","summary":"Public recursive capability tree.","quote":"root > shelf > system article > capability article > receipt","claim_ids":["oip-c1","oip-c3"],"link_status":"ok","hash":"oipmap0000000002"},{"id":"oip-s4","type":"protocol","title":"Directory row documentation","url":"https://miscsubjects.com/api/dispatch?key=OIP_TREE&format=markdown","summary":"Capability articles are generated from live rows.","quote":"Machine Contract","claim_ids":["oip-c1"],"link_status":"ok","hash":"oiprow0000000003"},{"id":"oip-s5","type":"protocol","title":"Invocation ledger","url":"https://miscsubjects.com/api/invocations","summary":"Append-only invocation records and receipt links.","quote":"invocations","claim_ids":["oip-c5"],"link_status":"ok","hash":"oipinvocations0005"}],"reviews":[],"extra":{"oip_virtual":true,"oip_type":"system","count":9,"system":"OIP","metric":"capabilities"},"register":"oip_protocol","status":"published","revisions":0,"contributions":[],"provenance":[{"action":"generate","model":"system/oip_articles","ts":"2026-07-03T01:49:07-07:00","hash":"virtual-oip","tokens_in":0,"tokens_out":0}],"energy":{"passes":1,"tokens_in":0,"tokens_out":0,"tokens_total":0,"cost_usd":0,"models":{"system/oip_articles":1},"head":"virtual-oip"},"posted_at":"2026-07-02T00:00:00.000Z","created_at":"2026-07-02T00:00:00.000Z","updated_at":"2026-07-03T01:49:07-07:00"}