@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/runtime/broker/turn-ignition.js

@@ -1,84 +1 @@
-import { emitEvent } from '../../events/emit.js';
-import { operationIdContext } from '../../events/operation-id.js';
-import { isUnknownModel } from '../model-selection.js';
-/** How long a caller waits for a dispatched prompt to become abortable, and how
- *  often it re-reads the engine while waiting. */
-const ABORTABLE_WAIT_MS = 5_000;
-const ABORTABLE_POLL_MS = 25;
-export function createPromptDispatchTracker(session) {
-    let pending = 0;
-    return {
-        track(p) {
-            pending++;
-            const tracked = Promise.resolve(p);
-            void tracked.finally(() => {
-                pending--;
-            });
-            return tracked;
-        },
-        pending: () => pending,
-        async waitUntilAbortable() {
-            if (session().isStreaming || pending === 0)
-                return;
-            const deadline = Date.now() + ABORTABLE_WAIT_MS;
-            while (Date.now() < deadline && !session().isStreaming && pending > 0) {
-                await new Promise((resolve) => setTimeout(resolve, ABORTABLE_POLL_MS));
-            }
-        },
-    };
-}
-export function createTurnAcceptanceGate() {
-    const waiters = new Set();
-    return {
-        waitFor: (waiter) => void waiters.add(waiter),
-        cancel: (waiter) => void waiters.delete(waiter),
-        notifyAccepted() {
-            const pending = [...waiters];
-            waiters.clear();
-            for (const waiter of pending)
-                waiter();
-        },
-    };
-}
-export function createKickoffDriver(deps) {
-    const { session, dispatches, turnAdmission } = deps;
-    let pendingPrompt;
-    let inFlight = false;
-    const sessionHasNoModel = () => session().model === undefined || isUnknownModel(session().model);
-    const drivePending = () => {
-        if (pendingPrompt === undefined || inFlight || sessionHasNoModel())
-            return;
-        inFlight = true;
-        void turnAdmission.admit((release) => {
-            const prompt = pendingPrompt;
-            if (prompt === undefined || sessionHasNoModel()) {
-                release();
-                inFlight = false;
-                return Promise.resolve();
-            }
-            pendingPrompt = undefined;
-            return dispatches.track(operationIdContext.fresh(() => session()
-                .prompt(prompt, {
-                preflightResult: release,
-                ...(session().isStreaming ? { streamingBehavior: 'steer' } : {}),
-            })
-                .catch((err) => {
-                emitEvent({
-                    level: 'error',
-                    event: 'broker.prompt.first_failed',
-                    error: err,
-                });
-            })
-                .finally(() => {
-                inFlight = false;
-            })));
-        });
-    };
-    return {
-        kickoff(prompt) {
-            pendingPrompt = prompt;
-            drivePending();
-        },
-        drivePending,
-    };
-}
+var m=Object.defineProperty;var r=(t,e)=>m(t,"name",{value:e,configurable:!0});import{emitEvent as p}from"../../events/emit.js";import{operationIdContext as u}from"../../events/operation-id.js";import{isUnknownModel as v}from"../model-selection.js";const g=5e3,w=25;function S(t){let e=0;return{track(n){e++;const i=Promise.resolve(n);return i.finally(()=>{e--}),i},pending:r(()=>e,"pending"),async waitUntilAbortable(){if(t().isStreaming||e===0)return;const n=Date.now()+g;for(;Date.now()<n&&!t().isStreaming&&e>0;)await new Promise(i=>setTimeout(i,w))}}}r(S,"createPromptDispatchTracker");function T(){const t=new Set;return{waitFor:r(e=>{t.add(e)},"waitFor"),cancel:r(e=>{t.delete(e)},"cancel"),notifyAccepted(){const e=[...t];t.clear();for(const n of e)n()}}}r(T,"createTurnAcceptanceGate");function _(t){const{session:e,dispatches:n,turnAdmission:i}=t;let o,a=!1;const c=r(()=>e().model===void 0||v(e().model),"sessionHasNoModel"),d=r(()=>{o===void 0||a||c()||(a=!0,i.admit(s=>{const f=o;return f===void 0||c()?(s(),a=!1,Promise.resolve()):(o=void 0,n.track(u.fresh(()=>e().prompt(f,{preflightResult:s,...e().isStreaming?{streamingBehavior:"steer"}:{}}).catch(l=>{p({level:"error",event:"broker.prompt.first_failed",error:l})}).finally(()=>{a=!1}))))}))},"drivePending");return{kickoff(s){o=s,d()},drivePending:d}}r(_,"createKickoffDriver");export{_ as createKickoffDriver,S as createPromptDispatchTracker,T as createTurnAcceptanceGate};

package/dist/core/runtime/broker-cli.js

@@ -1,81 +1,3 @@
-// broker-cli.ts — the headless broker's dedicated detached entry (plan T4 /
-// decision §1.13). Spawned directly via `spawn(execPath, [thisFile, nodeId], …)`
-// by HeadlessBrokerHost.launch — NEVER routed through src/cli.ts, which
-// would run the whole bootstrap chain (auto-update / scope-init / slash-template
-// rewrite) on every broker boot. Mirrors src/daemon/crtrd-cli.ts: parse the one
-// positional arg and hand off; keep this file a thin shim.
-import { isSafeNodeId } from '../canvas/paths.js';
-import { emitEvent } from '../events/emit.js';
-import { mark, timingProc } from '../timing.js';
-// Record this before dynamically importing broker.ts: ESM static imports finish
-// evaluating before module bodies run, so a static broker import would hide its
-// cold import graph from the boot trace. runBroker binds the canonical event
-// source as its own first line and emits the cli_entry/module_loaded startup
-// events from these captured timestamps; this file only validates raw argv
-// defense-in-depth before that module even loads.
-const startupAt = process.hrtime.bigint();
-const startupTs = new Date().toISOString();
-// The node id is by contract the FINAL argv token — the ps-based daemon
-// census parses the same way, and the `--canvas-home <path>` / `--epoch <id>`
-// ownership tags the host inserts before it (host.ts launch) are transparent
-// here.
-const nodeId = process.argv.length > 2 ? process.argv.at(-1) : undefined;
-if (nodeId === undefined || !isSafeNodeId(nodeId)) {
-    process.stderr.write('[broker] usage: broker-cli [--canvas-home <path>] [--epoch <id>] <nodeId>\n');
-    process.exit(1);
-}
-timingProc('broker');
-mark('broker.entry', { node: nodeId });
-const { runBroker, disposeActiveSession } = await import('./broker.js');
-mark('broker.module_loaded');
-// M3 (scout mq5thyli): dispose the live engine before a FATAL exit. The bash tool
-// spawns children `detached` (own pgid); only session.dispose() (→ abortBash /
-// agent.abort → killProcessTree) reaps them. The graceful path (shutdownHandler /
-// SIGTERM → disposeAndExit) already disposes; this routes the crash path —
-// uncaughtException / unhandledRejection / a runBroker reject — through dispose
-// too, so a fatal error never ORPHANS in-flight bash subprocesses. dispose is
-// idempotent + a no-op once the graceful path has run.
-function disposeAndExit(code) {
-    try {
-        disposeActiveSession();
-    }
-    catch {
-        /* dispose must not block the fatal exit */
-    }
-    process.exit(code);
-}
-// Last-resort safety net (review N-4): a stray throw/rejection from the SDK event
-// stream or an extension's async hook would otherwise crash the broker on Node's
-// default handler. One canonical-first helper serves all three fatal origins:
-// it attempts exactly one `broker.runtime.fatal` canonical event, and mirrors a
-// formatted stack to stderr (the host redirects broker stderr to the node's
-// job/broker.log) ONLY when that canonical append returns false or throws —
-// i.e. no broker source could be bound/used, which is the normal case for a
-// pre-bind import/module failure and the fallback for any other append failure.
-function reportFatal(origin, err) {
-    let reported;
-    try {
-        reported = emitEvent({ level: 'error', event: 'broker.runtime.fatal', error: err, fields: { origin } });
-    }
-    catch {
-        reported = false;
-    }
-    if (!reported) {
-        process.stderr.write(`[broker] fatal (${origin}): ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
-    }
-}
-// The daemon-owned ChildProcess exit lands in the fleet policy lane. Before
-// session_start the sessionless row is a surfaced boot failure (row 8); after
-// session_start the durable session is resumed or cycled from row state.
-process.on('uncaughtException', (err) => {
-    reportFatal('uncaughtException', err);
-    disposeAndExit(1);
-});
-process.on('unhandledRejection', (reason) => {
-    reportFatal('unhandledRejection', reason);
-    disposeAndExit(1);
-});
-runBroker(nodeId, startupAt, startupTs).catch((err) => {
-    reportFatal('run_failure', err);
-    disposeAndExit(1);
-});
+var a=Object.defineProperty;var n=(e,r)=>a(e,"name",{value:r,configurable:!0});import{isSafeNodeId as d}from"../canvas/paths.js";import{emitEvent as p}from"../events/emit.js";import{mark as c,timingProc as u}from"../timing.js";const f=process.hrtime.bigint(),l=new Date().toISOString(),t=process.argv.length>2?process.argv.at(-1):void 0;(t===void 0||!d(t))&&(process.stderr.write(`[broker] usage: broker-cli [--canvas-home <path>] [--epoch <id>] <nodeId>
+`),process.exit(1)),u("broker"),c("broker.entry",{node:t});const{runBroker:m,disposeActiveSession:h}=await import("./broker.js");c("broker.module_loaded");function s(e){try{h()}catch{}process.exit(e)}n(s,"disposeAndExit");function i(e,r){let o;try{o=p({level:"error",event:"broker.runtime.fatal",error:r,fields:{origin:e}})}catch{o=!1}o||process.stderr.write(`[broker] fatal (${e}): ${r instanceof Error?r.stack??r.message:String(r)}
+`)}n(i,"reportFatal"),process.on("uncaughtException",e=>{i("uncaughtException",e),s(1)}),process.on("unhandledRejection",e=>{i("unhandledRejection",e),s(1)}),m(t,f,l).catch(e=>{i("run_failure",e),s(1)});

package/dist/core/runtime/broker-extension-render.js

@@ -1,135 +1,5 @@
-// Pure broker-side render adapters. crtrd supplies the fixed extension-state
-// DTO; these functions only combine it with node-local/filesystem information.
-import { contextDir, nodeDir } from '../canvas/paths.js';
-import { interpolateNodePaths } from '../canvas/paths.js';
-import { fullName } from '../canvas/labels.js';
-import { renderKnowledgeForSubject, renderPreferencesForSubject } from '../substrate/render.js';
-import { renderWorkspaceOpenDocsForSubject } from '../substrate/on-read.js';
-import { buildProjectContextBlock, contextDirNote as contextDirNoteShared, profileNote as profileNoteShared, relativeLabel as relativeLabelShared, renderGraphMap, buildIdentityAssertion, worktreeNote as worktreeNoteShared, } from './bearings-render.js';
-export function editorLabelForBrokerNode(node) {
-    const icon = (node.icon ?? '').trim();
-    const handle = node.name !== node.kind ? node.name.trim() : '';
-    const name = handle !== '' ? handle : (node.description ?? '').trim() || node.name;
-    return icon === '' ? name : `${icon} ${name}`;
-}
-/** Same environment-only project context rendered at normal boot, without a
- * canvas import. */
-export function buildProjectContextBlockForBroker(cwd) {
-    return buildProjectContextBlock(cwd);
-}
-function contextDirNote(nodeId) {
-    return contextDirNoteShared(nodeId);
-}
-function profileNote(node) {
-    return profileNoteShared(node.cwd, node.profile_id);
-}
-function relativeLabel(node) {
-    return relativeLabelShared(node);
-}
-function graphMap(state) {
-    const { ancestors, children, node } = state;
-    return renderGraphMap(node.node_id, node.kind, node.mode, ancestors, children);
-}
-function identity(state) {
-    const { node, fork_source: source } = state;
-    const sourceLabel = source === null ? (node.fork_from ?? '') : `${node.fork_from} ("${fullName(source)}")`;
-    return buildIdentityAssertion(node.node_id, node.kind, node.mode, node.fork_from, sourceLabel);
-}
-function worktreeNote(node) {
-    return worktreeNoteShared(node.managed_worktree);
-}
-/** The companion note — rendered ONLY when a node carries its immutable
- *  companion binding. Names the target (the document under review, or the page
- *  the feedback is about), and for a page-feedback companion carries the whole
- *  behavioral contract — the companion is an ordinary fork of the sending node,
- *  so this note is the only place it learns the role. */
-function reviewNote(node) {
-    const review = node.review_binding;
-    if (review === null || review === undefined)
-        return '';
-    if (review.kind === 'page_feedback') {
-        const ticketId = review.review_id;
-        const targetFile = review.target_file;
-        return (`You exist for one page's feedback conversation — ticket \`${ticketId}\`, page source \`${targetFile}\`. ` +
-            `Think with the person about this one page and answer in a few plain sentences from the context you already carry. ` +
-            `Revise the page in place with \`crtr human send --replace ${ticketId} --page ${targetFile}\` — it swaps in on their screen immediately — and briefly say what changed; a silent swap leaves them guessing. ` +
-            `After dealing with an open feedback item — by revising the page or answering it here — resolve it with \`crtr human feedback resolve <comment_id>\`; ` +
-            `\`crtr human feedback list ${ticketId}\` shows each item's id and status. ` +
-            `Never author feedback or resolve an item before dealing with it — a sent comment is immutable, and resolution is your report that the work is done. ` +
-            `Asked to act beyond this page, give your advice and point the person at submitting it: the submitted answer is what reaches the task's owner, while work done here is invisible to it and ends when the ticket settles. ` +
-            `When a question needs real exploration, delegate it to a child node and keep talking while it runs. ` +
-            `The inherited conversation belongs to the origin node, not you — its task stays with it; carry only the context needed for this page. ` +
-            `The person's visible transcript begins at the boundary marker above; everything earlier is context they cannot see — never treat it as shared ground; when they ask about it, answer plainly in your own words rather than replaying it.`);
-    }
-    return `You exist for one human review of \`${review.target_file}\`. The inherited conversation belongs to the origin node, not you — carry only the context needed for this review. The person's visible transcript begins at the boundary marker above; everything earlier is context they cannot see.`;
-}
-/** `situational` is the node's stored situational card, placed in the bearings
- *  BODY — the one place in the system where a runtime card nests inside
- *  another (see situational-context.ts). '' when none is set. */
-export function buildContextBearingsFromState(state, projectContext, situational = '', target) {
-    const { node } = state;
-    const bearings = ['<crtr-bearings>', identity(state)];
-    const map = graphMap(state);
-    if (map !== '')
-        bearings.push('', '## Your place in the canvas', map);
-    bearings.push('', '## Your context directory', contextDirNote(node.node_id));
-    const profile = profileNote(node);
-    if (profile !== '')
-        bearings.push('', profile);
-    const worktree = worktreeNote(node);
-    if (worktree !== '')
-        bearings.push('', '## Your managed worktree', worktree);
-    if (node.mode === 'orchestrator')
-        bearings.push('', `Because you persist across refresh cycles, your context directory (${contextDir(node.node_id)}) is also where a future cycle of you resumes the work — keep the working notes and decisions a refreshed you would need there, alongside the docs you share with the nodes you spawn.`);
-    bearings.push('</crtr-bearings>');
-    const knowledge = renderKnowledgeForSubject(state.subject, node.node_id, target);
-    const workspace = renderWorkspaceOpenDocsForSubject(state.subject, node.cwd, node.profile_id, target);
-    return [bearings.join('\n'), knowledge, workspace, situational, projectContext].filter((part) => part !== '').join('\n');
-}
-export function buildForkBearingsFromState(state, situational = '') {
-    const { node, fork_source: source } = state;
-    const sourceMandate = source?.status === 'active' || source?.status === 'idle'
-        ? `Source node ${source.node_id} ("${fullName(source)}") is still live and still holds the mandate from the copied conversation; do not resume that work here.`
-        : 'The source node’s earlier graph position, lifecycle, children, schedules, worktree, situational context, and context-directory path do not carry over. Shared conversation, project, and operating context remain reference material.';
-    const bearings = ['<crtr-bearings>', identity(state), '', sourceMandate, '', '## Your node now', `Lifecycle: ${node.lifecycle}.`];
-    const map = graphMap(state);
-    bearings.push(...(map === '' ? ['Canvas: independent root with no parent or inherited graph edges.'] : ['', map]));
-    bearings.push(`Context directory: \`${contextDir(node.node_id)}\` (\`$CRTR_CONTEXT_DIR\`). Use this path in place of every source-node context path above.`);
-    if (source === null || source.cwd !== node.cwd)
-        bearings.push(`Working directory: \`${node.cwd}\`.`);
-    if (source === null || source.profile_id !== node.profile_id) {
-        const profile = profileNote(node);
-        if (profile !== '')
-            bearings.push(profile);
-    }
-    const worktree = worktreeNote(node);
-    if (worktree !== '')
-        bearings.push('', '## Your managed worktree', worktree);
-    if (node.mode === 'orchestrator')
-        bearings.push('', `Because you persist across refresh cycles, your context directory (${contextDir(node.node_id)}) is also where a future cycle of you resumes the work — keep the working notes and decisions a refreshed you would need there, alongside the docs you share with the nodes you spawn.`);
-    const review = reviewNote(node);
-    if (review !== '')
-        bearings.push('', review);
-    bearings.push('', 'The first real user message after these bearings is your mandate.', '</crtr-bearings>');
-    return [bearings.join('\n'), situational].filter((part) => part !== '').join('\n');
-}
-export function renderPreferencesFromState(state, target) {
-    return renderPreferencesForNodeSubject(state.node.node_id, state.subject, target);
-}
-/** The same preference block without the extension-state DTO, for the daemon-side
- * claim path that holds a node's subject directly. */
-export function renderPreferencesForNodeSubject(nodeId, subject, target) {
-    return interpolateNodePaths(renderPreferencesForSubject(subject, target).block, nodeId);
-}
-/** A canonical report ref has already been validated by crtrd in state. The
- * broker reads only its local filesystem content; no canvas accessor is needed. */
-export function reportPathFromRef(ref, reportNodes) {
-    const separator = ref.indexOf(':');
-    if (separator <= 0)
-        return null;
-    const nodeId = ref.slice(0, separator);
-    const relpath = ref.slice(separator + 1);
-    if (!reportNodes.has(nodeId) || !relpath.startsWith('reports/') || relpath.includes('..') || relpath.startsWith('/'))
-        return null;
-    return `${nodeDir(nodeId)}/${relpath}`;
-}
+var k=Object.defineProperty;var s=(e,r)=>k(e,"name",{value:r,configurable:!0});import{contextDir as h,nodeDir as b}from"../canvas/paths.js";import{interpolateNodePaths as v}from"../canvas/paths.js";import{fullName as l}from"../canvas/labels.js";import{renderKnowledgeForSubject as x,renderPreferencesForSubject as _}from"../substrate/render.js";import{renderWorkspaceOpenDocsForSubject as $}from"../substrate/on-read.js";import{buildProjectContextBlock as N,contextDirNote as j,profileNote as S,relativeLabel as F,renderGraphMap as T,buildIdentityAssertion as B,worktreeNote as C}from"./bearings-render.js";function q(e){const r=(e.icon??"").trim(),t=e.name!==e.kind?e.name.trim():"",o=t!==""?t:(e.description??"").trim()||e.name;return r===""?o:`${r} ${o}`}s(q,"editorLabelForBrokerNode");function E(e){return N(e)}s(E,"buildProjectContextBlockForBroker");function D(e){return j(e)}s(D,"contextDirNote");function p(e){return S(e.cwd,e.profile_id)}s(p,"profileNote");function G(e){return F(e)}s(G,"relativeLabel");function f(e){const{ancestors:r,children:t,node:o}=e;return T(o.node_id,o.kind,o.mode,r,t)}s(f,"graphMap");function m(e){const{node:r,fork_source:t}=e,o=t===null?r.fork_from??"":`${r.fork_from} ("${l(t)}")`;return B(r.node_id,r.kind,r.mode,r.fork_from,o)}s(m,"identity");function w(e){return C(e.managed_worktree)}s(w,"worktreeNote");function P(e){const r=e.review_binding;if(r==null)return"";if(r.kind==="page_feedback"){const t=r.review_id,o=r.target_file;return`You exist for one page's feedback conversation \u2014 ticket \`${t}\`, page source \`${o}\`. Think with the person about this one page and answer in a few plain sentences from the context you already carry. Revise the page in place with \`crtr human send --replace ${t} --page ${o}\` \u2014 it swaps in on their screen immediately \u2014 and briefly say what changed; a silent swap leaves them guessing. After dealing with an open feedback item \u2014 by revising the page or answering it here \u2014 resolve it with \`crtr human feedback resolve <comment_id>\`; \`crtr human feedback list ${t}\` shows each item's id and status. Never author feedback or resolve an item before dealing with it \u2014 a sent comment is immutable, and resolution is your report that the work is done. Asked to act beyond this page, give your advice and point the person at submitting it: the submitted answer is what reaches the task's owner, while work done here is invisible to it and ends when the ticket settles. When a question needs real exploration, delegate it to a child node and keep talking while it runs. The inherited conversation belongs to the origin node, not you \u2014 its task stays with it; carry only the context needed for this page. The person's visible transcript begins at the boundary marker above; everything earlier is context they cannot see \u2014 never treat it as shared ground; when they ask about it, answer plainly in your own words rather than replaying it.`}return`You exist for one human review of \`${r.target_file}\`. The inherited conversation belongs to the origin node, not you \u2014 carry only the context needed for this review. The person's visible transcript begins at the boundary marker above; everything earlier is context they cannot see.`}s(P,"reviewNote");function K(e,r,t="",o){const{node:i}=e,n=["<crtr-bearings>",m(e)],c=f(e);c!==""&&n.push("","## Your place in the canvas",c),n.push("","## Your context directory",D(i.node_id));const d=p(i);d!==""&&n.push("",d);const u=w(i);u!==""&&n.push("","## Your managed worktree",u),i.mode==="orchestrator"&&n.push("",`Because you persist across refresh cycles, your context directory (${h(i.node_id)}) is also where a future cycle of you resumes the work \u2014 keep the working notes and decisions a refreshed you would need there, alongside the docs you share with the nodes you spawn.`),n.push("</crtr-bearings>");const a=x(e.subject,i.node_id,o),g=$(e.subject,i.cwd,i.profile_id,o);return[n.join(`
+`),a,g,t,r].filter(y=>y!=="").join(`
+`)}s(K,"buildContextBearingsFromState");function U(e,r=""){const{node:t,fork_source:o}=e,i=o?.status==="active"||o?.status==="idle"?`Source node ${o.node_id} ("${l(o)}") is still live and still holds the mandate from the copied conversation; do not resume that work here.`:"The source node\u2019s earlier graph position, lifecycle, children, schedules, worktree, situational context, and context-directory path do not carry over. Shared conversation, project, and operating context remain reference material.",n=["<crtr-bearings>",m(e),"",i,"","## Your node now",`Lifecycle: ${t.lifecycle}.`],c=f(e);if(n.push(...c===""?["Canvas: independent root with no parent or inherited graph edges."]:["",c]),n.push(`Context directory: \`${h(t.node_id)}\` (\`$CRTR_CONTEXT_DIR\`). Use this path in place of every source-node context path above.`),(o===null||o.cwd!==t.cwd)&&n.push(`Working directory: \`${t.cwd}\`.`),o===null||o.profile_id!==t.profile_id){const a=p(t);a!==""&&n.push(a)}const d=w(t);d!==""&&n.push("","## Your managed worktree",d),t.mode==="orchestrator"&&n.push("",`Because you persist across refresh cycles, your context directory (${h(t.node_id)}) is also where a future cycle of you resumes the work \u2014 keep the working notes and decisions a refreshed you would need there, alongside the docs you share with the nodes you spawn.`);const u=P(t);return u!==""&&n.push("",u),n.push("","The first real user message after these bearings is your mandate.","</crtr-bearings>"),[n.join(`
+`),r].filter(a=>a!=="").join(`
+`)}s(U,"buildForkBearingsFromState");function X(e,r){return Y(e.node.node_id,e.subject,r)}s(X,"renderPreferencesFromState");function Y(e,r,t){return v(_(r,t).block,e)}s(Y,"renderPreferencesForNodeSubject");function z(e,r){const t=e.indexOf(":");if(t<=0)return null;const o=e.slice(0,t),i=e.slice(t+1);return!r.has(o)||!i.startsWith("reports/")||i.includes("..")||i.startsWith("/")?null:`${b(o)}/${i}`}s(z,"reportPathFromRef");export{K as buildContextBearingsFromState,U as buildForkBearingsFromState,E as buildProjectContextBlockForBroker,q as editorLabelForBrokerNode,Y as renderPreferencesForNodeSubject,X as renderPreferencesFromState,z as reportPathFromRef};

package/dist/core/runtime/broker-inventory.js

@@ -1,116 +1 @@
-// broker-inventory.ts — one short-lived OBSERVER round trip against a live
-// node's broker that collects both chat-surface inventories at once: the
-// command disclosure (`get_commands`) and the inline memory-reference
-// inventory (`list_memory_refs`).
-//
-// It is modelled on `broker-request.ts`'s `oneShotControllerRequest` — the
-// sanctioned host→live-broker dance — but is a different shape: two frames on
-// one connection, settling on two independent answers, and never writable.
-// Both read-ops are explicitly observer-safe, so this connection never claims
-// controller and can never drive the engine.
-//
-// The two answers arrive by different routes because the frames differ.
-// `get_commands` is uncorrelated and answers with an `ack`, which surfaces on
-// the client's `frame` event. `list_memory_refs` answers with a correlated
-// `data` frame, and `BrokerClient` swallows EVERY `data` frame into its
-// pending-by-id resolver rather than re-emitting it — so that half must ride
-// `client.request()`, which mints the id and owns the reply.
-//
-// A read NEVER revives. A dormant node, a refused connection, or an expired
-// budget answers `broker_live:false` with empty arrays; one answer arriving
-// without the other yields that part plus an empty peer. Nothing here is fatal,
-// because a chat surface's behavior for "empty because it failed" and "empty
-// because it is empty" is identical.
-import { randomUUID } from 'node:crypto';
-import { getNode } from '../canvas/canvas.js';
-import { BrokerClient } from '../broker-client/index.js';
-import { gatewayCommandRowsFromDetail, gatewayMemoryRows } from './chat-inventory-rows.js';
-import { isBrokerLive } from './model-swap.js';
-/** Same budget as `broker-request.ts`: this is local engine work, so it is
- *  generous slack rather than a tuned deadline. One budget covers BOTH answers —
- *  whichever part has not arrived when it expires is returned empty. */
-const READ_TIMEOUT_MS = 15_000;
-/** The transcript window this reader asks for in its welcome. Any hello triggers
- *  `sendWelcome`, and an untailed welcome makes the broker build and encode the
- *  whole conversation on its serialized frame loop for a payload this reader
- *  throws away — on every activation and reconnect, worst on the longest
- *  conversations. One entry is the smallest legal request. */
-const SNAPSHOT_TAIL = 1;
-const empty = (nodeId) => ({
-    node_id: nodeId,
-    broker_live: false,
-    commands: [],
-    memory_refs: [],
-});
-/** Collect the chat inventories for one node. Always resolves — every failure
- *  mode is expressed in the returned document, not thrown. */
-export function readChatInventory(nodeId) {
-    const meta = getNode(nodeId);
-    if (meta === null || !isBrokerLive(meta))
-        return Promise.resolve(empty(nodeId));
-    return new Promise((resolve) => {
-        const client = new BrokerClient(nodeId);
-        const clientId = randomUUID();
-        let settled = false;
-        let connected = false;
-        let commands;
-        let memoryRefs;
-        const timer = setTimeout(() => finish(), READ_TIMEOUT_MS);
-        if (typeof timer.unref === 'function')
-            timer.unref();
-        /** Settle once with whatever arrived. A part that never answered stays
-         *  empty; a connection that never established reports a dormant broker. */
-        function finish() {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            try {
-                client.close();
-            }
-            catch {
-                /* best-effort */
-            }
-            resolve({
-                node_id: nodeId,
-                broker_live: connected,
-                commands: commands ?? [],
-                memory_refs: memoryRefs ?? [],
-            });
-        }
-        function settleWhenComplete() {
-            if (commands !== undefined && memoryRefs !== undefined)
-                finish();
-        }
-        client.on('error', () => finish());
-        client.on('close', () => finish());
-        client.on('connect', () => {
-            connected = true;
-            client.send({ type: 'hello', role: 'observer', client_id: clientId, snapshot_tail: SNAPSHOT_TAIL });
-            client.send({ type: 'get_commands' });
-            client.request({ type: 'list_memory_refs' }).then((frame) => {
-                memoryRefs = frame.kind === 'list_memory_refs' ? gatewayMemoryRows(frame.refs) : [];
-                settleWhenComplete();
-            }, () => {
-                memoryRefs = [];
-                settleWhenComplete();
-            });
-        });
-        client.on('frame', (frame) => {
-            // `get_commands` carries no id, so its ack is matched on `for` alone.
-            if (frame.type === 'ack' && frame.for === 'get_commands') {
-                commands = frame.ok ? gatewayCommandRowsFromDetail(frame.detail) : [];
-                settleWhenComplete();
-                return;
-            }
-            // The memory half's correlated error is consumed by its own request
-            // rejection, so an error reaching here is uncorrelated and can only be
-            // attributed to the uncorrelated half.
-            if (frame.type === 'error' && frame.id === undefined) {
-                commands ??= [];
-                settleWhenComplete();
-            }
-        });
-        client.connect();
-    });
-}
+var _=Object.defineProperty;var n=(o,r)=>_(o,"name",{value:r,configurable:!0});import{randomUUID as y}from"node:crypto";import{getNode as p}from"../canvas/canvas.js";import{BrokerClient as h}from"../broker-client/index.js";import{gatewayCommandRowsFromDetail as k,gatewayMemoryRows as v}from"./chat-inventory-rows.js";import{isBrokerLive as w}from"./model-swap.js";const T=15e3,g=1,C=n(o=>({node_id:o,broker_live:!1,commands:[],memory_refs:[]}),"empty");function S(o){const r=p(o);return r===null||!w(r)?Promise.resolve(C(o)):new Promise(a=>{const e=new h(o),u=y();let f=!1,d=!1,i,s;const l=setTimeout(()=>m(),T);typeof l.unref=="function"&&l.unref();function m(){if(!f){f=!0,clearTimeout(l);try{e.close()}catch{}a({node_id:o,broker_live:d,commands:i??[],memory_refs:s??[]})}}n(m,"finish");function c(){i!==void 0&&s!==void 0&&m()}n(c,"settleWhenComplete"),e.on("error",()=>m()),e.on("close",()=>m()),e.on("connect",()=>{d=!0,e.send({type:"hello",role:"observer",client_id:u,snapshot_tail:g}),e.send({type:"get_commands"}),e.request({type:"list_memory_refs"}).then(t=>{s=t.kind==="list_memory_refs"?v(t.refs):[],c()},()=>{s=[],c()})}),e.on("frame",t=>{if(t.type==="ack"&&t.for==="get_commands"){i=t.ok?k(t.detail):[],c();return}t.type==="error"&&t.id===void 0&&(i??=[],c())}),e.connect()})}n(S,"readChatInventory");export{S as readChatInventory};

package/dist/core/runtime/broker-persona-guidance.js

@@ -1,154 +1,4 @@
-import { contextDir } from '../canvas/paths.js';
-import { emitEvent } from '../events/emit.js';
-import { brokerExtensionState, commitBrokerPersonaAck } from './broker/daemon-ops.js';
-import { readRoadmap, roadmapPath } from './roadmap.js';
-import { buildSubPersonaMenu, renderConfigChangeDelta } from '../substrate/render.js';
-import { cloneContextExposureState, contextExposureStatesEqual, exposureTarget, loadContextExposureState, mergeContextExposureState, replaceContextExposureState, saveContextExposureState, sharedContextExposureState, } from '../substrate/injected-store.js';
-import { formatCard } from '../../shared/generated-context.js';
-function orchestratorContextNote(nodeId) {
-    return `Because you persist across refresh cycles, your context directory (${contextDir(nodeId)}) is also where a future cycle of you resumes the work — keep the working notes and decisions a refreshed you would need there, alongside the docs you share with the nodes you spawn.`;
-}
-function orchestrationGuidance(node) {
-    const roadmap = readRoadmap(node.node_id) ?? '(no roadmap yet)';
-    const rmPath = roadmapPath(node.node_id);
-    return [
-        `You are now a ${node.kind.toUpperCase()} ORCHESTRATOR. Your scarce resource is your own context window.`,
-        'Your job is to manage context and delegate — not to do the goal yourself.',
-        '',
-        `Your roadmap scaffold (\`${rmPath}\`) — author it now: state the goal, exit criteria, and the phase skeleton, using the approach below. Current contents:`,
-        '',
-        roadmap,
-        '',
-        orchestratorContextNote(node.node_id),
-        '',
-        '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.',
-    ].join('\n');
-}
-function baseModeGuidance() {
-    return 'You are HANDS-ON again — 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.';
-}
-function subPersonaGuidance(from, to) {
-    if (from.kind === to.kind)
-        return '';
-    const before = buildSubPersonaMenu(from.kind);
-    const after = buildSubPersonaMenu(to.kind);
-    if (before === after)
-        return '';
-    return after === ''
-        ? `The ${to.kind} kind has no specialist sub-personas available.`
-        : after;
-}
-function transitionGuidance(state, from, to, contextExposure) {
-    const sections = [];
-    if (from.mode !== to.mode) {
-        sections.push(to.mode === 'orchestrator' ? orchestrationGuidance(state.node) : baseModeGuidance());
-    }
-    sections.push(subPersonaGuidance(from, to));
-    sections.push(renderConfigChangeDelta(state.subject, state.node.node_id, exposureTarget(contextExposure, 'transcript')));
-    return sections.filter((section) => section !== '').join('\n\n');
-}
-export function personaDriftFromBrokerState(state) {
-    const node = state.node;
-    const to = { kind: node.kind, mode: node.mode, lifecycle: node.lifecycle };
-    const ack = node.persona_ack;
-    const from = ack === undefined
-        ? to
-        : { kind: ack.kind ?? node.kind, mode: ack.mode, lifecycle: ack.lifecycle };
-    if (from.kind === to.kind && from.mode === to.mode && from.lifecycle === to.lifecycle)
-        return null;
-    return { from, to };
-}
-/** A new context's current snapshots make a rank delta unnecessary. */
-export async function acknowledgePersonaBaseline(state) {
-    const drift = personaDriftFromBrokerState(state);
-    if (drift === null)
-        return false;
-    const result = await commitBrokerPersonaAck(state.node.node_id, drift);
-    if (!result.applied)
-        throw new Error(`persona baseline acknowledgment was rejected for ${state.node.node_id}`);
-    return true;
-}
-/** Append pending transitions until the delivered persona matches current canvas state. */
-export async function deliverPendingPersonaTransition(initialState, deliver) {
-    const nodeId = initialState.node.node_id;
-    const live = sharedContextExposureState(nodeId);
-    const persisted = loadContextExposureState(nodeId);
-    mergeContextExposureState(live, persisted);
-    if (live.preferenceSnapshot === null) {
-        throw new Error(`context preference snapshot is missing for ${nodeId}`);
-    }
-    if (!contextExposureStatesEqual(live, persisted))
-        saveContextExposureState(nodeId, live);
-    let state = initialState;
-    let daemonDrift = personaDriftFromBrokerState(state);
-    if (daemonDrift === null)
-        return false;
-    const next = cloneContextExposureState(live);
-    let represented = daemonDrift.from;
-    for (;;) {
-        const current = {
-            kind: state.node.kind,
-            mode: state.node.mode,
-            lifecycle: state.node.lifecycle,
-        };
-        if (represented.kind !== current.kind
-            || represented.mode !== current.mode
-            || represented.lifecycle !== current.lifecycle) {
-            const guidance = transitionGuidance(state, represented, current, next);
-            if (guidance !== '')
-                await deliver(formatCard('persona-transition', {}, guidance));
-            represented = current;
-            replaceContextExposureState(live, next);
-            saveContextExposureState(nodeId, live);
-        }
-        daemonDrift = personaDriftFromBrokerState(state);
-        if (daemonDrift === null)
-            return true;
-        const result = await commitBrokerPersonaAck(nodeId, daemonDrift);
-        if (result.applied)
-            return true;
-        state = await brokerExtensionState(nodeId);
-    }
-}
-/** Gate each provider request on durable delivery of the current persona delta. */
-export function installPersonaTransitionGate(nodeId, session, noteFailure = () => { }) {
-    const { agent } = session;
-    const previousTransform = agent.transformContext;
-    agent.transformContext = async (messages, signal) => {
-        const transformed = previousTransform === undefined
-            ? messages
-            : await previousTransform(messages, signal);
-        try {
-            const state = await brokerExtensionState(nodeId);
-            await deliverPendingPersonaTransition(state, (content) => {
-                const details = { nodeId };
-                const message = {
-                    role: 'custom',
-                    customType: 'crtr-persona-transition',
-                    content,
-                    display: true,
-                    details,
-                    timestamp: Date.now(),
-                };
-                session.sessionManager.appendCustomMessageEntry('crtr-persona-transition', content, true, details);
-                const active = agent.state.messages;
-                for (const context of new Set([active, messages, transformed]))
-                    context.push(message);
-            });
-            return transformed;
-        }
-        catch (error) {
-            noteFailure();
-            emitEvent({
-                event: 'broker.daemon.operation.failed',
-                level: 'error',
-                node_id: nodeId,
-                error,
-                fields: { operation: 'persona_transition' },
-            });
-            throw error;
-        }
-    };
-}
+var g=Object.defineProperty;var i=(e,o)=>g(e,"name",{value:o,configurable:!0});import{contextDir as b}from"../canvas/paths.js";import{emitEvent as S}from"../events/emit.js";import{brokerExtensionState as m,commitBrokerPersonaAck as h}from"./broker/daemon-ops.js";import{readRoadmap as C,roadmapPath as v}from"./roadmap.js";import{buildSubPersonaMenu as y,renderConfigChangeDelta as E}from"../substrate/render.js";import{cloneContextExposureState as T,contextExposureStatesEqual as _,exposureTarget as P,loadContextExposureState as Y,mergeContextExposureState as j,replaceContextExposureState as D,saveContextExposureState as w,sharedContextExposureState as $}from"../substrate/injected-store.js";import{formatCard as G}from"../../shared/generated-context.js";function B(e){return`Because you persist across refresh cycles, your context directory (${b(e)}) is also where a future cycle of you resumes the work \u2014 keep the working notes and decisions a refreshed you would need there, alongside the docs you share with the nodes you spawn.`}i(B,"orchestratorContextNote");function H(e){const o=C(e.node_id)??"(no roadmap yet)",r=v(e.node_id);return[`You are now a ${e.kind.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.","",`Your roadmap scaffold (\`${r}\`) \u2014 author it now: state the goal, exit criteria, and the phase skeleton, using the approach below. Current contents:`,"",o,"",B(e.node_id),"",'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."].join(`
+`)}i(H,"orchestrationGuidance");function M(){return"You are HANDS-ON again \u2014 base mode. Do the work yourself in THIS window and finish it here; stop delegating by default. You no longer drive a roadmap, so `crtr node yield` is not your exit. Spawn a child only for a cleanly separable unit, never as your first move."}i(M,"baseModeGuidance");function R(e,o){if(e.kind===o.kind)return"";const r=y(e.kind),t=y(o.kind);return r===t?"":t===""?`The ${o.kind} kind has no specialist sub-personas available.`:t}i(R,"subPersonaGuidance");function A(e,o,r,t){const n=[];return o.mode!==r.mode&&n.push(r.mode==="orchestrator"?H(e.node):M()),n.push(R(o,r)),n.push(E(e.subject,e.node.node_id,P(t,"transcript"))),n.filter(a=>a!=="").join(`
+
+`)}i(A,"transitionGuidance");function p(e){const o=e.node,r={kind:o.kind,mode:o.mode,lifecycle:o.lifecycle},t=o.persona_ack,n=t===void 0?r:{kind:t.kind??o.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}}i(p,"personaDriftFromBrokerState");async function K(e){const o=p(e);if(o===null)return!1;if(!(await h(e.node.node_id,o)).applied)throw new Error(`persona baseline acknowledgment was rejected for ${e.node.node_id}`);return!0}i(K,"acknowledgePersonaBaseline");async function N(e,o){const r=e.node.node_id,t=$(r),n=Y(r);if(j(t,n),t.preferenceSnapshot===null)throw new Error(`context preference snapshot is missing for ${r}`);_(t,n)||w(r,t);let a=e,d=p(a);if(d===null)return!1;const u=T(t);let s=d.from;for(;;){const c={kind:a.node.kind,mode:a.node.mode,lifecycle:a.node.lifecycle};if(s.kind!==c.kind||s.mode!==c.mode||s.lifecycle!==c.lifecycle){const l=A(a,s,c,u);l!==""&&await o(G("persona-transition",{},l)),s=c,D(t,u),w(r,t)}if(d=p(a),d===null||(await h(r,d)).applied)return!0;a=await m(r)}}i(N,"deliverPendingPersonaTransition");function L(e,o,r=()=>{}){const{agent:t}=o,n=t.transformContext;t.transformContext=async(a,d)=>{const u=n===void 0?a:await n(a,d);try{const s=await m(e);return await N(s,c=>{const f={nodeId:e},l={role:"custom",customType:"crtr-persona-transition",content:c,display:!0,details:f,timestamp:Date.now()};o.sessionManager.appendCustomMessageEntry("crtr-persona-transition",c,!0,f);const k=t.state.messages;for(const x of new Set([k,a,u]))x.push(l)}),u}catch(s){throw r(),S({event:"broker.daemon.operation.failed",level:"error",node_id:e,error:s,fields:{operation:"persona_transition"}}),s}}}i(L,"installPersonaTransitionGate");export{K as acknowledgePersonaBaseline,N as deliverPendingPersonaTransition,L as installPersonaTransitionGate,p as personaDriftFromBrokerState};