@north-light/crouter 0.3.154

package/dist/core/keybindings/background-bash.d.ts

@@ -0,0 +1,13 @@
+import type { BindingId } from './catalog.js';
+import type { BindingResolution } from './types.js';
+/** The Alt+C -> b gesture pair for the background-bash tmux menu item, e.g.
+ *  `Alt+C b`. Null when either the menu-open gesture or the background-bash
+ *  selector is disabled (no bindings) — there is no fallback rendering for a
+ *  disabled binding. Bindings default to the user's resolved config; callers
+ *  holding a live snapshot (e.g. the attach viewer) pass it so a `/reload`
+ *  rebind is honored. */
+export declare function backgroundBashShortcut(bindings?: BindingResolution<BindingId>): string | null;
+/** Footer hint for the background-bash gesture: "<shortcut> to background", or
+ *  null when disabled. No CLI fallback — the tmux gesture is the only way to
+ *  invoke this handoff. */
+export declare function backgroundBashHint(bindings?: BindingResolution<BindingId>): string | null;

package/dist/core/keybindings/background-bash.js

@@ -0,0 +1,34 @@
+import { formatGesture } from './match.js';
+import { resolveUserKeybindings } from './resolve.js';
+const MENU_OPEN = 'crtr.tmux.menu.open';
+const BACKGROUND_BASH = 'crtr.tmux.menu.background-bash';
+/** The tmux menu's own shift-aware selector rendering (bare key -> itself,
+ *  shift+letter -> uppercase, shift+space -> a literal space) — duplicated
+ *  from the private `menuSelector` in `runtime/tmux.ts` rather than imported,
+ *  since tmux.ts already pulls this module in transitively via
+ *  `keybindings/index.ts` and importing back would cycle. */
+function selectorLabel(stroke) {
+    const parts = stroke.split('+');
+    const key = parts.at(-1);
+    return parts.includes('shift') && /[a-z]/.test(key) ? key.toUpperCase() : key === 'space' ? ' ' : key;
+}
+/** The Alt+C -> b gesture pair for the background-bash tmux menu item, e.g.
+ *  `Alt+C b`. Null when either the menu-open gesture or the background-bash
+ *  selector is disabled (no bindings) — there is no fallback rendering for a
+ *  disabled binding. Bindings default to the user's resolved config; callers
+ *  holding a live snapshot (e.g. the attach viewer) pass it so a `/reload`
+ *  rebind is honored. */
+export function backgroundBashShortcut(bindings = resolveUserKeybindings()) {
+    const menuOpen = bindings.gestures(MENU_OPEN);
+    const selector = bindings.gestures(BACKGROUND_BASH);
+    if (menuOpen.length === 0 || selector.length === 0)
+        return null;
+    return `${menuOpen.map(formatGesture).join(' / ')} ${selectorLabel(selector[0])}`;
+}
+/** Footer hint for the background-bash gesture: "<shortcut> to background", or
+ *  null when disabled. No CLI fallback — the tmux gesture is the only way to
+ *  invoke this handoff. */
+export function backgroundBashHint(bindings) {
+    const shortcut = backgroundBashShortcut(bindings);
+    return shortcut !== null ? `${shortcut} to background` : null;
+}

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

@@ -0,0 +1,15 @@
+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 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'>;
+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';
+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';
+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 declare const BINDING_IDS: ReadonlySet<string>;
+export declare const SAFETY_REQUIREMENTS: readonly SafetyRequirement[];
+export {};

package/dist/core/keybindings/catalog.js

@@ -0,0 +1,285 @@
+function binding(id, group, name, description, defaults, inputKind, contexts, safety) {
+    return Object.freeze({
+        id,
+        group,
+        name,
+        description,
+        defaults: Object.freeze([...defaults]),
+        inputKind,
+        contexts: Object.freeze([...contexts]),
+        ...(safety === undefined ? {} : { safety }),
+    });
+}
+const b = binding;
+const ATTACH_CONTEXTS = ['attach', 'graph', 'graph.confirm'];
+const VIEW_CONTEXTS = [
+    'view.canvas', 'view.chat', 'view.git-pr',
+    'view.inbox.list', 'view.inbox.compose', 'view.inbox.react',
+    'view.linkedin.list', 'view.linkedin.compose', 'view.linkedin.react',
+    'view.prompt-review',
+    'view.workspace-sidebar',
+    'view.inspector',
+];
+const SETUP_CANCEL_CONTEXTS = [
+    'setup.login', 'setup.list', 'setup.input', 'setup.keybindings',
+    'setup.keybindings.edit', 'setup.keybindings.filter', 'setup.models',
+];
+const SETUP_TAB_CONTEXTS = ['setup.login', 'setup.list', 'setup.keybindings', 'setup.models'];
+export const BINDING_CATALOG = Object.freeze([
+    b('crtr.tmux.menu.open', 'Global tmux', 'Open crouter menu', 'Open the crouter action menu.', ['alt+c'], 'host-global', ['tmux.root']),
+    b('crtr.tmux.menu.promote', 'Global tmux', 'Promote node', 'Promote the focused node to orchestrator.', ['o'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.resume', 'Global tmux', 'Resume node', 'Open the node resume picker.', ['r'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.fork', 'Global tmux', 'Fork node', 'Fork the focused node into an independent idle root.', ['f'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.demote', 'Global tmux', 'Demote node', 'Demote the focused node to terminal.', ['d'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.detach', 'Global tmux', 'Detach node', 'Detach the focused node to the background.', ['shift+d'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.close-subtree', 'Global tmux', 'Close subtree', 'Close the focused node and its subtree.', ['x'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.background-bash', 'Global tmux', 'Background bash', 'Hand the focused node’s running bash command to its background job system.', ['b'], 'tmux-menu-selector', ['tmux.menu']),
+    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.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']),
+    b('crtr.tmux.menu.graph', 'Global tmux', 'Open graph', 'Open the canvas graph.', ['g'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.focus-manager', 'Global tmux', 'Focus manager', 'Focus the node manager.', ['m'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.copy-id', 'Global tmux', 'Copy node id', 'Copy the focused node id to the system clipboard.', ['y'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.reload-viewer', 'Global tmux', 'Reload viewer', 'Respawn this pane’s viewer onto the current runtime generation.', ['l'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.issues', 'Global tmux', 'Open issue menu', 'Open the issue type submenu.', ['i'], 'tmux-menu-selector', ['tmux.menu']),
+    b('crtr.tmux.menu.issue.idea', 'Global tmux', 'Create idea', 'Create an idea issue.', ['i'], 'tmux-menu-selector', ['tmux.menu.issue']),
+    b('crtr.tmux.menu.issue.bug', 'Global tmux', 'Create bug', 'Create a bug issue.', ['b'], 'tmux-menu-selector', ['tmux.menu.issue']),
+    b('crtr.tmux.node.next', 'Global tmux', 'Next node', 'Focus the next canvas node.', ['alt+]'], 'host-global', ['tmux.root']),
+    b('crtr.tmux.node.previous', 'Global tmux', 'Previous node', 'Focus the previous canvas node.', ['alt+['], 'host-global', ['tmux.root']),
+    b('crtr.tmux.inbox.toggle', 'Global tmux', 'Toggle inbox', 'Open or close the human inbox popup.', ['alt+i'], 'host-global', ['tmux.root']),
+    b('crtr.tmux.view.next', 'Global tmux', 'Next view', 'Focus the next view.', ['alt+v > ]'], 'tmux-sequence', ['tmux.root']),
+    b('crtr.tmux.view.previous', 'Global tmux', 'Previous view', 'Focus the previous view.', ['alt+v > ['], 'tmux-sequence', ['tmux.root']),
+    b('crtr.attach.detach', 'Attach', 'Detach', 'Detach from the node.', ['ctrl+d'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.attach.clear-or-detach', 'Attach', 'Clear or detach', 'Clear input or detach when input is empty.', ['ctrl+c'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.attach.graph.toggle', 'Attach', 'Toggle graph', 'Open or close the graph overlay.', ['alt+g'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.attach.model-ladder.next', 'Attach', 'Next model ladder', 'Move to the next model ladder rung.', ['alt+m'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.attach.model-ladder.previous', 'Attach', 'Previous model ladder', 'Move to the previous model ladder rung.', ['alt+shift+m'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.attach.command.inspect', 'Attach', 'Inspect loaded command', 'Open the loaded slash command’s expanded prompt.', ['alt+shift+h'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.attach.file-review', 'Attach', 'Review a file', 'Open a line-anchored review of a file named in the transcript.', ['alt+shift+r'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.mode.cycle', 'Attach', 'Cycle mode', 'Cycle the active agent mode.', ['alt+shift+p'], 'host-global', ATTACH_CONTEXTS),
+    b('crtr.graph.down', 'GRAPH', 'Move down', 'Move to the next graph row.', ['j'], 'terminal', ['graph']),
+    b('crtr.graph.up', 'GRAPH', 'Move up', 'Move to the previous graph row.', ['k'], 'terminal', ['graph']),
+    b('crtr.graph.first', 'GRAPH', 'First row', 'Move to the first graph row.', ['g'], 'terminal', ['graph']),
+    b('crtr.graph.last', 'GRAPH', 'Last row', 'Move to the last graph row.', ['shift+g'], 'terminal', ['graph']),
+    b('crtr.graph.collapse-or-manager', 'GRAPH', 'Collapse or manager', 'Collapse a node or move to its manager.', ['h'], 'terminal', ['graph']),
+    b('crtr.graph.expand-or-child', 'GRAPH', 'Expand or child', 'Expand a node or move to its child.', ['l'], 'terminal', ['graph']),
+    b('crtr.graph.focus', 'GRAPH', 'Focus node', 'Focus the selected node.', ['enter'], 'terminal', ['graph']),
+    b('crtr.graph.revive', 'GRAPH', 'Revive node', 'Revive and open the selected dormant node.', ['r'], 'terminal', ['graph']),
+    b('crtr.graph.focus-manager', 'GRAPH', 'Focus manager', 'Focus the selected node manager.', ['m'], 'terminal', ['graph']),
+    b('crtr.graph.close-subtree', 'GRAPH', 'Close subtree', 'Ask to close the selected subtree.', ['x'], 'terminal', ['graph']),
+    b('crtr.graph.dismiss', 'GRAPH', 'Dismiss graph', 'Close the graph overlay.', ['escape'], 'terminal', ['graph'], 'dismiss-modal'),
+    b('crtr.graph.confirm.accept', 'GRAPH', 'Confirm close', 'Confirm closing the selected subtree.', ['y'], 'terminal', ['graph.confirm']),
+    b('crtr.graph.confirm.cancel', 'GRAPH', 'Cancel close', 'Cancel closing the selected subtree.', ['n', 'escape'], 'terminal', ['graph.confirm'], 'dismiss-modal'),
+    b('crtr.view.host.force-quit', 'Views', 'Force quit view', 'Immediately leave a hosted view.', ['ctrl+c'], 'host-global', VIEW_CONTEXTS, 'leave-screen'),
+    b('crtr.view.host.editor.backspace', 'Views', 'Delete captured text', 'Delete the previous captured character.', ['backspace'], 'host-global', ['view.chat', 'view.inbox.compose', 'view.linkedin.compose']),
+    ...viewNavigation('canvas', 'Canvas view'),
+    b('crtr.view.chat.submit', 'Views', 'Submit chat', 'Submit the current chat input.', ['enter'], 'terminal', ['view.chat']),
+    b('crtr.view.chat.contextual-cancel', 'Views', 'Cancel chat action', 'Cancel the active chat action.', ['escape'], 'terminal', ['view.chat']),
+    b('crtr.view.chat.reconnect', 'Views', 'Reconnect chat', 'Reconnect the chat stream.', ['r'], 'terminal', ['view.chat']),
+    b('crtr.view.chat.quit', 'Views', 'Quit chat', 'Leave the chat view.', ['q'], 'terminal', ['view.chat'], 'leave-screen'),
+    ...viewNavigation('git-pr', 'Git PR view'),
+    ...listView('inbox', 'Inbox', [
+        ['open', 'Open item', 'Open the selected inbox item.', ['enter']],
+        ['reply', 'Reply', 'Reply to the selected inbox item.', ['r']],
+        ['react', 'React', 'React to the selected inbox item.', ['e']],
+        ['filter', 'Filter', 'Filter inbox items.', ['f']],
+        ['refresh', 'Refresh', 'Refresh inbox items.', ['g']],
+        ['connect-linkedin', 'Connect LinkedIn', 'Connect the LinkedIn inbox.', ['shift+l']],
+        ['connect-gmail', 'Connect Gmail', 'Connect the Gmail inbox.', ['shift+g']],
+    ]),
+    ...composeAndReact('inbox', 'Inbox'),
+    ...listView('linkedin', 'LinkedIn', [
+        ['open', 'Open item', 'Open the selected LinkedIn item.', ['enter']],
+        ['reply', 'Reply', 'Reply to the selected LinkedIn item.', ['r']],
+        ['react', 'React', 'React to the selected LinkedIn item.', ['e']],
+        ['refresh', 'Refresh', 'Refresh LinkedIn items.', ['g']],
+    ]),
+    ...composeAndReact('linkedin', 'LinkedIn'),
+    b('crtr.view.prompt-review.down', 'Views', 'Move down', 'Move to the next prompt review row.', ['j', 'down'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.up', 'Views', 'Move up', 'Move to the previous prompt review row.', ['k', 'up'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.compare-previous', 'Views', 'Previous comparison', 'Select the previous comparison.', ['h', 'left'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.compare-next', 'Views', 'Next comparison', 'Select the next comparison.', ['l', 'right'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.toggle-mode', 'Views', 'Toggle mode', 'Toggle the prompt review mode.', ['tab'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.expand', 'Views', 'Expand', 'Expand the selected prompt review.', ['enter'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.export', 'Views', 'Export', 'Export the prompt review.', ['e'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.refresh', 'Views', 'Refresh', 'Refresh the prompt review.', ['g'], 'terminal', ['view.prompt-review']),
+    b('crtr.view.prompt-review.quit', 'Views', 'Quit', 'Leave the prompt review.', ['q'], 'terminal', ['view.prompt-review'], 'leave-screen'),
+    b('crtr.view.workspace-sidebar.down', 'Views', 'Move down', 'Move to the next workspace.', ['j', 'down'], 'terminal', ['view.workspace-sidebar']),
+    b('crtr.view.workspace-sidebar.up', 'Views', 'Move up', 'Move to the previous workspace.', ['k', 'up'], 'terminal', ['view.workspace-sidebar']),
+    b('crtr.view.workspace-sidebar.open', 'Views', 'Open workspace', 'Open the selected workspace.', ['enter'], 'terminal', ['view.workspace-sidebar']),
+    b('crtr.view.workspace-sidebar.refresh', 'Views', 'Refresh', 'Refresh workspaces.', ['g', 'r'], 'terminal', ['view.workspace-sidebar']),
+    b('crtr.view.workspace-sidebar.quit', 'Views', 'Quit', 'Leave the workspace sidebar.', ['q'], 'terminal', ['view.workspace-sidebar'], 'leave-screen'),
+    b('crtr.view.inspector.down', 'Views', 'Move down', 'Move the Inspector selection or scroll cursor down.', ['j', 'down'], 'terminal', ['view.inspector']),
+    b('crtr.view.inspector.up', 'Views', 'Move up', 'Move the Inspector selection or scroll cursor up.', ['k', 'up'], 'terminal', ['view.inspector']),
+    b('crtr.view.inspector.section-next', 'Views', 'Next Inspector section', 'Move to the next Inspector section.', ['tab'], 'terminal', ['view.inspector']),
+    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.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']),
+    b('crtr.view.inspector.refresh', 'Views', 'Refresh Inspector', 'Refresh the Inspector now.', ['g', 'r'], 'terminal', ['view.inspector']),
+    b('crtr.view.inspector.quit', 'Views', 'Quit Inspector', 'Leave the Inspector.', ['q'], 'terminal', ['view.inspector'], 'leave-screen'),
+    b('crtr.view-picker.down', 'Browse and pickers', 'Move down', 'Move to the next view.', ['j', 'down'], 'terminal', ['view-picker']),
+    b('crtr.view-picker.up', 'Browse and pickers', 'Move up', 'Move to the previous view.', ['k', 'up'], 'terminal', ['view-picker']),
+    b('crtr.view-picker.run', 'Browse and pickers', 'Run view', 'Run the selected view.', ['enter'], 'terminal', ['view-picker']),
+    b('crtr.view-picker.quit', 'Browse and pickers', 'Quit picker', 'Leave the view picker.', ['q', 'escape', 'ctrl+c'], 'terminal', ['view-picker'], 'leave-screen'),
+    ...browseBindings(),
+    ...profileBindings(),
+    ...setupBindings(),
+]);
+function viewNavigation(id, label) {
+    const context = `view.${id}`;
+    return [
+        b(`crtr.view.${id}.down`, 'Views', 'Move down', `Move to the next ${label.toLowerCase()} row.`, ['j', 'down'], 'terminal', [context]),
+        b(`crtr.view.${id}.up`, 'Views', 'Move up', `Move to the previous ${label.toLowerCase()} row.`, ['k', 'up'], 'terminal', [context]),
+        b(`crtr.view.${id}.refresh`, 'Views', 'Refresh', `Refresh the ${label.toLowerCase()}.`, ['g'], 'terminal', [context]),
+        b(`crtr.view.${id}.quit`, 'Views', 'Quit', `Leave the ${label.toLowerCase()}.`, ['q'], 'terminal', [context], 'leave-screen'),
+    ];
+}
+function listView(id, label, actions) {
+    const context = `view.${id}.list`;
+    return [
+        b(`crtr.view.${id}.down`, 'Views', 'Move down', `Move to the next ${label} item.`, ['j', 'down'], 'terminal', [context]),
+        b(`crtr.view.${id}.up`, 'Views', 'Move up', `Move to the previous ${label} item.`, ['k', 'up'], 'terminal', [context]),
+        ...actions.map(([action, name, description, defaults]) => b(`crtr.view.${id}.${action}`, 'Views', name, description, defaults, 'terminal', [context])),
+        b(`crtr.view.${id}.quit`, 'Views', 'Quit', `Leave ${label}.`, ['q'], 'terminal', [context], 'leave-screen'),
+    ];
+}
+function composeAndReact(id, label) {
+    return [
+        b(`crtr.view.${id}.submit-reply`, 'Views', 'Submit reply', `Submit the ${label} reply.`, ['enter'], 'terminal', [`view.${id}.compose`]),
+        b(`crtr.view.${id}.cancel`, 'Views', 'Cancel', `Cancel ${label} composition or reaction.`, ['escape'], 'terminal', [`view.${id}.compose`, `view.${id}.react`], 'dismiss-modal'),
+        b(`crtr.view.${id}.reaction-previous`, 'Views', 'Previous reaction', 'Select the previous reaction.', id === 'inbox' ? ['h', 'left'] : ['left', 'h'], 'terminal', [`view.${id}.react`]),
+        b(`crtr.view.${id}.reaction-next`, 'Views', 'Next reaction', 'Select the next reaction.', id === 'inbox' ? ['l', 'right'] : ['right', 'l'], 'terminal', [`view.${id}.react`]),
+        b(`crtr.view.${id}.submit-reaction`, 'Views', 'Submit reaction', `Submit the ${label} reaction.`, ['enter'], 'terminal', [`view.${id}.react`]),
+    ];
+}
+function browseBindings() {
+    const nav = 'browse';
+    return [
+        b('crtr.browse.quit', 'Browse and pickers', 'Quit browse', 'Leave canvas browse.', ['q', 'escape', 'ctrl+c'], 'terminal', [nav], 'leave-screen'),
+        b('crtr.browse.down', 'Browse and pickers', 'Move down', 'Move to the next row.', ['j', 'down'], 'terminal', [nav]),
+        b('crtr.browse.up', 'Browse and pickers', 'Move up', 'Move to the previous row.', ['k', 'up'], 'terminal', [nav]),
+        b('crtr.browse.first', 'Browse and pickers', 'First row', 'Move to the first row.', ['g'], 'terminal', [nav]),
+        b('crtr.browse.last', 'Browse and pickers', 'Last row', 'Move to the last row.', ['shift+g'], 'terminal', [nav]),
+        b('crtr.browse.expand-or-child', 'Browse and pickers', 'Expand or child', 'Expand a row or move to its child.', ['l', 'right'], 'terminal', [nav]),
+        b('crtr.browse.collapse-or-parent', 'Browse and pickers', 'Collapse or parent', 'Collapse a row or move to its parent.', ['h', 'left'], 'terminal', [nav]),
+        b('crtr.browse.toggle-fold', 'Browse and pickers', 'Toggle fold', 'Toggle the selected fold.', ['space'], 'terminal', [nav]),
+        b('crtr.browse.tab-next', 'Browse and pickers', 'Next tab', 'Select the next browse tab.', ['tab', ']'], 'terminal', [nav]),
+        b('crtr.browse.tab-previous', 'Browse and pickers', 'Previous tab', 'Select the previous browse tab.', ['shift+tab', '['], 'terminal', [nav]),
+        ...[1, 2, 3, 4, 5].map((slot) => b(`crtr.browse.tab.${slot}`, 'Browse and pickers', `Tab ${slot}`, `Select browse tab ${slot}.`, [`${slot}`], 'terminal', [nav])),
+        b('crtr.browse.close-subtree', 'Browse and pickers', 'Close subtree', 'Ask to close the selected subtree.', ['x'], 'terminal', [nav]),
+        b('crtr.browse.confirm-close', 'Browse and pickers', 'Confirm close', 'Confirm closing the selected subtree.', ['y'], 'terminal', ['browse.confirm']),
+        b('crtr.browse.sort', 'Browse and pickers', 'Change sort', 'Change the browse sort.', ['s'], 'terminal', [nav]),
+        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.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]),
+        b('crtr.browse.focus-background', 'Browse and pickers', 'Focus node (keep browsing)', 'Focus the selected node without leaving the navigator.', ['shift+o'], 'terminal', [nav]),
+        b('crtr.browse.search.cancel', 'Browse and pickers', 'Cancel search', 'Cancel browse search.', ['escape'], 'terminal', ['browse.search'], 'dismiss-modal'),
+        b('crtr.browse.search.commit', 'Browse and pickers', 'Commit search', 'Apply browse search.', ['enter'], 'terminal', ['browse.search']),
+        b('crtr.browse.search.delete', 'Browse and pickers', 'Delete search text', 'Delete the previous search character.', ['backspace'], 'terminal', ['browse.search']),
+        b('crtr.browse.search.quit', 'Browse and pickers', 'Quit browse', 'Leave canvas browse from search.', ['ctrl+c'], 'terminal', ['browse.search'], 'leave-screen'),
+    ];
+}
+function profileBindings() {
+    const menu = 'profile.menu';
+    const search = 'profile.search';
+    return [
+        b('crtr.profile.menu.up', 'Profiles', 'Move up', 'Move to the previous profile.', ['k', 'up'], 'terminal', [menu]),
+        b('crtr.profile.menu.down', 'Profiles', 'Move down', 'Move to the next profile.', ['j', 'down'], 'terminal', [menu]),
+        b('crtr.profile.menu.select', 'Profiles', 'Select profile', 'Select the highlighted profile.', ['enter'], 'terminal', [menu]),
+        b('crtr.profile.menu.accept-default', 'Profiles', 'Accept default', 'Accept the default profile.', ['escape'], 'terminal', [menu], 'leave-screen'),
+        b('crtr.profile.menu.abort', 'Profiles', 'Abort', 'Leave profile selection.', ['ctrl+c'], 'terminal', [menu], 'leave-screen'),
+        ...[1, 2, 3, 4, 5, 6, 7, 8, 9].map((slot) => b(`crtr.profile.menu.slot.${slot}`, 'Profiles', `Profile slot ${slot}`, `Select profile slot ${slot}.`, [`${slot}`], 'terminal', [menu])),
+        b('crtr.profile.menu.create', 'Profiles', 'Create profile', 'Create a profile.', ['c'], 'terminal', [menu]),
+        b('crtr.profile.menu.search-existing', 'Profiles', 'Search profiles', 'Search existing profiles.', ['s'], 'terminal', [menu]),
+        b('crtr.profile.menu.use-root', 'Profiles', 'Use root profile', 'Use the root profile.', ['r'], 'terminal', [menu]),
+        b('crtr.profile.menu.set-default', 'Profiles', 'Set default', 'Set the selected profile as default.', ['d'], 'terminal', [menu]),
+        b('crtr.profile.menu.add-directory', 'Profiles', 'Add directory', 'Add a directory to the profile.', ['a'], 'terminal', [menu]),
+        b('crtr.profile.menu.unpin', 'Profiles', 'Unpin directory', 'Unpin the selected directory.', ['u'], 'terminal', [menu]),
+        b('crtr.profile.search.up', 'Profiles', 'Move up', 'Move to the previous search result.', ['up', 'ctrl+p'], 'terminal', [search]),
+        b('crtr.profile.search.down', 'Profiles', 'Move down', 'Move to the next search result.', ['down', 'ctrl+n'], 'terminal', [search]),
+        b('crtr.profile.search.pick', 'Profiles', 'Pick profile', 'Pick the highlighted profile.', ['enter'], 'terminal', [search]),
+        b('crtr.profile.search.back', 'Profiles', 'Back', 'Return to profile selection.', ['escape'], 'terminal', [search], 'leave-screen'),
+        b('crtr.profile.search.delete', 'Profiles', 'Delete filter text', 'Delete the previous filter character.', ['backspace'], 'terminal', [search]),
+        b('crtr.profile.search.abort', 'Profiles', 'Abort', 'Leave profile search.', ['ctrl+c'], 'terminal', [search], 'leave-screen'),
+    ];
+}
+function setupBindings() {
+    return [
+        b('crtr.setup.cancel', 'Setup', 'Cancel setup', 'Leave the setup wizard.', ['q', 'ctrl+c', 'ctrl+d'], 'terminal', SETUP_CANCEL_CONTEXTS, 'leave-screen'),
+        b('crtr.setup.tab-next', 'Setup', 'Next tab', 'Select the next setup tab.', ['tab', 'right'], 'terminal', SETUP_TAB_CONTEXTS),
+        b('crtr.setup.tab-previous', 'Setup', 'Previous tab', 'Select the previous setup tab.', ['shift+tab', 'left'], 'terminal', SETUP_TAB_CONTEXTS),
+        b('crtr.setup.open', 'Setup', 'Open', 'Open the selected setup item.', ['enter'], 'terminal', ['setup.login']),
+        b('crtr.setup.list-down', 'Setup', 'Move down', 'Move to the next setup item.', ['j', 'down'], 'terminal', ['setup.list', 'setup.models', 'setup.models.dimension-picker']),
+        b('crtr.setup.list-up', 'Setup', 'Move up', 'Move to the previous setup item.', ['k', 'up'], 'terminal', ['setup.list', 'setup.models', 'setup.models.dimension-picker']),
+        b('crtr.setup.toggle', 'Setup', 'Toggle', 'Toggle the selected setup item.', ['space'], 'terminal', ['setup.list']),
+        b('crtr.setup.details', 'Setup', 'Show details', 'Show details for the selected item.', ['?'], 'terminal', ['setup.list']),
+        b('crtr.setup.advance', 'Setup', 'Advance', 'Advance the setup flow.', ['enter'], 'terminal', ['setup.list']),
+        b('crtr.setup.confirm.accept', 'Setup', 'Confirm', 'Accept the setup confirmation.', ['y', 'enter'], 'terminal', ['setup.confirm']),
+        b('crtr.setup.confirm.back', 'Setup', 'Go back', 'Cancel the setup confirmation.', ['n', 'escape', 'q'], 'terminal', ['setup.confirm'], 'dismiss-modal'),
+        b('crtr.setup.keybindings.edit', 'Setup', 'Edit binding', 'Edit the selected binding.', ['enter'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.commit-edit', 'Setup', 'Commit edit', 'Commit the active binding edit.', ['enter'], 'terminal', ['setup.keybindings.edit']),
+        b('crtr.setup.keybindings.cancel-edit', 'Setup', 'Cancel edit', 'Cancel the active binding edit.', ['escape'], 'terminal', ['setup.keybindings.edit'], 'dismiss-modal'),
+        b('crtr.setup.keybindings.unbind', 'Setup', 'Unbind', 'Disable the selected binding.', ['delete'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.reset-row', 'Setup', 'Reset binding', 'Reset the selected binding.', ['r'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.reset-all', 'Setup', 'Reset all bindings', 'Reset all bindings to defaults.', ['shift+r'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.save', 'Setup', 'Save bindings', 'Save keybinding changes.', ['s'], 'terminal', ['setup.keybindings'], 'save-keybindings'),
+        b('crtr.setup.keybindings.discard', 'Setup', 'Discard changes', 'Discard keybinding changes.', ['escape'], 'terminal', ['setup.keybindings'], 'leave-screen'),
+        b('crtr.setup.keybindings.page-up', 'Setup', 'Page up', 'Move up one keybinding page.', ['pageup'], 'terminal', ['setup.keybindings', 'setup.keybindings.edit']),
+        b('crtr.setup.keybindings.page-down', 'Setup', 'Page down', 'Move down one keybinding page.', ['pagedown'], 'terminal', ['setup.keybindings', 'setup.keybindings.edit']),
+        b('crtr.setup.keybindings.filter', 'Setup', 'Filter bindings', 'Open the keybinding filter.', ['/'], 'terminal', ['setup.keybindings']),
+        b('crtr.setup.keybindings.filter-delete', 'Setup', 'Delete filter text', 'Delete the previous filter character.', ['backspace'], 'terminal', ['setup.keybindings.filter']),
+        b('crtr.setup.keybindings.filter-clear', 'Setup', 'Clear filter', 'Clear the keybinding filter.', ['escape'], 'terminal', ['setup.keybindings.filter'], 'dismiss-modal'),
+        b('crtr.setup.cell-previous', 'Setup', 'Previous cell', 'Select the previous cell (strength-ladder provider column or a kind base/orchestrator provider/strength column).', ['h'], 'terminal', ['setup.models']),
+        b('crtr.setup.cell-next', 'Setup', 'Next cell', 'Select the next cell (strength-ladder provider column or a kind base/orchestrator provider/strength column).', ['l'], 'terminal', ['setup.models']),
+        b('crtr.setup.models.open', 'Setup', 'Edit model', 'Edit the selected model cell.', ['enter'], 'terminal', ['setup.models']),
+        b('crtr.setup.models.scope-next', 'Setup', 'Next model config scope', 'Edit the next applicable user, profile, or project config.', ['s'], 'terminal', ['setup.models']),
+        b('crtr.setup.models.commit', 'Setup', 'Commit pick', 'Commit the provider, strength, model, or thinking-level pick.', ['enter'], 'terminal', ['setup.models.picker', 'setup.models.dimension-picker']),
+        b('crtr.setup.models.cancel', 'Setup', 'Cancel pick', 'Cancel the provider, strength, model, or thinking-level picker.', ['escape'], 'terminal', ['setup.models.picker', 'setup.models.dimension-picker'], 'dismiss-modal'),
+    ];
+}
+export const BINDING_IDS = new Set(BINDING_CATALOG.map((definition) => definition.id));
+export const SAFETY_REQUIREMENTS = Object.freeze([
+    { context: 'graph', capability: 'dismiss-modal' },
+    { context: 'graph.confirm', capability: 'dismiss-modal' },
+    { context: 'view.canvas', capability: 'leave-screen' },
+    { context: 'view.chat', capability: 'leave-screen' },
+    { context: 'view.git-pr', capability: 'leave-screen' },
+    { context: 'view.inbox.list', capability: 'leave-screen' },
+    { context: 'view.inbox.compose', capability: 'dismiss-modal' },
+    { context: 'view.inbox.react', capability: 'dismiss-modal' },
+    { context: 'view.linkedin.list', capability: 'leave-screen' },
+    { context: 'view.linkedin.compose', capability: 'dismiss-modal' },
+    { context: 'view.linkedin.react', capability: 'dismiss-modal' },
+    { context: 'view.prompt-review', capability: 'leave-screen' },
+    { context: 'view.workspace-sidebar', capability: 'leave-screen' },
+    { context: 'view.inspector', capability: 'leave-screen' },
+    { context: 'view.inspector', capability: 'dismiss-modal' },
+    { context: 'view-picker', capability: 'leave-screen' },
+    { context: 'browse', capability: 'leave-screen' },
+    { context: 'browse.search', capability: 'dismiss-modal' },
+    { context: 'profile.menu', capability: 'leave-screen' },
+    { context: 'profile.search', capability: 'leave-screen' },
+    { context: 'setup.login', capability: 'leave-screen' },
+    { context: 'setup.list', capability: 'leave-screen' },
+    { context: 'setup.input', capability: 'leave-screen' },
+    { context: 'setup.confirm', capability: 'dismiss-modal' },
+    { context: 'setup.keybindings', capability: 'leave-screen' },
+    { context: 'setup.keybindings', capability: 'save-keybindings' },
+    { context: 'setup.keybindings.edit', capability: 'dismiss-modal' },
+    { context: 'setup.keybindings.filter', capability: 'dismiss-modal' },
+    { context: 'setup.models', capability: 'leave-screen' },
+    { context: 'setup.models.picker', capability: 'dismiss-modal' },
+    { context: 'setup.models.dimension-picker', capability: 'dismiss-modal' },
+]);

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

@@ -0,0 +1,21 @@
+import type { BindingId } from './catalog.js';
+import type { BindingResolution } from './types.js';
+/** The single source of truth for how every pending-interaction surface names
+ *  the inbox shortcut. Resolves the live `crtr.tmux.inbox.toggle` gestures and
+ *  returns the formatted label(s) — joined with ' / ' when multiple, matching
+ *  crouter's `formatBinding` convention — or null when the binding is disabled.
+ *  Bindings default to the user's resolved config so a bare call reflects
+ *  current state; callers holding a live snapshot (e.g. the attach viewer) pass
+ *  it so a `/reload` rebind is honored. */
+export declare function inboxShortcut(bindings?: BindingResolution<BindingId>): string | null;
+/** Closed-inbox footer affordance: "<shortcut> inbox", or the CLI fallback
+ *  `hl inbox open` when the binding is disabled. */
+export declare function inboxOpenHint(bindings?: BindingResolution<BindingId>): string;
+/** Bare token naming the inbox affordance for a parenthetical — the resolved
+ *  shortcut (e.g. `Alt+I`), or the backtick-quoted CLI form when disabled. Use
+ *  where prose reads "the inbox popup (<hint>)". */
+export declare function inboxPopupHint(bindings?: BindingResolution<BindingId>): string;
+/** Imperative clause telling the human how to open the inbox — "press
+ *  <shortcut> (or run `hl inbox open` at a terminal)", or just the CLI form
+ *  when the binding is disabled. */
+export declare function inboxOpenInstruction(bindings?: BindingResolution<BindingId>): string;

package/dist/core/keybindings/inbox.js

@@ -0,0 +1,35 @@
+import { formatGesture } from './match.js';
+import { resolveUserKeybindings } from './resolve.js';
+const INBOX_TOGGLE = 'crtr.tmux.inbox.toggle';
+/** The single source of truth for how every pending-interaction surface names
+ *  the inbox shortcut. Resolves the live `crtr.tmux.inbox.toggle` gestures and
+ *  returns the formatted label(s) — joined with ' / ' when multiple, matching
+ *  crouter's `formatBinding` convention — or null when the binding is disabled.
+ *  Bindings default to the user's resolved config so a bare call reflects
+ *  current state; callers holding a live snapshot (e.g. the attach viewer) pass
+ *  it so a `/reload` rebind is honored. */
+export function inboxShortcut(bindings = resolveUserKeybindings()) {
+    const gestures = bindings.gestures(INBOX_TOGGLE);
+    return gestures.length > 0 ? gestures.map(formatGesture).join(' / ') : null;
+}
+/** Closed-inbox footer affordance: "<shortcut> inbox", or the CLI fallback
+ *  `hl inbox open` when the binding is disabled. */
+export function inboxOpenHint(bindings) {
+    const shortcut = inboxShortcut(bindings);
+    return shortcut !== null ? `${shortcut} inbox` : 'hl inbox open';
+}
+/** Bare token naming the inbox affordance for a parenthetical — the resolved
+ *  shortcut (e.g. `Alt+I`), or the backtick-quoted CLI form when disabled. Use
+ *  where prose reads "the inbox popup (<hint>)". */
+export function inboxPopupHint(bindings) {
+    return inboxShortcut(bindings) ?? '`hl inbox open`';
+}
+/** Imperative clause telling the human how to open the inbox — "press
+ *  <shortcut> (or run `hl inbox open` at a terminal)", or just the CLI form
+ *  when the binding is disabled. */
+export function inboxOpenInstruction(bindings) {
+    const shortcut = inboxShortcut(bindings);
+    return shortcut !== null
+        ? `press ${shortcut} (or run \`hl inbox open\` at a terminal)`
+        : 'run `hl inbox open` at a terminal';
+}

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

@@ -0,0 +1,7 @@
+export { BINDING_CATALOG, BINDING_IDS, SAFETY_REQUIREMENTS, type BindingId, } from './catalog.js';
+export { GestureSyntaxError, KeybindingValidationError, normalizeGesture, normalizeSparseOverrides, normalizeStroke, resolveKeybindings, resolveUserKeybindings, splitGestureExpression, } from './resolve.js';
+export { canonicalTerminalStroke, formatBinding, formatGesture, formatStroke, matchesPiTuiInput, matchesTerminalInput, type PiTuiMatcher, type RawTerminalInput, } from './match.js';
+export { inboxOpenHint, inboxOpenInstruction, inboxPopupHint, inboxShortcut, } from './inbox.js';
+export { backgroundBashHint, backgroundBashShortcut, } from './background-bash.js';
+export { KeybindingConcurrentEditError, persistUserKeybindings, type PersistedKeybindings, type PersistKeybindingsOptions, } from './persistence.js';
+export type { BindingDefinition, BindingInputKind, BindingResolution, BindingSafetyCapability, EffectiveBinding, KeybindingDiagnostic, KeybindingDiagnosticCode, SafetyRequirement, SparseKeybindingOverrides, } from './types.js';

package/dist/core/keybindings/index.js

@@ -0,0 +1,6 @@
+export { BINDING_CATALOG, BINDING_IDS, SAFETY_REQUIREMENTS, } from './catalog.js';
+export { GestureSyntaxError, KeybindingValidationError, normalizeGesture, normalizeSparseOverrides, normalizeStroke, resolveKeybindings, resolveUserKeybindings, splitGestureExpression, } from './resolve.js';
+export { canonicalTerminalStroke, formatBinding, formatGesture, formatStroke, matchesPiTuiInput, matchesTerminalInput, } from './match.js';
+export { inboxOpenHint, inboxOpenInstruction, inboxPopupHint, inboxShortcut, } from './inbox.js';
+export { backgroundBashHint, backgroundBashShortcut, } from './background-bash.js';
+export { KeybindingConcurrentEditError, persistUserKeybindings, } from './persistence.js';

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

@@ -0,0 +1,29 @@
+import type { BindingId } from './catalog.js';
+import type { BindingResolution } from './types.js';
+export declare function formatStroke(stroke: string): string;
+export declare function formatGesture(gesture: string): string;
+export declare function formatBinding(bindingSet: BindingResolution<BindingId>, id: BindingId): string;
+export interface RawTerminalInput {
+    readonly input?: string;
+    readonly upArrow?: boolean;
+    readonly downArrow?: boolean;
+    readonly leftArrow?: boolean;
+    readonly rightArrow?: boolean;
+    readonly return?: boolean;
+    readonly escape?: boolean;
+    readonly ctrl?: boolean;
+    readonly meta?: boolean;
+    readonly shift?: boolean;
+    readonly tab?: boolean;
+    readonly shiftTab?: boolean;
+    readonly backspace?: boolean;
+    readonly delete?: boolean;
+    readonly pageUp?: boolean;
+    readonly pageDown?: boolean;
+    readonly home?: boolean;
+    readonly end?: boolean;
+}
+export declare function canonicalTerminalStroke(raw: RawTerminalInput): string | null;
+export declare function matchesTerminalInput(bindingSet: BindingResolution<BindingId>, id: BindingId, raw: RawTerminalInput): boolean;
+export type PiTuiMatcher<Input> = (input: Input, gesture: string) => boolean;
+export declare function matchesPiTuiInput<Input>(bindingSet: BindingResolution<BindingId>, id: BindingId, input: Input, matchesKey: PiTuiMatcher<Input>): boolean;