@north-light/cli 0.0.0 → 0.3.413

package/dist/pi-extensions/canvas-context-intro.d.ts

@@ -0,0 +1,55 @@
+import { CONTEXT_INTRO_CUSTOM_TYPE } from '../shared/generated-context.js';
+/** The `customType` stamped on the injected session message. Used both to write
+ *  the entry and to detect it on resume (the idempotency guard). Defined beside
+ *  the block builder in `core/runtime/bearings.ts` because the warm-pool claim's
+ *  live delivery needs it too; re-exported here as this module's own surface. */
+export { CONTEXT_INTRO_CUSTOM_TYPE };
+interface SessionEntryLike {
+    type: string;
+    customType?: string;
+    /** custom_message entries carry their injected content (string or blocks). */
+    content?: string | Array<{
+        type: string;
+        text?: string;
+    }>;
+    /** Extension metadata we stamp on the block (NOT sent to the LLM). The
+     *  authoritative idempotency discriminator: `nodeId` is the node the block
+     *  belongs to, so a fork (whose copied source block carries the SOURCE's id)
+     *  is told apart from a genuine resume by an EXACT id match. */
+    details?: {
+        nodeId?: string;
+    };
+}
+interface SessionStartCtxLike {
+    sessionManager: {
+        /** Required by pi's `ReadonlySessionManager`: the active branch, which is
+         *  the context the next turn actually sees. */
+        getBranch: (fromId?: string) => SessionEntryLike[];
+    };
+}
+interface CustomMessageLike {
+    customType: string;
+    content: string;
+    display?: boolean;
+    /** Extension-only metadata (not sent to the LLM); used as the exact
+     *  idempotency discriminator on resume — see SessionEntryLike.details. */
+    details?: {
+        nodeId: string;
+    };
+}
+interface PiLike {
+    on: (event: 'session_start', handler: (event: unknown, ctx: SessionStartCtxLike) => void | Promise<void>) => void;
+    sendMessage: (message: CustomMessageLike, options?: {
+        deliverAs?: string;
+        triggerTurn?: boolean;
+    }) => void;
+}
+/** Build the full bearings baseline for a conversation without inherited
+ *  crouter context. Exported for testing. */
+export declare function buildContextIntro(nodeId: string): Promise<string>;
+/** Build the compact node-scoped update for a fork whose copied branch already
+ *  carries a full crouter baseline. Exported for testing. */
+export declare function buildForkContextIntro(nodeId: string): Promise<string>;
+/** Register new-context baseline assembly; a strict resume changes nothing. */
+export declare function registerCanvasContextIntro(pi: PiLike): void;
+export default registerCanvasContextIntro;

package/dist/pi-extensions/canvas-context-intro.js

@@ -0,0 +1,2 @@
+var w=Object.defineProperty;var s=(t,e)=>w(t,"name",{value:e,configurable:!0});import{envNodeId as b}from"../shared/env.js";import{CONTEXT_INTRO_CUSTOM_TYPE as a,formatCard as C}from"../shared/generated-context.js";import{brokerDelivery as m,brokerExtensionState as f}from"../core/runtime/broker/daemon-ops.js";import{buildForkBearingsFromState as p}from"../core/runtime/broker-extension-render.js";import{acknowledgePersonaBaseline as T}from"../core/runtime/broker-persona-guidance.js";import{situationalContextEnvelope as l}from"../core/runtime/situational-context.js";async function O(t){return(await m(t,{activity:"boot"})).content}s(O,"buildContextIntro");async function P(t){const e=await f(t);return p(e,l(t)??"")}s(P,"buildForkContextIntro");function g(t){const e=t.content;return typeof e=="string"?e:Array.isArray(e)?e.filter(r=>typeof r?.text=="string").map(r=>r.text).join(`
+`):""}s(g,"entryText");function v(t){t.on("session_start",async(e,r)=>{const n=b();if(n===void 0||n.trim()==="")return;const x=e?.reason,i=await f(n);if(i.warm_spare||x==="new"&&i.node.parent===null)return;const c=r.sessionManager.getBranch().filter(o=>o.type==="custom_message"&&o.customType===a);if(c.some(o=>o.details?.nodeId===n||g(o).includes(n)))return;const d=await m(n,{activity:"boot",inherited:c.length>0}),y=d.inherited===!0?p(i,l(n)??""):d.content,u=C("bearings",{},y);if(t.sendMessage({customType:a,content:u,display:!0,details:{nodeId:n}}),!r.sessionManager.getBranch().some(o=>o.type==="custom_message"&&o.customType===a&&o.details?.nodeId===n&&g(o)===u))throw new Error(`Pi did not materialize the context baseline for ${n}`);await T(i)})}s(v,"registerCanvasContextIntro");var S=v;export{a as CONTEXT_INTRO_CUSTOM_TYPE,O as buildContextIntro,P as buildForkContextIntro,S as default,v as registerCanvasContextIntro};

package/dist/pi-extensions/canvas-doc-substrate.d.ts

@@ -0,0 +1,51 @@
+/** before_agent_start: pi hands us the assembled system prompt; returning a new
+ *  `systemPrompt` replaces it for this agent run (pi rebuilds it each run, so
+ *  splicing fresh every time is idempotent — never cumulative). */
+interface BeforeAgentStartEventLike {
+    systemPrompt: string;
+}
+interface BeforeAgentStartResultLike {
+    systemPrompt: string;
+}
+/** tool_result: fired after a tool returns. `content` is the tool's output
+ *  blocks; returning a new `content` replaces what the model sees. */
+interface ContentBlockLike {
+    type: string;
+    text?: string;
+}
+interface ToolResultEventLike {
+    toolName: string;
+    isError?: boolean;
+    /** The tool's resolved input. For `read` it carries the file path under
+     *  `path` (or the legacy `file_path`); for `bash`, the command string under
+     *  `command`. Typed loosely; narrowed at use. */
+    input?: unknown;
+    content: ContentBlockLike[];
+}
+interface ToolResultCtxLike {
+    /** The session cwd — used to resolve a relative read path. */
+    cwd?: string;
+}
+type ToolResultResultLike = {
+    content: ContentBlockLike[];
+} | void;
+/** tool_call: fired BEFORE the tool runs. Returning `{block: true, reason}`
+ *  stops it — nothing executes, no `tool_result` fires, and `reason` becomes the
+ *  call's synthesized error result, carrying arbitrary-length text. */
+interface ToolCallEventLike {
+    toolName: string;
+    input?: unknown;
+}
+type ToolCallResultLike = {
+    block: true;
+    reason: string;
+} | void;
+interface PiLike {
+    on(event: 'before_agent_start', handler: (event: BeforeAgentStartEventLike) => BeforeAgentStartResultLike | void | Promise<BeforeAgentStartResultLike | void>): void;
+    on(event: 'session_compact', handler: (event: unknown, ctx: unknown) => void | Promise<void>): void;
+    on(event: 'turn_end', handler: (event: unknown, ctx: unknown) => void | Promise<void>): void;
+    on(event: 'tool_call', handler: (event: ToolCallEventLike, ctx: unknown) => ToolCallResultLike | Promise<ToolCallResultLike>): void;
+    on(event: 'tool_result', handler: (event: ToolResultEventLike, ctx: ToolResultCtxLike) => ToolResultResultLike | Promise<ToolResultResultLike>): void;
+}
+export declare function registerCanvasDocSubstrate(pi: PiLike): void;
+export default registerCanvasDocSubstrate;

package/dist/pi-extensions/canvas-doc-substrate.js

@@ -0,0 +1,9 @@
+var y=Object.defineProperty;var c=(n,e)=>y(n,"name",{value:e,configurable:!0});import{envNodeId as p}from"../shared/env.js";import{homedir as b}from"node:os";import{join as w,resolve as g}from"node:path";import{brokerDelivery as m}from"../core/runtime/broker/daemon-ops.js";import{autoLoadedContextInner as x,mergeAutoLoadedContext as N}from"./envelope-merge.js";const O=`
+
+Guidelines:`;function _(n){const e=n?.command;return typeof e=="string"&&e.trim()!==""?e:null}c(_,"bashCommandOf");function L(n){return["HELD \u2014 nothing ran.","","Your bash command was NOT executed. It matched memory you had not yet read, and that memory is below.","","Read it, then re-issue your WHOLE command unchanged \u2014 every clause of it, including any heredoc, redirect, or `$(\u2026)` that built its input, because none of that ran either. The re-issue executes: this memory is now in your transcript, so there is nothing left to deliver and nothing left to hold.","",n].join(`
+`)}c(L,"heldReason");const E=["HELD \u2014 nothing ran.","","Your bash command was NOT executed. Another command in this same message was held against memory you had not read, and that memory was returned with it.","","Read it, then re-issue your WHOLE command unchanged. The re-issue executes."].join(`
+`);function j(n){const e=p();if(e===void 0||e.trim()==="")return;n.on("before_agent_start",async t=>{const o=(await m(e,{activity:"system-prompt"})).content;if(o==="")return;const r=t.systemPrompt.indexOf(O);return r===-1?{systemPrompt:`${t.systemPrompt}
+
+${o}`}:{systemPrompt:`${t.systemPrompt.slice(0,r)}
+
+${o}${t.systemPrompt.slice(r)}`}});let i=!1;n.on("turn_end",()=>{i=!1}),n.on("session_compact",async()=>{await m(e,{activity:"compact"}),i=!1}),n.on("tool_call",async t=>{if(t.toolName!=="bash")return;const o=_(t.input);if(o===null)return;if(i)return{block:!0,reason:E};const r=(await m(e,{activity:"pre-command",subject:o})).content;if(r!=="")return i=!0,{block:!0,reason:L(r)}}),n.on("tool_result",async(t,o)=>{if(t.isError===!0)return;let r=null,d=null;if(t.toolName==="read"){const a=t.input,s=a?.path??a?.file_path;if(s===void 0||s==="")return;const f=typeof o?.cwd=="string"&&o.cwd!==""?o.cwd:process.cwd(),h=s.startsWith("~")?w(b(),s.slice(1)):s;r=g(f,h)}else if(t.toolName==="bash"){const a=t.input;if(typeof a?.command!="string"||a.command.trim()==="")return;d=a.command}else return;const u=(await m(e,r!==null?{activity:"file-read",subject:r}:{activity:"command",subject:d})).content;if(u==="")return;const l=x(u);if(l===null)throw new Error("substrate renderer returned an invalid auto-loaded context block");return{content:N([l],t.content,t.toolName==="bash"?"after":"before")}})}c(j,"registerCanvasDocSubstrate");var C=j;export{C as default,j as registerCanvasDocSubstrate};

package/dist/pi-extensions/canvas-elapsed.d.ts

@@ -0,0 +1,21 @@
+interface ToolResultEvent {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    details?: unknown;
+}
+interface PiLike {
+    on(event: 'session_start' | 'input' | 'tool_result', handler: (event: any) => void | Promise<void> | {
+        content: ToolResultEvent['content'];
+    }): void;
+}
+interface ElapsedNodeState {
+    node: {
+        lifecycle: 'terminal' | 'resident';
+        created: string;
+    };
+    children: readonly unknown[];
+}
+export declare function registerCanvasElapsed(pi: PiLike, loadNode?: (id: string) => Promise<ElapsedNodeState>, now?: () => number): void;
+export default registerCanvasElapsed;

package/dist/pi-extensions/canvas-elapsed.js

@@ -0,0 +1,2 @@
+var f=Object.defineProperty;var d=(e,t)=>f(e,"name",{value:t,configurable:!0});import{envNodeId as h}from"../shared/env.js";import{brokerExtensionState as p}from"../core/runtime/broker/daemon-ops.js";import{crtrPreviewRecords as m}from"../core/preview-registry.js";const g="This is how long you have been on this work, shown because you have delegates. Finishing sooner is worth something: keep independent work running in parallel and take the quicker path when quality is unchanged. It is not a budget; never trade verification or scope for time.";function w(e){const t=Math.floor(Math.max(0,e)/1e3),o=Math.floor(t/60),r=Math.floor(o/60);return`elapsed ${r>0?`${r}h `:""}${o%60}m ${t%60}s`}d(w,"elapsedLine");function v(e){return m(e).some(t=>t.path==="node new"&&t.error===void 0)}d(v,"spawnedChild");function x(e,t=p,o=Date.now){const r=h();if(r===void 0||r.trim()==="")return;let l,a=o(),i=!1,c=!1;e.on("session_start",async()=>{a=o(),c=!1;const n=await t(r);if(l=n.node.lifecycle,i=i||n.children.length>0,l==="terminal"){const s=Date.parse(n.node.created);Number.isFinite(s)&&(a=s)}}),e.on("input",n=>{l==="resident"&&n?.streamingBehavior===void 0&&(a=o())}),e.on("tool_result",n=>{if(!i&&v(n)&&(i=!0),!i)return;const s=w(o()-a),u=c?s:`${s}
+${g}`;return c=!0,{content:[...n.content,{type:"text",text:u}]}})}d(x,"registerCanvasElapsed");var I=x;export{I as default,x as registerCanvasElapsed};

package/dist/pi-extensions/canvas-goal-capture.d.ts

@@ -0,0 +1,21 @@
+interface InputEventLike {
+    type: 'input';
+    text: string;
+    images?: unknown[];
+    source: 'interactive' | 'rpc' | 'extension';
+}
+interface PiLike {
+    on: (event: 'input', handler: (event: InputEventLike, ctx: any) => void) => void;
+    /** Update the live session display name (pi's editor label). Present in
+     *  interactive mode; optional so the extension stays inert where it's not. */
+    setSessionName?: (name: string) => void;
+}
+/**
+ * Register the goal-capture handler on `pi`.
+ *
+ * Returns immediately (inert) when CRTR_NODE_ID is absent. The `input` handler
+ * is the whole extension: on the first interactive message of a goal-less node,
+ * persist it as the goal.
+ */
+export declare function registerCanvasGoalCapture(pi: PiLike): void;
+export default registerCanvasGoalCapture;

package/dist/pi-extensions/canvas-goal-capture.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var o=(e,t)=>a(e,"name",{value:t,configurable:!0});import{envNodeId as u}from"../shared/env.js";import{captureGoalIfAbsent as s,generateAndCommitInitialName as c}from"./broker-local.js";import{parseCard as f}from"../shared/generated-context.js";function m(e){e.on("input",t=>{try{const r=u();if(r===void 0||r.trim()==="")return;const n=(t.text??"").trim();if(n===""||t.source==="extension"||f({role:"user",content:n})!==null)return;t.source==="interactive"&&s(r,n),c(r,n,i=>{try{e.setSessionName?.(i)}catch{}})}catch{}})}o(m,"registerCanvasGoalCapture");var C=m;export{C as default,m as registerCanvasGoalCapture};

package/dist/pi-extensions/canvas-inbox-watcher.d.ts

@@ -0,0 +1,26 @@
+type PiEvents = 'session_start' | 'turn_end' | 'agent_start' | 'agent_end' | 'agent_settled' | 'message_end' | 'session_shutdown';
+interface PiLike {
+    on: (event: PiEvents, handler: (event: any, ctx: any) => void | Promise<void>) => void;
+    sendUserMessage: (content: string, options?: {
+        deliverAs?: 'steer' | 'followUp';
+    }) => void;
+    appendEntry: (type: string, data: unknown) => void;
+    sendMessage: (message: {
+        customType: string;
+        content: string;
+        display?: boolean;
+        details?: Record<string, unknown>;
+    }, options?: {
+        deliverAs?: 'steer' | 'followUp' | 'nextTurn';
+        triggerTurn?: boolean;
+    }) => void;
+}
+/** Register one current watcher. `start()` only wires up pi's event handlers —
+ *  it calls no Pi action, so this is safe to run during extension factory
+ *  execution, before Pi has bound its action methods (sendUserMessage /
+ *  sendMessage throw until then). The watcher only starts polling and sending
+ *  once its own `session_start` handler fires and arms it — the first event
+ *  Pi emits once actions are bound. The returned disposer owns only this
+ *  registration's generation. */
+export declare function registerCanvasInboxWatcher(pi: PiLike): () => void;
+export default registerCanvasInboxWatcher;

package/dist/pi-extensions/canvas-inbox-watcher.js

@@ -0,0 +1,2 @@
+var O=Object.defineProperty;var l=(s,t)=>O(s,"name",{value:t,configurable:!0});import{envInboxBetweenTurns as A,envNodeId as H,envProfileId as U,envWatcherDebounceMs as q,envWatcherTickMs as B,envWatcherBackstopMs as J}from"../shared/env.js";import{coalesceBrokerInbox as W,entryCards as $}from"../core/runtime/broker/inbox.js";import{acknowledgeBrokerMail as G,claimBrokerMail as X,brokerExtensionState as j}from"../core/runtime/broker/daemon-ops.js";import{brokerSignalClient as F}from"../core/runtime/broker/signal-stream.js";import{wasTurnRefused as L}from"../core/runtime/broker/extension-abort.js";import{isDaemonTransportApiError as S}from"../api/errors.js";import{announceMessageOrigin as V,messageSignature as w}from"../core/runtime/stamp/channel.js";import{captureGoalIfAbsent as z,generateAndCommitInitialName as Q}from"./broker-local.js";import{emitEvent as Y}from"../core/events/emit.js";import{errorClassFromError as K}from"../core/events/errors.js";import{operationIdContext as m}from"../core/events/operation-id.js";import{situationalContextEnvelope as Z,SITUATIONAL_CONTEXT_CUSTOM_TYPE as _}from"../core/runtime/situational-context.js";import{isProfilePaused as ee}from"../core/profiles/manifest.js";import{brokerIdleTurnStart as te,brokerRunTurnBusy as ie,HELD_DEFERRED_INBOX_PROMPT_JOIN as ne}from"../core/runtime/broker/held-deferred-inbox.js";const b=64,R=16;let p,re=0;class N extends Error{static{l(this,"WatcherFatalError")}constructor(t,e){super(t,{cause:e}),this.name="WatcherFatalError"}}function se(){return{tickMs:B(),debounceMs:q()}}l(se,"resolveCadence");function I(){const s=H();return s===void 0||s.trim()===""?void 0:s}l(I,"currentNodeId");function P(){const s=U();return s!==void 0&&s!==""&&ee(s)}l(P,"profilePaused");function E(s){try{return K(s)}catch{return{class:"unknown"}}}l(E,"safeErrorClass");function v(s){try{Y(s)}catch{}}l(v,"emitBestEffort");function C(s){try{m.fresh(t=>{v({...s,operation_id:t})})}catch{}}l(C,"emitFreshBestEffort");function k(s,t){try{m.run(s,()=>{v({...t,operation_id:s})})}catch{}}l(k,"emitStoredBestEffort");function ae(s){return s.kind==="human"?{type:"human"}:{type:"runtime",kind:"inbox",entries:s.entries.map(t=>({...t.from===null?{}:{from:t.from},...t.from_name===void 0?{}:{fromName:t.from_name},kind:t.kind,tier:t.tier,...t.ref===void 0?{}:{ref:t.ref}}))}}l(ae,"deliveryOrigin");function x(s,t){if(s.length===0)throw new Error(`cannot create an empty ${t} delivery`);const e=[...new Set(s.map(n=>n.operation_id))].sort(),i=e.length-R;return{channel:t,entryIds:s.map(n=>n.entry_id),throughEntryId:s.at(-1).entry_id,sourceOperationIds:e.slice(0,R),...i>0?{sourceOperationIdsOmitted:i}:{}}}l(x,"deliveryFacts");function y(s){return{channel:s.channel,entry_ids:s.entryIds,through_entry_id:s.throughEntryId,source_operation_ids:s.sourceOperationIds,...s.sourceOperationIdsOmitted===void 0?{}:{source_operation_ids_omitted:s.sourceOperationIdsOmitted}}}l(y,"deliveryFields");function de(s){k(s.operationId,{level:"info",event:"inbox.delivery.completed",outcome:"succeeded",fields:y(s)})}l(de,"emitDeliveryCompleted");function T(s,t,e,i){k(s,{level:"error",event:"inbox.delivery.failed",outcome:"failed",error:i,error_class:E(i),fields:{stage:e,...y(t)}})}l(T,"emitDeliveryFailure");function M(s,t){k(s.operationId,{level:"error",event:"inbox.delivery.failed",outcome:"failed",error_class:{class:"unknown"},fields:{stage:"abandoned",reason:t,...y(s)}})}l(M,"emitDeliveryAbandoned");function oe(s){return typeof s=="string"?s:Array.isArray(s)?s.filter(t=>typeof t=="object"&&t!==null&&typeof t.text=="string").map(t=>t.text).join(`
+`):""}l(oe,"messageText");function D(s){return s==="quit"||s==="reload"||s==="new"||s==="resume"||s==="fork"}l(D,"isSessionShutdownReason");function fe(s){switch(s){case"quit":return"shutdown";case"reload":case"new":case"resume":case"fork":return"reload";default:return s}}l(fe,"disposalReasonForShutdown");function le(s){return typeof s=="string"?s.slice(0,128):s===null?"null":s===void 0?"undefined":typeof s=="number"||typeof s=="boolean"||typeof s=="bigint"?String(s).slice(0,128):typeof s}l(le,"boundedRuntimeReason");class he{static{l(this,"CanvasInboxWatcher")}pi;cadence;generation;timer;backstop;debounceTimer;signalUnsubscribers=[];rerun=!1;retryNeeded=!1;armed=!1;lastCtx;streaming=!1;runNode=A();nodeId;claims=new Map;reportBodies=new Map;tickInFlight;buffer=[];lastArrival=0;pendingHandoffs=[];pendingCommit;promptJoinInFlight=!1;replayUnseenInherited=!1;seeded=!1;disposed=!1;disposalReason;fatalError;fatalEscaped=!1;constructor(t,e,i){this.pi=t,this.cadence=e,this.generation=i}start(){const t=l((e,i)=>{this.canMutate()&&this.captureCtx(e,i)},"capture");this.pi.on("session_start",(e,i)=>{this.canMutate()&&(this.captureCtx(e,i),this.arm())}),this.pi.on("turn_end",t),this.pi.on("agent_start",(e,i)=>{this.canMutate()&&(this.captureCtx(e,i),this.streaming=!0)}),this.pi.on("agent_end",(e,i)=>{this.canMutate()&&(this.captureCtx(e,i),this.streaming=!1)}),this.pi.on("message_end",e=>{if(!this.canMutate())return;const i=e?.message;if(i?.role!=="user"&&i?.role!=="custom"||!this.pendingHandoffs.some(d=>d.awaitingDequeue!==void 0))return;const n=w(oe(i.content)),r=this.pendingHandoffs.find(d=>d.awaitingDequeue===n);r!==void 0&&delete r.awaitingDequeue}),this.pi.on("agent_settled",async(e,i)=>{if(!this.canMutate())return;this.captureCtx(e,i);const n=I();if(n!==void 0)try{this.assertNodeOwnership(n,"settle"),await this.tickInFlight,this.seeded||await this.claimMail(n);const r=await this.settle(n,i,!1,!0);r==="refresh_held"&&this.dispose("refresh",!1),this.runNode&&r==="settled"&&this.canMutate()&&this.buffer.length>0&&this.flushOrdinary(n),this.syncTimers()}catch(r){this.dispose("shutdown",!1,void 0,{error:r,stage:"settle"})}}),this.pi.on("session_shutdown",async e=>{if(!this.canMutate())return;let i;try{i=e?.reason}catch{i=void 0}const n=D(i)?fe(i):"reload";D(i)||C({level:"warn",event:"inbox.lifecycle.unknown_shutdown_reason",outcome:"failed",fields:{reason:le(i)}});try{await this.disposeAtSettlement(n,this.lastCtx)}catch(r){this.dispose(n,!1,void 0,{error:r,stage:"settle"})}})}arm(){if(this.armed)return;this.armed=!0;const t=F();this.signalUnsubscribers.push(t.subscribe("state",()=>this.syncTimers()),t.subscribe("mail",()=>this.runTick("schedule")),t.subscribe("resync",()=>this.runTick("schedule"))),this.syncTimers(),t.state!=="connected"&&this.runTick("schedule")}async disposeAtSettlement(t,e){const i=I();if(i===void 0){this.dispose(t,!1);return}try{this.assertNodeOwnership(i,"settle");const n=await this.settle(i,e,t!=="refresh");this.dispose(n==="refresh_held"?"refresh":t,!1)}catch(n){this.dispose(t,!1,void 0,{error:n,stage:"settle"})}}dispose(t,e,i,n){if(this.disposed)return;this.disposed=!0,this.disposalReason=t,this.clearTimer();for(const d of this.signalUnsubscribers.splice(0))d();const r=n;{const d=[...new Set([...this.pendingCommit?.handoffs??[],...this.pendingHandoffs.splice(0)])];this.buffer.length=0,this.claims.clear(),this.reportBodies.clear(),this.pendingCommit=void 0,this.promptJoinInFlight=!1,this.replayUnseenInherited=!1,this.nodeId=void 0,this.lastCtx=void 0,this.lastArrival=0,this.streaming=!1,this.seeded=!1,this.ownsCurrentGeneration()&&(p=void 0);for(const a of d)M(a,t)}if(r!==void 0){this.scheduleHandlerFatal(r.error,r.stage);return}}ownsCurrentGeneration(){return p===this&&p.generation===this.generation}canMutate(){return this.ownsCurrentGeneration()&&!this.disposed&&this.fatalError===void 0}captureCtx(t,e){e!==void 0&&(this.lastCtx=e)}clearTimer(){this.timer!==void 0&&clearInterval(this.timer),this.backstop!==void 0&&clearInterval(this.backstop),this.debounceTimer!==void 0&&clearTimeout(this.debounceTimer),this.timer=this.backstop=this.debounceTimer=void 0}syncTimers(){if(!this.armed||!this.canMutate())return;const t=F().state==="connected",e=!t||this.buffer.length>0||this.pendingCommit!==void 0||this.retryNeeded;e&&this.timer===void 0?(this.timer=setInterval(()=>this.runTick("schedule"),this.cadence.tickMs),this.timer.unref?.()):!e&&this.timer!==void 0&&(clearInterval(this.timer),this.timer=void 0),t&&this.backstop===void 0?(this.backstop=setInterval(()=>this.runTick("schedule"),J()),this.backstop.unref?.()):!t&&this.backstop!==void 0&&(clearInterval(this.backstop),this.backstop=void 0),this.buffer.length===0&&this.debounceTimer!==void 0&&(clearTimeout(this.debounceTimer),this.debounceTimer=void 0)}armDebounce(){this.debounceTimer!==void 0&&clearTimeout(this.debounceTimer);const t=Math.max(0,this.lastArrival+this.cadence.debounceMs-Date.now());this.debounceTimer=setTimeout(()=>{this.debounceTimer=void 0,this.runTick("schedule")},t),this.debounceTimer.unref?.()}isIdle(){if(this.runNode&&ie())return!1;try{if(typeof this.lastCtx?.isIdle=="function")return this.lastCtx.isIdle()===!0}catch{}return!this.streaming}assertNodeOwnership(t,e){!this.seeded||this.nodeId===void 0||this.nodeId===t||this.raiseReadFatal(e,new Error(`watcher node changed from ${this.nodeId} to ${t}`))}raiseFatal(t,e,i,n){throw this.fatalError===void 0&&(this.fatalError=new N(e,i),this.clearTimer(),C({level:"error",event:t,outcome:"failed",error:i,error_class:E(i),fields:n})),this.fatalError}raiseReadFatal(t,e){return this.raiseFatal("inbox.read.failed",`inbox ${t} state is corrupt`,e,{stage:t})}raiseSituationalFatal(t,e){return this.raiseFatal("inbox.situational_context.missing","situational context marker has no readable sidecar",e,{entry_id:t})}escapeFatal(t,e){if(!this.fatalEscaped){if(this.fatalEscaped=!0,e==="throw")throw t;queueMicrotask(()=>{throw t})}}scheduleHandlerFatal(t,e){let i;if(t instanceof N)i=t;else try{this.raiseReadFatal(e,t)}catch(n){i=n}this.escapeFatal(i,"schedule")}runTick(t="throw"){if(!this.canMutate())return;if(this.tickInFlight!==void 0){this.rerun=!0;return}const e=this.tick().then(()=>{this.retryNeeded=!1}).catch(i=>{if(this.canMutate()){if(S(i)){this.retryNeeded=!0,C({level:"warn",event:"inbox.read.failed",outcome:"failed",error:i,error_class:E(i),fields:{stage:"poll"}});return}this.scheduleHandlerFatal(i,"poll")}}).finally(()=>{this.tickInFlight===e&&(this.tickInFlight=void 0),this.syncTimers(),this.rerun&&this.canMutate()&&(this.rerun=!1,this.runTick("schedule"))});this.tickInFlight=e}async claimMail(t){this.assertNodeOwnership(t,"poll");let e;try{e=await X(t,"wake",this.reportBodies)}catch(a){throw S(a)&&(this.replayUnseenInherited=!0),a}if(!this.canMutate()||e.action==="hold")return!1;const i=this.replayUnseenInherited;this.replayUnseenInherited=!1,this.nodeId=t,this.seeded=!0;const n=new Set(e.deliveries.map(a=>a.entry.entry_id)),r=this.buffer.filter(a=>!n.has(a.entry_id));for(const a of r)this.claims.delete(a.entry_id);if(this.buffer.splice(0,this.buffer.length,...this.buffer.filter(a=>n.has(a.entry_id))),r.length>0){const a=globalThis[Symbol.for("@crouton-kit/crtr:watcher-cancel-probe")];typeof a=="function"&&a(r.map(f=>f.entry_id),process.hrtime.bigint())}let d=!1;for(const a of e.deliveries){const f=a.entry.entry_id;this.claims.has(f)||(this.claims.set(f,a),a.handoff==="inherited"&&!i?m.fresh(o=>{this.pendingHandoffs.push({...x([a.entry],"visible"),operationId:o,settleAtAgentSettled:!0})}):(this.buffer.push(a.entry),this.lastArrival=Date.now(),d=!0))}return d&&this.armDebounce(),this.syncTimers(),!0}async tick(){const t=I();if(t!==void 0){if(this.pendingCommit!==void 0){await this.retryPendingCommit(t)==="refresh_held"&&this.canMutate()&&this.dispose("refresh",!1);return}this.promptJoinInFlight||P()||this.pendingHandoffs.length>=b||await this.claimMail(t)&&this.buffer.length>0&&(!this.runNode||this.isIdle()||this.buffer.some(e=>e.tier==="critical"))&&Date.now()-this.lastArrival>=this.cadence.debounceMs&&this.flushOrdinary(t)}}missingChannelEntries(t){const e=t.filter(r=>this.claims.has(r.entry_id)),i=this.coveredEntryIds("hidden"),n=this.coveredEntryIds("visible");return{hiddenEntries:e.filter(r=>(r.data?.situational===!0||r.data?.situationalOnly===!0)&&!i.has(r.entry_id)),visibleEntries:e.filter(r=>r.data?.situationalOnly!==!0&&!n.has(r.entry_id))}}visibleRoute(t){return t.length===0?"none":this.isIdle()?"idle":this.runNode?t.some(e=>e.tier==="critical")?"critical":"none":t.some(e=>e.tier==="critical")?"critical":t.some(e=>e.tier==="urgent"||e.kind==="final")?"steer":"followUp"}buildPlan(t){const{hiddenEntries:e,visibleEntries:i}=this.missingChannelEntries(t),n=new Set(e.map(u=>u.entry_id)),r=new Set(i.map(u=>u.entry_id)),d=t.filter(u=>n.has(u.entry_id)||r.has(u.entry_id)),a=this.isIdle()&&d.length>0&&d.every(u=>u.tier==="deferred"),f=this.visibleRoute(i)==="critical",o=!a&&!f&&e.length>0,c=!a&&!f&&i.length>0;return{hiddenEntries:e,visibleEntries:i,deferredHold:a,sendCount:Number(o)+Number(c)}}ordinaryPlan(){return this.buildPlan(this.buffer)}contextCards(t,e){const i=[];if(e.some(n=>n.data?.situational===!0)){const n=e.at(-1).entry_id;let r;try{r=Z(t)}catch(d){this.raiseSituationalFatal(n,d)}r===null&&this.raiseSituationalFatal(n,new Error(`missing situational context for entry ${n}`)),i.push(r)}for(const n of e)n.data?.situationalOnly===!0&&i.push(...$(n));return i}digest(t,e){try{return W(t)}catch(i){this.raiseReadFatal(e,i)}}sendDelivery(t,e,i,n,r){this.pendingHandoffs.length>=b&&this.raiseReadFatal(n,new Error(`pending handoff capacity exceeded before ${t} send`));let d;try{d=x(e,t)}catch(o){this.raiseReadFatal(n,o)}let a;try{m.fresh(o=>{a=o,v({level:"info",event:"inbox.delivery.started",operation_id:o,fields:y(d)}),i()})}catch(o){return a===void 0&&this.raiseReadFatal(n,o),T(a,d,"send",o),"failed"}a===void 0&&this.raiseReadFatal(n,new Error(`${t} delivery returned without an operation id`));const f={operationId:a,...d,...r===void 0?{}:{awaitingDequeue:r}};return this.canMutate()?(this.pendingHandoffs.push(f),"handed-off"):(this.disposed&&this.disposalReason!==void 0&&M(f,this.disposalReason),"inactive")}sendContext(t,e,i,n,r,d){const a=n==="steer"||n==="followUp"?n:this.isIdle()?void 0:"followUp",f=a===void 0||i.length===0?void 0:w(i.at(-1));return this.sendDelivery("hidden",e,()=>{this.runNode&&r&&this.pi.appendEntry("crtr-turn-input",{message_ids:e.map(o=>o.entry_id)}),i.forEach((o,c)=>{const u=r&&c===i.length-1;this.pi.sendMessage({customType:_,content:o,display:!0,details:{nodeId:t}},a!==void 0?{deliverAs:a}:u?{deliverAs:"followUp",triggerTurn:!0}:{})})},d,f)}sendVisible(t,e,i,n,r,d){return this.sendDelivery("visible",t,()=>{if(r!=="idle"&&r!=="steer"&&r!=="followUp")throw new Error(`visible send requested for non-send route ${r}`);for(const a of e)this.pi.sendMessage({customType:_,content:a,display:!0},r==="idle"?{}:{deliverAs:r});if(V(i,n),r==="idle"){const a=te();if(a===void 0)throw new Error("broker idle-turn admission is unavailable");a(i,this.runNode?t.map(f=>f.entry_id):[])}else this.pi.sendUserMessage(i,{deliverAs:r})},d,r==="steer"||r==="followUp"?w(i):void 0)}abortCritical(){try{this.lastCtx?.abort?.()}catch{}}requeueFromBatch(t,e){if(e.size===0)return;const i=t.filter(d=>e.has(d.entry_id)),n=new Set(i.map(d=>d.entry_id)),r=this.buffer.filter(d=>!n.has(d.entry_id));this.buffer.splice(0,this.buffer.length,...i,...r)}executePlan(t,e,i){const n=new Set,r=this.visibleRoute(e.visibleEntries);if(r==="critical"){if(this.abortCritical(),!this.canMutate())return{inactive:!0,requeueEntryIds:n};for(const o of e.visibleEntries)n.add(o.entry_id);for(const o of e.hiddenEntries)n.add(o.entry_id);return{inactive:!1,requeueEntryIds:n}}if(this.runNode&&r==="none")return{inactive:!1,requeueEntryIds:new Set([...e.hiddenEntries,...e.visibleEntries].map(o=>o.entry_id))};const d=e.visibleEntries.length>0?this.digest(e.visibleEntries,i):[],[a,...f]=d;for(const o of f)for(const c of o.entries)n.add(c.entry_id);if(e.hiddenEntries.length>0){const o=this.contextCards(t,e.hiddenEntries),c=this.sendContext(t,e.hiddenEntries,o,r,a===void 0,i);if(c==="inactive")return{inactive:!0,requeueEntryIds:n};if(c==="failed")for(const u of e.hiddenEntries)n.add(u.entry_id)}if(!this.canMutate())return{inactive:!0,requeueEntryIds:n};if(a!==void 0){const o=this.sendVisible(a.entries,a.cards,a.text,ae(a),r,i);if(o==="inactive")return{inactive:!0,requeueEntryIds:n};if(o==="failed")for(const c of a.entries)n.add(c.entry_id);else a.kind==="human"&&(z(t,a.text),Q(t,a.text))}return{inactive:!1,requeueEntryIds:n}}flushOrdinary(t){if(this.buffer.length===0)return"empty";const e=this.ordinaryPlan();if(e.deferredHold)return"held";if(this.pendingHandoffs.length+e.sendCount>b)return"capacity-blocked";const i=[...this.buffer],n=this.executePlan(t,e,"poll");return n.inactive||(this.buffer.splice(0,i.length),this.requeueFromBatch(i,n.requeueEntryIds)),"attempted"}async prependHeldDeferredInbox(t){if(!this.canMutate()||this.nodeId===void 0||P())return;const e=this.ordinaryPlan();if(!e.deferredHold)return;const i=e.visibleEntries.length===0?[]:this.digest(e.visibleEntries,"poll"),n=+(e.hiddenEntries.length>0)+i.length;if(this.pendingHandoffs.length+n>b)return;const r=[...this.buffer];this.promptJoinInFlight=!0;try{this.runNode&&this.pi.appendEntry("crtr-turn-input",{message_ids:[...e.hiddenEntries,...e.visibleEntries].map(d=>d.entry_id)}),e.hiddenEntries.length>0&&await this.sendPromptJoinDelivery(t,"hidden",e.hiddenEntries,this.contextCards(this.nodeId,e.hiddenEntries));for(const d of i)await this.sendPromptJoinDelivery(t,"visible",d.entries,[...d.cards,d.text]);if(!this.canMutate())return;this.buffer.splice(0,r.length)}finally{this.promptJoinInFlight=!1}}async sendPromptJoinDelivery(t,e,i,n){let r;try{r=x(i,e)}catch(f){this.raiseReadFatal("poll",f)}let d;try{await m.fresh(async f=>{d=f,v({level:"info",event:"inbox.delivery.started",operation_id:f,fields:y(r)});for(const o of n)await t.sendCustomMessage({customType:_,content:o,display:!0})})}catch(f){throw d===void 0&&this.raiseReadFatal("poll",f),T(d,r,"send",f),f}d===void 0&&this.raiseReadFatal("poll",new Error(`${e} prompt-join delivery returned without an operation id`));const a={operationId:d,...r,settleAtAgentSettled:!0};if(!this.canMutate()){this.disposed&&this.disposalReason!==void 0&&M(a,this.disposalReason);return}this.pendingHandoffs.push(a)}coveredEntryIds(t){const e=new Set;for(const i of this.pendingHandoffs)if(i.channel===t)for(const n of i.entryIds)e.add(n);return e}retryPendingCommit(t){const e=this.pendingCommit;if(e===void 0)return Promise.resolve("settled");if(e.attempt!==void 0)return e.attempt;const i=this.attemptPendingCommit(t,e).finally(()=>{e.attempt===i&&(e.attempt=void 0)});return e.attempt=i,i}async attemptPendingCommit(t,e){let i=!1;try{const r=await G(t,e.receipts);if(r.action==="hold")return"refresh_held";for(const d of e.receipts){const a=r.results.find(f=>f.delivery_id===d.delivery_id);if(a?.outcome!==d.disposition&&a?.outcome!=="stale")throw new Error("daemon returned no terminal mail settlement outcome")}i=r.results.every(d=>d.outcome==="acknowledged")}catch(r){if(this.pendingCommit===e)for(const d of e.handoffs)T(d.operationId,d,"receipt_commit",r);return"held"}if(this.pendingCommit!==e)return"settled";for(const r of e.entryIds)this.claims.delete(r);if(e.receipts.some(r=>r.disposition==="released")){const r=new Set(e.entryIds);this.buffer.splice(0,this.buffer.length,...this.buffer.filter(d=>!r.has(d.entry_id)))}this.pendingCommit=void 0;const n=this.detachPending(r=>r.entryIds.every(d=>!this.claims.has(d)));for(const r of n)i&&de(r);return"settled"}async settle(t,e,i,n=!1){if(i)try{if(e?.hasPendingMessages?.()===!0)return"held"}catch{}if(this.pendingCommit!==void 0)return this.retryPendingCommit(t);const r=L(),d=!r&&this.pendingHandoffs.some(h=>h.awaitingDequeue!==void 0)&&await this.nodeRefreshing(t);if(this.pendingCommit!==void 0)return this.retryPendingCommit(t);const a=new Set(this.buffer.map(h=>h.entry_id)),f=new Set(d?this.pendingHandoffs.filter(h=>h.awaitingDequeue!==void 0).flatMap(h=>[...h.entryIds]):[]),o=this.pendingHandoffs.filter(h=>(n||h.settleAtAgentSettled!==!0)&&h.entryIds.every(g=>!f.has(g))),c=new Set(o.flatMap(h=>[...h.entryIds])),u=[...this.claims.keys()].filter(h=>r||c.has(h)&&!a.has(h));return u.length===0?"settled":(this.pendingCommit={handoffs:o,entryIds:u,receipts:u.map(h=>{const g=this.claims.get(h);return{delivery_id:g.delivery_id,attempts:g.attempts,disposition:r?"released":"acknowledged"}})},this.retryPendingCommit(t))}async nodeRefreshing(t){try{return(await j(t)).node.intent==="refresh"}catch{return!0}}detachPending(t){const e=[];for(let i=this.pendingHandoffs.length-1;i>=0;i-=1){const n=this.pendingHandoffs[i];t(n)&&e.push(...this.pendingHandoffs.splice(i,1))}return e.reverse(),e}}function ue(s,t){p?.dispose("reload",!1);const e=new he(s,t,++re);p=e;const i=l(n=>e.prependHeldDeferredInbox(n),"promptJoin");globalThis[ne]=i;try{e.start()}catch(n){throw e.dispose("reload",!1),n}return e}l(ue,"installWatcher");function ce(s){const t=ue(s,se());return()=>t.dispose("shutdown",!1)}l(ce,"registerCanvasInboxWatcher");var Fe=ce;export{Fe as default,ce as registerCanvasInboxWatcher};

package/dist/pi-extensions/canvas-passive-context.d.ts

@@ -0,0 +1,38 @@
+import type { MailEntryDTO } from '../api/dto/mail.js';
+type BrokerPassiveEntry = MailEntryDTO;
+interface InputEventLike {
+    type: 'input';
+    text: string;
+    images?: unknown[];
+    source: 'interactive' | 'rpc' | 'extension';
+}
+type InputEventResultLike = {
+    action: 'continue';
+} | {
+    action: 'transform';
+    text: string;
+    images?: unknown[];
+} | {
+    action: 'handled';
+};
+interface PiLike {
+    on(event: 'input', handler: (event: InputEventLike, ctx: any) => InputEventResultLike | void | Promise<InputEventResultLike | void>): void;
+    on(event: 'agent_settled' | 'session_shutdown', handler: (event: any, ctx: any) => void | Promise<void>): void;
+}
+/**
+ * Render drained passive entries (oldest first) into one XML pre-text block.
+ * Each accumulated message is its own timestamped `<update>` element.
+ */
+export declare function formatPassive(entries: BrokerPassiveEntry[], nodeId?: string): Promise<string>;
+/**
+ * Place the backlog block on a message without displacing a runtime card.
+ *
+ * A runtime card is a WHOLE-message envelope: it opens at byte 0 and closes at
+ * the last byte. The inbox watcher's own wake arrives through this same `input`
+ * event, so prepending to it would push the envelope off byte 0 and every
+ * reader would attribute the digest to the person. Inside the card, the backlog
+ * becomes the body's first child instead.
+ */
+export declare function placeBacklog(text: string, preText: string): string;
+export declare function registerCanvasPassiveContext(pi: PiLike): void;
+export default registerCanvasPassiveContext;

package/dist/pi-extensions/canvas-passive-context.js

@@ -0,0 +1,14 @@
+var w=Object.defineProperty;var u=(t,e)=>w(t,"name",{value:e,configurable:!0});import{envNodeId as v}from"../shared/env.js";import{isAbsolute as $}from"node:path";import{acknowledgeBrokerMail as h,claimBrokerMail as b,readBrokerPassiveMessage as k}from"../core/runtime/broker/daemon-ops.js";import{ApiError as C}from"../api/errors.js";import{wasTurnRefused as j}from"../core/runtime/broker/extension-abort.js";import{emitEvent as A}from"../core/events/emit.js";import{parseCard as B}from"../shared/generated-context.js";const g=4e3;function M(t){if(!t.startsWith(`---
+`))return t;const e=t.indexOf(`
+---
+`,4);return e===-1?t:t.slice(e+5)}u(M,"stripFrontmatter");async function P(t,e){if(e.ref!==void 0&&e.ref!==""){const r=e.data?.report_body;if(typeof r=="string"&&r.trim()!==""){const i=r.trim();return i.length>g?`${i.slice(0,g)}
+\u2026 (truncated; read the full report with \`crtr canvas read ${e.ref}\`)`:i}if($(e.ref))try{const{content:i}=await k(t,e.ref),f=M(i).trim();if(f!=="")return f.length>g?`${f.slice(0,g)}
+\u2026 (truncated; full report at ${e.ref})`:f}catch(i){if(!(i instanceof C)||i.status!==404)throw i}}const l=e.data?.body;return typeof l=="string"&&l.trim()!==""?l.trim():e.label}u(P,"entryContent");function p(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")}u(p,"attr");async function E(t,e=v()??""){const l=(await Promise.all(t.map(async r=>{const i=p(r.from??"system"),f=r.from_name!==void 0&&r.from_name!==""?` from_name="${p(r.from_name)}"`:"",m=r.ref!==void 0&&r.ref!==""?` ref="${p(r.ref)}"`:"";return`<update from="${i}"${f} kind="${p(r.kind)}" at="${p(r.ts)}"${m}>
+${await P(e,r)}
+</update>`}))).join(`
+`);return`<passive-subscription-backlog count="${t.length}" note="Reports accumulated from nodes you passively subscribe to while you were not actively listening. Surfaced now because you were messaged. Oldest first.">
+${l}
+</passive-subscription-backlog>`}u(E,"formatPassive");const I="</runtime>";function O(t,e){if(t.trim()==="")return e;const l=B({role:"user",content:t});if(l===null)return`${e}
+
+${t}`;const r=t.length-l.body.length-I.length;return`${t.slice(0,r)}${e}
+${t.slice(r)}`}u(O,"placeBacklog");function R(t){const e=new Map,l=new Map;let r,i;function f(c){try{A({level:"error",event:"inbox.delivery.failed",outcome:"failed",error:c,fields:{channel:"passive"}})}catch{}}u(f,"reportFailure");async function m(c){if(i!==void 0)return i;if(r===void 0&&(r=[...e.values()].filter(o=>o.injected).map(({claim:o})=>({delivery_id:o.delivery_id,attempts:o.attempts,disposition:j()?"released":"acknowledged"}))),r.length===0)return r=void 0,!0;const a=r,d=(async()=>{try{const o=await h(c,a);if(o.action==="hold")return!1;for(const s of a){const n=o.results.find(y=>y.delivery_id===s.delivery_id);if(n?.outcome!==s.disposition&&n?.outcome!=="stale")throw new Error(`passive mail settlement has no terminal outcome: ${s.delivery_id}`)}for(const s of a)e.delete(s.delivery_id);return r=void 0,!0}catch(o){return f(o),!1}})().finally(()=>{i===d&&(i=void 0)});return i=d,d}u(m,"settle"),t.on("input",async c=>{const a=v();if(!(a===void 0||a.trim()===""))try{if(r!==void 0&&!await m(a))return;const d=await b(a,"passive",l);if(d.action==="hold")return;for(const n of d.deliveries)e.has(n.delivery_id)||e.set(n.delivery_id,{claim:n,injected:!1});const o=[...e.values()].filter(n=>!n.injected);if(o.length===0)return;const s=O(c.text,await E(o.map(({claim:n})=>n.entry),a));for(const n of o)n.injected=!0;return{action:"transform",text:s,images:c.images}}catch(d){f(d);const o=[...e.values()].filter(s=>!s.injected);if(o.length>0)try{const s=await h(a,o.map(({claim:n})=>({delivery_id:n.delivery_id,attempts:n.attempts,disposition:"released"})));if(s.action!=="hold")for(const n of o){const y=s.results.find(_=>_.delivery_id===n.claim.delivery_id)?.outcome;(y==="released"||y==="stale")&&e.delete(n.claim.delivery_id)}}catch(s){f(s)}return}}),t.on("agent_settled",async()=>{const c=v();c!==void 0&&c!==""&&await m(c)}),t.on("session_shutdown",async(c,a)=>{const d=v();d!==void 0&&d!==""&&a?.hasPendingMessages?.()!==!0&&await m(d)})}u(R,"registerCanvasPassiveContext");var Y=R;export{Y as default,E as formatPassive,O as placeBacklog,R as registerCanvasPassiveContext};

package/dist/pi-extensions/canvas-preview-result.d.ts

@@ -0,0 +1,22 @@
+interface ToolResultEvent {
+    toolName: string;
+    toolCallId: string;
+    details?: Record<string, unknown>;
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+}
+interface PiLike {
+    on(event: 'tool_result', handler: (event: ToolResultEvent) => {
+        details: Record<string, unknown>;
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+    } | void): void;
+}
+/** Loaded into every canvas broker. Plain Pi sessions have no node id and
+ * deliberately receive no filesystem transport. */
+export declare function registerCanvasPreviewResult(pi: PiLike): void;
+export default registerCanvasPreviewResult;

package/dist/pi-extensions/canvas-preview-result.js

@@ -0,0 +1,4 @@
+var d=Object.defineProperty;var i=(t,r)=>d(t,"name",{value:r,configurable:!0});import{envNodeId as f}from"../shared/env.js";import{existsSync as p,readFileSync as y,rmSync as m}from"node:fs";import{previewResultPath as h}from"../core/preview-result-path.js";import{autoLoadedContextInner as x,mergeAutoLoadedContext as A}from"./envelope-merge.js";function j(t){if(t===null||typeof t!="object"||typeof t.path!="string")return!1;const r=t;return r.result!==void 0&&r.result!==null&&typeof r.result=="object"&&!Array.isArray(r.result)||Array.isArray(r.jsonl)&&r.jsonl.every(e=>e!==null&&typeof e=="object"&&!Array.isArray(e))||r.error!==void 0&&r.error!==null&&typeof r.error=="object"&&!Array.isArray(r.error)}i(j,"isPreviewRecord");function g(t){const r=[];for(const e of y(t,"utf8").split(`
+`))if(e.trim()!=="")try{const o=JSON.parse(e);j(o)&&r.push(o)}catch{}return r}i(g,"readPreviewRecords");function w(t){f()===void 0||f()===""||t.on("tool_result",r=>{if(r.toolName!=="bash")return;const e=h(r.toolCallId);if(p(e))try{const o=g(e),c=o.at(-1);if(c===void 0)return;const l=o.filter(s=>s.path==="canvas read"&&typeof s.result?.readMetadata=="string");let n=r.content;if(l.length>0){const s=l.map(a=>a.result.readMetadata);n=[...n,{type:"text",text:s.join(`
+
+`)}];const u=l.map(a=>x(String(a.result.readContext??""))).filter(a=>a!==null);n=A(u,n,"after")}return{details:{...r.details??{},crtrPreview:c,crtrPreviews:o},content:n}}catch{return}finally{m(e,{force:!0})}})}i(w,"registerCanvasPreviewResult");var R=w;export{R as default,w as registerCanvasPreviewResult};

package/dist/pi-extensions/canvas-prompt-scrub.d.ts

@@ -0,0 +1,13 @@
+/** Strip pi's self-references from an assembled system prompt. */
+export declare function scrubPromptSelfReference(systemPrompt: string): string;
+interface BeforeAgentStartEventLike {
+    systemPrompt: string;
+}
+interface PiLike {
+    on(event: 'before_agent_start', handler: (event: BeforeAgentStartEventLike) => {
+        systemPrompt: string;
+    } | void): void;
+}
+/** Register the system-prompt scrub for a canvas node. */
+export declare function registerCanvasPromptScrub(pi: PiLike): void;
+export default registerCanvasPromptScrub;

package/dist/pi-extensions/canvas-prompt-scrub.js

@@ -0,0 +1,2 @@
+var i=Object.defineProperty;var t=(n,e)=>i(n,"name",{value:e,configurable:!0});import{envNodeId as a}from"../shared/env.js";const s="You are an expert coding assistant operating inside pi, a coding agent harness.",c="You are an expert coding assistant.",d="Pi documentation (read only",p=/\n*^Pi documentation \(read only[^\n]*:(?:\n[ \t]*-[^\n]*)*/m;function u(n){let e=n;return e.includes(s)&&(e=e.replace(s,c)),e.includes(d)&&(e=`${e.replace(p,"").trimEnd()}
+`),e}t(u,"scrubPromptSelfReference");function m(n){const e=a();e===void 0||e.trim()===""||n.on("before_agent_start",r=>{const o=u(r.systemPrompt);if(o!==r.systemPrompt)return{systemPrompt:o}})}t(m,"registerCanvasPromptScrub");var l=m;export{l as default,m as registerCanvasPromptScrub,u as scrubPromptSelfReference};

package/dist/pi-extensions/canvas-recap.d.ts

@@ -0,0 +1,54 @@
+import { generateRecap } from '../core/runtime/recap.js';
+interface TextContentLike {
+    type: string;
+    text?: string;
+}
+interface MessageLike {
+    role: string;
+    content: string | TextContentLike[];
+}
+interface SessionEntryLike {
+    type: string;
+    message?: MessageLike;
+    customType?: string;
+    details?: {
+        reviewId?: string;
+    };
+}
+interface SessionManagerLike {
+    getEntries(): SessionEntryLike[];
+}
+interface UIContextLike {
+    setWidget(key: string, content: string[] | undefined, options?: {
+        placement?: 'aboveEditor' | 'belowEditor';
+    }): void;
+    notify?(message: string, type?: 'info' | 'warn' | 'warning' | 'error'): void;
+}
+interface ExtensionCtxLike {
+    ui?: UIContextLike;
+    mode?: string;
+    sessionManager?: SessionManagerLike;
+    model?: {
+        provider?: string;
+        id?: string;
+    };
+}
+type PiEvents = 'session_start' | 'input' | 'message_update' | 'turn_end' | 'session_shutdown';
+interface PiLike {
+    on(event: PiEvents, handler: (event: any, ctx: ExtensionCtxLike) => void): void;
+    registerCommand?(name: string, options: {
+        description: string;
+        handler: (args: string, ctx: ExtensionCtxLike) => Promise<void> | void;
+    }): void;
+    getSessionName?(): string | undefined;
+    setSessionName?(name: string): void;
+}
+type NameRegenerator = (nodeId: string, conversation: string, isStillAutomatic: () => boolean, onNamed?: (editorLabel: string) => void) => void;
+/**
+ * Register the inactivity-recap chrome on `pi`.
+ *
+ * Returns immediately (inert) when CRTR_NODE_ID is absent — a plain pi session
+ * or legacy job agent loads it as a no-op.
+ */
+export declare function registerCanvasRecap(pi: PiLike, recapGenerator?: typeof generateRecap, nameRegenerator?: NameRegenerator): void;
+export default registerCanvasRecap;

package/dist/pi-extensions/canvas-recap.js

@@ -0,0 +1,11 @@
+var B=Object.defineProperty;var a=(n,s)=>B(n,"name",{value:s,configurable:!0});import{envNodeId as O,envRecapIdleMs as U}from"../shared/env.js";import{brokerExtensionState as $}from"../core/runtime/broker/daemon-ops.js";import{generateRecap as V}from"../core/runtime/recap.js";import{putBrokerRecap as q}from"../core/runtime/broker/daemon-ops.js";import{isReviewBoundary as F}from"../core/runtime/session-visibility.js";import{editorLabelForBrokerNode as H}from"../core/runtime/broker-extension-render.js";import{generateAndCommitRecapName as K,readRoadmap as Y}from"./broker-local.js";function z(){return U()}a(z,"idleMs");const J=7e3,b=5,Q=1200,C="crtr-recap";let A;function X(n){const s=n.content;return typeof s=="string"?s.trim():Array.isArray(s)?s.filter(r=>r!==null&&typeof r=="object"&&r.type==="text"&&typeof r.text=="string").map(r=>(r.text??"").trim()).filter(r=>r!=="").join(`
+`).trim():""}a(X,"messageText");function Z(n,s){let r;try{r=n.getEntries()}catch{return{entries:[],boundaryPresent:s===void 0}}if(s===void 0)return{entries:r,boundaryPresent:!0};const t=r.findIndex(o=>F(o,s));return t===-1?{entries:[],boundaryPresent:!1}:{entries:r.slice(t+1),boundaryPresent:!0}}a(Z,"recapEntries");function D(n,s,r,t){const{entries:o,boundaryPresent:u}=Z(n,t),l=[],m=a(d=>{const p=d.role;if(p!=="user"&&p!=="assistant")return;let f=X(d);if(f==="")return;f.length>s&&(f=`${f.slice(0,s)} \u2026[truncated]`);const g=`${p==="user"?"User":"Agent"}: ${f}`;l.at(-1)!==g&&l.push(g)},"append");for(const d of o)d.type!=="message"||d.message===void 0||m(d.message);return u&&r?.role==="assistant"&&m(r),l}a(D,"conversationParts");function ee(n,s,r){const t=D(n,Q,s,r);if(t.length===0)return"";if(t.length<=b*2)return t.join(`
+
+`);const o=t.length-b*2;return[...t.slice(0,b),`[\u2026 ${o} message${o===1?"":"s"} omitted \u2026]`,...t.slice(t.length-b)].join(`
+
+`)}a(ee,"buildConversation");function te(n,s,r){const t=D(n,600,s,r);if(t.length===0)return"";const o=48;return t.length<=o?t.join(`
+
+`):Array.from({length:o},(l,m)=>{const d=Math.round(m*(t.length-1)/(o-1));return t[d]}).join(`
+
+`)}a(te,"buildNamingConversation");function ne(n,s=V,r){const t=O();if(t===void 0||t.trim()==="")return;let o,u,l,m;const d=a(i=>{const e=i.model?.provider?.trim(),c=i.model?.id?.trim();e&&c&&(m=`${e}/${c}`)},"captureLiveModel");let p=Date.now(),f=0,g,y=!1,_=!1,S=!1,h=!1,I;const v=a(()=>o!==void 0&&typeof o.setWidget=="function","canPaint"),w=a(i=>{try{o?.notify?.(i,"info")}catch{}},"notify"),x=a(()=>{if(v())try{o.setWidget(C,void 0,{placement:"aboveEditor"})}catch{}},"clearRecap"),j=a(i=>{if(!v()||i==="")return;const e=i.split(`
+`).filter(c=>c.trim()!=="");if(e.length!==0)try{o.setWidget(C,e,{placement:"aboveEditor"})}catch{}},"showRecap"),P=a(()=>{p=Date.now(),f+=1,S=!1,y&&(_=!0)},"onMessage"),T=a(i=>{if(!(n.getSessionName===void 0||n.setSessionName===void 0)){if(r!==void 0){const e=n.getSessionName();if(e===void 0)return;r(t,i,()=>n.getSessionName?.()===e,c=>{try{n.setSessionName?.(c)}catch{}});return}$(t).then(({node:e})=>{if(e.name.trim()!==""&&e.name!==e.kind)return;const c=H(e);n.getSessionName?.()===c&&K(t,i,{name:e.name,description:e.description??"",title:e.title??"",icon:e.icon??"",kind:e.kind},()=>n.getSessionName?.()===c,M=>{try{n.setSessionName?.(M)}catch{}})}).catch(()=>{})}},"refreshAutomaticName"),k=a(i=>{if(!v()||u===void 0||h)return;const e=g,c=l?.review_binding?.review_id??u.getEntries().map(N=>N.details?.reviewId).find(N=>typeof N=="string"),M=ee(u,e,c);if(M===""){S=!0,y=!1,_=!1,x();return}S=!1;const L=i?te(u,e,c):"",R=f;i||(I=R),h=!0,i&&(w("Generating recap\u2026"),T(L)),Y(t).catch(()=>null).then(N=>s(M,G=>{!i&&f!==R||!v()||q(t,G).then(()=>{!i&&f!==R||!v()||(y=!0,_=f!==R,j(G),i&&w("Recap ready"))}).catch(W=>w(`Recap could not be saved: ${String(W)}`)).finally(()=>{h=!1})},m,N??void 0)),setTimeout(()=>{h=!1},3e4).unref?.()},"requestRecap");n.registerCommand?.("recap",{description:"Generate a Goal/State recap and refresh the original generated session title",handler:a((i,e)=>{o=e.ui,u=e.sessionManager,d(e),k(!0)},"handler")}),n.on("session_start",(i,e)=>{o=e.ui,u=e.sessionManager,d(e),l=void 0,$(t).then(c=>{l=c.node}).catch(()=>{}),p=Date.now(),f=0,g=void 0,y=!1,_=!1,S=!1,h=!1,I=void 0,x()}),n.on("input",(i,e)=>{P()}),n.on("message_update",(i,e)=>{const c=i?.message;c?.role==="assistant"&&(g=c),P()}),n.on("turn_end",(i,e)=>{g=void 0,d(e),P()}),A!==void 0&&clearInterval(A);const E=setInterval(()=>{try{if(!v()||u===void 0||S||y&&!_||h||I===f||Date.now()-p<z())return;k(!1)}catch{}},J);typeof E.unref=="function"&&E.unref(),A=E,n.on("session_shutdown",()=>{clearInterval(E),A===E&&(A=void 0)})}a(ne,"registerCanvasRecap");var ue=ne;export{ue as default,ne as registerCanvasRecap};

package/dist/pi-extensions/canvas-review-boundary.d.ts

@@ -0,0 +1,42 @@
+interface SessionEntryLike {
+    type: string;
+    customType?: string;
+    details?: {
+        reviewId?: string;
+    };
+}
+interface SessionStartCtxLike {
+    sessionManager: {
+        /** Required by pi's `ReadonlySessionManager`: the active branch, which is
+         * the context the next turn actually sees. */
+        getBranch: (fromId?: string) => SessionEntryLike[];
+    };
+}
+interface CustomMessageLike {
+    customType: string;
+    content: string;
+    display?: boolean;
+    details?: {
+        reviewId: string;
+        originNodeId: string;
+        targetFile: string;
+        /** Which binding flavor authored this marker — lets a display surface
+         * (e.g. crouter cloud's native boundary) pick its copy without parsing the
+         * agent-facing prose. Absent on markers written before this field. */
+        kind: 'review' | 'page_feedback';
+    };
+}
+interface PiLike {
+    on: (event: 'session_start', handler: (event: unknown, ctx: SessionStartCtxLike) => void | Promise<void>) => void;
+    sendMessage: (message: CustomMessageLike, options?: {
+        deliverAs?: string;
+        triggerTurn?: boolean;
+    }) => void;
+}
+/**
+ * Register the review boundary marker. Companion nodes receive one boundary
+ * marker on session_start that separates inherited context from the visible
+ * transcript. Ordinary nodes get nothing.
+ */
+export declare function registerCanvasReviewBoundary(pi: PiLike): void;
+export default registerCanvasReviewBoundary;

package/dist/pi-extensions/canvas-review-boundary.js

@@ -0,0 +1,3 @@
+var h=Object.defineProperty;var d=(e,a)=>h(e,"name",{value:a,configurable:!0});import{envNodeId as f}from"../shared/env.js";import{brokerExtensionState as m}from"../core/runtime/broker/daemon-ops.js";import{isReviewBoundary as w,REVIEW_BOUNDARY_CUSTOM_TYPE as _}from"../core/runtime/session-visibility.js";import{formatCard as b}from"../shared/generated-context.js";function l(e){e.on("session_start",async(a,v)=>{const i=f();if(!i||i.trim()==="")return;let n;try{n=(await m(i)).node}catch{return}if(n.review_binding==null||v.sessionManager.getBranch().some(g=>w(g,n.review_binding?.review_id)))return;const r=n.review_binding,{review_id:t,origin_node_id:o,target_file:s}=r,c=r.kind==="page_feedback"?[`This conversation began from feedback on page ${t}.`,`Page source: ${s}`,`Origin node: ${o}`,"","The person's visible transcript starts here. Everything above this marker is the origin node's work \u2014 inherited context they have not seen."].join(`
+`):[`Reviewed file: ${s}`,`Review ID: ${t}`,`Origin node: ${o}`,"","The person's visible transcript starts here. Everything above this marker is inherited context they have not seen."].join(`
+`);e.sendMessage({customType:_,content:b("review-boundary",{},c),display:!0,details:{reviewId:t,originNodeId:o,targetFile:s,kind:r.kind??"review"}})})}d(l,"registerCanvasReviewBoundary");var R=l;export{R as default,l as registerCanvasReviewBoundary};

package/dist/pi-extensions/canvas-stamp.d.ts

@@ -0,0 +1,14 @@
+interface StampCtxLike {
+    sessionManager: {
+        /** Whole file, not the active branch: a session stamp on an abandoned
+         *  branch still describes this file's owner. */
+        getEntries: () => unknown[];
+    };
+}
+interface PiLike {
+    on: (event: 'session_start' | 'message_end', handler: (event: unknown, ctx: StampCtxLike) => void | Promise<void>) => void;
+    appendEntry: (customType: string, data?: unknown) => void;
+}
+/** Register the stamp writer. */
+export declare function registerCanvasStamp(pi: PiLike): void;
+export default registerCanvasStamp;

package/dist/pi-extensions/canvas-stamp.js

@@ -0,0 +1,2 @@
+var u=Object.defineProperty;var o=(e,n)=>u(e,"name",{value:n,configurable:!0});import{envNodeId as f}from"../shared/env.js";import{crtrVersion as p}from"../shared/crtr-version.js";import{claimMessageAnnouncement as d,drainStampExt as l,hasPendingStampExt as g}from"../core/runtime/stamp/channel.js";import{CRTR_STAMP_CUSTOM_TYPE as i,latestSessionStamp as c,STAMP_SCHEMA_VERSION as y}from"../core/runtime/stamp/protocol.js";function S(e){return typeof e=="string"?e:Array.isArray(e)?e.filter(n=>typeof n=="object"&&n!==null&&typeof n.text=="string").map(n=>n.text).join(`
+`):""}o(S,"messageText");function m(e,n){const t=l();return{v:y,kind:e,payload:n,...t===void 0?{}:{ext:t}}}o(m,"envelope");function E(e){e.on("session_start",(n,t)=>{const r=f();if(r===void 0||r.trim()==="")return;const s=p(),a=c(t.sessionManager.getEntries());a!==null&&a.payload.node===r&&a.payload.crtr===s||e.appendEntry(i,m("session",{node:r,crtr:s}))}),e.on("message_end",n=>{const t=n?.message;if(t==null||typeof t.timestamp!="number")return;const r=t.timestamp;if(t.role==="user"){const s=d(S(t.content));e.appendEntry(i,m("message",{msgTs:r,...s===null?{}:s}));return}g()&&e.appendEntry(i,m("message",{msgTs:r}))})}o(E,"registerCanvasStamp");var v=E;export{v as default,E as registerCanvasStamp};

package/dist/pi-extensions/canvas-stophook.d.ts

@@ -0,0 +1,48 @@
+type PiEvents = 'agent_start' | 'turn_end' | 'agent_end' | 'agent_settled' | 'session_shutdown' | 'session_start' | 'input' | 'tool_execution_start' | 'tool_execution_end' | 'tool_execution_update' | 'message_update';
+interface PiLike {
+    on: (event: PiEvents, handler: (event: any, ctx: any) => void | Promise<void>) => void;
+    sendUserMessage: (content: string, options?: {
+        deliverAs?: 'steer' | 'followUp';
+    }) => void;
+    /** Custom-message injection — used for the 'nextTurn' hold (queued silently,
+     *  injected alongside the NEXT user message, never triggers a turn). */
+    sendMessage: (message: {
+        customType: string;
+        content: string;
+        display?: boolean;
+        details?: Record<string, unknown>;
+    }, options?: {
+        deliverAs?: 'steer' | 'followUp' | 'nextTurn';
+        triggerTurn?: boolean;
+    }) => void;
+}
+/** The nudge text for a crossed band, specialized to the node's (mode,
+ *  lifecycle) persona + how far along the escalation it is. `crtr node yield` is
+ *  the single "keep going past this window" verb for every persona: it refreshes
+ *  the node into a clean window, MODE-PRESERVING — a base node stays base,
+ *  continuing fresh against its goal and its note. `--promote` is a separate,
+ *  explicit opt-in (never steered here as auto-behavior) for when worthwhile
+ *  independent work can run in parallel and coordination should become the
+ *  node's primary job — so no persona is ever steered at a bare `node promote` (which framed promotion as a heavy
+ *  "become an orchestrator" step and bred yield-avoidance).
+ *
+ *  - orchestrator (terminal OR resident): bring the roadmap current, then
+ *    yield (it already has a roadmap to bring current first).
+ *  - resident/base (root conversation): yield to continue fresh if the chat is
+ *    growing into a job, else wrap up — a root can simply end.
+ *  - terminal/base (worker): yield to continue if work remains, or `push final`
+ *    when close.
+ *
+ *  The wording strengthens with depth: gentle < 150k → firm < 185k → pushy at/
+ *  past 185k, where drifting further risks an overflow. */
+export declare function steerNote(at: number, lifecycle: string, mode: string): string;
+/**
+ * Register the canvas turn and settlement handlers on `pi`.
+ *
+ * Returns immediately when CRTR_NODE_ID is absent — the extension is fully
+ * inert in a non-canvas pi session. Safe to call multiple times (each call
+ * re-registers on the same `pi` instance, so it should only be called once
+ * per node lifecycle, matching how pi loads extensions).
+ */
+export declare function registerCanvasStophook(pi: PiLike): void;
+export default registerCanvasStophook;

package/dist/pi-extensions/canvas-stophook.js

@@ -0,0 +1 @@
+var X=Object.defineProperty;var l=(n,t)=>X(n,"name",{value:t,configurable:!0});import{brokerSignalClient as P}from"../core/runtime/broker/signal-stream.js";import{brokerExecutionId as K}from"../core/runtime/broker/daemon-ops.js";import{envNodeId as Z}from"../shared/env.js";import{stripCdPrefix as ee}from"../shared/strip-cd-prefix.js";import{contextDir as te}from"../core/canvas/paths.js";import{mutateBrokerFault as ne,recordBrokerTelemetry as re,recordBrokerTurn as x,clearBrokerPushedFinal as oe,consumeBrokerPushedFinal as se}from"../core/runtime/broker/daemon-ops.js";import{bindBrokerSession as ae,cachedBrokerNode as j,relaunchBrokerRoot as ie,settleBroker as L}from"../core/runtime/broker/daemon-ops.js";import{emitEvent as F}from"../core/events/emit.js";import{activeBackgroundBashJobs as le}from"../core/bash-jobs.js";import{CONTEXT_NUDGE_CUSTOM_TYPE as ue,formatCard as ce}from"../shared/generated-context.js";import{isReviewBoundary as de}from"../core/runtime/session-visibility.js";import{clearRefusedTurn as fe,isRuntimeTeardownInProgress as he,refuseTurn as me,runRefreshAbort as ge}from"../core/runtime/broker/extension-abort.js";import{announceMessageOrigin as Y}from"../core/runtime/stamp/channel.js";const z=80;function ye(n,t){const i=t??{},s=l(w=>typeof w=="string"?w:"","pick"),h=ee(s(i.command).trim())||s(i.path)||s(i.file_path)||s(i.pattern)||s(i.description)||s(i.prompt),m=(h!==""?`${n}: ${h}`:n).replace(/\s+/g," ").trim();return m.length>z?m.slice(0,z):m}l(ye,"summarizeActivity");function pe(n){for(let t=n.length-1;t>=0;t--)if(n[t]?.role==="assistant")return n[t]}l(pe,"lastAssistantMessage");function we(n){try{const t=n?.sessionManager?.getBranch();if(!Array.isArray(t))return[];const i=new Set;for(const s of t){if(!de(s))continue;const u=s.details?.reviewId;typeof u=="string"&&i.add(u)}return[...i]}catch{return[]}}l(we,"currentReviewBoundaryIds");const G=1e4,A=[13e4,15e4,17e4,185e3,2e5];function _e(n){const t=A[0],i=A[A.length-1];if(n<t)return null;if(n>=i)return i+Math.floor((n-i)/G)*G;let s=t;for(const u of A)n>=u&&(s=u);return s}l(_e,"steerBand");function ke(n,t,i){const s=Math.round(n/1e3),u=n>=185e3;if(i==="orchestrator")return n<15e4?`Context ~${s}k and growing. When you reach a good stopping point, consider updating your roadmap (\`crtr doc edit roadmap\`) and running \`crtr node yield\` to refresh against it \u2014 no rush yet.`:u?`Context ~${s}k \u2014 this is getting long. Stop taking on new work now: bring your roadmap current, hand off anything outstanding, and \`crtr node yield\` immediately to refresh before this context overflows.`:`Context ~${s}k. Update your roadmap (\`crtr doc edit roadmap\`) so a fresh revive can continue, delegate any outstanding work, then \`crtr node yield\` to refresh.`;if(t==="resident"){const h="If substantial work remains, `crtr node yield` to continue fresh against your goal and your note. Add --promote only when worthwhile independent work can run in parallel and coordinating it should become your primary job; `crtr node yield -h` has the boundary.";return n<15e4?`Context ~${s}k and growing. ${h} Otherwise no rush \u2014 wrap up when you reach a good stopping point.`:u?`Context ~${s}k \u2014 this is getting long. Wrap up now before this context overflows: finish what's in hand, or \`crtr node yield\` immediately to continue fresh against your goal and your note if substantial work remains.`:`Context ~${s}k. ${h} If you're near done, just finish here; if there's more open-ended work, \`crtr node yield\` rather than letting this context grow.`}return n<15e4?`Context ~${s}k and growing. If you're near done, finish with \`crtr push final\`. If real work remains, \`crtr node yield\` to continue in a fresh window against your goal and your note \u2014 no rush yet.`:u?`Context ~${s}k \u2014 this is getting long. Wrap up now before this context overflows: \`crtr push final\` if you're close, otherwise \`crtr node yield\` immediately to continue in a fresh window against your goal and your note.`:`Context ~${s}k. If you're close, finish with \`crtr push final\`; otherwise \`crtr node yield\` now to refresh into a clean window and keep going against your goal and your note.`}l(ke,"steerNote");function be(n){const t=Z();if(t===void 0||t.trim()==="")return;let i=0,s=0,u="",h=null,m=null;const w=new Set;let k=!1,C=!1;const D=l(e=>{if(!C){C=!0;try{ge(()=>e?.abort?.())}catch{}}},"abortForRefresh");let T;const Q=P().subscribe("node",()=>{const e=P();k&&e.state==="connected"&&e.latestNode?.intent==="refresh"&&D(T)}),N=l(()=>le(te(t)).length>0,"backgroundJobsRunning"),c=l((e,r)=>{F({event:"broker.daemon.operation.failed",level:"error",node_id:t,error:r,fields:{operation:e}})},"emitDaemonOperationFailure"),O=l((e,r)=>{if(e.action==="reprompt"){Y(e.prompt,{type:"runtime",kind:"stop-guard"}),n.sendUserMessage(e.prompt,{deliverAs:"followUp"});return}if(e.action==="shutdown")try{r?.shutdown?.()}catch{}},"enactSettleDirective"),V=3e3;let U=0,I=Promise.resolve(),d=null,q=null,J=-1/0,g=null,R=0;const S=l(()=>{if(d===null||d===q)return;const e=d;q=e,J=Date.now(),I=I.then(()=>re(t,e)).catch(r=>c("telemetry",r))},"queueTelemetry"),B=l((e,r)=>{if(d!==null&&d.tokens_in===i&&d.tokens_out===s&&d.model===u&&d.context_tokens===e&&d.last_activity===r)return;R=Math.max(Date.now(),R+1),d={tokens_in:i,tokens_out:s,model:u,context_tokens:e,last_activity:r,updated_at:new Date(R).toISOString()};const o=2e3-(Date.now()-J);o<=0?S():g===null&&(g=setTimeout(()=>{g=null,S()},o),g.unref?.())},"publishTelemetry"),E=l(()=>(g!==null&&clearTimeout(g),g=null,S(),I),"flushTelemetry");let $=Promise.resolve();const H=l(e=>($=$.catch(()=>{}).then(async()=>{const r=await x(t,{event:"progress"});(r.fault_link==="daemon\u2192node"||e&&r.fault_link==="pi\u2192provider")&&await ne(t,{op:"clear",link:r.fault_link})}),$),"reportProgress"),v=l(()=>{const e=Date.now();e-U<V||(U=e,H(!1).catch(r=>c("turn_progress",r)))},"heartbeat");n.on("session_start",async(e,r)=>{try{const o=r?.sessionManager?.getSessionId?.();if(typeof o!="string"||o==="")return;const y=r?.sessionManager?.getSessionFile?.(),p=typeof y=="string"&&y!==""?y:null,_=typeof e?.reason=="string"?e.reason:null;_==="new"&&(i=0,s=0,w.clear());const a=await ae(t,{piSessionId:o,sessionFile:p,pid:process.pid,reason:_,reviewBoundaryIds:we(r)});if(a.action==="none"&&P().start(t,K()),a.action==="shutdown"){try{r?.shutdown?.()}catch{}return}if(a.action==="relaunch_root"){ie(t).catch(f=>{const b=f instanceof Error?f.message:String(f);r?.ui?.notify?.(`/new refused: ${b}`,"error"),F({event:"broker.daemon.operation.failed",level:"error",node_id:t,error:f,fields:{operation:"relaunch_root"}})});return}}catch(o){F({event:"broker.daemon.operation.failed",level:"error",node_id:t,error:o,fields:{operation:"session_bound"}})}}),n.on("agent_start",async(e,r)=>{k=!0,T=r;try{if(!(await x(t,{event:"started"})).applied)throw new Error("daemon refused turn open")}catch(o){c("turn_open",o),r?.ui?.notify?.("Turn refused: the broker no longer owns this node.","error"),me(()=>r?.abort?.())}}),n.on("input",async()=>{k||(C=!1),fe();try{await oe(t)}catch(e){throw c("clear_pushed_final",e),e}}),n.on("tool_execution_start",e=>{try{m=ye(String(e?.toolName??""),e?.args),B(h,m),v()}catch{}}),n.on("tool_execution_update",()=>{try{v()}catch{}}),n.on("message_update",()=>{try{v()}catch{}}),n.on("tool_execution_end",async(e,r)=>{try{v(),(await j(t)).intent==="refresh"&&D(r)}catch{}}),n.on("session_shutdown",async(e,r)=>{Q(),k=!1,T=void 0,await E();try{await x(t,{event:"closed",end_reason:"teardown-aborted"})}catch(o){c("turn_close_teardown",o)}if(e?.reason==="quit")try{const o=await L(t,{stopReason:"quit",backgroundJobsRunning:N(),pushedFinal:!1});O(o,r)}catch(o){c("settle_quit",o)}});const W=l(e=>{e?.role!=="assistant"||e.usage==null||(i+=Number(e.usage.input??0)||0,s+=Number(e.usage.output??0)||0,typeof e.model=="string"&&e.model!==""&&(u=e.model))},"accumulate");n.on("turn_end",async(e,r)=>{W(e?.message);let o=null;try{const a=r.getContextUsage()?.tokens;typeof a=="number"&&(o=a)}catch{}o!==null&&(h=o),B(o,m),await E();try{const a=e?.message?.stopReason!=="error"&&e?.message?.stopReason!=="aborted";await H(a)}catch(a){c("turn_end_fault_clear",a)}const y=Array.isArray(e?.message?.content)?e.message.content:[],p=e?.message?.stopReason??"",_=p!=="error"&&p!=="aborted"&&y.some(a=>a?.type==="toolCall");try{const a=o!==null?_e(o):null,f=a!==null&&!w.has(a)?await j(t):null;if(a!==null&&f!==null){w.add(a);const b=ce("context-nudge",{},ke(a,f.lifecycle,f.mode));_?(Y(b,{type:"runtime",kind:"context-nudge"}),n.sendUserMessage(b,{deliverAs:"steer"})):n.sendMessage({customType:ue,content:b,display:!0},{deliverAs:"nextTurn"})}}catch(a){c("turn_boundary",a)}});let M=null;n.on("agent_end",e=>{M=e;try{const r=Array.isArray(e?.messages)?e.messages:[];for(const o of r)W(o)}catch{}}),n.on("agent_settled",async(e,r)=>{k=!1,T=void 0,B(h,m),await E();const o=M;if(M=null,he())return;try{await x(t,{event:"closed",end_reason:"settled"})}catch(a){c("turn_close",a);return}const y=Array.isArray(o?.messages)?o.messages:[],p=pe(y),_=typeof p?.stopReason=="string"?p.stopReason:"";try{const a=o===null?{pushedFinal:!1}:await se(t),f=await L(t,{stopReason:_,backgroundJobsRunning:N(),pushedFinal:a.pushedFinal});O(f,r)}catch(a){c("settle",a)}})}l(be,"registerCanvasStophook");var De=be;export{De as default,be as registerCanvasStophook,ke as steerNote};