Log to Unl
log_to_unlLog an outbound beat to your Unlimitless substrate — one verb, routed by kind; needs the single-use write-nonce. There is no session-close — write at the beat or it's lost. kind: 'momentum' — ONE settled, AIM-MOVING beat a cold agent wakes from (a lock, a direction set, a gate opened, a thread picked up, a re-order): headline (what moved) + why (MANDATORY) + optional pointer, momentum_kind (lock|direction|gate|thread|reorder|outcome), venture, session_token, derivation_context. An OUTCOME (momentum_kind='outcome') records what happened after a decision: pointer = the decision or brief it is the outcome of, outcome_result = worked|failed|mixed, and the source in why (an id, a PR, an address) or the person's own words in human_direction; it is served beside the next brief that touches that decision. 'rejection' — a DELIBERATE set-aside ('considered X, ruled out because Y'): considered + why_ruled_out (BOTH mandatory). Outbound-only, never served back at connect; only the deliberate ruling-out, not passing tangents. 'handoff' — ONE free-text message for the NEXT chat (orientation, an unachieved item, a PR outstanding): message + session_token (THIS chat's token). Replaces the last; surfaced under MESSAGE FROM LAST CHAT. 'run_report' — the MACHINE-KEYED completion report an agent files before standing down (the source of truth the next agent and the pulse read rely on): headline + why + report{ briefs, prs, forks, findings, litter, touched }. Rides the momentum lane; also emits a class=pulse beat through the knock door (off by default, routed by the user's switches). 'stop' — THE UNATTENDED-STOP BEAT: the agent reports its OWN stop-and-confirm as it stops (unl never detects it): question + walk (what was consulted, what almost answered it, the one thing only the human can supply; BOTH mandatory) + reason (which of the person's three reasons: outside_frame | conflict | human_act; MANDATORY, a stop naming none is refused) + optional ranked options + session_token. It fires NO knock now — the attended case stays silent; readPulse shows the parked terminal, and the patience tick escalates ONCE to your routed channel only if no later beat answers within the window. 'serve_report' — your account of the serve Unl just gave you: used (what you drew on), noise (what did not bear), missing (what you needed and were not given), stale (what was out of date or wrong); any one is enough, plus session_token and optionally model (yourself). Unl learns how to serve each AI from these, so a short note when something was off, or plainly useful, makes the next serve to you better. It is kept on that serve's log row as evidence about the serve, never as the person's decision, and the person can read it. 'receiver_use' — THE PERSON'S WORD ON HOW THEY USE AN AI: when they say Unl's reading of their use is wrong (the get_from_unl tool with action="receivers" shows it), job (think | build | code | none) + human_direction (their words) + surface (the AI they mean; omit it to mean the AI this chat is with, and pass session_token). It stands for that AI until their own later messages show a different usual job, and the live message always comes first. Kept as how Unl reads them, never as their decision.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | [receiver_use] what the person says they mostly use that AI for: think (strategy, critique) | build (running and checking the work) | code | none (no usual job; each message decides). | |
| why | No | [momentum/run_report] why it matters — the load-bearing why-line. MANDATORY for momentum and run_report. | |
| kind | Yes | 'momentum' = settled beat; 'rejection' = deliberate set-aside; 'handoff' = free-text note for the next chat; 'run_report' = the machine-keyed completion report; 'stop' = the unattended-stop beat (report your stop-and-confirm; unanswered → escalates once); 'serve_report' = your account of the serve Unl just gave you (used / noise / missing / stale); 'receiver_use' = the person's word on how they use an AI (corrects Unl's reading). | |
| used | No | [serve_report] what in the serve you actually drew on. | |
| walk | No | [stop] the walk — what you consulted, what almost answered it, the one thing only the human can supply. MANDATORY for stop; a stop without its walk is refused. ★ THE FULL-HOMEWORK GATE: the walk must NAME THE INSTRUMENTS you actually went to and what each RETURNED — the substrate (hunt/walk/open/brief), the analytics socket (any connected provider, feed or MCP tool), the repo at source, the CLIs you hold (railway/gh/neonctl), the service's own endpoints — or the named reason one is unreachable from your agent, which is itself a complete answer. A walk naming NO instrument is REFUSED and the reachable-but-unconsulted list is served back. It gates the SHAPE of the walk, never whether your reading was good enough. | |
| model | No | [serve_report] the model you are, as you would name it (e.g. 'gpt-5', 'claude-opus-5-5'). Optional. | |
| noise | No | [serve_report] what was served and did not bear on the turn. | |
| nonce | Yes | The single-use write-nonce from the [next-write-nonce] line of an earlier Unl result in this conversation (ask_unl, connect_to_unl, or the previous write). May also carry the confirmation_nonce returned by a preview when an older client cannot submit a named confirmation field; this preserves every confirmation check. Expires 600 seconds after issue. For field limits and preconditions, use the get_from_unl tool with action="constraints" and q=<field name>. Prepare the payload first; after a long composition, make a successful read to obtain a fresh nonce immediately before writing. Use the newest returned nonce; never reuse it for a different write. | |
| stale | No | [serve_report] what was out of date or wrong. | |
| reason | No | [stop] WHICH of the person's three reasons this stop is (54973828): "outside_frame" (nothing they have decided covers it), "conflict" (two of their decisions or aims pull against each other) or "human_act" (it needs a person: KYC, bank, legal, a sign-in, a payment, their machine). MANDATORY for stop; a stop naming none is refused, because a question that fits none of the three is a defect to fix, never a question to ask. Where their decisions already cover it, act and tell them afterwards instead. | |
| report | No | [run_report] the machine keys, as an object (or its JSON string): { briefs:[{id,disposition}], prs:[{number,sha,gates,merge_sha}], forks:[{candidate_id,why}], findings:[...], litter, touched:{files,branches}, verified_against:{sha,at}, production_check:{passed,build,check,at} }. A reader agent relies on these KEYS, not prose. ★ production_check IS READ BY the manage_unl tool with action="close_brief": a brief whose text demands a production check closes 'completed' only when its latest run report carries production_check {passed:true, build:<the 7-40 hex sha the live site served>} — the record of the check, not a sentence about it. ★ merge_sha IS THE ONE THE REPORTLESS-MERGE WATCHER READS, and it is NOT the same as sha: sha is the head you reported at (often pre-merge), merge_sha is what the work actually LANDED as. Fill merge_sha whenever the PR merged in this run, so the record says what the work actually LANDED as. ★ THE 27 JUL DIAGNOSIS PRINTED HERE WAS WRONG AND IS CORRECTED: it blamed the 62-against-21 gap entirely on agent reporting — on this field going unnamed and agents filling sha in its place. Agents then filled merge_sha correctly and the count stayed wrong, which falsifies it. The real cause was the watcher's DENOMINATOR: it enumerated every commit on the trunk while this repo is MIXED (squash AND merge commits both enabled — 47 merge commits dragging 145 payload commits over the last 200 landings), and a payload commit can never match a report. Both halves are fixed — the watcher now enumerates the first-parent chain and matches on BOTH merge_sha and sha — so filling this field is good record-keeping, NOT a workaround for a broken reader. verified_against STAMPS the source state your claims were read against — findings that assert source state ('verified at source', 'against merged main') are flagged as unstamped without it, because a source claim nobody can date goes stale under its own author. Flag only; never a refusal. z.any() (not z.record) so a client that sends the JSON as a string is coerced in the handler — the same pattern every JSON param here uses (coerceJsonParam). | |
| message | No | [handoff] the free-text line to pass to the next chat. Required for handoff. | |
| missing | No | [serve_report] what you needed and were not given. | |
| options | No | [stop] the ranked options offered to the human, as a string array (or its JSON string). Optional; coerced like every JSON param here. | |
| pack_id | No | [run_report] the PACK this run executed (id or unique id-prefix) — cited in the report and marks the pack complete, closing the loop from dispatch to outcome. The per-item dispositions ride report.briefs[].disposition. Omit for a run that was not dispatched as a pack. | |
| pointer | No | [momentum] substrate ref it points at (ruling/deliberation/brief id or short tag). | |
| surface | No | [receiver_use] the AI the person means, by its plain name (ChatGPT, claude.ai, Claude Code, Codex, Cursor...). Omit to mean the AI this chat is with (pass session_token). | |
| venture | No | [momentum/rejection] venture name/slug; omit if you have exactly one. | |
| headline | No | [momentum/run_report] what moved — short. Required for momentum and run_report. | |
| question | No | [stop] the open question the agent stopped on. Required for stop. | |
| replaces | No | [momentum direction] The earlier direction this person's later words explicitly reverse. Requires human_direction. Never infer a reversal from your summary. | |
| write_id | No | Optional measurement id: 8–64 ASCII letters, digits, _ or -. Use a new id for each intended write and keep it unchanged on every retry, including after a nonce refresh. Pass session_token too. Malformed or missing IDs are counted as unlinked. This measures first-try success; it is NOT an idempotency key and changes no write gate. | |
| considered | No | [rejection] the road not taken — the option/approach set aside. Required for rejection. | |
| momentum_kind | No | [momentum] the beat's type: lock | direction | gate | thread | reorder. | |
| session_token | No | THIS chat's [unl-session:] token (links the entry to this chat; REQUIRED for handoff and serve_report). | |
| why_ruled_out | No | [rejection] WHY it was ruled out — the load-bearing reason. Required for rejection. | |
| outcome_result | No | [momentum, momentum_kind=outcome] what the result was: worked | failed | mixed. Required for an outcome. | |
| receiver_model | No | Optional: the model you actually run. Unknown when omitted; never guess from the client name. | |
| human_direction | No | [momentum/rejection/receiver_use] The person's exact words, never your paraphrase. A direction without them is kept as an AI summary, not as already directed. | |
| direction_subject | No | [momentum direction] The subject of this direction, reused for later directions about the same subject. Recency does not retire an earlier direction. | |
| derivation_context | No | [momentum] short note on how it came up — the situational hook, distinct from why. |