OIP capability: PSYCH_INGEST
This is one executable OIP object. It is the leaf where prose stops and exact invocation begins.
Add corpus entries for one subject. Declared frame and state are owner-supplied, never model-inferred.
Parent system: PSYCH. Root: /a/oip. Machine doc: /api/dispatch?key=PSYCH_INGEST&format=markdown. Invocation history: /api/invocations?object_id=PSYCH_INGEST.
Invoke
Example: [PSYCH_INGEST]{"subject":"owner","entries":[{"title":"The Man In the Mirror","frame":"first_person","state":"elevated","text":"..."}]}[/PSYCH_INGEST]
Run URL: https://miscsubjects.com/api/dispatch?invoke=PSYCH_INGEST&body=%7B%22subject%22%3A%22owner%22%2C%22entries%22%3A%5B%7B%22title%22%3A%22The%20Man%20In%20the%20Mirror%22%2C%22frame%22%3A%22first_person%22%2C%22state%22%3A%22elevated%22%2C%22text%22%3A%22...%22%7D%5D%7D&share=<TOKEN>
Auth: required. Risk: low.
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.
Troubleshooting
- unknown key - Use the did_you_mean links or ask URL; never guess another key.
- argument/body mismatch - Read inputs/example_args here, then retry with repairs: inv_ID so lineage closes.
- expired or corrupted token - Report token_expired/token_corrupted from the response; owner mints a fresh scoped link.
- tool returned ok:false / exit nonzero - Do not call it sent. Read the receipt, correct the body, fire a repair.
Receipt loop
After any action, open the receipt. If it is wrong, repair it with POST /api/dispatch {key, body, repairs:"inv_ID"}. If you need to repeat the exact recorded call, replay it with POST /api/dispatch {replay:"inv_ID"}.
Full generated capability doc
§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 > PSYCH > PSYCH_INGEST Capability: PSYCH_INGEST — Add corpus entries for one subject. Declared frame and state are owner-supplied, never model-inferred. RUN NOW (open this URL): https://miscsubjects.com/api/dispatch?invoke=PSYCH_INGEST&body=%7B%22subject%22%3A%22owner%22%2C%22entries%22%3A%5B%7B%22title%22%3A%22The%20Man%20In%20the%20Mirror%22%2C%22frame%22%3A%22first_person%22%2C%22state%22%3A%22elevated%22%2C%22text%22%3A%22...%22%7D%5D%7D&share=<TOKEN> Example call: [PSYCH_INGEST]{"subject":"owner","entries":[{"title":"The Man In the Mirror","frame":"first_person","state":"elevated","text":"..."}]}[/PSYCH_INGEST]
- type · runner: tool · http · psych
- run it: Open run_now (URL, fires the example), or POST https://miscsubjects.com/api/dispatch {"key":"PSYCH_INGEST","body":"{"subject":"owner","entries":[{"title":"The Man In the Mirror","frame":"first_person","state":"elevated","text":"..."}]}"}. From the router: [PSYCH_INGEST]{"subject":"owner","entries":[{"title":"The Man In the Mirror","frame":"first_person","state":"elevated","text":"..."}]}[/PSYCH_INGEST]
- inputs: {"args":"JSON {subject, entries:[{title,date,frame,state,substance,text}]}"}
- 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 · low
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=PSYCH&format=markdown
- append-only ledger: https://miscsubjects.com/api/invocations?object_id=PSYCH_INGEST
- receipt pattern: https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=<TOKEN>
- replay: POST /api/dispatch {"replay":"inv_ID"}
- repair: POST /api/dispatch {"key":"PSYCH_INGEST","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=PSYCH_INGEST
- argument/body mismatch — Read inputs/example_args here, then retry with repairs: inv_ID so lineage closes. · https://miscsubjects.com/api/dispatch?key=PSYCH_INGEST
- 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)
- Every capability is an invokable object with its own _self — this block. → https://miscsubjects.com/api/dispatch?key=PSYCH_INGEST
- You run it by POSTing to /api/dispatch; in a model turn the router tag is [PSYCH_INGEST]args[/PSYCH_INGEST]. → https://miscsubjects.com/api/dispatch?registry=1
- Every invocation is ledgered with actor, cost, and material/waste. → https://miscsubjects.com/api/invocations?object_id=PSYCH_INGEST
- You can ask the build for capabilities in plain language. → https://miscsubjects.com/api/dispatch?ask=Add%20corpus%20entries%20for%20one%20subject.%20Decl
- 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=PSYCH_INGEST
- 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.