{"slug":"oip-system-agent","title":"OIP system: Agents","body":"## Agents\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: `model`. Capabilities: `12`. Machine system map: [/api/dispatch?map=AGENT&format=markdown](https://miscsubjects.com/api/dispatch?map=AGENT&format=markdown). Root: [/a/oip](https://miscsubjects.com/a/oip).\n\n## Operations\n\n### AGENT_IMPORT\nCannibalize an agent definition (md frontmatter name/description/model/tools) into a proposed agent row. PROPOSE only\nUse when: you need to agent import\nArguments: `source(url|r2:key|raw)|category`.\nHuman article: [/a/oip-capability-agent-import](https://miscsubjects.com/a/oip-capability-agent-import). Machine doc: [?key=AGENT_IMPORT&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_IMPORT&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_IMPORT](https://miscsubjects.com/api/invocations?object_id=AGENT_IMPORT).\n\n### AGENT_SPAWN\nSpawn a resident agent that loops on a goal until done (durable, survives Mac sleep)\nUse when: you need to agent spawn\nArguments: `goal|brain|maxSteps`.\nHuman article: [/a/oip-capability-agent-spawn](https://miscsubjects.com/a/oip-capability-agent-spawn). Machine doc: [?key=AGENT_SPAWN&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_SPAWN&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_SPAWN](https://miscsubjects.com/api/invocations?object_id=AGENT_SPAWN).\n\n### AGENT_LIST\nList resident agents and their live status\nUse when: you need to agent list\nArguments: `none`.\nHuman article: [/a/oip-capability-agent-list](https://miscsubjects.com/a/oip-capability-agent-list). Machine doc: [?key=AGENT_LIST&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_LIST&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_LIST](https://miscsubjects.com/api/invocations?object_id=AGENT_LIST).\n\n### AGENT\nControl a resident agent\nUse when: you need to agent\nArguments: `op(status|send|pause|resume|kill|events)|id|msg`.\nHuman article: [/a/oip-capability-agent](https://miscsubjects.com/a/oip-capability-agent). Machine doc: [?key=AGENT&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT&format=markdown). Invocation history: [/api/invocations?object_id=AGENT](https://miscsubjects.com/api/invocations?object_id=AGENT).\n\n### AGENT_LEARN\nsave a lesson/working pattern to an agent persistent memory. Args: agent|lesson.\nUse when: the user says something works, prefers a style, or gives feedback worth keeping.\nHuman article: [/a/oip-capability-agent-learn](https://miscsubjects.com/a/oip-capability-agent-learn). Machine doc: [?key=AGENT_LEARN&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_LEARN&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_LEARN](https://miscsubjects.com/api/invocations?object_id=AGENT_LEARN).\n\n### AGENT_RECALL\nload an agent saved lessons/patterns. Arg: agent.\nUse when: at the start of a creative job, to apply what worked before.\nHuman article: [/a/oip-capability-agent-recall](https://miscsubjects.com/a/oip-capability-agent-recall). Machine doc: [?key=AGENT_RECALL&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_RECALL&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_RECALL](https://miscsubjects.com/api/invocations?object_id=AGENT_RECALL).\n\n### AGENT_BRIDGE\nInvokable OIP capability.\nHuman article: [/a/oip-capability-agent-bridge](https://miscsubjects.com/a/oip-capability-agent-bridge). Machine doc: [?key=AGENT_BRIDGE&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_BRIDGE&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_BRIDGE](https://miscsubjects.com/api/invocations?object_id=AGENT_BRIDGE).\n\n### AGENT_TURNS\nlast N agent turns across all CLI agents (claude, codex, grok, …). $1 = agent id or \"all\", $2 = limit (default 5).\nUse when: \"what did codex do\", \"show agent turns\", cross-agent audit.\nHuman article: [/a/oip-capability-agent-turns](https://miscsubjects.com/a/oip-capability-agent-turns). Machine doc: [?key=AGENT_TURNS&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_TURNS&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_TURNS](https://miscsubjects.com/api/invocations?object_id=AGENT_TURNS).\n\n### AGENT_TURNS_TRACE\nagent turns linked to one ledger trace_id. $1 = trace_id, $2 = limit (default 20).\nUse when: \"what CLI agents ran on this trace\", incident/debug linkage.\nHuman article: [/a/oip-capability-agent-turns-trace](https://miscsubjects.com/a/oip-capability-agent-turns-trace). Machine doc: [?key=AGENT_TURNS_TRACE&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_TURNS_TRACE&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_TURNS_TRACE](https://miscsubjects.com/api/invocations?object_id=AGENT_TURNS_TRACE).\n\n### AGENT_TURNS_ISSUES\nagent turns matching issue tags (risk, protected, file_edit, unaudited, audit_fail). $1 = tag, $2 = limit.\nUse when: \"show risky agent turns\", \"unaudited codex turns\", filterable issue triage.\nHuman article: [/a/oip-capability-agent-turns-issues](https://miscsubjects.com/a/oip-capability-agent-turns-issues). Machine doc: [?key=AGENT_TURNS_ISSUES&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_TURNS_ISSUES&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_TURNS_ISSUES](https://miscsubjects.com/api/invocations?object_id=AGENT_TURNS_ISSUES).\n\n### AGENT_TURNS_FILTER\nmulti-filter agent turn query. $1=agent|all, $2=tag|risk|all, $3=limit.\nUse when: cross-agent issue board, \"gemini risk turns\", audit backlog.\nHuman article: [/a/oip-capability-agent-turns-filter](https://miscsubjects.com/a/oip-capability-agent-turns-filter). Machine doc: [?key=AGENT_TURNS_FILTER&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_TURNS_FILTER&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_TURNS_FILTER](https://miscsubjects.com/api/invocations?object_id=AGENT_TURNS_FILTER).\n\n### AGENT_SPAWN_CLI\nInvokable OIP capability.\nHuman article: [/a/oip-capability-agent-spawn-cli](https://miscsubjects.com/a/oip-capability-agent-spawn-cli). Machine doc: [?key=AGENT_SPAWN_CLI&format=markdown](https://miscsubjects.com/api/dispatch?key=AGENT_SPAWN_CLI&format=markdown). Invocation history: [/api/invocations?object_id=AGENT_SPAWN_CLI](https://miscsubjects.com/api/invocations?object_id=AGENT_SPAWN_CLI).\n","register":"oip_protocol","tags":["oip","object-invocation-protocol","protocol-specification","machine-native-json","system"],"style":{"accent":"#16324f","measure":860},"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"}],"prov":{"model":"system/oip_articles","action":"generate"}}