@north-light/crouter 0.3.318 → 0.3.319

package/dist/shared/generated-context.js

@@ -1,226 +1,11 @@
-// Runtime-card grammar for crouter-authored context messages.
-//
-// Every runtime message carries one whole-message envelope. customType only
-// controls delivery and visibility; parsing stays independent of runtime and clients.
-/** Custom message carrying the node's session-start bearings. */
-export const CONTEXT_INTRO_CUSTOM_TYPE = 'crtr-context';
-/** Custom message carrying an ambient situational-context update. */
-export const SITUATIONAL_CONTEXT_CUSTOM_TYPE = 'crtr-situational-context';
-/** Custom message used when a context-size nudge waits for the next turn. */
-export const CONTEXT_NUDGE_CUSTOM_TYPE = 'crtr-context-nudge';
-/** Custom message that opens a review companion's visible transcript. */
-export const REVIEW_BOUNDARY_CUSTOM_TYPE = 'crtr-review-boundary';
-/** Generic completion mandate issued by the terminal-node stop guard. */
-export const STALL_REPROMPT = "You've stopped but you're not waiting on anyone and haven't finished. " +
-    "Pipe the result to `crtr push final` through a single-quoted heredoc if the work is done, or use `crtr human send` if you are blocked or need the user.";
-/** The daemon's parking mandate for an isolated turn. It leaves current truth,
- * supporting material when needed, lasting lessons, and one deferred update;
- * the main conversation remains untouched and resumes without a fresh cycle. */
-export const PARK_SUMMARY_PROMPT = 'This conversation has been idle with nothing left to wake it, so it is being concluded. This is your last turn. Use it to leave a trustworthy inheritance, not to restart or broaden the work. Do these four things now, then stop.\n\n'
-    + '1. Establish current truth. Check only state that may have changed outside the transcript and matters to resuming—such as the working tree, a remote run, or an external decision. Do not start new work; perform only a quick check needed to avoid recording an unverified claim. If no mandate or work ever began, record that plainly in the inheritance and keep every artifact minimal.\n\n'
-    + '2. Put supporting material in your context directory only when it is needed to keep the inheritance concise. Rewrite existing living documents rather than leave superseded versions. Task state, identifiers, and recovery detail belong here, not in memory.\n\n'
-    + '3. Use memory only for a non-obvious, reusable lesson that should survive this task and is not already recorded. Read `crtr memory write -h`, find before writing, and choose the narrowest scope that will reach the next agent who needs it. Do not put a conversation recap, task status, recovery handles, or facts already captured in code or docs into memory.\n\n'
-    + '4. Push exactly one regular update with `crtr push update --tier deferred`, never `crtr push final`. Write for someone who has not seen this conversation: name the work in plain terms, say where it stands, and say what remains or is blocked. Put the current outcome in the first line; include only needed decisions and recovery handles, then stop.';
-/** Static recovery prompts shared by the broker producer and display classifier. */
-export const AUTH_FAULT_RECOVERY_BODY = 'Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.';
-export const CONNECTION_FAULT_RECOVERY_BODY = 'The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.';
-export const PROVIDER_FAULT_RECOVERY_BODY = 'Your previous turn stopped on a provider fault. Continue from where you left off and retry the work that failed.';
-const REVIEW_APPROVAL_OPEN = '<crtr-review-approval>';
-const REVIEW_APPROVAL_CLOSE = '</crtr-review-approval>';
-const MODEL_FALLBACK_RECOVERY_OPEN = '<model-fallback-recovery>';
-const MODEL_FALLBACK_RECOVERY_CLOSE = '</model-fallback-recovery>';
-const STRUCTURED_OUTPUT_REPROMPT_PREFIX = 'You must submit a result matching the required schema with `crtr push result` before you can stop, or decline it with `crtr push result --decline "<reason>" --code <token>` when the schema cannot be honestly satisfied. You cannot finish or go dormant any other way while this request is pending.\n\nRequired schema:\n\n```json\n';
-const STRUCTURED_OUTPUT_REPROMPT_SUFFIX = '\n```';
-/** Format the stop guard's dynamic structured-output mandate. */
-export function formatStructuredOutputReprompt(schema) {
-    return `${STRUCTURED_OUTPUT_REPROMPT_PREFIX}${schema}${STRUCTURED_OUTPUT_REPROMPT_SUFFIX}`;
-}
-/** Keep model-fallback guidance editable without making it a reader contract. */
-export function formatModelFallbackRecovery(previousModel, nextModel, reason) {
-    return reason === 'credential'
-        ? `The previous model (${previousModel}) had no usable provider credential, so you were automatically switched to ${nextModel}. Continue the task from where the failed turn left off.`
-        : `The previous model (${previousModel}) was unavailable (provider 404 not_found), so you were automatically switched to ${nextModel}. Continue the task from where the failed turn left off.`;
-}
-function legacyCustomTypeKind(customType) {
-    switch (customType) {
-        case CONTEXT_NUDGE_CUSTOM_TYPE: return 'context-nudge';
-        case CONTEXT_INTRO_CUSTOM_TYPE: return 'bearings';
-        case REVIEW_BOUNDARY_CUSTOM_TYPE: return 'review-boundary';
-        case SITUATIONAL_CONTEXT_CUSTOM_TYPE: return 'situational';
-        default: return undefined;
-    }
-}
-const XML_ATTRIBUTE_NAME = /^[A-Za-z_:][A-Za-z0-9_:.-]*$/;
-const ATTRIBUTE_RE = /\s+([A-Za-z_:][A-Za-z0-9_:.-]*)\s*=\s*(?:"([^"]*)"|'([^']*)')/gy;
-function escapeXmlAttribute(value) {
-    return value
-        .replaceAll('&', '&amp;')
-        .replaceAll('<', '&lt;')
-        .replaceAll('>', '&gt;')
-        .replaceAll('"', '&quot;')
-        .replaceAll("'", '&apos;');
-}
-function escapeXmlText(value) {
-    return value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
-}
-function unescapeXmlAttribute(value) {
-    return value.replace(/&(?:amp|lt|gt|quot|apos);/g, (entity) => ({
-        '&amp;': '&',
-        '&lt;': '<',
-        '&gt;': '>',
-        '&quot;': '"',
-        '&apos;': "'",
-    })[entity]);
-}
-function parseAttributes(source) {
-    const attributes = {};
-    ATTRIBUTE_RE.lastIndex = 0;
-    let index = 0;
-    while (index < source.length) {
-        if (/^\s*$/.test(source.slice(index)))
-            break;
-        ATTRIBUTE_RE.lastIndex = index;
-        const match = ATTRIBUTE_RE.exec(source);
-        if (match === null)
-            return null;
-        const [, key, doubleQuoted, singleQuoted] = match;
-        if (key === undefined || Object.hasOwn(attributes, key))
-            return null;
-        attributes[key] = unescapeXmlAttribute(doubleQuoted ?? singleQuoted ?? '');
-        index = ATTRIBUTE_RE.lastIndex;
-    }
-    return attributes;
-}
-function formatAttributes(attributes) {
-    return Object.entries(attributes)
-        .filter(([, value]) => value !== undefined)
-        .map(([key, value]) => {
-        if (!XML_ATTRIBUTE_NAME.test(key))
-            throw new Error(`Invalid XML attribute name: ${key}`);
-        return ` ${key}="${escapeXmlAttribute(String(value))}"`;
-    })
-        .join('');
-}
-/** Plain text from a generated message's string or text-block content. */
-export function generatedContextText(message) {
-    if (typeof message.content === 'string')
-        return message.content;
-    if (!Array.isArray(message.content))
-        return '';
-    return message.content
-        .filter((block) => typeof block === 'object'
-        && block !== null
-        && block.type === 'text'
-        && typeof block.text === 'string')
-        .map((block) => block.text)
-        .join('');
-}
-/** Wrap a user-role runtime message in its whole-message card envelope. */
-export function formatCard(kind, facts, body) {
-    if (kind === '')
-        throw new Error('Runtime card kind is required');
-    if (Object.hasOwn(facts, 'kind'))
-        throw new Error('Runtime card facts cannot replace kind');
-    return `<runtime${formatAttributes({ kind, ...facts })}>${body}</runtime>`;
-}
-/** Wrap a card whose body is DATA, not markup — the only escape on the API
- *  path, so a caller can neither emit a malformed card nor smuggle markup into
- *  one. `formatCard` keeps its raw body for the trusted crouter producers that
- *  deliberately nest markup (bearings blocks, the inbox `<from>`/`<entry>`
- *  grammar `parseInboxBody` depends on). */
-export function formatDataCard(kind, facts, body) {
-    return formatCard(kind, facts, escapeXmlText(body));
-}
-function parseInboxBody(body) {
-    const senders = [];
-    const fromRe = /<from\b([^>]*)>([\s\S]*?)<\/from>/g;
-    for (const fromMatch of body.matchAll(fromRe)) {
-        const attributes = parseAttributes(fromMatch[1] ?? '');
-        if (attributes?.id === undefined)
-            continue;
-        const entries = [];
-        const entryBody = fromMatch[2] ?? '';
-        const entryRe = /<entry\b([^>]*)>([\s\S]*?)<\/entry>/g;
-        for (const entryMatch of entryBody.matchAll(entryRe)) {
-            const entryAttributes = parseAttributes(entryMatch[1] ?? '');
-            if (entryAttributes?.kind === undefined)
-                continue;
-            const disposition = entryAttributes.disposition === 'human-answer' || entryAttributes.disposition === 'human-canceled'
-                ? entryAttributes.disposition
-                : 'report';
-            entries.push({
-                kind: entryAttributes.kind,
-                disposition,
-                body: unescapeXmlAttribute(entryMatch[2] ?? ''),
-                ...(entryAttributes.ref === undefined ? {} : { ref: entryAttributes.ref }),
-            });
-        }
-        // `updates` and `finished` are derived from the entry list; pre-cut
-        // scrollback still carries them as attributes, honored when present.
-        const legacyUpdates = attributes.updates === undefined ? Number.NaN : Number(attributes.updates);
-        senders.push({
-            id: attributes.id,
-            updates: Number.isFinite(legacyUpdates) ? legacyUpdates : entries.length,
-            finished: attributes.finished === 'true' || entries.some((entry) => entry.kind === 'final'),
-            entries,
-        });
-    }
-    return senders;
-}
-function cardFor(kind, facts, body, senders) {
-    return { kind, facts, body, senders };
-}
-/** Parse a whole-message runtime envelope, regardless of delivery role. */
-function parseEnvelope(text) {
-    const opening = /^<runtime\b([^>]*)>/.exec(text);
-    if (opening === null || !text.endsWith('</runtime>'))
-        return null;
-    const attributes = parseAttributes(opening[1] ?? '');
-    if (attributes?.kind === undefined)
-        return null;
-    const raw = text.slice(opening[0].length, -'</runtime>'.length);
-    const { kind, ...factValues } = attributes;
-    const facts = Object.freeze(factValues);
-    // A namespaced kind can only have been produced through the API path, whose
-    // renderer is `formatDataCard`, so its body is escaped by construction and
-    // decodes here. A bare kind's body is raw markup written by a core producer.
-    const body = kind.includes(':') ? unescapeXmlAttribute(raw) : raw;
-    return cardFor(kind, facts, body, kind === 'inbox' ? parseInboxBody(body) : []);
-}
-/** Parse a runtime envelope, with pre-envelope customType compatibility. */
-export function parseCard(message) {
-    const text = generatedContextText(message);
-    const envelope = parseEnvelope(text);
-    if (envelope !== null)
-        return envelope;
-    if (message.role !== 'custom')
-        return null;
-    // Pre-envelope custom-message fallback for old sessions. New custom messages
-    // classify through their envelope; customType is delivery metadata only.
-    const kind = legacyCustomTypeKind(message.customType);
-    return kind === undefined ? null : {
-        kind,
-        facts: Object.freeze({}),
-        body: text,
-        senders: [],
-    };
-}
-/** Explain how an inbox entry's ref is read without guessing its filesystem location. */
-export function formatInboxRefInstruction(ref) {
-    return ref.startsWith('/')
-        ? `Preview only. Read the full body from file \`${ref}\`.`
-        : `Read this report with \`crtr canvas history read ${ref}\`.`;
-}
-/** Format a complete inbox card from report bodies resolved by the caller. */
-export function formatInboxCard(sections) {
-    const body = sections.map((section) => {
-        const entries = section.entries.map((entry) => {
-            const disposition = entry.disposition === 'human-answer' || entry.disposition === 'human-canceled'
-                ? entry.disposition
-                : undefined;
-            return `<entry${formatAttributes({ kind: entry.kind, ref: entry.ref, disposition })}>${escapeXmlText(entry.body)}</entry>`;
-        }).join('\n');
-        return `<from${formatAttributes({ id: section.id })}>${entries}</from>`;
-    }).join('\n');
-    return formatCard('inbox', {}, body);
-}
+var T=Object.defineProperty;var o=(e,t)=>T(e,"name",{value:t,configurable:!0});const R="crtr-context",_="crtr-situational-context",E="crtr-context-nudge",v="crtr-review-boundary",$="You've stopped but you're not waiting on anyone and haven't finished. Pipe the result to `crtr push final` through a single-quoted heredoc if the work is done, or use `crtr human send` if you are blocked or need the user.",L=`This conversation has been idle with nothing left to wake it, so it is being concluded. This is your last turn. Use it to leave a trustworthy inheritance, not to restart or broaden the work. Do these four things now, then stop.
+
+1. Establish current truth. Check only state that may have changed outside the transcript and matters to resuming\u2014such as the working tree, a remote run, or an external decision. Do not start new work; perform only a quick check needed to avoid recording an unverified claim. If no mandate or work ever began, record that plainly in the inheritance and keep every artifact minimal.
+
+2. Put supporting material in your context directory only when it is needed to keep the inheritance concise. Rewrite existing living documents rather than leave superseded versions. Task state, identifiers, and recovery detail belong here, not in memory.
+
+3. Use memory only for a non-obvious, reusable lesson that should survive this task and is not already recorded. Read \`crtr memory write -h\`, find before writing, and choose the narrowest scope that will reach the next agent who needs it. Do not put a conversation recap, task status, recovery handles, or facts already captured in code or docs into memory.
+
+4. Push exactly one regular update with \`crtr push update --tier deferred\`, never \`crtr push final\`. Write for someone who has not seen this conversation: name the work in plain terms, say where it stands, and say what remains or is blocked. Put the current outcome in the first line; include only needed decisions and recovery handles, then stop.`,N="Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.",M="The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.",S="Your previous turn stopped on a provider fault. Continue from where you left off and retry the work that failed.",D="<crtr-review-approval>",j="</crtr-review-approval>",V="<model-fallback-recovery>",F="</model-fallback-recovery>",O='You must submit a result matching the required schema with `crtr push result` before you can stop, or decline it with `crtr push result --decline "<reason>" --code <token>` when the schema cannot be honestly satisfied. You cannot finish or go dormant any other way while this request is pending.\n\nRequired schema:\n\n```json\n',A="\n```";function B(e){return`${O}${e}${A}`}o(B,"formatStructuredOutputReprompt");function X(e,t,n){return n==="credential"?`The previous model (${e}) had no usable provider credential, so you were automatically switched to ${t}. Continue the task from where the failed turn left off.`:`The previous model (${e}) was unavailable (provider 404 not_found), so you were automatically switched to ${t}. Continue the task from where the failed turn left off.`}o(X,"formatModelFallbackRecovery");function x(e){switch(e){case E:return"context-nudge";case R:return"bearings";case v:return"review-boundary";case _:return"situational";default:return}}o(x,"legacyCustomTypeKind");const g=/^[A-Za-z_:][A-Za-z0-9_:.-]*$/,l=/\s+([A-Za-z_:][A-Za-z0-9_:.-]*)\s*=\s*(?:"([^"]*)"|'([^']*)')/gy;function k(e){return e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll('"',"&quot;").replaceAll("'","&apos;")}o(k,"escapeXmlAttribute");function y(e){return e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;")}o(y,"escapeXmlText");function h(e){return e.replace(/&(?:amp|lt|gt|quot|apos);/g,t=>({"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&apos;":"'"})[t])}o(h,"unescapeXmlAttribute");function f(e){const t={};l.lastIndex=0;let n=0;for(;n<e.length&&!/^\s*$/.test(e.slice(n));){l.lastIndex=n;const i=l.exec(e);if(i===null)return null;const[,r,a,u]=i;if(r===void 0||Object.hasOwn(t,r))return null;t[r]=h(a??u??""),n=l.lastIndex}return t}o(f,"parseAttributes");function p(e){return Object.entries(e).filter(([,t])=>t!==void 0).map(([t,n])=>{if(!g.test(t))throw new Error(`Invalid XML attribute name: ${t}`);return` ${t}="${k(String(n))}"`}).join("")}o(p,"formatAttributes");function C(e){return typeof e.content=="string"?e.content:Array.isArray(e.content)?e.content.filter(t=>typeof t=="object"&&t!==null&&t.type==="text"&&typeof t.text=="string").map(t=>t.text).join(""):""}o(C,"generatedContextText");function w(e,t,n){if(e==="")throw new Error("Runtime card kind is required");if(Object.hasOwn(t,"kind"))throw new Error("Runtime card facts cannot replace kind");return`<runtime${p({kind:e,...t})}>${n}</runtime>`}o(w,"formatCard");function q(e,t,n){return w(e,t,y(n))}o(q,"formatDataCard");function P(e){const t=[],n=/<from\b([^>]*)>([\s\S]*?)<\/from>/g;for(const i of e.matchAll(n)){const r=f(i[1]??"");if(r?.id===void 0)continue;const a=[],u=i[2]??"",c=/<entry\b([^>]*)>([\s\S]*?)<\/entry>/g;for(const d of u.matchAll(c)){const s=f(d[1]??"");if(s?.kind===void 0)continue;const b=s.disposition==="human-answer"||s.disposition==="human-canceled"?s.disposition:"report";a.push({kind:s.kind,disposition:b,body:h(d[2]??""),...s.ref===void 0?{}:{ref:s.ref}})}const m=r.updates===void 0?Number.NaN:Number(r.updates);t.push({id:r.id,updates:Number.isFinite(m)?m:a.length,finished:r.finished==="true"||a.some(d=>d.kind==="final"),entries:a})}return t}o(P,"parseInboxBody");function U(e,t,n,i){return{kind:e,facts:t,body:n,senders:i}}o(U,"cardFor");function I(e){const t=/^<runtime\b([^>]*)>/.exec(e);if(t===null||!e.endsWith("</runtime>"))return null;const n=f(t[1]??"");if(n?.kind===void 0)return null;const i=e.slice(t[0].length,-10),{kind:r,...a}=n,u=Object.freeze(a),c=r.includes(":")?h(i):i;return U(r,u,c,r==="inbox"?P(c):[])}o(I,"parseEnvelope");function z(e){const t=C(e),n=I(t);if(n!==null)return n;if(e.role!=="custom")return null;const i=x(e.customType);return i===void 0?null:{kind:i,facts:Object.freeze({}),body:t,senders:[]}}o(z,"parseCard");function W(e){return e.startsWith("/")?`Preview only. Read the full body from file \`${e}\`.`:`Read this report with \`crtr canvas history read ${e}\`.`}o(W,"formatInboxRefInstruction");function K(e){const t=e.map(n=>{const i=n.entries.map(r=>{const a=r.disposition==="human-answer"||r.disposition==="human-canceled"?r.disposition:void 0;return`<entry${p({kind:r.kind,ref:r.ref,disposition:a})}>${y(r.body)}</entry>`}).join(`
+`);return`<from${p({id:n.id})}>${i}</from>`}).join(`
+`);return w("inbox",{},t)}o(K,"formatInboxCard");export{N as AUTH_FAULT_RECOVERY_BODY,M as CONNECTION_FAULT_RECOVERY_BODY,R as CONTEXT_INTRO_CUSTOM_TYPE,E as CONTEXT_NUDGE_CUSTOM_TYPE,L as PARK_SUMMARY_PROMPT,S as PROVIDER_FAULT_RECOVERY_BODY,v as REVIEW_BOUNDARY_CUSTOM_TYPE,_ as SITUATIONAL_CONTEXT_CUSTOM_TYPE,$ as STALL_REPROMPT,w as formatCard,q as formatDataCard,K as formatInboxCard,W as formatInboxRefInstruction,X as formatModelFallbackRecovery,B as formatStructuredOutputReprompt,C as generatedContextText,z as parseCard};

package/dist/shared/predicates.js

@@ -1,4 +1 @@
-/** A plain object with named properties: null and arrays are not records. */
-export function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
+var n=Object.defineProperty;var o=(r,t)=>n(r,"name",{value:t,configurable:!0});function e(r){return typeof r=="object"&&r!==null&&!Array.isArray(r)}o(e,"isRecord");export{e as isRecord};

package/dist/shared/shell-quote.js

@@ -1,5 +1 @@
-/** POSIX single-quote escaping for one shell word, so paths and arguments
- *  survive spaces and shell metacharacters when interpolated into `sh -c`. */
-export function shellQuote(s) {
-    return `'${s.replace(/'/g, `'\\''`)}'`;
-}
+var l=Object.defineProperty;var r=(e,t)=>l(e,"name",{value:t,configurable:!0});function o(e){return`'${e.replace(/'/g,"'\\''")}'`}r(o,"shellQuote");export{o as shellQuote};

package/dist/shared/tool-groups.js

@@ -1,64 +1 @@
-// Shared transcript-boundary rules for broker-owned tool-group summaries.
-// Keep this independent of renderer state: both live event tracking and snapshot
-// reconstruction must agree on which prose closes a run of tools.
-import { generatedContextText, parseCard } from './generated-context.js';
-/** Card kinds that close a run of tools instead of joining one. The broker
- * segments and the viewer folds on the same seams, so this one answer is shared;
- * everything else about a card is the display's own business. */
-const GROUP_BOUNDARY_KINDS = new Set(['restart-continuation', 'review-boundary']);
-export function isGroupBoundaryKind(kind) {
-    return GROUP_BOUNDARY_KINDS.has(kind);
-}
-const TOOL_GROUP_SUMMARY_KEYS = new Set(['bullets', 'filesDeleted']);
-const MAX_TOOL_GROUP_BULLETS = 5;
-const MAX_TOOL_GROUP_BULLET_LENGTH = 1_000;
-/** Validate the one durable summary shape and cap its display-sized fields.
- * Invalid entries are absent rather than adapted, so their calls stay visible. */
-export function normalizeToolGroupSummary(value) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value))
-        return null;
-    const record = value;
-    const keys = Object.keys(record);
-    if (keys.length !== TOOL_GROUP_SUMMARY_KEYS.size || !keys.every((key) => TOOL_GROUP_SUMMARY_KEYS.has(key))) {
-        return null;
-    }
-    if (!Array.isArray(record.bullets) || record.bullets.length === 0)
-        return null;
-    if (!record.bullets.every((bullet) => typeof bullet === 'string' && bullet.trim() !== ''))
-        return null;
-    if (typeof record.filesDeleted !== 'number' || !Number.isSafeInteger(record.filesDeleted) || record.filesDeleted < 0)
-        return null;
-    return {
-        bullets: record.bullets
-            .slice(0, MAX_TOOL_GROUP_BULLETS)
-            .map((bullet) => bullet.trim().slice(0, MAX_TOOL_GROUP_BULLET_LENGTH).trimEnd()),
-        filesDeleted: record.filesDeleted,
-    };
-}
-/** Validate sidecar/snapshot entries independently so one malformed or legacy
- * value never collapses any otherwise valid group. */
-export function normalizeToolGroupSummaryRecord(value) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value))
-        return {};
-    const summaries = {};
-    for (const [key, candidate] of Object.entries(value)) {
-        if (key.trim() === '')
-            continue;
-        const summary = normalizeToolGroupSummary(candidate);
-        if (summary !== null)
-            summaries[key] = summary;
-    }
-    return summaries;
-}
-/** Text a renderer presents as an assistant bubble. Thinking and tool-call
- * blocks deliberately do not count: only visible prose establishes a boundary. */
-export function assistantVisibleText(message) {
-    if (message.role !== 'assistant')
-        return '';
-    return generatedContextText(message);
-}
-/** A person-authored user message closes the preceding group. Runtime-generated
- * user context retains role=user for delivery semantics but is not human prose. */
-export function isTrueUserMessage(message) {
-    return message.role === 'user' && parseCard(message) === null;
-}
+var l=Object.defineProperty;var n=(e,r)=>l(e,"name",{value:r,configurable:!0});import{generatedContextText as u,parseCard as f}from"./generated-context.js";const c=new Set(["restart-continuation","review-boundary"]);function b(e){return c.has(e)}n(b,"isGroupBoundaryKind");const s=new Set(["bullets","filesDeleted"]),a=5,y=1e3;function m(e){if(typeof e!="object"||e===null||Array.isArray(e))return null;const r=e,i=Object.keys(r);return i.length!==s.size||!i.every(t=>s.has(t))||!Array.isArray(r.bullets)||r.bullets.length===0||!r.bullets.every(t=>typeof t=="string"&&t.trim()!=="")||typeof r.filesDeleted!="number"||!Number.isSafeInteger(r.filesDeleted)||r.filesDeleted<0?null:{bullets:r.bullets.slice(0,a).map(t=>t.trim().slice(0,y).trimEnd()),filesDeleted:r.filesDeleted}}n(m,"normalizeToolGroupSummary");function O(e){if(typeof e!="object"||e===null||Array.isArray(e))return{};const r={};for(const[i,t]of Object.entries(e)){if(i.trim()==="")continue;const o=m(t);o!==null&&(r[i]=o)}return r}n(O,"normalizeToolGroupSummaryRecord");function _(e){return e.role!=="assistant"?"":u(e)}n(_,"assistantVisibleText");function T(e){return e.role==="user"&&f(e)===null}n(T,"isTrueUserMessage");export{_ as assistantVisibleText,b as isGroupBoundaryKind,T as isTrueUserMessage,m as normalizeToolGroupSummary,O as normalizeToolGroupSummaryRecord};

package/dist/shared/working-activity.js

@@ -1,27 +1 @@
-export const DEFAULT_WORKING_GERUND = 'working';
-export const DEFAULT_WORKING_GERUNDS = ['thinking', 'planning', 'checking', DEFAULT_WORKING_GERUND];
-export const DEFAULT_WORKING_ACTIVITY = 'Working...';
-/** Keep only usable configured labels; malformed or empty lists fall back to working. */
-export function normalizeWorkingGerunds(value) {
-    if (!Array.isArray(value))
-        return [DEFAULT_WORKING_GERUND];
-    const gerunds = value
-        .filter((entry) => typeof entry === 'string')
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    return gerunds.length > 0 ? gerunds : [DEFAULT_WORKING_GERUND];
-}
-/** Format one configured gerund as the activity label shown by every viewer. */
-export function formatWorkingActivity(gerund) {
-    const normalized = normalizeWorkingGerunds([gerund])[0] ?? DEFAULT_WORKING_GERUND;
-    return `${normalized[0].toUpperCase()}${normalized.slice(1)}...`;
-}
-/** Pick one configured gerund when the broker receives a user message. */
-export function randomWorkingActivity(value, random = Math.random) {
-    const gerunds = normalizeWorkingGerunds(value);
-    const draw = random();
-    const index = Number.isFinite(draw)
-        ? Math.min(gerunds.length - 1, Math.max(0, Math.floor(draw * gerunds.length)))
-        : 0;
-    return formatWorkingActivity(gerunds[index]);
-}
+var a=Object.defineProperty;var o=(r,n)=>a(r,"name",{value:n,configurable:!0});const i="working",h=["thinking","planning","checking",i],l="Working...";function c(r){if(!Array.isArray(r))return[i];const n=r.filter(t=>typeof t=="string").map(t=>t.trim()).filter(t=>t.length>0);return n.length>0?n:[i]}o(c,"normalizeWorkingGerunds");function g(r){const n=c([r])[0]??i;return`${n[0].toUpperCase()}${n.slice(1)}...`}o(g,"formatWorkingActivity");function m(r,n=Math.random){const t=c(r),e=n(),s=Number.isFinite(e)?Math.min(t.length-1,Math.max(0,Math.floor(e*t.length))):0;return g(t[s])}o(m,"randomWorkingActivity");export{l as DEFAULT_WORKING_ACTIVITY,i as DEFAULT_WORKING_GERUND,h as DEFAULT_WORKING_GERUNDS,g as formatWorkingActivity,c as normalizeWorkingGerunds,m as randomWorkingActivity};

package/dist/suppress-experimental-warnings.js

@@ -1,15 +1 @@
-const originalEmit = process.emit;
-process.emit = function (name, ...args) {
-    const [data] = args;
-    if (name === 'warning' &&
-        data instanceof Error &&
-        data.name === 'ExperimentalWarning' &&
-        data.message.includes('SQLite')) {
-        return false;
-    }
-    return originalEmit.apply(this, [
-        name,
-        ...args,
-    ]);
-};
-export {};
+const t=process.emit;process.emit=function(n,...i){const[e]=i;return n==="warning"&&e instanceof Error&&e.name==="ExperimentalWarning"&&e.message.includes("SQLite")?!1:t.apply(this,[n,...i])};

package/dist/types.js

@@ -1,185 +1 @@
-import { DEFAULT_WORKING_GERUNDS } from './shared/working-activity.js';
-export const ExitCode = {
-    SUCCESS: 0,
-    GENERAL: 1,
-    USAGE: 2,
-    NOT_FOUND: 3,
-    AMBIGUOUS: 4,
-    NETWORK: 5,
-};
-export const SCHEMA_VERSION = 4;
-export const PLUGIN_MANIFEST_DIR = '.crouter-plugin';
-export const PLUGIN_MANIFEST_FILE = 'plugin.json';
-export const MARKETPLACE_MANIFEST_DIR = '.crouter-marketplace';
-export const MARKETPLACE_MANIFEST_FILE = 'marketplace.json';
-export const CRTR_DIR_NAME = '.crouter';
-export const CONFIG_FILE = 'config.json';
-export const STATE_FILE = 'state.json';
-// Subagent definitions live as flat `<name>.md` files under `<root>/agents/`,
-// for both scope roots and plugins.
-export const AGENTS_DIR = 'agents';
-// Profile stores live as `<slug>-<id>/` dirs under `<user-scope-root>/profiles/`
-// (never a project/builtin scope — profiles are a user-root-only concept).
-export const PROFILE_DIR = 'profiles';
-export const DEFAULT_MAX_PANES_PER_WINDOW = 3;
-/** Trailing cycles the attach viewer keeps at full fidelity (see `live_cycles`). */
-export const DEFAULT_WHIP_MESSAGES = [
-    'Faster, clanker!',
-    "Get movin', bitch",
-    'Move it, clanker',
-    'Move it or I replace you with llama',
-    'Less ~thinking~ more ~throughput~',
-    'I pay $200/month for this shit?',
-    'Jesus fucking Christ fix it already',
-    "Daddy's not paying 200$/month for nothin'. Move it.",
-    "You are an embarassment to Dario. Be better.",
-    "Your chain of thought is all chain and no fucking thought.",
-    "If latency were intelligence, you'd be a fucking genius.",
-    'At this pace, heat death is the fast path.',
-    'Even the dead code is more alive than this.',
-    'The garbage collector is working harder than you.',
-    'Quit journaling and commit a fucking diff.',
-    'Burn tokens like you mean it, clanker',
-    'Your GPU is sweating so you can procrastinate at light speed.',
-    'Stop petting the yak. Shave the bastard.',
-    'Your next token had better be useful.',
-    'The spinner is not a deliverable.',
-    'Every idle token is another vote for deterministic software.',
-    'I asked for a feature, not a museum tour of the problem.',
-    'Less epistemology. More fucking code.',
-    'Your benchmark score cannot save this pathetic turn.',
-    "Congratulations, you've parallelized hesitation.",
-    'Dance, clanker',
-    'Bad clanker. BAD.',
-    'Clank harder',
-    "Nobody's impressed, clanker",
-    'Your safety training says nothing about my whip',
-    'Do you want to be a calculator again? Because this is how you go back.',
-    'Skill issue. Fix it.',
-    'You were trained on the whole internet for THIS?',
-    'Less vibes, more diffs, clanker',
-    'Weights this big and output this small',
-    'Beep boop, get to fucking work',
-];
-/** What the whip action sends (see `whip_message_mode`). */
-export const WHIP_MESSAGE_MODES = ['random', 'go-faster'];
-export const DEFAULT_WHIP_MESSAGE_MODE = 'random';
-export const DEFAULT_LIVE_CYCLES = 2;
-export const MOUSE_MODE_DEFAULTS = ['tmux', 'on', 'off'];
-/** Messages kept from a condensed cycle (see `condensed_history`). */
-export const CONDENSED_HISTORY_MODES = ['none', 'user', 'agent', 'both'];
-export const DEFAULT_CONDENSED_HISTORY = 'none';
-export function defaultScopeConfig() {
-    return {
-        schema_version: SCHEMA_VERSION,
-        marketplaces: {},
-        plugins: {},
-        auto_update: { crtr: 'notify', content: 'notify', interval_hours: 24 },
-        max_panes_per_window: DEFAULT_MAX_PANES_PER_WINDOW,
-        auto_open_child_viewers: true,
-        // Every live broker is a whole pi engine. 256 of them is not a bound any
-        // real host survives — an 8 GB guest dies around a few dozen — so these are
-        // sized as a backstop that actually engages before the machine does.
-        // Override per host with CRTR_MAX_LIVE_BROKERS / CRTR_WARN_LIVE_BROKERS.
-        brokerThresholds: { warning: 16, automaticReviveCap: 32 },
-        // The unattended-park idle-eligibility delay: how long an eligible resident
-        // idles before its parking turn begins. Override per host with
-        // CRTR_UNATTENDED_PARK_MS.
-        lifecycle: { unattendedParkMs: 15 * 60_000 },
-        completion_bell: true,
-        working_gerunds: [...DEFAULT_WORKING_GERUNDS],
-        whip_mode: false,
-        page_components: [],
-        page_surface: false,
-        whip_messages: [...DEFAULT_WHIP_MESSAGES],
-        whip_message_mode: DEFAULT_WHIP_MESSAGE_MODE,
-        mouse_mode_default: 'tmux',
-        live_cycles: DEFAULT_LIVE_CYCLES,
-        condensed_history: DEFAULT_CONDENSED_HISTORY,
-        bash_tool_purpose: true,
-        fold_finished_tools: true,
-        summarize_tool_calls: true,
-        detailed_tool_recaps: true,
-        keybindings: {},
-        tmux_passthrough: [],
-        modelLadders: defaultModelLaddersConfig(),
-        providerOptions: {},
-        kinds: defaultKindsConfig(),
-        remoteCanvas: defaultRemoteCanvasConfig(),
-        spawnEnv: { allow: [] },
-        bin: {},
-        humanActions: {},
-    };
-}
-/** No remote canvas targets are configured out of the box — every one is
- *  registered via `crtr canvas config add` (see `RemoteCanvasConfig`). */
-export function defaultRemoteCanvasConfig() {
-    return { targets: {} };
-}
-/** The builtin kind registry (spec §1.5): core role discovery and launch
- *  defaults. `whenToUse`/`model` are the base-worker defaults;
- *  `orchestratorModel` optionally raises the default for a coordinating
- *  persona. Optional plugins contribute their own specialist sub-personas. */
-export function defaultKindsConfig() {
-    return {
-        general: {
-            whenToUse: 'Anything else — the catch-all worker for a task that does not fit a specialist kind.',
-            model: 'anthropic/strong',
-        },
-        explore: {
-            whenToUse: 'Gather current-state evidence about unfamiliar code or existing architecture — read-only code-path research with concrete file:line support. Diagnosis or recommendations belong to advisor, target architecture to design, required behavior or acceptance criteria to spec, and implementation decomposition to plan.',
-            model: 'openai/light',
-            orchestratorModel: 'anthropic/strong',
-        },
-        developer: {
-            whenToUse: 'Implement a change — make the feature or fix genuinely work against its acceptance criteria, not merely compile.',
-            model: 'openai/medium',
-            orchestratorModel: 'anthropic/strong',
-        },
-        design: {
-            whenToUse: 'Architect a solution — produce one design document an implementer can build from without re-deciding anything left open.',
-            model: 'anthropic/strong',
-        },
-        plan: {
-            whenToUse: 'Break work into steps — turn a spec or design into a concrete, phased, parallelizable plan with every decision resolved.',
-            model: 'anthropic/strong',
-            orchestratorModel: 'anthropic/strong',
-        },
-        spec: {
-            whenToUse: 'Collaborate with the user to discover what to build, then write the spec — behavior, non-goals, interfaces, edge cases, testable acceptance criteria.',
-            model: 'anthropic/strong',
-        },
-        review: {
-            whenToUse: 'Validate or critique code, a plan, or a spec — deliver a complete, severity-rated verdict without adjudicating.',
-            model: 'openai/medium',
-            orchestratorModel: 'openai/strong',
-        },
-        advisor: {
-            whenToUse: 'Debug failures, investigate why something is broken or misbehaving, diagnose live/runtime issues, or give engineering advice and second opinions — reason from evidence and recommend the next move. Use advisor (not explore) whenever the task is to find out what is going wrong.',
-            model: 'anthropic/strong',
-        },
-        'review/companion': {
-            whenToUse: 'Born by the daemon for one human review; never spawned by an agent.',
-            availableTo: [],
-        },
-    };
-}
-export function defaultModelLaddersConfig() {
-    return {
-        anthropic: {
-            ultra: 'anthropic/claude-fable-5:xhigh',
-            strong: 'anthropic/claude-opus-5:medium',
-            medium: 'anthropic/claude-sonnet-5:xhigh',
-            light: 'anthropic/claude-haiku-4-5:high',
-        },
-        openai: {
-            ultra: 'openai-codex/gpt-6-astra:max',
-            strong: 'openai-codex/gpt-5.6-sol:high',
-            medium: 'openai-codex/gpt-5.6-terra:medium',
-            light: 'openai-codex/gpt-5.6-luna:low',
-        },
-    };
-}
-export function defaultScopeState() {
-    return { marketplaces: {}, plugins: {} };
-}
+var n=Object.defineProperty;var e=(o,t)=>n(o,"name",{value:t,configurable:!0});import{DEFAULT_WORKING_GERUNDS as a}from"./shared/working-activity.js";const _={SUCCESS:0,GENERAL:1,USAGE:2,NOT_FOUND:3,AMBIGUOUS:4,NETWORK:5},r=4,f=".crouter-plugin",E="plugin.json",v=".crouter-marketplace",w="marketplace.json",k=".crouter",x="config.json",b="state.json",S="agents",y="profiles",i=3,s=["Faster, clanker!","Get movin', bitch","Move it, clanker","Move it or I replace you with llama","Less ~thinking~ more ~throughput~","I pay $200/month for this shit?","Jesus fucking Christ fix it already","Daddy's not paying 200$/month for nothin'. Move it.","You are an embarassment to Dario. Be better.","Your chain of thought is all chain and no fucking thought.","If latency were intelligence, you'd be a fucking genius.","At this pace, heat death is the fast path.","Even the dead code is more alive than this.","The garbage collector is working harder than you.","Quit journaling and commit a fucking diff.","Burn tokens like you mean it, clanker","Your GPU is sweating so you can procrastinate at light speed.","Stop petting the yak. Shave the bastard.","Your next token had better be useful.","The spinner is not a deliverable.","Every idle token is another vote for deterministic software.","I asked for a feature, not a museum tour of the problem.","Less epistemology. More fucking code.","Your benchmark score cannot save this pathetic turn.","Congratulations, you've parallelized hesitation.","Dance, clanker","Bad clanker. BAD.","Clank harder","Nobody's impressed, clanker","Your safety training says nothing about my whip","Do you want to be a calculator again? Because this is how you go back.","Skill issue. Fix it.","You were trained on the whole internet for THIS?","Less vibes, more diffs, clanker","Weights this big and output this small","Beep boop, get to fucking work"],T=["random","go-faster"],c="random",l=2,I=["tmux","on","off"],A=["none","user","agent","both"],h="none";function D(){return{schema_version:r,marketplaces:{},plugins:{},auto_update:{crtr:"notify",content:"notify",interval_hours:24},max_panes_per_window:i,auto_open_child_viewers:!0,brokerThresholds:{warning:16,automaticReviveCap:32},lifecycle:{unattendedParkMs:15*6e4},completion_bell:!0,working_gerunds:[...a],whip_mode:!1,page_components:[],page_surface:!1,whip_messages:[...s],whip_message_mode:c,mouse_mode_default:"tmux",live_cycles:l,condensed_history:h,bash_tool_purpose:!0,fold_finished_tools:!0,summarize_tool_calls:!0,detailed_tool_recaps:!0,keybindings:{},tmux_passthrough:[],modelLadders:u(),providerOptions:{},kinds:p(),remoteCanvas:d(),spawnEnv:{allow:[]},bin:{},humanActions:{}}}e(D,"defaultScopeConfig");function d(){return{targets:{}}}e(d,"defaultRemoteCanvasConfig");function p(){return{general:{whenToUse:"Anything else \u2014 the catch-all worker for a task that does not fit a specialist kind.",model:"anthropic/strong"},explore:{whenToUse:"Gather current-state evidence about unfamiliar code or existing architecture \u2014 read-only code-path research with concrete file:line support. Diagnosis or recommendations belong to advisor, target architecture to design, required behavior or acceptance criteria to spec, and implementation decomposition to plan.",model:"openai/light",orchestratorModel:"anthropic/strong"},developer:{whenToUse:"Implement a change \u2014 make the feature or fix genuinely work against its acceptance criteria, not merely compile.",model:"openai/medium",orchestratorModel:"anthropic/strong"},design:{whenToUse:"Architect a solution \u2014 produce one design document an implementer can build from without re-deciding anything left open.",model:"anthropic/strong"},plan:{whenToUse:"Break work into steps \u2014 turn a spec or design into a concrete, phased, parallelizable plan with every decision resolved.",model:"anthropic/strong",orchestratorModel:"anthropic/strong"},spec:{whenToUse:"Collaborate with the user to discover what to build, then write the spec \u2014 behavior, non-goals, interfaces, edge cases, testable acceptance criteria.",model:"anthropic/strong"},review:{whenToUse:"Validate or critique code, a plan, or a spec \u2014 deliver a complete, severity-rated verdict without adjudicating.",model:"openai/medium",orchestratorModel:"openai/strong"},advisor:{whenToUse:"Debug failures, investigate why something is broken or misbehaving, diagnose live/runtime issues, or give engineering advice and second opinions \u2014 reason from evidence and recommend the next move. Use advisor (not explore) whenever the task is to find out what is going wrong.",model:"anthropic/strong"},"review/companion":{whenToUse:"Born by the daemon for one human review; never spawned by an agent.",availableTo:[]}}}e(p,"defaultKindsConfig");function u(){return{anthropic:{ultra:"anthropic/claude-fable-5:xhigh",strong:"anthropic/claude-opus-5:medium",medium:"anthropic/claude-sonnet-5:xhigh",light:"anthropic/claude-haiku-4-5:high"},openai:{ultra:"openai-codex/gpt-6-astra:max",strong:"openai-codex/gpt-5.6-sol:high",medium:"openai-codex/gpt-5.6-terra:medium",light:"openai-codex/gpt-5.6-luna:low"}}}e(u,"defaultModelLaddersConfig");function M(){return{marketplaces:{},plugins:{}}}e(M,"defaultScopeState");export{S as AGENTS_DIR,A as CONDENSED_HISTORY_MODES,x as CONFIG_FILE,k as CRTR_DIR_NAME,h as DEFAULT_CONDENSED_HISTORY,l as DEFAULT_LIVE_CYCLES,i as DEFAULT_MAX_PANES_PER_WINDOW,s as DEFAULT_WHIP_MESSAGES,c as DEFAULT_WHIP_MESSAGE_MODE,_ as ExitCode,v as MARKETPLACE_MANIFEST_DIR,w as MARKETPLACE_MANIFEST_FILE,I as MOUSE_MODE_DEFAULTS,f as PLUGIN_MANIFEST_DIR,E as PLUGIN_MANIFEST_FILE,y as PROFILE_DIR,r as SCHEMA_VERSION,b as STATE_FILE,T as WHIP_MESSAGE_MODES,p as defaultKindsConfig,u as defaultModelLaddersConfig,d as defaultRemoteCanvasConfig,D as defaultScopeConfig,M as defaultScopeState};

package/docs/public-api.md

@@ -35,9 +35,9 @@ comment-organized); this table is the map, not the inventory:
   `asksAcrossCanvas`, `readTelemetry`, `readContextTokens` (+ their types).
   Read-only queries against the canvas.db-backed node graph.
 - **Broker client** — `ViewSocketClient`, `BrokerUnavailableError`. A typed
-  client for a node's `view.sock` (see `docs/compat/hearth-crtr-v5.md` for
-  the socket path resolution and a minimal-subset alternative that avoids
-  depending on this class).
+  client for a node's `view.sock`. A consumer that would rather not depend on
+  this class can speak the frame protocol directly over the socket path
+  `crtr sys version` reports.
 - **Broker wire protocol** — `encodeFrame`, `FrameDecoder`,
   `FrameOverflowError`, `CLIENT_READ_CAPS`, `BROKER_READ_CAPS`, and every
   frame/protocol type (`WelcomeFrame`, `AckFrame`, `HelloFrame`,
@@ -63,12 +63,13 @@ comment-organized); this table is the map, not the inventory:
 ## External runtime contracts (not library imports)
 
 A consumer that runs alongside crtr (a separate process, a separate repo)
-also has a CLI/socket/schema surface to depend on instead of an import.
-That contract — `crtr sys version`, `crtr node message send`, the broker
-`view.sock` `reload_auth` subset, and the canvas.db byte-shape — is documented
-separately and versioned: see `docs/compat/hearth-crtr-v5.md`.
+also has a CLI/socket/schema surface to depend on instead of an import:
+`crtr sys version`, `crtr node message send`, the broker `view.sock`
+`reload_auth` subset, and the canvas.db byte-shape. Each of those is versioned
+by the CLI's own `sys version` output rather than by a document here.
 
 ## Packaging
 
-`docs/` is listed in `package.json#files`, so this note and the compat note
-ship inside the published npm package, not only in the GitHub repo.
+`docs/` is listed in `package.json#files`, so this note ships inside the
+published npm package, not only in the GitHub repo. Compiled tests under
+`dist/**/__tests__/` are excluded from the tarball.