@north-light/crouter 0.3.349 → 0.3.350

package/dist/core/runtime/kickoff.js

@@ -1,30 +1,30 @@
-var M=Object.defineProperty;var s=(e,t)=>M(e,"name",{value:t,configurable:!0});import{existsSync as p,readFileSync as b,writeFileSync as $,rmSync as S,mkdirSync as w,readdirSync as m}from"node:fs";import{join as x}from"node:path";import{contextDir as f,reportsDir as k,getNode as v,subscriptionsOf as j,subscribersOf as T}from"../canvas/index.js";import{activeBackgroundBashJobs as A,bashJobCommandLine as B,formatBashElapsed as E}from"../bash-jobs.js";import{readRoadmap as O,roadmapPath as N}from"./roadmap.js";import{buildWakeBearings as C}from"./bearings.js";import{personaDrift as G}from"./persona.js";import{coalesce as Y,nodeMailEntry as D}from"../feed/inbox.js";import{claimKickoffMail as P}from"../canvas/deliveries.js";import{formatCard as R}from"../../shared/generated-context.js";const dt=R("restart-continuation",{},"continue");function g(e){return x(f(e),"initial-prompt.md")}s(g,"goalPath");function _(e){const t=g(e);return p(t)?b(t,"utf8"):null}s(_,"readGoal");function U(e,t){const n=t.trim();n!==""&&(w(f(e),{recursive:!0}),$(g(e),n+`
-`,"utf8"))}s(U,"writeGoal");function ut(e,t){const n=_(e);if(n!==null&&n.trim()!=="")return!1;const o=t.trim();return o===""?!1:(U(e,o),!0)}s(ut,"captureGoalIfAbsent");function y(e){return x(f(e),"yield-message.md")}s(y,"yieldMessagePath");function ct(e,t){const n=t.trim();n!==""&&(w(f(e),{recursive:!0}),$(y(e),n+`
-`,"utf8"))}s(ct,"writeYieldMessage");function L(e){const t=y(e);if(!p(t))return null;const n=b(t,"utf8").trim();return n!==""?n:null}s(L,"readYieldMessage");function lt(e){try{S(y(e))}catch{}}s(lt,"clearYieldMessage");function F(e){const t=f(e);return p(t)?m(t).sort():[]}s(F,"listContextDir");function J(e){const t=k(e);return p(t)&&m(t).some(n=>n.endsWith(".md"))}s(J,"hasRetainedReports");function ft(e,t){const n=e.node_id,o=L(n),i=P(n,t).map(D);let r=null;if(i.length>0){const a=s(c=>{const h=c.data?.cards;return Array.isArray(h)?h.filter(I=>typeof I=="string"):[]},"cardsFor"),u=[];for(const c of i)(a(c).length>0||u.length===0)&&u.push([]),u.at(-1).push(c);r=u.map(c=>[...a(c[0]),Y(c).map(h=>h.text).join(`
+var E=Object.defineProperty;var i=(t,n)=>E(t,"name",{value:n,configurable:!0});import{join as w}from"node:path";import{getNode as x,subscriptionsOf as k,subscribersOf as M}from"../canvas/index.js";import{contextDir as h,nodeAgentDir as f,reportsDir as v}from"../canvas/node-agent-paths.js";import{readdirBeneath as A,readTextBeneathIfExists as j,unlinkBeneath as N,writeFileBeneath as R}from"../spaces/open-beneath.js";import{activeBackgroundBashJobs as O,bashJobCommandLine as I,formatBashElapsed as D}from"../bash-jobs.js";import{readRoadmap as C,roadmapPath as G}from"./roadmap.js";import{buildWakeBearings as Y}from"./bearings.js";import{personaDrift as P}from"./persona.js";import{coalesce as S,nodeMailEntry as U}from"../feed/inbox.js";import{claimKickoffMail as L}from"../canvas/deliveries.js";import{formatCard as _}from"../../shared/generated-context.js";const ct=_("restart-continuation",{},"continue");function y(t){return w(h(t),"initial-prompt.md")}i(y,"goalPath");function B(t){return j(f(t),y(t))}i(B,"readGoal");function J(t,n){const e=n.trim();e!==""&&R(f(t),y(t),e+`
+`)}i(J,"writeGoal");function pt(t,n){const e=B(t);if(e!==null&&e.trim()!=="")return!1;const o=n.trim();return o===""?!1:(J(t,o),!0)}i(pt,"captureGoalIfAbsent");function b(t){return w(h(t),"yield-message.md")}i(b,"yieldMessagePath");function ft(t,n){const e=n.trim();e!==""&&R(f(t),b(t),e+`
+`)}i(ft,"writeYieldMessage");function K(t){const n=j(f(t),b(t))?.trim()??"";return n!==""?n:null}i(K,"readYieldMessage");function ht(t){try{N(f(t),b(t))}catch{}}i(ht,"clearYieldMessage");function W(t){return $(t,h(t)).sort()}i(W,"listContextDir");function F(t){return $(t,v(t)).some(n=>n.endsWith(".md"))}i(F,"hasRetainedReports");function $(t,n){try{return A(f(t),n).map(e=>e.name)}catch(e){if(e.code==="ENOENT")return[];throw e}}i($,"agentDirNames");function mt(t,n){const e=t.node_id,o=K(e),s=t.run_id?[]:L(e,n),r=s.map(c=>c.message.messageId),d=s.map(U);let l=null;if(d.length>0){const c=i(p=>{const g=p.data?.cards;return Array.isArray(g)?g.filter(T=>typeof T=="string"):[]},"cardsFor"),m=[];for(const p of d)(c(p).length>0||m.length===0)&&m.push([]),m.at(-1).push(p);l=m.map(p=>[...c(p[0]),S(p).map(g=>g.text).join(`
 
 `)].join(`
 
 `)).join(`
 
-`)}const d=G(n),l=d?.guidance===void 0||d.guidance===""?null:d.guidance;return{yieldMsg:o,unreadDigest:r,driftGuidance:l}}s(ft,"drainBearings");const K=8;function W(e){return e.match(/^[0-9]{8}T[0-9]{6}-(.+)\.md$/)?.[1]??"report"}s(W,"reportKind");function H(e){const t=[];for(const n of j(e).filter(o=>o.active)){const o=k(n.node_id);if(!p(o))continue;const i=m(o).filter(d=>d.endsWith(".md")).sort().reverse();if(i.length===0)continue;const r=v(n.node_id);t.push({nodeId:n.node_id,name:r?.name??n.node_id,count:i.length,latest:i[0]})}return t.sort((n,o)=>o.latest.localeCompare(n.latest))}s(H,"reportHistorySources");function q(e,t){const n=j(e).filter(r=>r.active).map(r=>v(r.node_id)).filter(r=>r!==null&&(r.status==="active"||r.status==="idle")),o=[];if(n.length>0){const r=n.length,d=r===1?"it is":"they are",l=r===1?"it":"they",a=r===1?"pushes":"push";o.push(`Awaiting ${r} node${r===1?"":"s"} \u2014 ${d} alive and running right now, and will wake you the moment ${l} ${a}. The wake is automatic; nothing to check, poll, or verify.`);for(const u of n)o.push(`  - ${u.name} (${u.node_id}) \u2014 ${u.status}`);o.push("",t??"(no unread reports yet \u2014 expected while they run: a worker leaves no pointer until it pushes, so an empty feed means still working, not stalled)")}else o.push("Awaiting 0 nodes."),o.push("",t??"(no unread reports)");const i=H(e);if(i.length>0){const r=i.slice(0,K),d=i.length-r.length,l=i.reduce((a,u)=>a+u.count,0);o.push("",`Report history on disk (collapsed): ${l} report${l===1?"":"s"} across ${i.length} subscribed node${i.length===1?"":"s"}. This is a catch-up index for earlier reports; read only what matters.`,...r.map(a=>{const u=`${a.nodeId}:reports/${a.latest}`;return`  - ${a.name} (${a.nodeId}): ${a.count} report${a.count===1?"":"s"}; latest ${W(a.latest)}: ${u}`}),...d>0?[`  - \u2026 ${d} more subscribed node${d===1?"":"s"} with reports hidden`]:[],"Expand: `crtr canvas history read <ref>` for one listed report; `crtr node inspect artifacts <node-id> --type report` for that node's full report list; `crtr node inspect artifacts <node-id> --type inbox` for retained inbox history including full message bodies.")}return`<feed>
+`)}const a=P(e),u=a?.guidance===void 0||a.guidance===""?null:a.guidance;return{yieldMsg:o,unreadDigest:l,unreadMessageIds:r,driftGuidance:u}}i(mt,"drainBearings");const H=8;function q(t){return t.match(/^[0-9]{8}T[0-9]{6}-(.+)\.md$/)?.[1]??"report"}i(q,"reportKind");function z(t){const n=[];for(const e of k(t).filter(o=>o.active)){const o=$(e.node_id,v(e.node_id)).filter(r=>r.endsWith(".md")).sort().reverse();if(o.length===0)continue;const s=x(e.node_id);n.push({nodeId:e.node_id,name:s?.name??e.node_id,count:o.length,latest:o[0]})}return n.sort((e,o)=>o.latest.localeCompare(e.latest))}i(z,"reportHistorySources");function Q(t,n){const e=k(t).filter(r=>r.active).map(r=>x(r.node_id)).filter(r=>r!==null&&(r.status==="active"||r.status==="idle")),o=[];if(e.length>0){const r=e.length,d=r===1?"it is":"they are",l=r===1?"it":"they",a=r===1?"pushes":"push";o.push(`Awaiting ${r} node${r===1?"":"s"} \u2014 ${d} alive and running right now, and will wake you the moment ${l} ${a}. The wake is automatic; nothing to check, poll, or verify.`);for(const u of e)o.push(`  - ${u.name} (${u.node_id}) \u2014 ${u.status}`);o.push("",n??"(no unread reports yet \u2014 expected while they run: a worker leaves no pointer until it pushes, so an empty feed means still working, not stalled)")}else o.push("Awaiting 0 nodes."),o.push("",n??"(no unread reports)");const s=z(t);if(s.length>0){const r=s.slice(0,H),d=s.length-r.length,l=s.reduce((a,u)=>a+u.count,0);o.push("",`Report history on disk (collapsed): ${l} report${l===1?"":"s"} across ${s.length} subscribed node${s.length===1?"":"s"}. This is a catch-up index for earlier reports; read only what matters.`,...r.map(a=>{const u=`${a.nodeId}:reports/${a.latest}`;return`  - ${a.name} (${a.nodeId}): ${a.count} report${a.count===1?"":"s"}; latest ${q(a.latest)}: ${u}`}),...d>0?[`  - \u2026 ${d} more subscribed node${d===1?"":"s"} with reports hidden`]:[],"Expand: `crtr canvas history read <ref>` for one listed report; `crtr node inspect artifacts <node-id> --type report` for that node's full report list; `crtr node inspect artifacts <node-id> --type inbox` for retained inbox history including full message bodies.")}return`<feed>
 ${o.join(`
 `)}
-</feed>`}s(q,"feedBlock");function z(e,t){const n=(e??B(t)).trim()||"(no command)";return n.length>120?`${n.slice(0,117)}\u2026`:n}s(z,"jobLabel");function Q(e){const t=A(f(e));if(t.length===0)return null;const n=Date.now(),o=t.length===1,i=[`${t.length} background bash job${o?"":"s"} you started ${o?"is":"are"} STILL RUNNING, detached from any turn and unaffected by your refresh. Each one sends you a message when it exits \u2014 that wake is automatic, so do not poll it and do not relaunch the same command.`];for(const r of t)i.push(`  - ${r.jobId} \u2014 ${z(r.purpose,r.command)} \xB7 running ${E(n-r.startedAtMs)} \xB7 log ${r.logPath}`);return i.push("","Read output so far: `tail -n 50 <log>` (or `crtr node bash list --tail 20`). Abandon one: `crtr node bash kill <job-id>`."),`<background-jobs>
-${i.join(`
+</feed>`}i(Q,"feedBlock");function V(t,n){const e=(t??I(n)).trim()||"(no command)";return e.length>120?`${e.slice(0,117)}\u2026`:e}i(V,"jobLabel");function X(t){const n=O(h(t));if(n.length===0)return null;const e=Date.now(),o=n.length===1,s=[`${n.length} background bash job${o?"":"s"} you started ${o?"is":"are"} STILL RUNNING, detached from any turn and unaffected by your refresh. Each one sends you a message when it exits \u2014 that wake is automatic, so do not poll it and do not relaunch the same command.`];for(const r of n)s.push(`  - ${r.jobId} \u2014 ${V(r.purpose,r.command)} \xB7 running ${D(e-r.startedAtMs)} \xB7 log ${r.logPath}`);return s.push("","Read output so far: `tail -n 50 <log>` (or `crtr node bash list --tail 20`). Abandon one: `crtr node bash kill <job-id>`."),`<background-jobs>
+${s.join(`
 `)}
-</background-jobs>`}s(Q,"backgroundJobsBlock");function pt(e,t,n){const o=e.node_id,i=["You have been revived fresh after a context refresh \u2014 your previous in-memory context is gone, by design. Everything below was just read from disk; it is your full bearings. Rebuild from it and continue toward your goal."];n!==void 0&&i.push(C(n));const r=O(o),d=r!==null&&r.trim()!=="";if(i.push(`<roadmap file="${N(o)}">
+</background-jobs>`}i(X,"backgroundJobsBlock");function gt(t,n,e){const o=t.node_id,s=["You have been revived fresh after a context refresh \u2014 your previous in-memory context is gone, by design. Everything below was just read from disk; it is your full bearings. Rebuild from it and continue toward your goal."];e!==void 0&&s.push(Y(e));const r=C(o),d=r!==null&&r.trim()!=="";if(s.push(`<roadmap file="${G(o)}">
 ${d?r.trim():"(no roadmap on disk yet)"}
-</roadmap>`),!d&&!J(o)){const c=_(o);c!==null&&c.trim()!==""&&i.push(`<goal file="${g(o)}">
+</roadmap>`),!d&&!F(o)){const c=B(o);c!==null&&c.trim()!==""&&s.push(`<goal file="${y(o)}">
 ${c.trim()}
-</goal>`)}const l=F(o).filter(c=>c!=="yield-message.md");i.push(`<context-dir path="${f(o)}">
+</goal>`)}const l=W(o).filter(c=>c!=="yield-message.md");s.push(`<context-dir path="${h(o)}">
 ${l.length>0?l.join(`
 `):"(empty)"}
-</context-dir>`);const a=Q(o);a!==null&&i.push(a),i.push(q(o,t.unreadDigest)),i.push(t.yieldMsg!==null?`<yield-message>
-${t.yieldMsg.trim()}
-</yield-message>`:"<yield-message/>");const u=T(o).length>0;return i.push(u?"If there is work to do, perform it. Otherwise stop \u2014 pipe the result to `crtr push final` through a single-quoted heredoc if the goal is met, or end your turn without a message to stay dormant awaiting your workers.":"If there is work to do, perform it. Otherwise end your turn without writing a message \u2014 the user already has your last reply, and a status recap would only bury it. You are working directly with the user, so stay available and continue when they write back."),t.driftGuidance!==null&&i.push(`<persona-transition>
-Your role was changed while you were away. ${t.driftGuidance}
-</persona-transition>`),R("revive",{},`
-${i.join(`
+</context-dir>`);const a=X(o);a!==null&&s.push(a),s.push(Q(o,n.unreadDigest)),s.push(n.yieldMsg!==null?`<yield-message>
+${n.yieldMsg.trim()}
+</yield-message>`:"<yield-message/>");const u=M(o).length>0;return s.push(u?"If there is work to do, perform it. Otherwise stop \u2014 pipe the result to `crtr push final` through a single-quoted heredoc if the goal is met, or end your turn without a message to stay dormant awaiting your workers.":"If there is work to do, perform it. Otherwise end your turn without writing a message \u2014 the user already has your last reply, and a status recap would only bury it. You are working directly with the user, so stay available and continue when they write back."),n.driftGuidance!==null&&s.push(`<persona-transition>
+Your role was changed while you were away. ${n.driftGuidance}
+</persona-transition>`),_("revive",{},`
+${s.join(`
 
 `)}
-`)}s(pt,"buildReviveKickoff");export{dt as RUNTIME_RESTART_CONTINUATION,pt as buildReviveKickoff,ut as captureGoalIfAbsent,lt as clearYieldMessage,ft as drainBearings,g as goalPath,J as hasRetainedReports,F as listContextDir,_ as readGoal,L as readYieldMessage,U as writeGoal,ct as writeYieldMessage,y as yieldMessagePath};
+`)}i(gt,"buildReviveKickoff");export{ct as RUNTIME_RESTART_CONTINUATION,gt as buildReviveKickoff,pt as captureGoalIfAbsent,ht as clearYieldMessage,mt as drainBearings,y as goalPath,F as hasRetainedReports,W as listContextDir,B as readGoal,K as readYieldMessage,J as writeGoal,ft as writeYieldMessage,b as yieldMessagePath};

package/dist/core/runtime/launch-target.d.ts

@@ -22,4 +22,4 @@ export declare function resolveLaunchTarget(req: CreateNodeRequest, options?: {
     validateKind?: (kind: string) => void | Promise<void>;
 }): Promise<ResolvedLaunchTarget>;
 /** The directory a new node is pinned to. */
-export declare function resolveNodeCwd(req: CreateNodeRequest, parent: string | undefined, profileId: string | null, contextCwd: string): string;
+export declare function resolveNodeCwd(req: CreateNodeRequest, parent: string | undefined, _profileId: string | null, contextCwd: string): string;

package/dist/core/runtime/launch-target.js

@@ -1 +1 @@
-var u=Object.defineProperty;var r=(e,n)=>u(e,"name",{value:n,configurable:!0});import{envProfileId as m}from"../../shared/env.js";import{resolve as s}from"node:path";import{getNode as p}from"../canvas/canvas.js";import{usage as w}from"../errors.js";import{assertProfileActive as v,profileHome as y}from"../profiles/manifest.js";import{buildLaunchSpecAsync as h,readMergedLaunchConfigAsync as g}from"./launch.js";import{resolveProfileId as k}from"./spawn.js";function x(e,n){return e??n?.manifest.default_kind??"general"}r(x,"resolveCreateKind");async function _(e,n=process.cwd(),t=m()||null){const i=Object.keys((await g(n,t)).kinds);if(!i.includes(e))throw w(`unknown kind: ${e}`,{received:e,next:`Valid kinds: ${i.sort().join(", ")}.`})}r(_,"assertLaunchKind");async function j(e,n={}){const t=e.parent??void 0,i=e.cwd??process.cwd(),o=await k(e.profile,t??null,i,{readOnlySelection:n.readOnlyProfileSelection}),l=v(o),d=x(e.kind,l);await n.validateKind?.(d);const c=C({...e,kind:d},t,o,i);n.validateKind===void 0&&await _(d,c,o);const a=e.mode??"base",f=(await h(d,a,{lifecycle:e.root_lifecycle??(e.root===!0?"resident":"terminal"),hasManager:e.root!==!0,...e.model!==void 0?{model:e.model,modelOverride:!0}:{},cwd:c,profileId:o})).launch;return{profileId:o,profile:l,kind:d,mode:a,cwd:c,launch:f}}r(j,"resolveLaunchTarget");function C(e,n,t,i){if(e.pin_cwd!==void 0&&e.pin_cwd!=="")return s(e.pin_cwd);if(n!=null){const o=p(n);if(o!==null)return o.cwd}return e.cwd!==void 0&&e.cwd!==""?s(e.cwd):y(t)??i}r(C,"resolveNodeCwd");export{_ as assertLaunchKind,x as resolveCreateKind,j as resolveLaunchTarget,C as resolveNodeCwd};
+var u=Object.defineProperty;var d=(e,n)=>u(e,"name",{value:n,configurable:!0});import{appSpace as p}from"../layout.js";import{envProfileId as m}from"../../shared/env.js";import{resolve as s}from"node:path";import{getNode as w}from"../canvas/canvas.js";import{usage as v}from"../errors.js";import{assertProfileActive as y}from"../profiles/manifest.js";import{buildLaunchSpecAsync as h,readMergedLaunchConfigAsync as g}from"./launch.js";import{resolveProfileId as k}from"./spawn.js";function x(e,n){return e??n?.manifest.default_kind??"general"}d(x,"resolveCreateKind");async function _(e,n=process.cwd(),t=m()||null){const i=Object.keys((await g(n,t)).kinds);if(!i.includes(e))throw v(`unknown kind: ${e}`,{received:e,next:`Valid kinds: ${i.sort().join(", ")}.`})}d(_,"assertLaunchKind");async function M(e,n={}){const t=e.parent??void 0,i=e.cwd??process.cwd(),o=await k(e.profile,t??null,i,{readOnlySelection:n.readOnlyProfileSelection}),l=y(o),r=x(e.kind,l);await n.validateKind?.(r);const c=C({...e,kind:r},t,o,i);n.validateKind===void 0&&await _(r,c,o);const a=e.mode??"base",f=(await h(r,a,{lifecycle:e.root_lifecycle??(e.root===!0?"resident":"terminal"),hasManager:e.root!==!0,...e.model!==void 0?{model:e.model,modelOverride:!0}:{},cwd:c,profileId:o})).launch;return{profileId:o,profile:l,kind:r,mode:a,cwd:c,launch:f}}d(M,"resolveLaunchTarget");function C(e,n,t,i){if(e.pin_cwd!==void 0&&e.pin_cwd!=="")return s(e.pin_cwd);if(n!=null){const o=w(n);if(o!==null)return o.cwd}return e.cwd!==void 0&&e.cwd!==""?s(e.cwd):process.platform==="linux"?p("terminal").files:i}d(C,"resolveNodeCwd");export{_ as assertLaunchKind,x as resolveCreateKind,M as resolveLaunchTarget,C as resolveNodeCwd};

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

@@ -2,18 +2,9 @@ import { type MergedLaunchConfig } from '../config.js';
 import type { PiInvocation } from './invocation.js';
 export { CANVAS_EXTENSIONS, CANVAS_STOPHOOK_PATH, CANVAS_INBOX_WATCHER_PATH, CANVAS_RECAP_PATH, CANVAS_GOAL_CAPTURE_PATH, CANVAS_PASSIVE_CONTEXT_PATH, CANVAS_CONTEXT_INTRO_PATH, CANVAS_TOOL_GUIDE_PATH, CANVAS_DOC_SUBSTRATE_PATH, CANVAS_STRUCTURED_OUTPUT_PATH, CANVAS_BASH_VALVE_PATH, } from './canvas-extensions.js';
 import type { NodeMeta, LaunchSpec, Mode, Lifecycle } from '../canvas/index.js';
-import type { ModelProvider, ModelStrength, ScopeConfig } from '../../types.js';
+import type { ModelIntent, ModelProvider, ScopeConfig } from '../../types.js';
 export { OPENAI_PROVIDER_ENV, configuredLadderProviders, inferPortableModelSelection } from './model-selection.js';
 export type { PortableModelSelection } from './model-selection.js';
-/** True when an explicit model token is QUALIFIED — a `<provider>/<model-id>`
- *  or `<provider>/<tier>` raw token — the structural marker of a concrete exact
- *  pick. Deliberately provider-agnostic: a real registry provider namespace
- *  (`anthropic`, `openai-codex`, a user's own `amazon-bedrock`, …)
- *  qualifies identically, so the rule never depends on a fixed provider
- *  allowlist and never needs updating as providers are added. A bare tier
- *  (`ultra`) or bare family alias (`opus`/`sonnet`/`haiku`) has no `/` and
- *  stays unpinned. */
-export declare function isProviderPinnedModelToken(model: string): boolean;
 /** True when `model` is a PORTABLE ladder token — a bare strength/alias
  *  (`ultra`, `normal`, `opus`, …), a `<family>/<strength>` pair, or an
  *  anthropic family alias — i.e. a logical preference rather than a concrete
@@ -22,10 +13,13 @@ export declare function isProviderPinnedModelToken(model: string): boolean;
  *  ladder the running build ships, so they never freeze a stale concrete model
  *  id to disk. */
 export declare function isPortableModelToken(model: string): boolean;
-export declare function logicalModelIntent(model: string, ladders?: ScopeConfig['modelLadders']): {
-    family: string;
-    strength: ModelStrength;
-} | undefined;
+export declare function logicalModelIntent(model: string, ladders?: ScopeConfig['modelLadders']): ModelIntent | undefined;
+/** The routing contract an explicit model choice asks for, decided from the RAW
+ *  token: a portable token (`anthropic/strong`, `strong`, `opus`) is an intent
+ *  that may rotate to another family at the same strength; any other token names
+ *  one model exactly (undefined). `node new --model`, `node config --model`, and
+ *  a viewer `/model` all apply this one rule. */
+export declare function explicitModelIntent(model: string, ladders?: ScopeConfig['modelLadders']): ModelIntent | undefined;
 export declare function normalizeModel(model: string, ladders?: ScopeConfig['modelLadders']): string;
 /** The interleaved model-ladder cycle Alt+M / Alt+Shift+M walks: for each strength tier
  *  from strongest to weakest, each offered provider before descending — anthropic/ultra,
@@ -88,24 +82,8 @@ export interface LaunchBuildOptions {
      *  exactly the path that creates the user's sessions — so callers that
      *  know the node's profile must pass it explicitly (null = no profile). */
     profileId?: string | null;
-    /** Carry an EXISTING node's pin verbatim through a rebuild that supplies
-     *  no NEW `--model` override (a polymorph/lifecycle/kind change, or a
-     *  fresh-root relaunch). When set (including `false`), this wins over the
-     *  token-shape derivation below — the pin is decided exactly once, at the
-     *  moment of an explicit user model change, from that change's RAW token;
-     *  every other rebuild must preserve it rather than re-infer it from
-     *  `opts.model`, which may be a portablized `model_override` whose shape
-     *  no longer reflects the original raw pick (e.g. a concrete pin that
-     *  happens to byte-equal a ladder tier cell). Leave undefined for genuine
-     *  first-spawn and for an explicit new `--model` override on
-     *  promote/config, where `opts.model`'s shape IS the raw token and
-     *  legitimately re-decides the pin. */
-    modelProviderPinned?: boolean;
     /** Preserved intent from an existing launch recipe when rebuilding it. */
-    modelIntent?: {
-        family: string;
-        strength: ModelStrength;
-    };
+    modelIntent?: ModelIntent;
     /** Exact-consult launch: pass the captured `provider/id:thinking` spec
      *  verbatim as `launch.model`, skipping `floorReviewModel`/`normalizeModel`
      *  entirely (avoids any tier-collision reinterpretation). `opts.model` MUST
@@ -160,8 +138,7 @@ export declare function buildPiArgv(meta: NodeMeta, opts?: {
  *  maps one of buildPiArgv's emitted flags back to its SDK option:
  *  `-e`→`extensionPaths`, `-n`→`editorName`, `--fork`→`forkFrom`,
  *  `--session`→`resumeSessionPath|resumeSessionId`, `--crtr-new-cycle`→
- *  `newCycle`, `--model`→`model`, `--crtr-model-provider-pinned`→
- *  `modelProviderPinned`, `--crtr-model-exact`→`modelExact`, `--tools`→`tools`,
+ *  `newCycle`, `--model`→`model`, `--crtr-model-exact`→`modelExact`, `--tools`→`tools`,
  *  `--append-system-prompt`→`appendSystemPromptPath`, the trailing
  *  positional→`firstPrompt`. */
 export interface BrokerSdkConfig {
@@ -186,8 +163,6 @@ export interface BrokerSdkConfig {
     newCycle?: boolean;
     /** Model spec, e.g. `anthropic/sonnet` (`--model`). */
     model?: string;
-    /** A caller explicitly pinned `--model` to a provider; only a managed launch cooldown permits fallback. */
-    modelProviderPinned?: boolean;
     /** Exact-consult launch (`--crtr-model-exact`): `model` must run verbatim —
      *  every launch-time/turn-time fallback is bypassed and unavailability must
      *  fail rather than substitute. */

package/dist/core/runtime/launch.js

@@ -1 +1 @@
-var O=Object.defineProperty;var c=(n,r)=>O(n,"name",{value:r,configurable:!0});import{envProfileId as P}from"../../shared/env.js";import{mkdirSync as y,writeFileSync as w}from"node:fs";import{join as L}from"node:path";import{readMergedLaunchConfig as R}from"../config.js";import{fork as b}from"node:child_process";import{fileURLToPath as H}from"node:url";import{LAUNCH_SYSTEM_PROMPT as V}from"./launch-prompt.js";import{nodeEnv as M}from"./nodes.js";import{editorLabel as U}from"../canvas/index.js";import{CANVAS_EXTENSIONS as Ae,CANVAS_STOPHOOK_PATH as Pe,CANVAS_INBOX_WATCHER_PATH as Te,CANVAS_RECAP_PATH as _e,CANVAS_GOAL_CAPTURE_PATH as xe,CANVAS_PASSIVE_CONTEXT_PATH as Ee,CANVAS_CONTEXT_INTRO_PATH as ve,CANVAS_TOOL_GUIDE_PATH as Ie,CANVAS_DOC_SUBSTRATE_PATH as ke,CANVAS_STRUCTURED_OUTPUT_PATH as Ce,CANVAS_BASH_VALVE_PATH as Ne}from"./canvas-extensions.js";import{nodeDir as D}from"../canvas/paths.js";import{CANVAS_EXTENSIONS as F,mergeCanvasExtensions as T,assertMandatoryCanvasExtensions as G}from"./canvas-extensions.js";import{modelLadders as d,defaultProvider as _,STRENGTH_ALIASES as l,MODEL_PROVIDER_KEYS as S,MODEL_STRENGTHS as g,THINKING_SUFFIXES as K,stripThinkingSuffix as a}from"./model-selection.js";import{OPENAI_PROVIDER_ENV as ye,configuredLadderProviders as we,inferPortableModelSelection as Le}from"./model-selection.js";function x(n,r=d()){return r[n]}c(x,"ladderFor");const h={light:0,medium:1,strong:2,ultra:3};function X(n,r,e){const t=a(n);for(const o of[!0,!1]){const i=o?g:[...g].sort((u,f)=>h[u]-h[f]);for(const u of e)for(const f of i){const s=r[u][f];if(!(o?s!==n:a(s)!==t))return{provider:u,strength:f}}}return null}c(X,"findLadderCell");function E(n){const r=n.lastIndexOf("/"),e=r===-1?void 0:n.slice(0,r),t=r===-1?n:n.slice(r+1),o=l[t];return o!==void 0?o:e!==void 0&&e!=="anthropic"?null:t==="opus"?"strong":t==="sonnet"?"medium":t==="haiku"?"light":null}c(E,"modelTokenStrength");function v(n,r=d()){const e=E(n);return e!==null?e:X(A(n,r),r,S)?.strength??null}c(v,"resolvedModelStrength");function $(n){return n==="review"||n.startsWith("review/")||n.includes("/reviewers/")}c($,"isReviewQualityKind");function B(n,r,e,t=d()){if(r===void 0)return e;if(!$(n)||e===void 0)return r;const o=v(r,t),i=v(e,t);return o===null||i===null?r:h[o]<h[i]?e:r}c(B,"floorReviewModel");function W(n){return n.includes("/")&&!I(n)}c(W,"isProviderPinnedModelToken");function I(n){if(n.includes("/")){const r=n.lastIndexOf("/"),e=n.slice(0,r),t=n.slice(r+1);return e!==""&&(l[t]!==void 0||e==="anthropic"&&(t==="opus"||t==="sonnet"||t==="haiku"))}return l[n]!==void 0||n==="opus"||n==="sonnet"||n==="haiku"}c(I,"isPortableModelToken");function z(n,r=d()){const e=E(n);if(e!==null)return n.includes("/")?{family:n.slice(0,n.lastIndexOf("/")),strength:e}:n==="opus"||n==="sonnet"||n==="haiku"?{family:"anthropic",strength:e}:{family:_(r),strength:e}}c(z,"logicalModelIntent");function A(n,r=d()){if(n.includes("/")){const t=n.indexOf("/"),o=n.slice(0,t),i=n.slice(t+1),u=l[i];if(u!==void 0&&(o==="anthropic"||o==="openai"))return x(o,r)[u];if(o==="anthropic"){if(i==="opus")return r.anthropic.strong;if(i==="sonnet")return r.anthropic.medium;if(i==="haiku")return r.anthropic.light}return n}const e=l[n];return e!==void 0?x(_(r),r)[e]:n==="opus"?r.anthropic.strong:n==="sonnet"?r.anthropic.medium:n==="haiku"?r.anthropic.light:n}c(A,"normalizeModel");function k(n){const r=n.lastIndexOf(":");if(r<=0)return;const e=n.slice(r+1);return K.has(e)?e:void 0}c(k,"thinkingSuffixOf");function Y(n=S){const r=n.length>0?n:S,e=d(),t=[];for(const o of g)for(const i of r)t.push(e[i][o]);return t}c(Y,"interleavedLadderCycle");function le(n,r=1,e){const t=Y(e),o=A(n),i=a(o),u=k(o);let f=t.findIndex(s=>a(s)===i&&k(s)===u);return f===-1&&(f=t.findIndex(s=>a(s)===i)),f===-1?t[0]:t[(f+r+t.length)%t.length]}c(le,"nextLadderModel");function C(n,r,e,t){const o=t.kinds[n],i=t.modelLadders,u=r==="orchestrator"?o?.orchestratorModel??o?.model:o?.model,f=e.modelExact===!0?e.model:B(n,e.model,u,i),s=e.modelExact===!0||e.modelOverride===!0&&e.model!==void 0&&!I(e.model),p=e.modelExact===!0?f:f!==void 0?A(f,i):void 0,m=s?void 0:e.modelIntent??(f!==void 0?z(f,i):void 0);return{launch:{model:p,modelIntent:m,modelProviderPinned:e.modelProviderPinned!==void 0?e.modelProviderPinned:e.model!==void 0&&W(e.model),modelExact:s?!0:void 0,tools:o?.tools??[],extensions:T([...F,...o?.extensions??[]]),systemPrompt:V,env:{...e.extraEnv??{},...m?{CRTR_MODEL_INTENT:`${m.family}/${m.strength}`}:{}}},lifecycle:e.lifecycle}}c(C,"buildLaunchSpecFromMerged");function ae(n,r,e){return C(n,r,e,R(e.cwd??process.cwd(),e.profileId!==void 0?e.profileId:P()||null))}c(ae,"buildLaunchSpec");async function me(n,r,e){const t=e.cwd??process.cwd(),o=e.profileId!==void 0?e.profileId:P()||null,i=await j(t,o);return C(n,r,e,i)}c(me,"buildLaunchSpecAsync");const N=15e3;function j(n,r){return new Promise((e,t)=>{const o=b(H(new URL("./launch-config-worker.js",import.meta.url)),[],{stdio:["ignore","ignore","ignore","ipc"],serialization:"advanced"});o.send({cwd:n,profileId:r});let i=!1;const u=c(s=>{i||(i=!0,clearTimeout(f),o.connected&&o.disconnect(),o.killed||o.kill("SIGKILL"),s())},"finish"),f=setTimeout(()=>u(()=>t(new Error(`timed out after ${N}ms reading launch config for ${n}`))),N);o.once("message",s=>{s.error!==void 0?u(()=>t(new Error(s.error))):s.config!==void 0?u(()=>e(s.config)):u(()=>t(new Error("launch config subprocess returned no result")))}),o.once("error",s=>u(()=>t(s))),o.once("exit",(s,p)=>{s!==0&&p!=="SIGKILL"&&u(()=>t(new Error(`launch config subprocess exited with code ${s}`)))})})}c(j,"readMergedLaunchConfigAsync");function Q(n,r){try{const e=D(n);y(e,{recursive:!0});const t=L(e,"system-prompt.md");return w(t,r,"utf8"),t}catch{return null}}c(Q,"writeSystemPromptFile");function he(n,r={}){const e=n.launch,t=T(e?.extensions);G(t);const o=[];for(const i of t)o.push("-e",i);if(o.push("-n",U(n)),r.forkFrom!==void 0&&r.forkFrom!=="")o.push("--fork",r.forkFrom);else{const i=r.resumeSessionPath??r.resumeSessionId;i!==void 0&&o.push("--session",i),r.newCycle===!0&&o.push("--crtr-new-cycle")}if(e?.model!==void 0&&o.push("--model",e.model),e?.modelProviderPinned===!0&&o.push("--crtr-model-provider-pinned"),e?.modelExact===!0&&o.push("--crtr-model-exact"),e?.tools!==void 0&&e.tools.length>0&&o.push("--tools",e.tools.join(",")),e?.systemPrompt!==void 0&&e.systemPrompt!==""){const i=Q(n.node_id,e.systemPrompt)??e.systemPrompt;o.push("--append-system-prompt",i)}return r.prompt!==void 0&&r.prompt!==""&&o.push(r.prompt),{argv:o,env:M(n)}}c(he,"buildPiArgv");function pe(n){for(const[t,o]of Object.entries(n.env))process.env[t]=o;const r={cwd:n.env.CRTR_NODE_CWD??process.cwd(),extensionPaths:[]},e=n.argv;for(let t=0;t<e.length;t++){const o=e[t];switch(o){case"-e":r.extensionPaths.push(e[++t]);break;case"-n":r.editorName=e[++t];break;case"--fork":r.forkFrom=e[++t];break;case"--session":{const i=e[++t];i.includes("/")||i.endsWith(".jsonl")?r.resumeSessionPath=i:r.resumeSessionId=i;break}case"--model":r.model=e[++t];break;case"--crtr-model-provider-pinned":r.modelProviderPinned=!0;break;case"--crtr-model-exact":r.modelExact=!0;break;case"--tools":r.tools=e[++t].split(",").filter(i=>i!=="");break;case"--append-system-prompt":r.appendSystemPromptPath=e[++t];break;case"--crtr-new-cycle":r.newCycle=!0;break;default:r.firstPrompt=o;break}}return r}c(pe,"piInvocationToSdkConfig");export{Ne as CANVAS_BASH_VALVE_PATH,ve as CANVAS_CONTEXT_INTRO_PATH,ke as CANVAS_DOC_SUBSTRATE_PATH,Ae as CANVAS_EXTENSIONS,xe as CANVAS_GOAL_CAPTURE_PATH,Te as CANVAS_INBOX_WATCHER_PATH,Ee as CANVAS_PASSIVE_CONTEXT_PATH,_e as CANVAS_RECAP_PATH,Pe as CANVAS_STOPHOOK_PATH,Ce as CANVAS_STRUCTURED_OUTPUT_PATH,Ie as CANVAS_TOOL_GUIDE_PATH,ye as OPENAI_PROVIDER_ENV,ae as buildLaunchSpec,me as buildLaunchSpecAsync,he as buildPiArgv,we as configuredLadderProviders,Le as inferPortableModelSelection,Y as interleavedLadderCycle,I as isPortableModelToken,W as isProviderPinnedModelToken,z as logicalModelIntent,le as nextLadderModel,A as normalizeModel,pe as piInvocationToSdkConfig,j as readMergedLaunchConfigAsync};
+var y=Object.defineProperty;var c=(e,r)=>y(e,"name",{value:r,configurable:!0});import{envProfileId as _}from"../../shared/env.js";import{mkdirSync as w}from"node:fs";import{join as L}from"node:path";import{readMergedLaunchConfig as R}from"../config.js";import{fork as b}from"node:child_process";import{fileURLToPath as H}from"node:url";import{LAUNCH_SYSTEM_PROMPT as V}from"./launch-prompt.js";import{nodeEnv as M}from"./nodes.js";import{editorLabel as U}from"../canvas/index.js";import{CANVAS_EXTENSIONS as xe,CANVAS_STOPHOOK_PATH as Ee,CANVAS_INBOX_WATCHER_PATH as Pe,CANVAS_RECAP_PATH as Ie,CANVAS_GOAL_CAPTURE_PATH as Ce,CANVAS_PASSIVE_CONTEXT_PATH as Ne,CANVAS_CONTEXT_INTRO_PATH as ke,CANVAS_TOOL_GUIDE_PATH as Oe,CANVAS_DOC_SUBSTRATE_PATH as ve,CANVAS_STRUCTURED_OUTPUT_PATH as ye,CANVAS_BASH_VALVE_PATH as we}from"./canvas-extensions.js";import{nodeRunDir as D}from"../canvas/paths.js";import{writeFileBeneath as F}from"../spaces/open-beneath.js";import{projectOutputSchema as G}from"./structured-output.js";import{CANVAS_EXTENSIONS as K,mergeCanvasExtensions as T,assertMandatoryCanvasExtensions as X}from"./canvas-extensions.js";import{modelLadders as d,defaultProvider as x,STRENGTH_ALIASES as l,MODEL_PROVIDER_KEYS as S,MODEL_STRENGTHS as g,THINKING_SUFFIXES as B,stripThinkingSuffix as a}from"./model-selection.js";import{OPENAI_PROVIDER_ENV as Re,configuredLadderProviders as be,inferPortableModelSelection as He}from"./model-selection.js";function E(e,r=d()){return r[e]}c(E,"ladderFor");const p={light:0,medium:1,strong:2,ultra:3};function $(e,r,n){const t=a(e);for(const o of[!0,!1]){const i=o?g:[...g].sort((u,f)=>p[u]-p[f]);for(const u of n)for(const f of i){const s=r[u][f];if(!(o?s!==e:a(s)!==t))return{provider:u,strength:f}}}return null}c($,"findLadderCell");function P(e){const r=e.lastIndexOf("/"),n=r===-1?void 0:e.slice(0,r),t=r===-1?e:e.slice(r+1),o=l[t];return o!==void 0?o:n!==void 0&&n!=="anthropic"?null:t==="opus"?"strong":t==="sonnet"?"medium":t==="haiku"?"light":null}c(P,"modelTokenStrength");function I(e,r=d()){const n=P(e);return n!==null?n:$(A(e,r),r,S)?.strength??null}c(I,"resolvedModelStrength");function W(e){return e==="review"||e.startsWith("review/")||e.includes("/reviewers/")}c(W,"isReviewQualityKind");function j(e,r,n,t=d()){if(r===void 0)return n;if(!W(e)||n===void 0)return r;const o=I(r,t),i=I(n,t);return o===null||i===null?r:p[o]<p[i]?n:r}c(j,"floorReviewModel");function C(e){if(e.includes("/")){const r=e.lastIndexOf("/"),n=e.slice(0,r),t=e.slice(r+1);return n!==""&&(l[t]!==void 0||n==="anthropic"&&(t==="opus"||t==="sonnet"||t==="haiku"))}return l[e]!==void 0||e==="opus"||e==="sonnet"||e==="haiku"}c(C,"isPortableModelToken");function N(e,r=d()){const n=P(e);if(n!==null)return e.includes("/")?{family:e.slice(0,e.lastIndexOf("/")),strength:n}:e==="opus"||e==="sonnet"||e==="haiku"?{family:"anthropic",strength:n}:{family:x(r),strength:n}}c(N,"logicalModelIntent");function he(e,r=d()){return C(e)?N(e,r):void 0}c(he,"explicitModelIntent");function A(e,r=d()){if(e.includes("/")){const t=e.indexOf("/"),o=e.slice(0,t),i=e.slice(t+1),u=l[i];if(u!==void 0&&(o==="anthropic"||o==="openai"))return E(o,r)[u];if(o==="anthropic"){if(i==="opus")return r.anthropic.strong;if(i==="sonnet")return r.anthropic.medium;if(i==="haiku")return r.anthropic.light}return e}const n=l[e];return n!==void 0?E(x(r),r)[n]:e==="opus"?r.anthropic.strong:e==="sonnet"?r.anthropic.medium:e==="haiku"?r.anthropic.light:e}c(A,"normalizeModel");function k(e){const r=e.lastIndexOf(":");if(r<=0)return;const n=e.slice(r+1);return B.has(n)?n:void 0}c(k,"thinkingSuffixOf");function z(e=S){const r=e.length>0?e:S,n=d(),t=[];for(const o of g)for(const i of r)t.push(n[i][o]);return t}c(z,"interleavedLadderCycle");function pe(e,r=1,n){const t=z(n),o=A(e),i=a(o),u=k(o);let f=t.findIndex(s=>a(s)===i&&k(s)===u);return f===-1&&(f=t.findIndex(s=>a(s)===i)),f===-1?t[0]:t[(f+r+t.length)%t.length]}c(pe,"nextLadderModel");function O(e,r,n,t){const o=t.kinds[e],i=t.modelLadders,u=r==="orchestrator"?o?.orchestratorModel??o?.model:o?.model,f=n.modelExact===!0?n.model:j(e,n.model,u,i),s=n.modelExact===!0||n.modelOverride===!0&&n.model!==void 0&&!C(n.model),m=n.modelExact===!0?f:f!==void 0?A(f,i):void 0,h=s?void 0:n.modelIntent??(f!==void 0?N(f,i):void 0);return{launch:{model:m,modelIntent:h,modelExact:s?!0:void 0,tools:o?.tools??[],extensions:T([...K,...o?.extensions??[]]),systemPrompt:V,env:{...n.extraEnv??{},...h?{CRTR_MODEL_INTENT:`${h.family}/${h.strength}`}:{}}},lifecycle:n.lifecycle}}c(O,"buildLaunchSpecFromMerged");function me(e,r,n){return O(e,r,n,R(n.cwd??process.cwd(),n.profileId!==void 0?n.profileId:_()||null))}c(me,"buildLaunchSpec");async function Se(e,r,n){const t=n.cwd??process.cwd(),o=n.profileId!==void 0?n.profileId:_()||null,i=await Y(t,o);return O(e,r,n,i)}c(Se,"buildLaunchSpecAsync");const v=15e3;function Y(e,r){return new Promise((n,t)=>{const o=b(H(new URL("./launch-config-worker.js",import.meta.url)),[],{stdio:["ignore","ignore","ignore","ipc"],serialization:"advanced"});o.send({cwd:e,profileId:r});let i=!1;const u=c(s=>{i||(i=!0,clearTimeout(f),o.connected&&o.disconnect(),o.killed||o.kill("SIGKILL"),s())},"finish"),f=setTimeout(()=>u(()=>t(new Error(`timed out after ${v}ms reading launch config for ${e}`))),v);o.once("message",s=>{s.error!==void 0?u(()=>t(new Error(s.error))):s.config!==void 0?u(()=>n(s.config)):u(()=>t(new Error("launch config subprocess returned no result")))}),o.once("error",s=>u(()=>t(s))),o.once("exit",(s,m)=>{s!==0&&m!=="SIGKILL"&&u(()=>t(new Error(`launch config subprocess exited with code ${s}`)))})})}c(Y,"readMergedLaunchConfigAsync");function Q(e,r){try{const n=D(e);w(n,{recursive:!0});const t=L(n,"system-prompt.md");return F(n,t,r,{atomic:!0}),t}catch{return null}}c(Q,"writeSystemPromptFile");function ge(e,r={}){const n=e.launch,t=T(n?.extensions);X(t);const o=[];for(const i of t)o.push("-e",i);if(o.push("-n",U(e)),r.forkFrom!==void 0&&r.forkFrom!=="")o.push("--fork",r.forkFrom);else{const i=r.resumeSessionPath??r.resumeSessionId;i!==void 0&&o.push("--session",i),r.newCycle===!0&&o.push("--crtr-new-cycle")}if(n?.model!==void 0&&o.push("--model",n.model),n?.modelExact===!0&&o.push("--crtr-model-exact"),n?.tools!==void 0&&n.tools.length>0&&o.push("--tools",n.tools.join(",")),n?.systemPrompt!==void 0&&n.systemPrompt!==""){const i=Q(e.node_id,n.systemPrompt)??n.systemPrompt;o.push("--append-system-prompt",i)}return r.prompt!==void 0&&r.prompt!==""&&o.push(r.prompt),G(e.node_id),{argv:o,env:M(e)}}c(ge,"buildPiArgv");function Ae(e){for(const[t,o]of Object.entries(e.env))process.env[t]=o;const r={cwd:e.env.CRTR_NODE_CWD??process.cwd(),extensionPaths:[]},n=e.argv;for(let t=0;t<n.length;t++){const o=n[t];switch(o){case"-e":r.extensionPaths.push(n[++t]);break;case"-n":r.editorName=n[++t];break;case"--fork":r.forkFrom=n[++t];break;case"--session":{const i=n[++t];i.includes("/")||i.endsWith(".jsonl")?r.resumeSessionPath=i:r.resumeSessionId=i;break}case"--model":r.model=n[++t];break;case"--crtr-model-exact":r.modelExact=!0;break;case"--tools":r.tools=n[++t].split(",").filter(i=>i!=="");break;case"--append-system-prompt":r.appendSystemPromptPath=n[++t];break;case"--crtr-new-cycle":r.newCycle=!0;break;default:r.firstPrompt=o;break}}return r}c(Ae,"piInvocationToSdkConfig");export{we as CANVAS_BASH_VALVE_PATH,ke as CANVAS_CONTEXT_INTRO_PATH,ve as CANVAS_DOC_SUBSTRATE_PATH,xe as CANVAS_EXTENSIONS,Ce as CANVAS_GOAL_CAPTURE_PATH,Pe as CANVAS_INBOX_WATCHER_PATH,Ne as CANVAS_PASSIVE_CONTEXT_PATH,Ie as CANVAS_RECAP_PATH,Ee as CANVAS_STOPHOOK_PATH,ye as CANVAS_STRUCTURED_OUTPUT_PATH,Oe as CANVAS_TOOL_GUIDE_PATH,Re as OPENAI_PROVIDER_ENV,me as buildLaunchSpec,Se as buildLaunchSpecAsync,ge as buildPiArgv,be as configuredLadderProviders,he as explicitModelIntent,He as inferPortableModelSelection,z as interleavedLadderCycle,C as isPortableModelToken,N as logicalModelIntent,pe as nextLadderModel,A as normalizeModel,Ae as piInvocationToSdkConfig,Y as readMergedLaunchConfigAsync};

package/dist/core/runtime/lifecycle.js

@@ -1,2 +1,2 @@
-var w=Object.defineProperty;var i=(t,e)=>w(t,"name",{value:e,configurable:!0});import{getNode as y,cancelCronsOnWake as S,transitionStatusIntent as A}from"../canvas/index.js";import{readExternalActionDelivery as N}from"../canvas/deliveries.js";import{composeNodeOutcomeDocument as b}from"./outcome-document.js";const f="*",J={finish:"finished",park:"parked",cancel:"stranded",crash:"crashed","refresh-launch":null,revive:null},c=["active","idle"],_={finish:{status:"done",intent:"done",from:c},park:{status:"done",intent:"parked",from:c},cancel:{status:"canceled",intent:null,from:f},crash:{status:"dead",from:c},yield:{intent:"refresh",from:c},release:{status:"idle",intent:"idle-release",from:[...c,"done"]},"refresh-launch":{status:"active",intent:"refresh",from:f},revive:{status:"active",intent:null,from:f}};function v(t,e){const r=t.split(`
-`)[0]??"";let n=0,l="";for(const u of r){const s=Buffer.byteLength(u,"utf8");if(n+s>e)break;n+=s,l+=u}return l}i(v,"firstLineAtMost");function E(t){if(t===void 0)return null;const e=t.message===void 0?void 0:v(t.message,500),r={...t,...e===void 0?{}:{message:e}},n=JSON.stringify(r);return Buffer.byteLength(n,"utf8")<=4*1024?n:JSON.stringify({schema:"crtr.node-outcome-detail/v1",truncated:!0,...e===void 0?{}:{message:e}})}i(E,"detailJson");function $(t){const e=N(`node-outcome:${t}`);if(e===null||e.state!=="armed")return null;const r=e.adapter;if(r?.adapter!=="subprocess"||!Array.isArray(r.argv)||!r.argv.every(n=>typeof n=="string")||typeof r.cwd!="string")throw new Error(`outcome delivery ${e.deliveryId} has an invalid subprocess adapter`);return{name:e.destinationId,payload:r.payload??null}}i($,"armedOutcomeAction");function x(t,e){let r,n;return e==="finished"||e==="declined"?(r="done",n="done"):e==="parked"?(r="done",n="parked"):e==="closed"||e==="retired"||e==="stranded"||e==="deadline_exceeded"?(r="canceled",n=null):(r="dead",n=null),{...t,status:r,intent:n,terminal_reason:e}}i(x,"nodeAtOutcome");function j(t,e,r){const n=_[e],l=Object.prototype.hasOwnProperty.call(n,"status"),u=Object.prototype.hasOwnProperty.call(n,"intent"),s=r?.reason??J[e],d={};l&&(d.status=n.status),u&&(d.intent=n.intent??null),s!==void 0&&(d.terminal_reason=s);const m=e==="finish"||e==="park"||e==="cancel"||e==="crash",a=m?y(t):null,g=m&&a?.kind!=="human",p=s,k=m?new Date().toISOString():null,O=E(r?.outcome?.detail);let h;if(g&&a!==null&&a.outcome_at===null){const o=$(t);o!==null&&(h=JSON.stringify(b({node:x(a,p),outcome:{kind:"failure",reason:p,at:k,revision:(a.outcome_revision??0)+1,detailJson:O},action:o})))}if(A(t,d,{fromStatuses:n.from===f?void 0:n.from,requireNoFinalReport:e==="cancel",...g?{outcome:{kind:"failure",reason:p,detailJson:O,at:k,...h===void 0?{}:{documentJson:h}}}:{}})===0){const o=y(t);if(o===null)throw new Error(`transition: unknown node ${t}`);if(e==="cancel"&&o.final_report!==null&&o.final_report!==void 0)return o;throw new Error(`illegal lifecycle transition: '${e}' from status='${o.status}' (node ${t})`)}return(e==="finish"||e==="park"||e==="cancel")&&S(t),y(t)}i(j,"transition");function B(t){return t.status==="done"&&t.intent==="parked"}i(B,"isParked");export{B as isParked,j as transition};
+var S=Object.defineProperty;var a=(t,e)=>S(t,"name",{value:e,configurable:!0});import{getNode as k,cancelCronsOnWake as A,transitionStatusIntent as N}from"../canvas/index.js";import{readExternalActionDelivery as _}from"../canvas/deliveries.js";import{composeNodeOutcomeDocument as b}from"./outcome-document.js";const f="*",J={finish:"finished",park:"parked",cancel:"stranded",crash:"crashed","refresh-launch":null,revive:null},c=["active","idle"],v={finish:{status:"done",intent:"done",from:c},park:{status:"done",intent:"parked",from:c},cancel:{status:"canceled",intent:null,from:f},crash:{status:"dead",from:c},yield:{intent:"refresh",from:c},release:{status:"idle",intent:"idle-release",from:[...c,"done"]},"refresh-launch":{status:"active",intent:"refresh",from:f},revive:{status:"active",intent:null,from:f}};function E(t,e){const r=t.split(`
+`)[0]??"";let n=0,u="";for(const l of r){const i=Buffer.byteLength(l,"utf8");if(n+i>e)break;n+=i,u+=l}return u}a(E,"firstLineAtMost");function R(t){if(t===void 0)return null;const e=t.message===void 0?void 0:E(t.message,500),r={...t,...e===void 0?{}:{message:e}},n=JSON.stringify(r);return Buffer.byteLength(n,"utf8")<=4*1024?n:JSON.stringify({schema:"crtr.node-outcome-detail/v1",truncated:!0,...e===void 0?{}:{message:e}})}a(R,"detailJson");function $(t){const e=_(`node-outcome:${t}`);if(e===null||e.state!=="armed")return null;const r=e.adapter;if(r?.adapter!=="subprocess"||!Array.isArray(r.argv)||!r.argv.every(n=>typeof n=="string")||typeof r.cwd!="string")throw new Error(`outcome delivery ${e.deliveryId} has an invalid subprocess adapter`);return{name:e.destinationId,payload:r.payload??null}}a($,"armedOutcomeAction");function x(t,e){let r,n;return e==="finished"||e==="declined"?(r="done",n="done"):e==="parked"?(r="done",n="parked"):e==="closed"||e==="retired"||e==="stranded"||e==="deadline_exceeded"?(r="canceled",n=null):(r="dead",n=null),{...t,status:r,intent:n,terminal_reason:e}}a(x,"nodeAtOutcome");function B(t,e,r){const n=v[e],u=Object.prototype.hasOwnProperty.call(n,"status"),l=Object.prototype.hasOwnProperty.call(n,"intent"),i=r?.reason??J[e],d={};u&&(d.status=n.status),l&&(d.intent=n.intent??null),i!==void 0&&(d.terminal_reason=i);const m=e==="finish"||e==="park"||e==="cancel"||e==="crash",o=m?k(t):null,p=m&&o?.kind!=="human",h=i,g=m?new Date().toISOString():null,O=R(r?.outcome?.detail),w=p&&o?.run_id!=null&&i!=="parked"&&o.outcome_at!==null&&(c.includes(o.status)||o.outcome_reason==="parked");let y;if(p&&o!==null&&(o.outcome_at===null||w)){const s=$(t);s!==null&&(y=JSON.stringify(b({node:x(o,h),outcome:{kind:"failure",reason:h,at:g,revision:(o.outcome_revision??0)+1,detailJson:O},action:s})))}if(N(t,d,{fromStatuses:n.from===f?void 0:n.from,requireNoFinalReport:e==="cancel",...p?{outcome:{kind:"failure",reason:h,detailJson:O,at:g,...w?{supersede:!0}:{},...y===void 0?{}:{documentJson:y}}}:{}})===0){const s=k(t);if(s===null)throw new Error(`transition: unknown node ${t}`);if(e==="cancel"&&s.final_report!==null&&s.final_report!==void 0)return s;throw new Error(`illegal lifecycle transition: '${e}' from status='${s.status}' (node ${t})`)}return(e==="finish"||e==="park"||e==="cancel")&&A(t),k(t)}a(B,"transition");function I(t){return t.status==="done"&&t.intent==="parked"}a(I,"isParked");export{I as isParked,B as transition};

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

@@ -1,3 +1,3 @@
 /** The node-local memory directory in a node's context dir — holds substrate
  *  docs (.md files with kind/when/why frontmatter). */
-export declare function memoryDir(nodeId: string): string;
+export declare function memoryDir(nodeId: string, grantee?: string): string;

package/dist/core/runtime/memory.js

@@ -1 +1 @@
-var t=Object.defineProperty;var o=(r,m)=>t(r,"name",{value:m,configurable:!0});import{join as i}from"node:path";import{contextDir as e}from"../canvas/paths.js";function c(r){return i(e(r),"memory")}o(c,"memoryDir");export{c as memoryDir};
+var e=Object.defineProperty;var m=(r,o)=>e(r,"name",{value:o,configurable:!0});import{join as p}from"node:path";import{appSpace as i}from"../layout.js";function a(r,o){if(!o)throw new Error(`memory store for ${r} requires an app`);return p(i(o).memory,"nodes",r)}m(a,"memoryDir");export{a as memoryDir};

package/dist/core/runtime/model-registry.js

@@ -1 +1 @@
-var n=Object.defineProperty;var t=(o,e)=>n(o,"name",{value:e,configurable:!0});import{join as r}from"node:path";import{ModelRegistry as i,ModelRuntime as m}from"@earendil-works/pi-coding-agent";import{PoolCredentialStore as s}from"../pool-credential-store.js";import{piAgentDir as a}from"./package-health.js";async function u(){const o=a(),e=await m.create({credentials:new s(r(o,"auth.json")),modelsPath:r(o,"models.json")});return new i(e)}t(u,"openModelRegistry");export{u as openModelRegistry};
+var i=Object.defineProperty;var r=(o,e)=>i(o,"name",{value:e,configurable:!0});import{join as t}from"node:path";import{ModelRegistry as n,ModelRuntime as m}from"@earendil-works/pi-coding-agent";import{PoolCredentialStore as s}from"../pool-credential-store.js";import{piAgentDir as a}from"./package-health.js";import{secretsDir as l}from"../layout.js";async function j(){const o=a(),e=await m.create({credentials:new s(t(l(),"auth.json")),modelsPath:t(o,"models.json")});return new n(e)}r(j,"openModelRegistry");export{j as openModelRegistry};

package/dist/core/runtime/model-swap.d.ts

@@ -1,4 +1,5 @@
 import { type NodeMeta } from '../canvas/index.js';
+import type { ModelIntent } from '../../types.js';
 /** True when the node's broker engine is reachable: its recorded pid is alive
  *  AND its view.sock exists. Both are required — a dead pid with a stale socket,
  *  or a live pid mid-boot before it binds the socket, is NOT a live broker. */
@@ -7,22 +8,19 @@ export declare function isBrokerLive(node: Pick<NodeMeta, 'node_id' | 'pi_pid'>)
  *  sends `set_model`, and resolves with the broker-resolved durable spec from its
  *  `model_changed` frame. Rejects with the broker's message on an `error` frame (e.g.
  *  `no model matching '<spec>' in the registry`), on connect failure, or timeout.
- *  `pinned` is the durable-pin decision for this change, made by the CALLER from
- *  the RAW pre-normalize token (`spec` here is already normalizeModel-resolved,
- *  so deriving the pin from `spec`'s shape would wrongly re-pin a deliberately
- *  chosen bare tier that happens to byte-equal a ladder cell) — sent explicitly
- *  on the frame so the broker persists that decision rather than re-inferring it
- *  from the resolved spec. */
-export declare function setModelLive(nodeId: string, spec: string, pinned: boolean): Promise<string>;
-/** Persist a model choice into a DORMANT node's durable recipe — mirrors exactly
- *  what the broker's persistModelChoice writes on a live switch: `model_override`
- *  (so polymorphs preserve it via buildLaunchSpec), `launch.model`, and its
- *  exact-consult marker (the recipe buildPiArgv replays on revive). `spec` must
- *  already be a concrete `provider/id` (normalizeModel maps tiers/aliases; a bare
- *  substring cannot resolve offline).
- *  `pinned` is the durable-pin decision for this change — decided by the CALLER
- *  from the RAW pre-normalize token, never re-derived here from `spec`'s shape
- *  (a concrete `spec` always reads as "pinned", which would wrongly re-pin a
- *  deliberately chosen bare tier that happens to byte-equal a ladder cell). */
-export declare function updateModelRecipe(meta: NodeMeta, spec: string, pinnedOverride: boolean | undefined, userSelected: boolean): NodeMeta;
-export declare function persistDormantModel(nodeId: string, spec: string, pinned: boolean): void;
+ *  `intent` is the routing contract the CALLER derived from the RAW token
+ *  (`explicitModelIntent`); `spec` is already normalized, so its shape no longer
+ *  says whether the pick was portable. Undefined means an exact model. */
+export declare function setModelLive(nodeId: string, spec: string, intent: ModelIntent | undefined): Promise<string>;
+/** Write a model choice into a node's durable recipe: `model_override` (so
+ *  polymorphs preserve it via buildLaunchSpec) and `launch.model`. A
+ *  `userSelected` change also replaces the routing contract the next revive
+ *  replays: with an `intent`, `launch.modelIntent` + `CRTR_MODEL_INTENT` (the
+ *  route may rotate to another family at that strength); without one,
+ *  `launch.modelExact` (the model runs verbatim). `spec` must already be a
+ *  concrete `provider/id` (normalizeModel maps tiers/aliases; a bare substring
+ *  cannot resolve offline). */
+export declare function updateModelRecipe(meta: NodeMeta, spec: string, intent: ModelIntent | undefined, userSelected: boolean): NodeMeta;
+/** Persist a user's model choice into a DORMANT node's durable recipe — the same
+ *  write the broker commits on a live switch. */
+export declare function persistDormantModel(nodeId: string, spec: string, intent: ModelIntent | undefined): void;

package/dist/core/runtime/model-swap.js

@@ -1 +1 @@
-var m=Object.defineProperty;var n=(e,o)=>m(e,"name",{value:o,configurable:!0});import{existsSync as c}from"node:fs";import{getNode as s,updateNode as f}from"../canvas/index.js";import{viewSocketPath as p}from"../canvas/paths.js";import{isPidAlive as _}from"../canvas/pid.js";import{oneShotControllerRequest as a}from"./broker-request.js";function g(e){return _(e.pi_pid)&&c(p(e.node_id))}n(g,"isBrokerLive");function k(e,o,t){let d;return a({nodeId:e,what:"the model switch",ackFor:"set_model",frame:n(()=>({type:"set_model",model:o,pinned:t}),"frame"),observe:n(r=>{r.type==="model_changed"&&r.spec!==null&&(d=r.spec)},"observe"),result:n(()=>d??o,"result")})}n(k,"setModelLive");function h(e,o,t,d){const r=e.launch===void 0?void 0:d?(()=>{const{modelIntent:v,env:i,...l}=e.launch,{CRTR_MODEL_INTENT:x,...u}=i;return{...l,model:o,modelExact:!0,...t!==void 0?{modelProviderPinned:t}:{},env:u}})():{...e.launch,model:o,...t!==void 0?{modelProviderPinned:t}:{}};return f(e.node_id,{model_override:o,...r!==void 0?{launch:r}:{}})}n(h,"updateModelRecipe");function w(e,o,t){const d=s(e);d!==null&&h(d,o,t,!0)}n(w,"persistDormantModel");export{g as isBrokerLive,w as persistDormantModel,k as setModelLive,h as updateModelRecipe};
+var u=Object.defineProperty;var n=(e,o)=>u(e,"name",{value:o,configurable:!0});import{existsSync as c}from"node:fs";import{getNode as s,updateNode as f}from"../canvas/index.js";import{viewSocketPath as p}from"../canvas/paths.js";import{isPidAlive as _}from"../canvas/pid.js";import{oneShotControllerRequest as a}from"./broker-request.js";function y(e){return _(e.pi_pid)&&c(p(e.node_id))}n(y,"isBrokerLive");function L(e,o,t){let d;return a({nodeId:e,what:"the model switch",ackFor:"set_model",frame:n(()=>({type:"set_model",model:o,...t!==void 0?{intent:t}:{}}),"frame"),observe:n(r=>{r.type==="model_changed"&&r.spec!==null&&(d=r.spec)},"observe"),result:n(()=>d??o,"result")})}n(L,"setModelLive");function v(e,o,t,d){const r=e.launch===void 0?void 0:d?(()=>{const{modelIntent:h,modelExact:E,env:m,...l}=e.launch,{CRTR_MODEL_INTENT:x,...i}=m;return t!==void 0?{...l,model:o,modelIntent:t,env:{...i,CRTR_MODEL_INTENT:`${t.family}/${t.strength}`}}:{...l,model:o,modelExact:!0,env:i}})():{...e.launch,model:o};return f(e.node_id,{model_override:o,...r!==void 0?{launch:r}:{}})}n(v,"updateModelRecipe");function S(e,o,t){const d=s(e);d!==null&&v(d,o,t,!0)}n(S,"persistDormantModel");export{y as isBrokerLive,S as persistDormantModel,L as setModelLive,v as updateModelRecipe};

package/dist/core/runtime/node-read.js

@@ -1,2 +1,3 @@
-var _=Object.defineProperty;var i=(e,t)=>_(e,"name",{value:t,configurable:!0});import{copyFileSync as C,existsSync as h,mkdtempSync as N,readFileSync as y,rmSync as j}from"node:fs";import{readJsonIfExists as R}from"../fs-utils.js";import{tmpdir as $}from"node:os";import{basename as k,join as d}from"node:path";import{InputError as f}from"../io.js";import{fullName as A,getNode as g}from"../canvas/index.js";import{jobDir as b,nodeDir as L,sessionPtrPath as T}from"../canvas/paths.js";import{hydratePersistedAdvertisedCommandMessages as S}from"./advertised-command-invocation.js";import{SessionManager as F}from"./broker-sdk.js";import{openModelRegistry as P}from"./model-registry.js";import{BUILTIN_SLASH_COMMANDS as E}from"./pi-vendored.js";import{cycleAwareMessages as B}from"./session-cycles.js";import{projectTranscript as D}from"./session-visibility.js";import{normalizeToolGroupSummaryRecord as J}from"../../shared/tool-groups.js";async function O(e){if(e!==null)try{return(await P()).find(e.provider,e.modelId)}catch{return}}i(O,"resolveRecordedModel");function w(e,t){if(typeof t=="string"&&t!==""&&h(t))return t;const o=T(e);if(!h(o))return null;const s=y(o,"utf8").trim();return s===""?null:h(s)?s:null}i(w,"resolveSessionFile");function U(e){const t=g(e);if(t===null)throw new f({error:"not_found",message:`no node: ${e}`,field:"id",next:"List nodes with `crtr node inspect list`."});return w(e,t.pi_session_file)}i(U,"readableSessionFile");function V(e,t){return{sessionFile:t,sessionId:e,userMessages:0,assistantMessages:0,toolCalls:0,toolResults:0,totalMessages:0,tokens:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0},cost:0}}i(V,"emptyStats");function W(e,t,o){const s=V(t,o);s.totalMessages=e.length;for(const r of e)if(r.role==="user")s.userMessages++;else if(r.role==="assistant"){s.assistantMessages++;const a=Array.isArray(r.content)?r.content:[];s.toolCalls+=a.filter(l=>l!==null&&typeof l=="object"&&l.type==="toolCall").length;const n=r.usage;n!==void 0&&(s.tokens.input+=n.input??0,s.tokens.output+=n.output??0,s.tokens.cacheRead+=n.cacheRead??0,s.tokens.cacheWrite+=n.cacheWrite??0,s.cost+=n.cost?.total??0)}else r.role==="toolResult"&&s.toolResults++;return s.tokens.total=s.tokens.input+s.tokens.output+s.tokens.cacheRead+s.tokens.cacheWrite,s}i(W,"statsFromMessages");function me(e){const t=g(e);if(t===null)throw new f({error:"not_found",message:`no node: ${e}`,field:"id",next:"List nodes with `crtr node inspect list`."});const o=w(e,t.pi_session_file);if(o===null)throw new f({error:"no_session",message:`node has no readable session file: ${e}`,field:"id",next:"Choose a node with captured conversation history."});return{nodeId:e,sessionFile:o,sessionJsonl:y(o,"utf8"),systemPrompt:x(d(b(e),"system-prompt.md"))??x(d(L(e),"system-prompt.md"))}}i(me,"readNodeSession");function x(e){try{return y(e,"utf8")}catch{return null}}i(x,"readIfPresent");function G(e){try{const t=R(d(b(e),"tool-summaries.json"));return J(t)}catch{return{}}}i(G,"readToolGroupSummaries");async function v(e){const t=g(e);if(t===null)throw new f({error:"not_found",message:`no node: ${e}`,field:"id",next:"List nodes with `crtr node inspect list`."});const o=w(e,t.pi_session_file);if(o===null)throw new f({error:"no_session",message:`node has no readable session file: ${e}`,field:"id",next:"Choose a node with captured conversation history."});const s=N(d($(),"crtr-node-session-"));try{const r=d(s,k(o));C(o,r);const a=F.open(r),n=a.buildSessionContext();S(n.messages);const l=B(a);l!==void 0&&S(l.map(({message:c})=>c));const u=l===void 0?void 0:D(l,{boundaryReviewId:t.review_binding?.review_id,sessionEntries:a.getEntries()}),m=u?.map(({message:c})=>c)??n.messages;return{sessionFile:o,messages:m,identified:u,model:n.model,thinkingLevel:n.thinkingLevel,sessionId:a.getSessionId(),sessionName:a.getSessionName()}}finally{j(s,{recursive:!0,force:!0})}}i(v,"reconstructTranscript");function p(){throw new f({error:"invalid_cursor",message:"cursor must be a base64url-encoded messages cursor.",field:"cursor",next:"Omit cursor to start from the newest messages."})}i(p,"invalidCursor");function z(e,t){/^[A-Za-z0-9_-]+$/u.test(e)||p();let o;try{const r=Buffer.from(e,"base64url").toString("utf8");Buffer.from(r,"utf8").toString("base64url")!==e&&p(),o=JSON.parse(r)}catch{p()}(typeof o!="object"||o===null||o.v!==1||!Number.isSafeInteger(o.before))&&p();const s=o.before;return(s<0||s>t)&&p(),s}i(z,"decodeMessagesCursor");function q(e){return Buffer.from(JSON.stringify({v:1,before:e}),"utf8").toString("base64url")}i(q,"encodeMessagesCursor");async function H(e){const t=await v(e),o={messages:t.messages,...t.identified===void 0?{}:{messageIds:t.identified.map(({id:s})=>s)},messageVisibility:t.identified?.map(({visibility:s})=>s)??t.messages.map(()=>"visible"),turnVisibility:"visible",stats:W(t.messages,t.sessionId,t.sessionFile),state:{model:await O(t.model),thinkingLevel:t.thinkingLevel,isStreaming:!1,isCompacting:!1,steeringMode:"one-at-a-time",followUpMode:"one-at-a-time",sessionFile:t.sessionFile,sessionId:t.sessionId,sessionName:t.sessionName,autoCompactionEnabled:!0,messageCount:t.messages.length,pendingMessageCount:0},display:{statuses:{},widgets:{},title:void 0},queued:{steering:[],followUp:[]},toolGroupSummaries:G(e)};return{nodeId:e,snapshot:o,commands:E.map(s=>({...s,source:"builtin"}))}}i(H,"readNodeSnapshot");async function de(e,{cursor:t,limit:o=200}){if(!Number.isSafeInteger(o)||o<1||o>500)throw new f({error:"invalid_limit",message:"limit must be an integer from 1 through 500.",field:"limit",next:"Use a limit from 1 through 500."});if(U(e)===null)return{messages:[],messageIds:[],messageVisibility:[],nextCursor:null};const{messages:s,identified:r}=await v(e),a=t===void 0?s.length:z(t,s.length);let n=Math.max(0,a-o);for(;n>0&&typeof s[n]=="object"&&s[n]!==null&&s[n].role==="toolResult";)n--;const l=r?.slice(n,a);return{messages:l?.map(({message:u})=>u)??s.slice(n,a),...l===void 0?{}:{messageIds:l.map(({id:u})=>u)},messageVisibility:l?.map(({visibility:u})=>u)??s.slice(n,a).map(()=>"visible"),nextCursor:n===0?null:q(n)}}i(de,"readNodeMessagesPage");function I(e){return typeof e=="string"?e:Array.isArray(e)?e.filter(t=>typeof t=="object"&&t!==null).filter(t=>t.type==="text"&&typeof t.text=="string").map(t=>t.text).join(""):""}i(I,"textFromContent");function Y(e){switch(e.role){case"user":return"You";case"assistant":return"Agent";case"toolResult":return"Tool result";default:return typeof e.role=="string"?e.role:"Message"}}i(Y,"roleLabel");function Z(e){return Array.isArray(e.content)?e.content.filter(t=>typeof t=="object"&&t!==null&&t.type==="toolCall").map(t=>`Tool: ${typeof t.name=="string"?t.name:"call"}`):[]}i(Z,"toolSummaries");async function pe(e){const t=g(e);if(t===null)throw new f({error:"not_found",message:`no node: ${e}`,field:"node-id",next:"List nodes with `crtr node inspect list`."});const{snapshot:o}=await H(e),r=[`# ${A(t)}`,"",`Saved transcript \xB7 ${t.status} \xB7 ${t.lifecycle}`,""];for(const a of o.messages){if(typeof a!="object"||a===null)continue;const n=a;if(n.role==="custom"&&n.display===!1)continue;const l=I(n.content),u=typeof n.text=="string"?n.text:"",m=l.trim()?l:u.trim()?u:"",c=Z(n);if(!(!m&&c.length===0)){r.push(`## ${Y(n)}`,""),m&&r.push(m,"");for(const M of c)r.push(`- ${M}`);c.length&&r.push("")}}return r.length===5&&r.push("_No saved messages._",""),r.join(`
-`)}i(pe,"transcriptMarkdown");export{de as readNodeMessagesPage,me as readNodeSession,H as readNodeSnapshot,pe as transcriptMarkdown};
+var C=Object.defineProperty;var a=(e,t)=>C(e,"name",{value:t,configurable:!0});import{existsSync as N,readFileSync as R}from"node:fs";import{isBeneathRefusal as F,readFileBeneath as $,readTextBeneathIfExists as j}from"../spaces/open-beneath.js";import{join as g}from"node:path";import{InputError as f}from"../io.js";import{conversationIdFromPath as h,conversationStore as y,ConversationNotFoundError as A}from"../conversation-store/index.js";import{fullName as k,getNode as p}from"../canvas/index.js";import{nodeRunDir as w,nodeRunJobDir as S,sessionPtrPath as L}from"../canvas/paths.js";import{hydratePersistedAdvertisedCommandMessages as x}from"./advertised-command-invocation.js";import{SessionManager as T}from"./broker-sdk.js";import{openModelRegistry as P}from"./model-registry.js";import{BUILTIN_SLASH_COMMANDS as B}from"./pi-vendored.js";import{cycleAwareMessages as E}from"./session-cycles.js";import{projectTranscript as J}from"./session-visibility.js";import{normalizeToolGroupSummaryRecord as O}from"../../shared/tool-groups.js";async function U(e){if(e!==null)try{return(await P()).find(e.provider,e.modelId)}catch{return}}a(U,"resolveRecordedModel");function b(e,t){const o=a(i=>{const n=i?h(i):null;if(n===null)return null;try{return y().header(n).path}catch(l){if(l instanceof A)return null;throw l}},"resolvePath"),s=o(t);if(s!==null)return s;const r=L(e);return N(r)?o(R(r,"utf8").trim()):null}a(b,"resolveSessionFile");function V(e){const t=p(e);if(t===null)throw new f({error:"not_found",message:`no node: ${e}`,field:"id",next:"List nodes with `crtr node inspect list`."});return b(e,t.pi_session_file)}a(V,"readableSessionFile");function W(e,t){return{sessionFile:t,sessionId:e,userMessages:0,assistantMessages:0,toolCalls:0,toolResults:0,totalMessages:0,tokens:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0},cost:0}}a(W,"emptyStats");function D(e,t,o){const s=W(t,o);s.totalMessages=e.length;for(const r of e)if(r.role==="user")s.userMessages++;else if(r.role==="assistant"){s.assistantMessages++;const i=Array.isArray(r.content)?r.content:[];s.toolCalls+=i.filter(l=>l!==null&&typeof l=="object"&&l.type==="toolCall").length;const n=r.usage;n!==void 0&&(s.tokens.input+=n.input??0,s.tokens.output+=n.output??0,s.tokens.cacheRead+=n.cacheRead??0,s.tokens.cacheWrite+=n.cacheWrite??0,s.cost+=n.cost?.total??0)}else r.role==="toolResult"&&s.toolResults++;return s.tokens.total=s.tokens.input+s.tokens.output+s.tokens.cacheRead+s.tokens.cacheWrite,s}a(D,"statsFromMessages");function me(e){const t=p(e);if(t===null)throw new f({error:"not_found",message:`no node: ${e}`,field:"id",next:"List nodes with `crtr node inspect list`."});const o=b(e,t.pi_session_file);if(o===null)throw new f({error:"no_session",message:`node has no readable session file: ${e}`,field:"id",next:"Choose a node with captured conversation history."});return{nodeId:e,sessionFile:o,sessionJsonl:(()=>{const{header:s,entries:r}=y().read(h(o));return[s,...r].map(i=>`${JSON.stringify(i)}
+`).join("")})(),systemPrompt:v(e,g(S(e),"system-prompt.md"))??v(e,g(w(e),"system-prompt.md"))}}a(me,"readNodeSession");function v(e,t){try{return $(w(e),t).toString("utf8")}catch(o){if(F(o))throw o;return null}}a(v,"readRunFileIfPresent");function G(e){try{const t=j(w(e),g(S(e),"tool-summaries.json"));return O(t===null?null:JSON.parse(t))}catch{return{}}}a(G,"readToolGroupSummaries");async function M(e){const t=p(e);if(t===null)throw new f({error:"not_found",message:`no node: ${e}`,field:"id",next:"List nodes with `crtr node inspect list`."});const o=b(e,t.pi_session_file);if(o===null)throw new f({error:"no_session",message:`node has no readable session file: ${e}`,field:"id",next:"Choose a node with captured conversation history."});const{header:s,entries:r}=y().read(h(o)),i=T.inMemory(s.cwd,void 0,[s,...r]),n=i.buildSessionContext();x(n.messages);const l=E(i);l!==void 0&&x(l.map(({message:c})=>c));const u=l===void 0?void 0:J(l,{boundaryReviewId:t.review_binding?.review_id,sessionEntries:i.getEntries()}),m=u?.map(({message:c})=>c)??n.messages;return{sessionFile:o,messages:m,identified:u,model:n.model,thinkingLevel:n.thinkingLevel,sessionId:i.getSessionId(),sessionName:i.getSessionName()}}a(M,"reconstructTranscript");function d(){throw new f({error:"invalid_cursor",message:"cursor must be a base64url-encoded messages cursor.",field:"cursor",next:"Omit cursor to start from the newest messages."})}a(d,"invalidCursor");function z(e,t){/^[A-Za-z0-9_-]+$/u.test(e)||d();let o;try{const r=Buffer.from(e,"base64url").toString("utf8");Buffer.from(r,"utf8").toString("base64url")!==e&&d(),o=JSON.parse(r)}catch{d()}(typeof o!="object"||o===null||o.v!==1||!Number.isSafeInteger(o.before))&&d();const s=o.before;return(s<0||s>t)&&d(),s}a(z,"decodeMessagesCursor");function q(e){return Buffer.from(JSON.stringify({v:1,before:e}),"utf8").toString("base64url")}a(q,"encodeMessagesCursor");async function H(e){const t=await M(e),o={messages:t.messages,...t.identified===void 0?{}:{messageIds:t.identified.map(({id:s})=>s)},messageVisibility:t.identified?.map(({visibility:s})=>s)??t.messages.map(()=>"visible"),turnVisibility:"visible",stats:D(t.messages,t.sessionId,t.sessionFile),state:{model:await U(t.model),thinkingLevel:t.thinkingLevel,isStreaming:!1,isCompacting:!1,steeringMode:"one-at-a-time",followUpMode:"one-at-a-time",sessionFile:t.sessionFile,sessionId:t.sessionId,sessionName:t.sessionName,autoCompactionEnabled:!0,messageCount:t.messages.length,pendingMessageCount:0},display:{statuses:{},widgets:{},title:void 0},queued:{steering:[],followUp:[]},toolGroupSummaries:G(e)};return{nodeId:e,snapshot:o,commands:B.map(s=>({...s,source:"builtin"}))}}a(H,"readNodeSnapshot");async function de(e,{cursor:t,limit:o=200}){if(!Number.isSafeInteger(o)||o<1||o>500)throw new f({error:"invalid_limit",message:"limit must be an integer from 1 through 500.",field:"limit",next:"Use a limit from 1 through 500."});if(V(e)===null)return{messages:[],messageIds:[],messageVisibility:[],nextCursor:null};const{messages:s,identified:r}=await M(e),i=t===void 0?s.length:z(t,s.length);let n=Math.max(0,i-o);for(;n>0&&typeof s[n]=="object"&&s[n]!==null&&s[n].role==="toolResult";)n--;const l=r?.slice(n,i);return{messages:l?.map(({message:u})=>u)??s.slice(n,i),...l===void 0?{}:{messageIds:l.map(({id:u})=>u)},messageVisibility:l?.map(({visibility:u})=>u)??s.slice(n,i).map(()=>"visible"),nextCursor:n===0?null:q(n)}}a(de,"readNodeMessagesPage");function Y(e){return typeof e=="string"?e:Array.isArray(e)?e.filter(t=>typeof t=="object"&&t!==null).filter(t=>t.type==="text"&&typeof t.text=="string").map(t=>t.text).join(""):""}a(Y,"textFromContent");function Z(e){switch(e.role){case"user":return"You";case"assistant":return"Agent";case"toolResult":return"Tool result";default:return typeof e.role=="string"?e.role:"Message"}}a(Z,"roleLabel");function K(e){return Array.isArray(e.content)?e.content.filter(t=>typeof t=="object"&&t!==null&&t.type==="toolCall").map(t=>`Tool: ${typeof t.name=="string"?t.name:"call"}`):[]}a(K,"toolSummaries");async function pe(e){const t=p(e);if(t===null)throw new f({error:"not_found",message:`no node: ${e}`,field:"node-id",next:"List nodes with `crtr node inspect list`."});const{snapshot:o}=await H(e),r=[`# ${k(t)}`,"",`Saved transcript \xB7 ${t.status} \xB7 ${t.lifecycle}`,""];for(const i of o.messages){if(typeof i!="object"||i===null)continue;const n=i;if(n.role==="custom"&&n.display===!1)continue;const l=Y(n.content),u=typeof n.text=="string"?n.text:"",m=l.trim()?l:u.trim()?u:"",c=K(n);if(!(!m&&c.length===0)){r.push(`## ${Z(n)}`,""),m&&r.push(m,"");for(const _ of c)r.push(`- ${_}`);c.length&&r.push("")}}return r.length===5&&r.push("_No saved messages._",""),r.join(`
+`)}a(pe,"transcriptMarkdown");export{de as readNodeMessagesPage,me as readNodeSession,H as readNodeSnapshot,pe as transcriptMarkdown};

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

@@ -1,3 +1,4 @@
+import type { DatabaseSync } from 'node:sqlite';
 import { type NodeMeta, type Mode, type Lifecycle, type LaunchSpec, type ManagedWorktree, type OutcomeDeliveryBinding, type ReviewBinding } from '../canvas/index.js';
 /** Explicitly set the resolved install id. crtrd calls this once at boot,
  *  immediately after `resolveInstallId()` — see crtrd.ts — so a provisioning
@@ -97,6 +98,10 @@ export interface SpawnNodeOpts {
     profile_id?: string | null;
     /** Per-run scope allow-list. Omit to inherit the creating node's list. */
     scopes?: string[];
+    /** Run identity set on an app root; managed children inherit it. */
+    run?: Pick<NodeMeta, 'grantee' | 'sub' | 'grant_id' | 'client_id' | 'metadata_json' | 'run_id' | 'event_cursor' | 'usage_json'>;
+    /** Additional rows committed atomically with the newborn node. */
+    withinCreate?: (db: DatabaseSync, row: NodeMeta) => void;
     /** Managed worktree already created for this node, if any. */
     managedWorktree?: ManagedWorktree;
     /** Absolute wall-clock deadline persisted with the row at birth. */
@@ -113,6 +118,8 @@ export interface SpawnNodeOpts {
      *  and duplicate-rejected (`NodeIdConflictError`) here. */
     nodeId?: string;
 }
+/** The node that owns the conversation a fork copies, or null when no node does. */
+export declare function forkSourceNode(sourceFile: string): NodeMeta | null;
 /** Create a node on the canvas and wire its spawn-time edges.
  *
  *  For a child (parent given): the parent auto-subscribes ACTIVE to the child

package/dist/core/runtime/nodes.js

@@ -1 +1 @@
-var y=Object.defineProperty;var i=(e,n)=>y(e,"name",{value:n,configurable:!0});import{envHomeOverride as D,envRuntimeHomeOverride as N,scopeAllowed as k}from"../../shared/env.js";import{validateScopes as T}from"../scopes.js";import{InputError as g}from"../io.js";import{randomBytes as O}from"node:crypto";import{mkdirSync as b}from"node:fs";import{createNode as x,getNode as c,getRow as S,subscribe as $,recordSpawn as M,subscribersOf as A,contextDir as B}from"../canvas/index.js";import{memoryDir as H}from"./memory.js";import{resolveInstallId as P}from"../canvas/install-id.js";import{canvasDbPath as F}from"../canvas/paths.js";import{usage as h}from"../errors.js";import{assertProfileAvailableForBirth as U}from"../profiles/deletion-reservation.js";import{admitNodeCreate as L}from"../command-hooks/lifecycle-create.js";import{fanDoctrineWake as W}from"./close.js";import{BIRTH_ANNOUNCEMENT_MARKER as q,birthAnnouncementBody as K}from"../../shared/birth-announcement.js";let f;const E=new Map;function ue(e){f=e}i(ue,"setInstallId");function z(){if(f!==void 0)return f;const e=F(),n=E.get(e);if(n!==void 0)return n;const r=P();return E.set(e,r),r}i(z,"installId");function J(){return`${Date.now().toString(36)}-${O(4).toString("hex")}`}i(J,"newJobId");function X(){return`${z()}-${J()}`}i(X,"newNodeId");const _=128,Y=/^[a-z0-9-]+$/;class C extends Error{static{i(this,"NodeIdConflictError")}nodeId;constructor(n){super(`node already exists: ${n}`),this.nodeId=n,this.name="NodeIdConflictError"}}function m(e){if(e.length===0||e.length>_)throw h(`invalid --node-id '${e}': must be 1-${_} characters`,{next:`Pass an id-safe string (lowercase letters, digits, hyphens) of at most ${_} characters.`});if(!Y.test(e))throw h(`invalid --node-id '${e}': must contain only lowercase letters, digits, and hyphens (e.g. 'remote42', 'my-node-1')`,{next:"Use only lowercase letters, digits, and hyphens."})}i(m,"validateNodeIdFormat");function fe(e){if(m(e),c(e)!==null)throw new C(e)}i(fe,"preflightNodeId");function j(e){if(m(e),c(e)!==null)throw new C(e);return e}i(j,"validatedExplicitNodeId");function _e(e){let n=e;const r=new Set;for(;;){if(r.has(n))return n;r.add(n);const d=S(n);if(d===null||d.parent==null)return n;n=d.parent}}i(_e,"rootOfSpine");function me(){const e=process.env;return{nodeId:e.CRTR_NODE_ID??null,kind:e.CRTR_KIND??null,mode:e.CRTR_MODE??null}}i(me,"currentNodeContext");function pe(e){const n={CRTR_NODE_ID:e.node_id,CRTR_KIND:e.kind,CRTR_MODE:e.mode,CRTR_LIFECYCLE:e.lifecycle,CRTR_NODE_CWD:e.cwd,CRTR_CONTEXT_DIR:B(e.node_id),CRTR_CYCLES:(e.cycles??0).toString(),CRTR_PROFILE_ID:e.profile_id??"",PI_CLAUDE_OAUTH_REINJECT_SCOPE:"never"};e.parent&&(n.CRTR_PARENT_NODE_ID=e.parent),e.scopes!==null&&e.scopes!==void 0&&(n.CRTR_SCOPES=e.scopes.join(","));const r=D();r!==void 0&&r!==""&&(n.CRTR_HOME=r);const d=N();d!==void 0&&d!==""&&(n.CRTR_RUNTIME_HOME=d);const t=process.env.CRTR_SUBTREE;return t!==void 0&&t!==""&&(n.CRTR_SUBTREE=t),{...n,...e.launch?.env??{}}}i(pe,"nodeEnv");async function Re(e){const n=e.nodeId!==void 0?(m(e.nodeId),e.nodeId):X(),r=e.parent??null,d=r===null,t=e.spawnedBy??r,l=e.creator??null,p=e.mode??"base",a=e.lifecycle??(d?"resident":"terminal"),o={node_id:n,name:e.name??e.kind,description:e.description,cycles:0,created:new Date().toISOString(),cwd:e.cwd,host_kind:"broker",profile_id:e.profile_id??null,kind:e.kind,mode:p,lifecycle:a,persona_ack:{kind:e.kind,mode:p,lifecycle:a},status:"active",parent:r,spawned_by:t,creator:l,fork_from:e.forkFrom,fork_source_file:e.forkSourceFile,review_binding:e.reviewBinding,model_override:e.modelOverride??null,scopes:e.scopes??null,passive_default:e.passiveDefault??!1,...e.managedWorktree!==void 0?{managed_worktree:e.managedWorktree}:{},intent:null,deadline_at:e.deadlineAt??null,pi_session_id:null,pi_session_file:null,launch:e.launch},s=e.scopes===void 0?void 0:T(e.scopes),R=r===null?null:c(r);if(r!==null&&R===null)throw new Error(`cannot spawn under unknown parent node: ${r}`);const w=l===null?null:c(l);if(l!==null&&w===null)throw new Error(`cannot spawn from unknown creator node: ${l}`);const u=R??w??(t===null?null:c(t));if(u!==null){if(s!==void 0&&!s.every(v=>k(u.scopes,v)))throw new g({error:"unknown_scope",message:"child scopes must be a subset of the creating node's scopes",received:s,field:"scopes",next:"Request only scopes held by the node creating this child."});o.scopes=s??u.scopes??null}U(o.profile_id??null);const I=await L({kind:o.kind,mode:o.mode,cwd:o.cwd,profile:o.profile_id??null,root:d,parentId:r,requestingNodeId:l,lifecycle:a,replaces:e.replaces??null});try{e.nodeId!==void 0&&j(e.nodeId),await e.beforeCreate?.(),x(o,e.outcomeDelivery===void 0?void 0:{outcomeDelivery:e.outcomeDelivery})}finally{I()}if(o.kind!=="human"&&b(H(o.node_id),{recursive:!0}),r!==null&&e.subscribe!==!1&&$(r,o.node_id,!0),r!==null&&l!==r)try{W(o.node_id,A(o.node_id),`Child created \u2014 ${o.name} (${o.node_id}, ${o.kind})`,{birth_announcement:q,body:K({name:o.name,nodeId:o.node_id,kind:o.kind,creator:l===null?"an external process":c(l).name})},"deferred")}catch{}return t!=null&&c(t)!==null&&M(o.node_id,t),o}i(Re,"spawnNode");export{C as NodeIdConflictError,me as currentNodeContext,J as newJobId,X as newNodeId,pe as nodeEnv,fe as preflightNodeId,_e as rootOfSpine,ue as setInstallId,Re as spawnNode};
+var $=Object.defineProperty;var o=(e,r)=>$(e,"name",{value:r,configurable:!0});import{envHomeOverride as A,envRuntimeHomeOverride as M,scopeAllowed as m}from"../../shared/env.js";import{validateScopes as B}from"../scopes.js";import{activeGrant as N,terminalGrant as w}from"../grants/mirror.js";import{appendRunEvent as F}from"../runs/events.js";import{readConfig as h}from"../config.js";import{InputError as v}from"../io.js";import{randomBytes as P}from"node:crypto";import{existsSync as H,mkdirSync as U}from"node:fs";import{createNode as L,assertRunNotDeleting as j,conversationOwner as q,getNode as s,getRow as G,subscribe as J,recordSpawn as K,subscribersOf as W}from"../canvas/index.js";import{memoryDir as z}from"./memory.js";import{ensureAppSpace as X}from"../spaces/space.js";import{LAUNCHER_SOCKET as Y}from"../../launcher/spec.js";import{resolveInstallId as Q}from"../canvas/install-id.js";import{canvasDbPath as V,contextDir as Z}from"../canvas/paths.js";import{conversationIdFromPath as ee}from"../conversation-store/index.js";import{usage as T}from"../errors.js";import{assertProfileAvailableForBirth as ne}from"../profiles/deletion-reservation.js";import{loadExactProfileManifest as re}from"../profiles/manifest.js";import{admitNodeCreate as ie}from"../command-hooks/lifecycle-create.js";import{fanDoctrineWake as te}from"./close.js";import{BIRTH_ANNOUNCEMENT_MARKER as oe,birthAnnouncementBody as le}from"../../shared/birth-announcement.js";let E;const D=new Map;function Be(e){E=e}o(Be,"setInstallId");function de(){if(E!==void 0)return E;const e=V(),r=D.get(e);if(r!==void 0)return r;const i=Q();return D.set(e,i),i}o(de,"installId");function ae(){return`${Date.now().toString(36)}-${P(4).toString("hex")}`}o(ae,"newJobId");function se(){return`${de()}-${ae()}`}o(se,"newNodeId");const C=128,ce=/^[a-z0-9-]+$/;class S extends Error{static{o(this,"NodeIdConflictError")}nodeId;constructor(r){super(`node already exists: ${r}`),this.nodeId=r,this.name="NodeIdConflictError"}}function I(e){if(e.length===0||e.length>C)throw T(`invalid --node-id '${e}': must be 1-${C} characters`,{next:`Pass an id-safe string (lowercase letters, digits, hyphens) of at most ${C} characters.`});if(!ce.test(e))throw T(`invalid --node-id '${e}': must contain only lowercase letters, digits, and hyphens (e.g. 'remote42', 'my-node-1')`,{next:"Use only lowercase letters, digits, and hyphens."})}o(I,"validateNodeIdFormat");function Fe(e){if(I(e),s(e)!==null)throw new S(e)}o(Fe,"preflightNodeId");function ue(e){if(I(e),s(e)!==null)throw new S(e);return e}o(ue,"validatedExplicitNodeId");function Pe(e){let r=e;const i=new Set;for(;;){if(i.has(r))return r;i.add(r);const t=G(r);if(t===null||t.parent==null)return r;r=t.parent}}o(Pe,"rootOfSpine");function He(){const e=process.env;return{nodeId:e.CRTR_NODE_ID??null,kind:e.CRTR_KIND??null,mode:e.CRTR_MODE??null}}o(He,"currentNodeContext");function Ue(e){const r={CRTR_NODE_ID:e.node_id,CRTR_KIND:e.kind,CRTR_MODE:e.mode,CRTR_LIFECYCLE:e.lifecycle,CRTR_NODE_CWD:e.cwd,CRTR_CONTEXT_DIR:Z(e.node_id,e.grantee),CRTR_CYCLES:(e.cycles??0).toString(),CRTR_PROFILE_ID:e.profile_id??"",PI_CLAUDE_OAUTH_REINJECT_SCOPE:"never"};e.parent&&(r.CRTR_PARENT_NODE_ID=e.parent),e.run_id&&(r.CRTR_RUN_ID=e.run_id),e.scopes!==null&&e.scopes!==void 0&&(r.CRTR_SCOPES=e.scopes.join(",")),r.CRTR_GRANTEE=e.grantee??"app:terminal";const i=A();i!==void 0&&i!==""&&(r.CRTR_HOME=i);const t=M();t!==void 0&&t!==""&&(r.CRTR_RUNTIME_HOME=t);const a=process.env.CRTR_SUBTREE;return a!==void 0&&a!==""&&(r.CRTR_SUBTREE=a),{...r,...e.launch?.env??{}}}o(Ue,"nodeEnv");function fe(e){const r=ee(e),i=r===null?null:q(r);return i===null?null:s(i)}o(fe,"forkSourceNode");async function Le(e){const r=e.nodeId!==void 0?(I(e.nodeId),e.nodeId):se(),i=e.parent??null,t=i===null,a=e.spawnedBy??i,c=e.creator??null,y=e.mode??"base",R=e.lifecycle??(t?"resident":"terminal"),_=e.run===void 0?w():null;if(e.run===void 0&&h("user").runtime?.issuer&&_===null)throw new Error("terminal grant is not active");const n={node_id:r,name:e.name??e.kind,description:e.description,cycles:0,created:new Date().toISOString(),cwd:e.cwd,host_kind:"broker",profile_id:e.profile_id??null,kind:e.kind,mode:y,lifecycle:R,persona_ack:{kind:e.kind,mode:y,lifecycle:R},status:"active",parent:i,spawned_by:a,creator:c,fork_from:e.forkFrom,fork_source_file:e.forkSourceFile,review_binding:e.reviewBinding,model_override:e.modelOverride??null,scopes:e.scopes??null,grantee:e.run?.grantee??"app:terminal",sub:e.run?.sub??_?.sub??null,grant_id:e.run?.grant_id??_?.id??null,client_id:e.run?.client_id??null,metadata_json:t?e.run?.metadata_json??null:null,run_id:t?r:e.run?.run_id??null,event_cursor:t?e.run?.event_cursor??1:null,usage_json:t?e.run?.usage_json??JSON.stringify({input_tokens:0,output_tokens:0,cache_read_tokens:0,cache_write_tokens:0,cost_usd:0}):null,passive_default:e.passiveDefault??!1,...e.managedWorktree!==void 0?{managed_worktree:e.managedWorktree}:{},intent:null,deadline_at:e.deadlineAt??null,pi_session_id:null,pi_session_file:null,launch:e.launch},p=e.scopes===void 0?void 0:B(e.scopes),g=i===null?null:s(i);if(i!==null&&g===null)throw new Error(`cannot spawn under unknown parent node: ${i}`);if(g?.run_id&&s(g.run_id)?.deleting_at)throw new Error("run is deleting");const k=c===null?null:s(c);if(c!==null&&k===null)throw new Error(`cannot spawn from unknown creator node: ${c}`);const O=e.forkSourceFile==null?null:fe(e.forkSourceFile),b=e.replaces==null?null:s(e.replaces),l=g??O??b??k??(a===null?null:s(a));if(l!==null){const u=l.grantee==="app:terminal"?w():l.grant_id?N(l.grant_id):null,d=l.grantee==="app:terminal"&&!h("user").runtime?.issuer;if(p!==void 0&&!p.every(f=>m(l.scopes,f)&&(u?m(u.resolved,f):d)))throw new v({error:"unknown_scope",message:"child scopes must be covered by the creating node and its current grant",received:p,field:"scopes",next:"Request only scopes the creating node currently holds."});if(n.scopes=p??l.scopes??null,n.scopes?.includes("crtr:act")&&!m(n.scopes,"crtr:llm"))throw new v({error:"invalid_scope",message:"crtr:act requires crtr:llm",received:n.scopes,field:"scopes",next:"Include crtr:llm or omit crtr:act."});n.grantee=l.grantee==="user:local"?"app:terminal":l.grantee,n.sub=l.sub??_?.sub??null,n.grant_id=l.grant_id??_?.id??null,n.client_id=l.client_id,n.run_id=t?r:l.run_id??null}if(n.profile_id){const u=re(n.profile_id).manifest.grantee??"app:terminal";if(u!==n.grantee){const d=`crtr:memory:rw:${u}:profile:${n.profile_id}`,f=n.grantee==="app:terminal"?w():n.grant_id?N(n.grant_id):null;if(!(n.grantee==="app:terminal"&&!h("user").runtime?.issuer)&&(!f||f.grantee!==n.grantee||!m(f.resolved,d))||!m(n.scopes,d))throw new v({error:"scope_missing",message:`missing scope ${d}`,received:n.profile_id,field:"profile",next:"Select a profile covered by this run and its current grant."})}}if(ne(n.profile_id??null),!n.grantee)throw new Error("node creation requires an app");const x=await ie({kind:n.kind,mode:n.mode,cwd:n.cwd,profile:n.profile_id??null,root:t,parentId:i,requestingNodeId:c,lifecycle:R,replaces:e.replaces??null},n.grantee);try{e.nodeId!==void 0&&ue(e.nodeId),await e.beforeCreate?.(),(process.platform!=="linux"||H(Y))&&await X(n.grantee??"app:terminal"),L(n,{outcomeDelivery:e.outcomeDelivery,withinCreate:o((u,d)=>{d.run_id&&d.run_id!==d.node_id&&j(u,d.run_id),t&&e.run===void 0&&F(u,r,r,"run.started",{scopes:d.scopes,payer:"user",usage:JSON.parse(d.usage_json)}),e.withinCreate?.(u,d)},"withinCreate")})}finally{x()}if(n.kind!=="human"&&U(z(n.node_id,n.grantee),{recursive:!0}),i!==null&&e.subscribe!==!1&&J(i,n.node_id,!0),i!==null&&c!==i)try{te(n.node_id,W(n.node_id),`Child created \u2014 ${n.name} (${n.node_id}, ${n.kind})`,{birth_announcement:oe,body:le({name:n.name,nodeId:n.node_id,kind:n.kind,creator:c===null?"an external process":s(c).name})},"deferred")}catch{}return a!=null&&s(a)!==null&&K(n.node_id,a),n}o(Le,"spawnNode");export{S as NodeIdConflictError,He as currentNodeContext,fe as forkSourceNode,ae as newJobId,se as newNodeId,Ue as nodeEnv,Fe as preflightNodeId,Pe as rootOfSpine,Be as setInstallId,Le as spawnNode};

package/dist/core/runtime/outcome-document.js

@@ -1 +1 @@
-var f=Object.defineProperty;var s=(t,e)=>f(t,"name",{value:e,configurable:!0});import{existsSync as p,readFileSync as m}from"node:fs";import{contextDir as y,reportsDir as _}from"../canvas/paths.js";import{outputResultPath as R}from"./structured-output.js";const h=256*1024;function B(t){const e=R(t);try{return p(e)?JSON.parse(m(e,"utf8")):void 0}catch{return}}s(B,"structuredResult");function b(t){if(t===null)return null;try{return JSON.parse(t)}catch{return null}}s(b,"parseDetail");function c(t){if(Buffer.byteLength(t,"utf8")<=1024)return t;const n="\u2026";let i=Buffer.byteLength(n,"utf8"),r="";for(const d of t){const l=Buffer.byteLength(d,"utf8");if(i+l>1024)break;i+=l,r+=d}return`${r}${n}`}s(c,"truncateDescription");function D(t){const{node:e,outcome:n,action:i}=t,r=b(n.detailJson),d=t.finalReport??e.final_report??"",l=c(e.name),o=e.description===void 0?void 0:c(e.description),a=n.kind==="result"?t.structuredResult===void 0?B(e.node_id):t.structuredResult:void 0,u={schema:"crtr.node-outcome/v1",outcomeId:`${e.node_id}:${n.revision}`,nodeId:e.node_id,revision:n.revision,kind:n.kind,reason:n.reason,settledAt:n.at,node:{name:l,...o===void 0?{}:{description:o},kind:e.kind,mode:e.mode,lifecycle:e.lifecycle,status:e.status,terminalReason:e.terminal_reason??null,cwd:e.cwd,createdAt:e.created,parent:e.parent??null,spawnedBy:e.spawned_by??null},...n.kind==="result"?{result:{finalReport:{basename:d,path:`${_(e.node_id)}/${d}`},...a===void 0?{}:{structuredResult:a}}}:{failure:{message:r?.message??null,faultKind:r?.fault_kind??null,errorClass:r?.error_class??null,respawnFailures:r?.respawn_failures??null,deadline:r?.deadline===void 0?null:{deadlineAt:r.deadline.deadline_at,elapsedMs:r.deadline.elapsed_ms},declined:r?.declined??null}},action:i,delivery:{attempt:0}};return Buffer.byteLength(JSON.stringify(u),"utf8")>h&&u.result?.structuredResult!==void 0&&(delete u.result.structuredResult,u.result.structuredResultOmitted=!0,u.result.structuredResultPath=`${y(e.node_id)}/result.json`),u}s(D,"composeNodeOutcomeDocument");export{D as composeNodeOutcomeDocument};
+var f=Object.defineProperty;var s=(t,e)=>f(t,"name",{value:e,configurable:!0});import{contextDir as m,reportsDir as p}from"../canvas/node-agent-paths.js";import{readOutputResult as y}from"./structured-output.js";const _=256*1024;function R(t,e){try{return y(t,e)}catch{return}}s(R,"structuredResult");function h(t){if(t===null)return null;try{return JSON.parse(t)}catch{return null}}s(h,"parseDetail");function c(t){if(Buffer.byteLength(t,"utf8")<=1024)return t;const n="\u2026";let l=Buffer.byteLength(n,"utf8"),r="";for(const d of t){const i=Buffer.byteLength(d,"utf8");if(l+i>1024)break;l+=i,r+=d}return`${r}${n}`}s(c,"truncateDescription");function $(t){const{node:e,outcome:n,action:l}=t,r=h(n.detailJson),d=t.finalReport??e.final_report??"",i=c(e.name),o=e.description===void 0?void 0:c(e.description),a=n.kind==="result"?t.structuredResult===void 0?R(e.node_id,e.grantee):t.structuredResult:void 0,u={schema:"crtr.node-outcome/v1",outcomeId:`${e.node_id}:${n.revision}`,nodeId:e.node_id,revision:n.revision,kind:n.kind,reason:n.reason,settledAt:n.at,node:{name:i,...o===void 0?{}:{description:o},kind:e.kind,mode:e.mode,lifecycle:e.lifecycle,status:e.status,terminalReason:e.terminal_reason??null,cwd:e.cwd,createdAt:e.created,parent:e.parent??null,spawnedBy:e.spawned_by??null},...n.kind==="result"?{result:{finalReport:{basename:d,path:`${p(e.node_id)}/${d}`},...a===void 0?{}:{structuredResult:a}}}:{failure:{message:r?.message??null,faultKind:r?.fault_kind??null,errorClass:r?.error_class??null,respawnFailures:r?.respawn_failures??null,deadline:r?.deadline===void 0?null:{deadlineAt:r.deadline.deadline_at,elapsedMs:r.deadline.elapsed_ms},declined:r?.declined??null}},action:l,delivery:{attempt:0}};return Buffer.byteLength(JSON.stringify(u),"utf8")>_&&u.result?.structuredResult!==void 0&&(delete u.result.structuredResult,u.result.structuredResultOmitted=!0,u.result.structuredResultPath=`${m(e.node_id,e.grantee)}/result.json`),u}s($,"composeNodeOutcomeDocument");export{$ as composeNodeOutcomeDocument};

package/dist/core/runtime/package-health.js

@@ -1,4 +1,4 @@
-var u=Object.defineProperty;var t=(r,e)=>u(r,"name",{value:e,configurable:!0});import{existsSync as f,readFileSync as g}from"node:fs";import{homedir as a}from"node:os";import{join as p,resolve as d}from"node:path";import{isRendererReady as h}from"../termrender/termrender.js";import{expandTilde as l}from"../fs-utils.js";function $(){return h()?null:"crtr: the pinned termrender renderer is not provisioned \u2014 pages, reviews, and inline diagrams render as plaintext.\n  Fix: run `crtr sys setup` (requires `uv`: curl -LsSf https://astral.sh/uv/install.sh | sh)."}t($,"rendererWarning");function A(r=a()){const e=process.env.PI_CODING_AGENT_DIR;return e!==void 0&&e!==""?l(e,r):p(r,".pi","agent")}t(A,"piAgentDir");function m(r){return r.startsWith("npm:")?!1:r.startsWith(".")||r.startsWith("/")||r.startsWith("~")}t(m,"isLocalPathSource");function y(r,e=a()){let n;try{n=g(p(r,"settings.json"),"utf8")}catch{return[]}let s;try{s=JSON.parse(n).packages}catch{return[]}if(!Array.isArray(s))return[];const i=[];for(const o of s){if(typeof o!="string"||!m(o))continue;const c=d(r,l(o,e));f(c)||i.push({source:o,resolved:c})}return i}t(y,"findMissingPackagePaths");function j(r,e=a()){const n=y(r,e);if(n.length===0)return null;const s=n.map(i=>`  \u2022 ${i.source}
+var u=Object.defineProperty;var t=(r,e)=>u(r,"name",{value:e,configurable:!0});import{existsSync as f,readFileSync as g}from"node:fs";import{homedir as a}from"node:os";import{appSpace as m}from"../layout.js";import{join as c,resolve as d}from"node:path";import{isRendererReady as h}from"../termrender/termrender.js";import{expandTilde as l}from"../fs-utils.js";function j(){return h()?null:"crtr: the pinned termrender renderer is not provisioned \u2014 pages, reviews, and inline diagrams render as plaintext.\n  Fix: run `crtr sys setup` (requires `uv`: curl -LsSf https://astral.sh/uv/install.sh | sh)."}t(j,"rendererWarning");function w(r=a()){const e=process.env.PI_CODING_AGENT_DIR;return e!==void 0&&e!==""?l(e,r):c(r===a()?m("terminal").home:r,".pi","agent")}t(w,"piAgentDir");function y(r){return r.startsWith("npm:")?!1:r.startsWith(".")||r.startsWith("/")||r.startsWith("~")}t(y,"isLocalPathSource");function v(r,e=a()){let n;try{n=g(c(r,"settings.json"),"utf8")}catch{return[]}let s;try{s=JSON.parse(n).packages}catch{return[]}if(!Array.isArray(s))return[];const i=[];for(const o of s){if(typeof o!="string"||!y(o))continue;const p=d(r,l(o,e));f(p)||i.push({source:o,resolved:p})}return i}t(v,"findMissingPackagePaths");function F(r,e=a()){const n=v(r,e);if(n.length===0)return null;const s=n.map(i=>`  \u2022 ${i.source}
       \u2192 ${i.resolved} (missing)`);return`crtr: ${n.length} configured pi package path${n.length===1?"":"s"} no longer exist${n.length===1?"s":""} \u2014 pi silently skips these, so their slash commands (e.g. ~/.claude commands & marketplace plugins) will not load.
 `+s.join(`
-`)+"\n  Fix: re-run `crtr sys setup` (re-resolves package paths to this repo's current location)."}t(j,"missingPackageWarning");export{y as findMissingPackagePaths,j as missingPackageWarning,A as piAgentDir,$ as rendererWarning};
+`)+"\n  Fix: re-run `crtr sys setup` (re-resolves package paths to this repo's current location)."}t(F,"missingPackageWarning");export{v as findMissingPackagePaths,F as missingPackageWarning,w as piAgentDir,j as rendererWarning};

package/dist/core/runtime/persona.js

@@ -1,2 +1,2 @@
-var s=Object.defineProperty;var a=(o,e)=>s(o,"name",{value:e,configurable:!0});import{getNode as i,updateNode as c}from"../canvas/index.js";import{readRoadmap as l,roadmapPath as d}from"./roadmap.js";import{orchestratorContextNote as u}from"./bearings.js";function m(o,e){const r=l(o)??"(no roadmap yet)",t=d(o),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 scaffold (\`${t}\`) \u2014 author it now: state the goal, exit criteria, and the phase skeleton, using your orchestration protocol. Current contents:`,"",r,"",u(o),"",'Your three long-term memory scopes (user-global, project, node-local) already surface in your bearings at boot. What promotion changes is USE, not access: you now persist across refresh cycles, so node-local carries what THIS goal needs between your refreshes, and durable facts you commit to user-global or project outlive this node. Use `crtr memory write` to save a document; `crtr memory list` to browse; `crtr memory find` to search (see "Your long-term memory" above for the full substrate flow).',"","Then delegate each phase with `crtr node new --kind <kind>`. When your context fills, run `crtr node yield` to refresh against this roadmap."),n.join(`
-`)}a(m,"orchestrationGuidance");function f(){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."}a(f,"baseModeGuidance");function p(o,e,r){if(e.mode===r.mode)return"";if(r.mode==="base")return f();const t=i(o);return m(o,t?.kind??"general")}a(p,"transitionGuidance");function k(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,n=t===void 0?r:{kind:t.kind??e.kind,mode:t.mode,lifecycle:t.lifecycle};return n.kind===r.kind&&n.mode===r.mode&&n.lifecycle===r.lifecycle?null:{from:n,to:r,guidance:p(o,n,r)}}a(k,"personaDrift");function b(o,e){c(o,{persona_ack:e})}a(b,"commitPersonaAck");export{b as commitPersonaAck,k as personaDrift,p as transitionGuidance};
+var c=Object.defineProperty;var a=(o,e)=>c(o,"name",{value:e,configurable:!0});import{getNode as s,updateNode as l}from"../canvas/index.js";import{readRoadmap as d,roadmapPath as u}from"./roadmap.js";import{orchestratorContextNote as m}from"./bearings.js";function f(o,e,r){const t=d(o)??"(no roadmap yet)",n=u(o),i=[`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 i.push("",`Your roadmap scaffold (\`${n}\`) \u2014 author it now: state the goal, exit criteria, and the phase skeleton, using your orchestration protocol. Current contents:`,"",t,"",m(o,r),"",'Your three long-term memory scopes (user-global, project, node-local) already surface in your bearings at boot. What promotion changes is USE, not access: you now persist across refresh cycles, so node-local carries what THIS goal needs between your refreshes, and durable facts you commit to user-global or project outlive this node. Use `crtr memory write` to save a document; `crtr memory list` to browse; `crtr memory find` to search (see "Your long-term memory" above for the full substrate flow).',"","Then delegate each phase with `crtr node new --kind <kind>`. When your context fills, run `crtr node yield` to refresh against this roadmap."),i.join(`
+`)}a(f,"orchestrationGuidance");function p(){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."}a(p,"baseModeGuidance");function h(o,e,r){if(e.mode===r.mode)return"";if(r.mode==="base")return p();const t=s(o);return f(o,t?.kind??"general",t?.grantee)}a(h,"transitionGuidance");function b(o){const e=s(o);if(e===null)return null;const r={kind:e.kind,mode:e.mode,lifecycle:e.lifecycle},t=e.persona_ack,n=t===void 0?r:{kind:t.kind??e.kind,mode:t.mode,lifecycle:t.lifecycle};return n.kind===r.kind&&n.mode===r.mode&&n.lifecycle===r.lifecycle?null:{from:n,to:r,guidance:h(o,n,r)}}a(b,"personaDrift");function x(o,e){l(o,{persona_ack:e})}a(x,"commitPersonaAck");export{x as commitPersonaAck,b as personaDrift,h as transitionGuidance};

package/dist/core/runtime/pi-vendored.js

@@ -1 +1 @@
-var i=Object.defineProperty;var n=(e,s)=>i(e,"name",{value:s,configurable:!0});import{homedir as t}from"node:os";import{join as o}from"node:path";import{expandTilde as r}from"../fs-utils.js";function d(){const e=process.env.PI_CODING_AGENT_DIR,s=e!==void 0&&e!==""?r(e):o(t(),".pi","agent");return o(s,"sessions")}n(d,"piSessionsRoot");const l=[{name:"settings",description:"Open settings menu"},{name:"model",description:"Select model (opens selector UI)"},{name:"scoped-models",description:"Enable/disable models for Ctrl+P cycling"},{name:"export",description:"Export session (HTML default, or specify path: .html/.jsonl)"},{name:"import",description:"Import and resume a session from a JSONL file"},{name:"share",description:"Share session as a secret GitHub gist"},{name:"copy",description:"Copy last agent message to clipboard"},{name:"name",description:"Set session display name"},{name:"session",description:"Show session info and stats"},{name:"changelog",description:"Show changelog entries"},{name:"hotkeys",description:"Show all keyboard shortcuts"},{name:"fork",description:"Create a new fork from a previous user message"},{name:"clone",description:"Duplicate the current session at the current position"},{name:"tree",description:"Navigate session tree (switch branches)"},{name:"login",description:"Configure provider authentication"},{name:"logout",description:"Remove provider authentication"},{name:"new",description:"Start a new session"},{name:"compact",description:"Manually compact the session context"},{name:"resume",description:"Resume a different session"},{name:"reload",description:"Reload keybindings, extensions, skills, prompts, and themes"},{name:"quit",description:"Quit pi"}];export{l as BUILTIN_SLASH_COMMANDS,d as piSessionsRoot};
+var i=Object.defineProperty;var e=(s,n)=>i(s,"name",{value:n,configurable:!0});import{join as o}from"node:path";import{piAgentDir as t}from"./package-health.js";function c(){return o(t(),"sessions")}e(c,"piSessionsRoot");const m=[{name:"settings",description:"Open settings menu"},{name:"model",description:"Select model (opens selector UI)"},{name:"scoped-models",description:"Enable/disable models for Ctrl+P cycling"},{name:"export",description:"Export session (HTML default, or specify path: .html/.jsonl)"},{name:"import",description:"Import and resume a session from a JSONL file"},{name:"share",description:"Share session as a secret GitHub gist"},{name:"copy",description:"Copy last agent message to clipboard"},{name:"name",description:"Set session display name"},{name:"session",description:"Show session info and stats"},{name:"changelog",description:"Show changelog entries"},{name:"hotkeys",description:"Show all keyboard shortcuts"},{name:"fork",description:"Create a new fork from a previous user message"},{name:"clone",description:"Duplicate the current session at the current position"},{name:"tree",description:"Navigate session tree (switch branches)"},{name:"login",description:"Configure provider authentication"},{name:"logout",description:"Remove provider authentication"},{name:"new",description:"Start a new session"},{name:"compact",description:"Manually compact the session context"},{name:"resume",description:"Resume a different session"},{name:"reload",description:"Reload keybindings, extensions, skills, prompts, and themes"},{name:"quit",description:"Quit pi"}];export{m as BUILTIN_SLASH_COMMANDS,c as piSessionsRoot};

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

@@ -1,4 +1,4 @@
-export { paneExists, paneLocation, paneOfNode, paneCurrentPath, paneSize, paneRunning, ensureSession, openNodeWindow, splitWindow, closePane, currentTmux, switchClient, selectWindow, selectLayout, selectPane, getPaneOption, setPaneOption, breakPane, inTmux, piCommand, shellQuote, renameWindow, displayPopup, windowOfPane, respawnPaneSync, respawnPaneInBackground, respawnPaneInPlace, paneStartCommand, panePid, windowAlive, listLivePanes, VIEWER_STAMP_OPTION, stampViewerPaneAsync, liveViewerPanes, sendAttachControl, displayClientMessage, } from './tmux-driver.js';
+export { paneExists, paneLocation, paneOfNode, paneCurrentPath, paneSize, paneRunning, ensureSession, openNodeWindow, splitWindow, closePane, currentTmux, switchClient, selectWindow, selectLayout, selectPane, getPaneOption, setPaneOption, breakPane, inTmux, piCommand, shellQuote, renameWindow, displayPopup, windowOfPane, respawnPaneSync, respawnPaneInBackground, respawnPaneInPlace, runShellInBackground, paneStartCommand, panePid, windowAlive, listLivePanes, VIEWER_STAMP_OPTION, stampViewerPaneAsync, liveViewerPanes, sendAttachControl, displayClientMessage, } from './tmux-driver.js';
 export { installTmuxBindings } from './tmux-bindings.js';
 export { BROKER_VIEW_SOCKET_WAIT_MS, waitForBrokerViewSocket } from './view-socket.js';
 /** Env for a `crtr surface attach` VIEWER pane (the focus split, the spawn viewer