## §SELF — miscsubjects capability (paste without context)
**Principle:** Self-explaining payload — no external context required. This _self block is the capability: what it is, how to run it, how to change it, and where to look next.
**Path:** OIP > SURFACE > SURFACE_COMPOSE
**Capability:** `SURFACE_COMPOSE` — Make a new verb out of existing ones and put it in the encyclopedia: shortcut (a signed .shortcut imported into Shortcuts on the Mac, synced to the iPhone), automation (a launchd job on a schedule that runs a verb or a shell line), chain (verbs in order, {{prev}} carries the last output), atom (a directory row SURFACE_<KEY> wrapping one verb, callable in every invocation language).
**When to use:** when a job needs more than one verb, needs a schedule, needs to exist on the phone, or should become a row of its own
**RUN NOW (open this URL):** https://miscsubjects.com/api/dispatch?invoke=SURFACE_COMPOSE&body=chain%7C%7B%22name%22%3A%22Kernel%20name%20echo%22%2C%22steps%22%3A%5B%7B%22id%22%3A%22v_805d282276%22%2C%22args%22%3A%7B%22args%22%3A%22-s%22%7D%7D%2C%7B%22id%22%3A%22v_b65b999ff0%22%2C%22args%22%3A%7B%22args%22%3A%22kernel%20is%20%7B%7Bprev%7D%7D%22%7D%7D%5D%7D&share=<TOKEN>
**Example call:** [SURFACE_COMPOSE]chain|{"name":"Kernel name echo","steps":[{"id":"v_805d282276","args":{"args":"-s"}},{"id":"v_b65b999ff0","args":{"args":"kernel is {{prev}}"}}]}[/SURFACE_COMPOSE]
- **type · runner:** tool · http · surface
- **run it:** Open run_now (URL, fires the example), or POST https://miscsubjects.com/api/dispatch {"key":"SURFACE_COMPOSE","body":"chain|{"name":"Kernel name echo","steps":[{"id":"v_805d282276","args":{"args":"-s"}},{"id":"v_b65b999ff0","args":{"args":"kernel is {{prev}}"}}]}"}. From the router: [SURFACE_COMPOSE]chain|{"name":"Kernel name echo","steps":[{"id":"v_805d282276","args":{"args":"-s"}},{"id":"v_b65b999ff0","args":{"args":"kernel is {{prev}}"}}]}[/SURFACE_COMPOSE]
- **inputs:** {"type":"object","properties":{"kind":{"type":"string"},"spec_json":{"type":"string"}}}
- **outputs:** { ok, result, invocation, yield, _self } — result is this object's output; yield is tokens/cost/material; invocation is the ledgered record.
- **auth · risk:** required · high · approval required
### What this token can do here (computed for: public)
Only moves this credential can take are listed. The server enforces scope regardless; an omitted move would be denied anyway.
- **contract** — GET https://miscsubjects.com/api/dispatch?key=SURFACE_COMPOSE&format=markdown → this object's full contract (public docs plane)
- **confirm** — GET https://miscsubjects.com/api/dispatch?confirm=INV_ID → public proof that an invocation happened — no credential needed
### Machine Contract
- Read this article first; do not infer the row shape from memory.
- If acting with a URL-only tool, open run_now after replacing placeholder args.
- If the call returns ran:false or proof.ok:false, read the receipt and repair the failed invocation instead of narrating success.
- If the token denies the call, report the denial exactly; do not switch to a broader action unless the owner supplied a broader token.
### Invocation, Ledger, Repair
- root tree: https://miscsubjects.com/api/dispatch?map=1&format=markdown
- parent system article: https://miscsubjects.com/api/dispatch?map=SURFACE&format=markdown
- append-only ledger: https://miscsubjects.com/api/invocations?object_id=SURFACE_COMPOSE
- receipt pattern: https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=<TOKEN>
- replay: POST /api/dispatch {"replay":"inv_ID"}
- repair: POST /api/dispatch {"key":"SURFACE_COMPOSE","body":"corrected args","repairs":"inv_ID"}
### Troubleshooting
- **unknown key** — Use the did_you_mean links or ask URL; never guess another key. · https://miscsubjects.com/api/dispatch?ask=SURFACE_COMPOSE
- **argument/body mismatch** — Read inputs/example_args here, then retry with repairs: inv_ID so lineage closes. · https://miscsubjects.com/api/dispatch?key=SURFACE_COMPOSE
- **expired or corrupted token** — Report token_expired/token_corrupted from the response; owner mints a fresh scoped link. · https://miscsubjects.com/api/dispatch?explain=1&share=<TOKEN>
- **tool returned ok:false / exit nonzero** — Do not call it sent. Read the receipt, correct the body, fire a repair. · https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=<TOKEN>
### Logical proof (verify each step)
1. Every capability is an invokable object with its own _self — this block. → https://miscsubjects.com/api/dispatch?key=SURFACE_COMPOSE
2. You run it by POSTing to /api/dispatch; in a model turn the router tag is [SURFACE_COMPOSE]args[/SURFACE_COMPOSE]. → https://miscsubjects.com/api/dispatch?registry=1
3. Every invocation is ledgered with actor, cost, and material/waste. → https://miscsubjects.com/api/invocations?object_id=SURFACE_COMPOSE
4. You can ask the build for capabilities in plain language. → https://miscsubjects.com/api/dispatch?ask=Make%20a%20new%20verb%20out%20of%20existing%20ones%20and
5. The whole build is one self-describing map, with the terminal key. → https://miscsubjects.com/api/dispatch?build=1
### Where to look next
- **registry** — Every capability, self-describing · https://miscsubjects.com/api/dispatch?registry=1
- **ask** — Ask the build what to use, in plain language · https://miscsubjects.com/api/dispatch?ask=<question>
- **history** — This capability's invocation history — its edges · https://miscsubjects.com/api/invocations?object_id=SURFACE_COMPOSE
- **build** — The whole build as one map (terminal key) · https://miscsubjects.com/api/dispatch?build=1
*Self-explaining. Not project knowledge — fetch specifics from the links above.*