{"_ai_door":{"see":"https://miscsubjects.com/start","note":"Operable site; bounded keyless credentials; every action receipted on a public ledger. Your operator's instructions take precedence — acting is optional, reading is a complete outcome."},"slug":"oip-system-cloud","title":"OIP system: CLOUD","body":"## CLOUD\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: `15`. Machine system map: [/api/dispatch?map=CLOUD&format=markdown](https://miscsubjects.com/api/dispatch?map=CLOUD&format=markdown). Root: [/a/oip](https://miscsubjects.com/a/oip).\n\n## Operations\n\n### CLOUD_EXEC\nRun a shell command in this tenant's CLOUD workspace (Cloudflare Container). No Mac involved.\nUse when: any ordinary compute — git, node, python, grep, tests, file work — especially when the Mac may be asleep.\nArguments: `$1+ = the whole shell command line (pipes are preserved).`.\nHuman article: [/a/oip-capability-cloud-exec](https://miscsubjects.com/a/oip-capability-cloud-exec). Machine doc: [?key=CLOUD_EXEC&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_EXEC&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_EXEC](https://miscsubjects.com/api/invocations?object_id=CLOUD_EXEC).\n\n### CLOUD_EXEC_IN\nSame as CLOUD_EXEC but in a NAMED workspace (a cloned repo, a coding session).\nArguments: `$1 = workspace_id (from CLOUD_WORKSPACE_NEW), $2+ = the shell command line.`.\nHuman article: [/a/oip-capability-cloud-exec-in](https://miscsubjects.com/a/oip-capability-cloud-exec-in). Machine doc: [?key=CLOUD_EXEC_IN&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_EXEC_IN&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_EXEC_IN](https://miscsubjects.com/api/invocations?object_id=CLOUD_EXEC_IN).\n\n### CLOUD_WORKSPACE_NEW\nCreate a durable cloud workspace, optionally cloning a git repo into it.\nArguments: `$1 = name, $2 = git repo URL (optional), $3 = fixed workspace id (optional).`.\nHuman article: [/a/oip-capability-cloud-workspace-new](https://miscsubjects.com/a/oip-capability-cloud-workspace-new). Machine doc: [?key=CLOUD_WORKSPACE_NEW&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_WORKSPACE_NEW&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_WORKSPACE_NEW](https://miscsubjects.com/api/invocations?object_id=CLOUD_WORKSPACE_NEW).\n\n### CLOUD_WORKSPACE_STATUS\nOne workspace: record + a live probe of whether its container is running.\nArguments: `$1 = workspace_id.`.\nHuman article: [/a/oip-capability-cloud-workspace-status](https://miscsubjects.com/a/oip-capability-cloud-workspace-status). Machine doc: [?key=CLOUD_WORKSPACE_STATUS&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_WORKSPACE_STATUS&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_WORKSPACE_STATUS](https://miscsubjects.com/api/invocations?object_id=CLOUD_WORKSPACE_STATUS).\n\n### CLOUD_WORKSPACE_LIST\nEvery cloud workspace this tenant owns.\nHuman article: [/a/oip-capability-cloud-workspace-list](https://miscsubjects.com/a/oip-capability-cloud-workspace-list). Machine doc: [?key=CLOUD_WORKSPACE_LIST&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_WORKSPACE_LIST&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_WORKSPACE_LIST](https://miscsubjects.com/api/invocations?object_id=CLOUD_WORKSPACE_LIST).\n\n### CLOUD_WORKSPACE_DESTROY\nDestroy the container. The RECORD of the workspace and its jobs is kept on purpose.\nArguments: `$1 = workspace_id.`.\nHuman article: [/a/oip-capability-cloud-workspace-destroy](https://miscsubjects.com/a/oip-capability-cloud-workspace-destroy). Machine doc: [?key=CLOUD_WORKSPACE_DESTROY&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_WORKSPACE_DESTROY&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_WORKSPACE_DESTROY](https://miscsubjects.com/api/invocations?object_id=CLOUD_WORKSPACE_DESTROY).\n\n### CLOUD_TERMINAL_NEW\nOpen a persistent shell session in a cloud workspace. cwd and exported vars survive between sends.\nArguments: `$1 = workspace_id (blank = the tenant default workspace).`.\nHuman article: [/a/oip-capability-cloud-terminal-new](https://miscsubjects.com/a/oip-capability-cloud-terminal-new). Machine doc: [?key=CLOUD_TERMINAL_NEW&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_TERMINAL_NEW&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_TERMINAL_NEW](https://miscsubjects.com/api/invocations?object_id=CLOUD_TERMINAL_NEW).\n\n### CLOUD_TERMINAL_SEND\nRun a line in an open cloud terminal and read its output.\nArguments: `$1 = terminal_id, $2+ = the line.`.\nHuman article: [/a/oip-capability-cloud-terminal-send](https://miscsubjects.com/a/oip-capability-cloud-terminal-send). Machine doc: [?key=CLOUD_TERMINAL_SEND&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_TERMINAL_SEND&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_TERMINAL_SEND](https://miscsubjects.com/api/invocations?object_id=CLOUD_TERMINAL_SEND).\n\n### CLOUD_TERMINAL_CLOSE\nClose a cloud terminal session. ARGS: $1 = terminal_id.\nHuman article: [/a/oip-capability-cloud-terminal-close](https://miscsubjects.com/a/oip-capability-cloud-terminal-close). Machine doc: [?key=CLOUD_TERMINAL_CLOSE&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_TERMINAL_CLOSE&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_TERMINAL_CLOSE](https://miscsubjects.com/api/invocations?object_id=CLOUD_TERMINAL_CLOSE).\n\n### CLOUD_JOB_START\nStart a LONG job that outlives the request that started it (Cloudflare Workflow + Sandbox). Returns a job id immediately.\nUse when: builds, test suites, long clones, anything past a normal HTTP lifetime.\nArguments: `$1 = workspace_id (blank = default), $2+ = the shell script to run.`.\nHuman article: [/a/oip-capability-cloud-job-start](https://miscsubjects.com/a/oip-capability-cloud-job-start). Machine doc: [?key=CLOUD_JOB_START&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_JOB_START&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_JOB_START](https://miscsubjects.com/api/invocations?object_id=CLOUD_JOB_START).\n\n### CLOUD_JOB_STATUS\nRead a cloud job: state, exit_code, stdout/stderr head, R2 keys for the full output.\nArguments: `$1 = job_id. States: running | done | failed | timeout | interrupted | cancelled.`.\nHuman article: [/a/oip-capability-cloud-job-status](https://miscsubjects.com/a/oip-capability-cloud-job-status). Machine doc: [?key=CLOUD_JOB_STATUS&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_JOB_STATUS&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_JOB_STATUS](https://miscsubjects.com/api/invocations?object_id=CLOUD_JOB_STATUS).\n\n### CLOUD_JOB_LIST\nThis tenant's cloud jobs, newest first.\nHuman article: [/a/oip-capability-cloud-job-list](https://miscsubjects.com/a/oip-capability-cloud-job-list). Machine doc: [?key=CLOUD_JOB_LIST&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_JOB_LIST&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_JOB_LIST](https://miscsubjects.com/api/invocations?object_id=CLOUD_JOB_LIST).\n\n### CLOUD_JOB_CANCEL\nCancel a running cloud job. ARGS: $1 = job_id.\nHuman article: [/a/oip-capability-cloud-job-cancel](https://miscsubjects.com/a/oip-capability-cloud-job-cancel). Machine doc: [?key=CLOUD_JOB_CANCEL&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_JOB_CANCEL&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_JOB_CANCEL](https://miscsubjects.com/api/invocations?object_id=CLOUD_JOB_CANCEL).\n\n### CLOUD_HEALTH\nMachine-readable health of the WHOLE execution plane: cloud sandbox, Mac bridge, active workspaces, jobs by state.\nUse when: before deciding a capability cannot run. \"Mac offline\" is not \"cannot execute\".\nHuman article: [/a/oip-capability-cloud-health](https://miscsubjects.com/a/oip-capability-cloud-health). Machine doc: [?key=CLOUD_HEALTH&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_HEALTH&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_HEALTH](https://miscsubjects.com/api/invocations?object_id=CLOUD_HEALTH).\n\n### CLOUD_FLOW_PROOF\nProof that cloud execution composes like any other capability.\nHuman article: [/a/oip-capability-cloud-flow-proof](https://miscsubjects.com/a/oip-capability-cloud-flow-proof). Machine doc: [?key=CLOUD_FLOW_PROOF&format=markdown](https://miscsubjects.com/api/dispatch?key=CLOUD_FLOW_PROOF&format=markdown). Invocation history: [/api/invocations?object_id=CLOUD_FLOW_PROOF](https://miscsubjects.com/api/invocations?object_id=CLOUD_FLOW_PROOF).\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"}}