@north-light/crouter 0.3.158 → 0.3.160

package/dist/core/inspector/model.js

@@ -13,6 +13,8 @@ export const ICON = {
     artifacts: cp(0xf1da), // history/archive — what it left behind
     paths: cp(0xf0f6), // file-text — on-disk locations
     cron: cp(0xf017), // clock — one armed cron
+    job: cp(0xf013), // cog — one live background bash job
+    log: cp(0xf120), // terminal — the job's log stream
     section: cp(0xf192), // dot-circle — the active tab marker
     raw: cp(0xf121), // code — the raw record
     empty: cp(0xf1b3), // cubes — nothing armed
@@ -42,6 +44,43 @@ export function scheduledItems(crons) {
         return a.cron.cron_id.localeCompare(b.cron.cron_id);
     });
 }
+/** Elapsed duration in the shape every bash-handoff surface uses: `12s`,
+ *  `3m 40s`, `1h 04m`. Duplicated from core/bash-jobs.ts on purpose — a view
+ *  module stays a pure read and never pulls the node:fs job scanner in. */
+export function elapsed(ms) {
+    const totalSeconds = Math.max(0, Math.floor(ms / 1000));
+    if (totalSeconds < 60)
+        return `${totalSeconds}s`;
+    const totalMinutes = Math.floor(totalSeconds / 60);
+    if (totalMinutes < 60)
+        return `${totalMinutes}m ${String(totalSeconds % 60).padStart(2, '0')}s`;
+    return `${Math.floor(totalMinutes / 60)}h ${String(totalMinutes % 60).padStart(2, '0')}m`;
+}
+/** How a running job's age reads at a glance: an ordered ramp, not decoration.
+ *  Fresh work is green, a job past 15m is amber, past an hour is red — the same
+ *  good/warn/bad progression the node status glyphs use. */
+export function jobTone(elapsedMs) {
+    if (elapsedMs >= 60 * 60_000)
+        return 'bad';
+    if (elapsedMs >= 15 * 60_000)
+        return 'warn';
+    return 'good';
+}
+/** Milliseconds a job has been running, live from `started_at`. */
+export function jobElapsedMs(job, now = Date.now()) {
+    const at = Date.parse(job.started_at);
+    return Number.isFinite(at) ? now - at : job.elapsed_ms;
+}
+/** Live elapsed time for a job row — recomputed from `started_at` so the number
+ *  keeps ticking between the view's 5s refreshes; `elapsed_ms` is the fallback. */
+export function jobElapsed(job, now = Date.now()) {
+    return elapsed(jobElapsedMs(job, now));
+}
+/** First line of a command, whitespace-collapsed and capped for a one-row cell. */
+export function commandCell(command, cap = 60) {
+    const oneLine = (command.split('\n')[0] ?? '').replace(/\s+/g, ' ').trim();
+    return oneLine.length > cap ? `${oneLine.slice(0, cap - 1)}…` : oneLine;
+}
 export function relativeTime(iso, now = Date.now()) {
     if (iso === null)
         return '—';

package/dist/core/inspector/text.js

@@ -1,4 +1,4 @@
-import { overviewGroups, relativeTime, scheduledItems, value } from './model.js';
+import { jobElapsed, overviewGroups, relativeTime, scheduledItems, value } from './model.js';
 /** The piped path: same information and grouping as the TUI, minus the glyphs
  *  and hue a pipe cannot carry. */
 export const inspectorText = {
@@ -27,6 +27,19 @@ export const inspectorText = {
             const cron = item.cron;
             lines.push('', `  ${cron.name} · ${item.cadence} · ${relativeTime(item.nextAt)}`, `    id        ${cron.cron_id}`, `    next      ${item.nextAt}`, `    state     ${value(cron.state)}`, `    output    ${cron.on_output}${cron.sink ? ` → ${cron.sink}` : ''}`, `    expires   ${value(cron.expires_at)}`);
         }
+        lines.push('', 'BACKGROUND BASH JOBS');
+        if (state.jobs.error) {
+            lines.push(`  ${state.jobs.error.display.explanation}`, `  ${state.jobs.error.display.nextStep}`);
+            return lines.join('\n');
+        }
+        const jobs = state.jobs.data ?? [];
+        if (jobs.length === 0)
+            lines.push('  nothing running');
+        for (const job of jobs) {
+            lines.push('', `  ${job.command.split('\n')[0]} · ${jobElapsed(job)}`, `    id        ${job.job_id}`, `    started   ${job.started_at}`, `    log       ${job.log_path}`);
+            for (const line of job.log_tail.slice(-5))
+                lines.push(`    | ${line}`);
+        }
         return lines.join('\n');
     },
 };

package/dist/core/inspector/tui.js

@@ -1,4 +1,4 @@
-import { ICON, overviewGroups, relativeTime, scheduledItems, shortPath, value, } from './model.js';
+import { ICON, commandCell, jobElapsed, jobElapsedMs, jobTone, overviewGroups, relativeTime, scheduledItems, shortPath, value, } from './model.js';
 // ── Visual grammar ───────────────────────────────────────────────────────────
 //
 // Three primitives carry the whole screen: a TAB STRIP (where am I / where can
@@ -21,6 +21,7 @@ const HEAD_STYLE = { fg: '36', bold: true };
 const SECTIONS = [
     { id: 'overview', label: 'overview' },
     { id: 'schedule', label: 'schedule' },
+    { id: 'jobs', label: 'jobs' },
     { id: 'raw', label: 'raw' },
 ];
 /** `label` padded into the dim label column, then the value. */
@@ -50,7 +51,9 @@ function tabStrip(state, width) {
         const active = section.id === state.section;
         const badge = section.id === 'schedule'
             ? ` ${scheduledItems(state.schedule.data ?? []).length}`
-            : '';
+            : section.id === 'jobs'
+                ? ` ${(state.jobs.data ?? []).length}`
+                : '';
         spans.push({
             text: active ? `${ICON.section} ${section.label}${badge}` : `${section.label}${badge}`,
             style: active ? { fg: '36', bold: true } : { dim: true },
@@ -147,6 +150,52 @@ function cronItem(item, expanded) {
         lines,
     };
 }
+/** One live background job as a list item. Collapsed it shows the single thing
+ *  a watcher wants — the newest log line — under the command and its running
+ *  time; expanding adds the job's identity and a live tail of its log, so the
+ *  Inspector answers "what is it doing right now" without a second surface. */
+function jobItem(job, expanded, width) {
+    const tone = TONE[jobTone(jobElapsedMs(job))];
+    const last = job.log_tail[job.log_tail.length - 1];
+    const lines = [];
+    if (!expanded) {
+        lines.push([{ text: `${INDENT}${INDENT}${last === undefined ? 'no output yet' : logCell(last, width - 6)}`, style: { dim: true } }]);
+    }
+    else {
+        for (const [label, text] of [['job', job.job_id], ['started', job.started_at], ['log', shortPath(job.log_path)], ['watch', `tail -f ${shortPath(job.log_path)}`]]) {
+            lines.push([{ text: `${INDENT}${INDENT}${label.padEnd(LABEL_COL)}`, style: LABEL_STYLE }, { text, style: label === 'watch' ? { fg: '36' } : undefined }]);
+        }
+        lines.push([]);
+        lines.push(groupHeader(ICON.log, `last ${job.log_tail.length} lines`, width - 2));
+        if (job.log_tail.length === 0)
+            lines.push([{ text: `${INDENT}${INDENT}no output yet`, style: { dim: true } }]);
+        for (const line of job.log_tail)
+            lines.push([{ text: `${INDENT}${INDENT}${logCell(line, width - 6)}`, style: { dim: true } }]);
+    }
+    lines.push([]); // one blank row between jobs — each item reads as its own block
+    return {
+        spans: [
+            { text: ` ${ICON.job} `, style: tone },
+            { text: commandCell(job.command, Math.max(20, width - 26)), style: { bold: true } },
+        ],
+        right: [{ text: `${jobElapsed(job)} `, style: tone }],
+        lines,
+    };
+}
+/** A log line, tabs expanded and clipped to the card — never wrapped, so one
+ *  runaway line cannot push the rest of the tail off the screen. */
+function logCell(line, width) {
+    const flat = line.replace(/\t/g, '  ').replace(/[\u0000-\u0008\u000b-\u001f]/g, '');
+    const cap = Math.max(10, width);
+    return flat.length > cap ? `${flat.slice(0, cap - 1)}…` : flat;
+}
+function jobsEmptyRows() {
+    return [
+        [{ text: ` ${ICON.empty} nothing running`, style: { dim: true } }],
+        [],
+        [{ text: `${INDENT}This node has no bash commands running in the background.`, style: { dim: true } }],
+    ];
+}
 function scheduleEmptyRows() {
     return [
         [{ text: ` ${ICON.empty} nothing armed`, style: { dim: true } }],
@@ -185,6 +234,23 @@ export const inspectorTui = {
             paint(state, rawRows(state), draw, content);
             return;
         }
+        if (state.section === 'jobs') {
+            if (state.jobs.error) {
+                const d = state.jobs.error.display;
+                paint(state, errorRows(d.headline, d.explanation, d.nextStep), draw, content);
+                return;
+            }
+            const jobs = state.jobs.data ?? [];
+            if (jobs.length === 0) {
+                paint(state, jobsEmptyRows(), draw, content);
+                return;
+            }
+            draw.spans(content.row, content.col, tabStrip(state, content.width), content.width);
+            const cursor = Math.max(0, jobs.findIndex((job) => job.job_id === state.selectedJobId));
+            const rows = jobs.map((job, index) => jobItem(job, index === cursor && state.expanded, content.width));
+            draw.list({ ...content, row: content.row + 2, height: Math.max(0, content.height - 2) }, rows, cursor, state.scroll.jobs);
+            return;
+        }
         if (state.schedule.error) {
             const d = state.schedule.error.display;
             paint(state, errorRows(d.headline, d.explanation, d.nextStep), draw, content);
@@ -209,8 +275,10 @@ export const inspectorTui = {
         { bindingId: 'crtr.view.inspector.section-prev', intent: 'sectionPrev' },
         { bindingId: 'crtr.view.inspector.page-down', intent: 'pageDown' },
         { bindingId: 'crtr.view.inspector.page-up', intent: 'pageUp' },
-        { bindingId: 'crtr.view.inspector.toggle-detail', intent: 'toggleDetail', when: (state) => state.section === 'schedule' && state.selectedCronId !== null, hint: { label: 'details' } },
+        { bindingId: 'crtr.view.inspector.toggle-detail', intent: 'toggleDetail', when: (state) => (state.section === 'schedule' && state.selectedCronId !== null) || (state.section === 'jobs' && state.selectedJobId !== null), hint: { label: 'details' } },
         { bindingId: 'crtr.view.inspector.cancel-item', intent: 'cancelItem', when: (state) => state.section === 'schedule' && state.selectedCronId !== null, hint: { label: 'cancel' } },
+        { bindingId: 'crtr.view.inspector.cancel-item', intent: 'cancelItem', when: (state) => state.section === 'jobs' && state.selectedJobId !== null, hint: { label: 'stop job' } },
+        { bindingId: 'crtr.view.inspector.open-log', intent: 'openLog', when: (state) => state.section === 'jobs' && state.selectedJobId !== null, hint: { label: 'open log' } },
         { bindingId: 'crtr.view.inspector.confirm', intent: 'confirm', when: (state) => state.pendingCancel !== null, hint: { label: 'confirm' } },
         { bindingId: 'crtr.view.inspector.dismiss', intent: 'dismiss', hint: { label: 'dismiss' } },
         { bindingId: 'crtr.view.inspector.retarget', intent: 'retarget', when: (state) => state.section === 'schedule' && state.selectedCronId !== null, hint: { label: 'retarget' } },

package/dist/core/keybindings/__tests__/resolve.test.js

@@ -14,7 +14,7 @@ function ids(prefix, actions) {
     return actions.map((action) => `${prefix}.${action}`);
 }
 const REQUIRED_IDS = [
-    ...ids('crtr.tmux.menu', ['open', 'promote', 'resume', 'fork', 'demote', 'detach', 'close-subtree', 'background-bash', 'file-review', 'pin', 'show', 'metadata', 'context', 'providers', 'graph', 'focus-manager', 'copy-id', 'reload-viewer', 'issues']),
+    ...ids('crtr.tmux.menu', ['open', 'promote', 'resume', 'fork', 'demote', 'detach', 'close-subtree', 'background-bash', 'file-review', 'pin', 'show', 'view-settings', 'fold-tools', 'metadata', 'context', 'providers', 'graph', 'focus-manager', 'copy-id', 'reload-viewer', 'issues']),
     ...ids('crtr.tmux.menu.issue', ['idea', 'bug']),
     ...ids('crtr.tmux.node', ['next', 'previous']),
     'crtr.tmux.inbox.toggle',
@@ -31,7 +31,7 @@ const REQUIRED_IDS = [
     ...ids('crtr.view.linkedin', ['down', 'up', 'open', 'reply', 'react', 'refresh', 'quit', 'submit-reply', 'cancel', 'reaction-previous', 'reaction-next', 'submit-reaction']),
     ...ids('crtr.view.prompt-review', ['down', 'up', 'compare-previous', 'compare-next', 'toggle-mode', 'expand', 'export', 'refresh', 'quit']),
     ...ids('crtr.view.workspace-sidebar', ['down', 'up', 'open', 'refresh', 'quit']),
-    ...ids('crtr.view.inspector', ['down', 'up', 'section-next', 'section-prev', 'page-down', 'page-up', 'toggle-detail', 'cancel-item', 'confirm', 'dismiss', 'retarget', 'refresh', 'quit']),
+    ...ids('crtr.view.inspector', ['down', 'up', 'section-next', 'section-prev', 'page-down', 'page-up', 'toggle-detail', 'cancel-item', 'open-log', 'confirm', 'dismiss', 'retarget', 'refresh', 'quit']),
     ...ids('crtr.view-picker', ['down', 'up', 'run', 'quit']),
     ...ids('crtr.browse', ['quit', 'down', 'up', 'first', 'last', 'expand-or-child', 'collapse-or-parent', 'toggle-fold', 'tab-next', 'tab-previous', 'tab.1', 'tab.2', 'tab.3', 'tab.4', 'tab.5', 'close-subtree', 'confirm-close', 'sort', 'scope', 'profile', 'residents', 'preview', 'search', 'revive-now', 'focus', 'focus-background']),
     ...ids('crtr.browse.search', ['cancel', 'commit', 'delete', 'quit']),

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

@@ -1,5 +1,5 @@
 import type { BindingDefinition, SafetyRequirement } from './types.js';
-type TmuxMenuAction = 'open' | 'show' | 'metadata' | 'promote' | 'resume' | 'fork' | 'demote' | 'detach' | 'close-subtree' | 'background-bash' | 'file-review' | 'pin' | 'reload-viewer' | 'context' | 'providers' | 'graph' | 'focus-manager' | 'copy-id' | 'issues';
+type TmuxMenuAction = 'open' | 'show' | 'view-settings' | 'fold-tools' | 'metadata' | 'promote' | 'resume' | 'fork' | 'demote' | 'detach' | 'close-subtree' | 'background-bash' | 'file-review' | 'pin' | 'reload-viewer' | 'context' | 'providers' | 'graph' | 'focus-manager' | 'copy-id' | 'issues';
 type GraphAction = 'down' | 'up' | 'first' | 'last' | 'collapse-or-manager' | 'expand-or-child' | 'focus' | 'revive' | 'focus-manager' | 'close-subtree' | 'dismiss';
 type InboxAction = 'down' | 'up' | 'open' | 'reply' | 'react' | 'filter' | 'refresh' | 'connect-linkedin' | 'connect-gmail' | 'quit' | 'submit-reply' | 'cancel' | 'reaction-previous' | 'reaction-next' | 'submit-reaction';
 type LinkedinAction = Exclude<InboxAction, 'filter' | 'connect-linkedin' | 'connect-gmail'>;
@@ -8,8 +8,8 @@ type ProfileMenuAction = 'up' | 'down' | 'select' | 'accept-default' | 'abort' |
 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'}` | `crtr.tmux.node.${'next' | 'previous'}` | `crtr.tmux.view.${'next' | 'previous'}` | 'crtr.tmux.inbox.toggle' | `crtr.attach.${'detach' | 'clear-or-detach' | 'graph.toggle' | 'model-ladder.next' | 'model-ladder.previous' | 'command.inspect' | 'file-review'}` | 'crtr.mode.cycle' | `crtr.graph.${GraphAction}` | `crtr.graph.confirm.${'accept' | 'cancel'}` | `crtr.view.host.${'force-quit' | 'editor.backspace'}` | `crtr.view.canvas.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.chat.${'submit' | 'contextual-cancel' | 'reconnect' | 'quit'}` | `crtr.view.git-pr.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.inbox.${InboxAction}` | `crtr.view.linkedin.${LinkedinAction}` | `crtr.view.prompt-review.${'down' | 'up' | 'compare-previous' | 'compare-next' | 'toggle-mode' | 'expand' | 'export' | 'refresh' | 'quit'}` | `crtr.view.workspace-sidebar.${'down' | 'up' | 'open' | 'refresh' | 'quit'}` | `crtr.view.inspector.${'down' | 'up' | 'section-next' | 'section-prev' | 'page-down' | 'page-up' | 'toggle-detail' | 'cancel-item' | 'confirm' | 'dismiss' | 'retarget' | 'refresh' | 'quit'}` | `crtr.view-picker.${'down' | 'up' | 'run' | '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.promote">, BindingDefinition<"crtr.tmux.menu.resume">, BindingDefinition<"crtr.tmux.menu.fork">, BindingDefinition<"crtr.tmux.menu.demote">, BindingDefinition<"crtr.tmux.menu.detach">, BindingDefinition<"crtr.tmux.menu.close-subtree">, BindingDefinition<"crtr.tmux.menu.background-bash">, BindingDefinition<"crtr.tmux.menu.file-review">, BindingDefinition<"crtr.tmux.menu.pin">, BindingDefinition<"crtr.tmux.menu.show">, BindingDefinition<"crtr.tmux.menu.metadata">, BindingDefinition<"crtr.tmux.menu.context">, BindingDefinition<"crtr.tmux.menu.providers">, BindingDefinition<"crtr.tmux.menu.graph">, BindingDefinition<"crtr.tmux.menu.focus-manager">, BindingDefinition<"crtr.tmux.menu.copy-id">, BindingDefinition<"crtr.tmux.menu.reload-viewer">, BindingDefinition<"crtr.tmux.menu.issues">, BindingDefinition<"crtr.tmux.menu.issue.idea">, BindingDefinition<"crtr.tmux.menu.issue.bug">, BindingDefinition<"crtr.tmux.node.next">, BindingDefinition<"crtr.tmux.node.previous">, BindingDefinition<"crtr.tmux.inbox.toggle">, BindingDefinition<"crtr.tmux.view.next">, BindingDefinition<"crtr.tmux.view.previous">, BindingDefinition<"crtr.attach.detach">, BindingDefinition<"crtr.attach.clear-or-detach">, BindingDefinition<"crtr.attach.graph.toggle">, BindingDefinition<"crtr.attach.model-ladder.next">, BindingDefinition<"crtr.attach.model-ladder.previous">, BindingDefinition<"crtr.attach.command.inspect">, BindingDefinition<"crtr.attach.file-review">, BindingDefinition<"crtr.mode.cycle">, 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.view.host.force-quit">, BindingDefinition<"crtr.view.host.editor.backspace">, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<"crtr.view.chat.submit">, BindingDefinition<"crtr.view.chat.contextual-cancel">, BindingDefinition<"crtr.view.chat.reconnect">, BindingDefinition<"crtr.view.chat.quit">, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.view.prompt-review.down"> | BindingDefinition<"crtr.view.prompt-review.up"> | BindingDefinition<"crtr.view.prompt-review.compare-previous"> | BindingDefinition<"crtr.view.prompt-review.compare-next"> | BindingDefinition<"crtr.view.prompt-review.toggle-mode"> | BindingDefinition<"crtr.view.prompt-review.expand"> | BindingDefinition<"crtr.view.prompt-review.export"> | BindingDefinition<"crtr.view.prompt-review.refresh"> | BindingDefinition<"crtr.view.prompt-review.quit"> | BindingDefinition<"crtr.view.workspace-sidebar.down"> | BindingDefinition<"crtr.view.workspace-sidebar.up"> | BindingDefinition<"crtr.view.workspace-sidebar.open"> | BindingDefinition<"crtr.view.workspace-sidebar.refresh"> | BindingDefinition<"crtr.view.workspace-sidebar.quit"> | BindingDefinition<"crtr.view.inspector.down"> | BindingDefinition<"crtr.view.inspector.up"> | BindingDefinition<"crtr.view.inspector.section-next"> | BindingDefinition<"crtr.view.inspector.section-prev"> | BindingDefinition<"crtr.view.inspector.page-down"> | BindingDefinition<"crtr.view.inspector.page-up"> | BindingDefinition<"crtr.view.inspector.toggle-detail"> | BindingDefinition<"crtr.view.inspector.cancel-item"> | BindingDefinition<"crtr.view.inspector.confirm"> | BindingDefinition<"crtr.view.inspector.dismiss"> | BindingDefinition<"crtr.view.inspector.retarget"> | BindingDefinition<"crtr.view.inspector.refresh"> | BindingDefinition<"crtr.view.inspector.quit"> | BindingDefinition<"crtr.view-picker.down"> | BindingDefinition<"crtr.view-picker.up"> | BindingDefinition<"crtr.view-picker.run"> | BindingDefinition<"crtr.view-picker.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.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.9" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.6">)[], 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.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 type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | `crtr.tmux.node.${'next' | 'previous'}` | `crtr.tmux.view.${'next' | 'previous'}` | 'crtr.tmux.inbox.toggle' | `crtr.attach.${'detach' | 'clear-or-detach' | 'graph.toggle' | 'model-ladder.next' | 'model-ladder.previous' | 'command.inspect' | 'file-review'}` | 'crtr.mode.cycle' | `crtr.graph.${GraphAction}` | `crtr.graph.confirm.${'accept' | 'cancel'}` | `crtr.view.host.${'force-quit' | 'editor.backspace'}` | `crtr.view.canvas.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.chat.${'submit' | 'contextual-cancel' | 'reconnect' | 'quit'}` | `crtr.view.git-pr.${'down' | 'up' | 'refresh' | 'quit'}` | `crtr.view.inbox.${InboxAction}` | `crtr.view.linkedin.${LinkedinAction}` | `crtr.view.prompt-review.${'down' | 'up' | 'compare-previous' | 'compare-next' | 'toggle-mode' | 'expand' | 'export' | 'refresh' | 'quit'}` | `crtr.view.workspace-sidebar.${'down' | 'up' | 'open' | 'refresh' | 'quit'}` | `crtr.view.inspector.${'down' | 'up' | 'section-next' | 'section-prev' | 'page-down' | 'page-up' | 'toggle-detail' | 'cancel-item' | 'open-log' | 'confirm' | 'dismiss' | 'retarget' | 'refresh' | 'quit'}` | `crtr.view-picker.${'down' | 'up' | 'run' | '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.promote">, BindingDefinition<"crtr.tmux.menu.resume">, BindingDefinition<"crtr.tmux.menu.fork">, BindingDefinition<"crtr.tmux.menu.demote">, BindingDefinition<"crtr.tmux.menu.detach">, BindingDefinition<"crtr.tmux.menu.close-subtree">, BindingDefinition<"crtr.tmux.menu.background-bash">, BindingDefinition<"crtr.tmux.menu.file-review">, BindingDefinition<"crtr.tmux.menu.pin">, BindingDefinition<"crtr.tmux.menu.show">, BindingDefinition<"crtr.tmux.menu.view-settings">, BindingDefinition<"crtr.tmux.menu.fold-tools">, BindingDefinition<"crtr.tmux.menu.metadata">, BindingDefinition<"crtr.tmux.menu.context">, BindingDefinition<"crtr.tmux.menu.providers">, BindingDefinition<"crtr.tmux.menu.graph">, BindingDefinition<"crtr.tmux.menu.focus-manager">, BindingDefinition<"crtr.tmux.menu.copy-id">, BindingDefinition<"crtr.tmux.menu.reload-viewer">, BindingDefinition<"crtr.tmux.menu.issues">, BindingDefinition<"crtr.tmux.menu.issue.idea">, BindingDefinition<"crtr.tmux.menu.issue.bug">, BindingDefinition<"crtr.tmux.node.next">, BindingDefinition<"crtr.tmux.node.previous">, BindingDefinition<"crtr.tmux.inbox.toggle">, BindingDefinition<"crtr.tmux.view.next">, BindingDefinition<"crtr.tmux.view.previous">, BindingDefinition<"crtr.attach.detach">, BindingDefinition<"crtr.attach.clear-or-detach">, BindingDefinition<"crtr.attach.graph.toggle">, BindingDefinition<"crtr.attach.model-ladder.next">, BindingDefinition<"crtr.attach.model-ladder.previous">, BindingDefinition<"crtr.attach.command.inspect">, BindingDefinition<"crtr.attach.file-review">, BindingDefinition<"crtr.mode.cycle">, 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.view.host.force-quit">, BindingDefinition<"crtr.view.host.editor.backspace">, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<"crtr.view.chat.submit">, BindingDefinition<"crtr.view.chat.contextual-cancel">, BindingDefinition<"crtr.view.chat.reconnect">, BindingDefinition<"crtr.view.chat.quit">, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, BindingDefinition<BindingId>, ...(BindingDefinition<BindingId> | BindingDefinition<"crtr.view.prompt-review.down"> | BindingDefinition<"crtr.view.prompt-review.up"> | BindingDefinition<"crtr.view.prompt-review.compare-previous"> | BindingDefinition<"crtr.view.prompt-review.compare-next"> | BindingDefinition<"crtr.view.prompt-review.toggle-mode"> | BindingDefinition<"crtr.view.prompt-review.expand"> | BindingDefinition<"crtr.view.prompt-review.export"> | BindingDefinition<"crtr.view.prompt-review.refresh"> | BindingDefinition<"crtr.view.prompt-review.quit"> | BindingDefinition<"crtr.view.workspace-sidebar.down"> | BindingDefinition<"crtr.view.workspace-sidebar.up"> | BindingDefinition<"crtr.view.workspace-sidebar.open"> | BindingDefinition<"crtr.view.workspace-sidebar.refresh"> | BindingDefinition<"crtr.view.workspace-sidebar.quit"> | BindingDefinition<"crtr.view.inspector.down"> | BindingDefinition<"crtr.view.inspector.up"> | BindingDefinition<"crtr.view.inspector.section-next"> | BindingDefinition<"crtr.view.inspector.section-prev"> | BindingDefinition<"crtr.view.inspector.page-down"> | BindingDefinition<"crtr.view.inspector.page-up"> | BindingDefinition<"crtr.view.inspector.toggle-detail"> | BindingDefinition<"crtr.view.inspector.cancel-item"> | BindingDefinition<"crtr.view.inspector.open-log"> | BindingDefinition<"crtr.view.inspector.confirm"> | BindingDefinition<"crtr.view.inspector.dismiss"> | BindingDefinition<"crtr.view.inspector.retarget"> | BindingDefinition<"crtr.view.inspector.refresh"> | BindingDefinition<"crtr.view.inspector.quit"> | BindingDefinition<"crtr.view-picker.down"> | BindingDefinition<"crtr.view-picker.up"> | BindingDefinition<"crtr.view-picker.run"> | BindingDefinition<"crtr.view-picker.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.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.9" | "crtr.profile.menu.slot.8" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.6">)[], 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.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>;
 export declare const SAFETY_REQUIREMENTS: readonly SafetyRequirement[];
 export {};

package/dist/core/keybindings/catalog.js

@@ -37,6 +37,8 @@ export const BINDING_CATALOG = Object.freeze([
     b('crtr.tmux.menu.file-review', 'Global tmux', 'Review a file', 'Open a line-anchored review of a file named in the transcript.', ['v'], 'tmux-menu-selector', ['tmux.menu']),
     b('crtr.tmux.menu.pin', 'Global tmux', 'Pin conversation', 'Pin or unpin this conversation in the canvas navigator.', ['shift+f'], 'tmux-menu-selector', ['tmux.menu']),
     b('crtr.tmux.menu.show', 'Global tmux', 'Show node', 'Open the focused node’s inspection menu.', ['s'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.view-settings', 'Global tmux', 'View settings', 'Open the viewer display-settings menu.', ['w'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.fold-tools', 'Global tmux', 'Fold finished tool calls', 'Fold every finished tool call in the transcript to its single call line.', ['f'], 'tmux-menu-selector', ['tmux.menu.view-settings']),
     b('crtr.tmux.menu.metadata', 'Global tmux', 'Show metadata', 'Show the focused node’s metadata dossier.', ['m'], 'tmux-menu-selector', ['tmux.menu.show']),
     b('crtr.tmux.menu.context', 'Global tmux', 'Browse context', 'Browse the focused node context.', ['c'], 'tmux-menu-selector', ['tmux.menu.show']),
     b('crtr.tmux.menu.providers', 'Global tmux', 'Open settings', 'Open the crouter settings panel.', ['p'], 'tmux-menu-selector', ['tmux.menu']),
@@ -118,8 +120,9 @@ export const BINDING_CATALOG = Object.freeze([
     b('crtr.view.inspector.section-prev', 'Views', 'Previous Inspector section', 'Move to the previous Inspector section.', ['shift+tab'], 'terminal', ['view.inspector']),
     b('crtr.view.inspector.page-down', 'Views', 'Page down Inspector', 'Scroll the Inspector detail body down.', ['ctrl+d', 'pagedown'], 'terminal', ['view.inspector']),
     b('crtr.view.inspector.page-up', 'Views', 'Page up Inspector', 'Scroll the Inspector detail body up.', ['ctrl+u', 'pageup'], 'terminal', ['view.inspector']),
-    b('crtr.view.inspector.toggle-detail', 'Views', 'Toggle cron detail', 'Expand or collapse the selected cron.', ['enter'], 'terminal', ['view.inspector']),
-    b('crtr.view.inspector.cancel-item', 'Views', 'Cancel cron', 'Arm cancellation for the selected cron.', ['x'], 'terminal', ['view.inspector']),
+    b('crtr.view.inspector.toggle-detail', 'Views', 'Toggle item detail', 'Expand or collapse the selected cron or background job.', ['enter'], 'terminal', ['view.inspector']),
+    b('crtr.view.inspector.cancel-item', 'Views', 'Cancel selected item', 'Arm cancellation for the selected cron, or stopping for the selected background job.', ['x'], 'terminal', ['view.inspector']),
+    b('crtr.view.inspector.open-log', 'Views', 'Open job log', 'Follow the selected background job’s log in a new tmux window.', ['o'], 'terminal', ['view.inspector']),
     b('crtr.view.inspector.confirm', 'Views', 'Confirm Inspector action', 'Confirm the armed Inspector action.', ['y'], 'terminal', ['view.inspector']),
     b('crtr.view.inspector.dismiss', 'Views', 'Dismiss Inspector action', 'Dismiss an Inspector confirmation or banner.', ['escape'], 'terminal', ['view.inspector'], 'dismiss-modal'),
     b('crtr.view.inspector.retarget', 'Views', 'Retarget Inspector', 'Inspect the selected cron anchor or creator node.', ['t'], 'terminal', ['view.inspector']),

package/dist/core/preview-registry.d.ts

@@ -9,6 +9,11 @@ export declare function suppressOutputForLeaf(helpName: string): boolean;
  *  abc`) don't prevent the match. */
 export declare function suppressOutputForPath(tokens: readonly string[]): boolean;
 export declare const HELP_ICON: string;
+/** Glyphs for the plain agent tools the attach viewer re-skins (render/tool-calls.ts).
+ *  Same registry as the crtr command icons so every Nerd Font codepoint the viewer
+ *  paints lives in one file: terminal for `bash`, file-text for `read`, floppy for
+ *  `write` (content committed to disk), pencil-square for `edit`. */
+export declare const TOOL_ICON: Readonly<Record<'bash' | 'read' | 'write' | 'edit', string>>;
 /** Resolve the Nerd Font glyph for a command's argv tokens: the longest
  *  matching LEAF_ICON_CP prefix, else the tokens[0] family glyph, else the
  *  generic ◆ fallback for an unmapped family. */

package/dist/core/preview-registry.js

@@ -53,6 +53,16 @@ export function suppressOutputForPath(tokens) {
  *  regardless of which command's help was requested. */
 const HELP_ICON_CP = 0xf059;
 export const HELP_ICON = String.fromCodePoint(HELP_ICON_CP);
+/** Glyphs for the plain agent tools the attach viewer re-skins (render/tool-calls.ts).
+ *  Same registry as the crtr command icons so every Nerd Font codepoint the viewer
+ *  paints lives in one file: terminal for `bash`, file-text for `read`, floppy for
+ *  `write` (content committed to disk), pencil-square for `edit`. */
+export const TOOL_ICON = {
+    bash: String.fromCodePoint(0xf120),
+    read: String.fromCodePoint(0xf15c),
+    write: String.fromCodePoint(0xf0c7),
+    edit: String.fromCodePoint(0xf044),
+};
 /** One glyph per root subtree (`crtr <family> ...`) — the fallback for any
  *  leaf not listed in LEAF_ICON_CP below. Codepoints are Nerd Font
  *  private-use-area icons chosen per family concept (see command-icons.md). */

package/dist/core/runtime/canvas-extensions.d.ts

@@ -7,6 +7,10 @@ export declare const CANVAS_CONTEXT_INTRO_PATH: string;
 export declare const CANVAS_DOC_SUBSTRATE_PATH: string;
 export declare const CANVAS_STRUCTURED_OUTPUT_PATH: string;
 export declare const CANVAS_BASH_VALVE_PATH: string;
+/** NOT a canvas extension — loaded only by the headless namer subprocess
+ *  (`runtime/naming.ts`) to give it a constrained-schema `name_session` tool.
+ *  Deliberately absent from CANVAS_EXTENSIONS: a node must never carry it. */
+export declare const NAMING_TOOL_PATH: string;
 /** 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. */
 export declare const CANVAS_EXTENSIONS: string[];

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

@@ -19,6 +19,10 @@ export const CANVAS_CONTEXT_INTRO_PATH = resolveExtension('canvas-context-intro'
 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');
+/** NOT a canvas extension — loaded only by the headless namer subprocess
+ *  (`runtime/naming.ts`) to give it a constrained-schema `name_session` tool.
+ *  Deliberately absent from CANVAS_EXTENSIONS: a node must never carry it. */
+export const NAMING_TOOL_PATH = resolveExtension('naming-tool');
 /** 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. */
 export const CANVAS_EXTENSIONS = [

package/dist/core/runtime/naming-persist.d.ts

@@ -1,8 +1,9 @@
 import type { NodeMeta } from '../canvas/index.js';
 /** Asynchronously generate a name for `prompt` and persist it to the node's
- *  meta as `description` — only if the node has none yet (so a later message
- *  never clobbers it). Non-blocking: safe to call from inside a live pi event
- *  loop. Best-effort; swallows all errors.
+ *  meta as `description` + `icon` — only if the node has none yet (so a later
+ *  message never clobbers it). Non-blocking: safe to call from inside a live pi
+ *  event loop. Best-effort; swallows all errors. The slug fallback carries no
+ *  icon: a locally derived name has no judgment behind it to pick a glyph from.
  *
  *  `onNamed` (optional) fires with the freshly-persisted meta the moment the
  *  name lands — the canvas-goal-capture naming hook passes a callback that calls

package/dist/core/runtime/naming-persist.js

@@ -8,9 +8,10 @@
 import { headlessName, sanitizeSessionName, slugFromPrompt } from './naming.js';
 import { getNode, updateNode } from '../canvas/index.js';
 /** Asynchronously generate a name for `prompt` and persist it to the node's
- *  meta as `description` — only if the node has none yet (so a later message
- *  never clobbers it). Non-blocking: safe to call from inside a live pi event
- *  loop. Best-effort; swallows all errors.
+ *  meta as `description` + `icon` — only if the node has none yet (so a later
+ *  message never clobbers it). Non-blocking: safe to call from inside a live pi
+ *  event loop. Best-effort; swallows all errors. The slug fallback carries no
+ *  icon: a locally derived name has no judgment behind it to pick a glyph from.
  *
  *  `onNamed` (optional) fires with the freshly-persisted meta the moment the
  *  name lands — the canvas-goal-capture naming hook passes a callback that calls
@@ -20,22 +21,22 @@ export function generateAndPersistName(nodeId, prompt, onNamed) {
     const body = (prompt ?? '').trim();
     if (body === '')
         return;
-    const persist = (name) => {
+    const persist = (generated) => {
         try {
             const meta = getNode(nodeId);
             if (meta === null)
                 return;
             if ((meta.description ?? '').trim() !== '')
                 return; // already named
-            const clean = sanitizeSessionName(name);
-            const updated = updateNode(nodeId, { description: clean !== '' ? clean : slugFromPrompt(body) });
+            const clean = sanitizeSessionName(generated.name);
+            const description = clean !== '' ? clean : slugFromPrompt(body);
+            const icon = generated.icon.trim();
+            const updated = updateNode(nodeId, { description, ...(icon !== '' ? { icon } : {}) });
             onNamed?.(updated);
         }
         catch {
             // best-effort
         }
     };
-    void headlessName(body).then((name) => {
-        persist(name !== '' ? name : slugFromPrompt(body));
-    });
+    void headlessName(body).then(persist);
 }

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

@@ -5,18 +5,38 @@ export declare function sanitizeSessionName(raw: string): string;
 /** Local fallback: derive a name straight from the prompt (no pi call). Drops
  *  stop-words, takes the first few content words. */
 export declare function slugFromPrompt(prompt: string): string;
-/** Ask pi headlessly for a kebab-case name for `body`, async. Resolves to the
- *  sanitized name, or '' on any failure (non-zero exit, timeout, empty/garbled
- *  output) so the caller can fall back to a local slug. Owns the subprocess
- *  mechanics — crucially it hands pi an immediate stdin EOF: `pi -p` reads
- *  stdin, and execFile's default stdin is an OPEN pipe that never closes, so
- *  without this pi blocks waiting for EOF and the call exits non-zero (the
- *  regression that silently lost every LLM name to the slug fallback).
+/** A generated session name: the kebab-case handle plus the Nerd Font glyph the
+ *  namer chose for it. `icon` is '' when the model returned nothing usable —
+ *  every surface renders the name alone in that case. */
+export interface SessionName {
+    name: string;
+    icon: string;
+}
+/** Normalize a model-supplied icon to a single renderable glyph, or '' when
+ *  nothing usable came back.
+ *
+ *  The model is asked for a `U+XXXX` codepoint rather than the literal
+ *  character: Nerd Font glyphs sit in the private-use areas, which models
+ *  reproduce unreliably as literal text (they tend to substitute an emoji), but
+ *  name accurately as codepoints. A literal glyph is still accepted — including
+ *  an emoji, which renders fine even if it is not the house style — so a model
+ *  that ignores the format still contributes. Rejects a spelled-out
+ *  `nf-fa-bug`, a bare ASCII letter, and anything multi-glyph, all of which
+ *  would render as noise or tofu in a label. */
+export declare function sanitizeIcon(raw: string): string;
+/** Ask pi headlessly for a structured {name, icon} for `body`, async. Resolves
+ *  to a sanitized SessionName, or `{name:'',icon:''}` on any failure (non-zero
+ *  exit, timeout, no tool call, garbled emission) so the caller can fall back to
+ *  a local slug. Owns the subprocess mechanics — crucially it hands pi an
+ *  immediate stdin EOF: `pi -p` reads stdin, and execFile's default stdin is an
+ *  OPEN pipe that never closes, so without this pi blocks waiting for EOF and
+ *  the call exits non-zero (the regression that silently lost every LLM name to
+ *  the slug fallback).
  *
  *  Exported (not just for tests): the canvas-coupled persistence wrapper
  *  generateAndPersistName lives in naming-persist.ts to keep this module
  *  canvas-free, and imports this pure helper. */
-export declare function headlessName(body: string): Promise<string>;
+export declare function headlessName(body: string): Promise<SessionName>;
 /** A filesystem-safe slug for the `.todos/<slug>.md` fallback path: lowercase,
  *  [a-z0-9] kept, everything else → single hyphen, clamped to 8 words. */
 export declare function titleSlug(title: string): string;