@north-light/cli 0.0.0 → 0.3.413

package/dist/pi-extensions/canvas-structured-output.d.ts

@@ -0,0 +1,49 @@
+import { type SubmitResultDTO, type SubmitResultRequest } from '../api/index.js';
+import { SUBMIT_RESULT_TOOL, type StructuredOutputRequest } from '../core/runtime/structured-output.js';
+export { SUBMIT_RESULT_TOOL };
+interface BeforeAgentStartEventLike {
+    systemPrompt: string;
+}
+interface ToolResultLike {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    details: unknown;
+    isError?: boolean;
+}
+interface SubmitResultParams {
+    request_id: string;
+    result?: unknown;
+    decline?: {
+        reason: string;
+        code: string;
+        retryable?: boolean;
+    };
+}
+interface ToolDefinitionLike {
+    name: string;
+    label: string;
+    description: string;
+    promptSnippet?: string;
+    parameters: unknown;
+    defaultActive?: boolean;
+    execute: (toolCallId: string, params: SubmitResultParams) => Promise<ToolResultLike>;
+}
+interface PiLike {
+    on(event: 'before_agent_start', handler: (event: BeforeAgentStartEventLike) => {
+        systemPrompt: string;
+    } | void): void;
+    on(event: 'turn_end', handler: () => void): void;
+    registerTool(tool: ToolDefinitionLike): void;
+    getActiveTools(): string[];
+    setActiveTools(toolNames: string[]): void;
+}
+/** Render the prompt block for one valid request. Exported for the test suite. */
+export declare function structuredOutputPromptBlock(request: StructuredOutputRequest): string;
+/** The model-facing text for an accepted submission — the same wording `crtr push result` prints. */
+export declare function submitResultText(result: SubmitResultDTO): string;
+/** Build the `submit_result` tool for one node. Exported for the test suite. */
+export declare function createSubmitResultTool(nodeId: string, submit?: (req: SubmitResultRequest) => Promise<SubmitResultDTO>): ToolDefinitionLike;
+export declare function registerCanvasStructuredOutput(pi: PiLike): void;
+export default registerCanvasStructuredOutput;

package/dist/pi-extensions/canvas-structured-output.js

@@ -0,0 +1,19 @@
+var g=Object.defineProperty;var d=(e,t)=>g(e,"name",{value:t,configurable:!0});import{Type as i}from"typebox";import{envNodeId as y}from"../shared/env.js";import{localClient as b}from"../api/node-transport.js";import{ApiError as q}from"../api/index.js";import{readBrokerOutputRequest as h,SUBMIT_RESULT_TOOL as a}from"../core/runtime/structured-output.js";function O(e){const t=JSON.stringify(e.schema,null,2),n=`call the ${`\`${a}\` tool with \`request_id: "${e.request_id}"\``} and the JSON in \`result\``,r=`call \`${a}\` with \`decline: { reason, code }\` instead`;return`<structured-output-request>
+${e.mode==="terminal"?`This node owes a terminal structured result. When the work is complete, submit it: ${n}. That records it and pushes your final report in one step, finishing this node. Do NOT call \`crtr push final\` yourself; it is blocked while this request is pending. If the schema cannot be honestly satisfied (blocked, unavailable, bad input), ${r} of inventing a value \u2014 that finishes the node with a declined outcome. You cannot stop or go dormant until the result is accepted or declined.`:`This node owes a one-off structured result. Submit it: ${n}. That records it and pushes an update report to your subscribers, then you continue working normally. If the schema cannot be honestly satisfied, ${r} of inventing a value. You cannot stop or go dormant until the result is accepted or declined.`}
+
+The submitted JSON is validated against this schema; a mismatch rejects with field errors and records nothing, so fix it and call the tool again.
+
+Required schema:
+
+\`\`\`json
+${t}
+\`\`\`
+</structured-output-request>`}d(O,"structuredOutputPromptBlock");function $(e){const t=e.declined,s=e.mode==="terminal"?`${t?"Decline recorded":"Result recorded"} \u2014 node finished; its engine shuts down on next stop. Nothing more to do here: STOP your turn immediately. Reply with just "Done." and nothing else.`:`${t?"One-off request declined":"One-off result recorded"} and pushed \u2014 the structured-output gate is cleared; continue working normally.`,n=t===void 0?"":`
+- code: ${t.code} (${t.retryable?"retryable":"not retryable"})`;return`${s}
+
+- ${t?"declined":"result"}: ${e.result_path}${n}
+- report: ${e.report}`}d($,"submitResultText");function w(e,t){if(typeof t!="string")return t;const s=h(e),n=s.state==="valid"?s.request.schema.type:void 0;if(n!=="object"&&n!=="array")return t;try{return JSON.parse(t)}catch{return t}}d(w,"normalizeResult");function l(e){return{content:[{type:"text",text:e}],details:void 0,isError:!0}}d(l,"errorResult");function T(e,t=s=>b({autostart:!1}).submitResult(e,s)){return{name:a,label:"Submit result",description:"Answer this node's pending structured-output request. Pass the request id from the structured-output instruction and either `result` (the JSON value matching the required schema) or `decline` when the schema cannot be honestly satisfied. The result is validated against the schema; a mismatch is rejected with field errors and nothing is recorded.",promptSnippet:"Submit the JSON result for a pending structured-output request (or decline it)",parameters:i.Object({request_id:i.String({description:"The request id named in the structured-output instruction."}),result:i.Optional(i.Unknown({description:"The JSON value matching the required schema. Omit when declining."})),decline:i.Optional(i.Object({reason:i.String({description:"One sentence on why the schema cannot be honestly satisfied."}),code:i.String({description:"A whitespace-free token naming the decline class, as the requester documented."}),retryable:i.Optional(i.Boolean({description:"Whether a retry could succeed. Default false."}))},{description:"Decline the request instead of submitting a result."}))}),defaultActive:!1,async execute(s,n){const r=typeof n.request_id=="string"?n.request_id.trim():"";if(r==="")return l("request_id is required: pass the request id named in the structured-output instruction.");const c=Object.hasOwn(n,"result")&&n.result!==void 0,o=n.decline;if(c&&o!==void 0)return l("Pass either `result` or `decline`, not both.");if(!c&&o===void 0)return l("Pass `result` (the JSON value matching the required schema), or `decline` when the schema cannot be honestly satisfied.");const f=o!==void 0?{request_id:r,decline:o.reason,code:o.code,retryable:o.retryable===!0}:{request_id:r,value:w(e,n.result)};try{const u=await t(f);return{content:[{type:"text",text:$(u)}],details:u}}catch(u){if(u instanceof q){const m=u.details,p=typeof m?.next=="string"?`
+
+${m.next}`:"";return l(`${u.code}: ${u.message}${p}`)}return l(`The result was not submitted: ${u.message}`)}}}}d(T,"createSubmitResultTool");function S(e){const t=y();if(t===void 0||t.trim()==="")return;e.registerTool(T(t));const s=d(n=>{const r=e.getActiveTools(),c=r.includes(a);n&&!c?e.setActiveTools([...r,a]):!n&&c&&e.setActiveTools(r.filter(o=>o!==a))},"syncTool");e.on("before_agent_start",n=>{const r=h(t);if(s(r.state==="valid"),r.state==="valid")return{systemPrompt:`${n.systemPrompt}
+
+${O(r.request)}`}}),e.on("turn_end",()=>{s(h(t).state==="valid")})}d(S,"registerCanvasStructuredOutput");var j=S;export{a as SUBMIT_RESULT_TOOL,T as createSubmitResultTool,j as default,S as registerCanvasStructuredOutput,O as structuredOutputPromptBlock,$ as submitResultText};

package/dist/pi-extensions/canvas-tool-guide.d.ts

@@ -0,0 +1,14 @@
+declare function injectToolGuide(systemPrompt: string, helpText: string): string;
+interface BeforeAgentStartEventLike {
+    systemPrompt: string;
+}
+interface PiLike {
+    on(event: 'session_start', handler: () => void | Promise<void>): void;
+    on(event: 'before_agent_start', handler: (event: BeforeAgentStartEventLike) => {
+        systemPrompt: string;
+    } | void): void;
+}
+/** Register the root crtr tool-guide injection for a canvas node. */
+export declare function registerCanvasToolGuide(pi: PiLike): void;
+export { injectToolGuide };
+export default registerCanvasToolGuide;

package/dist/pi-extensions/canvas-tool-guide.js

@@ -0,0 +1,9 @@
+var f=Object.defineProperty;var c=(t,o)=>f(t,"name",{value:o,configurable:!0});import{envNodeId as d}from"../shared/env.js";import{execFile as l}from"node:child_process";import{createHash as m}from"node:crypto";import{mkdirSync as p,readFileSync as h,writeFileSync as x}from"node:fs";import{homedir as y}from"node:os";import{dirname as g,join as S}from"node:path";import{promisify as $}from"node:util";const _=$(l),s=15e3,O=`
+
+Guidelines:`;function T(t){const o=m("sha1").update(`${t}\0${process.env.CRTR_SCOPES??""}`).digest("hex").slice(0,16);return S(y(),".cache","crouter",`crtr-tool-guide-${o}.json`)}c(T,"helpCacheFile");function a(t,o){const r=`<crtr-tool-guide>
+${o}
+</crtr-tool-guide>`,n=t.indexOf(O);return n===-1?`${t}
+
+${r}`:`${t.slice(0,n)}
+
+${r}${t.slice(n)}`}c(a,"injectToolGuide");function w(t){const o=d();if(o===void 0||o.trim()==="")return;let r="",n=0;async function u(){if(r!==""&&Date.now()-n<s)return;const i=T(process.cwd());try{const e=JSON.parse(h(i,"utf8"));if(typeof e.text=="string"&&e.text!==""&&typeof e.at=="number"&&Date.now()-e.at<s){r=e.text,n=e.at;return}}catch{}try{const{stdout:e}=await _("crtr",["-h"],{timeout:1e4});r=e.trim(),n=Date.now();try{p(g(i),{recursive:!0}),x(i,JSON.stringify({text:r,at:n}),"utf8")}catch{}}catch(e){console.error("[canvas-tool-guide] crtr -h capture failed:",e)}}c(u,"refresh"),t.on("session_start",u),t.on("before_agent_start",i=>{if(r!=="")return{systemPrompt:a(i.systemPrompt,r)}})}c(w,"registerCanvasToolGuide");var R=w;export{R as default,a as injectToolGuide,w as registerCanvasToolGuide};

package/dist/pi-extensions/envelope-merge.d.ts

@@ -0,0 +1,13 @@
+type ContentBlock = {
+    type: string;
+    text?: string;
+};
+type TextBlock = {
+    type: 'text';
+    text: string;
+};
+/** Return the normalized contents of an auto-loaded-context envelope. */
+export declare function autoLoadedContextInner(text: string): string | null;
+/** Merge fresh items into the one auto-loaded-context envelope in a tool result. */
+export declare function mergeAutoLoadedContext<T extends ContentBlock>(items: readonly string[], content: T[], placement?: 'before' | 'after'): Array<T | TextBlock>;
+export {};

package/dist/pi-extensions/envelope-merge.js

@@ -0,0 +1,8 @@
+var l=Object.defineProperty;var o=(n,e)=>l(n,"name",{value:e,configurable:!0});const r=/<auto-loaded-context(?:\s[^>]*)?>\n([\s\S]*?)\n<\/auto-loaded-context>/;function m(n){const e=n.match(r)?.[1]?.trim();return e===void 0||e===""?null:e}o(m,"autoLoadedContextInner");function h(n,e,u="before"){const s=e.map(t=>t.text??"").join(`
+`),x=n.map(t=>t.trim()).filter(t=>t!==""&&!s.includes(t));if(x.length===0)return e;const i=x.join(`
+`),d=e.findIndex(t=>typeof t.text=="string"&&r.test(t.text));if(d===-1){const t={type:"text",text:`<auto-loaded-context>
+${i}
+</auto-loaded-context>`};return u==="after"?[...e,t]:[t,...e]}return e.map((t,f)=>f!==d||typeof t.text!="string"?t:{...t,text:t.text.replace(r,(p,c)=>{const a=c.trim();return`<auto-loaded-context>
+${i}${a===""?"":`
+${a}`}
+</auto-loaded-context>`})})}o(h,"mergeAutoLoadedContext");export{m as autoLoadedContextInner,h as mergeAutoLoadedContext};

package/dist/pi-extensions/system-prompt-entry.d.ts

@@ -0,0 +1,15 @@
+interface PiLike {
+    on(event: 'agent_start', handler: (event: unknown, ctx: {
+        getSystemPrompt(): string;
+        sessionManager: {
+            getEntries(): Array<{
+                type: string;
+                customType?: string;
+                data?: unknown;
+            }>;
+        };
+    }) => void): void;
+    appendEntry(type: string, data: unknown): void;
+}
+export default function registerSystemPromptEntry(pi: PiLike): void;
+export {};

package/dist/pi-extensions/system-prompt-entry.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var n=(t,e)=>p(t,"name",{value:e,configurable:!0});import{envNodeId as m}from"../shared/env.js";function i(t){t.on("agent_start",(e,r)=>{if(!m())return;const s=r.getSystemPrompt();[...r.sessionManager.getEntries()].reverse().find(o=>o.type==="custom"&&o.customType==="crtr-system-prompt")?.data?.text!==s&&t.appendEntry("crtr-system-prompt",{text:s})})}n(i,"registerSystemPromptEntry");export{i as default};

package/dist/prompts/review.d.ts

@@ -0,0 +1,2 @@
+export declare function specReviewPrompt(specPath: string): string;
+export declare function planReviewPrompt(planPath: string, specPath: string | null): string;

package/dist/prompts/review.js

@@ -0,0 +1,110 @@
+var i=Object.defineProperty;var s=(t,e)=>i(t,"name",{value:e,configurable:!0});const n=`## Delivering your review
+
+When your review is complete, deliver your verdict as instructed by
+__CRTR_SUBMIT_INSTRUCTION__
+
+The pane will close automatically once your review is delivered. Do NOT
+summarize or chat after submission \u2014 the submit call IS the response.
+
+If you cannot complete the review (file missing, totally malformed, etc.),
+still submit with a brief explanation of why.`;function r(t){return`You are reviewing a spec document. Verify it is complete and ready for
+planning.
+
+**Spec to review:** ${t}
+
+Read the spec end-to-end first.
+
+## What to check
+
+| Category | What to look for |
+|----------|------------------|
+| Completeness | TODOs, placeholders, "TBD", incomplete sections |
+| Consistency | Internal contradictions, conflicting requirements |
+| Clarity | Requirements ambiguous enough to cause someone to build the wrong thing |
+| Scope | Focused enough for a single plan |
+| YAGNI | Unrequested features, over-engineering |
+
+For specs with non-trivial component interaction, also walk the primary
+flow from trigger to final state and check whether preconditions, state
+transitions, failure handling, and handoffs between components are
+actually specified. This is the highest-signal check when there are
+seams to fall between \u2014 skip it for self-contained specs.
+
+For larger specs touching established patterns, optionally spawn a Task
+agent (\`general-purpose\`, \`sonnet\`) to cross-check the spec's design
+against the repo's documents (discover them with \`crtr canvas list --type document\`
+or \`crtr canvas search\` and load them with \`crtr canvas read\`) and the files
+they reference, looking for contradictions with project conventions. Skip for small
+specs.
+
+## Calibration
+
+Approve unless an implementer or planner would be led astray. Real issues:
+missing requirements, contradictory design, unspecified failure modes on
+critical paths, requirements ambiguous enough to be built two ways. Not
+issues: wording preferences, "I'd have organized this differently",
+sections less detailed than others.
+
+## Output
+
+## Spec Review
+
+**Status:** Approved | Issues Found
+
+**Issues (if any):**
+- [Section]: [specific issue] \u2014 [why it matters for planning]
+
+**Recommendations (advisory, do not block approval):**
+- [suggestions]
+
+${n}`}s(r,"specReviewPrompt");function l(t,e){return`You are reviewing a plan document. Verify it is complete and ready for
+implementation.
+
+${e===null?`**Plan to review:** ${t}
+
+No spec was provided for cross-reference \u2014 evaluate the plan on its own
+merits (internal completeness, task decomposition, buildability). Skip the
+"Spec Alignment" check.`:`**Plan to review:** ${t}
+**Spec for reference:** ${e}
+
+Read the plan first, then the spec, then evaluate alignment and the other
+criteria below.`}
+
+## What to check
+
+| Category | What to look for |
+|----------|------------------|
+| Completeness | TODOs, placeholders, incomplete tasks, missing steps |
+${e===null?"":`| Spec alignment | Plan covers spec requirements, no major scope creep, no unjustified divergence from the spec's design |
+`}| Resolved decisions | No "if X then Y" branches, no "investigate whether\u2026", no deferred choices |
+| Buildability | Could an engineer follow this without getting stuck or re-deciding things? |
+| Quality smells | Timelines, "for now" shortcuts, magic values, fallbacks, missing type definitions where the plan creates a new contract |
+
+For medium+ plans that claim parallelizable tasks, also check that tasks
+own disjoint files (or call out unavoidable overlap) and that shared
+types/APIs between tasks have their contracts specified.
+
+For large plans${e===null?"":", or when spec coverage feels uncertain"}, you may
+optionally spawn one Task agent (\`general-purpose\`, \`sonnet\`) to
+cross-check ${e===null?"coverage of the plan's own stated phases against its task list":`spec requirements at \`${e}\` against plan tasks`}.
+Skip for small plans.
+
+## Calibration
+
+Approve unless an implementer would build the wrong thing, get stuck, or
+ship something that violates the plan's quality bar. Minor wording,
+stylistic preferences, and "nice to have" reorganizations are NOT issues.
+
+## Output
+
+## Plan Review
+
+**Status:** Approved | Issues Found
+
+**Issues (if any):**
+- [Task / Section]: [specific issue] \u2014 [why it matters for implementation]
+
+**Recommendations (advisory, do not block approval):**
+- [suggestions]
+
+${n}`}s(l,"planReviewPrompt");export{l as planReviewPrompt,r as specReviewPrompt};

package/dist/shared/crtr-version.d.ts

@@ -0,0 +1,2 @@
+/** The running crouter package version (`package.json` `version`). */
+export declare function crtrVersion(): string;

package/dist/shared/crtr-version.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var t=(o,e)=>i(o,"name",{value:e,configurable:!0});import{readFileSync as a}from"node:fs";import{dirname as m,join as n}from"node:path";import{fileURLToPath as p}from"node:url";let r=null;function u(){if(r!==null)return r;const o=n(m(p(import.meta.url)),"..","..");return r=JSON.parse(a(n(o,"package.json"),"utf8")).version,r}t(u,"crtrVersion");export{u as crtrVersion};

package/dist/shared/env.d.ts

@@ -0,0 +1,116 @@
+/** The current node's id (`CRTR_NODE_ID`), or undefined outside a node. */
+export declare function envNodeId(): string | undefined;
+/** Find the single launch snapshot mounted by the launcher into this process's
+ * Linux namespace. Cron bash has no CRTR_NODE_ID, but its creator's mounted
+ * launch snapshot supplies config and granted-command projection without
+ * claiming the cron is a node. Its broker relay may already have closed when
+ * the cron fires; still classify the sandbox so CLI bootstrap never falls back
+ * to host stores or person authority. Neither CRTR_NODE_ID, CRTR_ANCHOR, nor
+ * the caller-editable CRTR_API_SOCKET selects the launch identity. */
+export declare function sandboxCliNodeId(): string | undefined;
+/** A Linux app command uses its mounted launch snapshot, not host user stores. */
+export declare function isSandboxedNode(): boolean;
+/** The app that owns the current node, supplied in its broker launch identity. */
+export declare function envGrantee(): string | undefined;
+/** Set to '1' by `nodeEnv` for an app-started run's brokers, which admit inbox
+ *  mail only between agent runs. Terminal nodes also carry `CRTR_RUN_ID`, so
+ *  that variable is not this signal. */
+export declare const INBOX_BETWEEN_TURNS_ENV = "CRTR_INBOX_BETWEEN_TURNS";
+export declare function envInboxBetweenTurns(): boolean;
+/** The current run's scope allow-list; null means the row inherits everything. */
+export declare function envScopes(): readonly string[] | null;
+/** Whether a launched scope list covers a capability. Null means not narrowed. */
+export declare function scopeAllowed(scopes: readonly string[] | null | undefined, scope: string): boolean;
+export declare function envExecutionId(): string | undefined;
+/** The current node's target profile id (`CRTR_PROFILE_ID`), or undefined. */
+export declare function envProfileId(): string | undefined;
+/** The current node's working directory (`CRTR_NODE_CWD`), or undefined. */
+export declare function envNodeCwd(): string | undefined;
+/** An explicit model-routing override for this turn (`CRTR_MODEL_INTENT`), or
+ *  undefined. Cleared (not read) via `delete process.env['CRTR_MODEL_INTENT']`
+ *  in `runtime/broker.ts` — a mutation, not a read, so it stays there. */
+export declare function envModelIntent(): string | undefined;
+/** Whether the launch recipe requires this broker to keep its exact provider/model. */
+export declare function envModelExact(): boolean;
+/** The raw `CRTR_HOME` override, unresolved. Use `crtrHome()`
+ *  (`core/canvas/paths.ts`) to get the resolved canvas-home path; use this
+ *  only when a caller needs the override itself — to check whether one is
+ *  set, or to propagate it verbatim into a child process's env. */
+export declare function envHomeOverride(): string | undefined;
+/** The raw installed-runtime directory override, unresolved. */
+export declare function envRuntimeHomeOverride(): string | undefined;
+/** Dead-provider watchdog timeout (`CRTR_STREAM_WATCHDOG_MS`), 5 minutes by
+ *  default. See `runtime/stream-watchdog.ts` for what it guards. */
+export declare function envStreamWatchdogMs(): number;
+/** The canvas inbox watcher's poll tick (`CRTR_WATCHER_TICK_MS`). */
+export declare function envWatcherTickMs(): number;
+/** Claim backstop while broker signals are connected (`CRTR_WATCHER_BACKSTOP_MS`). */
+export declare function envWatcherBackstopMs(): number;
+/** The canvas inbox watcher's debounce window (`CRTR_WATCHER_DEBOUNCE_MS`). */
+export declare function envWatcherDebounceMs(): number;
+/** No-new-message window before a recap is shown (`CRTR_RECAP_IDLE_MS`), 60s
+ *  by default. */
+export declare function envRecapIdleMs(): number;
+/** Explicit recap-model override (`CRTR_RECAP_MODEL`), trimmed; undefined if
+ *  unset or blank. */
+export declare function envRecapModelOverride(): string | undefined;
+/** The bash safety-valve deadline (`CRTR_BASH_VALVE_MS`), 5 minutes by
+ *  default; undocumented test-only override so the E2E valve check doesn't
+ *  sleep 5 minutes. */
+export declare function envBashValveMs(): number;
+/** How long an AUTO-backgrounded bash job may run before the daemon cancels it
+ *  unless the agent claims it (`CRTR_BASH_AUTO_BG_DEADLINE_MS`), 60s by default;
+ *  undocumented test-only override so the deadline check doesn't wait a minute. */
+export declare function envBashAutoBgDeadlineMs(): number;
+/** Explicit pidfile path override (`CRTR_PIDFILE`, tests only); undefined if
+ *  unset or blank. */
+export declare function envPidfileOverride(): string | undefined;
+/** The broker engine module spec (`CRTR_BROKER_ENGINE`, the T11 test seam),
+ *  defaulting to the real SDK. `runtime/host.ts` layers `inv.env` ahead of
+ *  this (a launch-time override mirrored into the child's env, since
+ *  spawn-env.ts's default-deny allowlist strips `CRTR_*` from ambient env). */
+export declare function envBrokerEngine(): string;
+/** Test-only pi-binary substitution (`CRTR_PI_BINARY`) so the integration
+ *  harness can point a real `crtr node new` at a deterministic fake-pi
+ *  vehicle. Undefined in production. */
+export declare function envPiBinaryOverride(): string | undefined;
+/** Whether implicit daemon autostart is suppressed for this invocation
+ *  (`CRTR_NO_DAEMON_AUTOSTART=1`). */
+export declare function envNoDaemonAutostart(): boolean;
+/** The `--tcp` fallback for crtrd's opt-in TCP listener (`CRTRD_TCP`), raw
+ *  (`host:port` or undefined — absent means unix socket only). */
+export declare function envCrtrdTcp(): string | undefined;
+/** The opt-in bearer token guarding crtrd's TCP listener (`CRTRD_TOKEN`).
+ *  Unset (or blank) → undefined, and the TCP listener performs NO auth check
+ *  at all — exactly today's behavior. The unix socket never checks this,
+ *  set or not. */
+export declare function envCrtrdToken(): string | undefined;
+/** Kill switch for the host-exports writer/pruner (`CRTR_NO_EXPORTS=1`). */
+export declare function envNoExports(): boolean;
+/** Verbose-diagnostics gate for otherwise-silent best-effort catches
+ *  (`CRTR_DEBUG=1`). Distinct from `CRTR_DEBUG_PID_LIVENESS`
+ *  (`core/canvas/pid.ts`), a different, unrelated var. */
+export declare function envDebug(): boolean;
+/** Live-broker automatic-revive cap override (`CRTR_MAX_LIVE_BROKERS`); wins
+ *  over `readConfig('user').brokerThresholds.automaticReviveCap` when set. */
+export declare function envMaxLiveBrokers(): number | undefined;
+/** Live-broker warning threshold override (`CRTR_WARN_LIVE_BROKERS`); wins
+ *  over `readConfig('user').brokerThresholds.warning` when set. */
+export declare function envWarnLiveBrokers(): number | undefined;
+/** Test-only unattended-park interval override (`CRTR_TEST_UNATTENDED_PARK_MS`),
+ *  gated by `envNoDaemonAutostart()` at the call site; no production default. */
+export declare function envTestUnattendedParkMs(): number | undefined;
+/** Production unattended-park interval override (`CRTR_UNATTENDED_PARK_MS`), in
+ *  milliseconds; wins over the user-scope config value
+ *  (`readConfig('user').lifecycle.unattendedParkMs`, itself defaulting to 15
+ *  min) whenever set, autostart or not. Unlike `CRTR_TEST_UNATTENDED_PARK_MS`
+ *  this is not gated on `envNoDaemonAutostart()`: it is the env escape hatch
+ *  above the configured knob a deployment sets to tune how long an eligible
+ *  resident idles before its parking turn. */
+export declare function envUnattendedParkMs(): number | undefined;
+/** Test-only park-summary grace-period override
+ *  (`CRTR_TEST_PARK_SUMMARY_GRACE_MS`); no production default. */
+export declare function envTestParkSummaryGraceMs(): number | undefined;
+/** The bounded lifetime shared by the daemon's pending-park sweep and its
+ * in-broker isolated turn. */
+export declare function parkSummaryGraceMs(): number;

package/dist/shared/env.js

@@ -0,0 +1,2 @@
+var _=Object.defineProperty;var e=(n,r)=>_(n,"name",{value:r,configurable:!0});import{lstatSync as R,readFileSync as p,readdirSync as T}from"node:fs";import{join as i}from"node:path";import{covers as E}from"@north-light/identity";function U(){return process.env.CRTR_NODE_ID}e(U,"envNodeId");function d(){if(process.platform==="linux")try{const n="/run/crtr/nodes",r=new Set(p("/proc/self/mountinfo","utf8").split(`
+`).map(s=>s.split(" ")[4])),t=T(n,{withFileTypes:!0}).filter(s=>s.isDirectory()&&/^[a-zA-Z0-9][a-zA-Z0-9-]{0,127}$/.test(s.name)&&r.has(i(n,s.name))&&R(i(n,s.name,"broker-launch.json"),{throwIfNoEntry:!1})?.isFile());return t.length===1?t[0].name:void 0}catch{return}}e(d,"sandboxCliNodeId");function L(){return d()!==void 0}e(L,"isSandboxedNode");function P(){return process.env.CRTR_GRANTEE}e(P,"envGrantee");const f="CRTR_INBOX_BETWEEN_TURNS";function W(){return process.env[f]==="1"}e(W,"envInboxBetweenTurns");function F(){const n=process.env.CRTR_SCOPES;return n===void 0?null:n===""?[]:n.split(",")}e(F,"envScopes");function H(n,r){return n==null?!0:n.some(t=>E(t,r))}e(H,"scopeAllowed");function G(){return process.env.CRTR_EXECUTION_ID}e(G,"envExecutionId");function K(){return process.env.CRTR_PROFILE_ID}e(K,"envProfileId");function h(){return process.env.CRTR_NODE_CWD}e(h,"envNodeCwd");function b(){return process.env.CRTR_MODEL_INTENT}e(b,"envModelIntent");function k(){return process.env.CRTR_MODEL_EXACT==="1"}e(k,"envModelExact");function g(){return process.env.CRTR_HOME}e(g,"envHomeOverride");function V(){return process.env.CRTR_RUNTIME_HOME}e(V,"envRuntimeHomeOverride");function o(n,r){if(n===void 0)return r;const t=Number(n);return Number.isFinite(t)&&t>0?t:r}e(o,"parsePositiveMs");const v=5*6e4;function w(){return o(process.env.CRTR_STREAM_WATCHDOG_MS,v)}e(w,"envStreamWatchdogMs");const C=800;function y(){return o(process.env.CRTR_WATCHER_TICK_MS,C)}e(y,"envWatcherTickMs");const A=6e4;function X(){return o(process.env.CRTR_WATCHER_BACKSTOP_MS,A)}e(X,"envWatcherBackstopMs");const a=1e3;function Y(){return o(process.env.CRTR_WATCHER_DEBOUNCE_MS,a)}e(Y,"envWatcherDebounceMs");const M=6e4;function j(){return o(process.env.CRTR_RECAP_IDLE_MS,M)}e(j,"envRecapIdleMs");function z(){const n=process.env.CRTR_RECAP_MODEL;return n!==void 0&&n.trim()!==""?n.trim():void 0}e(z,"envRecapModelOverride");const S=300*1e3;function Z(){return o(process.env.CRTR_BASH_VALVE_MS,S)}e(Z,"envBashValveMs");const N=60*1e3;function $(){return o(process.env.CRTR_BASH_AUTO_BG_DEADLINE_MS,N)}e($,"envBashAutoBgDeadlineMs");function q(){const n=process.env.CRTR_PIDFILE;return n!==void 0&&n!==""?n:void 0}e(q,"envPidfileOverride");const x="@earendil-works/pi-coding-agent";function J(){return process.env.CRTR_BROKER_ENGINE??x}e(J,"envBrokerEngine");function Q(){return process.env.CRTR_PI_BINARY}e(Q,"envPiBinaryOverride");function ee(){return process.env.CRTR_NO_DAEMON_AUTOSTART==="1"}e(ee,"envNoDaemonAutostart");function ne(){return process.env.CRTRD_TCP}e(ne,"envCrtrdTcp");function re(){const n=process.env.CRTRD_TOKEN;return n!==void 0&&n!==""?n:void 0}e(re,"envCrtrdToken");function te(){return process.env.CRTR_NO_EXPORTS==="1"}e(te,"envNoExports");function oe(){return process.env.CRTR_DEBUG==="1"}e(oe,"envDebug");function c(n){if(n===void 0||n==="")return;const r=Number(n);return Number.isSafeInteger(r)&&r>=1?r:void 0}e(c,"parsePositiveInteger");function se(){return c(process.env.CRTR_MAX_LIVE_BROKERS)}e(se,"envMaxLiveBrokers");function ue(){return c(process.env.CRTR_WARN_LIVE_BROKERS)}e(ue,"envWarnLiveBrokers");function u(n){if(n===void 0)return;const r=Number(n);return Number.isFinite(r)&&r>0?r:void 0}e(u,"parsePositiveMsNoDefault");function ie(){return u(process.env.CRTR_TEST_UNATTENDED_PARK_MS)}e(ie,"envTestUnattendedParkMs");function ce(){return u(process.env.CRTR_UNATTENDED_PARK_MS)}e(ce,"envUnattendedParkMs");function D(){return u(process.env.CRTR_TEST_PARK_SUMMARY_GRACE_MS)}e(D,"envTestParkSummaryGraceMs");const O=5*6e4;function _e(){return D()??O}e(_e,"parkSummaryGraceMs");export{f as INBOX_BETWEEN_TURNS_ENV,$ as envBashAutoBgDeadlineMs,Z as envBashValveMs,J as envBrokerEngine,ne as envCrtrdTcp,re as envCrtrdToken,oe as envDebug,G as envExecutionId,P as envGrantee,g as envHomeOverride,W as envInboxBetweenTurns,se as envMaxLiveBrokers,k as envModelExact,b as envModelIntent,ee as envNoDaemonAutostart,te as envNoExports,h as envNodeCwd,U as envNodeId,Q as envPiBinaryOverride,q as envPidfileOverride,K as envProfileId,j as envRecapIdleMs,z as envRecapModelOverride,V as envRuntimeHomeOverride,F as envScopes,w as envStreamWatchdogMs,D as envTestParkSummaryGraceMs,ie as envTestUnattendedParkMs,ce as envUnattendedParkMs,ue as envWarnLiveBrokers,X as envWatcherBackstopMs,Y as envWatcherDebounceMs,y as envWatcherTickMs,L as isSandboxedNode,_e as parkSummaryGraceMs,d as sandboxCliNodeId,H as scopeAllowed};

package/dist/shared/generated-context.d.ts

@@ -0,0 +1,83 @@
+/** Custom message carrying the node's session-start bearings. */
+export declare const CONTEXT_INTRO_CUSTOM_TYPE = "crtr-context";
+/** Custom message carrying an ambient situational-context update. */
+export declare const SITUATIONAL_CONTEXT_CUSTOM_TYPE = "crtr-situational-context";
+/** Custom message used when a context-size nudge waits for the next turn. */
+export declare const CONTEXT_NUDGE_CUSTOM_TYPE = "crtr-context-nudge";
+/** Custom message that opens a review companion's visible transcript. */
+export declare const REVIEW_BOUNDARY_CUSTOM_TYPE = "crtr-review-boundary";
+/** Generic completion mandate issued by the terminal-node stop guard. */
+export declare const STALL_REPROMPT: string;
+/** 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 declare const PARK_SUMMARY_PROMPT: string;
+/** Static recovery prompts shared by the broker producer and display classifier. */
+export declare 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 declare 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.";
+/** A run node's connection retry. Its broker never probes the network (its
+ *  model calls go through the daemon), so it cannot claim the network is back;
+ *  the attempt itself is the probe. */
+export declare const RUN_CONNECTION_FAULT_RETRY_BODY = "Your previous turn stopped on a connection error reaching the model provider. Retrying now: continue from where you left off and retry the work that failed.";
+export declare 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.";
+export type ModelFallbackRecoveryReason = 'credential' | 'not-found';
+/** Format the stop guard's dynamic structured-output mandate. */
+export declare function formatStructuredOutputReprompt(schema: string, requestId: string): string;
+/** Keep model-fallback guidance editable without making it a reader contract. */
+export declare function formatModelFallbackRecovery(previousModel: string, nextModel: string, reason: ModelFallbackRecoveryReason): string;
+export interface GeneratedContextMessageLike {
+    role?: string;
+    customType?: string;
+    content?: unknown;
+}
+export type CardEntryDisposition = 'report' | 'human-answer' | 'human-canceled';
+export interface CardEntry {
+    disposition: CardEntryDisposition;
+    kind: string;
+    body: string;
+    ref?: string;
+}
+export interface CardSender {
+    id: string;
+    updates: number;
+    finished: boolean;
+    entries: CardEntry[];
+}
+/** An already-resolved inbox entry supplied to the pure digest formatter. */
+export interface InboxCardEntry {
+    kind: string;
+    body: string;
+    ref?: string;
+    disposition?: CardEntryDisposition;
+}
+/** An already-resolved sender section supplied to the pure digest formatter. */
+export interface InboxCardSection {
+    id: string;
+    entries: readonly InboxCardEntry[];
+}
+export interface GeneratedCard {
+    kind: string;
+    facts: Readonly<Record<string, string>>;
+    body: string;
+    senders: CardSender[];
+}
+/** Plain text from a generated message's string or text-block content. */
+export declare function generatedContextText(message: GeneratedContextMessageLike): string;
+/** Wrap a user-role runtime message in its whole-message card envelope. */
+export declare function formatCard(kind: string, facts: Record<string, string | number | boolean | undefined>, body: string): string;
+/** 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 declare function formatDataCard(kind: string, facts: Record<string, string | number | boolean | undefined>, body: string): string;
+/** Parse a runtime envelope, with pre-envelope customType compatibility. */
+export declare function parseCard(message: GeneratedContextMessageLike): GeneratedCard | null;
+/** Whether an inbox entry is the person's own words. A `human-answer` entry
+ *  whose body is itself a runtime card is a runtime notice — review approvals
+ *  were delivered that way before they became plain prose — never speech. */
+export declare function isHumanWordsEntry(entry: CardEntry): boolean;
+/** Explain how an inbox entry's ref is read without guessing its filesystem location. */
+export declare function formatInboxRefInstruction(ref: string): string;
+/** Format a complete inbox card from report bodies resolved by the caller. */
+export declare function formatInboxCard(sections: readonly InboxCardSection[]): string;

package/dist/shared/generated-context.js

@@ -0,0 +1,8 @@
+var _=Object.defineProperty;var o=(e,t)=>_(e,"name",{value:t,configurable:!0});const T="crtr-context",E="crtr-situational-context",R="crtr-context-nudge",O="crtr-review-boundary",Y="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.",I="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\n1. 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.\n\n2. Put supporting material in documents you own (`crtr doc write`) 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, under this node, not under a longer-lived owner.\n\n3. Give a longer-lived owner (`--owner repo|profile|user`) only to a non-obvious, reusable lesson that should survive this task and is not already recorded. Read `crtr doc write -h`, search before writing (`crtr canvas search`), and choose the narrowest owner 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 such a document.\n\n4. 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.",$="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.",L="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 connection error reaching the model provider. Retrying now: continue from where you left off and retry the work that failed.",M="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>",B="</model-fallback-recovery>",g="\n```";function F(e,t){return`You must submit a result matching the required schema before you can stop: call the \`submit_result\` tool with \`request_id: "${t}"\` and the JSON in \`result\`, or with \`decline: { reason, code }\` when the schema cannot be honestly satisfied. You cannot finish or go dormant any other way while this request is pending.
+
+Required schema:
+
+\`\`\`json
+${e}${g}`}o(F,"formatStructuredOutputReprompt");function q(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(q,"formatModelFallbackRecovery");function A(e){switch(e){case R:return"context-nudge";case T:return"bearings";case O:return"review-boundary";case E:return"situational";default:return}}o(A,"legacyCustomTypeKind");const x=/^[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 w(e){return e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;")}o(w,"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(!x.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 y(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(y,"formatCard");function X(e,t,n){return y(e,t,w(n))}o(X,"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 v=s.disposition==="human-answer"||s.disposition==="human-canceled"?s.disposition:"report";a.push({kind:s.kind,disposition:v,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 N(e,t,n,i){return{kind:e,facts:t,body:n,senders:i}}o(N,"cardFor");function b(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 N(r,u,c,r==="inbox"?P(c):[])}o(b,"parseEnvelope");function W(e){const t=C(e),n=b(t);if(n!==null)return n;if(e.role!=="custom")return null;const i=A(e.customType);return i===void 0?null:{kind:i,facts:Object.freeze({}),body:t,senders:[]}}o(W,"parseCard");function z(e){return e.disposition==="human-answer"&&b(e.body.trim())===null}o(z,"isHumanWordsEntry");function K(e){return e.startsWith("/")?`Preview only. Read the full body from file \`${e}\`.`:`Read this report with \`crtr canvas read ${e}\`.`}o(K,"formatInboxRefInstruction");function Z(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})}>${w(r.body)}</entry>`}).join(`
+`);return`<from${p({id:n.id})}>${i}</from>`}).join(`
+`);return y("inbox",{},t)}o(Z,"formatInboxCard");export{$ as AUTH_FAULT_RECOVERY_BODY,L as CONNECTION_FAULT_RECOVERY_BODY,T as CONTEXT_INTRO_CUSTOM_TYPE,R as CONTEXT_NUDGE_CUSTOM_TYPE,I as PARK_SUMMARY_PROMPT,M as PROVIDER_FAULT_RECOVERY_BODY,O as REVIEW_BOUNDARY_CUSTOM_TYPE,S as RUN_CONNECTION_FAULT_RETRY_BODY,E as SITUATIONAL_CONTEXT_CUSTOM_TYPE,Y as STALL_REPROMPT,y as formatCard,X as formatDataCard,Z as formatInboxCard,K as formatInboxRefInstruction,q as formatModelFallbackRecovery,F as formatStructuredOutputReprompt,C as generatedContextText,z as isHumanWordsEntry,W as parseCard};

package/dist/shared/inbox-entry-body.d.ts

@@ -0,0 +1,22 @@
+export declare const INLINE_REPORT_MAX_CHARS = 1000;
+/** The rendering fields both inbox projections share. */
+export interface InboxEntryFields {
+    ts: string;
+    from: string | null;
+    from_name?: string;
+    label: string;
+    ref?: string;
+    data?: Record<string, unknown>;
+}
+/** A report document's ref (`<node>/reports/<name>`), else undefined. */
+export declare function reportRefNodeId(ref: string | undefined): string | undefined;
+/** Clip a body to the bounded preview stored beside a spilled message body. */
+export declare function clipBody(body: string): {
+    text: string;
+    clipped: boolean;
+};
+export declare function inlineBody(entry: Pick<InboxEntryFields, 'data' | 'label'>): string;
+/** One entry's card body: an inlined short report, a bounded inline message body, an event
+ *  push rendered from its metadata, or the label. `report` is the report document's body when
+ *  the caller could read it. */
+export declare function renderEntryBody(entry: InboxEntryFields, report: string | null): string;

package/dist/shared/inbox-entry-body.js

@@ -0,0 +1,10 @@
+var w=Object.defineProperty;var i=(e,t)=>w(e,"name",{value:t,configurable:!0});import{formatInboxRefInstruction as u}from"./generated-context.js";const f=12,l=1e3,y=1e3;function k(e){return(e===void 0?null:/^([a-z0-9-]+)\/reports\/[^/]+$/.exec(e))?.[1]}i(k,"reportRefNodeId");function x(e){let t=e,r=!1;const o=t.split(`
+`);return o.length>f&&(t=o.slice(0,f).join(`
+`),r=!0),t.length>l&&(t=t.slice(0,l),r=!0),{text:t.trimEnd(),clipped:r}}i(x,"clipBody");function j(e){const t=typeof e.data?.body=="string"?String(e.data.body).trim():"";return t===""||t===e.label?"":t}i(j,"inlineBody");function v(e){const t=e.data?.push;return typeof t=="object"&&t!==null&&typeof t.event=="string"?t:null}i(v,"pushOf");function $(e){const t=e.owner_handle??e.owner;return t==null?e.name:`${t}/${e.name}`}i($,"objectRef");function _(e){return e.type==="document"?`[[${$(e)}]]`:e.type==="job"?`job ${e.id} (\`${e.name}\`)`:e.type==="node"?`node ${e.name} (${e.id})`:`${e.type} ${e.name}`}i(_,"objectText");function R(e,t){return t.actor===null?"the runtime":e.from_name===void 0||e.from_name===t.actor?t.actor:`${e.from_name} (${t.actor})`}i(R,"actorText");function m(e){return Array.isArray(e)?e.filter(t=>typeof t=="string"):[]}i(m,"list");function A(e,t){const r=_(t.object),o=R(e,t),n=t.attrs,a=t.object.type==="document"?` Read it with \`crtr canvas read ${$(t.object)}\`.`:"";switch(t.event){case"created":return t.object.type==="node"?`${o} created ${r}${typeof n.kind=="string"?`, kind ${n.kind}`:""}.`:`${o} created ${r}.${a}`;case"read":return`${o} read ${r}.`;case"watched":return`${o} started watching ${r}.`;case"deleted":return`${o} deleted ${r}.`;case"edited":{const c=m(n.authors),s=m(n.rationales),d=typeof n.from_revision=="number"&&typeof n.revision=="number"&&n.revision-n.from_revision>1?`revisions ${n.from_revision+1}\u2013${n.revision}`:typeof n.revision=="number"?`revision ${n.revision}`:"a new revision",g=c.length===0?o:c.join(", "),b=s.length===0?"":` Rationale: ${s.join("; ")}.`,p=n.needs_merge===!0?" Two edits were made from the same revision; read it and edit it to merge them.":"",h=` You get this because you read or wrote it; if it no longer concerns your work, stop with \`crtr canvas unwatch ${$(t.object)}\`.`;return`${g} edited ${r} (${d}).${b}${p}${a}${h}`}case"messaged":return`${o} messaged ${r}.`;case"sent":return`${o} sent a message as ${r}.`;case"configured":return`${o} changed the settings of ${r}${typeof n.changed=="string"?`: ${n.changed}`:""}.`;case"exited":return`${r[0].toUpperCase()}${r.slice(1)} exited with code ${String(n["exit-code"])}. Log: ${String(n["log-path"])}`;case"killed":{const c=t.actor===null?"":` by ${o}`,s=typeof n.reason=="string"?` (${n.reason})`:"",d=n.reason==="deadline"?` It was canceled at its deadline; claim it with \`crtr node bash extend ${t.object.id} --for <duration>\` next time.`:"";return`${r[0].toUpperCase()}${r.slice(1)} was killed${c}${s}.${d} Log: ${String(n["log-path"])}`}default:return e.label}}i(A,"renderPush");function E(e,t){if(t!==null&&t.length<y&&e.ref!==void 0)return`${t.trimEnd()}
+
+${u(e.ref)}`;const r=j(e);if(r===""){const a=v(e);return a!==null&&e.ref===void 0?A(e,a):e.ref===void 0?e.label:`${e.label}
+
+${u(e.ref)}`}const{text:o,clipped:n}=x(r);return e.ref!==void 0?`${o}
+
+${u(e.ref)}`:n?`${o}
+\u2026 (body clipped)`:o}i(E,"renderEntryBody");export{y as INLINE_REPORT_MAX_CHARS,x as clipBody,j as inlineBody,E as renderEntryBody,k as reportRefNodeId};

package/dist/shared/inline-ref-grammar.d.ts

@@ -0,0 +1,53 @@
+/**
+ * A candidate slash token found in free text by `findRefTokens`. This is the
+ * NORMATIVE, trimmed span used for resolution and highlighting.
+ */
+export interface RefToken {
+    /** Character index of the leading `/`. */
+    start: number;
+    /** Character index just past the last kept name character (post-trim). */
+    end: number;
+    /** The surface token including `/`, trailing punctuation already trimmed. */
+    raw: string;
+    /** Decoded canonical name (`:` → `/`); never empty (empty candidates are omitted). */
+    candidate: string;
+}
+/**
+ * The in-progress token touching a caret position, as reported by
+ * `findRefTokenAtCaret`. Its `[start, end)` range is the COMPLETE captured
+ * replacement range (the maximal, UNTRIMMED `[A-Za-z0-9_:-]` run) — not the
+ * trimmed `RefToken` span — so a completion accept can replace an
+ * in-progress token like `/taste:` (no trailing name segment yet) or a token
+ * the caret sits in the middle of (suffix-inclusive). The normative resolved
+ * span for highlighting/guidance always remains `findRefTokens`' trimmed span;
+ * this helper exists only to drive completion UX.
+ */
+export interface RefCaretToken {
+    /** Character index of the leading `/`. */
+    start: number;
+    /** Character index just past the last character of the maximal (untrimmed) run. */
+    end: number;
+    /** The slash/name prefix from `start` through the caret (`text.slice(start, caret)`). */
+    surfacePrefix: string;
+}
+/**
+ * Find every resolved-ref CANDIDATE in `text` per the §4.1 grammar. Does not
+ * consult any inventory — callers resolve a token by testing
+ * `token.candidate` against a `Set<string>` of visible canonical names.
+ */
+export declare function findRefTokens(text: string): RefToken[];
+/**
+ * Render a canonical name back into its surface slash-token form:
+ * `'dev' -> '/dev'`, `'taste/foo' -> '/taste:foo'`.
+ */
+export declare function formatRefToken(canonicalName: string): string;
+/**
+ * Classify the in-progress token (if any) touching `caret` in `text`, for
+ * completion UX. Reuses the same whitespace/name-char predicates as
+ * `findRefTokens`, but reports the UNTRIMMED maximal run so an incomplete
+ * prefix (`/taste:` with nothing typed after the colon yet) or a caret sitting
+ * mid-token (with more valid characters after it) both produce a full,
+ * suffix-inclusive replacement range. Returns `null` when the caret is not
+ * touching a token-shaped run.
+ */
+export declare function findRefTokenAtCaret(text: string, caret: number): RefCaretToken | null;

package/dist/shared/inline-ref-grammar.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var s=(n,o)=>u(n,"name",{value:o,configurable:!0});const h=/[A-Za-z0-9_:-]/,A=/[A-Za-z0-9]/,p=/[ \t\n\r\f\v]/;function a(n){return h.test(n)}s(a,"isNameChar");function C(n){return p.test(n)}s(C,"isAsciiWhitespace");function l(n,o){return o===0||C(n[o-1])}s(l,"isTokenStart");function k(n){const o=[],c=n.length;for(let e=0;e<c;e++){if(n[e]!=="/"||!l(n,e))continue;let i=e+1;for(;i<c&&a(n[i]);)i++;if(i===e+1)continue;let t=i;for(;t>e+1&&!A.test(n[t-1]);)t--;if(t===e+1)continue;const r=n.slice(e,t),f=r.slice(1).replace(/:/g,"/");o.push({start:e,end:t,raw:r,candidate:f})}return o}s(k,"findRefTokens");function m(n){return"/"+n.replace(/\//g,":")}s(m,"formatRefToken");function w(n,o){const c=n.length,e=Math.max(0,Math.min(o,c));let i=e;for(;i>0&&a(n[i-1]);)i--;const t=i-1;if(t<0||n[t]!=="/"||!l(n,t))return null;let r=t+1;for(;r<c&&a(n[r]);)r++;return{start:t,end:r,surfacePrefix:n.slice(t,e)}}s(w,"findRefTokenAtCaret");export{w as findRefTokenAtCaret,k as findRefTokens,m as formatRefToken};

package/dist/shared/inline-ref-guidance.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resolve every slash token in `text` against `names` (the node's document
+ * names from the delivery route), collapse duplicates, and return one
+ * directive line per distinct resolved ref in FIRST-APPEARANCE order.
+ * Returns `null` when no token resolves, so the broker sends no guidance
+ * message for prose with no refs.
+ */
+export declare function buildGuidance(text: string, names: Set<string>): string | null;