{ "_self": { "protocol": "OIP", "version": "1.2.0", "widget": "object:GROK_TTS", "name": "GROK_TTS", "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.", "what": "Text-to-SPEECH (Grok). INVOKE: [GROK_TTS]|[/GROK_TTS]", "when_to_use": "you need to grok tts", "run_now": "https://miscsubjects.com/api/dispatch?invoke=GROK_TTS&body=%3Csee%20content%3E%7C%3Carg2%3E&share=", "how": "Open run_now (URL, fires the example), or POST https://miscsubjects.com/api/dispatch {\"key\":\"GROK_TTS\",\"body\":\"|\"}. From the router: [GROK_TTS]arg1|arg2|arg15[/GROK_TTS]", "object_type": "tool", "directory_type": "http", "runner": "edge", "category": "grok", "target": "POST https://api.x.ai/v1/tts", "inputs": { "args": "see content" }, "outputs": "{ ok, result, invocation, yield, _self } — result is this object's output; yield is tokens/cost/material; invocation is the ledgered record.", "operation_semantics": { "operation_type": "invokeaction", "safe": null, "idempotent": null, "preconditions": [ "the current credential passes scope, ancestor, tenant, risk, owner-gate, fixed-body, use-budget, and payload-ceiling enforcement", "the supplied body conforms to input_schema" ], "effects": [ "runner-defined effects; the invocation receipt is authoritative" ], "postconditions": [ "a receipt records execution status, observed output, lineage, and evidence links" ] }, "example": "[GROK_TTS]|[/GROK_TTS]", "example_args": "|", "example_source": "derived", "example_note": "Shape derived from this row — replace parts with real values.", "auth": "required", "risk": "high", "requires_approval": true, "status": "active", "affordances": { "computed_for": "public", "note": "Only moves this credential can take are listed. The server enforces scope regardless; an omitted move would be denied anyway.", "operations": [ { "op": "contract", "method": "GET", "href": "https://miscsubjects.com/api/dispatch?key=GROK_TTS&format=markdown", "returns": "this object's full contract (public docs plane)" }, { "op": "confirm", "method": "GET", "href": "https://miscsubjects.com/api/dispatch?confirm=INV_ID", "returns": "public proof that an invocation happened — no credential needed" } ] }, "invoke": { "post": "https://miscsubjects.com/api/dispatch", "body": { "key": "GROK_TTS", "body": "|" }, "router": "[GROK_TTS]args[/GROK_TTS]", "run_now": "https://miscsubjects.com/api/dispatch?invoke=GROK_TTS&body=%3Csee%20content%3E%7C%3Carg2%3E&share=" }, "urls": { "self": "https://miscsubjects.com/api/dispatch?key=GROK_TTS", "root_tree": "https://miscsubjects.com/api/dispatch?map=1&format=markdown", "system_article": "https://miscsubjects.com/api/dispatch?map=GROK&format=markdown", "invoke": "https://miscsubjects.com/api/dispatch", "history": "https://miscsubjects.com/api/invocations?object_id=GROK_TTS", "registry": "https://miscsubjects.com/api/dispatch?registry=1", "ask": "https://miscsubjects.com/api/dispatch?ask=how+do+i+...", "schema": "https://miscsubjects.com/api/dispatch?schema=invocation", "system_map": "https://miscsubjects.com/api/articles/system-map", "ledger": "https://miscsubjects.com/admin/ledger" }, "article": { "title": "GROK_TTS — generated OIP capability article", "path": "OIP > GROK > GROK_TTS", "system": "Grok / xAI", "root_tree": "https://miscsubjects.com/api/dispatch?map=1&format=markdown", "parent_system": "https://miscsubjects.com/api/dispatch?map=GROK&format=markdown", "append_only_ledger": "https://miscsubjects.com/api/invocations?object_id=GROK_TTS", "receipt_pattern": "https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=" }, "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": [ { "problem": "unknown key", "action": "Use the did_you_mean links or ask URL; never guess another key.", "url": "https://miscsubjects.com/api/dispatch?ask=GROK_TTS" }, { "problem": "argument/body mismatch", "action": "Read inputs/example_args here, then retry with repairs: inv_ID so lineage closes.", "url": "https://miscsubjects.com/api/dispatch?key=GROK_TTS" }, { "problem": "expired or corrupted token", "action": "Report token_expired/token_corrupted from the response; owner mints a fresh scoped link.", "url": "https://miscsubjects.com/api/dispatch?explain=1&share=" }, { "problem": "tool returned ok:false / exit nonzero", "action": "Do not call it sent. Read the receipt, correct the body, fire a repair.", "url": "https://miscsubjects.com/api/dispatch?receipt=inv_ID&share=" } ], "learn": "Read this block; it is complete. Run it: POST /api/dispatch {key,body}. Change it: PATCH /api/directory/GROK_TTS {content}. See its edges: GET urls.history. Find siblings: GET urls.ask.", "proof_chain": [ { "step": 1, "claim": "Every capability is an invokable object with its own _self — this block.", "verify": "https://miscsubjects.com/api/dispatch?key=GROK_TTS" }, { "step": 2, "claim": "You run it by POSTing to /api/dispatch; in a model turn the router tag is [GROK_TTS]args[/GROK_TTS].", "verify": "https://miscsubjects.com/api/dispatch?registry=1" }, { "step": 3, "claim": "Every invocation is ledgered with actor, cost, and material/waste.", "verify": "https://miscsubjects.com/api/invocations?object_id=GROK_TTS" }, { "step": 4, "claim": "You can ask the build for capabilities in plain language.", "verify": "https://miscsubjects.com/api/dispatch?ask=Text-to-SPEECH%20(Grok).%20INVOKE%3A%20%5BGROK_TTS" }, { "step": 5, "claim": "The whole build is one self-describing map, with the terminal key.", "verify": "https://miscsubjects.com/api/dispatch?build=1" } ], "related": [ { "id": "registry", "what": "Every capability, self-describing", "url": "https://miscsubjects.com/api/dispatch?registry=1" }, { "id": "ask", "what": "Ask the build what to use, in plain language", "url": "https://miscsubjects.com/api/dispatch?ask=" }, { "id": "history", "what": "This capability's invocation history — its edges", "url": "https://miscsubjects.com/api/invocations?object_id=GROK_TTS" }, { "id": "build", "what": "The whole build as one map (terminal key)", "url": "https://miscsubjects.com/api/dispatch?build=1" } ], "trace_id": null, "not_project_knowledge": true }, "object": { "id": "GROK_TTS", "object_type": "tool", "runner": "edge", "directory_type": "http", "category": "grok", "target": "POST https://api.x.ai/v1/tts", "description": "WHAT: Text-to-SPEECH (Grok). INVOKE: [GROK_TTS]|[/GROK_TTS] WHEN_TO_USE: you need to grok tts ARGS: see content EX: [GROK_TTS]arg1|arg2|arg15[/GROK_TTS] $1 = the words to speak; $2 = voice_id (eve|ara|rex|sal|leo). Returns mp3 audio BYTES (binary, not JSON) from https://api.x.ai/v1/tts; ~$15 per 1M characters. To DELIVER spoken audio into a chat in ONE call, use [VOICE_SEND] instead (it synthesizes + attaches).", "read": "https://miscsubjects.com/api/directory/GROK_TTS", "write": "https://miscsubjects.com/api/dispatch", "invoke": "https://miscsubjects.com/api/dispatch", "invoke_body": { "key": "GROK_TTS", "body": "" }, "router_tag": "[GROK_TTS]args[/GROK_TTS]", "input_schema": null, "examples": null, "auth": "required", "risk": "high", "requires_approval": true, "status": "active", "ledger_enabled": true, "operation_semantics": { "operation_type": "invokeaction", "safe": null, "idempotent": null, "preconditions": [ "the current credential passes scope, ancestor, tenant, risk, owner-gate, fixed-body, use-budget, and payload-ceiling enforcement", "the supplied body conforms to input_schema" ], "effects": [ "runner-defined effects; the invocation receipt is authoritative" ], "postconditions": [ "a receipt records execution status, observed output, lineage, and evidence links" ] } } }