@north-light/crouter 0.3.263 → 0.3.270

package/dist/core/command-hooks/schema.js

@@ -1,4 +1,5 @@
 import { isRecord } from '../../shared/predicates.js';
+import { LIFECYCLE_EVENTS, isLifecycleEvent } from './lifecycle-catalog.js';
 function typeName(value) {
     if (value === null)
         return 'null';
@@ -6,6 +7,98 @@ function typeName(value) {
         return 'array';
     return typeof value;
 }
+function validateCommandDeclaration(value, index, issue) {
+    const path = `hooks[${index}]`;
+    if (!isRecord(value)) {
+        issue('hook_manifest_invalid', 'hook must be an object', typeName(value), '{ target, phase, op, description, effects }', 'Fix the hook declaration.', path);
+        return undefined;
+    }
+    const keys = Object.keys(value).filter((key) => !['target', 'phase', 'op', 'description', 'effects'].includes(key));
+    if (keys.length > 0) {
+        issue('hook_manifest_invalid', 'unknown hook keys', keys.join(', '), 'only: target, phase, op, description, effects', 'Remove the unknown keys.', path);
+        return undefined;
+    }
+    for (const field of ['target', 'op', 'description']) {
+        if (typeof value[field] !== 'string' || value[field].length === 0) {
+            issue('hook_manifest_invalid', `${field} must be a non-empty string`, typeName(value[field]), 'a non-empty string', `Set ${field}.`, `${path}.${field}`);
+            return undefined;
+        }
+    }
+    if (value['phase'] !== 'before' && value['phase'] !== 'after' && value['phase'] !== 'replace') {
+        issue('hook_manifest_invalid', 'phase must be before|after|replace', String(value['phase']), 'before | after | replace', 'Set phase to a supported hook phase.', `${path}.phase`);
+        return undefined;
+    }
+    if (!isEffects(value['effects'])) {
+        issue('hook_manifest_invalid', 'effects must be a non-empty string array', typeName(value['effects']), 'a non-empty array of non-empty strings', 'Declare every persistent effect.', `${path}.effects`);
+        return undefined;
+    }
+    return {
+        target: value['target'],
+        phase: value['phase'],
+        op: value['op'],
+        description: value['description'],
+        effects: value['effects'],
+    };
+}
+function validateLifecycleDeclaration(value, index, issue) {
+    const path = `lifecycle[${index}]`;
+    if (!isRecord(value)) {
+        issue('hook_manifest_invalid', 'lifecycle hook must be an object', typeName(value), '{ event, phase, op, description, effects }', 'Fix the lifecycle declaration.', path);
+        return undefined;
+    }
+    const keys = Object.keys(value).filter((key) => !['event', 'phase', 'op', 'description', 'effects'].includes(key));
+    if (keys.length > 0) {
+        issue('hook_manifest_invalid', 'unknown lifecycle hook keys', keys.join(', '), 'only: event, phase, op, description, effects', 'Remove the unknown keys.', path);
+        return undefined;
+    }
+    for (const field of ['event', 'op', 'description']) {
+        if (typeof value[field] !== 'string' || value[field].length === 0) {
+            issue('hook_manifest_invalid', `${field} must be a non-empty string`, typeName(value[field]), 'a non-empty string', `Set ${field}.`, `${path}.${field}`);
+            return undefined;
+        }
+    }
+    if (!isLifecycleEvent(value['event'])) {
+        issue('hook_manifest_invalid', 'event must name a supported lifecycle event', String(value['event']), LIFECYCLE_EVENTS.join(' | '), `Set event to one of: ${LIFECYCLE_EVENTS.join(', ')}.`, `${path}.event`);
+        return undefined;
+    }
+    if (value['phase'] !== 'on') {
+        issue('hook_manifest_invalid', 'phase must be on', String(value['phase']), 'on', 'Set phase to on.', `${path}.phase`);
+        return undefined;
+    }
+    if (!isEffects(value['effects'])) {
+        issue('hook_manifest_invalid', 'effects must be a non-empty string array', typeName(value['effects']), 'a non-empty array of non-empty strings', 'Declare every persistent effect.', `${path}.effects`);
+        return undefined;
+    }
+    return {
+        event: value['event'],
+        phase: 'on',
+        op: value['op'],
+        description: value['description'],
+        effects: value['effects'],
+    };
+}
+function isEffects(value) {
+    return Array.isArray(value) && value.length > 0 && value.every((effect) => typeof effect === 'string' && effect.length > 0);
+}
+function validateV1(raw, issue) {
+    const unknown = Object.keys(raw).filter((key) => key !== 'schemaVersion' && key !== 'hooks');
+    if (unknown.length > 0) {
+        issue('hook_manifest_invalid', 'unknown top-level keys', unknown.join(', '), 'only: schemaVersion, hooks', 'Remove the unknown keys.');
+        return { issues: [] };
+    }
+    if (!Array.isArray(raw['hooks']) || raw['hooks'].length === 0) {
+        issue('hook_manifest_invalid', 'hooks must be a non-empty array', typeName(raw['hooks']), 'a non-empty array of hook declarations', 'Declare at least one hook.', 'hooks');
+        return { issues: [] };
+    }
+    const hooks = [];
+    for (let index = 0; index < raw['hooks'].length; index++) {
+        const hook = validateCommandDeclaration(raw['hooks'][index], index, issue);
+        if (hook === undefined)
+            return { issues: [] };
+        hooks.push(hook);
+    }
+    return { manifest: { schemaVersion: 1, hooks }, issues: [] };
+}
 /** Validates the declarative hooks.json payload without filesystem access. */
 export function validateHookManifest(raw) {
     const issues = [];
@@ -16,53 +109,48 @@ export function validateHookManifest(raw) {
         issue('hook_manifest_invalid', 'manifest must be an object', typeName(raw), '{ schemaVersion, hooks }', 'Provide a valid hooks.json manifest.');
         return { issues };
     }
-    const unknown = Object.keys(raw).filter((key) => key !== 'schemaVersion' && key !== 'hooks');
+    if (raw['schemaVersion'] === 1) {
+        const validation = validateV1(raw, issue);
+        return { ...(validation.manifest === undefined ? {} : { manifest: validation.manifest }), issues };
+    }
+    if (raw['schemaVersion'] !== 2) {
+        issue('hook_schema_version', 'schemaVersion must be exactly 1 or 2', String(raw['schemaVersion']), '1 | 2', 'Update the manifest schema version to 1 or 2.', 'schemaVersion');
+        return { issues };
+    }
+    const unknown = Object.keys(raw).filter((key) => key !== 'schemaVersion' && key !== 'hooks' && key !== 'lifecycle');
     if (unknown.length > 0) {
-        issue('hook_manifest_invalid', 'unknown top-level keys', unknown.join(', '), 'only: schemaVersion, hooks', 'Remove the unknown keys.');
+        issue('hook_manifest_invalid', 'unknown top-level keys', unknown.join(', '), 'only: schemaVersion, hooks, lifecycle', 'Remove the unknown keys.');
         return { issues };
     }
-    if (raw['schemaVersion'] !== 1) {
-        issue('hook_schema_version', 'schemaVersion must be exactly 1', String(raw['schemaVersion']), '1', 'Update the manifest schema version to 1.', 'schemaVersion');
+    const rawHooks = raw['hooks'];
+    const rawLifecycle = raw['lifecycle'];
+    if (rawHooks !== undefined && !Array.isArray(rawHooks)) {
+        issue('hook_manifest_invalid', 'hooks must be an array when present', typeName(rawHooks), 'an array of hook declarations', 'Fix hooks.', 'hooks');
         return { issues };
     }
-    if (!Array.isArray(raw['hooks']) || raw['hooks'].length === 0) {
-        issue('hook_manifest_invalid', 'hooks must be a non-empty array', typeName(raw['hooks']), 'a non-empty array of hook declarations', 'Declare at least one hook.', 'hooks');
+    if (rawLifecycle !== undefined && !Array.isArray(rawLifecycle)) {
+        issue('hook_manifest_invalid', 'lifecycle must be an array when present', typeName(rawLifecycle), 'an array of lifecycle hook declarations', 'Fix lifecycle.', 'lifecycle');
         return { issues };
     }
-    const hooks = [];
-    for (let index = 0; index < raw['hooks'].length; index++) {
-        const value = raw['hooks'][index];
-        const path = `hooks[${index}]`;
-        if (!isRecord(value)) {
-            issue('hook_manifest_invalid', 'hook must be an object', typeName(value), '{ target, phase, op, description, effects }', 'Fix the hook declaration.', path);
-            return { issues };
-        }
-        const keys = Object.keys(value).filter((key) => !['target', 'phase', 'op', 'description', 'effects'].includes(key));
-        if (keys.length > 0) {
-            issue('hook_manifest_invalid', 'unknown hook keys', keys.join(', '), 'only: target, phase, op, description, effects', 'Remove the unknown keys.', path);
-            return { issues };
-        }
-        for (const field of ['target', 'op', 'description']) {
-            if (typeof value[field] !== 'string' || value[field].length === 0) {
-                issue('hook_manifest_invalid', `${field} must be a non-empty string`, typeName(value[field]), 'a non-empty string', `Set ${field}.`, `${path}.${field}`);
-                return { issues };
-            }
-        }
-        if (value['phase'] !== 'before' && value['phase'] !== 'after' && value['phase'] !== 'replace') {
-            issue('hook_manifest_invalid', 'phase must be before|after|replace', String(value['phase']), 'before | after | replace', 'Set phase to a supported hook phase.', `${path}.phase`);
+    const hooks = rawHooks ?? [];
+    const lifecycle = rawLifecycle ?? [];
+    if (hooks.length === 0 && lifecycle.length === 0) {
+        issue('hook_manifest_invalid', 'hooks or lifecycle must be a non-empty array', 'both arrays were empty or absent', 'at least one command or lifecycle hook declaration', 'Declare at least one hook.', 'hooks');
+        return { issues };
+    }
+    const declaredHooks = [];
+    for (let index = 0; index < hooks.length; index++) {
+        const hook = validateCommandDeclaration(hooks[index], index, issue);
+        if (hook === undefined)
             return { issues };
-        }
-        if (!Array.isArray(value['effects']) || value['effects'].length === 0 || !value['effects'].every((effect) => typeof effect === 'string' && effect.length > 0)) {
-            issue('hook_manifest_invalid', 'effects must be a non-empty string array', typeName(value['effects']), 'a non-empty array of non-empty strings', 'Declare every persistent effect.', `${path}.effects`);
+        declaredHooks.push(hook);
+    }
+    const declaredLifecycle = [];
+    for (let index = 0; index < lifecycle.length; index++) {
+        const hook = validateLifecycleDeclaration(lifecycle[index], index, issue);
+        if (hook === undefined)
             return { issues };
-        }
-        hooks.push({
-            target: value['target'],
-            phase: value['phase'],
-            op: value['op'],
-            description: value['description'],
-            effects: value['effects'],
-        });
-    }
-    return { manifest: { schemaVersion: 1, hooks }, issues };
+        declaredLifecycle.push(hook);
+    }
+    return { manifest: { schemaVersion: 2, hooks: declaredHooks, lifecycle: declaredLifecycle }, issues };
 }

package/dist/core/command-hooks/transport/exec-lifecycle.d.ts

@@ -0,0 +1,12 @@
+import type { LifecycleHookRequest } from '../../../hook-authoring.js';
+import type { EffectiveLifecycleHook } from '../discovery.js';
+export declare const LIFECYCLE_HOOK_TIMEOUT_MS = 5000;
+export declare const LIFECYCLE_EVENT_BUDGET_MS = 10000;
+export interface LifecycleHookInvocation {
+    node: LifecycleHookRequest['node'];
+    runtime: LifecycleHookRequest['runtime'];
+}
+/** Runs one lifecycle hook. The node launch remains authoritative on every failure. */
+export declare function invokeLifecycleHook(hook: EffectiveLifecycleHook, invocation: LifecycleHookInvocation, timeoutMs: number): Promise<void>;
+/** Executes lifecycle hooks in discovery order, within one bounded start-event budget. */
+export declare function invokeLifecycleHooks(hooks: readonly EffectiveLifecycleHook[], invocation: LifecycleHookInvocation): Promise<void>;

package/dist/core/command-hooks/transport/exec-lifecycle.js

@@ -0,0 +1,152 @@
+import { randomBytes } from 'node:crypto';
+import { spawn } from 'node:child_process';
+import { PROCESS_GROUP_KILL_GRACE_MS, posixProcessGroupSpawnOptions, terminateProcessGroup } from '../../../hook-process.js';
+import { isRecord } from '../../../shared/predicates.js';
+import { diag } from '../../io.js';
+const MAX_STDOUT = 10 * 1024 * 1024;
+export const LIFECYCLE_HOOK_TIMEOUT_MS = 5_000;
+export const LIFECYCLE_EVENT_BUDGET_MS = 10_000;
+/** Runs one lifecycle hook. The node launch remains authoritative on every failure. */
+export async function invokeLifecycleHook(hook, invocation, timeoutMs) {
+    try {
+        const request = {
+            protocolVersion: 1,
+            op: hook.op,
+            event: hook.event,
+            phase: hook.phase,
+            operationId: randomBytes(16).toString('hex'),
+            node: invocation.node,
+            runtime: invocation.runtime,
+            context: { cwd: invocation.node.cwd },
+        };
+        const result = await runLifecycleProcess(hook, JSON.stringify(request), timeoutMs);
+        if (result.signal !== null)
+            throw new Error(`executable was killed by signal ${result.signal}`);
+        const envelope = parseEnvelope(result.stdout);
+        if (envelope.ok) {
+            if (result.status !== 0)
+                diag(`crtr: ${label(hook)} returned ok:true but exited ${result.status} (honoring the envelope)`);
+            return;
+        }
+        diag(`crtr: ${label(hook)} failed: ${envelope.error.code}: ${envelope.error.message}`);
+    }
+    catch (error) {
+        diag(`crtr: ${label(hook)} failed: ${describeError(error)}`);
+    }
+}
+/** Executes lifecycle hooks in discovery order, within one bounded start-event budget. */
+export async function invokeLifecycleHooks(hooks, invocation) {
+    const deadline = Date.now() + LIFECYCLE_EVENT_BUDGET_MS;
+    for (const hook of hooks) {
+        const remaining = deadline - Date.now();
+        // A timed-out hook must be reaped before launch can proceed. Reserve the
+        // process-group termination grace inside the event budget rather than
+        // letting the final cleanup extend the node-start critical path.
+        const timeoutMs = Math.min(LIFECYCLE_HOOK_TIMEOUT_MS, remaining - PROCESS_GROUP_KILL_GRACE_MS);
+        if (timeoutMs <= 0) {
+            diag(`crtr: lifecycle hook event ${hook.event} exceeded its ${LIFECYCLE_EVENT_BUDGET_MS}ms aggregate budget; skipped ${label(hook)}`);
+            return;
+        }
+        await invokeLifecycleHook(hook, invocation, timeoutMs);
+    }
+}
+async function runLifecycleProcess(hook, input, timeoutMs) {
+    let child;
+    try {
+        child = spawn(hook.executable, ['--crtr-hook-protocol', '1'], {
+            cwd: hook.plugin.root,
+            env: process.env,
+            stdio: ['pipe', 'pipe', 'inherit'],
+            ...posixProcessGroupSpawnOptions(),
+        });
+    }
+    catch (error) {
+        throw new Error(`executable could not be run (${describeError(error)})`);
+    }
+    return new Promise((resolve, reject) => {
+        let stdoutBytes = 0;
+        const stdout = [];
+        let failure;
+        let closed = false;
+        let cleaned = false;
+        let status = null;
+        let signal = null;
+        let timeout;
+        const finish = () => {
+            if (!closed || (failure !== undefined && !cleaned))
+                return;
+            if (timeout !== undefined)
+                clearTimeout(timeout);
+            if (failure?.kind === 'timeout')
+                return reject(new Error(`executable timed out after ${timeoutMs}ms`));
+            if (failure?.kind === 'output_limit')
+                return reject(new Error('stdout exceeded the 10 MiB cap'));
+            if (failure?.kind === 'spawn')
+                return reject(new Error(`executable could not be run (${describeError(failure.error)})`));
+            if (failure?.kind === 'cleanup')
+                return reject(new Error(`executable cleanup failed (${describeError(failure.error)})`));
+            resolve({ stdout: Buffer.concat(stdout).toString('utf8'), status, signal });
+        };
+        const terminate = (reason) => {
+            if (failure !== undefined)
+                return;
+            failure = reason;
+            if (timeout !== undefined)
+                clearTimeout(timeout);
+            void terminateProcessGroup(child).then(() => { cleaned = true; finish(); }, (error) => { failure = { kind: 'cleanup', error }; cleaned = true; finish(); });
+        };
+        child.stdout.on('data', (chunk) => {
+            stdoutBytes += chunk.byteLength;
+            if (stdoutBytes > MAX_STDOUT)
+                return terminate({ kind: 'output_limit' });
+            stdout.push(chunk);
+        });
+        child.once('error', (error) => {
+            if (child.pid === undefined) {
+                failure = { kind: 'spawn', error };
+                closed = true;
+                cleaned = true;
+                finish();
+                return;
+            }
+            terminate({ kind: 'spawn', error });
+        });
+        child.once('close', (nextStatus, nextSignal) => {
+            status = nextStatus;
+            signal = nextSignal;
+            closed = true;
+            finish();
+        });
+        timeout = setTimeout(() => terminate({ kind: 'timeout' }), timeoutMs);
+        child.stdin.end(input);
+    });
+}
+function parseEnvelope(stdout) {
+    let value;
+    try {
+        value = JSON.parse(stdout.trim());
+    }
+    catch {
+        throw new Error('stdout was not a single JSON envelope');
+    }
+    if (!isRecord(value) || value['protocolVersion'] !== 1)
+        throw new Error('stdout was not a protocolVersion: 1 envelope');
+    if (value['ok'] === true && exactKeys(value, ['protocolVersion', 'ok']))
+        return { protocolVersion: 1, ok: true };
+    if (value['ok'] !== false || !exactKeys(value, ['protocolVersion', 'ok', 'error']))
+        throw new Error('response envelope had missing or extra fields');
+    const error = value['error'];
+    if (!isRecord(error) || !exactKeys(error, ['code', 'message'], ['next']) || typeof error['code'] !== 'string' || error['code'] === '' || typeof error['message'] !== 'string' || error['message'] === '' || (error['next'] !== undefined && typeof error['next'] !== 'string')) {
+        throw new Error('failure envelope had invalid error fields');
+    }
+    return { protocolVersion: 1, ok: false, error: { code: error['code'], message: error['message'], ...(error['next'] === undefined ? {} : { next: error['next'] }) } };
+}
+function exactKeys(value, required, optional = []) {
+    return required.every((key) => Object.hasOwn(value, key)) && Object.keys(value).every((key) => required.includes(key) || optional.includes(key));
+}
+function label(hook) {
+    return `plugin "${hook.plugin.name}" lifecycle hook "${hook.op}" for ${hook.event}`;
+}
+function describeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/core/config.js

@@ -114,10 +114,11 @@ export function ensureScopeInitialized(scope, root) {
         // a missing `modelLadders` from whatever build is CURRENTLY running, and an explicit
         // user override (`sys config set modelLadders...`) still persists and still wins.
         // Keybindings are sparse user overrides, so an untouched scope omits that member too.
-        const { modelLadders: _omittedModelLadders, keybindings: _omittedKeybindings, tmux_passthrough: _omittedTmuxPassthrough, brokerThresholds, ...rest } = defaultScopeConfig();
-        // Broker thresholds are host-wide daemon policy, so only user scope
-        // persists them. Project config must never acquire a machine setting.
-        atomicWriteJson(cfgPath, scope === 'user' ? { ...rest, brokerThresholds } : rest);
+        const { modelLadders: _omittedModelLadders, keybindings: _omittedKeybindings, tmux_passthrough: _omittedTmuxPassthrough, brokerThresholds, lifecycle, ...rest } = defaultScopeConfig();
+        // Broker thresholds and lifecycle timing are host-wide daemon policy, so
+        // only user scope persists them. Project config must never acquire a
+        // machine setting.
+        atomicWriteJson(cfgPath, scope === 'user' ? { ...rest, brokerThresholds, lifecycle } : rest);
     });
 }
 function normalizeKeybindings(raw) {
@@ -701,6 +702,12 @@ function mergeBrokerThresholds(raw, defaults) {
         ? { warning, automaticReviveCap }
         : { ...defaults };
 }
+function mergeLifecycle(raw, defaults) {
+    const partial = raw !== null && typeof raw === 'object'
+        ? raw
+        : {};
+    return { unattendedParkMs: normalizePositiveInteger(partial.unattendedParkMs, defaults.unattendedParkMs) };
+}
 function normalizeWhipMessages(raw) {
     if (!Array.isArray(raw))
         return [...DEFAULT_WHIP_MESSAGES];
@@ -728,6 +735,7 @@ function mergeConfig(partial) {
         ? partial.auto_open_child_viewers
         : defaults.auto_open_child_viewers;
     const brokerThresholds = mergeBrokerThresholds(partial.brokerThresholds, defaults.brokerThresholds);
+    const lifecycle = mergeLifecycle(partial.lifecycle, defaults.lifecycle);
     const completion_bell = typeof partial.completion_bell === 'boolean' ? partial.completion_bell : defaults.completion_bell;
     const working_gerunds = partial.working_gerunds === undefined
         ? [...defaults.working_gerunds]
@@ -761,7 +769,7 @@ function mergeConfig(partial) {
     const spawnEnv = mergeSpawnEnv(partial.spawnEnv, defaults.spawnEnv?.allow);
     const bin = normalizeBin(partial.bin);
     const humanActions = normalizeHumanActions(partial.humanActions);
-    return { bin, humanActions, schema_version, marketplaces, plugins, auto_update, max_panes_per_window, auto_open_child_viewers, brokerThresholds, completion_bell, working_gerunds, whip_mode, page_components, page_surface, whip_messages, whip_message_mode, mouse_mode_default, live_cycles, condensed_history, bash_tool_purpose, fold_finished_tools, summarize_tool_calls, detailed_tool_recaps, keybindings, tmux_passthrough, modelLadders, ...(Object.keys(modelRoutes).length > 0 ? { modelRoutes } : {}), ...(Object.keys(routes.legacy).length > 0 ? { legacyModelRoutes: routes.legacy } : {}), ...(modelRouting !== undefined ? { modelRouting } : {}), kinds, remoteCanvas, spawnEnv };
+    return { bin, humanActions, schema_version, marketplaces, plugins, auto_update, max_panes_per_window, auto_open_child_viewers, brokerThresholds, lifecycle, completion_bell, working_gerunds, whip_mode, page_components, page_surface, whip_messages, whip_message_mode, mouse_mode_default, live_cycles, condensed_history, bash_tool_purpose, fold_finished_tools, summarize_tool_calls, detailed_tool_recaps, keybindings, tmux_passthrough, modelLadders, ...(Object.keys(modelRoutes).length > 0 ? { modelRoutes } : {}), ...(Object.keys(routes.legacy).length > 0 ? { legacyModelRoutes: routes.legacy } : {}), ...(modelRouting !== undefined ? { modelRouting } : {}), kinds, remoteCanvas, spawnEnv };
 }
 /** Raw (un-defaulted) partial config for one scope, or null if the scope has
  *  no root or no config.json. Used by `readMergedLaunchConfig` to layer

package/dist/core/human/feedback-companion.js

@@ -92,7 +92,7 @@ export async function realizeFeedbackCompanion(args) {
         // The bind deadline below only a live broker can meet, so a capacity
         // refusal must surface here and discard the companion — freezing would
         // burn the whole deadline waiting for a launch that is not coming.
-        reviveNode(node.node_id, { resume: false, capacity: 'refuse' });
+        await reviveNode(node.node_id, { resume: false, capacity: 'refuse' });
         if (!await awaitCompanionBind(node.node_id, COMPANION_BIND_DEADLINE_MS)) {
             throw new Error(`feedback companion did not bind within ${COMPANION_BIND_DEADLINE_MS}ms`);
         }

package/dist/core/keybindings/catalog.d.ts

@@ -3,13 +3,13 @@ import type { AttachBindingId, AttachMenuBindingId } from './attach-control.js';
 type TmuxMenuAction = 'open' | 'attach' | 'show' | 'view-settings' | 'fold-tools' | 'metadata' | 'promote' | 'demote-mode' | 'resume' | 'fork' | 'demote' | 'make-resident' | 'detach' | 'close-subtree' | 'background-bash' | 'file-review' | 'pin' | 'reload-viewer' | 'recap' | 'context' | 'context-admin' | 'providers' | 'plugins' | 'graph' | 'focus-manager' | 'copy-id' | 'issues';
 type TmuxMenuEntryAction = Exclude<TmuxMenuAction, 'open' | 'attach'> | `issue.${'idea' | 'bug'}`;
 type GraphAction = 'down' | 'up' | 'first' | 'last' | 'collapse-or-manager' | 'expand-or-child' | 'focus' | 'revive' | 'focus-manager' | 'close-subtree' | 'dismiss';
-type BrowseAction = 'quit' | 'down' | 'up' | 'first' | 'last' | 'expand-or-child' | 'collapse-or-parent' | 'toggle-fold' | 'tab-next' | 'tab-previous' | `tab.${1 | 2 | 3 | 4 | 5}` | 'close-subtree' | 'confirm-close' | 'sort' | 'scope' | 'profile' | 'residents' | 'preview' | 'search' | 'revive-now' | 'focus' | 'focus-background' | 'yank-id';
+type BrowseAction = 'quit' | 'down' | 'up' | 'first' | 'last' | 'expand-or-child' | 'collapse-or-parent' | 'toggle-fold' | 'tab-next' | 'tab-previous' | `tab.${1 | 2 | 3 | 4 | 5}` | 'close-subtree' | 'confirm-close' | 'sort' | 'scope' | 'profile' | 'residents' | 'preview' | 'pin' | 'search' | 'revive-now' | 'focus' | 'focus-background' | 'yank-id';
 type ProfileMenuAction = 'up' | 'down' | 'select' | 'accept-default' | 'abort' | `slot.${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}` | 'create' | 'search-existing' | 'use-root' | 'set-default' | 'add-directory' | 'unpin' | 'manage';
 type SetupAction = 'cancel' | 'tab-next' | 'tab-previous' | 'open' | 'list-down' | 'list-up' | 'toggle' | 'details' | 'advance' | 'cell-previous' | 'cell-next';
 type SetupKeybindingAction = 'edit' | 'commit-edit' | 'cancel-edit' | 'unbind' | 'reset-row' | 'reset-all' | 'save' | 'discard' | 'page-up' | 'page-down' | 'filter' | 'filter-delete' | 'filter-clear';
 type SetupModelsAction = 'open' | 'commit' | 'cancel' | 'scope-next';
 export type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | AttachMenuBindingId | `crtr.tmux.menu-global.${TmuxMenuEntryAction}` | `crtr.tmux.node.${'next' | 'previous'}` | 'crtr.tmux.inbox.toggle' | `crtr.attach.scroll.${'up' | 'down' | 'page-up' | 'page-down' | 'live'}` | 'crtr.attach.mouse.toggle' | 'crtr.attach.copy.message' | 'crtr.attach.help.toggle' | `crtr.attach.search.${'next' | 'previous' | 'edit' | 'close'}` | AttachBindingId | `crtr.graph.${GraphAction}` | `crtr.graph.confirm.${'accept' | 'cancel'}` | `crtr.inspector.${'force-quit' | 'down' | 'up' | 'section-next' | 'section-prev' | 'page-down' | 'page-up' | 'toggle-detail' | 'cancel-item' | 'open-log' | 'confirm' | 'dismiss' | 'retarget' | 'refresh' | 'quit'}` | `crtr.browse.${BrowseAction}` | `crtr.browse.search.${'cancel' | 'commit' | 'delete' | 'quit'}` | `crtr.profile.menu.${ProfileMenuAction}` | `crtr.profile.search.${'up' | 'down' | 'pick' | 'back' | 'delete' | 'abort'}` | `crtr.setup.${SetupAction}` | `crtr.setup.confirm.${'accept' | 'back'}` | `crtr.setup.keybindings.${SetupKeybindingAction}` | `crtr.setup.models.${SetupModelsAction}`;
-export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.attach">, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.tmux.node.next"> | BindingDefinition<"crtr.tmux.node.previous"> | BindingDefinition<"crtr.tmux.inbox.toggle"> | BindingDefinition<"crtr.attach.scroll.up"> | BindingDefinition<"crtr.attach.scroll.down"> | BindingDefinition<"crtr.attach.scroll.page-up"> | BindingDefinition<"crtr.attach.scroll.page-down"> | BindingDefinition<"crtr.attach.scroll.live"> | BindingDefinition<"crtr.attach.mouse.toggle"> | BindingDefinition<"crtr.attach.copy.message"> | BindingDefinition<"crtr.attach.search.next"> | BindingDefinition<"crtr.attach.search.previous"> | BindingDefinition<"crtr.attach.search.edit"> | BindingDefinition<"crtr.attach.search.close"> | BindingDefinition<"crtr.graph.down"> | BindingDefinition<"crtr.graph.up"> | BindingDefinition<"crtr.graph.first"> | BindingDefinition<"crtr.graph.last"> | BindingDefinition<"crtr.graph.collapse-or-manager"> | BindingDefinition<"crtr.graph.expand-or-child"> | BindingDefinition<"crtr.graph.focus"> | BindingDefinition<"crtr.graph.revive"> | BindingDefinition<"crtr.graph.focus-manager"> | BindingDefinition<"crtr.graph.close-subtree"> | BindingDefinition<"crtr.graph.dismiss"> | BindingDefinition<"crtr.graph.confirm.accept"> | BindingDefinition<"crtr.graph.confirm.cancel"> | BindingDefinition<"crtr.inspector.force-quit"> | BindingDefinition<"crtr.inspector.down"> | BindingDefinition<"crtr.inspector.up"> | BindingDefinition<"crtr.inspector.section-next"> | BindingDefinition<"crtr.inspector.section-prev"> | BindingDefinition<"crtr.inspector.page-down"> | BindingDefinition<"crtr.inspector.page-up"> | BindingDefinition<"crtr.inspector.toggle-detail"> | BindingDefinition<"crtr.inspector.cancel-item"> | BindingDefinition<"crtr.inspector.open-log"> | BindingDefinition<"crtr.inspector.confirm"> | BindingDefinition<"crtr.inspector.dismiss"> | BindingDefinition<"crtr.inspector.retarget"> | BindingDefinition<"crtr.inspector.refresh"> | BindingDefinition<"crtr.inspector.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.2" | "crtr.browse.tab.1" | "crtr.browse.tab.3" | "crtr.browse.tab.4" | "crtr.browse.tab.5"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.profile"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.focus-background"> | BindingDefinition<"crtr.browse.yank-id"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.menu.manage">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">, BindingDefinition<"crtr.setup.cell-previous">, BindingDefinition<"crtr.setup.cell-next">, BindingDefinition<"crtr.setup.models.open">, BindingDefinition<"crtr.setup.models.scope-next">, BindingDefinition<"crtr.setup.models.commit">, BindingDefinition<"crtr.setup.models.cancel">];
+export declare const BINDING_CATALOG: readonly [BindingDefinition<"crtr.tmux.menu.open">, BindingDefinition<"crtr.tmux.menu.attach">, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.tmux.node.next"> | BindingDefinition<"crtr.tmux.node.previous"> | BindingDefinition<"crtr.tmux.inbox.toggle"> | BindingDefinition<"crtr.attach.scroll.up"> | BindingDefinition<"crtr.attach.scroll.down"> | BindingDefinition<"crtr.attach.scroll.page-up"> | BindingDefinition<"crtr.attach.scroll.page-down"> | BindingDefinition<"crtr.attach.scroll.live"> | BindingDefinition<"crtr.attach.mouse.toggle"> | BindingDefinition<"crtr.attach.copy.message"> | BindingDefinition<"crtr.attach.search.next"> | BindingDefinition<"crtr.attach.search.previous"> | BindingDefinition<"crtr.attach.search.edit"> | BindingDefinition<"crtr.attach.search.close"> | BindingDefinition<"crtr.graph.down"> | BindingDefinition<"crtr.graph.up"> | BindingDefinition<"crtr.graph.first"> | BindingDefinition<"crtr.graph.last"> | BindingDefinition<"crtr.graph.collapse-or-manager"> | BindingDefinition<"crtr.graph.expand-or-child"> | BindingDefinition<"crtr.graph.focus"> | BindingDefinition<"crtr.graph.revive"> | BindingDefinition<"crtr.graph.focus-manager"> | BindingDefinition<"crtr.graph.close-subtree"> | BindingDefinition<"crtr.graph.dismiss"> | BindingDefinition<"crtr.graph.confirm.accept"> | BindingDefinition<"crtr.graph.confirm.cancel"> | BindingDefinition<"crtr.inspector.force-quit"> | BindingDefinition<"crtr.inspector.down"> | BindingDefinition<"crtr.inspector.up"> | BindingDefinition<"crtr.inspector.section-next"> | BindingDefinition<"crtr.inspector.section-prev"> | BindingDefinition<"crtr.inspector.page-down"> | BindingDefinition<"crtr.inspector.page-up"> | BindingDefinition<"crtr.inspector.toggle-detail"> | BindingDefinition<"crtr.inspector.cancel-item"> | BindingDefinition<"crtr.inspector.open-log"> | BindingDefinition<"crtr.inspector.confirm"> | BindingDefinition<"crtr.inspector.dismiss"> | BindingDefinition<"crtr.inspector.retarget"> | BindingDefinition<"crtr.inspector.refresh"> | BindingDefinition<"crtr.inspector.quit"> | BindingDefinition<"crtr.browse.quit"> | BindingDefinition<"crtr.browse.down"> | BindingDefinition<"crtr.browse.up"> | BindingDefinition<"crtr.browse.first"> | BindingDefinition<"crtr.browse.last"> | BindingDefinition<"crtr.browse.expand-or-child"> | BindingDefinition<"crtr.browse.collapse-or-parent"> | BindingDefinition<"crtr.browse.toggle-fold"> | BindingDefinition<"crtr.browse.tab-next"> | BindingDefinition<"crtr.browse.tab-previous"> | BindingDefinition<"crtr.browse.tab.2" | "crtr.browse.tab.1" | "crtr.browse.tab.3" | "crtr.browse.tab.4" | "crtr.browse.tab.5"> | BindingDefinition<"crtr.browse.close-subtree"> | BindingDefinition<"crtr.browse.confirm-close"> | BindingDefinition<"crtr.browse.sort"> | BindingDefinition<"crtr.browse.scope"> | BindingDefinition<"crtr.browse.profile"> | BindingDefinition<"crtr.browse.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.pin"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | BindingDefinition<"crtr.browse.focus-background"> | BindingDefinition<"crtr.browse.yank-id"> | BindingDefinition<"crtr.browse.search.cancel"> | BindingDefinition<"crtr.browse.search.commit"> | BindingDefinition<"crtr.browse.search.delete"> | BindingDefinition<"crtr.browse.search.quit"> | BindingDefinition<"crtr.profile.menu.up"> | BindingDefinition<"crtr.profile.menu.down"> | BindingDefinition<"crtr.profile.menu.select"> | BindingDefinition<"crtr.profile.menu.accept-default"> | BindingDefinition<"crtr.profile.menu.abort"> | BindingDefinition<"crtr.profile.menu.slot.2" | "crtr.profile.menu.slot.1" | "crtr.profile.menu.slot.3" | "crtr.profile.menu.slot.4" | "crtr.profile.menu.slot.5" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.menu.manage">, BindingDefinition<"crtr.profile.search.up">, BindingDefinition<"crtr.profile.search.down">, BindingDefinition<"crtr.profile.search.pick">, BindingDefinition<"crtr.profile.search.back">, BindingDefinition<"crtr.profile.search.delete">, BindingDefinition<"crtr.profile.search.abort">, BindingDefinition<"crtr.setup.cancel">, BindingDefinition<"crtr.setup.tab-next">, BindingDefinition<"crtr.setup.tab-previous">, BindingDefinition<"crtr.setup.open">, BindingDefinition<"crtr.setup.list-down">, BindingDefinition<"crtr.setup.list-up">, BindingDefinition<"crtr.setup.toggle">, BindingDefinition<"crtr.setup.details">, BindingDefinition<"crtr.setup.advance">, BindingDefinition<"crtr.setup.confirm.accept">, BindingDefinition<"crtr.setup.confirm.back">, BindingDefinition<"crtr.setup.keybindings.edit">, BindingDefinition<"crtr.setup.keybindings.commit-edit">, BindingDefinition<"crtr.setup.keybindings.cancel-edit">, BindingDefinition<"crtr.setup.keybindings.unbind">, BindingDefinition<"crtr.setup.keybindings.reset-row">, BindingDefinition<"crtr.setup.keybindings.reset-all">, BindingDefinition<"crtr.setup.keybindings.save">, BindingDefinition<"crtr.setup.keybindings.discard">, BindingDefinition<"crtr.setup.keybindings.page-up">, BindingDefinition<"crtr.setup.keybindings.page-down">, BindingDefinition<"crtr.setup.keybindings.filter">, BindingDefinition<"crtr.setup.keybindings.filter-delete">, BindingDefinition<"crtr.setup.keybindings.filter-clear">, BindingDefinition<"crtr.setup.cell-previous">, BindingDefinition<"crtr.setup.cell-next">, BindingDefinition<"crtr.setup.models.open">, BindingDefinition<"crtr.setup.models.scope-next">, BindingDefinition<"crtr.setup.models.commit">, BindingDefinition<"crtr.setup.models.cancel">];
 export declare const BINDING_IDS: ReadonlySet<string>;
 /** True for an action whose direct gesture is handled inside an attach viewer.
  *  Tmux menu selectors and root shortcuts are chrome, not pane input. */

package/dist/core/keybindings/catalog.js

@@ -147,7 +147,8 @@ function browseBindings() {
         b('crtr.browse.scope', 'Browse and pickers', 'Change scope', 'Toggle the browse cwd scope.', ['c'], 'terminal', [nav]),
         b('crtr.browse.profile', 'Browse and pickers', 'Toggle profile', 'Toggle the browse profile scope.', ['shift+p'], 'terminal', [nav]),
         b('crtr.browse.residents', 'Browse and pickers', 'Toggle residents', 'Toggle resident display.', ['r'], 'terminal', [nav]),
-        b('crtr.browse.preview', 'Browse and pickers', 'Toggle preview', 'Toggle the preview panel.', ['p'], 'terminal', [nav]),
+        b('crtr.browse.preview', 'Browse and pickers', 'Toggle preview', 'Toggle the preview panel.', ['v'], 'terminal', [nav]),
+        b('crtr.browse.pin', 'Browse and pickers', 'Pin node', 'Star or unstar the selected node.', ['p'], 'terminal', [nav]),
         b('crtr.browse.search', 'Browse and pickers', 'Search', 'Open browse search.', ['/'], 'terminal', [nav]),
         b('crtr.browse.revive-now', 'Browse and pickers', 'Revive now', 'Revive the selected node now.', ['shift+k'], 'terminal', [nav]),
         b('crtr.browse.focus', 'Browse and pickers', 'Focus node', 'Focus the selected node.', ['enter', 'o'], 'terminal', [nav]),

package/dist/core/model-routes.js

@@ -189,7 +189,7 @@ export function modelRequestFromConfig(model, modelIntent, exact) {
     if (exact)
         return { kind: 'exact', spec: model };
     if (modelIntent) {
-        const slash = modelIntent.indexOf('/');
+        const slash = modelIntent.lastIndexOf('/');
         const strength = slash > 0 ? modelIntent.slice(slash + 1) : '';
         if (STRENGTHS.includes(strength))
             return { kind: 'logical', family: modelIntent.slice(0, slash), strength: strength, spec: model };

package/dist/core/review/realize.js

@@ -172,7 +172,7 @@ export async function realizeReview(reviewId) {
     // Realization is bounded by the bind deadline below, which only a live broker
     // can meet: refuse at the cap rather than freeze into a certain timeout.
     if (companion.pi_session_id === null)
-        reviveNode(companion.node_id, { resume: false, capacity: 'refuse' });
+        await reviveNode(companion.node_id, { resume: false, capacity: 'refuse' });
     // R4: session_start is the durable bind boundary.
     if (!await awaitCompanionBind(review.companion_node_id, COMPANION_BIND_DEADLINE_MS)) {
         throw companionUnbound(review.review_id, COMPANION_BIND_DEADLINE_MS);

package/dist/core/runtime/broker/auth-reload.js

@@ -3,6 +3,7 @@ import { envModelIntent } from '../../../shared/env.js';
 import { emitEvent } from '../../events/emit.js';
 import { clearFault, readFault } from '../fault.js';
 import { isUnknownModel } from '../model-selection.js';
+import { announceMessageOrigin } from '../stamp/channel.js';
 export function createAuthReloadGate(deps) {
     const { nodeId, cfg, replies, rebind, session, services, broadcastModelChanged, formatModelSpec, resolveLaunchModel, driveKickoff, turnAdmission, } = deps;
     let reloadInFlight = null;
@@ -118,7 +119,9 @@ export function createAuthReloadGate(deps) {
                         return Promise.resolve();
                     }
                     clearFault(nodeId, { link: 'pi→provider' });
-                    return faultSession.prompt(formatCard('recovery', {}, AUTH_FAULT_RECOVERY_BODY), { preflightResult: release });
+                    const card = formatCard('recovery', {}, AUTH_FAULT_RECOVERY_BODY);
+                    announceMessageOrigin(card, { type: 'runtime', kind: 'recovery' });
+                    return faultSession.prompt(card, { preflightResult: release });
                 });
             }
             catch (err) {

package/dist/core/runtime/broker/engine-drive.d.ts

@@ -1,3 +1,4 @@
+import type { MessageOrigin } from '../stamp/protocol.js';
 import type { ClientToBroker } from '../broker-protocol.js';
 import type { BrokerClient, BrokerClientRegistry } from './client-registry.js';
 import type { EventProjection } from './event-projection.js';
@@ -9,9 +10,18 @@ import type { RebindDriver } from './rebind.js';
 import type { ToolGroupTracker } from './tool-groups.js';
 import type { PromptDispatchTracker } from './turn-ignition.js';
 import type { TurnAdmissionGate } from './turn-admission.js';
-/** The frames that drive the live engine — the viewer's input vocabulary. */
-export type DriveFrame = Extract<ClientToBroker, {
-    type: 'prompt' | 'steer' | 'follow_up' | 'abort' | 'bash';
+/** The frames that drive the live engine. A daemon delivery carries its
+ *  provenance through admission because only the resolved route can decide
+ *  whether the resulting run is internal. */
+type DeliveredInput = {
+    delivery?: {
+        origin?: MessageOrigin;
+    };
+};
+export type DriveFrame = (Extract<ClientToBroker, {
+    type: 'prompt' | 'follow_up';
+}> & DeliveredInput) | Extract<ClientToBroker, {
+    type: 'steer' | 'abort' | 'bash';
 }>;
 export type EngineDriver = (client: BrokerClient, frame: DriveFrame) => Promise<unknown> | undefined;
 export declare function createEngineDriver(deps: {
@@ -26,3 +36,4 @@ export declare function createEngineDriver(deps: {
     toolGroups: ToolGroupTracker;
     turnAdmission: TurnAdmissionGate;
 }): EngineDriver;
+export {};

package/dist/core/runtime/broker/engine-drive.js

@@ -2,6 +2,8 @@ import { emitEvent } from '../../events/emit.js';
 import { operationIdContext } from '../../events/operation-id.js';
 import { promptWithAdvertisedCommandInvocation } from '../advertised-command-invocation.js';
 import { heldDeferredInboxPromptJoin } from './held-deferred-inbox.js';
+import { announceMessageOrigin } from '../stamp/channel.js';
+import { clearTurnVisibility, currentTurnVisibility, setTurnVisibility, } from '../turn-visibility.js';
 import { chooseGuidanceDeliveryMode, promptWithNextTurnGuidance, resolveEngineRoute, resolveSteerCall, } from './engine-routing.js';
 export function createEngineDriver(deps) {
     const { registry, replies, session, dispatches, memoryRefs, authReloadGate, rebind, projection, toolGroups, turnAdmission, } = deps;
@@ -47,6 +49,20 @@ export function createEngineDriver(deps) {
             const route = resolveEngineRoute(frame, session().isStreaming);
             const promptOptions = route.call === 'prompt' ? route.options : undefined;
             const guidance = memoryRefs.guidanceFor(frame.text);
+            const deliveryIsInternal = frame.delivery?.origin?.type === 'runtime'
+                && frame.delivery.origin.kind === 'park'
+                && route.call === 'prompt'
+                && route.options.streamingBehavior === undefined;
+            const announceDelivery = () => {
+                if (frame.delivery === undefined)
+                    return;
+                const visibility = deliveryIsInternal ? 'internal' : undefined;
+                if (frame.delivery.origin === undefined) {
+                    setTurnVisibility('visible');
+                    return;
+                }
+                announceMessageOrigin(frame.text, frame.delivery.origin, visibility);
+            };
             const prompt = async () => {
                 // Both human surfaces converge at this admitted boundary. The watcher
                 // claims held deferred mail before the prompt body, but its cursor stays
@@ -60,7 +76,19 @@ export function createEngineDriver(deps) {
                         // replay. A person's live prompt is not replayable, so it must run.
                     }
                 }
-                await session().prompt(frame.text, { ...promptOptions, preflightResult: release });
+                announceDelivery();
+                registry.broadcast({
+                    type: 'turn_visibility',
+                    visibility: currentTurnVisibility(),
+                });
+                try {
+                    await session().prompt(frame.text, { ...promptOptions, preflightResult: release });
+                }
+                catch (error) {
+                    if (deliveryIsInternal)
+                        clearTurnVisibility();
+                    throw error;
+                }
             };
             if (guidance === null) {
                 if (route.call === 'prompt') {