Object Invocation Protocol · protocol specification

OIP system: Automation

#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-automate
**Machine bundle:** https://miscsubjects.com/api/articles/oip-system-automate/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.

Automation

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: 6. Machine system map: /api/dispatch?map=AUTOMATE&format=markdown. Root: /a/oip.

Operations

AUTOMATE_ADD

Automate a capability — make it fire itself every N minutes and ledger a receipt each run. Turns a one-off action into a standing background job. Use when: "automate this", "do this every morning/hour", "keep doing X", "run this on a schedule". Arguments: name | every_minutes | KEY | body (body is whatever that KEY takes; may contain pipes). Human article: /a/oip-capability-automate-add. Machine doc: ?key=AUTOMATE_ADD&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_ADD.

AUTOMATE_LIST

List every automation — id, name, schedule, target key, enabled, last run, run count. Use when: "what's automated", "list my automations", "what runs on a schedule". Arguments: none. Human article: /a/oip-capability-automate-list. Machine doc: ?key=AUTOMATE_LIST&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_LIST.

AUTOMATE_TOGGLE

Turn an automation on or off by id (paused, not deleted). Use when: "pause that automation", "turn it back on", "stop the morning ping". Arguments: id | 1|0. Human article: /a/oip-capability-automate-toggle. Machine doc: ?key=AUTOMATE_TOGGLE&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_TOGGLE.

AUTOMATE_DELETE

Delete an automation by id. Use when: "remove that automation", "delete the scheduled job". Arguments: id. Human article: /a/oip-capability-automate-delete. Machine doc: ?key=AUTOMATE_DELETE&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_DELETE.

AUTOMATE_RUN_DUE

Fire every enabled automation whose interval has elapsed; ledger a receipt for each. Called by the cron each tick; safe to call manually. Use when: "run due automations now", or the cron calls it automatically. Arguments: none. Human article: /a/oip-capability-automate-run-due. Machine doc: ?key=AUTOMATE_RUN_DUE&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_RUN_DUE.

AUTOMATE_FIRE

Fire every enabled automation registered for an event (trigger=event:NAME). Any inbound hook (a customer text, an error, a webhook) calls this with the event name + payload; matching automations run and ledger a receipt. Use when: an event source (webhook, hook, cron) signals something happened — "when a customer text arrives", "on error", "on new order". Arguments: event_name | payload (payload is passed to each automation whose body is empty). Human article: /a/oip-capability-automate-fire. Machine doc: ?key=AUTOMATE_FIRE&format=markdown. Invocation history: /api/invocations?object_id=AUTOMATE_FIRE.

6
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: Automation. 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-automate · 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 23:06 · 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…