@north-light/crouter 0.3.317 → 0.3.319

package/dist/core/runtime/canvas-extensions.js

@@ -1,96 +1 @@
-import { existsSync } from 'node:fs';
-import { basename, dirname, extname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { customExtensionPaths, isShippedCanvasExtension } from '../canvas/extensions.js';
-function resolveExtension(name) {
-    const here = dirname(fileURLToPath(import.meta.url)); // dist/core/runtime or src/core/runtime
-    const candidates = [
-        join(here, '..', '..', 'pi-extensions', `${name}.js`),
-        join(here, '..', '..', 'pi-extensions', `${name}.ts`),
-    ];
-    return candidates.find((p) => existsSync(p)) ?? candidates[0];
-}
-export const CANVAS_STOPHOOK_PATH = resolveExtension('canvas-stophook');
-export const CANVAS_INBOX_WATCHER_PATH = resolveExtension('canvas-inbox-watcher');
-export const CANVAS_RECAP_PATH = resolveExtension('canvas-recap');
-export const CANVAS_GOAL_CAPTURE_PATH = resolveExtension('canvas-goal-capture');
-export const CANVAS_PASSIVE_CONTEXT_PATH = resolveExtension('canvas-passive-context');
-export const CANVAS_REVIEW_BOUNDARY_PATH = resolveExtension('canvas-review-boundary');
-export const CANVAS_CONTEXT_INTRO_PATH = resolveExtension('canvas-context-intro');
-export const CANVAS_TOOL_GUIDE_PATH = resolveExtension('canvas-tool-guide');
-export const CANVAS_DOC_SUBSTRATE_PATH = resolveExtension('canvas-doc-substrate');
-export const CANVAS_STRUCTURED_OUTPUT_PATH = resolveExtension('canvas-structured-output');
-export const CANVAS_BASH_VALVE_PATH = resolveExtension('canvas-bash-valve');
-export const CANVAS_PREVIEW_RESULT_PATH = resolveExtension('canvas-preview-result');
-export const CANVAS_PROMPT_SCRUB_PATH = resolveExtension('canvas-prompt-scrub');
-export const CANVAS_STAMP_PATH = resolveExtension('canvas-stamp');
-/** The canvas extensions every node loads, in order. The inbox watcher commits
- *  its cursor at agent_settled before the stophook checks it for idle release.
- *  The review boundary must run before the stophook commits companion session
- *  coordinates, and before the context intro appends fork bearings.
- *
- *  Every entry here loads ahead of any installed pi package, which is why the
- *  prompt scrub belongs in this list rather than in crouter's pi package: the
- *  Claude subscription adapter is a package, and it must not see pi's docs
- *  block still in the prompt (see canvas-prompt-scrub.ts). */
-export const CANVAS_EXTENSIONS = [
-    CANVAS_INBOX_WATCHER_PATH,
-    CANVAS_REVIEW_BOUNDARY_PATH,
-    CANVAS_STOPHOOK_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,
-    CANVAS_PREVIEW_RESULT_PATH,
-    CANVAS_PROMPT_SCRUB_PATH,
-    CANVAS_STAMP_PATH,
-];
-/** Preserve the invariant: mandatory extensions are always present exactly once.
- *
- *  - canonical mandatory list always prepended
- *  - duplicates removed
- *  - genuine custom extras appended in their persisted order
- */
-export function mergeCanvasExtensions(persisted) {
-    const baseline = CANVAS_EXTENSIONS;
-    const mandatory = new Set(baseline);
-    const extras = [];
-    const seen = new Set();
-    const paths = Array.isArray(persisted) && persisted.every((path) => typeof path === 'string')
-        ? customExtensionPaths(persisted)
-        : [];
-    for (const path of paths) {
-        if (mandatory.has(path) || seen.has(path))
-            continue;
-        seen.add(path);
-        extras.push(path);
-    }
-    return [...baseline, ...extras];
-}
-export function assertMandatoryCanvasExtensions(extensions) {
-    const required = new Set(CANVAS_EXTENSIONS);
-    const seen = new Map();
-    const canvasBasenames = new Set();
-    for (const ext of extensions) {
-        if (isShippedCanvasExtension(ext)) {
-            const filename = basename(ext.replaceAll('\\', '/'));
-            const name = filename.slice(0, filename.length - extname(filename).length);
-            if (canvasBasenames.has(name)) {
-                throw new Error(`duplicate mandatory canvas extension basename ${name}`);
-            }
-            canvasBasenames.add(name);
-        }
-        if (!required.has(ext))
-            continue;
-        seen.set(ext, (seen.get(ext) ?? 0) + 1);
-    }
-    for (const ext of CANVAS_EXTENSIONS) {
-        if (seen.get(ext) !== 1) {
-            throw new Error(`missing mandatory canvas extension ${ext} (found ${seen.get(ext) ?? 0} times)`);
-        }
-    }
-}
+var _=Object.defineProperty;var A=(e,s)=>_(e,"name",{value:s,configurable:!0});import{existsSync as x}from"node:fs";import{basename as T,dirname as S,extname as v,join as p}from"node:path";import{fileURLToPath as C}from"node:url";import{customExtensionPaths as m,isShippedCanvasExtension as P}from"../canvas/extensions.js";function t(e){const s=S(C(import.meta.url)),a=[p(s,"..","..","pi-extensions",`${e}.js`),p(s,"..","..","pi-extensions",`${e}.ts`)];return a.find(r=>x(r))??a[0]}A(t,"resolveExtension");const E=t("canvas-stophook"),f=t("canvas-inbox-watcher"),u=t("canvas-recap"),N=t("canvas-goal-capture"),V=t("canvas-passive-context"),d=t("canvas-review-boundary"),h=t("canvas-context-intro"),H=t("canvas-tool-guide"),l=t("canvas-doc-substrate"),O=t("canvas-structured-output"),R=t("canvas-bash-valve"),w=t("canvas-preview-result"),U=t("canvas-prompt-scrub"),g=t("canvas-stamp"),i=[f,d,E,u,N,V,h,H,l,O,R,w,U,g];function $(e){const s=i,a=new Set(s),r=[],n=new Set,c=Array.isArray(e)&&e.every(o=>typeof o=="string")?m(e):[];for(const o of c)a.has(o)||n.has(o)||(n.add(o),r.push(o));return[...s,...r]}A($,"mergeCanvasExtensions");function D(e){const s=new Set(i),a=new Map,r=new Set;for(const n of e){if(P(n)){const c=T(n.replaceAll("\\","/")),o=c.slice(0,c.length-v(c).length);if(r.has(o))throw new Error(`duplicate mandatory canvas extension basename ${o}`);r.add(o)}s.has(n)&&a.set(n,(a.get(n)??0)+1)}for(const n of i)if(a.get(n)!==1)throw new Error(`missing mandatory canvas extension ${n} (found ${a.get(n)??0} times)`)}A(D,"assertMandatoryCanvasExtensions");export{R as CANVAS_BASH_VALVE_PATH,h as CANVAS_CONTEXT_INTRO_PATH,l as CANVAS_DOC_SUBSTRATE_PATH,i as CANVAS_EXTENSIONS,N as CANVAS_GOAL_CAPTURE_PATH,f as CANVAS_INBOX_WATCHER_PATH,V as CANVAS_PASSIVE_CONTEXT_PATH,w as CANVAS_PREVIEW_RESULT_PATH,U as CANVAS_PROMPT_SCRUB_PATH,u as CANVAS_RECAP_PATH,d as CANVAS_REVIEW_BOUNDARY_PATH,g as CANVAS_STAMP_PATH,E as CANVAS_STOPHOOK_PATH,O as CANVAS_STRUCTURED_OUTPUT_PATH,H as CANVAS_TOOL_GUIDE_PATH,D as assertMandatoryCanvasExtensions,$ as mergeCanvasExtensions};

package/dist/core/runtime/chat-inventory-rows.js

@@ -1,105 +1 @@
-import { isDeterministicCommandExpansion } from './command-expansion.js';
-const MEMORY_KINDS = new Set(['knowledge', 'preference']);
-const MEMORY_SCOPES = new Set(['node', 'project', 'profile', 'user', 'builtin']);
-function nonEmptyString(value) {
-    return typeof value === 'string' && value !== '';
-}
-/** Keep the command rows a Gateway can use. Malformed registrations are
- * discarded individually so one producer cannot take down the inventory. */
-export function gatewayCommandRows(rows) {
-    if (!Array.isArray(rows))
-        return [];
-    const out = [];
-    for (const row of rows) {
-        if (typeof row !== 'object' || row === null)
-            continue;
-        const record = row;
-        if (record['gatewayCapable'] !== true)
-            continue;
-        const source = record['source'];
-        if (source !== 'command' && source !== 'template')
-            continue;
-        if (!nonEmptyString(record['name']) || typeof record['description'] !== 'string')
-            continue;
-        const expansion = record['expansion'];
-        const template = record['template'];
-        const argumentHint = record['argumentHint'];
-        out.push({
-            name: record['name'],
-            description: record['description'],
-            source,
-            ...(nonEmptyString(argumentHint) ? { argument_hint: argumentHint } : {}),
-            ...(isDeterministicCommandExpansion(expansion) ? { expansion } : {}),
-            ...(typeof template === 'string' ? { template } : {}),
-        });
-    }
-    return out;
-}
-export function chatInventoryCommandRows(rows) {
-    if (!Array.isArray(rows))
-        return [];
-    return rows.filter((row) => {
-        if (typeof row !== 'object' || row === null)
-            return false;
-        const record = row;
-        if (!nonEmptyString(record['name']) || typeof record['description'] !== 'string')
-            return false;
-        if (record['source'] !== 'command' && record['source'] !== 'template')
-            return false;
-        if (record['argument_hint'] !== undefined && !nonEmptyString(record['argument_hint']))
-            return false;
-        if (record['template'] !== undefined && typeof record['template'] !== 'string')
-            return false;
-        return record['expansion'] === undefined || isDeterministicCommandExpansion(record['expansion']);
-    });
-}
-export function gatewayCommandRowsFromDetail(detail) {
-    if (detail === undefined)
-        return [];
-    try {
-        return gatewayCommandRows(JSON.parse(detail));
-    }
-    catch {
-        return [];
-    }
-}
-export function chatInventoryMemoryRows(rows) {
-    if (!Array.isArray(rows))
-        return [];
-    return rows.filter((row) => {
-        if (typeof row !== 'object' || row === null)
-            return false;
-        const record = row;
-        return nonEmptyString(record['name'])
-            && typeof record['shortForm'] === 'string'
-            && typeof record['kind'] === 'string'
-            && MEMORY_KINDS.has(record['kind'])
-            && typeof record['scope'] === 'string'
-            && MEMORY_SCOPES.has(record['scope']);
-    });
-}
-export function gatewayMemoryRows(refs) {
-    if (!Array.isArray(refs))
-        return [];
-    const out = [];
-    for (const row of refs) {
-        if (typeof row !== 'object' || row === null)
-            continue;
-        const record = row;
-        if (record['gatewayVisible'] !== true)
-            continue;
-        if (!nonEmptyString(record['name']) || typeof record['shortForm'] !== 'string')
-            continue;
-        if (typeof record['kind'] !== 'string' || !MEMORY_KINDS.has(record['kind']))
-            continue;
-        if (typeof record['scope'] !== 'string' || !MEMORY_SCOPES.has(record['scope']))
-            continue;
-        out.push({
-            name: record['name'],
-            kind: record['kind'],
-            scope: record['scope'],
-            shortForm: record['shortForm'],
-        });
-    }
-    return out;
-}
+var y=Object.defineProperty;var o=(t,r)=>y(t,"name",{value:r,configurable:!0});import{isDeterministicCommandExpansion as u}from"./command-expansion.js";const p=new Set(["knowledge","preference"]),m=new Set(["node","project","profile","user","builtin"]);function i(t){return typeof t=="string"&&t!==""}o(i,"nonEmptyString");function d(t){if(!Array.isArray(t))return[];const r=[];for(const n of t){if(typeof n!="object"||n===null)continue;const e=n;if(e.gatewayCapable!==!0)continue;const s=e.source;if(s!=="command"&&s!=="template"||!i(e.name)||typeof e.description!="string")continue;const a=e.expansion,c=e.template,f=e.argumentHint;r.push({name:e.name,description:e.description,source:s,...i(f)?{argument_hint:f}:{},...u(a)?{expansion:a}:{},...typeof c=="string"?{template:c}:{}})}return r}o(d,"gatewayCommandRows");function h(t){return Array.isArray(t)?t.filter(r=>{if(typeof r!="object"||r===null)return!1;const n=r;return!i(n.name)||typeof n.description!="string"||n.source!=="command"&&n.source!=="template"||n.argument_hint!==void 0&&!i(n.argument_hint)||n.template!==void 0&&typeof n.template!="string"?!1:n.expansion===void 0||u(n.expansion)}):[]}o(h,"chatInventoryCommandRows");function x(t){if(t===void 0)return[];try{return d(JSON.parse(t))}catch{return[]}}o(x,"gatewayCommandRowsFromDetail");function w(t){return Array.isArray(t)?t.filter(r=>{if(typeof r!="object"||r===null)return!1;const n=r;return i(n.name)&&typeof n.shortForm=="string"&&typeof n.kind=="string"&&p.has(n.kind)&&typeof n.scope=="string"&&m.has(n.scope)}):[]}o(w,"chatInventoryMemoryRows");function A(t){if(!Array.isArray(t))return[];const r=[];for(const n of t){if(typeof n!="object"||n===null)continue;const e=n;e.gatewayVisible===!0&&(!i(e.name)||typeof e.shortForm!="string"||typeof e.kind!="string"||!p.has(e.kind)||typeof e.scope!="string"||!m.has(e.scope)||r.push({name:e.name,kind:e.kind,scope:e.scope,shortForm:e.shortForm}))}return r}o(A,"gatewayMemoryRows");export{h as chatInventoryCommandRows,w as chatInventoryMemoryRows,d as gatewayCommandRows,x as gatewayCommandRowsFromDetail,A as gatewayMemoryRows};

package/dist/core/runtime/close.js

@@ -1,265 +1 @@
-// close.ts — the "close this node + its subtree" action behind `crtr node lifecycle close`.
-//
-// Closing a node tears down the focused node and every descendant it
-// EXCLUSIVELY owns, walking DOWN the subscribes_to spine (subscriptionsOf = a
-// node's reports/children). A node that never produced substantive assistant
-// output is reaped and cannot be revived. Streaming nodes and nodes with an open
-// managed worktree are retained; other closed nodes keep their pi session,
-// canvas edges, and on-disk state for a later revive (`crtr node lifecycle
-// revive` / focus → `pi --session <id>`).
-//
-// Per node, in this order — the order matters twice:
-//
-//   1. Mark `canceled` + clear intent. Done BEFORE the window dies: the daemon
-//      only ever revives an active|idle node, so flipping to canceled first
-//      closes the race where the supervisor sees a window-gone live node and
-//      either revives it or marks it dead (overwriting our canceled).
-//   2. Tear down the broker ENGINE (the `shutdown` frame → SIGTERM fallback so
-//      the broker process exits and releases the sole .jsonl writer; this also
-//      ends the inbox watcher) AND proactively close the node's on-screen viewer
-//      pane + registry row. The viewer teardown is explicit because attach
-//      auto-reconnects: left to the socket drop alone, the viewer would sit in a
-//      misleading "reconnecting…" state for ~30s on a deliberate close.
-//   3. Append the cancellation notice to its inbox AFTER the watcher is gone.
-//      The watcher advances its cursor when it READS an entry, so appending
-//      while it is still live would let it consume + skip the notice (cursor
-//      moves past it, never delivered). Killed first, the cursor stays put;
-//      on the node's next resume a fresh watcher seeds from that frozen cursor,
-//      finds the notice, and injects it — the agent learns its children died.
-//
-// The cascade is GUARDED: a descendant is closed only when EVERY node that
-// subscribes to it (its managers, subscribersOf — active OR passive) is itself
-// inside the closing set. A node still subscribed to by a manager outside the
-// subtree is left running — "only kill the children if they are only subscribed
-// to by the agent being closed", generalized to any depth via a fixpoint.
-import { getNode, subscriptionsOf, subscribersOf, } from '../canvas/index.js';
-import { transition } from './lifecycle.js';
-import { requestBrokerTeardown } from './host.js';
-import { tearDownNode, reapIfEmpty } from './placement.js';
-import { crtrHome, contextDir, jobDir, nodeDir, reportsDir } from '../canvas/paths.js';
-import { discoverLifecycleHookRegistry } from '../command-hooks/discovery.js';
-import { invokeLifecycleHooks } from '../command-hooks/transport/exec-lifecycle.js';
-import { emitEvent } from '../events/emit.js';
-import { enqueueNodeMail } from '../feed/messages.js';
-/** Fan a lifecycle or birth notice to every given subscriber. A passive
- * subscription is a non-waking delivery; active subscriptions wake. */
-export function fanDoctrineWake(fromId, subscribers, label, data, tier = 'normal') {
-    for (const sub of subscribers) {
-        try {
-            enqueueNodeMail(sub.node_id, {
-                senderNodeId: fromId,
-                kind: 'message',
-                label,
-                bodyJson: data,
-                urgency: tier,
-                wake: sub.active ? 1 : 0,
-            });
-        }
-        catch {
-            /* one unavailable subscriber never blocks the rest */
-        }
-    }
-}
-/** The set of nodes to close: the root plus every descendant reachable down the
- *  subscriptions spine, all of whose managers are themselves in the set. Grown
- *  to a fixpoint — a node added this pass can qualify its own children next
- *  pass. Cycle-safe via the membership skip. */
-function closingSet(root) {
-    const closing = new Set([root]);
-    let changed = true;
-    while (changed) {
-        changed = false;
-        for (const parent of [...closing]) {
-            for (const sub of subscriptionsOf(parent)) {
-                const child = sub.node_id;
-                if (closing.has(child))
-                    continue;
-                // Close the child only if NOBODY outside the closing set subscribes to
-                // it. (subscriptionsOf always yields child→parent, so `parent` is one
-                // of child's managers and is in `closing` — the check is never vacuous.)
-                if (subscribersOf(child).every((m) => closing.has(m.node_id))) {
-                    closing.add(child);
-                    changed = true;
-                }
-            }
-        }
-    }
-    return closing;
-}
-/** BFS the closing set from root, then reverse: leaves die first, the focused
- *  root dies last ("cascades up"). The root being killed last also keeps the
- *  user's foreground window — the one they invoked the close from — open until
- *  every background descendant is gone. */
-function killOrder(root, closing) {
-    const order = [];
-    const seen = new Set([root]);
-    const queue = [root];
-    while (queue.length > 0) {
-        const id = queue.shift();
-        order.push(id);
-        for (const sub of subscriptionsOf(id)) {
-            if (closing.has(sub.node_id) && !seen.has(sub.node_id)) {
-                seen.add(sub.node_id);
-                queue.push(sub.node_id);
-            }
-        }
-    }
-    // Any closing node a cycle kept BFS from reaching still gets torn down.
-    for (const id of closing)
-        if (!seen.has(id))
-            order.push(id);
-    return order.reverse();
-}
-/** The inbox notice a closed node reads on its next resume. */
-function cancellationLabel(isRoot, deadChildren) {
-    const who = isRoot
-        ? 'You were CLOSED by the user from the canvas'
-        : 'You were CANCELED — an ancestor of yours was closed from the canvas';
-    if (deadChildren.length === 0) {
-        return `${who}. Your pi session is preserved; this resume reopened it.`;
-    }
-    const names = deadChildren.slice(0, 4).map((c) => {
-        const n = getNode(c);
-        return n !== null ? `${n.name} (${c})` : c;
-    });
-    const more = deadChildren.length > names.length ? ` +${deadChildren.length - names.length} more` : '';
-    return (`${who}. ${deadChildren.length} child node(s) you subscribe to were canceled with you and are no ` +
-        `longer running: ${names.join(', ')}${more}. Resuming will NOT restore them — re-spawn if you ` +
-        `still need that work.`);
-}
-/** Close `rootId` and its exclusive subtree. Best-effort throughout: a tmux/db
- *  failure on one node never aborts the cascade. Throws only on an unknown root
- *  so the command can surface a clean not-found error.
- *
- *  `rootEvent` decides the ROOT's terminal status (descendants are always
- *  `cancel`led — they did not finish their own work, they were torn down with the
- *  parent):
- *    'cancel'   (default) — the node was abandoned/torn down  → canceled (⊜).
- *    'finish'             — the user is marking it COMPLETE   → done (✓). Used by
- *      the canvas browser's `x` (close-out) action. A root already in a terminal
- *      status keeps it (finish is only legal from a live status). */
-export function closeNode(rootId, opts = {}) {
-    if (getNode(rootId) === null)
-        throw new Error(`closeNode: unknown node ${rootId}`);
-    const rootEvent = opts.rootEvent ?? 'cancel';
-    const closing = closingSet(rootId);
-    const order = killOrder(rootId, closing);
-    // Descendants reachable from the subtree but kept alive (shared managers).
-    const spared = [];
-    for (const id of closing) {
-        for (const sub of subscriptionsOf(id)) {
-            if (!closing.has(sub.node_id) && !spared.includes(sub.node_id)) {
-                spared.push(sub.node_id);
-            }
-        }
-    }
-    const closed = [];
-    for (const id of order) {
-        try {
-            const m = getNode(id);
-            if (m === null)
-                continue;
-            // This node's reports that are dying with it (for the resume notice).
-            const deadChildren = subscriptionsOf(id)
-                .map((s) => s.node_id)
-                .filter((c) => closing.has(c));
-            // Surviving managers captured BEFORE any teardown — a reap (below) deletes
-            //    this node's edges, so the step-4 fan-out must read them up front.
-            const survivors = subscribersOf(id).filter((s) => !closing.has(s.node_id));
-            // Capture the target-scoped hook plan and payload before an empty node's
-            // reap can remove its row and directories. The executable still runs from
-            // its plugin root; the payload paths can therefore name a reaped directory.
-            let afterTeardown;
-            try {
-                const hooks = discoverLifecycleHookRegistry(m.cwd, m.profile_id).plans.get('node:close') ?? [];
-                if (hooks.length > 0) {
-                    const invocation = {
-                        node: {
-                            id,
-                            name: m.name,
-                            kind: m.kind,
-                            mode: m.mode,
-                            lifecycle: m.lifecycle,
-                            cwd: m.cwd,
-                            nodeDir: nodeDir(id),
-                            contextDir: contextDir(id),
-                            jobDir: jobDir(id),
-                            reportsDir: reportsDir(id),
-                        },
-                        runtime: { isBirth: false, canvasHome: crtrHome(), profile: m.profile_id ?? null },
-                    };
-                    afterTeardown = () => invokeLifecycleHooks(hooks, invocation);
-                }
-            }
-            catch (error) {
-                emitEvent({ level: 'error', event: 'node.close_hook.discovery_failed', node_id: id, error });
-            }
-            // Capture the process snapshot while the row exists, then execute after
-            // the response settles. A failed teardown skips the lifecycle hook rather
-            // than claiming cleanup was safe.
-            const teardown = requestBrokerTeardown(id, id === rootId ? { excludePid: opts.callerPid } : {}, afterTeardown);
-            try {
-                opts.registerDetached?.(teardown.then(() => { }));
-            }
-            catch (error) {
-                emitEvent({ level: 'error', event: 'node.close_hook.detached_registration_failed', node_id: id, error });
-            }
-            // 0) A node with no substantive assistant output is a useless shell — don't
-            //    park it as a canceled husk; reap it outright (engine + viewer + row +
-            //    dir). Its teardown was queued above from the preserved snapshot; when
-            //    reaping fires we skip the cancel transition + resume notice (the node
-            //    is gone) but still fan the "child gone" wake out to survivors below.
-            if (!reapIfEmpty(id, undefined, false)) {
-                // 1) Terminal status set BEFORE the window dies (daemon race). The root may
-                //    finish to `done` (a deliberate "mark complete" close-out); every
-                //    descendant, and the root by default, `cancel`s. finish is legal only
-                //    from a live status — an already-terminal root keeps its status.
-                //    A node that ALREADY pushed its final report (final_report set) is a
-                //    special case: it FINISHED its own work, so its terminal state is
-                //    `done`, not `canceled`. `cancel` is guarded `final_report IS NULL`
-                //    (lifecycle.ts) and would silently no-op on such a node, leaving it
-                //    active for the daemon to keep reviving forever (the stuck-node
-                //    incident). Finish it to `done` instead so close actually tears it
-                //    down; finish is legal only from a live status, so an already-terminal
-                //    finalized node keeps its status.
-                const finalized = m.final_report !== null && m.final_report !== undefined;
-                if ((id === rootId && rootEvent === 'finish') || finalized) {
-                    if (m.status === 'active' || m.status === 'idle')
-                        transition(id, 'finish');
-                }
-                else {
-                    transition(id, 'cancel', { reason: 'closed' });
-                }
-                // 2) The daemon-owned teardown was queued above after capturing this
-                //    node's process tree. The root caller's shell was excluded from its
-                //    own broker tree before the response can settle.
-                tearDownNode(id);
-                // 3) Leave the resume notice AFTER the watcher is gone, so it survives.
-                enqueueNodeMail(id, {
-                    kind: 'message',
-                    label: cancellationLabel(id === rootId, deadChildren),
-                    bodyJson: { reason: 'user-close', cascade_root: rootId, canceled_children: deadChildren },
-                    urgency: 'normal',
-                    wake: 1,
-                });
-            }
-            // 4) Wake any SURVIVING manager subscribed to this node — the doctrine wake.
-            //    A node going dormant trusts the runtime to wake it on a child's
-            //    terminal outcome; D-1 found that `node lifecycle close` notified ONLY the closed
-            //    node itself, never its subscribers, so a parent that delegated then
-            //    just stopped hangs forever when its child is closed out from under it.
-            //    Only the close ROOT can have a surviving subscriber (closingSet adds a
-            //    non-root node only when EVERY subscriber is itself closing), so this
-            //    reaches the still-living manager(s) of a deliberately-closed child and
-            //    never fires inside a self-contained cascade. Active → inbox (wakes a
-            //    dormant manager via its live watcher / the daemon's dormant-revive
-            //    second pass); passive → passive accumulator (delivered, not woken).
-            fanDoctrineWake(id, survivors, `Child closed — ${m.name} (${id}) was closed from the canvas and is no longer running.`, { reason: 'child-closed', child: id });
-            closed.push(id);
-        }
-        catch (error) {
-            emitEvent({ level: 'error', event: 'node.close.failed', node_id: id, error });
-        }
-    }
-    return { root: rootId, closed, spared };
-}
+var b=Object.defineProperty;var a=(n,o)=>b(n,"name",{value:o,configurable:!0});import{getNode as u,subscriptionsOf as f,subscribersOf as w}from"../canvas/index.js";import{transition as _}from"./lifecycle.js";import{requestBrokerTeardown as D}from"./host.js";import{tearDownNode as $,reapIfEmpty as E}from"./placement.js";import{crtrHome as N,contextDir as x,jobDir as L,nodeDir as O,reportsDir as H}from"../canvas/paths.js";import{discoverLifecycleHookRegistry as S}from"../command-hooks/discovery.js";import{invokeLifecycleHooks as j}from"../command-hooks/transport/exec-lifecycle.js";import{emitEvent as h}from"../events/emit.js";import{enqueueNodeMail as g}from"../feed/messages.js";function q(n,o,t,s,l="normal"){for(const r of o)try{g(r.node_id,{senderNodeId:n,kind:"message",label:t,bodyJson:s,urgency:l,wake:r.active?1:0})}catch{}}a(q,"fanDoctrineWake");function T(n){const o=new Set([n]);let t=!0;for(;t;){t=!1;for(const s of[...o])for(const l of f(s)){const r=l.node_id;o.has(r)||w(r).every(d=>o.has(d.node_id))&&(o.add(r),t=!0)}}return o}a(T,"closingSet");function Y(n,o){const t=[],s=new Set([n]),l=[n];for(;l.length>0;){const r=l.shift();t.push(r);for(const d of f(r))o.has(d.node_id)&&!s.has(d.node_id)&&(s.add(d.node_id),l.push(d.node_id))}for(const r of o)s.has(r)||t.push(r);return t.reverse()}a(Y,"killOrder");function B(n,o){const t=n?"You were CLOSED by the user from the canvas":"You were CANCELED \u2014 an ancestor of yours was closed from the canvas";if(o.length===0)return`${t}. Your pi session is preserved; this resume reopened it.`;const s=o.slice(0,4).map(r=>{const d=u(r);return d!==null?`${d.name} (${r})`:r}),l=o.length>s.length?` +${o.length-s.length} more`:"";return`${t}. ${o.length} child node(s) you subscribe to were canceled with you and are no longer running: ${s.join(", ")}${l}. Resuming will NOT restore them \u2014 re-spawn if you still need that work.`}a(B,"cancellationLabel");function K(n,o={}){if(u(n)===null)throw new Error(`closeNode: unknown node ${n}`);const t=o.rootEvent??"cancel",s=T(n),l=Y(n,s),r=[];for(const e of s)for(const i of f(e))!s.has(i.node_id)&&!r.includes(i.node_id)&&r.push(i.node_id);const d=[];for(const e of l)try{const i=u(e);if(i===null)continue;const m=f(e).map(c=>c.node_id).filter(c=>s.has(c)),v=w(e).filter(c=>!s.has(c.node_id));let p;try{const c=S(i.cwd,i.profile_id).plans.get("node:close")??[];if(c.length>0){const k={node:{id:e,name:i.name,kind:i.kind,mode:i.mode,lifecycle:i.lifecycle,cwd:i.cwd,nodeDir:O(e),contextDir:x(e),jobDir:L(e),reportsDir:H(e)},runtime:{isBirth:!1,canvasHome:N(),profile:i.profile_id??null}};p=a(()=>j(c,k),"afterTeardown")}}catch(c){h({level:"error",event:"node.close_hook.discovery_failed",node_id:e,error:c})}const y=D(e,e===n?{excludePid:o.callerPid}:{},p);try{o.registerDetached?.(y.then(()=>{}))}catch(c){h({level:"error",event:"node.close_hook.detached_registration_failed",node_id:e,error:c})}if(!E(e,void 0,!1)){const c=i.final_report!==null&&i.final_report!==void 0;e===n&&t==="finish"||c?(i.status==="active"||i.status==="idle")&&_(e,"finish"):_(e,"cancel",{reason:"closed"}),$(e),g(e,{kind:"message",label:B(e===n,m),bodyJson:{reason:"user-close",cascade_root:n,canceled_children:m},urgency:"normal",wake:1})}q(e,v,`Child closed \u2014 ${i.name} (${e}) was closed from the canvas and is no longer running.`,{reason:"child-closed",child:e}),d.push(e)}catch(i){h({level:"error",event:"node.close.failed",node_id:e,error:i})}return{root:n,closed:d,spared:r}}a(K,"closeNode");export{K as closeNode,q as fanDoctrineWake};

package/dist/core/runtime/command-expansion.js

@@ -1,104 +1,9 @@
-/** Accept only the inert, JSON-safe discriminated shape that may cross the
- * broker boundary. Extension registrations are arbitrary runtime objects, so
- * never serialize getters, prototypes, or extra metadata into a viewer. */
-export function isDeterministicCommandExpansion(value) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value))
-        return false;
-    try {
-        const prototype = Object.getPrototypeOf(value);
-        if (prototype !== Object.prototype && prototype !== null)
-            return false;
-        if (Object.getOwnPropertySymbols(value).length !== 0)
-            return false;
-        const keys = Object.getOwnPropertyNames(value).sort();
-        if (keys.length !== 3 || keys[0] !== 'body' || keys[1] !== 'commandName' || keys[2] !== 'kind')
-            return false;
-        const descriptors = Object.getOwnPropertyDescriptors(value);
-        if (Object.values(descriptors).some((descriptor) => !('value' in descriptor)))
-            return false;
-        const record = value;
-        if (record.kind !== 'memory-slash' || typeof record.commandName !== 'string' || typeof record.body !== 'string')
-            return false;
-        JSON.stringify(value);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** Remove HTML comments from Markdown before it becomes model context. Markdown
- * command files use comments for author metadata; fenced and inline code remain
- * literal so examples of HTML are never altered. */
-export function stripMarkdownComments(markdown) {
-    let out = '';
-    let i = 0;
-    let lineStart = true;
-    let fenced;
-    let inlineTicks;
-    while (i < markdown.length) {
-        if (lineStart && inlineTicks === undefined) {
-            const fence = markdown.slice(i).match(/^(?: {0,3})(`{3,}|~{3,})/);
-            if (fence !== null) {
-                const marker = fence[1][0];
-                const length = fence[1].length;
-                if (fenced === undefined)
-                    fenced = { marker, length };
-                else if (fenced.marker === marker && length >= fenced.length)
-                    fenced = undefined;
-            }
-        }
-        if (fenced === undefined && inlineTicks === undefined && markdown.startsWith('<!--', i)) {
-            const end = markdown.indexOf('-->', i + 4);
-            const afterComment = end === -1 ? markdown.length : end + 3;
-            const lineEnd = markdown.indexOf('\n', afterComment);
-            const lineStartAt = markdown.lastIndexOf('\n', i - 1) + 1;
-            const before = markdown.slice(lineStartAt, i);
-            const after = markdown.slice(afterComment, lineEnd === -1 ? markdown.length : lineEnd);
-            if (before.trim() === '' && after.trim() === '') {
-                // An author-only comment on its own line should leave no blank line in
-                // the prompt (and no leading whitespace already copied before it).
-                if (before.length > 0)
-                    out = out.slice(0, -before.length);
-                i = lineEnd === -1 ? markdown.length : lineEnd + 1;
-                lineStart = true;
-                continue;
-            }
-            const comment = markdown.slice(i, afterComment);
-            lineStart = comment.endsWith('\n');
-            i += comment.length;
-            continue;
-        }
-        if (fenced === undefined && markdown[i] === '`') {
-            let end = i;
-            while (markdown[end] === '`')
-                end++;
-            const length = end - i;
-            if (inlineTicks === undefined)
-                inlineTicks = length;
-            else if (inlineTicks === length)
-                inlineTicks = undefined;
-            out += markdown.slice(i, end);
-            lineStart = false;
-            i = end;
-            continue;
-        }
-        const char = markdown[i];
-        out += char;
-        lineStart = char === '\n';
-        i++;
-    }
-    return out;
-}
-/** The single expansion path used by deterministic command handlers and by
- * pre-submit disclosure. `rawArgs` is the unparsed text after the slash name. */
-export function expandDeterministicCommand(expansion, rawArgs) {
-    const args = rawArgs.trim();
-    const body = stripMarkdownComments(expansion.body);
-    if (body.includes('$ARGUMENTS')) {
-        return body.split('$ARGUMENTS').join(args);
-    }
-    const header = args === ''
-        ? `You invoked /${expansion.commandName} with no arguments.`
-        : `You invoked /${expansion.commandName} with: ${args}`;
-    return `${header}\n\nFollow the instructions below exactly as written — every part, including the presence or absence of arguments above, is a load-bearing requirement.\n\n${body}`;
-}
+var m=Object.defineProperty;var f=(e,n)=>m(e,"name",{value:n,configurable:!0});function b(e){if(typeof e!="object"||e===null||Array.isArray(e))return!1;try{const n=Object.getPrototypeOf(e);if(n!==Object.prototype&&n!==null||Object.getOwnPropertySymbols(e).length!==0)return!1;const t=Object.getOwnPropertyNames(e).sort();if(t.length!==3||t[0]!=="body"||t[1]!=="commandName"||t[2]!=="kind")return!1;const r=Object.getOwnPropertyDescriptors(e);if(Object.values(r).some(c=>!("value"in c)))return!1;const i=e;return i.kind!=="memory-slash"||typeof i.commandName!="string"||typeof i.body!="string"?!1:(JSON.stringify(e),!0)}catch{return!1}}f(b,"isDeterministicCommandExpansion");function y(e){let n="",t=0,r=!0,i,c;for(;t<e.length;){if(r&&c===void 0){const s=e.slice(t).match(/^(?: {0,3})(`{3,}|~{3,})/);if(s!==null){const o=s[1][0],l=s[1].length;i===void 0?i={marker:o,length:l}:i.marker===o&&l>=i.length&&(i=void 0)}}if(i===void 0&&c===void 0&&e.startsWith("<!--",t)){const s=e.indexOf("-->",t+4),o=s===-1?e.length:s+3,l=e.indexOf(`
+`,o),a=e.lastIndexOf(`
+`,t-1)+1,u=e.slice(a,t),g=e.slice(o,l===-1?e.length:l);if(u.trim()===""&&g.trim()===""){u.length>0&&(n=n.slice(0,-u.length)),t=l===-1?e.length:l+1,r=!0;continue}const h=e.slice(t,o);r=h.endsWith(`
+`),t+=h.length;continue}if(i===void 0&&e[t]==="`"){let s=t;for(;e[s]==="`";)s++;const o=s-t;c===void 0?c=o:c===o&&(c=void 0),n+=e.slice(t,s),r=!1,t=s;continue}const d=e[t];n+=d,r=d===`
+`,t++}return n}f(y,"stripMarkdownComments");function O(e,n){const t=n.trim(),r=y(e.body);return r.includes("$ARGUMENTS")?r.split("$ARGUMENTS").join(t):`${t===""?`You invoked /${e.commandName} with no arguments.`:`You invoked /${e.commandName} with: ${t}`}
+
+Follow the instructions below exactly as written \u2014 every part, including the presence or absence of arguments above, is a load-bearing requirement.
+
+${r}`}f(O,"expandDeterministicCommand");export{O as expandDeterministicCommand,b as isDeterministicCommandExpansion,y as stripMarkdownComments};