@north-light/cli 0.0.0-stage → 0.3.413

package/dist/core/canvas/remote-canvas-source.d.ts

@@ -0,0 +1,70 @@
+import type { CanvasSource } from './source.js';
+import type { NodeMeta, NodeRow, NodeStatus, SubscriptionRef } from './types.js';
+/** The exact JSON shape `crtr --json node inspect show <id>` emits (see
+ *  `nodeShow` in `src/commands/node/inspect.ts`) — mirrored here, not imported,
+ *  to avoid a commands→canvas value dependency. */
+export interface RemoteShowResponse {
+    node: NodeMeta;
+    reports: {
+        node_id: string;
+        name: string;
+        kind: string;
+        status: string;
+        active: boolean;
+    }[];
+    managers: {
+        node_id: string;
+        name: string;
+        kind: string;
+        status: string;
+        active: boolean;
+    }[];
+    artifacts: {
+        report: number;
+        doc: number;
+        roadmap: number;
+    };
+    pending_crons: number;
+    paths: {
+        context_dir: string;
+        session_file?: string | null;
+    };
+    follow_up: string;
+    fault?: {
+        link: string;
+        kind: string;
+        retry: {
+            disposition: string;
+        };
+        since: string;
+    } | null;
+}
+export declare class RemoteCanvasSource implements CanvasSource {
+    private readonly previewEndpoint;
+    private readonly relayToken;
+    private readonly exec;
+    private nodeCache;
+    private rosterCache;
+    private topologyCache;
+    private viewCache;
+    constructor(previewEndpoint: string, relayToken: string);
+    private execJson;
+    private fetchShow;
+    private topology;
+    private loadTopology;
+    /** The full passthrough object `node inspect show` produces — used by
+     *  `nodeShow`'s remote branch (`src/commands/node/inspect.ts`) to return the exact
+     *  same shape a local read would, without re-deriving it. */
+    rawShow(id: string): Promise<RemoteShowResponse | null>;
+    getNode(id: string): Promise<NodeMeta | null>;
+    getRow(id: string): Promise<NodeRow | null>;
+    listNodes(filter?: {
+        status?: NodeStatus | NodeStatus[];
+    }): Promise<NodeRow[]>;
+    subscriptionsOf(id: string): Promise<SubscriptionRef[]>;
+    subscribersOf(id: string): Promise<SubscriptionRef[]>;
+    view(root: string): Promise<string[]>;
+    ticketCountsForNodes(nodeIds: readonly string[]): Promise<Record<string, number>>;
+    ticketCountsForView(root: string): Promise<Record<string, number>>;
+    hasActiveLiveSubscription(id: string): Promise<boolean>;
+}

package/dist/core/canvas/remote-canvas-source.js

@@ -0,0 +1 @@
+var y=Object.defineProperty;var u=(s,e)=>y(s,"name",{value:e,configurable:!0});import{createRemoteExec as h}from"./remote-transport.js";const d=1e3;function r(s){return typeof s=="object"&&s!==null&&!Array.isArray(s)}u(r,"isPlainObject");function w(s){if(!r(s))return!1;const e=s.node;if(!r(e)||typeof e.node_id!="string"||!Array.isArray(s.reports)||!Array.isArray(s.managers))return!1;const t=s.artifacts;if(!r(t)||typeof t.report!="number"||typeof t.doc!="number"||typeof t.roadmap!="number"||typeof s.pending_crons!="number")return!1;const o=s.paths;if(!r(o)||typeof o.context_dir!="string"||"session_file"in o&&o.session_file!==null&&typeof o.session_file!="string"||typeof s.follow_up!="string")return!1;const n=s.fault;if(n!=null){if(!r(n)||typeof n.link!="string"||typeof n.kind!="string"||typeof n.since!="string")return!1;const i=n.retry;if(!r(i)||typeof i.disposition!="string")return!1}return!0}u(w,"isValidShowResponse");function p(s){return r(s)&&typeof s.node_id=="string"&&typeof s.name=="string"&&typeof s.kind=="string"&&typeof s.status=="string"&&typeof s.active=="boolean"}u(p,"isValidNeighborEntry");function g(s){return r(s)&&typeof s.from_id=="string"&&typeof s.to_id=="string"&&typeof s.active=="boolean"&&typeof s.created=="string"}u(g,"isValidRosterEdge");function _(s){return r(s)?typeof s.node_id=="string"&&typeof s.name=="string"&&typeof s.kind=="string"&&typeof s.mode=="string"&&typeof s.lifecycle=="string"&&typeof s.status=="string"&&typeof s.cwd=="string"&&typeof s.created=="string":!1}u(_,"isValidNodeRow");class v{static{u(this,"RemoteCanvasSource")}previewEndpoint;relayToken;exec;nodeCache=new Map;rosterCache=new Map;topologyCache=null;viewCache=new Map;constructor(e,t){this.previewEndpoint=e,this.relayToken=t,this.exec=h(e,t)}async execJson(e){let t;try{t=await this.exec("crtr",["--json",...e])}catch{return null}if(!t.ok||t.exitCode!==void 0&&t.exitCode!==0)return null;try{return JSON.parse(t.stdout.trim())}catch{return null}}async fetchShow(e){const t=this.nodeCache.get(e);if(t&&Date.now()-t.at<d)return t.value;const o=await this.execJson(["node","inspect","show",e]),n=w(o)?{...o,fault:o.fault??null,reports:o.reports.filter(p),managers:o.managers.filter(p)}:null;return this.nodeCache.set(e,{value:n,at:Date.now()}),n}topology(){if(this.topologyCache!==null&&Date.now()-this.topologyCache.at<d)return this.topologyCache.value;const e=this.loadTopology();return this.topologyCache={value:e,at:Date.now()},e}async loadTopology(){const e=await this.exec("crtr",["--json","canvas","roster"]);if(!e.ok||e.exitCode!==void 0&&e.exitCode!==0)throw new Error("remote canvas topology is unavailable");let t;try{t=JSON.parse(e.stdout.trim())}catch{throw new Error("remote canvas topology is invalid")}if(!r(t)||!Array.isArray(t.edges)||!t.edges.every(g))throw new Error("remote canvas topology is invalid");const o=t.edges,n={subscriptions:new Map,subscribers:new Map};for(const i of o){const a={node_id:i.to_id,active:i.active,created:i.created},c={node_id:i.from_id,active:i.active,created:i.created},l=n.subscriptions.get(i.from_id);l===void 0?n.subscriptions.set(i.from_id,[a]):l.push(a);const f=n.subscribers.get(i.to_id);f===void 0?n.subscribers.set(i.to_id,[c]):f.push(c)}return n}async rawShow(e){return this.fetchShow(e)}async getNode(e){return(await this.fetchShow(e))?.node??null}async getRow(e){const t=(await this.fetchShow(e))?.node;return t?{node_id:t.node_id,name:t.name,kind:t.kind,mode:t.mode,lifecycle:t.lifecycle,status:t.status,cwd:t.cwd,host_kind:t.host_kind??null,profile_id:t.profile_id??null,scopes:t.scopes??null,isolated:t.isolated===!0,parent:t.parent??null,created:t.created,intent:t.intent??null,waiting_for:t.waiting_for??null,frozen_at:t.frozen_at??null,terminal_reason:t.terminal_reason??null,pi_pid:t.pi_pid??null,pi_pid_identity:t.pi_pid_identity??null,window:t.window??null,tmux_session:t.tmux_session??null,pane:t.pane??null,fault:t.fault??null,streaming:t.streaming===!0}:null}async listNodes(e){const t=JSON.stringify(e?.status??null),o=this.rosterCache.get(t);if(o&&Date.now()-o.at<d)return o.value;const n=["node","inspect","list"];e?.status&&n.push("--status",(Array.isArray(e.status)?e.status:[e.status]).join(","));const i=await this.execJson(n),c=(r(i)&&Array.isArray(i.nodes)?i.nodes:[]).filter(_).map(l=>({...l,isolated:l.isolated===!0}));return this.rosterCache.set(t,{value:c,at:Date.now()}),c}async subscriptionsOf(e){return(await this.topology()).subscriptions.get(e)??[]}async subscribersOf(e){return(await this.topology()).subscribers.get(e)??[]}async view(e){const t=this.viewCache.get(e);if(t&&Date.now()-t.at<d)return t.value;const o=new Set([e]),n=[],i=(await this.subscriptionsOf(e)).map(a=>a.node_id);for(;i.length>0;){const a=i.shift();if(!o.has(a)){o.add(a),n.push(a);for(const c of await this.subscriptionsOf(a))o.has(c.node_id)||i.push(c.node_id)}}return this.viewCache.set(e,{value:n,at:Date.now()}),n}async ticketCountsForNodes(e){if(e.length===0)return{};const t=await this.execJson(["canvas","attention","map","--nodes",e.join(",")]);return r(t)&&r(t.counts)?t.counts:{}}async ticketCountsForView(e){const t=await this.execJson(["canvas","attention","map","--view",e]);return r(t)&&r(t.counts)?t.counts:{}}async hasActiveLiveSubscription(e){const t=(await this.subscriptionsOf(e)).filter(o=>o.active);for(const o of t){const n=await this.getRow(o.node_id);if(n&&(n.status==="active"||n.status==="idle"))return!0}return!1}}export{v as RemoteCanvasSource};

package/dist/core/canvas/remote-transport.d.ts

@@ -0,0 +1,7 @@
+export interface RemoteExecResponse {
+    ok: boolean;
+    exitCode?: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function createRemoteExec(previewEndpoint: string, relayToken: string, timeoutMs?: number): (bin: string, args: string[]) => Promise<RemoteExecResponse>;

package/dist/core/canvas/remote-transport.js

@@ -0,0 +1 @@
+var d=Object.defineProperty;var s=(r,e)=>d(r,"name",{value:e,configurable:!0});const k=5e3;function x(r,e,n=5e3){const a=/^[\x20-\x7e]+$/.test(e);return s(async function(c,i){if(!a)return{ok:!1,stdout:"",stderr:"remote source: invalid stored relay token"};const u={kind:"exec",bin:c,args:i},o=new AbortController,l=setTimeout(()=>o.abort(),n);let t;try{t=await fetch(new URL("/__crtr/source",r),{method:"POST",headers:{"content-type":"application/json",authorization:`Bearer ${e}`},body:JSON.stringify(u),signal:o.signal})}catch{return o.signal.aborted?{ok:!1,stdout:"",stderr:`remote source: timeout after ${n}ms`}:{ok:!1,stdout:"",stderr:"remote source: network error"}}finally{clearTimeout(l)}return t.ok?await t.json():{ok:!1,stdout:"",stderr:`remote source: HTTP ${t.status} ${t.statusText}`}},"exec")}s(x,"createRemoteExec");export{x as createRemoteExec};

package/dist/core/canvas/render-source.d.ts

@@ -0,0 +1,193 @@
+import type { CanvasSource } from './source.js';
+import { type NodeRecap } from './node-recap.js';
+import type { Fault } from '../runtime/fault.js';
+import type { NodeStatus, Lifecycle, NodeRow, TerminalReason } from './types.js';
+/** Format a token count as `Nk` (rounded down to nearest 1 k). */
+export declare function fmtCtx(tokensIn: number | undefined): string;
+export declare function renderTreeFromSource(source: CanvasSource, rootId: string, snapshot?: readonly NodeRow[], ticketSnapshot?: Record<string, number>, ticketUnavailable?: string): Promise<string>;
+export declare function renderForestFromSource(source: CanvasSource, snapshot?: readonly NodeRow[], ticketSnapshot?: Record<string, number>, ticketUnavailable?: string): Promise<string>;
+export interface DashboardRow {
+    node_id: string;
+    /** Full display label: explicit handle plus generated description. */
+    name: string;
+    /** Explicit node handle, kept separate so search does not treat generated text
+     *  as part of the higher-weight name field. */
+    handle?: string;
+    /** Generated first-task description. Searchable below user-authored prompts. */
+    description?: string;
+    status: NodeStatus;
+    frozen_at?: string | null;
+    terminal_reason?: TerminalReason | null;
+    kind: string;
+    mode: string;
+    ctx_tokens: number;
+    asks: number;
+    /** The dir the node is pinned to (its cwd). Drives the browser's cwd-scope
+     *  filter + the All-dirs basename cue. */
+    cwd: string;
+    /** The stable profile identity the node runs under. Drives canvas browse's
+     *  default profile filter; null only for historical no-profile nodes. */
+    profile_id?: string | null;
+    /** ISO 8601 birth timestamp — drives the recency sort + the relative-age cue. */
+    created: string;
+    /** terminal = one-shot worker (finalizes on push --final); resident = persistent
+     *  agent you come back to. Drives the browser's resident-only lifecycle filter.
+     *  Only populated by dashboardRowsAll (the browser snapshot). */
+    lifecycle?: Lifecycle;
+    /** True when the node pushed a final report. With `lifecycle` this separates
+     *  work that FINISHED from a resident agent that merely stopped, which the
+     *  status alone cannot (see `isFinishedWork` in node-order.ts). Only populated
+     *  by dashboardRowsAll (the browser snapshot). */
+    finalized?: boolean;
+    /** "Most recent activity" sort key — epoch ms from the daemon's telemetry
+     *  projection, falling back to `created` when a node never reported telemetry.
+     *  This is the cheap proxy for last-message recency the attention sort tie-breaks
+     *  on. Always set by dashboardRowsAll; optional only so synthetic test rows + the
+     *  scoped dashboardRows can omit it. */
+    mtimeMs?: number;
+    /** The node's spawn prompt (context/initial-prompt.md), trimmed + capped. Populated
+     *  LAZILY by loadPreview (selected-row preview) — NOT on the cheap boot path.
+     *  Indexed by super-search and shown in the preview panel when there is no query. */
+    goal?: string;
+    /** The user prompts from the session's opening and closing 64 KB, joined + capped.
+     *  Populated LAZILY by loadSearchText once a search opens; undefined for
+     *  never-revived nodes (no session file). Powers super-search + the windowed
+     *  preview snippet under a query. */
+    prompts?: string;
+    /** The node's LAST assistant message (text only), trimmed + capped. Populated LAZILY
+     *  by loadPreview (the same tail read as `transcript`); undefined for a node whose
+     *  session has no assistant reply yet. Shown in the preview's reply block. */
+    lastAssistant?: string;
+    /** The node's last persisted Goal/State briefing (`job/recap.json`, written by the
+     *  broker's recap extension). Populated LAZILY by loadPreview; undefined for a node
+     *  that never generated one. The preview's fastest "what is this / where is it" line. */
+    recap?: NodeRecap;
+    /** The newest report the node pushed (`reports/<ts>-<id>-<kind>.md`). Populated
+     *  LAZILY by loadPreview; undefined when the node has pushed nothing. Residents push
+     *  updates as they work, so this is the last thing the node deliberately DELIVERED —
+     *  usually crisper than its last assistant message. */
+    report?: NodeReportPreview;
+    /** True when the node is GENUINELY mid-turn right now — the projected row's
+     *  `streaming` (its live execution has an open turn AND its broker pid is alive),
+     *  not merely an `active`, between-turns node. The live "is it generating?" cue,
+     *  carried for LIVE nodes only (dormant rows are always false). */
+    streaming?: boolean;
+    /** Set when the node is parked on an active fault. The otherwise-invisible
+     *  "stuck, awaiting recovery" window. Mutually exclusive with `streaming`
+     *  (hanging means the turn ended, so no turn is open); when set,
+     *  dashboardRowsAll forces `streaming:false`. The projected row field, already
+     *  overlaid by the owning daemon (stale daemon-owned provider faults whose
+     *  broker pid is gone are suppressed there). */
+    hanging?: Fault | null;
+    /** True when a viewer (focus row) is attached to the node — i.e. someone has it
+     *  open on screen. Set on the cheap boot path from one listFocuses() query. The
+     *  focus registry is local viewer state, so callers pass it separately from the
+     *  canvas source and remote snapshots always suppress it. */
+    viewed?: boolean;
+    /** Lazy-enrichment guard (internal): true once enrichRow/enrichRows has folded in
+     *  the full label (meta), ctx tokens (telemetry), and ⚑ asks. Idempotency marker so
+     *  progressive paint can re-call enrich for a viewport every keystroke for free. */
+    enriched?: boolean;
+    /** Lazy-enrichment guard (internal): true once loadPreview has read goal, recap,
+     *  report and lastAssistant. Idempotency marker for the selected row. */
+    previewLoaded?: boolean;
+    /** Lazy guard (internal): true once loadSearchText has read goal + `prompts`. */
+    promptsLoaded?: boolean;
+    /** The node's conversation as ORDERED user/assistant turns — what the preview panel
+     *  paints as a chat transcript. Populated LAZILY by loadPreview({transcript}) for the SELECTED
+     *  row only (never on the background warm pass): one transcript per row is a few KB,
+     *  and holding one for every node on a multi-thousand-node canvas is what `prompts`
+     *  and `lastAssistant` exist to avoid. Undefined until asked for; an empty array
+     *  means "read, and the node has no session turns". */
+    transcript?: TranscriptTurn[];
+    /** Lazy guard (internal): true once loadPreview({transcript}) has read the session for this row. */
+    transcriptLoaded?: boolean;
+    /** The source `NodeRow` this row was built from (dashboardRowFromNodeRow only).
+     *  Carries every column listNodes already fetched — the runtime fields
+     *  (host_kind/parent/waiting_for/final_report/finalized_at/pi_pid) plus the
+     *  mirrored identity fields (description/cycles) — so the snapshot handler
+     *  reads them here instead of opening meta.json.
+     *  Undefined for rows built by other paths (dashboardRowsFromSource). */
+    srcRow?: NodeRow;
+}
+export declare function readGoalText(contextPath: string): string | undefined;
+/** The newest pushed report, reduced to what a preview panel can use. */
+export interface NodeReportPreview {
+    /** final | update | urgent. */
+    kind: string;
+    /** ISO 8601 push time. */
+    ts: string;
+    /** The report's first markdown heading, or its first non-empty line. */
+    heading: string;
+    /** The body after that heading, whitespace-normalized + capped. */
+    body: string;
+}
+/** The node's newest report document, reduced to a preview. Never throws;
+ *  undefined when the node pushed nothing. */
+export declare function reportPreview(report: {
+    tier: string;
+    created: string;
+    body: string;
+} | null | undefined): NodeReportPreview | undefined;
+export declare function readSessionPrompts(sessionFile: string | null | undefined): Promise<string | undefined>;
+/** One conversation turn as the preview panel paints it. */
+export interface TranscriptTurn {
+    role: 'user' | 'assistant';
+    text: string;
+}
+/** The session's recent end in ONE tail read: the conversation as ordered
+ *  user/assistant turns, newest-last and capped to the last TRANSCRIPT_TURNS, and
+ *  the newest assistant message with text (`lastAssistant`). Generated context cards
+ *  are dropped (runtime scaffolding, not something the user or the agent said) and
+ *  so are tool-only assistant turns, so the result reads as a chat rather than a
+ *  log. The read starts at 256 KB and widens only when that window held no reply —
+ *  a tail that landed inside one giant tool result. Never throws on a missing
+ *  session; empty for a node that was never revived. */
+export interface SessionTail {
+    transcript: TranscriptTurn[];
+    lastAssistant?: string;
+}
+export declare function readSessionTail(sessionFile: string | null | undefined): Promise<SessionTail>;
+/** Did this node's engine ever PRODUCE something — an assistant message with real
+ *  text, a tool call, or non-empty reasoning? The signal that a node did work and
+ *  is not an empty shell. A never-revived node (no session file) is trivially
+ *  false; an assistant turn that is only an empty/aborted `thinking` stub does NOT
+ *  count (that's a node started and killed before it did anything). CONSERVATIVE
+ *  by design: ANY substance keeps the node, so the reap never deletes real work
+ *  — a tool-call-only turn (no final text) still counts. Drives reap-on-close/
+ *  detach. One file read with an early exit on the first substantive turn. */
+export declare function nodeHasAssistantMessage(sessionFile: string | null | undefined): boolean;
+/** "Most recent activity" sort key from the daemon's telemetry projection. It
+ * falls back to `created` when the broker has never reported telemetry. */
+export declare function sessionMtime(created: string, telemetryUpdatedAt: string | null | undefined, remote?: boolean): number;
+/** Build one cheap-boot row from a raw db/source row. `fault`/`streaming` are
+ *  projected row fields, so they hold for a remote row too; `remote` suppresses the
+ *  LOCAL disk reads (telemetry-mtime/viewers) that are meaningless for a truly
+ *  remote canvas. A local row is viewed when either its tmux focus row exists or
+ *  its live broker reports a terminal/web viewer. */
+export declare function dashboardRowFromNodeRow(row: NodeRow, focusedNodeIds: ReadonlySet<string>, remote: boolean): DashboardRow;
+/** One row per node visible in the sub-DAG of `rootId` (including root), read
+ *  entirely through the source — the openDb-free sibling of `dashboardRows`.
+ *  Ticket counts come from ONE `source.ticketCountsForView(rootId)` call (the
+ *  API/remote attention projection), never `countTickets` (openDb). */
+export declare function dashboardRowsFromSource(source: CanvasSource, rootId: string, snapshot?: readonly NodeRow[], ticketSnapshot?: Record<string, number>): Promise<DashboardRow[]>;
+/** CHEAP boot builder over a source — one row per node across the whole canvas,
+ *  fields that need no per-node meta/session read. Local API callers may supply
+ *  the node ids from one `listFocuses()` query so `viewed` remains visible without
+ *  coupling the canvas source to local viewer state. Remote sources ignore that
+ *  set. Local disk telemetry is likewise suppressed remotely. */
+export declare function dashboardRowsAllFromSource(source: CanvasSource, localFocusedNodeIds?: ReadonlySet<string>, liveOnly?: boolean, snapshot?: readonly NodeRow[]): Promise<DashboardRow[]>;
+export declare function enrichRowsFromSource(_source: CanvasSource, rows: DashboardRow[], asks?: Record<string, number>): Promise<void>;
+/** The selected row's preview: goal, recap, newest report and the session's recent
+ *  end (`lastAssistant`), from one small tail read. `transcript: true` also folds the
+ *  ordered chat turns from that same read — ask for it for the SELECTED row only,
+ *  never across the canvas, where one transcript per node is exactly the memory cost
+ *  the capped fields avoid. goal, recap and session are local disk reads, suppressed
+ *  for a remote source (its transcript stays empty). */
+export declare function loadPreviewFromSource(source: CanvasSource, row: DashboardRow, opts?: {
+    transcript?: boolean;
+}): Promise<DashboardRow>;
+/** The text super-search matches: the spawn prompt (`goal`) and the session's user
+ *  prompts (`prompts`). Read for every row once a search opens, so it is only the
+ *  small prompt window — never the preview's recap, report or transcript. Local only. */
+export declare function loadSearchTextFromSource(source: CanvasSource, row: DashboardRow): Promise<DashboardRow>;

package/dist/core/canvas/render-source.js

@@ -0,0 +1,7 @@
+var Y=Object.defineProperty;var u=(t,e)=>Y(t,"name",{value:e,configurable:!0});import{conversationIdFromPath as v,conversationStore as H,ConversationNotFoundError as N,readConversationAsync as J}from"../conversation-store/index.js";import{dirname as U,join as R}from"node:path";import{readFileBeneath as q,readTextBeneathIfExists as K}from"../spaces/open-beneath.js";import{RemoteCanvasSource as y}from"./remote-canvas-source.js";import{fullName as S}from"./labels.js";import{nodeRunDir as Q,nodeRunJobDir as X,contextDir as Z}from"./paths.js";import{readNodeRecap as I}from"./node-recap.js";import{isFrozenRow as T,resolveNodeVisual as w,faultSummary as A}from"./status-glyph.js";import{parseCard as C}from"../../shared/generated-context.js";function P(t){return t===void 0||t===0?"0k":`${Math.floor(t/1e3)}k`}u(P,"fmtCtx");function tt(t,e,i,n,r,s){if(t===void 0)return`${i}${n}? <missing meta: ${e}>`;const c=t.fault??null,a=w(t.status,{hanging:c,frozen:T(t)}).glyph,l=r?"0k":P(t.telemetry_tokens_in??void 0),o=s[e]??0,m=o>0?` \u2691${o}`:"",p=c!==null?` \xB7 ${A(c)}`:"";return`${i}${n}${a} ${S(t)} [${t.kind}/${t.mode}] ctx ${l}${m}${p}`}u(tt,"nodeLineFromSource");async function L(t,e,i,n,r,s,c,a,l){if(s.has(i))return;s.add(i);const o=r?"\u2514\u2500 ":"\u251C\u2500 ";c.push(tt(e.get(i),i,n,o,a,l));const m=n+(r?"   ":"\u2502  ");let p;try{p=await t.subscriptionsOf(i)}catch(d){c.push(`${m}\u26A0 children unavailable: ${d instanceof Error?d.message:String(d)}`);return}for(let d=0;d<p.length;d++){const h=p[d],x=d===p.length-1;if(s.has(h.node_id)){const $=x?"\u2514\u2500 ":"\u251C\u2500 ";c.push(`${m}${$}\u21BA <cycle: ${h.node_id}>`);continue}await L(t,e,h.node_id,m,x,s,c,a,l)}}u(L,"walkTreeFromSource");async function et(t,e,i,n,r){const s=t instanceof y,c=new Map((i??await t.listNodes()).map(f=>[f.node_id,f])),a=c.get(e);if(a===void 0)return`? <missing node: ${e}>`;let l=n,o=r??null;if(l===void 0)try{l=await t.ticketCountsForView(e)}catch(f){l={},o=f instanceof Error?f.message:String(f)}const m=s?"0k":P(a.telemetry_tokens_in??void 0),p=l[e]??0,d=p>0?` \u2691${p}`:"",h=a.fault??null,x=w(a.status,{hanging:h,frozen:T(a)}).glyph,$=h!==null?` \xB7 ${A(h)}`:"",g=[];g.push(`${x} ${S(a)} [${a.kind}/${a.mode}] ctx ${m}${d}${$}`);const V=new Set([e]);let _;try{_=await t.subscriptionsOf(e)}catch(f){g.push(`\u26A0 children unavailable: ${f instanceof Error?f.message:String(f)}`),_=[]}for(let f=0;f<_.length;f++){const G=_[f],W=f===_.length-1;await L(t,c,G.node_id,"",W,V,g,s,l)}return o!==null&&g.push(`Tickets: unavailable (${o}).`),g.join(`
+`)}u(et,"renderTreeFromSource");async function bt(t,e,i,n){const r=e??await t.listNodes();if(r.length===0)return"(canvas is empty)";const s=r.filter(a=>a.parent===null&&(a.status==="active"||a.status==="idle"));if(s.length===0)return"(no live roots)";const c=[];for(const a of s)c.push(await et(t,a.node_id,r,i,n));return c.join(`
+
+`)}u(bt,"renderForestFromSource");const E=4096;function O(t){try{const e=K(U(t),R(t,"initial-prompt.md"))?.trim()??"";return e===""?void 0:e.length>E?e.slice(0,E):e}catch{return}}u(O,"readGoalText");const F=1024;function nt(t){if(t==null)return;const e=t.tier,i=t.created,n=t.body,r=n.split(`
+`);let s="",c=n;for(let l=0;l<r.length;l++){const o=(r[l]??"").trim();if(o!==""){s=o.startsWith("#")?o.replace(/^#+\s*/,"").trim():o,c=r.slice(l+1).join(`
+`);break}}const a=c.replace(/\s+/g," ").trim();return{kind:e,ts:i,heading:s,body:a.length>F?a.slice(0,F):a}}u(nt,"reportPreview");const it=[262144,1<<20,4<<20],rt=65536,st=65536;async function M(t,e,i){if(t==null||t==="")return null;const n=v(t);if(n===null)return null;try{const{entries:r,tail:s}=await J(n,{head:e,tail:i});return{head:r,tail:s??r,windowed:s!==void 0}}catch(r){if(r instanceof N)return null;throw r}}u(M,"readSessionWindow");const b=8192,k=2048;async function at(t){const e=await M(t,rt,st);if(e===null)return;const i=[];let n=0;for(const s of e.windowed?[...e.head,...e.tail]:e.head){if(s.type!=="message"||s.message.role!=="user")continue;const c=D(s.message.content);if(c===""||C({role:"user",content:c})!==null)continue;const a=c.length>k?c.slice(0,k):c;if(i.push(a),n+=a.length+1,n>=b)break}if(i.length===0)return;const r=i.join(`
+`);return r.length>b?r.slice(0,b):r}u(at,"readSessionPrompts");const j=120,z=4096;async function ot(t){let e={transcript:[]};for(const i of it){const n=await M(t,0,i);if(n===null||(e=ct(n.tail),!n.windowed||e.lastAssistant!==void 0))return e}return e}u(ot,"readSessionTail");function ct(t){const e=[];let i;for(const n of t){if(n.type!=="message")continue;const r=n.message.role;if(r!=="user"&&r!=="assistant")continue;const s=D(n.message.content);s!==""&&(r==="assistant"&&(i=s.length>k?s.slice(0,k):s),C({role:r,content:s})===null&&e.push({role:r,text:s.length>z?s.slice(0,z):s}))}return{transcript:e.length>j?e.slice(e.length-j):e,...i===void 0?{}:{lastAssistant:i}}}u(ct,"sessionTailFrom");function vt(t){if(t==null||t==="")return!1;const e=v(t);if(e===null)return!1;let i;try{i=H().read(e).entries}catch(n){if(n instanceof N)return!1;throw n}for(const n of i)if(!(n.type!=="message"||n.message.role!=="assistant")&&ut(n.message.content))return!0;return!1}u(vt,"nodeHasAssistantMessage");function ut(t){if(typeof t=="string")return t.trim()!=="";if(!Array.isArray(t))return!1;for(const e of t){if(e===null||typeof e!="object")continue;const i=e,n=(i.type??"").toLowerCase();if(n==="text"){if(typeof i.text=="string"&&i.text.trim()!=="")return!0}else if(n==="thinking"){if(typeof i.thinking=="string"&&i.thinking.trim()!=="")return!0}else return!0}return!1}u(ut,"assistantContentIsSubstantive");function D(t){if(typeof t=="string")return t.trim();if(!Array.isArray(t))return"";const e=[];for(const i of t)if(i!==null&&typeof i=="object"){const n=i;n.type==="text"&&typeof n.text=="string"&&e.push(n.text)}return e.join(" ").trim()}u(D,"extractUserText");function lt(t,e,i=!1){if(!i&&e!==null&&e!==void 0){const r=Date.parse(e);if(!Number.isNaN(r))return r}const n=Date.parse(t);return Number.isNaN(n)?0:n}u(lt,"sessionMtime");function ft(t){if(t.status!=="active")return!1;try{const e=JSON.parse(q(Q(t.node_id),R(X(t.node_id),"attach.json")).toString("utf8"));return typeof e.viewers=="number"&&e.viewers>0}catch{return!1}}u(ft,"hasLiveBrokerViewer");function dt(t,e,i){const n=t.status==="active"||t.status==="idle",r=t.fault??null;return{node_id:t.node_id,name:S(t),handle:t.name,description:t.description,status:t.status,frozen_at:t.frozen_at??null,terminal_reason:t.terminal_reason??null,kind:t.kind,mode:t.mode,ctx_tokens:i?0:t.telemetry_tokens_in??0,asks:0,cwd:t.cwd,profile_id:t.profile_id,created:t.created,lifecycle:t.lifecycle,finalized:t.final_report!=null,mtimeMs:lt(t.created,t.telemetry_updated_at,i),streaming:r===null&&n&&t.streaming===!0,hanging:r,viewed:i?!1:e.has(t.node_id)||ft(t),srcRow:t}}u(dt,"dashboardRowFromNodeRow");async function Nt(t,e,i,n){const r=t instanceof y,s=n??await t.ticketCountsForView(e).catch(()=>({})),c=new Map((i??await t.listNodes()).map(l=>[l.node_id,l]));return[e,...await t.view(e)].flatMap(l=>{const o=c.get(l);return o===void 0?[]:[{node_id:l,name:S(o),handle:o.name,description:o.description,status:o.status,frozen_at:o.frozen_at??null,terminal_reason:o.terminal_reason??null,kind:o.kind,mode:o.mode,ctx_tokens:r?0:o.telemetry_tokens_in??0,asks:s[l]??0,cwd:o.cwd,profile_id:o.profile_id,created:o.created}]})}u(Nt,"dashboardRowsFromSource");async function Rt(t,e=new Set,i=!1,n){const r=t instanceof y,s=r?new Set:e;return(n??await t.listNodes(i?{status:["active","idle"]}:void 0)).map(a=>dt(a,s,r))}u(Rt,"dashboardRowsAllFromSource");async function Tt(t,e,i){const n=e.filter(s=>s.enriched!==!0);if(n.length===0)return;const r=i??{};for(const s of n)s.asks=r[s.node_id]??0,s.enriched=!0}u(Tt,"enrichRowsFromSource");async function B(t,e,i){const n=i?.paths;if(n!==void 0)return n.context_dir;const r=e.srcRow?.grantee??(await t.getRow(e.node_id))?.grantee;if(!r)throw new Error(`node ${e.node_id} has no app assignment`);return Z(e.node_id,r)}u(B,"contextPathOf");async function wt(t,e,i={}){const n=i.transcript===!0&&e.transcriptLoaded!==!0;if(e.previewLoaded===!0&&!n)return e;if(t instanceof y)return e.previewLoaded=!0,n&&(e.transcript=[],e.transcriptLoaded=!0),e;const r=await t.getNode(e.node_id),s=await ot(r?.pi_session_file);return e.previewLoaded!==!0&&(e.goal??=O(await B(t,e,r)),e.lastAssistant=s.lastAssistant,e.recap=I(e.node_id),e.report=nt(await t.newestReport?.(e.node_id).catch(()=>null)),e.previewLoaded=!0),n&&(e.transcript=s.transcript,e.transcriptLoaded=!0),e}u(wt,"loadPreviewFromSource");async function At(t,e){if(e.promptsLoaded===!0)return e;if(!(t instanceof y)){const i=await t.getNode(e.node_id);e.goal??=O(await B(t,e,i)),e.prompts=await at(i?.pi_session_file)}return e.promptsLoaded=!0,e}u(At,"loadSearchTextFromSource");export{dt as dashboardRowFromNodeRow,Rt as dashboardRowsAllFromSource,Nt as dashboardRowsFromSource,Tt as enrichRowsFromSource,P as fmtCtx,wt as loadPreviewFromSource,At as loadSearchTextFromSource,vt as nodeHasAssistantMessage,O as readGoalText,at as readSessionPrompts,ot as readSessionTail,bt as renderForestFromSource,et as renderTreeFromSource,nt as reportPreview,lt as sessionMtime};

package/dist/core/canvas/sessions.d.ts

@@ -0,0 +1,57 @@
+import { type ConversationStore } from '../conversation-store/index.js';
+export interface SessionBinding {
+    bindingId: string;
+    sessionId: string | null;
+    nodeId: string;
+    transcriptPath: string | null;
+    sourceSessionId: string | null;
+    forkEntryId: string | null;
+    createdAt: string;
+    boundAt: string;
+    unboundAt: string | null;
+}
+export declare function readLiveSession(nodeId: string): SessionBinding | null;
+export declare function findNodeBySessionFileSql(path: string): string | null;
+export declare function bindSession(nodeId: string, input: {
+    executionId: string;
+    sessionId: string | null;
+    transcriptPath: string | null;
+    sourceSessionId?: string | null;
+}): 'bound' | 'shutdown';
+export declare function resetSession(nodeId: string, input: {
+    sessionId: string;
+    transcriptPath: string | null;
+}): void;
+export declare function transferSession(input: {
+    fromNodeId: string;
+    fromBindingId: string;
+    toNodeId: string;
+    executionId: string;
+    sessionId: string | null;
+    transcriptPath: string | null;
+}): 'transferred' | 'shutdown' | 'changed';
+export declare function unbindSession(nodeId: string): void;
+/** Rewrite the header `cwd` of every transcript this node owns from `oldCwd` to `newCwd`, keeping
+ *  the sessions bound. Pi opens a transcript with its header cwd and a resume is vetoed once that
+ *  directory is gone, so a same-directory relocation must move the header too. Each file is replaced
+ *  atomically (temp + fsync + rename) and a run node's indexed `event_offset` shifts by the byte
+ *  delta, in one canvas write that also serializes against `appendSection`. Returns files rewritten. */
+export declare function relocateSessionCwd(nodeId: string, oldCwd: string, newCwd: string): number;
+export declare function setCyclePending(nodeId: string, pending: boolean): void;
+export declare function conversationOwner(conversationId: string): string | null;
+/** Map only the indexed conversation paths; repair each file on first use. */
+export declare function openCanvasConversationStore(root: string): ConversationStore & {
+    recover(rows: Array<{
+        session_id: string;
+        node_id: string;
+        transcript_path: string | null;
+    }>): void;
+    repair(id: string): void;
+};
+export declare function repairRunConversations(runId: string): void;
+/** Open the canvas conversation store from the user `store` settings, install it in this
+ *  process, and serve it for brokers. Unset settings use pi's sessions dir and
+ *  `<CRTR_HOME>/store.sock`. */
+export declare function serveCanvasConversationStore(): Promise<{
+    close(): Promise<void>;
+}>;

package/dist/core/canvas/sessions.js

@@ -0,0 +1,4 @@
+var C=Object.defineProperty;var _=(n,e)=>C(n,"name",{value:e,configurable:!0});import{prepared as o}from"../sqlite-statements.js";import{randomUUID as R}from"node:crypto";import{closeSync as D,existsSync as I,fsyncSync as U,openSync as O,readFileSync as A,readSync as W,renameSync as H,statSync as M,truncateSync as b,unlinkSync as h,writeFileSync as x}from"node:fs";import{openDb as c,withCanvasWrite as p}from"./db.js";import{canonicalSessionFile as g}from"./canvas.js";import{join as m}from"node:path";import{readConfig as F}from"../config.js";import{appSpace as P,socketDir as B}from"../layout.js";import{createFileStore as $,conversationStore as k,defaultConversationRoot as J,installConversationStore as w}from"../conversation-store/index.js";import{listenConversationStore as j}from"../conversation-store/listener.js";import{appendConversationEvents as y}from"../../daemon/runs/append-section.js";function L(){return new Date().toISOString()}_(L,"now");function v(n,e,s){return o(n,"SELECT 1 FROM executions WHERE execution_id = ? AND node_id = ? AND state != 'exited'").get(s,e)!==void 0}_(v,"liveExecution");function Y(n){return{bindingId:n.binding_id,sessionId:n.session_id??null,nodeId:n.node_id,transcriptPath:n.transcript_path??null,sourceSessionId:n.source_session_id??null,forkEntryId:n.fork_entry_id??null,createdAt:n.created_at,boundAt:n.bound_at,unboundAt:n.unbound_at??null}}_(Y,"hydrate");function _n(n){const e=o(c(),"SELECT * FROM sessions WHERE node_id = ? AND unbound_at IS NULL").get(n);return e===void 0?null:Y(e)}_(_n,"readLiveSession");function an(n){return o(c(),"SELECT node_id FROM sessions WHERE transcript_path = ? AND unbound_at IS NULL").get(g(n))?.node_id??null}_(an,"findNodeBySessionFileSql");function cn(n,e){return p(s=>{if(!v(s,n,e.executionId))return"shutdown";const i=L(),r=e.transcriptPath===null?null:g(e.transcriptPath),d=o(s,"SELECT binding_id, session_id FROM sessions WHERE node_id = ? AND unbound_at IS NULL").get(n);if(d!==void 0&&d.session_id===e.sessionId)o(s,"UPDATE sessions SET transcript_path = ?, source_session_id = ?, bound_at = ? WHERE binding_id = ?").run(r,e.sourceSessionId??null,i,d.binding_id);else{d!==void 0&&o(s,"UPDATE sessions SET unbound_at = ? WHERE binding_id = ?").run(i,d.binding_id);const t=e.sessionId===null?void 0:o(s,"SELECT binding_id FROM sessions WHERE node_id = ? AND session_id = ? ORDER BY created_at DESC LIMIT 1").get(n,e.sessionId);t?o(s,"UPDATE sessions SET transcript_path = ?, source_session_id = ?, bound_at = ?, unbound_at = NULL WHERE binding_id = ?").run(r,e.sourceSessionId??null,i,t.binding_id):o(s,"INSERT INTO sessions (binding_id, session_id, node_id, transcript_path, source_session_id, fork_entry_id, created_at, bound_at) VALUES (?, ?, ?, ?, ?, NULL, ?, ?)").run(R(),e.sessionId,n,r,e.sourceSessionId??null,i,i)}return o(s,"UPDATE nodes SET cycle_pending = 0 WHERE node_id = ?").run(n),"bound"})}_(cn,"bindSession");function un(n,e){p(s=>{const i=L();o(s,"UPDATE sessions SET unbound_at = ? WHERE node_id = ? AND unbound_at IS NULL").run(i,n),o(s,"INSERT INTO sessions (binding_id, session_id, node_id, transcript_path, source_session_id, fork_entry_id, created_at, bound_at) VALUES (?, ?, ?, ?, NULL, NULL, ?, ?)").run(R(),e.sessionId,n,e.transcriptPath===null?null:g(e.transcriptPath),i,i),o(s,"UPDATE nodes SET cycle_pending = 0 WHERE node_id = ?").run(n)})}_(un,"resetSession");function En(n){return p(e=>{if(!v(e,n.toNodeId,n.executionId))return"shutdown";if(o(e,"SELECT binding_id FROM sessions WHERE node_id = ? AND binding_id = ? AND unbound_at IS NULL").get(n.fromNodeId,n.fromBindingId)===void 0)return"changed";if(o(e,"SELECT run_id FROM nodes WHERE node_id IN (?, ?) AND run_id IS NOT NULL LIMIT 1").get(n.fromNodeId,n.toNodeId))throw new Error("run conversation transfer is not supported");const r=L();return o(e,"UPDATE sessions SET unbound_at = ? WHERE binding_id = ?").run(r,n.fromBindingId),o(e,"UPDATE sessions SET unbound_at = ? WHERE node_id = ? AND unbound_at IS NULL").run(r,n.toNodeId),o(e,"INSERT INTO sessions (binding_id, session_id, node_id, transcript_path, source_session_id, fork_entry_id, created_at, bound_at) VALUES (?, ?, ?, ?, NULL, NULL, ?, ?)").run(R(),n.sessionId,n.toNodeId,n.transcriptPath===null?null:g(n.transcriptPath),r,r),o(e,"UPDATE nodes SET cycle_pending = 0 WHERE node_id = ?").run(n.toNodeId),"transferred"})}_(En,"transferSession");function fn(n){o(c(),"UPDATE sessions SET unbound_at = ? WHERE node_id = ? AND unbound_at IS NULL").run(L(),n)}_(fn,"unbindSession");function ln(n,e,s){return p(i=>{const r=o(i,"SELECT binding_id, transcript_path FROM sessions WHERE node_id = ? AND transcript_path IS NOT NULL").all(n),d=[];try{for(const t of r){if(!I(t.transcript_path))continue;const u=A(t.transcript_path),S=u.indexOf(10);if(S<0)continue;let E;try{E=JSON.parse(u.subarray(0,S).toString("utf8"))}catch{continue}if(E.type!=="session"||E.cwd!==e)continue;const f=Buffer.concat([Buffer.from(JSON.stringify({...E,cwd:s}),"utf8"),u.subarray(S)]),a=`${t.transcript_path}.${R()}.tmp`;d.push({binding_id:t.binding_id,path:t.transcript_path,temp:a,delta:f.length-u.length}),x(a,f,{flag:"wx",mode:384});const l=O(a,"r");try{U(l)}finally{D(l)}}for(const t of d)t.delta!==0&&o(i,"UPDATE sessions SET event_offset = event_offset + ? WHERE binding_id = ? AND event_offset IS NOT NULL AND event_offset > 0").run(t.delta,t.binding_id);for(const t of d)H(t.temp,t.path)}finally{for(const t of d)I(t.temp)&&h(t.temp)}return d.length})}_(ln,"relocateSessionCwd");function Sn(n,e){o(c(),"UPDATE nodes SET cycle_pending = ? WHERE node_id = ?").run(e?1:0,n)}_(Sn,"setCyclePending");const N="unbound_at IS NULL DESC, created_at DESC, rowid DESC";function pn(n){return o(c(),`SELECT node_id FROM sessions WHERE session_id = ? ORDER BY ${N} LIMIT 1`).get(n)?.node_id??null}_(pn,"conversationOwner");const V={appendSection:_((n,e,s)=>{const i=e.kind==="create"?e:void 0;i&&p(r=>{if(!o(r,"SELECT node_id FROM nodes WHERE node_id = ?").get(i.nodeId))throw new Error(`missing conversation owner ${i.nodeId}`);const t=L();o(r,"INSERT INTO sessions (binding_id, session_id, node_id, transcript_path, source_session_id, fork_entry_id, created_at, bound_at, unbound_at, event_offset) VALUES (?, ?, ?, ?, ?, NULL, ?, ?, ?, 0)").run(R(),n,i.nodeId,i.path,i.sourceId??null,t,t,t)}),p(r=>{const d=o(r,`SELECT node_id, binding_id, input_ids_json FROM sessions WHERE session_id = ? ORDER BY ${N} LIMIT 1`).get(n),t=i?i.nodeId:d?.node_id;if(!t)throw new Error(`conversation ${n} has no active owner`);const u=o(r,"SELECT run_id FROM nodes WHERE node_id = ?").get(t);if(!u)throw new Error(`cannot write conversation ${n}: missing node ${t}`);if(e.kind==="replace"&&u.run_id!==null)throw new Error(`run conversation ${n} is append-only; replace refused`);const S=d.binding_id,E=s();if(u.run_id!==null&&e.kind!=="replace"){const f=i?.sourceId?[]:e.entries,a=y(r,u.run_id,t,f,JSON.parse(d?.input_ids_json??"[]"));o(r,"UPDATE sessions SET event_offset = ?, indexed_entry_id = ?, input_ids_json = ? WHERE binding_id = ?").run(E,f.at(-1)?.id??null,JSON.stringify(a),S)}})},"appendSection"),abortCreate(n){o(c(),"DELETE FROM sessions WHERE session_id = ? AND event_offset = 0").run(n)},delete(n){o(c(),"DELETE FROM sessions WHERE session_id = ?").run(n)},pathFor(n){return o(c(),`SELECT transcript_path FROM sessions WHERE session_id = ? ORDER BY ${N} LIMIT 1`).get(n)?.transcript_path??void 0},createPath(n,e){const s=o(c(),"SELECT grantee FROM node_rows WHERE node_id = ?").get(n);if(!s)throw new Error(`missing conversation owner ${n}`);return m(P(s.grantee).conversations,n,`${e.timestamp.replace(/[:.]/g,"-")}_${e.id}.jsonl`)},repair(n,e){z(n,e)},owners(){const n=new Map,e=o(c(),`SELECT session_id, node_id FROM sessions WHERE session_id IS NOT NULL ORDER BY session_id, ${N}`).all();for(const s of e)n.has(s.session_id)||n.set(s.session_id,s.node_id);return n}};function z(n,e){const s=o(c(),`SELECT s.binding_id, s.node_id, s.event_offset, s.input_ids_json, s.source_session_id, n.run_id
+    FROM sessions s JOIN nodes n ON n.node_id = s.node_id WHERE s.session_id = ? ORDER BY s.unbound_at IS NULL DESC, s.created_at DESC, s.rowid DESC LIMIT 1`).get(n);if(!s?.run_id||s.event_offset===null)return;if(s.event_offset===0&&!I(e)){o(c(),"DELETE FROM sessions WHERE binding_id = ?").run(s.binding_id);return}const i=M(e).size;if(i<s.event_offset)throw new Error(`conversation shorter than indexed offset: ${n}`);if(i===s.event_offset)return;const r=O(e,"r"),d=[];try{const a=Buffer.allocUnsafe(65536);for(let l=s.event_offset;l<i;){const T=W(r,a,0,Math.min(a.length,i-l),l);if(!T)throw new Error(`conversation read ended early: ${n}`);d.push(Buffer.from(a.subarray(0,T))),l+=T}}finally{D(r)}const t=Buffer.concat(d).toString("utf8"),u=t.lastIndexOf(`
+`);if(u<0){s.event_offset===0?(h(e),o(c(),"DELETE FROM sessions WHERE binding_id = ?").run(s.binding_id)):b(e,s.event_offset);return}const S=t.slice(0,u+1),E=S.split(`
+`).filter(Boolean).map(a=>JSON.parse(a)).filter(a=>a.type!=="session"),f=s.event_offset+Buffer.byteLength(S);f<i&&b(e,f),p(a=>{const l=s.source_session_id?[]:y(a,s.run_id,s.node_id,E,JSON.parse(s.input_ids_json));o(a,"UPDATE sessions SET event_offset = ?, indexed_entry_id = ?, input_ids_json = ? WHERE binding_id = ?").run(f,E.at(-1)?.id??null,JSON.stringify(l),s.binding_id)})}_(z,"repairConversationTail");function q(n){return $(n,V)}_(q,"openCanvasConversationStore");function Rn(n){const e=o(c(),"SELECT DISTINCT s.session_id FROM sessions s JOIN nodes n ON n.node_id = s.node_id WHERE n.run_id = ? AND s.session_id IS NOT NULL").all(n),s=k();for(const i of e)s.repair?.(i.session_id)}_(Rn,"repairRunConversations");async function Ln(){const n=F("user").store,e=n?.address??m(B(),"store.sock"),s=q(n?.root??J());w(s),process.env.CRTR_STORE_ADDRESS=e;const i=await j(e,s);return{async close(){await i.close(),w(void 0)}}}_(Ln,"serveCanvasConversationStore");export{cn as bindSession,pn as conversationOwner,an as findNodeBySessionFileSql,q as openCanvasConversationStore,_n as readLiveSession,ln as relocateSessionCwd,Rn as repairRunConversations,un as resetSession,Ln as serveCanvasConversationStore,Sn as setCyclePending,En as transferSession,fn as unbindSession};

package/dist/core/canvas/source.d.ts

@@ -0,0 +1,48 @@
+import type { NodeMeta, NodeRow, NodeStatus, SubscriptionRef } from './types.js';
+import type { Scope } from '../../types.js';
+import type { RosterDTO } from '../../api/dto/canvas.js';
+export interface CanvasSource {
+    getNode(nodeId: string): Promise<NodeMeta | null>;
+    getRow(nodeId: string): Promise<NodeRow | null>;
+    listNodes(filter?: {
+        status?: NodeStatus | NodeStatus[];
+    }): Promise<NodeRow[]>;
+    /** Optional one-request browse projection. Other listNodes callers keep their full rows. */
+    browseSnapshot?(): Promise<NodeRow[]>;
+    /** One topology snapshot for the attach relationship panel. */
+    panelRoster?(): Promise<RosterDTO>;
+    subscriptionsOf(subscriber: string): Promise<SubscriptionRef[]>;
+    subscribersOf(publisher: string): Promise<SubscriptionRef[]>;
+    view(root: string): Promise<string[]>;
+    ticketCountsForNodes(nodeIds: readonly string[]): Promise<Record<string, number>>;
+    ticketCountsForView(root: string): Promise<Record<string, number>>;
+    hasActiveLiveSubscription(nodeId: string): Promise<boolean>;
+    /** The node's newest report document, or null. Only a source that reads through `/v1` offers it. */
+    newestReport?(nodeId: string): Promise<{
+        tier: string;
+        created: string;
+        body: string;
+    } | null>;
+}
+export declare class LocalCanvasSource implements CanvasSource {
+    getNode(nodeId: string): Promise<NodeMeta | null>;
+    getRow(nodeId: string): Promise<NodeRow | null>;
+    listNodes(filter?: {
+        status?: NodeStatus | NodeStatus[];
+    }): Promise<NodeRow[]>;
+    subscriptionsOf(subscriber: string): Promise<SubscriptionRef[]>;
+    subscribersOf(publisher: string): Promise<SubscriptionRef[]>;
+    view(root: string): Promise<string[]>;
+    ticketCountsForNodes(nodeIds: readonly string[]): Promise<Record<string, number>>;
+    ticketCountsForView(root: string): Promise<Record<string, number>>;
+    hasActiveLiveSubscription(nodeId: string): Promise<boolean>;
+}
+export declare const localCanvasSource: CanvasSource;
+/** The active read source for a command: an explicit `--canvas <name>` wins,
+ *  else the durable `crtr canvas use` selection (`ScopeState.activeCanvas`),
+ *  else local — byte-for-byte the same `localCanvasSource` singleton so a
+ *  caller with neither set sees zero behavior change. */
+export declare function resolveCanvasSource(opts?: {
+    canvasName?: string;
+    scope?: Scope;
+}, sandboxed?: boolean): CanvasSource;

package/dist/core/canvas/source.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var s=(r,e)=>u(r,"name",{value:e,configurable:!0});import{getNode as m,getRow as v,listNodes as p,subscriptionsOf as d,subscribersOf as f,view as o,hasActiveLiveSubscription as l}from"./canvas.js";import{ticketCountsForNodes as w}from"./attention.js";import{readState as y}from"../config.js";import{resolveRemoteCanvasTarget as C}from"../remote-canvas-target.js";import{RemoteCanvasSource as N}from"./remote-canvas-source.js";import{isSandboxedNode as b}from"../../shared/env.js";import{ownerOnly as h}from"../errors.js";class S{static{s(this,"LocalCanvasSource")}async getNode(e){return m(e)}async getRow(e){return v(e)}async listNodes(e){return p(e)}async subscriptionsOf(e){return d(e)}async subscribersOf(e){return f(e)}async view(e){return o(e)}async ticketCountsForNodes(e){return w([...e])}async ticketCountsForView(e){return this.ticketCountsForNodes([e,...o(e)])}async hasActiveLiveSubscription(e){return l(e)}}const a=new S;function T(r,e=b()){const n=r?.scope??"user";if(e){if(r?.canvasName!==void 0)throw h("--canvas selects the person's remote canvas targets, which an app's node cannot reach","Omit --canvas; this node reads its own runtime's canvas.");return a}const t=r?.canvasName??y(n).activeCanvas??null;if(!t)return a;const{previewEndpoint:c,relayToken:i}=C(t,n);return new N(c,i)}s(T,"resolveCanvasSource");export{S as LocalCanvasSource,a as localCanvasSource,T as resolveCanvasSource};

package/dist/core/canvas/status-glyph.d.ts

@@ -0,0 +1,52 @@
+import type { NodeStatus } from './types.js';
+import { type Fault, type FaultKind } from '../runtime/fault.js';
+export declare const STATUS_GLYPH: Record<NodeStatus, string>;
+export declare const STATUS_COLOR: Record<NodeStatus, string>;
+export declare const HANGING_GLYPH = "\u26A0";
+export declare const HANGING_COLOR = "33";
+/** Short label for the fault kind. The overlay keeps one glyph and lets the
+ *  label carry the distinction. */
+export declare function hangingLabel(kind: FaultKind): string;
+export interface NodeVisual {
+    glyph: string;
+    /** SGR fg parameters, e.g. '32' or '38;5;243' — interpolate as `\x1b[${color}m`. */
+    color: string;
+    /** Overlay word (hanging kind label / 'live'); undefined for a plain status
+     *  (the caller supplies its own status word). */
+    word?: string;
+    bold?: boolean;
+}
+/** Whether a row is frozen: the broker ledger marked it waiting for a slot and
+ *  no process holds it. Both halves matter — a launch clears `frozen_at`, so a
+ *  mark sitting beside a live pid is stale rather than frozen. A projection
+ *  that carries no pid at all (the dashboard row) reads on the mark alone. */
+export declare function isFrozenRow(row: {
+    frozen_at?: string | null;
+    pi_pid?: number | null;
+}): boolean;
+/** Resolve a node's glyph + hue + overlay word, applying the precedence
+ *  hanging > frozen > streaming > status. */
+export declare function resolveNodeVisual(status: NodeStatus, opts: {
+    streaming?: boolean;
+    frozen?: boolean;
+    hanging?: Fault | {
+        kind: FaultKind;
+    } | null;
+}): NodeVisual;
+/** True for exactly the fault dispositions `faultDispositionText` renders as
+ *  "needs you" — nothing (sdk/daemon/client) is auto-driving recovery, so the
+ *  dashboard flags the node for the human. Exported so a recovery verb (e.g.
+ *  `node lifecycle revive --now`, src/commands/node-lifecycle-revive.ts) can gate on the SAME
+ *  predicate the dashboard advertises instead of drifting out of sync with it
+ *  and rejecting exactly the nodes shown as "needs you". */
+export declare function faultNeedsYou(fault: Pick<Fault, 'retry'>): boolean;
+/** Human-friendly active-fault disposition text. `auto` faults show the current
+ *  retry attempt plus the next scheduled retry; client-owned redials say
+ *  `redialing`; everything else says `needs you`. */
+export declare function faultDispositionText(fault: Fault, now?: number): string;
+/** One-line active-fault summary used by the canvas surfaces: `link kind ·
+ *  disposition`. */
+export declare function faultSummary(fault: Fault, now?: number): string;
+/** Elapsed counter used by the browse rail's countdown slot. `faultSummary`
+ *  covers the presenter surfaces; this stays for the rail's existing time text. */
+export declare function hangingCountdown(since: string, now?: number): string;

package/dist/core/canvas/status-glyph.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var o=(e,t)=>u(e,"name",{value:t,configurable:!0});import{RECESSIVE_FG as a}from"../tui/draw.js";import{FAULT_QUIET_MS as c}from"../runtime/fault.js";const d={active:"\u25CF",idle:"\u25CB",done:"\u2713",dead:"\u2717",canceled:"\u2298"},l={active:"32",idle:"33",done:"36",dead:"31",canceled:a},s="\u27F3",f="92",p="\u25CC",m="94",g="\u26A0",x="33";function i(e){switch(e){case"rate-limit":return"rate-limited";case"overloaded":return"overloaded";case"connection":return"down";case"auth":return"auth";case"protocol":return"protocol";case"context-overflow":return"context-overflow";case"wedged":return"wedged";case"model-not-found":return"model-not-found";default:return"other"}}o(i,"hangingLabel");function $(e){return e.frozen_at!=null&&e.pi_pid==null}o($,"isFrozenRow");function L(e,t){return t.hanging!=null?{glyph:g,color:x,word:i(t.hanging.kind),bold:!0}:t.frozen===!0?{glyph:p,color:m,word:"frozen"}:t.streaming===!0?{glyph:s,color:f,word:"live",bold:!0}:{glyph:d[e]??"?",color:l[e]}}o(L,"resolveNodeVisual");function h(e,t){const r=Date.parse(e);if(Number.isNaN(r))return"now";const n=r-t;return n<=0?"now":n>=6e4?`${Math.max(1,Math.round(n/6e4))}m`:`${Math.max(1,Math.ceil(n/1e3))}s`}o(h,"retryCountdown");function y(e){return e.retry.disposition!=="auto"}o(y,"faultNeedsYou");function _(e,t=Date.now()){const r=e.retry;if(!y(e)){if(r.by==="client")return"redialing";const n=typeof r.attempt=="number"&&typeof r.max=="number"?`auto-retry ${r.attempt}/${r.max}`:"auto-retrying";return r.nextAt?`${n}, next ${h(r.nextAt,t)}`:n}return"needs you"}o(_,"faultDispositionText");function M(e,t=Date.now()){return`${e.link} ${i(e.kind)} \xB7 ${_(e,t)}`}o(M,"faultSummary");function O(e,t=Date.now()){const r=Date.parse(e);if(Number.isNaN(r))return"retrying\u2026";const n=c-(t-r);return n<=0?"retrying\u2026":n>=6e4?`retry in ~${Math.max(1,Math.round(n/6e4))}m`:`retry in ~${Math.ceil(n/1e3)}s`}o(O,"hangingCountdown");export{x as HANGING_COLOR,g as HANGING_GLYPH,l as STATUS_COLOR,d as STATUS_GLYPH,_ as faultDispositionText,y as faultNeedsYou,M as faultSummary,O as hangingCountdown,i as hangingLabel,$ as isFrozenRow,L as resolveNodeVisual};

package/dist/core/canvas/structured-requests.d.ts

@@ -0,0 +1,69 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { StructuredRequestDTO, StructuredRequestModeDTO, StructuredRequestStateDTO, StructuredRequestSubmissionDTO } from '../../api/dto/structured-requests.js';
+import type { DeclinedResult, NodeOutcomeDetailV1, TerminalReason } from './types.js';
+export type StructuredRequestFailureReason = TerminalReason | 'node_create_failed' | 'bind_failed' | 'prompt_delivery_failed' | 'node_deadline_exceeded';
+export interface StructuredRequestRow {
+    request_id: string;
+    node_id: string | null;
+    mode: StructuredRequestModeDTO;
+    submission: StructuredRequestSubmissionDTO;
+    dedicated: boolean;
+    state: StructuredRequestStateDTO;
+    schema: Record<string, unknown>;
+    result: unknown | null;
+    deadline_at: number | null;
+    created_at: number;
+    settled_at: number | null;
+    effects_done_at: number | null;
+    result_path: string | null;
+    declined: DeclinedResult | null;
+    failure_reason: StructuredRequestFailureReason | null;
+    failure_detail: NodeOutcomeDetailV1 | null;
+    /** The inbox entry a one-off request arrived in; its subscription ends when the result report lands. */
+    request_message_id: string | null;
+}
+export interface SettleStructuredRequestInput {
+    intended: Exclude<StructuredRequestStateDTO, 'pending'>;
+    now?: number;
+    result?: unknown;
+    declined?: DeclinedResult;
+    failureReason?: StructuredRequestFailureReason;
+    failureDetail?: NodeOutcomeDetailV1 | null;
+}
+export interface SettleStructuredRequestResult {
+    changed: boolean;
+    row: StructuredRequestRow | null;
+}
+/** The daemon installs its post-commit effects here. Core only exposes a committed row. */
+export declare function registerStructuredRequestEffectRunner(runner: (row: StructuredRequestRow) => void): void;
+export declare function runStructuredRequestEffects(row: StructuredRequestRow | null): void;
+export declare function getStructuredRequest(requestId: string): StructuredRequestRow | null;
+export declare function getPendingStructuredRequestForNode(nodeId: string): StructuredRequestRow | null;
+export declare function admitStructuredRequest(input: {
+    requestId: string;
+    mode: StructuredRequestModeDTO;
+    submission: StructuredRequestSubmissionDTO;
+    dedicated: boolean;
+    schema: Record<string, unknown>;
+    deadlineAt: number | null;
+    nodeId?: string | null;
+    requestMessageId?: string | null;
+    now?: number;
+}): StructuredRequestRow;
+/** Bind is conditional so a cancel that won after creation cannot attach its node. */
+export declare function bindStructuredRequest(requestId: string, nodeId: string): SettleStructuredRequestResult;
+/** One settlement statement with deadline precedence. Callers that own a wider transaction pass that db. */
+export declare function settleStructuredRequestIn(db: DatabaseSync, requestId: string, input: SettleStructuredRequestInput): SettleStructuredRequestResult;
+export declare function settleStructuredRequest(requestId: string, input: SettleStructuredRequestInput): SettleStructuredRequestResult;
+export declare function settlePendingStructuredRequestForNodeIn(db: DatabaseSync, nodeId: string, input: SettleStructuredRequestInput): SettleStructuredRequestResult;
+export declare function settlePendingStructuredRequestForNode(nodeId: string, input: SettleStructuredRequestInput): SettleStructuredRequestResult;
+export declare function pendingStructuredRequestsPast(now: number): StructuredRequestRow[];
+export declare function incompleteStructuredRequestEffects(): StructuredRequestRow[];
+/** One-off result paths belong to one request; terminal result paths belong to the latest terminal settlement on the node. */
+export declare function ownsStructuredRequestResultProjection(row: StructuredRequestRow): boolean;
+/** Declines share one legacy path, so its owner is the latest declined request regardless of submission mode. */
+export declare function ownsStructuredRequestDeclineProjection(row: StructuredRequestRow): boolean;
+export declare function markStructuredRequestEffectsDone(requestId: string, resultPath: string | null): void;
+/** Legacy node/message schema paths get the same identity and authority. */
+export declare function registerLegacyStructuredRequest(nodeId: string, mode: StructuredRequestSubmissionDTO, schema: Record<string, unknown>, requestMessageId?: string): StructuredRequestRow;
+export declare function toStructuredRequestDTO(row: StructuredRequestRow): StructuredRequestDTO;

package/dist/core/canvas/structured-requests.js

@@ -0,0 +1,15 @@
+var g=Object.defineProperty;var d=(e,n)=>g(e,"name",{value:n,configurable:!0});import{randomUUID as D}from"node:crypto";import{openDb as s,withCanvasWrite as u}from"./db.js";let _;function I(e){_=e}d(I,"registerStructuredRequestEffectRunner");function E(e){e!==null&&e.state!=="pending"&&_?.(e)}d(E,"runStructuredRequestEffects");function f(e){return e==null?null:JSON.stringify(e)}d(f,"json");function c(e){return typeof e!="string"?null:JSON.parse(e)}d(c,"parseJson");function i(e){if(e===void 0)return null;const n=c(e.schema_json);if(n===null||typeof n!="object"||Array.isArray(n))throw new Error(`structured request ${String(e.request_id)} has invalid schema_json`);const t=e.declined_reason===null?null:{reason:e.declined_reason,code:e.declined_code,retryable:e.declined_retryable===1},r=c(e.failure_detail_json);return{request_id:e.request_id,node_id:e.node_id,mode:e.mode,submission:e.submission,dedicated:e.dedicated===1,state:e.state,schema:n,result:c(e.result_json),deadline_at:e.deadline_at,created_at:e.created_at,settled_at:e.settled_at,effects_done_at:e.effects_done_at,result_path:e.result_path,declined:t,failure_reason:e.failure_reason,failure_detail:r,request_message_id:e.request_message_id??null}}d(i,"rowFrom");function o(e,n){return i(e.prepare("SELECT * FROM structured_requests WHERE request_id = ?").get(n))}d(o,"get");function O(e){return o(s(),e)}d(O,"getStructuredRequest");function p(e){return i(s().prepare("SELECT * FROM structured_requests WHERE node_id = ? AND state = 'pending'").get(e))}d(p,"getPendingStructuredRequestForNode");function R(e){const n=e.now??Date.now();return u(t=>(t.prepare(`INSERT INTO structured_requests (request_id, node_id, mode, submission, dedicated, state, schema_json, deadline_at, created_at, request_message_id)
+      VALUES (?, ?, ?, ?, ?, 'pending', ?, ?, ?, ?)`).run(e.requestId,e.nodeId??null,e.mode,e.submission,e.dedicated?1:0,JSON.stringify(e.schema),e.deadlineAt,n,e.requestMessageId??null),o(t,e.requestId)))}d(R,"admitStructuredRequest");function h(e,n){return u(t=>({changed:Number(t.prepare("UPDATE structured_requests SET node_id = ? WHERE request_id = ? AND state = 'pending' AND node_id IS NULL").run(n,e).changes)===1,row:o(t,e)}))}d(h,"bindStructuredRequest");function N(e,n,t){const r=t.now??Date.now(),l=t.intended==="completed"?f(t.result):null,a=t.intended==="declined"?t.declined:void 0,S=t.intended==="failed"?t.failureReason??"crashed":t.intended==="expired"?t.failureReason??null:null,q=t.intended==="failed"||t.intended==="expired"?f(t.failureDetail??null):null;return{changed:Number(e.prepare(`UPDATE structured_requests
+     SET state = CASE WHEN deadline_at IS NOT NULL AND ? >= deadline_at THEN 'expired' ELSE ? END,
+         result_json = CASE WHEN deadline_at IS NOT NULL AND ? >= deadline_at THEN result_json WHEN ? = 'completed' THEN ? ELSE result_json END,
+         declined_reason = CASE WHEN deadline_at IS NOT NULL AND ? >= deadline_at THEN declined_reason WHEN ? = 'declined' THEN ? ELSE declined_reason END,
+         declined_code = CASE WHEN deadline_at IS NOT NULL AND ? >= deadline_at THEN declined_code WHEN ? = 'declined' THEN ? ELSE declined_code END,
+         declined_retryable = CASE WHEN deadline_at IS NOT NULL AND ? >= deadline_at THEN declined_retryable WHEN ? = 'declined' THEN ? ELSE declined_retryable END,
+         failure_reason = CASE WHEN deadline_at IS NOT NULL AND ? >= deadline_at THEN failure_reason WHEN ? IN ('failed', 'expired') THEN ? ELSE failure_reason END,
+         failure_detail_json = CASE WHEN deadline_at IS NOT NULL AND ? >= deadline_at THEN failure_detail_json WHEN ? IN ('failed', 'expired') THEN ? ELSE failure_detail_json END,
+         settled_at = ?
+   WHERE request_id = ? AND state = 'pending'`).run(r,t.intended,r,t.intended,l,r,t.intended,a?.reason??null,r,t.intended,a?.code??null,r,t.intended,a===void 0?null:a.retryable?1:0,r,t.intended,S,r,t.intended,q,r,n).changes)===1,row:o(e,n)}}d(N,"settleStructuredRequestIn");function W(e,n){const t=u(r=>N(r,e,n));return t.changed&&E(t.row),t}d(W,"settleStructuredRequest");function m(e,n,t){const r=i(e.prepare("SELECT * FROM structured_requests WHERE node_id = ? AND state = 'pending'").get(n));return r===null?{changed:!1,row:null}:N(e,r.request_id,t)}d(m,"settlePendingStructuredRequestForNodeIn");function x(e,n){const t=u(r=>m(r,e,n));return t.changed&&E(t.row),t}d(x,"settlePendingStructuredRequestForNode");function C(e){return s().prepare("SELECT * FROM structured_requests WHERE state = 'pending' AND deadline_at IS NOT NULL AND deadline_at <= ?").all(e).map(n=>i(n))}d(C,"pendingStructuredRequestsPast");function b(){return s().prepare("SELECT * FROM structured_requests WHERE state != 'pending' AND effects_done_at IS NULL").all().map(e=>i(e))}d(b,"incompleteStructuredRequestEffects");function U(e){return e.node_id===null?!1:e.submission==="oneoff"?!0:s().prepare(`SELECT request_id FROM structured_requests
+    WHERE node_id = ? AND submission = 'terminal' AND state IN ('completed', 'declined')
+    ORDER BY settled_at DESC, rowid DESC LIMIT 1`).get(e.node_id)?.request_id===e.request_id}d(U,"ownsStructuredRequestResultProjection");function j(e){return e.node_id===null?!1:s().prepare(`SELECT request_id FROM structured_requests
+    WHERE node_id = ? AND state = 'declined'
+    ORDER BY settled_at DESC, rowid DESC LIMIT 1`).get(e.node_id)?.request_id===e.request_id}d(j,"ownsStructuredRequestDeclineProjection");function y(e,n){u(t=>{t.prepare("UPDATE structured_requests SET effects_done_at = ?, result_path = COALESCE(?, result_path) WHERE request_id = ? AND state != 'pending'").run(Date.now(),n,e)})}d(y,"markStructuredRequestEffectsDone");function F(e,n,t,r){const l=p(e);return l!==null?l:R({requestId:`legacy-${D().replace(/-/g,"")}`,mode:"async",submission:n,dedicated:n==="terminal",schema:t,deadlineAt:null,nodeId:e,requestMessageId:r??null})}d(F,"registerLegacyStructuredRequest");function M(e){return{request_id:e.request_id,node_id:e.node_id,mode:e.mode,submission:e.submission,state:e.state,created_at:new Date(e.created_at).toISOString(),deadline_at:e.deadline_at===null?null:new Date(e.deadline_at).toISOString(),settled_at:e.settled_at===null?null:new Date(e.settled_at).toISOString(),result:e.state==="completed"?e.result:null,declined:e.state==="declined"?e.declined:null,failure:e.state==="failed"&&e.failure_reason!==null?{reason:e.failure_reason,detail:e.failure_detail}:null}}d(M,"toStructuredRequestDTO");export{R as admitStructuredRequest,h as bindStructuredRequest,p as getPendingStructuredRequestForNode,O as getStructuredRequest,b as incompleteStructuredRequestEffects,y as markStructuredRequestEffectsDone,j as ownsStructuredRequestDeclineProjection,U as ownsStructuredRequestResultProjection,C as pendingStructuredRequestsPast,F as registerLegacyStructuredRequest,I as registerStructuredRequestEffectRunner,E as runStructuredRequestEffects,x as settlePendingStructuredRequestForNode,m as settlePendingStructuredRequestForNodeIn,W as settleStructuredRequest,N as settleStructuredRequestIn,M as toStructuredRequestDTO};