@north-light/cli 0.3.529 → 0.3.531

package/dist/core/runtime/persona.js

@@ -1,2 +1,2 @@
-var s=Object.defineProperty;var n=(o,e)=>s(o,"name",{value:e,configurable:!0});import{getNode as i,updateNode as d}from"../canvas/index.js";import{readRoadmap as c}from"./roadmap.js";import{orchestratorContextNote as u}from"./bearings.js";function l(o,e){const r=c(o)??"(no roadmap yet)",t=[`You are now a ${e.toUpperCase()} ORCHESTRATOR. Your scarce resource is your own context window.`,"Your job is to manage context and delegate \u2014 not to do the goal yourself."];return t.push("","Your roadmap is your document `roadmap`; it loads at every new session of yours. Author it now with `crtr doc edit roadmap`: state the goal and exit criteria, and set the preview to the goal\u2019s first line, using your orchestration protocol. Current contents:","",r,"",u(),"","What promotion changes is how long your documents matter: you now persist across refresh cycles, so the documents you own (`crtr doc write`) carry what this goal needs between your refreshes, and a lesson that should outlive this node gets another owner (`--owner user|repo|profile`).","","Then delegate each unit with `crtr node new --kind <kind>`. When your context fills, run `crtr node yield` to refresh against this roadmap."),t.join(`
-`)}n(l,"orchestrationGuidance");function m(){return"You are HANDS-ON again \u2014 base mode. Do the work yourself in THIS window and finish it here; stop delegating by default. You no longer drive a roadmap, so `crtr node yield` is not your exit. Spawn a child only for a cleanly separable unit, never as your first move."}n(m,"baseModeGuidance");function f(o,e,r){if(e.mode===r.mode)return"";if(r.mode==="base")return m();const t=i(o);return l(o,t?.kind??"general")}n(f,"transitionGuidance");function g(o){const e=i(o);if(e===null)return null;const r={kind:e.kind,mode:e.mode,lifecycle:e.lifecycle},t=e.persona_ack,a=t===void 0?r:{kind:t.kind??e.kind,mode:t.mode,lifecycle:t.lifecycle};return a.kind===r.kind&&a.mode===r.mode&&a.lifecycle===r.lifecycle?null:{from:a,to:r,guidance:f(o,a,r)}}n(g,"personaDrift");function k(o,e){d(o,{persona_ack:e})}n(k,"commitPersonaAck");export{k as commitPersonaAck,g as personaDrift,f as transitionGuidance};
+var s=Object.defineProperty;var r=(o,e)=>s(o,"name",{value:e,configurable:!0});import{getNode as i,updateNode as c}from"../canvas/index.js";import{readRoadmap as d}from"./roadmap.js";import{orchestratorContextNote as u}from"./bearings.js";async function l(o,e){const t=await d(o)??"(no roadmap yet)",n=[`You are now a ${e.toUpperCase()} ORCHESTRATOR. Your scarce resource is your own context window.`,"Your job is to manage context and delegate \u2014 not to do the goal yourself."];return n.push("","Your roadmap is your document `roadmap`; it loads at every new session of yours. Author it now with `crtr doc edit roadmap`: state the goal and exit criteria, and set the preview to the goal\u2019s first line, using your orchestration protocol. Current contents:","",t,"",u(),"","What promotion changes is how long your documents matter: you now persist across refresh cycles, so the documents you own (`crtr doc write`) carry what this goal needs between your refreshes, and a lesson that should outlive this node gets another owner (`--owner user|repo|profile`).","","Then delegate each unit with `crtr node new --kind <kind>`. When your context fills, run `crtr node yield` to refresh against this roadmap."),n.join(`
+`)}r(l,"orchestrationGuidance");function m(){return"You are HANDS-ON again \u2014 base mode. Do the work yourself in THIS window and finish it here; stop delegating by default. You no longer drive a roadmap, so `crtr node yield` is not your exit. Spawn a child only for a cleanly separable unit, never as your first move."}r(m,"baseModeGuidance");async function f(o,e,t){if(e.mode===t.mode)return"";if(t.mode==="base")return m();const n=await i(o);return await l(o,n?.kind??"general")}r(f,"transitionGuidance");async function g(o){const e=await i(o);if(e===null)return null;const t={kind:e.kind,mode:e.mode,lifecycle:e.lifecycle},n=e.persona_ack,a=n===void 0?t:{kind:n.kind??e.kind,mode:n.mode,lifecycle:n.lifecycle};return a.kind===t.kind&&a.mode===t.mode&&a.lifecycle===t.lifecycle?null:{from:a,to:t,guidance:await f(o,a,t)}}r(g,"personaDrift");async function k(o,e){await c(o,{persona_ack:e})}r(k,"commitPersonaAck");export{k as commitPersonaAck,g as personaDrift,f as transitionGuidance};

package/dist/core/runtime/placement.d.ts

@@ -5,15 +5,15 @@ export type { RespawnPaneOpts } from './tmux-driver.js';
 export { installTmuxBindings } from './tmux-bindings.js';
 export type { TmuxInstalledPair, TmuxInstallDiagnostic, TmuxInstallResult } from './tmux-bindings.js';
 /** The viewer a node has on screen, or null. UNIQUE(node_id) ⇒ at most one. */
-export declare function focusOf(nodeId: string): FocusRow | null;
+export declare function focusOf(nodeId: string): Promise<FocusRow | null>;
 /** Does this node have a live viewer on screen? */
-export declare function isFocused(nodeId: string): boolean;
+export declare function isFocused(nodeId: string): Promise<boolean>;
 /** The viewer realized by a given pane (`%id`), or null. */
-export declare function focusByPane(pane: string): FocusRow | null;
+export declare function focusByPane(pane: string): Promise<FocusRow | null>;
 /** The set of node ids that currently have a live viewer. */
-export declare function focusedNodes(): Set<string>;
+export declare function focusedNodes(): Promise<Set<string>>;
 /** Every live viewer row (GC'ing any whose pane has gone). */
-export declare function listFocuses(): FocusRow[];
+export declare function listFocuses(): Promise<FocusRow[]>;
 /** A reviver: ensure a node's broker ENGINE is alive (idempotent → reviveNode →
  *  headlessBrokerHost.launch). Injected so placement.ts need not import revive.ts
  *  (which imports placement.ts — a cycle). */
@@ -40,7 +40,7 @@ export interface FocusResult {
  *  `window` is accepted for the call contract (spawn passes it) but not stored —
  *  the focuses table keys on pane + session only. The attach client self-tags the
  *  pane `@crtr_node` on connect, so `nodeInPane` resolves it either way. */
-export declare function registerViewerFocus(nodeId: string, pane: string, session: string | null, window: string | null): FocusRow | null;
+export declare function registerViewerFocus(nodeId: string, pane: string, session: string | null, window: string | null): Promise<FocusRow | null>;
 /** Open a surface-attach viewer for `nodeId` and register its viewer focus row —
  *  the shared opener used by `focus` (a split beside the caller) and by a --root
  *  spawn (a fresh window in the caller's current session). Wraps `ensureSession`
@@ -58,7 +58,7 @@ export declare function openViewerWindow(nodeId: string, session: string, opts?:
     besidePane?: string;
     waitForBroker?: boolean;
     initialWhip?: boolean;
-}): FocusRow | null;
+}): Promise<FocusRow | null>;
 export declare function focus(nodeId: string, opts: {
     pane?: string;
     newPane?: boolean;
@@ -70,7 +70,7 @@ export declare function focus(nodeId: string, opts: {
  *  on-screen viewer: kill its pane (the window collapses once its last pane goes)
  *  and drop its registry row. Best-effort tmux; the DB write always lands. No-op
  *  when the node has no viewer. */
-export declare function tearDownNode(nodeId: string, keepPane?: string): void;
+export declare function tearDownNode(nodeId: string, keepPane?: string): Promise<void>;
 /** Detach a node from the foreground (the `node lifecycle demote --detach` / Alt+C → D
  *  half). Every node is a headless broker — the only thing on screen is its
  *  surface-attach viewer pane — so "detach" means STOP FOREGROUNDING it: close the
@@ -78,7 +78,7 @@ export declare function tearDownNode(nodeId: string, keepPane?: string): void;
  *  reconnectable by a later `focus`. `pane` is the authoritative pane the caller
  *  acts on (the Alt+C menu's `#{pane_id}`); falls back to the node's registered
  *  viewer pane. No-op (false) when there is no live viewer pane to close. */
-export declare function detachToBackground(nodeId: string, pane?: string): boolean;
+export declare function detachToBackground(nodeId: string, pane?: string): Promise<boolean>;
 /** Reap `nodeId` IFF it is an empty shell (see {@link isEmptyNode}): tear down its
  *  broker engine, close any viewer, and hard-delete its row (edges cascade) + dir.
  *  The user closing or detaching from a node that never said anything wants it
@@ -86,7 +86,7 @@ export declare function detachToBackground(nodeId: string, pane?: string): boole
  *  its node identity so the worktree remains owned and can later be closed.
  *  Returns true when it reaped. No-op (false) on a node that produced output,
  *  is mid-first-turn, owns an open managed worktree, or no longer exists. */
-export declare function reapIfEmpty(nodeId: string, keepPane?: string, teardown?: boolean): boolean;
+export declare function reapIfEmpty(nodeId: string, keepPane?: string, teardown?: boolean): Promise<boolean>;
 /** Sweep the whole canvas for empty shells and reap them — the bulk cleanup
  *  behind `crtr canvas prune --empty`, for the husks that accumulated before
  *  close/detach learned to reap. Skips: the caller ($CRTR_NODE_ID), dead rows,
@@ -97,4 +97,4 @@ export declare function reapIfEmpty(nodeId: string, keepPane?: string, teardown?
  *  without deleting. Returns the reaped (or, under dryRun, reapable) node ids. */
 export declare function reapEmptyNodes(opts?: {
     dryRun?: boolean;
-}): string[];
+}): Promise<string[]>;

package/dist/core/runtime/placement.js

@@ -1 +1 @@
-var V=Object.defineProperty;var t=(e,n)=>V(e,"name",{value:n,configurable:!0});import{envNodeId as $}from"../../shared/env.js";import{getNode as m,fullName as H,deleteNode as R,listNodes as M,openFocusRow as z,closeFocusRow as a,getFocusByNode as T,getFocusByPane as x,getFocusById as D,listFocuses as J}from"../canvas/index.js";import{nodeHasAssistantMessage as Q}from"../canvas/render-source.js";import{headlessBrokerHost as k}from"./host.js";import{publishNotice as U}from"./close.js";import{paneExists as d,paneLocation as h,closePane as P,currentTmux as X,switchClient as j,selectWindow as q,selectLayout as G,selectPane as S,getPaneOption as K,setPaneOption as Y,respawnPaneSync as Z,windowOfPane as I,renameWindow as ee}from"./tmux-driver.js";import{openViewerPane as ne,viewerSplitEnv as W,waitForBrokerViewSocket as oe}from"./placement-tmux.js";import{newJobId as se}from"./nodes.js";import{isPidAlive as y}from"../canvas/pid.js";import{splitWindow as Oe,breakPane as Re,selectLayout as Te,selectPane as ke,focusWindow as Se,selectWindow as We,switchClient as be,openNodeWindow as Ae,ensureSession as Be,paneLocation as Ee,paneExists as Ce,paneRunning as Le,paneCurrentPath as Ve,currentTmux as $e,inTmux as He,paneOfNode as Me,setPaneOption as ze,getPaneOption as De,piCommand as Je,shellQuote as Qe,respawnPaneSync as Ue,closePane as Xe,displayPopup as je,windowOfPane as qe,renameWindow as Ge,paneOfWindow as Ke,windowAlive as Ye,listLivePanes as Ze,listLivePanesAsync as Ie}from"./tmux-driver.js";import{installTmuxBindings as nn}from"./tmux-bindings.js";function g(e){return e===null?null:e.pane!==null&&!d(e.pane)?(a(e.focus_id),null):e}t(g,"liveOrPrune");function p(e){return g(T(e))}t(p,"focusOf");function _e(e){return p(e)!==null}t(_e,"isFocused");function ie(e){return g(x(e))}t(ie,"focusByPane");function xe(){return new Set(te().map(e=>e.node_id))}t(xe,"focusedNodes");function te(){const e=[];for(const n of J())g(n)!==null&&e.push(n);return e}t(te,"listFocuses");function re(){return`f-${se()}`}t(re,"newFocusId");function b(e,n,o,s){const u=x(n);if(u!==null)return u;const r=T(e);if(r!==null)return r;const l=re();return z(l,n,o,e),D(l)}t(b,"registerViewerFocus");function A(e,n,o={}){const s=ne(e,n,o);return s===null?null:b(e,s.pane,s.session,s.window)}t(A,"openViewerWindow");function B(e){const n=h(e)?.window??null;n!==null&&G(n,"even-horizontal"),S(e)}t(B,"surfaceNewPane");async function he(e,n){const o=m(e);if(o===null)return{focused:!1,session:null,inPlace:!1,revived:!1};const s=n.pane??process.env.TMUX_PANE??X()?.pane;if(s===void 0||s==="")return{focused:!1,session:null,inPlace:!1,revived:!1};const u=y(o.pi_pid??null),r=n.revive(e),l=!u;if(!await oe(e,r?.launch?.exited))return{focused:!1,session:null,inPlace:!1,revived:l};const v=h(s)?.session??null,N=v??"";if(n.inPlace===!0){const i=p(e);i!==null&&(i.pane!==null&&i.pane!==s&&d(i.pane)&&P(i.pane),a(i.focus_id));const c=x(s);c!==null&&c.node_id!==e&&a(c.focus_id);try{Y(s,"@crtr_node","")}catch{}const _=I(s),F=c?.node_id,L=F===void 0?W():{...W(),CRTR_ATTACH_ROSTER:F},O=Z({pane:s,cwd:o.cwd,env:L,command:`crtr surface attach to ${e}`});return O&&(_!==null&&ee(_,H(o)),b(e,s,v,_)),{focused:O,session:v,inPlace:!0,revived:l}}if(n.newPane===!0){const i=p(e);i!==null&&(i.pane!==null&&d(i.pane)&&P(i.pane),a(i.focus_id));const c=A(e,N,{cwd:o.cwd,besidePane:s});return c===null?{focused:!1,session:null,inPlace:!1,revived:l}:(c.pane!==null&&B(c.pane),{focused:!0,session:c.session,inPlace:!1,revived:l})}const f=p(e);if(f!==null&&f.pane!==null)if(K(f.pane,"@crtr_node")===e){const i=h(f.pane);if(i!==null)return j(i.session),q(i.session,i.window),S(f.pane),{focused:!0,session:i.session,inPlace:!0,revived:l};a(f.focus_id)}else a(f.focus_id);const w=A(e,N,{cwd:o.cwd,besidePane:s});return w===null?{focused:!1,session:null,inPlace:!1,revived:l}:(w.pane!==null&&B(w.pane),{focused:!0,session:w.session,inPlace:!1,revived:l})}t(he,"focus");function E(e,n){const o=p(e);o!==null&&(o.pane!==null&&o.pane!==n&&d(o.pane)&&P(o.pane),a(o.focus_id))}t(E,"tearDownNode");function ye(e,n){const o=n??p(e)?.pane??null;if(o===null||!d(o))return!1;const s=ie(o);s!==null&&a(s.focus_id);const u=P(o);return le(e),u}t(ye,"detachToBackground");function C(e){const n=m(e);return n===null||n.streaming===!0&&y(n.pi_pid)?!1:!Q(n.pi_session_file)}t(C,"isEmptyNode");function le(e,n,o=!0){return m(e)?.managed_worktree?.state==="open"||!C(e)?!1:(o&&k.teardown(e),E(e,n),R(e).deleted)}t(le,"reapIfEmpty");function ge(e={}){const n=e.dryRun??!1,o=$()??"",s=[];for(const u of M()){const r=u.node_id,l=m(r);r===o||u.status==="dead"||y(u.pi_pid)||l?.managed_worktree?.state==="open"||!C(r)||!n&&(U(r,"notice.close",`Child closed \u2014 ${l?.name??r} (${r}) was closed from the canvas and is no longer running.`,{reason:"child-closed",child:r}),k.teardown(r),E(r),!R(r).deleted)||s.push(r)}return s}t(ge,"reapEmptyNodes");export{Re as breakPane,Xe as closePane,$e as currentTmux,ye as detachToBackground,je as displayPopup,Be as ensureSession,he as focus,ie as focusByPane,p as focusOf,Se as focusWindow,xe as focusedNodes,De as getPaneOption,He as inTmux,nn as installTmuxBindings,_e as isFocused,te as listFocuses,Ze as listLivePanes,Ie as listLivePanesAsync,Ae as openNodeWindow,A as openViewerWindow,Ve as paneCurrentPath,Ce as paneExists,Ee as paneLocation,Me as paneOfNode,Ke as paneOfWindow,Le as paneRunning,Je as piCommand,ge as reapEmptyNodes,le as reapIfEmpty,b as registerViewerFocus,Ge as renameWindow,Ue as respawnPaneSync,Te as selectLayout,ke as selectPane,We as selectWindow,ze as setPaneOption,Qe as shellQuote,Oe as splitWindow,be as switchClient,E as tearDownNode,Ye as windowAlive,qe as windowOfPane};
+var V=Object.defineProperty;var s=(e,n)=>V(e,"name",{value:n,configurable:!0});import{envNodeId as $}from"../../shared/env.js";import{getNode as m,fullName as H,deleteNode as R,listNodes as M,openFocusRow as z,closeFocusRow as u,getFocusByNode as T,getFocusByPane as _,getFocusById as D,listFocuses as J}from"../canvas/index.js";import{nodeHasAssistantMessage as Q}from"../canvas/render-source.js";import{headlessBrokerHost as k}from"./host.js";import{publishNotice as U}from"./close.js";import{paneExists as p,paneLocation as x,closePane as P,currentTmux as X,switchClient as j,selectWindow as q,selectLayout as G,selectPane as S,getPaneOption as K,setPaneOption as Y,respawnPaneSync as Z,windowOfPane as I,renameWindow as ee}from"./tmux-driver.js";import{openViewerPane as ne,viewerSplitEnv as W,waitForBrokerViewSocket as ae}from"./placement-tmux.js";import{newJobId as ie}from"./nodes.js";import{isPidAlive as h}from"../canvas/pid.js";import{splitWindow as Oe,breakPane as Re,selectLayout as Te,selectPane as ke,focusWindow as Se,selectWindow as We,switchClient as be,openNodeWindow as Ae,ensureSession as Be,paneLocation as Ee,paneExists as Ce,paneRunning as Le,paneCurrentPath as Ve,currentTmux as $e,inTmux as He,paneOfNode as Me,setPaneOption as ze,getPaneOption as De,piCommand as Je,shellQuote as Qe,respawnPaneSync as Ue,closePane as Xe,displayPopup as je,windowOfPane as qe,renameWindow as Ge,paneOfWindow as Ke,windowAlive as Ye,listLivePanes as Ze,listLivePanesAsync as Ie}from"./tmux-driver.js";import{installTmuxBindings as nn}from"./tmux-bindings.js";async function g(e){return e===null?null:e.pane!==null&&!p(e.pane)?(await u(e.focus_id),null):e}s(g,"liveOrPrune");async function w(e){return await g(await T(e))}s(w,"focusOf");async function ve(e){return await w(e)!==null}s(ve,"isFocused");async function te(e){return await g(await _(e))}s(te,"focusByPane");async function _e(){return new Set((await se()).map(e=>e.node_id))}s(_e,"focusedNodes");async function se(){const e=[];for(const n of await J())await g(n)!==null&&e.push(n);return e}s(se,"listFocuses");function oe(){return`f-${ie()}`}s(oe,"newFocusId");async function b(e,n,a,i){const c=await _(n);if(c!==null)return c;const o=await T(e);if(o!==null)return o;const r=oe();return await z(r,n,a,e),await D(r)}s(b,"registerViewerFocus");async function A(e,n,a={}){const i=ne(e,n,a);return i===null?null:await b(e,i.pane,i.session,i.window)}s(A,"openViewerWindow");function B(e){const n=x(e)?.window??null;n!==null&&G(n,"even-horizontal"),S(e)}s(B,"surfaceNewPane");async function xe(e,n){const a=await m(e);if(a===null)return{focused:!1,session:null,inPlace:!1,revived:!1};const i=n.pane??process.env.TMUX_PANE??X()?.pane;if(i===void 0||i==="")return{focused:!1,session:null,inPlace:!1,revived:!1};const c=h(a.pi_pid??null),o=n.revive(e),r=!c;if(!await ae(e,o?.launch?.exited))return{focused:!1,session:null,inPlace:!1,revived:r};const y=x(i)?.session??null,N=y??"";if(n.inPlace===!0){const t=await w(e);t!==null&&(t.pane!==null&&t.pane!==i&&p(t.pane)&&P(t.pane),await u(t.focus_id));const l=await _(i);l!==null&&l.node_id!==e&&await u(l.focus_id);try{Y(i,"@crtr_node","")}catch{}const v=I(i),F=l?.node_id,L=F===void 0?W():{...W(),CRTR_ATTACH_ROSTER:F},O=Z({pane:i,cwd:a.cwd,env:L,command:`crtr surface attach to ${e}`});return O&&(v!==null&&ee(v,H(a)),await b(e,i,y,v)),{focused:O,session:y,inPlace:!0,revived:r}}if(n.newPane===!0){const t=await w(e);t!==null&&(t.pane!==null&&p(t.pane)&&P(t.pane),await u(t.focus_id));const l=await A(e,N,{cwd:a.cwd,besidePane:i});return l===null?{focused:!1,session:null,inPlace:!1,revived:r}:(l.pane!==null&&B(l.pane),{focused:!0,session:l.session,inPlace:!1,revived:r})}const f=await w(e);if(f!==null&&f.pane!==null)if(K(f.pane,"@crtr_node")===e){const t=x(f.pane);if(t!==null)return j(t.session),q(t.session,t.window),S(f.pane),{focused:!0,session:t.session,inPlace:!0,revived:r};await u(f.focus_id)}else await u(f.focus_id);const d=await A(e,N,{cwd:a.cwd,besidePane:i});return d===null?{focused:!1,session:null,inPlace:!1,revived:r}:(d.pane!==null&&B(d.pane),{focused:!0,session:d.session,inPlace:!1,revived:r})}s(xe,"focus");async function E(e,n){const a=await w(e);a!==null&&(a.pane!==null&&a.pane!==n&&p(a.pane)&&P(a.pane),await u(a.focus_id))}s(E,"tearDownNode");async function he(e,n){const a=n??(await w(e))?.pane??null;if(a===null||!p(a))return!1;const i=await te(a);i!==null&&await u(i.focus_id);const c=P(a);return await re(e),c}s(he,"detachToBackground");async function C(e){const n=await m(e);return n===null||n.streaming===!0&&h(n.pi_pid)?!1:!await Q(n.pi_session_file)}s(C,"isEmptyNode");async function re(e,n,a=!0){return(await m(e))?.managed_worktree?.state==="open"||!await C(e)?!1:(a&&k.teardown(e),await E(e,n),(await R(e)).deleted)}s(re,"reapIfEmpty");async function ge(e={}){const n=e.dryRun??!1,a=$()??"",i=[];for(const c of await M()){const o=c.node_id,r=await m(o);o===a||c.status==="dead"||h(c.pi_pid)||r?.managed_worktree?.state==="open"||!await C(o)||!n&&(await U(o,"notice.close",`Child closed \u2014 ${r?.name??o} (${o}) was closed from the canvas and is no longer running.`,{reason:"child-closed",child:o}),k.teardown(o),await E(o),!(await R(o)).deleted)||i.push(o)}return i}s(ge,"reapEmptyNodes");export{Re as breakPane,Xe as closePane,$e as currentTmux,he as detachToBackground,je as displayPopup,Be as ensureSession,xe as focus,te as focusByPane,w as focusOf,Se as focusWindow,_e as focusedNodes,De as getPaneOption,He as inTmux,nn as installTmuxBindings,ve as isFocused,se as listFocuses,Ze as listLivePanes,Ie as listLivePanesAsync,Ae as openNodeWindow,A as openViewerWindow,Ve as paneCurrentPath,Ce as paneExists,Ee as paneLocation,Me as paneOfNode,Ke as paneOfWindow,Le as paneRunning,Je as piCommand,ge as reapEmptyNodes,re as reapIfEmpty,b as registerViewerFocus,Ge as renameWindow,Ue as respawnPaneSync,Te as selectLayout,ke as selectPane,We as selectWindow,ze as setPaneOption,Qe as shellQuote,Oe as splitWindow,be as switchClient,E as tearDownNode,Ye as windowAlive,qe as windowOfPane};

package/dist/core/runtime/promote.d.ts

@@ -22,7 +22,7 @@ type ReshapeOptions = {
     profileId?: string | null;
 };
 /** Synchronous reshape for CLI callers outside the daemon. */
-export declare function reshapeNode(nodeId: string, opts?: ReshapeOptions, beforePersist?: () => void): NodeMeta;
+export declare function reshapeNode(nodeId: string, opts?: ReshapeOptions, beforePersist?: () => void): Promise<NodeMeta>;
 /** Daemon-safe reshape: network-backed config resolution happens off its event loop. */
 export declare function reshapeNodeAsync(nodeId: string, opts?: ReshapeOptions, beforePersist?: () => void): Promise<NodeMeta>;
 /** Promote a node to an orchestrator (mode→orchestrator), optionally
@@ -36,7 +36,7 @@ export declare function promote(nodeId: string, opts?: {
     kind?: string;
     resident?: boolean;
     model?: string;
-}): PromoteResult;
+}): Promise<PromoteResult>;
 /** Daemon-safe promotion variant; preserves the same validation/seed ordering. */
 export declare function promoteAsync(nodeId: string, opts?: {
     kind?: string;
@@ -72,5 +72,5 @@ export declare function requestYield(nodeId: string, opts?: {
     promote?: boolean;
 }, deps?: {
     ensure?: () => void;
-}): YieldResult;
+}): Promise<YieldResult>;
 export {};

package/dist/core/runtime/promote.js

@@ -1 +1 @@
-var g=Object.defineProperty;var l=(n,e)=>g(n,"name",{value:e,configurable:!0});import{getNode as m,updateNode as x}from"../canvas/index.js";import{transition as E}from"./lifecycle.js";import{ensureDaemon as R}from"../../daemon/manage.js";import{buildLaunchSpec as $,buildLaunchSpecAsync as A}from"./launch.js";import{ensureRoadmap as u,hasRoadmap as f,roadmapRef as t}from"./roadmap.js";import{readGoal as c,goalPath as k}from"./kickoff.js";function h(n,e){const d=m(n);if(d===null)throw new Error(`unknown node: ${n}`);const i=e.kind??d.kind,o=e.mode??d.mode,r=e.lifecycle??d.lifecycle,a=e.profileId===void 0?d.profile_id??null:e.profileId;return{node:d,kind:i,mode:o,lifecycle:r,profileId:a,launchOpts:{lifecycle:r,hasManager:d.parent!==null,model:e.model??d.model_override??void 0,modelOverride:e.model!==void 0,modelIntent:e.model===void 0?d.launch?.modelIntent:void 0,modelExact:e.model===void 0?d.launch?.modelExact:void 0,cwd:d.cwd,profileId:a}}}l(h,"reshapeInputs");function w(n,e,d,i,o){o?.();const r=d.node.name===d.node.kind&&d.kind!==d.node.kind;return x(n,{kind:d.kind,mode:d.mode,lifecycle:d.lifecycle,profile_id:d.profileId,launch:i,...r?{name:d.kind}:{},...e.model!==void 0?{model_override:i?.model??e.model}:{}})}l(w,"persistReshape");function s(n,e={},d){const i=h(n,e);return w(n,e,i,$(i.kind,i.mode,i.launchOpts).launch,d)}l(s,"reshapeNode");async function y(n,e={},d){const i=h(n,e),{launch:o}=await A(i.kind,i.mode,i.launchOpts);return w(n,e,i,o,d)}l(y,"reshapeNodeAsync");function N(n,e={}){const d=m(n);if(d===null)throw new Error(`unknown node: ${n}`);let i=!1;return{meta:s(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{},mode:"orchestrator",lifecycle:e.resident===!0?"resident":d.lifecycle},()=>{if(!f(n)){const r=c(n);i=u(n,r!==null&&r.trim()!==""?{goal:r.trim()}:{})}}),roadmapWritten:i,roadmapRef:t(n),goalPath:k(n)}}l(N,"promote");async function O(n,e={}){const d=m(n);if(d===null)throw new Error(`unknown node: ${n}`);let i=!1;return{meta:await y(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{},mode:"orchestrator",lifecycle:e.resident===!0?"resident":d.lifecycle},()=>{if(!f(n)){const r=c(n);i=u(n,r!==null&&r.trim()!==""?{goal:r.trim()}:{})}}),roadmapWritten:i,roadmapRef:t(n),goalPath:k(n)}}l(O,"promoteAsync");async function Y(n,e={},d={}){if(m(n)===null)throw new Error(`unknown node: ${n}`);return e.promote===!0?await O(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{}}):(e.kind!==void 0||e.model!==void 0)&&await y(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{}}),{..._(n,{},d),promoted:e.promote===!0}}l(Y,"requestYieldAsync");function _(n,e={},d={}){const i=d.ensure??R;if(m(n)===null)throw new Error(`unknown node: ${n}`);const r=e.kind!==void 0||e.model!==void 0;let a=!1;return e.promote===!0?(N(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{}}),a=!0):r&&s(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{}}),i(),E(n,"yield"),{meta:m(n),promoted:a,willRefresh:!0}}l(_,"requestYield");export{N as promote,O as promoteAsync,_ as requestYield,Y as requestYieldAsync,s as reshapeNode,y as reshapeNodeAsync};
+var g=Object.defineProperty;var r=(n,e)=>g(n,"name",{value:e,configurable:!0});import{getNode as o,updateNode as x}from"../canvas/index.js";import{transition as E}from"./lifecycle.js";import{ensureDaemon as R}from"../../daemon/manage.js";import{buildLaunchSpec as $,buildLaunchSpecAsync as A}from"./launch.js";import{ensureRoadmap as m,hasRoadmap as c,roadmapRef as u}from"./roadmap.js";import{readGoal as f,goalPath as w}from"./kickoff.js";async function k(n,e){const i=await o(n);if(i===null)throw new Error(`unknown node: ${n}`);const a=e.kind??i.kind,l=e.mode??i.mode,d=e.lifecycle??i.lifecycle,t=e.profileId===void 0?i.profile_id??null:e.profileId;return{node:i,kind:a,mode:l,lifecycle:d,profileId:t,launchOpts:{lifecycle:d,hasManager:i.parent!==null,model:e.model??i.model_override??void 0,modelOverride:e.model!==void 0,modelIntent:e.model===void 0?i.launch?.modelIntent:void 0,modelExact:e.model===void 0?i.launch?.modelExact:void 0,cwd:i.cwd,profileId:t}}}r(k,"reshapeInputs");async function s(n,e,i,a,l){l?.();const d=i.node.name===i.node.kind&&i.kind!==i.node.kind;return await x(n,{kind:i.kind,mode:i.mode,lifecycle:i.lifecycle,profile_id:i.profileId,launch:a,...d?{name:i.kind}:{},...e.model!==void 0?{model_override:a?.model??e.model}:{}})}r(s,"persistReshape");async function h(n,e={},i){const a=await k(n,e);return await s(n,e,a,$(a.kind,a.mode,a.launchOpts).launch,i)}r(h,"reshapeNode");async function y(n,e={},i){const a=await k(n,e),{launch:l}=await A(a.kind,a.mode,a.launchOpts);return await s(n,e,a,l,i)}r(y,"reshapeNodeAsync");async function N(n,e={}){const i=await o(n);if(i===null)throw new Error(`unknown node: ${n}`);let a=!1;return{meta:await h(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{},mode:"orchestrator",lifecycle:e.resident===!0?"resident":i.lifecycle},async()=>{if(!await c(n)){const d=await f(n);a=await m(n,d!==null&&d.trim()!==""?{goal:d.trim()}:{})}}),roadmapWritten:a,roadmapRef:u(n),goalPath:await w(n)}}r(N,"promote");async function O(n,e={}){const i=await o(n);if(i===null)throw new Error(`unknown node: ${n}`);let a=!1;return{meta:await y(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{},mode:"orchestrator",lifecycle:e.resident===!0?"resident":i.lifecycle},async()=>{if(!await c(n)){const d=await f(n);a=await m(n,d!==null&&d.trim()!==""?{goal:d.trim()}:{})}}),roadmapWritten:a,roadmapRef:u(n),goalPath:await w(n)}}r(O,"promoteAsync");async function Y(n,e={},i={}){if(await o(n)===null)throw new Error(`unknown node: ${n}`);return e.promote===!0?await O(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{}}):(e.kind!==void 0||e.model!==void 0)&&await y(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{}}),{...await _(n,{},i),promoted:e.promote===!0}}r(Y,"requestYieldAsync");async function _(n,e={},i={}){const a=i.ensure??R;if(await o(n)===null)throw new Error(`unknown node: ${n}`);const d=e.kind!==void 0||e.model!==void 0;let t=!1;return e.promote===!0?(await N(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{}}),t=!0):d&&await h(n,{...e.kind!==void 0?{kind:e.kind}:{},...e.model!==void 0?{model:e.model}:{}}),a(),await E(n,"yield"),{meta:await o(n),promoted:t,willRefresh:!0}}r(_,"requestYield");export{N as promote,O as promoteAsync,_ as requestYield,Y as requestYieldAsync,h as reshapeNode,y as reshapeNodeAsync};

package/dist/core/runtime/recycle.js

@@ -1 +1 @@
-var w=Object.defineProperty;var r=(e,t)=>w(e,"name",{value:t,configurable:!0});import{abortExecution as y,beginExecution as _,getNode as s,setPresence as h,setFocusOccupant as v,fullName as R,recordExecutionPid as b,recordLaunch as E}from"../canvas/index.js";import{pushFinal as k}from"../feed/feed.js";import{newestReportBody as g}from"../feed/reports.js";import{spawnNode as x,rootOfSpine as S}from"./nodes.js";import{buildLaunchSpecAsync as T,buildPiArgv as B}from"./launch.js";import{focusOf as N,respawnPaneSync as O,setPaneOption as P}from"./placement.js";import{waitForBrokerViewSocket as C,viewerSplitEnv as D}from"./placement-tmux.js";import{headlessBrokerHost as u}from"./host.js";import{boundFleet as F}from"./fleet.js";import{transition as z}from"./lifecycle.js";import{ensureDaemon as A}from"../../daemon/manage.js";import{invokeBirthLifecycleHooks as L}from"./spawn.js";async function ne(e,t){const n=s(e);if(n===null)return{recycled:!1,finalized:!1,newRoot:null,delivered:[]};const o=t??process.env.TMUX_PANE;if(o===void 0||o==="")return{recycled:!1,finalized:!1,newRoot:null,delivered:[]};const f=N(e);try{A()}catch{}const{launch:m}=await T("general","base",{lifecycle:"resident",hasManager:!1,cwd:n.cwd,profileId:n.profile_id}),p=g(e)||`Closed via recycle \u2014 no final summary was authored by ${n.name}.`;let a=[],d=!1;const i=await x({kind:"general",mode:"base",lifecycle:"resident",cwd:n.cwd,name:"general",parent:null,replaces:e,profile_id:n.profile_id,launch:m,beforeCreate:r(async()=>{try{a=(await k(e,p)).deliveredTo,d=!0}catch{}},"beforeCreate")}),c=s(i.node_id);await L(c);const l=B(c);if(l.env={...l.env,CRTR_SUBTREE:S(i.node_id)},!await U(c,l))return{recycled:!1,finalized:d,newRoot:i.node_id,delivered:a};try{u.teardown(e)}catch{}try{h(e,{pane:null,window:null,tmux_session:null})}catch{}if(f!==null)try{v(f.focus_id,i.node_id)}catch{}return{recycled:M(c,o),finalized:d,newRoot:i.node_id,delivered:a}}r(ne,"recycleNode");async function U(e,t){const n=_(e.node_id,{daemonEpoch:F().epoch()});t.env={...t.env,CRTR_EXECUTION_ID:n};let o;try{if(o=await u.launch(e.node_id,t,{cwd:e.cwd,name:R(e),resuming:!1}),o.pid===null)throw new Error("broker host returned no pid");if(E(e.node_id,new Date().toISOString()),b(n,e.node_id,o.pid)==="shutdown")throw new Error("broker execution was superseded");if(await C(e.node_id,o.exited))return!0}catch{y(n,{reason:"launch_failed"})}try{H(e.node_id)}catch{}try{u.teardown(e.node_id)}catch{}return!1}r(U,"launchRecycledBroker");function H(e){const t=s(e);(t?.status==="active"||t?.status==="idle")&&z(e,"crash")}r(H,"transitionReplacementToDead");function M(e,t){try{P(t,"@crtr_node","")}catch{}return O({pane:t,cwd:e.cwd,env:D(),command:`crtr surface attach to ${e.node_id}`})}r(M,"respawnRecycledViewer");export{ne as recycleNode};
+var p=Object.defineProperty;var n=(e,t)=>p(e,"name",{value:t,configurable:!0});import{abortExecution as y,beginExecution as _,getNode as s,setPresence as h,setFocusOccupant as v,fullName as R,recordExecutionPid as b,recordLaunch as E}from"../canvas/index.js";import{pushFinal as k}from"../feed/feed.js";import{newestReportBody as g}from"../feed/reports.js";import{spawnNode as x,rootOfSpine as S}from"./nodes.js";import{buildLaunchSpecAsync as T,buildPiArgv as B}from"./launch.js";import{focusOf as N,respawnPaneSync as O,setPaneOption as P}from"./placement.js";import{waitForBrokerViewSocket as C,viewerSplitEnv as D}from"./placement-tmux.js";import{headlessBrokerHost as u}from"./host.js";import{boundFleet as F}from"./fleet.js";import{transition as z}from"./lifecycle.js";import{ensureDaemon as A}from"../../daemon/manage.js";import{invokeBirthLifecycleHooks as L}from"./spawn.js";async function ae(e,t){const a=await s(e);if(a===null)return{recycled:!1,finalized:!1,newRoot:null,delivered:[]};const o=t??process.env.TMUX_PANE;if(o===void 0||o==="")return{recycled:!1,finalized:!1,newRoot:null,delivered:[]};const w=await N(e);try{A()}catch{}const{launch:f}=await T("general","base",{lifecycle:"resident",hasManager:!1,cwd:a.cwd,profileId:a.profile_id}),m=await g(e)||`Closed via recycle \u2014 no final summary was authored by ${a.name}.`;let c=[],d=!1;const r=await x({kind:"general",mode:"base",lifecycle:"resident",cwd:a.cwd,name:"general",parent:null,replaces:e,profile_id:a.profile_id,launch:f,beforeCreate:n(async()=>{try{c=(await k(e,m)).deliveredTo,d=!0}catch{}},"beforeCreate")}),i=await s(r.node_id);await L(i);const l=B(i);if(l.env={...l.env,CRTR_SUBTREE:await S(r.node_id)},!await U(i,l))return{recycled:!1,finalized:d,newRoot:r.node_id,delivered:c};try{u.teardown(e)}catch{}try{await h(e,{pane:null,window:null,tmux_session:null})}catch{}if(w!==null)try{await v(w.focus_id,r.node_id)}catch{}return{recycled:M(i,o),finalized:d,newRoot:r.node_id,delivered:c}}n(ae,"recycleNode");async function U(e,t){const a=await _(e.node_id,{daemonEpoch:F().epoch()});t.env={...t.env,CRTR_EXECUTION_ID:a};let o;try{if(o=await u.launch(e.node_id,t,{cwd:e.cwd,name:R(e),resuming:!1}),o.pid===null)throw new Error("broker host returned no pid");if(await E(e.node_id,new Date().toISOString()),await b(a,e.node_id,o.pid)==="shutdown")throw new Error("broker execution was superseded");if(await C(e.node_id,o.exited))return!0}catch{await y(a,{reason:"launch_failed"})}try{await H(e.node_id)}catch{}try{u.teardown(e.node_id)}catch{}return!1}n(U,"launchRecycledBroker");async function H(e){const t=await s(e);(t?.status==="active"||t?.status==="idle")&&await z(e,"crash")}n(H,"transitionReplacementToDead");function M(e,t){try{P(t,"@crtr_node","")}catch{}return O({pane:t,cwd:e.cwd,env:D(),command:`crtr surface attach to ${e.node_id}`})}n(M,"respawnRecycledViewer");export{ae as recycleNode};

package/dist/core/runtime/reopen.d.ts

@@ -2,14 +2,14 @@
  *  `final_report` fresh — never a caller-supplied snapshot. Throws
  *  `node_finalized` when latched; otherwise a no-op (the common case). No
  *  side effect either way. */
-export declare function assertNotFinalized(nodeId: string): void;
+export declare function assertNotFinalized(nodeId: string): Promise<void>;
 /** Validate a target IS latched (the `--reopen` doorway) and return the exact
  *  `final_report` value observed, so the caller can CAS-clear it later via
  *  `commitReopen` — once every OTHER fallible precondition the requested
  *  operation needs has already passed (e.g. `--fresh`'s recoverable-state
  *  check). Throws `not_finalized` when the target has nothing to clear. Pure
  *  read — never mutates. */
-export declare function assertFinalizedForReopen(nodeId: string): string;
+export declare function assertFinalizedForReopen(nodeId: string): Promise<string>;
 /** Clear `nodeId`'s finalization latch — retract-pointer-only (only
  *  `final_report`/`finalized_at`; the report file and every delivered feed
  *  event are untouched). CAS'd against `expectedFinalReport` (the value the
@@ -19,20 +19,31 @@ export declare function assertFinalizedForReopen(nodeId: string): string;
  *  this throws `reopen_latch_changed` instead of silently clobbering a newer
  *  canonical result. Callers MUST NOT proceed to revive/deliver when this
  *  throws. */
-export declare function commitReopen(nodeId: string, expectedFinalReport: string): void;
-/** Commit the wider message-delivery reopen: make the node resident, then
+export declare function commitReopen(nodeId: string, expectedFinalReport: string): Promise<void>;
+/** Commit the wider message-delivery reopen: settle the node's lifecycle, then
  * retract a final latch when one exists. Unlike the revive/fresh gate, an
- * unlatched node is valid here — it still becomes resident. Writing lifecycle
- * first leaves a failed latch CAS with the canonical-final pointer intact.
- * Both writes finish before either delivery channel begins. */
-export declare function commitReopenResident(nodeId: string, expectedFinalReport?: string): string | null;
+ * unlatched node is valid here.
+ *
+ * Lifecycle rule: resident is for a node with no manager to report to (an app
+ * or person conversation, e.g. a hosted SMS thread reopened by a new text), so
+ * a reopen by a person, an app run, or a node that is not the target's manager
+ * makes the target resident. When `callerNodeId` is a node that is a tree
+ * subscriber of the target (its parent/manager re-tasking its own child), the
+ * target keeps its current lifecycle: a terminal child stays terminal and keeps
+ * owing a final report, which is what wakes the manager. Either way the final
+ * latch is cleared and a done/canceled/dead row returns to active.
+ *
+ * Writing lifecycle first leaves a failed latch CAS with the canonical-final
+ * pointer intact. Both writes finish before either delivery channel begins. */
+export declare function commitReopenResident(nodeId: string, expectedFinalReport?: string, callerNodeId?: string | null): Promise<string | null>;
 /** Convenience wrapper for a doorway with NO intervening fallible step between
  *  the gate check and the reopen clear (`node lifecycle revive` has nothing
  *  fallible between the gate and `reviveNode`). Validates and, when `reopen`,
  *  clears in one call.
  *
  *  - `reopen` false + latched → throws `node_finalized`.
- *  - `reopen` true + latched → makes the node resident and CAS-clears the latch (side effect) and returns.
+ *  - `reopen` true + latched → settles lifecycle per `commitReopenResident` (resident, unless `callerNodeId` is the target's manager),
+ *    CAS-clears the latch (side effect) and returns.
  *  - `reopen` true + not latched → throws `not_finalized`.
  *  - `reopen` false + not latched → no-op (the common case). */
-export declare function assertReopenGate(nodeId: string, reopen: boolean): void;
+export declare function assertReopenGate(nodeId: string, reopen: boolean, callerNodeId?: string | null): Promise<void>;

package/dist/core/runtime/reopen.js

@@ -1 +1 @@
-var s=Object.defineProperty;var n=(e,t)=>s(e,"name",{value:t,configurable:!0});import{clearFinalReportIfMatches as l,getFinalReport as c,getNode as p,updateNode as u}from"../canvas/index.js";import{InputError as i}from"../io.js";import{transition as f}from"./lifecycle.js";import{noticeChangedWhileDone as h}from"./ledger.js";function o(e){return c(e)}n(o,"currentFinalReport");function m(e,t){throw new i({error:"node_finalized",message:`${e} already submitted its canonical final result (\`crtr canvas read ${e}/${t}\`) \u2014 reviving it now would hand it a mandate it can never finish, since a second \`push final\` always errors against an already-latched node.`,next:`Re-run this exact command with --reopen to clear ${e}'s spent latch and re-task it in place.`})}n(m,"throwNodeFinalized");function d(e){throw new i({error:"not_finalized",message:`${e} is not finalized \u2014 --reopen has nothing to clear.`,next:"Drop --reopen."})}n(d,"throwNotFinalized");function w(e){const t=o(e);t!==null&&m(e,t)}n(w,"assertNotFinalized");function g(e){const t=o(e);return t===null&&d(e),t}n(g,"assertFinalizedForReopen");function R(e,t){if(!l(e,t))throw new i({error:"reopen_latch_changed",message:`${e}'s finalization latch changed since it was last inspected \u2014 a concurrent --reopen (or a fresh push final) already moved it, so clearing it now would risk erasing a newer canonical result.`,next:"Re-run this exact command \u2014 it will re-inspect the current state before acting."})}n(R,"commitReopen");function x(e,t){const r=o(e);u(e,{lifecycle:"resident"});const a=p(e);return a!==null&&(a.status==="done"||a.status==="canceled"||a.status==="dead")&&(a.status==="done"&&a.last_settled_at!=null&&h(e,a.last_settled_at),f(e,"revive")),r!==null&&R(e,t??r),r}n(x,"commitReopenResident");function y(e,t){if(t){const r=g(e);x(e,r);return}w(e)}n(y,"assertReopenGate");export{g as assertFinalizedForReopen,w as assertNotFinalized,y as assertReopenGate,R as commitReopen,x as commitReopenResident};
+var c=Object.defineProperty;var a=(t,e)=>c(t,"name",{value:e,configurable:!0});import{clearFinalReportIfMatches as l,getFinalReport as f,getNode as u,updateNode as p}from"../canvas/index.js";import{subscribersOf as w}from"../canvas/tree.js";import{InputError as o}from"../io.js";import{transition as m}from"./lifecycle.js";import{noticeChangedWhileDone as h}from"./ledger.js";async function s(t){return await f(t)}a(s,"currentFinalReport");function d(t,e){throw new o({error:"node_finalized",message:`${t} already submitted its canonical final result (\`crtr canvas read ${t}/${e}\`) \u2014 reviving it now would hand it a mandate it can never finish, since a second \`push final\` always errors against an already-latched node.`,next:`Re-run this exact command with --reopen to clear ${t}'s spent latch and re-task it in place.`})}a(d,"throwNodeFinalized");function g(t){throw new o({error:"not_finalized",message:`${t} is not finalized \u2014 --reopen has nothing to clear.`,next:"Drop --reopen."})}a(g,"throwNotFinalized");async function R(t){const e=await s(t);e!==null&&d(t,e)}a(R,"assertNotFinalized");async function y(t){const e=await s(t);return e===null&&g(t),e}a(y,"assertFinalizedForReopen");async function x(t,e){if(!await l(t,e))throw new o({error:"reopen_latch_changed",message:`${t}'s finalization latch changed since it was last inspected \u2014 a concurrent --reopen (or a fresh push final) already moved it, so clearing it now would risk erasing a newer canonical result.`,next:"Re-run this exact command \u2014 it will re-inspect the current state before acting."})}a(x,"commitReopen");async function F(t,e){return t==null?!1:(await w(e)).some(i=>i.node_id===t)}a(F,"isManagerOf");async function _(t,e,i){const r=await s(t);await F(i,t)||await p(t,{lifecycle:"resident"});const n=await u(t);return n!==null&&(n.status==="done"||n.status==="canceled"||n.status==="dead")&&(n.status==="done"&&n.last_settled_at!=null&&await h(t,n.last_settled_at),await m(t,"revive")),r!==null&&await x(t,e??r),r}a(_,"commitReopenResident");async function D(t,e,i){if(e){const r=await y(t);await _(t,r,i);return}await R(t)}a(D,"assertReopenGate");export{y as assertFinalizedForReopen,R as assertNotFinalized,D as assertReopenGate,x as commitReopen,_ as commitReopenResident};

package/dist/core/runtime/reset.d.ts

@@ -11,7 +11,7 @@ import { respawnPaneSync } from './placement.js';
  *  explicit: an abrupt broker teardown fires NO clean `session_shutdown`, so the
  *  general quit→done rule does NOT auto-resolve a force-killed descendant — we
  *  mark it `canceled` here via the same `cancel` event the close cascade uses. */
-export declare function reapDescendants(rootId: string): string[];
+export declare function reapDescendants(rootId: string): Promise<string[]>;
 /** Injectable host/viewer seam, so the ordinary source test drives relaunchRoot's pure
  *  DB transitions without a real broker or tmux. Each field defaults to its
  *  production verb. */
@@ -51,7 +51,7 @@ export interface ResetRootResult {
  *  `--session <id>` wakes the right conversation. A `/new` on a child is NOT a
  *  graph reset — a root's `/new` is handled by relaunchRoot, never here; a root
  *  that reaches this is a no-op. */
-export declare function resetRoot(nodeId: string, newSessionId?: string, newSessionFile?: string | null): ResetRootResult;
+export declare function resetRoot(nodeId: string, newSessionId?: string, newSessionFile?: string | null): Promise<ResetRootResult>;
 export type HandleNewSessionPath = 'reset-child' | 'noop';
 export interface HandleNewSessionResult {
     path: HandleNewSessionPath;
@@ -59,10 +59,10 @@ export interface HandleNewSessionResult {
 /** The child-side `/new` entry the stophook calls (the root side goes to
  *  relaunchRoot directly). The broker already drove the engine-side new_session;
  *  this only refreshes the child's session id on the SAME node id. */
-export declare function handleNewSession(nodeId: string, newSessionId: string, newSessionFile?: string | null): HandleNewSessionResult;
+export declare function handleNewSession(nodeId: string, newSessionId: string, newSessionFile?: string | null): Promise<HandleNewSessionResult>;
 /** Resolve a cleanly-exiting node to `done`. Returns true iff it transitioned.
  *  Guard: only a real quit, and only a node still active|idle with no pending
  *  intent — so it never clobbers a node already routed by agent_end to done
  *  (push final), refresh (yield), or idle-release. Pure/DB-only (no pi/tmux) so
  *  the guard is unit-testable without a live pi. */
-export declare function markCleanExitDone(nodeId: string, reason: unknown): boolean;
+export declare function markCleanExitDone(nodeId: string, reason: unknown): Promise<boolean>;

package/dist/core/runtime/reset.js

@@ -1 +1 @@
-var S=Object.defineProperty;var l=(e,t)=>S(e,"name",{value:t,configurable:!0});import{getNode as p,beginExecution as B,recordExecutionPid as N,abortExecution as k,bindSession as b,recordLaunch as g,fullName as x,liveExecutionForNode as F,closeFocusRow as R,view as O}from"../canvas/index.js";import{transition as a}from"./lifecycle.js";import{headlessBrokerHost as y,requestBrokerTeardown as V}from"./host.js";import{boundFleet as C}from"./fleet.js";import{tearDownNode as D,focusOf as P,registerViewerFocus as T,respawnPaneSync as I,windowOfPane as L,renameWindow as q}from"./placement.js";import{viewerSplitEnv as A,waitForBrokerViewSocket as H}from"./placement-tmux.js";import{buildLaunchSpecAsync as M,buildPiArgv as U}from"./launch.js";import{newNodeId as j,spawnNode as W,rootOfSpine as X}from"./nodes.js";import{appSpace as $}from"../layout.js";import{join as z}from"node:path";import{invokeBirthLifecycleHooks as G}from"./spawn.js";function J(e){const t=[];for(const r of O(e))try{a(r,"cancel",{reason:"closed"}),V(r),D(r),t.push(r)}catch{}return t}l(J,"reapDescendants");async function le(e,t={}){const r=t.launchBroker??y.launch,s=t.waitForViewSocket??H,m=t.respawnViewer??I,c=t.teardownBroker??y.teardown,o=p(e);if(o===null||o.parent!=null||o.status==="done")return null;const d=P(e),h=o.isolated?j():void 0,_=h?z($(o.grantee??"app:terminal").nodes,h):o.cwd,{launch:E}=await M(o.kind,"base",{lifecycle:"resident",hasManager:!1,model:o.model_override??void 0,modelIntent:o.launch?.modelIntent,modelExact:o.launch?.modelExact,cwd:_,profileId:o.profile_id}),n=await W({nodeId:h,kind:o.kind,mode:"base",lifecycle:"resident",cwd:_,name:o.kind,parent:null,replaces:e,profile_id:o.profile_id,launch:E,modelOverride:o.model_override??void 0});await G(n);const u=U(n,{});u.env={...u.env,CRTR_SUBTREE:X(n.node_id)};const f=B(n.node_id,{daemonEpoch:C().epoch()});u.env={...u.env,CRTR_EXECUTION_ID:f};let w;try{w=await r(n.node_id,u,{cwd:_,name:x(n),resuming:!1})}catch(i){throw k(f,{reason:"launch_failed"}),a(n.node_id,"crash"),i}if(w.pid==null)return k(f,{reason:"launch_failed"}),a(n.node_id,"crash"),null;if(g(n.node_id,new Date().toISOString()),N(f,n.node_id,w.pid)==="shutdown"){k(f,{reason:"superseded"});try{c(n.node_id)}catch{}return a(n.node_id,"crash"),null}let v=!1;try{v=await s(n.node_id,w.exited)}catch{}if(!v){const i=p(n.node_id);(i?.status==="active"||i?.status==="idle")&&a(n.node_id,"crash");try{c(n.node_id)}catch{}return null}if(J(e),a(e,"finish"),d?.pane!=null){R(d.focus_id),m({pane:d.pane,cwd:o.cwd,env:A(),command:`crtr surface attach to ${n.node_id}`});const i=L(d.pane);i!==null&&q(i,x(n)),T(n.node_id,d.pane,d.session,i)}return c(e),{newNodeId:n.node_id}}l(le,"relaunchRoot");function K(e,t,r){const s=p(e),m={reaped:[],detached:[],reset:!1};if(s===null||s.parent==null)return m;if(t!==void 0){const c=F(e);c!==null&&b(e,{executionId:c.executionId,sessionId:t,transcriptPath:r??null})}return m}l(K,"resetRoot");function se(e,t,r){return p(e)===null?{path:"noop"}:(K(e,t,r),{path:"reset-child"})}l(se,"handleNewSession");function ue(e,t){if(t!=="quit")return!1;const r=p(e);return r===null||r.status!=="active"&&r.status!=="idle"||r.intent!=null?!1:(a(e,"finish"),!0)}l(ue,"markCleanExitDone");export{se as handleNewSession,ue as markCleanExitDone,J as reapDescendants,le as relaunchRoot,K as resetRoot};
+var S=Object.defineProperty;var s=(e,t)=>S(e,"name",{value:t,configurable:!0});import{getNode as f,beginExecution as B,recordExecutionPid as N,abortExecution as v,bindSession as b,recordLaunch as g,fullName as x,liveExecutionForNode as F,closeFocusRow as R,view as O}from"../canvas/index.js";import{transition as r}from"./lifecycle.js";import{headlessBrokerHost as y,requestBrokerTeardown as V}from"./host.js";import{boundFleet as C}from"./fleet.js";import{tearDownNode as D,focusOf as P,registerViewerFocus as T,respawnPaneSync as I,windowOfPane as L,renameWindow as q}from"./placement.js";import{viewerSplitEnv as A,waitForBrokerViewSocket as H}from"./placement-tmux.js";import{buildLaunchSpecAsync as M,buildPiArgv as U}from"./launch.js";import{newNodeId as j,spawnNode as W,rootOfSpine as X}from"./nodes.js";import{appSpace as $}from"../layout.js";import{join as z}from"node:path";import{invokeBirthLifecycleHooks as G}from"./spawn.js";async function J(e){const t=[];for(const i of await O(e))try{await r(i,"cancel",{reason:"closed"}),V(i),await D(i),t.push(i)}catch{}return t}s(J,"reapDescendants");async function se(e,t={}){const i=t.launchBroker??y.launch,l=t.waitForViewSocket??H,p=t.respawnViewer??I,c=t.teardownBroker??y.teardown,a=await f(e);if(a===null||a.parent!=null||a.status==="done")return null;const d=await P(e),h=a.isolated?await j():void 0,_=h?z($(a.grantee??"app:terminal").nodes,h):a.cwd,{launch:E}=await M(a.kind,"base",{lifecycle:"resident",hasManager:!1,model:a.model_override??void 0,modelIntent:a.launch?.modelIntent,modelExact:a.launch?.modelExact,cwd:_,profileId:a.profile_id}),n=await W({nodeId:h,kind:a.kind,mode:"base",lifecycle:"resident",cwd:_,name:a.kind,parent:null,replaces:e,profile_id:a.profile_id,launch:E,modelOverride:a.model_override??void 0});await G(n);const u=U(n,{});u.env={...u.env,CRTR_SUBTREE:await X(n.node_id)};const w=await B(n.node_id,{daemonEpoch:C().epoch()});u.env={...u.env,CRTR_EXECUTION_ID:w};let m;try{m=await i(n.node_id,u,{cwd:_,name:x(n),resuming:!1})}catch(o){throw await v(w,{reason:"launch_failed"}),await r(n.node_id,"crash"),o}if(m.pid==null)return await v(w,{reason:"launch_failed"}),await r(n.node_id,"crash"),null;if(await g(n.node_id,new Date().toISOString()),await N(w,n.node_id,m.pid)==="shutdown"){await v(w,{reason:"superseded"});try{c(n.node_id)}catch{}return await r(n.node_id,"crash"),null}let k=!1;try{k=await l(n.node_id,m.exited)}catch{}if(!k){const o=await f(n.node_id);(o?.status==="active"||o?.status==="idle")&&await r(n.node_id,"crash");try{c(n.node_id)}catch{}return null}if(await J(e),await r(e,"finish"),d?.pane!=null){await R(d.focus_id),p({pane:d.pane,cwd:a.cwd,env:A(),command:`crtr surface attach to ${n.node_id}`});const o=L(d.pane);o!==null&&q(o,x(n)),await T(n.node_id,d.pane,d.session,o)}return c(e),{newNodeId:n.node_id}}s(se,"relaunchRoot");async function K(e,t,i){const l=await f(e),p={reaped:[],detached:[],reset:!1};if(l===null||l.parent==null)return p;if(t!==void 0){const c=await F(e);c!==null&&await b(e,{executionId:c.executionId,sessionId:t,transcriptPath:i??null})}return p}s(K,"resetRoot");async function le(e,t,i){return await f(e)===null?{path:"noop"}:(await K(e,t,i),{path:"reset-child"})}s(le,"handleNewSession");async function ue(e,t){if(t!=="quit")return!1;const i=await f(e);return i===null||i.status!=="active"&&i.status!=="idle"||i.intent!=null?!1:(await r(e,"finish"),!0)}s(ue,"markCleanExitDone");export{le as handleNewSession,ue as markCleanExitDone,J as reapDescendants,se as relaunchRoot,K as resetRoot};

package/dist/core/runtime/revive-all.d.ts

@@ -35,7 +35,7 @@ export declare function isDisconnected(meta: NodeMeta, isAlive: (pid: number | n
 /** Every disconnected node on the canvas — the set a revive-all WOULD relaunch.
  *  This is the PREVIEW: it has no side effects, so the command can list the
  *  candidates and gate on confirmation before any engine is launched. */
-export declare function listDisconnected(): NodeMeta[];
+export declare function listDisconnected(): Promise<NodeMeta[]>;
 export interface ReviveAllResult {
     /** Node ids whose broker engine reviveAll relaunched (RESUME). */
     revived: string[];
@@ -54,4 +54,4 @@ export interface ReviveAllResult {
  *  no-op), so this is a thin orchestrator over `listDisconnected`: revive each
  *  with resume:true. One failing node never aborts the sweep — its error is
  *  collected and the rest proceed. */
-export declare function reviveAll(include?: (meta: NodeMeta) => boolean): Promise<ReviveAllResult>;
+export declare function reviveAll(include?: (meta: NodeMeta) => Promise<boolean>): Promise<ReviveAllResult>;

package/dist/core/runtime/revive-all.js

@@ -1 +1 @@
-var t=Object.defineProperty;var n=(e,r)=>t(e,"name",{value:r,configurable:!0});import{listNodes as s,getNode as u}from"../canvas/index.js";import{recordedPidLiveness as d}from"../canvas/pid.js";import{reviveNode as f}from"./revive.js";const l=["done","canceled"];function c(e){return e.frozen_at==null&&(e.final_report!=null||l.includes(e.status))}n(c,"hasNoNaturalCycle");function p(e,r){return!(e.kind==="human"||r(e.pi_pid)||e.pi_session_id==null&&e.pi_session_file==null||c(e))}n(p,"isDisconnected");function a(){const e=[];for(const r of s()){const o=u(r.node_id);o!==null&&p(o,i=>d(i,o.pi_pid_identity)==="alive")&&e.push(o)}return e}n(a,"listDisconnected");async function y(e=()=>!0){const r={revived:[],failed:[],frozen:[]};for(const o of a().filter(e))try{(await f(o.node_id,{resume:!0,recovery:!0,capacity:"freeze"})).outcome==="frozen"?r.frozen.push(o.node_id):r.revived.push(o.node_id)}catch(i){r.failed.push({node_id:o.node_id,error:i.message})}return r}n(y,"reviveAll");export{l as TERMINAL_BY_CHOICE,c as hasNoNaturalCycle,p as isDisconnected,a as listDisconnected,y as reviveAll};
+var t=Object.defineProperty;var i=(e,r)=>t(e,"name",{value:r,configurable:!0});import{listNodes as s,getNode as u}from"../canvas/index.js";import{recordedPidLiveness as c}from"../canvas/pid.js";import{reviveNode as d}from"./revive.js";import{filterAsync as f}from"../async-array.js";const l=["done","canceled"];function a(e){return e.frozen_at==null&&(e.final_report!=null||l.includes(e.status))}i(a,"hasNoNaturalCycle");function p(e,r){return!(e.kind==="human"||r(e.pi_pid)||e.pi_session_id==null&&e.pi_session_file==null||a(e))}i(p,"isDisconnected");async function _(){const e=[];for(const r of await s()){const o=await u(r.node_id);o!==null&&p(o,n=>c(n,o.pi_pid_identity)==="alive")&&e.push(o)}return e}i(_,"listDisconnected");async function N(e=async()=>!0){const r={revived:[],failed:[],frozen:[]};for(const o of await f(await _(),e))try{(await d(o.node_id,{resume:!0,recovery:!0,capacity:"freeze"})).outcome==="frozen"?r.frozen.push(o.node_id):r.revived.push(o.node_id)}catch(n){r.failed.push({node_id:o.node_id,error:n.message})}return r}i(N,"reviveAll");export{l as TERMINAL_BY_CHOICE,a as hasNoNaturalCycle,p as isDisconnected,_ as listDisconnected,N as reviveAll};

package/dist/core/runtime/revive.d.ts

@@ -21,16 +21,16 @@ import { headlessBrokerHost } from './host.js';
  *  branch (`--crtr-new-cycle`) rather than continuing the existing leaf. Pure
  *  so the decision is unit-testable without tmux or a real filesystem fixture
  *  beyond a temp file. */
-export declare function resumeArgs(meta: NodeMeta, resume: boolean): {
+export declare function resumeArgs(meta: NodeMeta, resume: boolean): Promise<{
     resumeSessionPath?: string;
     newCycle?: boolean;
-};
+}>;
 /** Whether a fresh context window would have anything on disk to stand on: a
  *  goal, a roadmap, or both. The negative is what makes a fresh cycle worse
  *  than a resume — the new window would wake amnesiac, with no statement of
  *  what it is for. Read by the parked-resident veto below and by the message
  *  handler's explicit fresh-revive gate. */
-export declare function hasFreshGroundState(nodeId: string): boolean;
+export declare function hasFreshGroundState(nodeId: string): Promise<boolean>;
 export interface ReviveResult {
     /** Always null — the broker engine is never placed in a tmux window. Kept on
      *  the result for caller back-compat. */
@@ -50,7 +50,7 @@ export interface ReviveResult {
      *  `beginBootFaultAttempt` at the exact clear-then-launch boundary below.
      *  Present only when a fresh launch actually happened (absent on the
      *  double-revive no-op, where nothing was cleared or relaunched). */
-    faultExplanation?: () => string | null;
+    faultExplanation?: () => Promise<string | null>;
     /** What this call actually did. `already-live` means a broker was already
      *  running for the node and nothing was launched; `frozen` means no slot was
      *  free and the row is now waiting for one — the tick thaws it. */

package/dist/core/runtime/revive.js

@@ -1,3 +1,3 @@
-var Y=Object.defineProperty;var l=(e,r)=>Y(e,"name",{value:r,configurable:!0});import{assertGranteeRunsHere as q}from"./unsandboxed.js";import{existsSync as B}from"node:fs";import{conversationIdFromPath as p,conversationStore as h,ConversationNotFoundError as O}from"../conversation-store/index.js";import{isAbsolute as Q}from"node:path";import{findNodeBySessionFile as Z,getNode as R,updateNode as E,beginExecution as I,recordExecutionPid as ee,abortExecution as S,endLiveExecution as re,unbindSession as T,recordLaunch as ie,setFrozen as ne,clearFrozen as te,fullName as D}from"../canvas/index.js";import{emitEvent as oe}from"../events/emit.js";import{cancelCronsOnWake as se}from"../canvas/crons.js";import{isParked as le,transition as x}from"./lifecycle.js";import{publishNotice as ce}from"./close.js";import{InputError as $}from"../io.js";import{buildPiArgv as v}from"./launch.js";import{buildReviveKickoff as ae,drainBearings as ue,hasRetainedReports as fe,readGoal as y,readYieldMessage as de,RUNTIME_RESTART_CONTINUATION as he}from"./kickoff.js";import{readRoadmap as z}from"./roadmap.js";import{encodeKickoffOrigin as pe,KICKOFF_ORIGIN_ENV as ve}from"./stamp/protocol.js";import{headlessBrokerHost as H}from"./host.js";import{appMemoryFull as me,appMemoryTooSmall as we,boundFleet as M,brokerCapReached as _e,brokerThresholdsForDaemon as U}from"./fleet.js";import{admitBrokerMemory as ke}from"./memory-admission.js";import{beginBootFaultAttempt as ye,clearFault as ge,hasAdmittedTurn as be}from"../canvas/recovery.js";import{clearNodeLedger as K,forkNodeLedger as Re,noticeChangedWhileDone as Ee}from"./ledger.js";import{forkSourceNode as Se,rootOfSpine as xe}from"./nodes.js";import{isReviewCompanionBound as $e}from"../review/companion.js";import{assertProfileActive as Ce}from"../profiles/manifest.js";import{isPidAlive as Ne}from"../canvas/pid.js";import{crtrHome as Fe,jobDir as Pe}from"../canvas/paths.js";import{contextDir as Ae,ensureNodeDirs as Be,nodeAgentDir as Oe}from"../canvas/node-agent-paths.js";import{discoverLifecycleHookRegistry as Te}from"../command-hooks/discovery.js";import{invokeLifecycleHooks as De}from"../command-hooks/transport/exec-lifecycle.js";function ze(e,r){const i=e.pi_session_file,n=i?p(i):null;if(n===null)return{};try{const t=h().header(n);return r?{resumeSessionPath:t.path}:{resumeSessionPath:t.path,newCycle:!0}}catch(t){if(t instanceof O)return{};throw t}}l(ze,"resumeArgs");function G(e){const r=p(e);if(r===null)return!1;try{return h().header(r),!0}catch(i){if(i instanceof O)return!1;throw i}}l(G,"conversationExists");function He(e){const r=p(e);return r===null?!0:h().read(r).entries.some(i=>i.type==="message")}l(He,"sessionHasConversation");function Me(e){const r=p(e);if(r===null)return!0;const i=h().header(r).header.cwd;return typeof i!="string"||B(i)}l(Me,"sessionCwdExists");function Ue(e,r,i){const n=r.pi_session_file;if(!n||!G(n))return{};const t=Z(n);return t!==null&&t.node_id!==e&&Ne(t.pi_pid)?{}:Me(n)?ze(r,i):{}}l(Ue,"resumableSessionArgs");function Ke(e){return z(e)===null&&de(e)===null&&!fe(e)}l(Ke,"isUnstartedBirth");function _r(e){const r=y(e);if(r!==null&&r.trim()!=="")return!0;const i=z(e);return i!==null&&i.trim()!==""}l(_r,"hasFreshGroundState");async function kr(e,r){const i=await L(e,r,!0);if(i.parked)throw new Error(`reviveNode: internal parked decision for activating revive ${e}`);return i.result}l(kr,"reviveNode");async function yr(e,r,i){return L(e,{...r,viewerAttach:!0},i)}l(yr,"decideAttachRevive");async function L(e,r,i){let n=R(e);if(n===null)throw new Error(`reviveNode: unknown node ${e}`);if(n=R(e)??n,n.run_id&&R(n.run_id)?.deleting_at)throw new Error("run is deleting");if(n.final_report!==null)throw new Error(`reviveNode: refusing to revive ${e} \u2014 its finalization latch is set (final_report=${n.final_report}). A final landed between the caller's reopen-gate check and this revive; re-run with --reopen if this retask is still wanted.`);Ce(n.profile_id),q(n.grantee);const t=M();if(t.has(e))return x(e,n.intent==="refresh"?"refresh-launch":"revive"),{parked:!1,result:{window:null,session:n.tmux_session??null,resumed:!1,outcome:"already-live"}};if(t.isClaimed(e))return{parked:!1,result:{window:null,session:n.tmux_session??null,resumed:!1,outcome:"already-live"}};if(!i&&n.lifecycle==="resident"&&le(n))return{parked:!0};const c=t.reserveSlot(e);let s=null;if(c){try{s=await ke(e)}catch(u){throw t.releaseReservation(e),u}s.verdict!=="admitted"&&t.releaseReservation(e)}if(s?.verdict==="too_small")throw we(s);if(!c||s?.verdict==="denied"){if(r.capacity==="refuse")throw s?.verdict==="denied"?me(s):_e(U().automaticReviveCap,t.size());return n.frozen_at==null&&(ne(e,new Date().toISOString()),re(e,{reason:"frozen"}),oe({level:"info",event:"broker.frozen",node_id:e,fields:s?.verdict==="denied"?{reason:"app_memory",free_bytes:s.free_bytes,needed_bytes:s.needed_bytes}:{reason:"broker_cap",live_count:t.size(),hard_cap:U().automaticReviveCap}})),{parked:!1,result:{window:null,session:n.tmux_session??null,resumed:!1,outcome:"frozen"}}}try{return{parked:!1,result:await Ge(e,n,r)}}finally{t.releaseReservation(e)}}l(L,"decideRevive");async function Ge(e,r,i){if(!B(r.cwd)){const m=r.fork_from!=null?`Restore ${r.cwd}, then revive the fork normally with \`crtr node lifecycle revive ${e}\`.`:r.managed_worktree?.state==="open"?"Restore or reconcile the recorded checkout, then use the managed-worktree close or abandon recovery.":`Recreate ${r.cwd}, or repair it with \`crtr node config --cwd <path> --node ${e}\`; durable node work resumes in a fresh conversation. Then retry \`crtr node lifecycle revive ${e}\`.`;throw new $({error:"cwd_missing",message:`${e} cannot be revived \u2014 its recorded cwd no longer exists: ${r.cwd}`,next:m})}r.host_kind!=="broker"&&(E(e,{host_kind:"broker"}),r.host_kind="broker"),r.review_binding!=null&&!$e(e)&&(r.pi_session_id!=null||r.pi_session_file!=null)&&(T(e),r.pi_session_id=null,r.pi_session_file=null);const t=r.fork_from!=null&&r.pi_session_id==null,c=r.fork_source_file;if(t&&(typeof c!="string"||!Q(c)))throw new $({error:"fork_source_invalid",message:`${e} cannot be revived \u2014 its resolved fork source file is missing or invalid.`,next:`Restore the node's fork source metadata, then retry \`crtr node lifecycle revive ${e}\`.`});const s=t&&typeof c=="string";if(s&&!G(c))throw new $({error:"fork_from_missing",message:`${e} cannot be revived \u2014 its fork source no longer exists: ${c}`,next:`Restore ${c}, or update the node's fork source, then retry \`crtr node lifecycle revive ${e}\`.`});const u=I(e,{daemonEpoch:M().epoch()});try{r.cycles=(r.cycles??0)+1,E(e,{cycles:r.cycles});const j=r.intent==="refresh"||r.cycle_pending===!0?!1:i.resume,d=s?{}:Ue(e,r,j),w=d.resumeSessionPath!==void 0,C=w&&d.newCycle===!0,_=w&&!C,N=!w&&(i.wakeReason===void 0||i.wakeReason==="runtime-restart-abort")&&Ke(e),g=_&&(i.wakeReason===void 0||i.wakeReason==="runtime-restart-abort")&&!be(e)&&!He(d.resumeSessionPath)?y(e)?.trim():void 0,F=g!==void 0&&g!=="",W=s||N||F,P=r.cycle_pending===!0||C;E(e,{cycle_pending:P}),r.cycle_pending=P,!s&&!w&&(r.pi_session_id!=null||r.pi_session_file!=null)&&(T(e),r.pi_session_id=null,r.pi_session_file=null);let a,f=null;const b=l(()=>({type:"runtime",kind:"kickoff",...r.spawned_by!=null&&r.spawned_by!==""?{spawnedBy:r.spawned_by}:{}}),"birthOrigin");if(s){const o=y(e),A=p(c);if(A===null)throw new Error(`invalid fork source ${c}`);const X=h().header(h().fork(A,e)).path;a=v(r,{resumeSessionPath:X,...o!=null&&o!==""?{prompt:o}:{}}),o!=null&&o!==""&&(f=b()),Re(e,Se(c)?.node_id??null)}else if(F)a=v(r,{...d,prompt:g}),f=b();else if(_)a=v(r,{...d,...i.wakeReason==="runtime-restart-abort"?{prompt:he}:{}}),i.wakeReason==="runtime-restart-abort"&&(f={type:"runtime",kind:"restart-continuation"});else if(N){const o=y(e)?.trim();a=v(r,o!==void 0&&o!==""?{prompt:o}:{}),o!==void 0&&o!==""&&(f=b()),K(e)}else{const o=ue(r,u);a=v(r,{...d,prompt:ae(r,o,i.wakeReason==="runtime-restart-abort"?void 0:i.wakeReason)}),r.run_id&&o.unreadMessageIds?.length&&(a.env.CRTR_KICKOFF_MESSAGE_IDS=JSON.stringify(o.unreadMessageIds)),f=i.wakeReason!==void 0&&i.wakeReason!=="runtime-restart-abort"?{type:"runtime",kind:"wake",wake:i.wakeReason}:{type:"runtime",kind:"revive",cycle:r.cycles??0},K(e)}a.env={...a.env,CRTR_SUBTREE:xe(e)},f!==null&&(a.env[ve]=pe(f)),r.status==="done"&&r.last_settled_at!=null&&Ee(e,r.last_settled_at),x(e,r.intent==="refresh"?"refresh-launch":"revive"),ge(e,{preserveEpisode:!0});const J=ye(e);i.recovery!==!0&&i.viewerAttach!==!0&&se(e),Be(e,r.grantee);const V=Te(r.cwd,r.profile_id).plans.get("node:start")??[];await De(V,{node:{id:e,name:r.name,kind:r.kind,mode:r.mode,lifecycle:r.lifecycle,cwd:r.cwd,nodeDir:Oe(e),contextDir:Ae(e),jobDir:Pe(e)},runtime:{isBirth:W,canvasHome:Fe(),profile:r.profile_id??null}}),a.env={...a.env,CRTR_EXECUTION_ID:u};let k;try{if(k=await H.launch(e,a,{cwd:r.cwd,name:D(r),resuming:_}),k.pid===null)throw new Error(`broker host returned no pid for ${e}`)}catch(o){try{x(e,"crash",{reason:"launch_failed",outcome:{detail:{schema:"crtr.node-outcome-detail/v1",message:o instanceof Error?o.message:String(o)}}}),ce(e,"notice.crash",`Child crashed \u2014 ${D(r)} (${e}) failed to relaunch and is now dead: ${o.message}
+var Y=Object.defineProperty;var a=(e,r)=>Y(e,"name",{value:r,configurable:!0});import{assertGranteeRunsHere as q}from"./unsandboxed.js";import{existsSync as B}from"node:fs";import{conversationIdFromPath as h,conversationStore as d,ConversationNotFoundError as O}from"../conversation-store/index.js";import{isAbsolute as Q}from"node:path";import{findNodeBySessionFile as Z,getNode as R,updateNode as E,beginExecution as I,recordExecutionPid as ee,abortExecution as S,endLiveExecution as re,unbindSession as T,recordLaunch as ie,setFrozen as te,clearFrozen as ne,fullName as D}from"../canvas/index.js";import{emitEvent as oe}from"../events/emit.js";import{cancelCronsOnWake as se}from"../canvas/crons.js";import{isParked as ae,transition as x}from"./lifecycle.js";import{publishNotice as le}from"./close.js";import{InputError as $}from"../io.js";import{buildPiArgv as p}from"./launch.js";import{buildReviveKickoff as ce,drainBearings as ue,hasRetainedReports as fe,readGoal as k,readYieldMessage as we,RUNTIME_RESTART_CONTINUATION as de}from"./kickoff.js";import{readRoadmap as z}from"./roadmap.js";import{encodeKickoffOrigin as he,KICKOFF_ORIGIN_ENV as pe}from"./stamp/protocol.js";import{headlessBrokerHost as H}from"./host.js";import{appMemoryFull as ve,appMemoryTooSmall as me,boundFleet as M,brokerCapReached as _e,brokerThresholdsForDaemon as U}from"./fleet.js";import{admitBrokerMemory as ye}from"./memory-admission.js";import{beginBootFaultAttempt as ke,clearFault as ge,hasAdmittedTurn as be}from"../canvas/recovery.js";import{clearNodeLedger as K,forkNodeLedger as Re,noticeChangedWhileDone as Ee}from"./ledger.js";import{forkSourceNode as Se,rootOfSpine as xe}from"./nodes.js";import{isReviewCompanionBound as $e}from"../review/companion.js";import{assertProfileActive as Ce}from"../profiles/manifest.js";import{isPidAlive as Ne}from"../canvas/pid.js";import{crtrHome as Fe,jobDir as Pe}from"../canvas/paths.js";import{contextDir as Ae,ensureNodeDirs as Be,nodeAgentDir as Oe}from"../canvas/node-agent-paths.js";import{discoverLifecycleHookRegistry as Te}from"../command-hooks/discovery.js";import{invokeLifecycleHooks as De}from"../command-hooks/transport/exec-lifecycle.js";async function ze(e,r){const i=e.pi_session_file,t=i?h(i):null;if(t===null)return{};try{const n=await d().header(t);return r?{resumeSessionPath:n.path}:{resumeSessionPath:n.path,newCycle:!0}}catch(n){if(n instanceof O)return{};throw n}}a(ze,"resumeArgs");async function G(e){const r=h(e);if(r===null)return!1;try{return await d().header(r),!0}catch(i){if(i instanceof O)return!1;throw i}}a(G,"conversationExists");async function He(e){const r=h(e);return r===null?!0:(await d().read(r)).entries.some(i=>i.type==="message")}a(He,"sessionHasConversation");async function Me(e){const r=h(e);if(r===null)return!0;const i=(await d().header(r)).header.cwd;return typeof i!="string"||B(i)}a(Me,"sessionCwdExists");async function Ue(e,r,i){const t=r.pi_session_file;if(!t||!await G(t))return{};const n=await Z(t);return n!==null&&n.node_id!==e&&Ne(n.pi_pid)?{}:await Me(t)?await ze(r,i):{}}a(Ue,"resumableSessionArgs");async function Ke(e){return await z(e)===null&&await we(e)===null&&!await fe(e)}a(Ke,"isUnstartedBirth");async function _r(e){const r=await k(e);if(r!==null&&r.trim()!=="")return!0;const i=await z(e);return i!==null&&i.trim()!==""}a(_r,"hasFreshGroundState");async function yr(e,r){const i=await L(e,r,!0);if(i.parked)throw new Error(`reviveNode: internal parked decision for activating revive ${e}`);return i.result}a(yr,"reviveNode");async function kr(e,r,i){return L(e,{...r,viewerAttach:!0},i)}a(kr,"decideAttachRevive");async function L(e,r,i){let t=await R(e);if(t===null)throw new Error(`reviveNode: unknown node ${e}`);if(t=await R(e)??t,t.run_id&&(await R(t.run_id))?.deleting_at)throw new Error("run is deleting");if(t.final_report!==null)throw new Error(`reviveNode: refusing to revive ${e} \u2014 its finalization latch is set (final_report=${t.final_report}). A final landed between the caller's reopen-gate check and this revive; re-run with --reopen if this retask is still wanted.`);Ce(t.profile_id),q(t.grantee);const n=M();if(n.has(e))return await x(e,t.intent==="refresh"?"refresh-launch":"revive"),{parked:!1,result:{window:null,session:t.tmux_session??null,resumed:!1,outcome:"already-live"}};if(n.isClaimed(e))return{parked:!1,result:{window:null,session:t.tmux_session??null,resumed:!1,outcome:"already-live"}};if(!i&&t.lifecycle==="resident"&&ae(t))return{parked:!0};const l=n.reserveSlot(e);let s=null;if(l){try{s=await ye(e)}catch(u){throw n.releaseReservation(e),u}s.verdict!=="admitted"&&n.releaseReservation(e)}if(s?.verdict==="too_small")throw me(s);if(!l||s?.verdict==="denied"){if(r.capacity==="refuse")throw s?.verdict==="denied"?ve(s):_e(U().automaticReviveCap,n.size());return t.frozen_at==null&&(await te(e,new Date().toISOString()),await re(e,{reason:"frozen"}),oe({level:"info",event:"broker.frozen",node_id:e,fields:s?.verdict==="denied"?{reason:"app_memory",free_bytes:s.free_bytes,needed_bytes:s.needed_bytes}:{reason:"broker_cap",live_count:n.size(),hard_cap:U().automaticReviveCap}})),{parked:!1,result:{window:null,session:t.tmux_session??null,resumed:!1,outcome:"frozen"}}}try{return{parked:!1,result:await Ge(e,t,r)}}finally{n.releaseReservation(e)}}a(L,"decideRevive");async function Ge(e,r,i){if(!B(r.cwd)){const v=r.fork_from!=null?`Restore ${r.cwd}, then revive the fork normally with \`crtr node lifecycle revive ${e}\`.`:r.managed_worktree?.state==="open"?"Restore or reconcile the recorded checkout, then use the managed-worktree close or abandon recovery.":`Recreate ${r.cwd}, or repair it with \`crtr node config --cwd <path> --node ${e}\`; durable node work resumes in a fresh conversation. Then retry \`crtr node lifecycle revive ${e}\`.`;throw new $({error:"cwd_missing",message:`${e} cannot be revived \u2014 its recorded cwd no longer exists: ${r.cwd}`,next:v})}r.host_kind!=="broker"&&(await E(e,{host_kind:"broker"}),r.host_kind="broker"),r.review_binding!=null&&!await $e(e)&&(r.pi_session_id!=null||r.pi_session_file!=null)&&(await T(e),r.pi_session_id=null,r.pi_session_file=null);const n=r.fork_from!=null&&r.pi_session_id==null,l=r.fork_source_file;if(n&&(typeof l!="string"||!Q(l)))throw new $({error:"fork_source_invalid",message:`${e} cannot be revived \u2014 its resolved fork source file is missing or invalid.`,next:`Restore the node's fork source metadata, then retry \`crtr node lifecycle revive ${e}\`.`});const s=n&&typeof l=="string";if(s&&!await G(l))throw new $({error:"fork_from_missing",message:`${e} cannot be revived \u2014 its fork source no longer exists: ${l}`,next:`Restore ${l}, or update the node's fork source, then retry \`crtr node lifecycle revive ${e}\`.`});const u=await I(e,{daemonEpoch:M().epoch()});try{r.cycles=(r.cycles??0)+1,await E(e,{cycles:r.cycles});const j=r.intent==="refresh"||r.cycle_pending===!0?!1:i.resume,w=s?{}:await Ue(e,r,j),m=w.resumeSessionPath!==void 0,C=m&&w.newCycle===!0,_=m&&!C,N=!m&&(i.wakeReason===void 0||i.wakeReason==="runtime-restart-abort")&&await Ke(e),g=_&&(i.wakeReason===void 0||i.wakeReason==="runtime-restart-abort")&&!await be(e)&&!await He(w.resumeSessionPath)?(await k(e))?.trim():void 0,F=g!==void 0&&g!=="",W=s||N||F,P=r.cycle_pending===!0||C;await E(e,{cycle_pending:P}),r.cycle_pending=P,!s&&!m&&(r.pi_session_id!=null||r.pi_session_file!=null)&&(await T(e),r.pi_session_id=null,r.pi_session_file=null);let c,f=null;const b=a(()=>({type:"runtime",kind:"kickoff",...r.spawned_by!=null&&r.spawned_by!==""?{spawnedBy:r.spawned_by}:{}}),"birthOrigin");if(s){const o=await k(e),A=h(l);if(A===null)throw new Error(`invalid fork source ${l}`);const X=(await d().header(await d().fork(A,e))).path;c=p(r,{resumeSessionPath:X,...o!=null&&o!==""?{prompt:o}:{}}),o!=null&&o!==""&&(f=b()),await Re(e,(await Se(l))?.node_id??null)}else if(F)c=p(r,{...w,prompt:g}),f=b();else if(_)c=p(r,{...w,...i.wakeReason==="runtime-restart-abort"?{prompt:de}:{}}),i.wakeReason==="runtime-restart-abort"&&(f={type:"runtime",kind:"restart-continuation"});else if(N){const o=(await k(e))?.trim();c=p(r,o!==void 0&&o!==""?{prompt:o}:{}),o!==void 0&&o!==""&&(f=b()),await K(e)}else{const o=await ue(r,u);c=p(r,{...w,prompt:await ce(r,o,i.wakeReason==="runtime-restart-abort"?void 0:i.wakeReason)}),r.run_id&&o.unreadMessageIds?.length&&(c.env.CRTR_KICKOFF_MESSAGE_IDS=JSON.stringify(o.unreadMessageIds)),f=i.wakeReason!==void 0&&i.wakeReason!=="runtime-restart-abort"?{type:"runtime",kind:"wake",wake:i.wakeReason}:{type:"runtime",kind:"revive",cycle:r.cycles??0},await K(e)}c.env={...c.env,CRTR_SUBTREE:await xe(e)},f!==null&&(c.env[pe]=he(f)),r.status==="done"&&r.last_settled_at!=null&&await Ee(e,r.last_settled_at),await x(e,r.intent==="refresh"?"refresh-launch":"revive"),await ge(e,{preserveEpisode:!0});const J=await ke(e);i.recovery!==!0&&i.viewerAttach!==!0&&await se(e),await Be(e,r.grantee);const V=Te(r.cwd,r.profile_id).plans.get("node:start")??[];await De(V,{node:{id:e,name:r.name,kind:r.kind,mode:r.mode,lifecycle:r.lifecycle,cwd:r.cwd,nodeDir:await Oe(e),contextDir:await Ae(e),jobDir:Pe(e)},runtime:{isBirth:W,canvasHome:Fe(),profile:r.profile_id??null}}),c.env={...c.env,CRTR_EXECUTION_ID:u};let y;try{if(y=await H.launch(e,c,{cwd:r.cwd,name:D(r),resuming:_}),y.pid===null)throw new Error(`broker host returned no pid for ${e}`)}catch(o){try{await x(e,"crash",{reason:"launch_failed",outcome:{detail:{schema:"crtr.node-outcome-detail/v1",message:o instanceof Error?o.message:String(o)}}}),await le(e,"notice.crash",`Child crashed \u2014 ${D(r)} (${e}) failed to relaunch and is now dead: ${o.message}
 
-It stays dead until you revive it \u2014 \`crtr node lifecycle revive ${e}\`.`,{reason:"child-crashed",child:e})}catch{}throw S(u,{reason:"launch_failed"}),new Error(`[broker] refusing to revive ${e}: ${o.message}`)}if(ie(e,new Date().toISOString()),ee(u,e,k.pid)==="shutdown")throw S(u,{reason:"superseded"}),H.teardown(e),new Error(`[broker] refusing to revive ${e}: execution was superseded during launch`);return te(e),{window:null,session:r.tmux_session??null,resumed:_,launch:k,faultExplanation:J.explanation,outcome:"launched"}}catch(m){throw S(u,{reason:"launch_failed"}),m}}l(Ge,"launchRevive");export{yr as decideAttachRevive,_r as hasFreshGroundState,ze as resumeArgs,kr as reviveNode};
+It stays dead until you revive it \u2014 \`crtr node lifecycle revive ${e}\`.`,{reason:"child-crashed",child:e})}catch{}throw await S(u,{reason:"launch_failed"}),new Error(`[broker] refusing to revive ${e}: ${o.message}`)}if(await ie(e,new Date().toISOString()),await ee(u,e,y.pid)==="shutdown")throw await S(u,{reason:"superseded"}),H.teardown(e),new Error(`[broker] refusing to revive ${e}: execution was superseded during launch`);return await ne(e),{window:null,session:r.tmux_session??null,resumed:_,launch:y,faultExplanation:J.explanation,outcome:"launched"}}catch(v){throw await S(u,{reason:"launch_failed"}),v}}a(Ge,"launchRevive");export{kr as decideAttachRevive,_r as hasFreshGroundState,ze as resumeArgs,yr as reviveNode};

package/dist/core/runtime/roadmap.d.ts

@@ -1,4 +1,4 @@
-import type { DatabaseSync } from 'node:sqlite';
+import { type CanvasDb } from '../canvas/db.js';
 export declare const ROADMAP_NAME = "roadmap";
 /** Fallback preview when the roadmap is seeded without a goal. */
 export declare const ROADMAP_PREVIEW = "To understand this node's long-term task and current plan, read this.";
@@ -6,19 +6,19 @@ export declare const ROADMAP_PREVIEW = "To understand this node's long-term task
 export declare function roadmapPreview(goal?: string): string;
 /** How a node addresses its own roadmap in `crtr canvas read` / `crtr doc edit`. */
 export declare function roadmapRef(nodeId: string): string;
-export declare function hasRoadmap(nodeId: string): boolean;
+export declare function hasRoadmap(nodeId: string): Promise<boolean>;
 /** The roadmap's newest head body, or null when the node has none. */
-export declare function readRoadmap(nodeId: string): string | null;
+export declare function readRoadmap(nodeId: string): Promise<string | null>;
 /** Seed a fresh, EXTREMELY BAREBONES roadmap document — the section skeleton
  *  with one-line prompts — authored by the node. The owner fleshes it out as
  *  its next act with `crtr doc edit roadmap`. Leaves an existing roadmap
  *  untouched and returns null; otherwise returns the seeded body. */
-export declare function seedRoadmap(db: DatabaseSync, nodeId: string, opts?: {
+export declare function seedRoadmap(db: CanvasDb, nodeId: string, opts?: {
     goal?: string;
     exitCriteria?: string;
-}): string | null;
+}): Promise<string | null>;
 /** `seedRoadmap` in its own canvas write; true when it wrote one. */
 export declare function ensureRoadmap(nodeId: string, opts?: {
     goal?: string;
     exitCriteria?: string;
-}): boolean;
+}): Promise<boolean>;

package/dist/core/runtime/roadmap.js

@@ -1,15 +1,15 @@
-var l=Object.defineProperty;var r=(e,n)=>l(e,"name",{value:n,configurable:!0});import{openDb as u,withCanvasWrite as d}from"../canvas/db.js";import{get as s}from"../graph/bodies.js";import{heads as m,writeDocument as p}from"../graph/documents.js";import{asRuntimeWriter as c}from"../graph/spaces/own-memory.js";import{getById as f,liveDocumentNamed as h,nodeObject as g}from"../graph/objects.js";import{readerForNode as w}from"../graph/reader.js";const i="roadmap",x="To understand this node's long-term task and current plan, read this.";function R(e){return e?.split(`
-`).map(t=>t.trim()).find(t=>t!=="")??x}r(R,"roadmapPreview");function P(e){return`${e}/${i}`}r(P,"roadmapRef");function a(e,n){const t=f(e,n);return t===null||t.type!=="node"?null:h(e,t.rowid,i)}r(a,"roadmapObject");function $(e){return a(u(),e)!==null}r($,"hasRoadmap");function M(e){const n=u(),t=a(n,e);if(t===null)return null;const o=m(n,t)[0];if(o===void 0)return null;try{return s(o.body_hash)}catch{return null}}r(M,"readRoadmap");function y(e){return`# Roadmap
+var l=Object.defineProperty;var r=(t,e)=>l(t,"name",{value:e,configurable:!0});import{openDb as u,withCanvasWrite as s}from"../canvas/db.js";import{get as c}from"../graph/bodies.js";import{heads as d,writeDocument as m}from"../graph/documents.js";import{asRuntimeWriter as p}from"../graph/spaces/own-memory.js";import{getById as f,liveDocumentNamed as w,nodeObject as h}from"../graph/objects.js";import{readerForNode as y}from"../graph/reader.js";const o="roadmap",g="To understand this node's long-term task and current plan, read this.";function x(t){return t?.split(`
+`).map(n=>n.trim()).find(n=>n!=="")??g}r(x,"roadmapPreview");function P(t){return`${t}/${o}`}r(P,"roadmapRef");async function i(t,e){const n=await f(t,e);return n===null||n.type!=="node"?null:await w(t,n.rowid,o)}r(i,"roadmapObject");async function $(t){return await i(await u(),t)!==null}r($,"hasRoadmap");async function M(t){const e=await u(),n=await i(e,t);if(n===null)return null;const a=(await d(e,n))[0];if(a===void 0)return null;try{return c(a.body_hash)}catch{return null}}r(M,"readRoadmap");function R(t){return`# Roadmap
 
 ## Goal
-${e.goal?.trim()||"(the goal you now own)"}
+${t.goal?.trim()||"(the goal you now own)"}
 
 ## Exit criteria
-${e.exitCriteria?.trim()||'(what "done" looks like)'}
+${t.exitCriteria?.trim()||'(what "done" looks like)'}
 
 ## Where things stand
 (present state at your level: settled, in flight, remaining)
 
 ## Working set
 (links to the documents the work depends on now, one per line)
-`}r(y,"scaffold");function k(e,n,t={}){if(a(e,n)!==null)return null;const o=y(t);return p(e,c(w(e,n,()=>[])),{owner:g(e,n),name:i,kind:"knowledge",preview:R(t.goal),privacy:"public",rules:[{on:"boot",deliver:"content"}]},o),o}r(k,"seedRoadmap");function N(e,n={}){return d(t=>k(t,e,n)!==null)}r(N,"ensureRoadmap");export{i as ROADMAP_NAME,x as ROADMAP_PREVIEW,N as ensureRoadmap,$ as hasRoadmap,M as readRoadmap,R as roadmapPreview,P as roadmapRef,k as seedRoadmap};
+`}r(R,"scaffold");async function k(t,e,n={}){if(await i(t,e)!==null)return null;const a=R(n);return await m(t,p(await y(t,e,async()=>[])),{owner:await h(t,e),name:o,kind:"knowledge",preview:x(n.goal),privacy:"public",rules:[{on:"boot",deliver:"content"}]},a),a}r(k,"seedRoadmap");async function N(t,e={}){return await s(async n=>await k(n,t,e)!==null)}r(N,"ensureRoadmap");export{o as ROADMAP_NAME,g as ROADMAP_PREVIEW,N as ensureRoadmap,$ as hasRoadmap,M as readRoadmap,x as roadmapPreview,P as roadmapRef,k as seedRoadmap};

package/dist/core/runtime/session-branch.d.ts

@@ -4,4 +4,4 @@ export interface HumanForkCoordinates {
     leafId: string;
 }
 /** Fork the captured root-to-leaf branch without opening or mutating its live source. */
-export declare function materializeSessionBranch(coordinates: HumanForkCoordinates): string;
+export declare function materializeSessionBranch(coordinates: HumanForkCoordinates): Promise<string>;

package/dist/core/runtime/session-branch.js

@@ -1 +1 @@
-var n=Object.defineProperty;var s=(e,r)=>n(e,"name",{value:r,configurable:!0});import{conversationIdFromPath as i,conversationStore as t}from"../conversation-store/index.js";function c(e){if(e.sourceSessionId===""||e.leafId==="")throw new Error("session branch coordinates require source session and leaf ids");const r=i(e.sourceFile);if(r===null||r!==e.sourceSessionId)throw new Error("source session id does not match captured coordinates");const o=t();if(o.header(r).header.id!==e.sourceSessionId)throw new Error("source session id does not match captured coordinates");return o.header(o.fork(r,void 0,e.leafId)).path}s(c,"materializeSessionBranch");export{c as materializeSessionBranch};
+var n=Object.defineProperty;var s=(e,r)=>n(e,"name",{value:r,configurable:!0});import{conversationIdFromPath as i,conversationStore as a}from"../conversation-store/index.js";async function c(e){if(e.sourceSessionId===""||e.leafId==="")throw new Error("session branch coordinates require source session and leaf ids");const r=i(e.sourceFile);if(r===null||r!==e.sourceSessionId)throw new Error("source session id does not match captured coordinates");const o=a();if((await o.header(r)).header.id!==e.sourceSessionId)throw new Error("source session id does not match captured coordinates");return(await o.header(await o.fork(r,void 0,e.leafId))).path}s(c,"materializeSessionBranch");export{c as materializeSessionBranch};

package/dist/core/runtime/session-list-cache.js

@@ -1 +1 @@
-var T=Object.defineProperty;var c=(t,e)=>T(t,"name",{value:e,configurable:!0});import{readFile as D,rename as N,unlink as C,writeFile as A}from"node:fs/promises";import{resolve as M}from"node:path";import{conversationStore as p,ConversationNotFoundError as F}from"../conversation-store/index.js";const S=1024;function E(t){if(t.length<=S)return t;const e=S/2;return`${t.slice(0,e)} \u2026 ${t.slice(-e)}`}c(E,"compactSessionSearchText");const w=1,P=2e3;function g(t){return typeof t=="number"&&Number.isFinite(t)&&t>=0}c(g,"isFiniteNonNeg");function b(t){return t===void 0||typeof t=="string"}c(b,"isOptionalString");function x(t){if(typeof t!="object"||t===null)return!1;const e=t;return typeof e.path=="string"&&typeof e.id=="string"&&typeof e.cwd=="string"&&typeof e.created=="string"&&typeof e.modified=="string"&&g(e.messageCount)&&typeof e.firstMessage=="string"&&typeof e.allMessagesText=="string"&&b(e.name)&&b(e.parentSessionPath)}c(x,"isValidWireInfo");function O(t){if(typeof t!="object"||t===null)return!1;const e=t;return g(e.mtimeMs)&&g(e.size)&&x(e.info)}c(O,"isValidEntry");function _(t){const e=t.content;return typeof e=="string"?e:Array.isArray(e)?e.filter(i=>i.type==="text").map(i=>i.text).join(" "):""}c(_,"extractTextContent");function k(t){const e=t.message;if(!e||!("content"in e))return;const i=e.role;if(i!=="user"&&i!=="assistant")return;const s=e.timestamp;if(typeof s=="number")return s;const n=new Date(t.timestamp).getTime();return Number.isNaN(n)?void 0:n}c(k,"messageActivityTime");function v(t){try{const e=t.header;let i=0,s="";const n=[];let a,h;for(const f of p().read(t.conversation_id).entries){if(f.type==="session_info"&&(a=f.name?.trim()||void 0),f.type!=="message")continue;i++;const y=k(f);typeof y=="number"&&(h=Math.max(h??0,y));const u=f.message;if(!u||!("content"in u))continue;const m=u.role;if(m!=="user"&&m!=="assistant")continue;const d=_(u);d&&(n.push(d),!s&&m==="user"&&(s=d))}const r=typeof e.cwd=="string"?e.cwd:"",o=typeof e.timestamp=="string"?new Date(e.timestamp).getTime():NaN,l=typeof h=="number"&&h>0?new Date(h):Number.isNaN(o)?new Date(t.mtime):new Date(o);return{path:t.path,id:e.id,cwd:r,name:a,parentSessionPath:e.parentSession,created:new Date(e.timestamp).toISOString(),modified:l.toISOString(),messageCount:i,firstMessage:s||"(no messages)",allMessagesText:E(n.join(" "))}}catch(e){if(e instanceof F)return null;throw e}}c(v,"buildWireSessionInfo");class H{static{c(this,"SessionListCache")}cacheFile;cache=new Map;inflightDir=new Map;loadPromise=null;buildChain=Promise.resolve();persisting=!1;persistAgain=!1;persistTimer=null;constructor(e){this.cacheFile=e}listDir(e){const i=M(e),s=this.inflightDir.get(i);if(s)return s;const n=Promise.resolve().then(()=>this.buildDir(i));this.inflightDir.set(i,n);const a=c(()=>{this.inflightDir.get(i)===n&&this.inflightDir.delete(i)},"clear");return n.then(a,a),n}buildDir(e){const i=p().list().filter(s=>s.header.cwd===e);return this.build(i,s=>this.cache.get(s)?.info.cwd===e)}async listAll(){return this.build(p().list(),()=>!0)}build(e,i){const s=this.buildChain.then(()=>this.buildLocked(e,i));return this.buildChain=s.then(()=>{},()=>{}),s}async buildLocked(e,i){await this.ensureLoaded();const s=new Set(e.map(({path:r})=>r));let n=!1;for(const r of this.cache.keys())!s.has(r)&&i(r)&&(this.cache.delete(r),n=!0);const a=new Array(e.length);for(const[r,o]of e.entries()){const l=this.cache.get(o.path);if(l&&l.mtimeMs===o.mtime&&l.size===o.size){a[r]=l.info;continue}const f=v(o);if(n=!0,!f){this.cache.delete(o.path);continue}this.cache.set(o.path,{mtimeMs:o.mtime,size:o.size,info:f}),a[r]=f}n&&this.schedulePersist();const h=a.filter(r=>r!==void 0);return h.sort((r,o)=>new Date(o.modified).getTime()-new Date(r.modified).getTime()),h}ensureLoaded(){return this.loadPromise||(this.loadPromise=this.loadFromDisk()),this.loadPromise}async loadFromDisk(){try{const e=JSON.parse(await D(this.cacheFile,"utf8"));if(e?.version!==w||typeof e.entries!="object")return;for(const[i,s]of Object.entries(e.entries)){if(!O(s)){this.cache.clear();return}this.cache.set(i,s)}}catch{this.cache.clear()}}schedulePersist(){this.persistTimer||(this.persistTimer=setTimeout(()=>{this.persistTimer=null,this.persist()},P),this.persistTimer.unref?.())}async persist(){if(this.persisting){this.persistAgain=!0;return}this.persisting=!0;const e=`${this.cacheFile}.${process.pid}.tmp`;try{const i={};for(const[n,a]of this.cache)i[n]=a;await A(e,JSON.stringify({version:w,entries:i})),await N(e,this.cacheFile)}catch{await C(e).catch(()=>{})}finally{this.persisting=!1,this.persistAgain&&(this.persistAgain=!1,this.persist())}}}export{H as SessionListCache,E as compactSessionSearchText};
+var T=Object.defineProperty;var c=(t,e)=>T(t,"name",{value:e,configurable:!0});import{readFile as D,rename as N,unlink as C,writeFile as A}from"node:fs/promises";import{resolve as M}from"node:path";import{conversationStore as p,ConversationNotFoundError as F}from"../conversation-store/index.js";const w=1024;function E(t){if(t.length<=w)return t;const e=w/2;return`${t.slice(0,e)} \u2026 ${t.slice(-e)}`}c(E,"compactSessionSearchText");const S=1,P=2e3;function g(t){return typeof t=="number"&&Number.isFinite(t)&&t>=0}c(g,"isFiniteNonNeg");function b(t){return t===void 0||typeof t=="string"}c(b,"isOptionalString");function x(t){if(typeof t!="object"||t===null)return!1;const e=t;return typeof e.path=="string"&&typeof e.id=="string"&&typeof e.cwd=="string"&&typeof e.created=="string"&&typeof e.modified=="string"&&g(e.messageCount)&&typeof e.firstMessage=="string"&&typeof e.allMessagesText=="string"&&b(e.name)&&b(e.parentSessionPath)}c(x,"isValidWireInfo");function O(t){if(typeof t!="object"||t===null)return!1;const e=t;return g(e.mtimeMs)&&g(e.size)&&x(e.info)}c(O,"isValidEntry");function _(t){const e=t.content;return typeof e=="string"?e:Array.isArray(e)?e.filter(i=>i.type==="text").map(i=>i.text).join(" "):""}c(_,"extractTextContent");function k(t){const e=t.message;if(!e||!("content"in e))return;const i=e.role;if(i!=="user"&&i!=="assistant")return;const s=e.timestamp;if(typeof s=="number")return s;const n=new Date(t.timestamp).getTime();return Number.isNaN(n)?void 0:n}c(k,"messageActivityTime");async function v(t){try{const e=t.header;let i=0,s="";const n=[];let a,h;for(const f of(await p().read(t.conversation_id)).entries){if(f.type==="session_info"&&(a=f.name?.trim()||void 0),f.type!=="message")continue;i++;const y=k(f);typeof y=="number"&&(h=Math.max(h??0,y));const u=f.message;if(!u||!("content"in u))continue;const m=u.role;if(m!=="user"&&m!=="assistant")continue;const d=_(u);d&&(n.push(d),!s&&m==="user"&&(s=d))}const r=typeof e.cwd=="string"?e.cwd:"",o=typeof e.timestamp=="string"?new Date(e.timestamp).getTime():NaN,l=typeof h=="number"&&h>0?new Date(h):Number.isNaN(o)?new Date(t.mtime):new Date(o);return{path:t.path,id:e.id,cwd:r,name:a,parentSessionPath:e.parentSession,created:new Date(e.timestamp).toISOString(),modified:l.toISOString(),messageCount:i,firstMessage:s||"(no messages)",allMessagesText:E(n.join(" "))}}catch(e){if(e instanceof F)return null;throw e}}c(v,"buildWireSessionInfo");class H{static{c(this,"SessionListCache")}cacheFile;cache=new Map;inflightDir=new Map;loadPromise=null;buildChain=Promise.resolve();persisting=!1;persistAgain=!1;persistTimer=null;constructor(e){this.cacheFile=e}listDir(e){const i=M(e),s=this.inflightDir.get(i);if(s)return s;const n=Promise.resolve().then(()=>this.buildDir(i));this.inflightDir.set(i,n);const a=c(()=>{this.inflightDir.get(i)===n&&this.inflightDir.delete(i)},"clear");return n.then(a,a),n}async buildDir(e){const i=(await p().list()).filter(s=>s.header.cwd===e);return this.build(i,s=>this.cache.get(s)?.info.cwd===e)}async listAll(){return this.build(await p().list(),()=>!0)}build(e,i){const s=this.buildChain.then(()=>this.buildLocked(e,i));return this.buildChain=s.then(()=>{},()=>{}),s}async buildLocked(e,i){await this.ensureLoaded();const s=new Set(e.map(({path:r})=>r));let n=!1;for(const r of this.cache.keys())!s.has(r)&&i(r)&&(this.cache.delete(r),n=!0);const a=new Array(e.length);for(const[r,o]of e.entries()){const l=this.cache.get(o.path);if(l&&l.mtimeMs===o.mtime&&l.size===o.size){a[r]=l.info;continue}const f=await v(o);if(n=!0,!f){this.cache.delete(o.path);continue}this.cache.set(o.path,{mtimeMs:o.mtime,size:o.size,info:f}),a[r]=f}n&&this.schedulePersist();const h=a.filter(r=>r!==void 0);return h.sort((r,o)=>new Date(o.modified).getTime()-new Date(r.modified).getTime()),h}ensureLoaded(){return this.loadPromise||(this.loadPromise=this.loadFromDisk()),this.loadPromise}async loadFromDisk(){try{const e=JSON.parse(await D(this.cacheFile,"utf8"));if(e?.version!==S||typeof e.entries!="object")return;for(const[i,s]of Object.entries(e.entries)){if(!O(s)){this.cache.clear();return}this.cache.set(i,s)}}catch{this.cache.clear()}}schedulePersist(){this.persistTimer||(this.persistTimer=setTimeout(()=>{this.persistTimer=null,this.persist()},P),this.persistTimer.unref?.())}async persist(){if(this.persisting){this.persistAgain=!0;return}this.persisting=!0;const e=`${this.cacheFile}.${process.pid}.tmp`;try{const i={};for(const[n,a]of this.cache)i[n]=a;await A(e,JSON.stringify({version:S,entries:i})),await N(e,this.cacheFile)}catch{await C(e).catch(()=>{})}finally{this.persisting=!1,this.persistAgain&&(this.persistAgain=!1,this.persist())}}}export{H as SessionListCache,E as compactSessionSearchText};

package/dist/core/runtime/situational-live.js

@@ -1 +1 @@
-var i=Object.defineProperty;var n=(t,e)=>i(t,"name",{value:e,configurable:!0});import{getNode as r}from"../canvas/index.js";import{deliverCustomMessageLive as a}from"./deliver-live.js";import{appendSituationalContext as l,formatSituationalProse as u,situationalContextEnvelope as s,SITUATIONAL_CONTEXT_CUSTOM_TYPE as m}from"./situational-context.js";async function C(t,e){if(l(t,u(e)),r(t)===null)throw new Error(`setSituationalContextLive: unknown node ${t}`);const o=s(t);o!==null&&await a(t,{customType:m,content:o,deliverAs:"nextTurn"})}n(C,"setSituationalContextLive");export{C as setSituationalContextLive};
+var i=Object.defineProperty;var n=(t,e)=>i(t,"name",{value:e,configurable:!0});import{getNode as a}from"../canvas/index.js";import{deliverCustomMessageLive as r}from"./deliver-live.js";import{appendSituationalContext as l,formatSituationalProse as u,situationalContextEnvelope as s,SITUATIONAL_CONTEXT_CUSTOM_TYPE as m}from"./situational-context.js";async function C(t,e){if(l(t,u(e)),await a(t)===null)throw new Error(`setSituationalContextLive: unknown node ${t}`);const o=s(t);o!==null&&await r(t,{customType:m,content:o,deliverAs:"nextTurn"})}n(C,"setSituationalContextLive");export{C as setSituationalContextLive};