OIP system: SESSION
SESSION
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: core. Capabilities: 4. Machine system map: /api/dispatch?map=SESSION&format=markdown. Root: /a/oip.
Operations
SESSION_START
Start (or upsert) a stateful agent session Use when: you need to session start Arguments: session_id|agent|cwd|goal. Human article: /a/oip-capability-session-start. Machine doc: ?key=SESSION_START&format=markdown. Invocation history: /api/invocations?object_id=SESSION_START.
SESSION_GET
Read a session row Use when: you need to session get Arguments: session_id. Human article: /a/oip-capability-session-get. Machine doc: ?key=SESSION_GET&format=markdown. Invocation history: /api/invocations?object_id=SESSION_GET.
SESSION_UPDATE
Patch a session (agent|cwd|goal|status|last_event_id) Use when: you need to session update Arguments: session_id|patch_json. Human article: /a/oip-capability-session-update. Machine doc: ?key=SESSION_UPDATE&format=markdown. Invocation history: /api/invocations?object_id=SESSION_UPDATE.
SESSION_RESUME
Rehydrate a cold terminal agent: session row + recent LEDGER events (actor=session_id) Use when: you need to session resume Arguments: session_id|limit. Human article: /a/oip-capability-session-resume. Machine doc: ?key=SESSION_RESUME&format=markdown. Invocation history: /api/invocations?object_id=SESSION_RESUME.