@north-light/crouter 0.3.164 → 0.3.165

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

@@ -1,6 +1,7 @@
 import type { BindingDefinition, SafetyRequirement } from './types.js';
-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 TmuxMenuEntryAction = Exclude<TmuxMenuAction, 'open'> | `issue.${'idea' | 'bug'}`;
+import type { AttachBindingId, AttachMenuBindingId } from './attach-control.js';
+type TmuxMenuAction = 'open' | 'attach' | '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 TmuxMenuEntryAction = Exclude<TmuxMenuAction, 'open' | 'attach'> | `issue.${'idea' | 'bug'}`;
 type GraphAction = 'down' | 'up' | 'first' | 'last' | 'collapse-or-manager' | 'expand-or-child' | 'focus' | 'revive' | 'focus-manager' | 'close-subtree' | 'dismiss';
 type 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'>;
@@ -9,8 +10,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.menu-global.${TmuxMenuEntryAction}` | `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<BindingId> | 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<"crtr.view.chat.submit"> | BindingDefinition<"crtr.view.chat.contextual-cancel"> | BindingDefinition<"crtr.view.chat.reconnect"> | BindingDefinition<"crtr.view.chat.quit"> | 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 type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | AttachMenuBindingId | `crtr.tmux.menu-global.${TmuxMenuEntryAction}` | `crtr.tmux.node.${'next' | 'previous'}` | `crtr.tmux.view.${'next' | 'previous'}` | 'crtr.tmux.inbox.toggle' | AttachBindingId | `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.attach">, ...(BindingDefinition<BindingId> | 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.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<"crtr.view.chat.submit"> | BindingDefinition<"crtr.view.chat.contextual-cancel"> | BindingDefinition<"crtr.view.chat.reconnect"> | BindingDefinition<"crtr.view.chat.quit"> | 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.6" | "crtr.profile.menu.slot.7">)[], 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

@@ -20,6 +20,12 @@ function menuEntry(action, name, description, defaults, contexts) {
         b(globalId, 'Global tmux', name, description, [], 'tmux-global-action', ['tmux.root'], undefined, { field: 'global', pairedId: menuId }),
     ];
 }
+function attachEntry(menuId, actionId, name, description, menuDefault, directDefaults) {
+    return [
+        b(menuId, 'Attach', name, description, [menuDefault], 'tmux-menu-selector', ['tmux.menu.attach'], undefined, { field: 'menu', pairedId: actionId }),
+        b(actionId, 'Attach', name, description, directDefaults, 'host-global', ATTACH_CONTEXTS, undefined, { field: 'direct', pairedId: menuId }),
+    ];
+}
 const ATTACH_CONTEXTS = ['attach', 'graph', 'graph.confirm'];
 const VIEW_CONTEXTS = [
     'view.canvas', 'view.chat', 'view.git-pr',
@@ -36,6 +42,7 @@ const SETUP_CANCEL_CONTEXTS = [
 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.attach', 'Global tmux', 'Attach actions', 'Open the attach-viewer action submenu.', ['a'], 'tmux-menu-selector', ['tmux.menu']),
     ...menuEntry('promote', 'Promote node', 'Promote the focused node to orchestrator.', ['o'], ['tmux.menu']),
     ...menuEntry('resume', 'Resume node', 'Open the node resume picker.', ['r'], ['tmux.menu']),
     ...menuEntry('fork', 'Fork node', 'Fork the focused node into an independent idle root.', ['f'], ['tmux.menu']),
@@ -63,14 +70,15 @@ export const BINDING_CATALOG = Object.freeze([
     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),
+    ...attachEntry('crtr.tmux.menu.attach.detach', 'crtr.attach.detach', 'Detach', 'Detach from the node.', 'd', ['ctrl+d']),
+    ...attachEntry('crtr.tmux.menu.attach.clear-or-detach', 'crtr.attach.clear-or-detach', 'Clear or detach', 'Clear input or detach when input is empty.', 'c', ['ctrl+c']),
+    ...attachEntry('crtr.tmux.menu.attach.mode-cycle', 'crtr.mode.cycle', 'Cycle mode', 'Cycle the active agent mode.', 'p', ['alt+shift+p']),
+    ...attachEntry('crtr.tmux.menu.attach.graph.toggle', 'crtr.attach.graph.toggle', 'Toggle graph', 'Open or close the graph overlay.', 'g', ['alt+g']),
+    ...attachEntry('crtr.tmux.menu.attach.model-ladder.next', 'crtr.attach.model-ladder.next', 'Next model ladder', 'Move to the next model ladder rung.', ']', ['alt+m']),
+    ...attachEntry('crtr.tmux.menu.attach.model-ladder.previous', 'crtr.attach.model-ladder.previous', 'Previous model ladder', 'Move to the previous model ladder rung.', '[', ['alt+shift+m']),
+    ...attachEntry('crtr.tmux.menu.attach.command.inspect', 'crtr.attach.command.inspect', 'Inspect loaded command', 'Open the loaded slash command’s expanded prompt.', 'h', ['alt+shift+h']),
+    ...attachEntry('crtr.tmux.menu.attach.file-review', 'crtr.attach.file-review', 'Review a file', 'Open a line-anchored review of a file named in the transcript.', 'r', ['alt+shift+r']),
+    ...attachEntry('crtr.tmux.menu.attach.profile-files', 'crtr.attach.profile-files', 'Search profile files', 'Search files across the node’s profile projects, cwd, and ancestor crouter memory stores.', 'f', []),
     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']),

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

@@ -3,5 +3,6 @@ export { GestureSyntaxError, KeybindingValidationError, normalizeGesture, normal
 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 { ATTACH_CONTROL_BINDINGS, decodeAttachControlInput, encodeAttachControlInput, extractAttachControlInput, type AttachBindingId, type AttachMenuBindingId, type ExtractedAttachControlInput, } from './attach-control.js';
 export { KeybindingConcurrentEditError, persistUserKeybindings, type PersistedKeybindings, type PersistKeybindingsOptions, } from './persistence.js';
 export type { BindingDefinition, BindingInputKind, BindingPair, BindingResolution, BindingSafetyCapability, EffectiveBinding, KeybindingDiagnostic, KeybindingDiagnosticCode, SafetyRequirement, SparseKeybindingOverrides, } from './types.js';

package/dist/core/keybindings/index.js

@@ -3,4 +3,5 @@ export { GestureSyntaxError, KeybindingValidationError, normalizeGesture, normal
 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 { ATTACH_CONTROL_BINDINGS, decodeAttachControlInput, encodeAttachControlInput, extractAttachControlInput, } from './attach-control.js';
 export { KeybindingConcurrentEditError, persistUserKeybindings, } from './persistence.js';

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

@@ -1,6 +1,6 @@
 export type BindingInputKind = 'terminal' | 'tmux-sequence' | 'tmux-menu-selector' | 'tmux-global-action' | 'host-global';
 export interface BindingPair {
-    readonly field: 'menu' | 'global';
+    readonly field: 'menu' | 'global' | 'direct';
     readonly pairedId: string;
 }
 export type BindingSafetyCapability = 'dismiss-modal' | 'leave-screen' | 'save-keybindings';

package/dist/core/preview-registry.js

@@ -1592,7 +1592,7 @@ function summarizeNodeConfig(text) {
     ];
 }
 /** Compact an inspection result into a primary state line plus a bounded set
- *  of muted facts. Profile, configured-CLI, and config reads all use this
+ *  of muted facts. Profile and config reads both use this
  *  rather than each inventing a bespoke card grammar. */
 const INSPECTION_DETAIL_CAP = 5;
 function inspectionGlance(head, details) {
@@ -1690,46 +1690,6 @@ function summarizeProfileEnvList(text) {
         return null;
     return inspectionGlance({ text: `${count} env var${count === 1 ? '' : 's'}`, tone: count === 0 ? 'muted' : 'plain' }, [id, ...names]);
 }
-function summarizePkgCliList(text) {
-    const total = parseIntBullet(text, 'total');
-    const rows = parseTableRows(text, 'items');
-    if (total === null || rows === null || (total > 0 && rows.length === 0))
-        return null;
-    if (total === 0)
-        return inspectionGlance({ text: '0 configured CLIs', tone: 'muted' }, []);
-    const details = [];
-    for (const row of rows) {
-        const name = row['name'];
-        const scope = row['scope'];
-        const state = row['manifest_state'];
-        const commands = row['top_level_commands'];
-        if (name === undefined || name === '' || scope === undefined || scope === '' || (state !== 'stored' && state !== 'absent') || commands === undefined)
-            return null;
-        details.push(`${name} · ${scope} · ${state}${commands === '' ? '' : ` · ${commands}`}`);
-    }
-    return inspectionGlance({ text: `${total} configured CLI${total === 1 ? '' : 's'}` }, details);
-}
-function summarizePkgCliShow(text) {
-    const name = /^- name:\s*(\S+)\s*$/m.exec(text)?.[1];
-    const scope = /^- scope:\s*(\S+)\s*$/m.exec(text)?.[1];
-    const state = /^- manifest_state:\s*(stored|absent)\s*$/m.exec(text)?.[1];
-    const issuesStart = text.search(/^0 issues\.$|^\d+ issues:$/m);
-    if (name === undefined || scope === undefined || state === undefined || issuesStart === -1)
-        return null;
-    const commands = parseTableRows(text.slice(0, issuesStart), 'commands');
-    const issueText = text.slice(issuesStart);
-    const issues = parseTableRows(issueText, 'issues');
-    if (commands === null || issues === null)
-        return null;
-    if (commands.some((row) => row['command'] === undefined || row['command'] === '' || row['paths'] === undefined) || issues.some((row) => row['code'] === undefined || row['code'] === ''))
-        return null;
-    const details = [`${commands.length} command${commands.length === 1 ? '' : 's'} · ${issues.length} issue${issues.length === 1 ? '' : 's'}`];
-    details.push(...commands.map((row) => row['command']));
-    details.push(...issues.map((row) => `issue: ${row['code']}`));
-    return inspectionGlance({ text: `${name} · ${scope} · ${state}`, tone: state === 'stored' ? 'plain' : 'warning' }, details);
-}
-/** `canvas config show` already emits one concise line. List only earns a
- *  card once multiple targets produce a real multiline roster. */
 function summarizeCanvasConfigList(text) {
     const rows = text.split('\n').filter((line) => line.trim() !== '');
     if (rows.length < 2)
@@ -1904,36 +1864,31 @@ function summarizePkgMarketRemove(text) {
     return [{ text: `removed marketplace ${name}`, tone: 'success' }];
 }
 /** `crtr pkg plugin install` (pluginInstall.run, src/commands/pkg/
- *  plugin-manage.ts:280) has no custom `render`; the generic renderer
- *  bullets `name`/`scope` (always short) then `path` — almost always long
- *  enough to cross the prose threshold, and since it's the SOLE prose field
- *  it renders as a bare unlabeled paragraph (see soloProseAfterBullets),
- *  not a labeled one. Falls back to a `- path:` bullet for the rare
- *  short-path case. Returns null when `name`/`scope` aren't present as
- *  bullets — an error/unrecognized shape (path is a muted aside, not
- *  required for a recognized digest). */
+ *  plugin-manage.ts:418) has no custom `render`; the generic renderer
+ *  bullets `name`, `scope`, and optional `transport`, then `path` — almost
+ *  always long enough to cross the prose threshold, and since it is the sole
+ *  prose field it renders as a bare unlabeled paragraph (see
+ *  soloProseAfterBullets). Returns null when `name`/`scope` aren't present as
+ *  bullets — an error/unrecognized shape (path is a muted aside, not required
+ *  for a recognized digest). */
 function summarizePkgPluginInstall(text) {
     const name = /^- name:\s*(\S+)\s*$/m.exec(text)?.[1];
     const scope = /^- scope:\s*(\S+)\s*$/m.exec(text)?.[1];
+    const transport = /^- transport:\s*(exec|http)\s*$/m.exec(text)?.[1];
     if (name === undefined || scope === undefined)
         return null;
     const path = readFieldFlexible(text, 'path') ?? soloProseAfterBullets(text);
     return [
-        { text: `installed ${name}`, tone: 'success' },
+        { text: `installed ${name}${transport !== undefined ? ` · ${transport}` : ''}`, tone: 'success' },
         { text: path !== undefined ? `${scope} · ${path}` : scope, tone: 'muted' },
     ];
 }
 /** `crtr pkg plugin update` (pluginUpdate.run, src/commands/pkg/
- *  plugin-manage.ts:349) has no custom `render`; the generic renderer emits
- *  an `N updated:` table (columns `name,updated,sha`) — one row when
- *  `--name` targets a single plugin, one row per installed plugin
- *  otherwise. There is no version field anywhere in this output (unlike
- *  command-icons.md's hypothetical version-delta wording) — `sha` (short,
- *  7 chars) is the only content available to show. Returns null when the
- *  table doesn't match this shape, or when any row's `updated` cell isn't
- *  exactly `true`/`false` (the multi-row loop mirrors the single-row
- *  validation above — a malformed cell must not be silently counted as
- *  "already current"). */
+ *  plugin-manage.ts:571) has no custom `render`; the generic renderer emits
+ *  an `N updated:` table. HTTP rows carry `transport=http` and no sha because
+ *  they replace commands.json after refetch; git rows retain their optional
+ *  `sha`. Returns null when the table doesn't match this shape or an `updated`
+ *  cell is not exactly `true`/`false`. */
 function summarizePkgPluginUpdate(text) {
     const rows = parseTableRows(text, 'updated');
     if (rows === null)
@@ -1944,31 +1899,40 @@ function summarizePkgPluginUpdate(text) {
         const row = rows[0];
         const name = row['name'];
         const updated = row['updated'];
-        if (name === undefined || (updated !== 'true' && updated !== 'false'))
+        const transport = row['transport'];
+        if (name === undefined || (updated !== 'true' && updated !== 'false') || (transport !== undefined && transport !== '' && transport !== 'exec' && transport !== 'http'))
             return null;
         const sha = (row['sha'] ?? '').slice(0, 7);
         const lines = [
-            updated === 'true' ? { text: `updated ${name}`, tone: 'success' } : { text: `${name} already current`, tone: 'muted' },
+            updated === 'true' ? { text: `${transport === 'http' ? 'refreshed' : 'updated'} ${name}`, tone: 'success' } : { text: `${name} already current`, tone: 'muted' },
         ];
+        if (transport !== undefined && transport !== '')
+            lines.push({ text: transport, tone: 'muted' });
         if (sha !== '')
             lines.push({ text: sha, tone: 'muted' });
         return lines;
     }
     let updatedCount = 0;
+    let httpCount = 0;
     for (const row of rows) {
         const updated = row['updated'];
+        const transport = row['transport'];
         if (updated !== 'true' && updated !== 'false')
             return null;
+        if (transport !== undefined && transport !== '' && transport !== 'exec' && transport !== 'http')
+            return null;
         if (updated === 'true')
             updatedCount++;
+        if (transport === 'http')
+            httpCount++;
     }
     const current = rows.length - updatedCount;
-    return [{ text: `${updatedCount} updated · ${current} already current` }];
+    return [{ text: `${updatedCount} updated · ${current} already current${httpCount > 0 ? ` · ${httpCount} HTTP` : ''}` }];
 }
 const PKG_LIST_NAME_CAP = 8;
 /** `crtr pkg plugin list` (pluginList.run, src/commands/pkg/
- *  plugin-inspect.ts:12) bullets `- total: N` then an `N items:` table
- *  (columns `name,scope,version,enabled,source_marketplace,path`).
+ *  plugin-inspect.ts:14) bullets `- total: N` then an `N items:` table
+ *  (columns `name,scope,version,enabled,transport,source_marketplace,path`).
  *  `enabled`/name counts are read from the RETURNED page only — with the
  *  default 50-per-page limit this matches `total` in practice, but a
  *  narrower `--limit` would undercount enabled/shown names against the
@@ -1990,11 +1954,12 @@ function summarizePkgPluginList(text) {
     for (const row of rows) {
         const name = row['name'];
         const enabled = row['enabled'];
-        if (name === undefined || name === '' || (enabled !== 'true' && enabled !== 'false'))
+        const transport = row['transport'];
+        if (name === undefined || name === '' || (enabled !== 'true' && enabled !== 'false') || (transport !== 'exec' && transport !== 'http' && transport !== ''))
             return null;
         if (enabled === 'true')
             enabledCount++;
-        names.push(name);
+        names.push(`${name}${transport === '' ? '' : ` (${transport})`}`);
     }
     const shown = names.slice(0, PKG_LIST_NAME_CAP);
     const remaining = names.length - shown.length;
@@ -2005,14 +1970,15 @@ function summarizePkgPluginList(text) {
     ];
 }
 /** `crtr pkg plugin show` (pluginShow.run, src/commands/pkg/
- *  plugin-inspect.ts:76) bullets `name`/`scope`/`path`/`enabled` (path is
+ *  plugin-inspect.ts:88) bullets `name`/`scope`/`path`/`enabled` (path is
  *  usually short here — a plugin dir, not a nested interaction path — so
  *  stays a bullet) then `manifest` — an OBJECT, so core/render.ts's
  *  scalarStr always JSON.stringifies it to a bullet regardless of length
  *  (isProse only ever triggers for strings) — then an `N docs:` table (or
- *  `0 docs.`). `version` is read from the parsed manifest JSON, not a
- *  top-level field. Returns null when `name`/`enabled`/`manifest` don't
- *  match, `manifest` isn't valid JSON, or the docs count line is missing. */
+ *  `0 docs.`). `version` and `transport.kind` are read from the parsed
+ *  manifest JSON, not top-level fields. Returns null when `name`/`enabled`/
+ *  `manifest` don't match, `manifest` isn't valid JSON, or the docs count
+ *  line is missing. */
 function summarizePkgPluginShow(text) {
     const name = /^- name:\s*(\S+)\s*$/m.exec(text)?.[1];
     const enabledMatch = /^- enabled:\s*(true|false)\s*$/m.exec(text);
@@ -2029,12 +1995,15 @@ function summarizePkgPluginShow(text) {
     const version = manifest !== null && typeof manifest === 'object' && 'version' in manifest && typeof manifest.version === 'string'
         ? manifest.version
         : undefined;
+    const transport = manifest !== null && typeof manifest === 'object' && 'transport' in manifest && manifest.transport !== null && typeof manifest.transport === 'object' && ['exec', 'http'].includes(manifest.transport.kind)
+        ? manifest.transport.kind
+        : undefined;
     const docsCount = /^0 docs\.$/m.test(text) ? 0 : Number(/^(\d+) docs:$/m.exec(text)?.[1] ?? NaN);
     if (Number.isNaN(docsCount))
         return null;
     const enabled = enabledMatch[1] === 'true';
     return [
-        { text: `${name}${version !== undefined ? `@${version}` : ''} · ${enabled ? 'enabled' : 'disabled'}`, tone: enabled ? 'success' : 'muted' },
+        { text: `${name}${version !== undefined ? `@${version}` : ''}${transport !== undefined ? ` · ${transport}` : ''} · ${enabled ? 'enabled' : 'disabled'}`, tone: enabled ? 'success' : 'muted' },
         { text: `${docsCount} substrate doc${docsCount === 1 ? '' : 's'}`, tone: 'muted' },
     ];
 }
@@ -2797,8 +2766,6 @@ const SUMMARIZERS = [
     { path: 'profile show', run: summarizeProfileShow },
     { path: 'profile default show', run: summarizeProfileDefaultShow },
     { path: 'profile env list', run: summarizeProfileEnvList },
-    { path: 'pkg cli list', run: summarizePkgCliList },
-    { path: 'pkg cli show', run: summarizePkgCliShow },
     { path: 'canvas config list', run: summarizeCanvasConfigList },
     { path: 'sys config get', run: summarizeSysConfigGet },
     { path: 'sys config path', run: summarizeSysConfigPath },

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

@@ -1,15 +1,12 @@
 import { type Cron } from '../canvas/index.js';
+/** The bearings custom type is shared with every attached renderer. */
+export { CONTEXT_INTRO_CUSTOM_TYPE } from '../../shared/generated-context.js';
 /** The `<project_context>` block — the `<environment>` snapshot only: a
  *  host/runtime line (platform, hostname, node version, tmux-or-not — the
  *  headless engine's own process env, which its bash tools inherit), the cwd
  *  dir listing, and git status/worktrees. Project guidance lives in the
  *  document substrate, so this wrapper stays environment-only. It always emits
  *  because the environment snapshot is always present. Exported for testing. */
-/** The `customType` stamped on a node's injected bearings message. Lives here,
- *  beside the builder, because BOTH delivery paths need it: the context-intro
- *  pi-extension (session_start, the cold path) and the warm-pool claim's live
- *  delivery. It is also the idempotency discriminator a later revive matches. */
-export declare const CONTEXT_INTRO_CUSTOM_TYPE = "crtr-context";
 export declare function buildProjectContextBlock(cwd: string): string;
 /** The context-directory note — names the path INLINE (no XML attribute, so it
  *  never scopes a sibling block) and frames the dir as durable, shared scratch.

package/dist/core/runtime/bearings.js

@@ -48,6 +48,8 @@ import { cadenceDisplay } from '../wake.js';
 import { renderKnowledgeBlock, renderWorkspaceOpenDocs } from '../substrate/index.js';
 import { loadProfileManifest } from '../profiles/manifest.js';
 import { situationalContextBlock } from './situational-context.js';
+/** The bearings custom type is shared with every attached renderer. */
+export { CONTEXT_INTRO_CUSTOM_TYPE } from '../../shared/generated-context.js';
 function escapeAttribute(value) {
     return value.replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
 }
@@ -144,11 +146,6 @@ function parseWorktrees(lines) {
  *  dir listing, and git status/worktrees. Project guidance lives in the
  *  document substrate, so this wrapper stays environment-only. It always emits
  *  because the environment snapshot is always present. Exported for testing. */
-/** The `customType` stamped on a node's injected bearings message. Lives here,
- *  beside the builder, because BOTH delivery paths need it: the context-intro
- *  pi-extension (session_start, the cold path) and the warm-pool claim's live
- *  delivery. It is also the idempotency discriminator a later revive matches. */
-export const CONTEXT_INTRO_CUSTOM_TYPE = 'crtr-context';
 export function buildProjectContextBlock(cwd) {
     const envLines = directoryListingLines(cwd);
     const git = gitSnapshot(cwd);

package/dist/core/runtime/front-door.d.ts

@@ -10,7 +10,7 @@ export declare const FRONT_DOOR_ENV = "CRTR_FRONT_DOOR";
  *  Takes NO command tree: it decides from argv plus the static `SUBTREE_NAMES`
  *  list, so bare `crtr` never pays for assembling the full tree (measured 520ms
  *  of the front door's ~1.6s — every subtree's module graph plus external
- *  plugin/configured-CLI discovery, none of which a root boot reads). The one
+ *  plugin/HTTP-transport plugin discovery, none of which a root boot reads). The one
  *  case that genuinely needs external command names — a bare word that is also
  *  an existing directory — builds the tree lazily, below. */
 export declare function maybeBootRoot(argv: string[]): Promise<boolean>;

package/dist/core/runtime/front-door.js

@@ -101,7 +101,7 @@ export const FRONT_DOOR_ENV = 'CRTR_FRONT_DOOR';
  *  Takes NO command tree: it decides from argv plus the static `SUBTREE_NAMES`
  *  list, so bare `crtr` never pays for assembling the full tree (measured 520ms
  *  of the front door's ~1.6s — every subtree's module graph plus external
- *  plugin/configured-CLI discovery, none of which a root boot reads). The one
+ *  plugin/HTTP-transport plugin discovery, none of which a root boot reads). The one
  *  case that genuinely needs external command names — a bare word that is also
  *  an existing directory — builds the tree lazily, below. */
 export async function maybeBootRoot(argv) {
@@ -138,7 +138,7 @@ export async function maybeBootRoot(argv) {
             return false;
         // A bare word that is an existing directory is the ONLY token shape that
         // could also be an EXTERNAL top-level command name (a command plugin or a
-        // configured CLI) — a prompt carries whitespace and a front-door flag is
+        // HTTP-transport plugin) — a prompt carries whitespace and a front-door flag is
         // `-`-prefixed, and neither can name a command. Resolve the full tree only
         // for that collision check, keeping it off the bare-`crtr` boot path.
         if (looksLikeDir) {

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

@@ -1,5 +1,6 @@
 import { type NodeMeta } from '../canvas/index.js';
 import { type WakeOrigin } from './bearings.js';
+export { REVIVE_KICKOFF_SENTINEL } from '../../shared/generated-context.js';
 /** The goal file — the prompt/task a node was spawned with, persisted at birth
  *  so a fresh revive can re-read its mandate. */
 export declare function goalPath(nodeId: string): string;
@@ -13,9 +14,8 @@ export declare function writeGoal(nodeId: string, text: string): void;
  *  the text was empty. Guarded so a later message never clobbers the mandate. */
 export declare function captureGoalIfAbsent(nodeId: string, text: string): boolean;
 /** Sentinel opening the fresh-revive kickoff message (see buildReviveKickoff).
- *  The goal-capture extension skips any input starting with this so a kickoff
- *  prompt is never mistaken for a user's first mandate. */
-export declare const REVIVE_KICKOFF_SENTINEL = "You have been revived fresh after a context refresh";
+ *  The goal-capture extension and attached renderers share its pure definition,
+ *  so the same exact contract controls both prompt exclusion and display. */
 /** Injected only when a broker cleanly persisted an aborted in-flight turn
  * before a daemon restart. The transcript already carries the full picture, so
  * this is a bare nudge — a longer explanation only destabilizes the resume. */

package/dist/core/runtime/kickoff.js

@@ -24,6 +24,8 @@ import { readRoadmap, roadmapPath } from './roadmap.js';
 import { buildWakeBearings } from './bearings.js';
 import { personaDrift, commitPersonaAck } from './persona.js';
 import { readInboxSince, readCursor, writeCursor, coalesce, } from '../feed/inbox.js';
+import { REVIVE_KICKOFF_SENTINEL } from '../../shared/generated-context.js';
+export { REVIVE_KICKOFF_SENTINEL } from '../../shared/generated-context.js';
 // ---------------------------------------------------------------------------
 // Companion context files: the goal (the spawning mandate) and the one-shot
 // yield message (a note from the prior self to the revived self).
@@ -61,9 +63,8 @@ export function captureGoalIfAbsent(nodeId, text) {
     return true;
 }
 /** Sentinel opening the fresh-revive kickoff message (see buildReviveKickoff).
- *  The goal-capture extension skips any input starting with this so a kickoff
- *  prompt is never mistaken for a user's first mandate. */
-export const REVIVE_KICKOFF_SENTINEL = 'You have been revived fresh after a context refresh';
+ *  The goal-capture extension and attached renderers share its pure definition,
+ *  so the same exact contract controls both prompt exclusion and display. */
 /** Injected only when a broker cleanly persisted an aborted in-flight turn
  * before a daemon restart. The transcript already carries the full picture, so
  * this is a bare nudge — a longer explanation only destabilizes the resume. */

package/dist/core/runtime/situational-context.d.ts

@@ -1,6 +1,6 @@
 /** The `customType` stamped on the hidden custom message the inbox watcher
  *  sends for an existing node's situational-context update. */
-export declare const SITUATIONAL_CONTEXT_CUSTOM_TYPE = "crtr-situational-context";
+export { SITUATIONAL_CONTEXT_CUSTOM_TYPE } from '../../shared/generated-context.js';
 /** Upsert the node's current situational context (replace, not append) — the
  *  one sanctioned writer for the sidecar. No-op for blank text, so a caller
  *  can pass through an optional/empty value with no guard at the call site. */

package/dist/core/runtime/situational-context.js

@@ -21,7 +21,7 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { situationalContextPath, nodeDir } from '../canvas/paths.js';
 /** The `customType` stamped on the hidden custom message the inbox watcher
  *  sends for an existing node's situational-context update. */
-export const SITUATIONAL_CONTEXT_CUSTOM_TYPE = 'crtr-situational-context';
+export { SITUATIONAL_CONTEXT_CUSTOM_TYPE } from '../../shared/generated-context.js';
 /** Upsert the node's current situational context (replace, not append) — the
  *  one sanctioned writer for the sidecar. No-op for blank text, so a caller
  *  can pass through an optional/empty value with no guard at the call site. */

package/dist/core/runtime/spawn.js

@@ -30,6 +30,7 @@ import { beginBootFaultAttempt } from './fault.js';
 import { piSessionsRoot } from './pi-vendored.js';
 import { headlessBrokerHost } from './host.js';
 import { ensureDaemon } from '../../daemon/manage.js';
+import { readConfig } from '../config.js';
 // ---------------------------------------------------------------------------
 // Shared broker-launch wrapper — catch launch/preflight failures at the call
 // site, mark the node crashed, then rethrow a clear error.
@@ -371,15 +372,14 @@ export async function spawnChildPrepared(opts, beforeBrokerLaunch) {
                 }
             }
         }
-        else if (!root && spawner !== null) {
-            // A managed child is normally born headless (no viewer). But when a HUMAN is
-            // actively watching the spawner in a tmux viewer pane, pop the child's viewer
-            // open beside it so the human sees background work start immediately instead of
-            // having to hunt for it. The broker is headless (TMUX stripped in broker.ts), so
-            // we can't read $TMUX — instead we find the spawner's live viewer pane from the
-            // focus registry (focusOf prunes a dead pane and returns null) and split beside
-            // it. No viewer ⇒ nobody is watching ⇒ stay headless as before. Best-effort:
-            // never fail a spawn on viewer placement.
+        else if (!root && spawner !== null && readConfig('user').auto_open_child_viewers) {
+            // When enabled, a managed child opens beside a HUMAN actively watching
+            // its spawner. Turning the setting off leaves every child headless until
+            // someone explicitly focuses or attaches it. The broker is headless
+            // (TMUX stripped in broker.ts), so we can't read $TMUX — instead we find
+            // the spawner's live viewer pane from the focus registry (focusOf prunes
+            // a dead pane and returns null) and split beside it. No viewer ⇒ nobody is
+            // watching ⇒ stay headless. Best-effort: never fail a spawn on placement.
             try {
                 const parentViewer = focusOf(spawner);
                 if (parentViewer !== null && parentViewer.pane !== null && parentViewer.pane !== '') {

package/dist/core/runtime/tmux.js

@@ -11,7 +11,7 @@ import { spawnSync } from 'node:child_process';
 import { readFileSync, rmSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
-import { BINDING_CATALOG, formatGesture, resolveUserKeybindings, } from '../keybindings/index.js';
+import { ATTACH_CONTROL_BINDINGS, BINDING_CATALOG, encodeAttachControlInput, formatGesture, resolveUserKeybindings, } from '../keybindings/index.js';
 import { bundledPiCommandForShell } from './pi-cli.js';
 import { surfaceTmuxStyleArgs } from './surface-bg.js';
 import { inboxToggleTmuxCommand } from '@crouton-kit/humanloop';
@@ -554,6 +554,13 @@ function menuActionCommand(action) {
                 menu: `send-keys -t '#{pane_id}' ${shellQuote(keys)}`,
             };
         }
+        case 'literal-input': {
+            const input = escapeTmuxFormats(action.input);
+            return {
+                argv: ['send-keys', '-l', input],
+                menu: `send-keys -l -t '#{pane_id}' ${shellQuote(input)}`,
+            };
+        }
         case 'command': return chordCommand(action.run);
         case 'direct': return directCommand(action.run);
         case 'popup': return chordCommand(action.run, true);
@@ -640,6 +647,22 @@ function resolvedMenuActions(bindings) {
         if (entry !== undefined)
             entries.set(id, entry);
     }
+    for (const { menuId, actionId } of ATTACH_CONTROL_BINDINGS) {
+        const definition = BINDING_CATALOG.find((candidate) => candidate.id === actionId);
+        if (definition === undefined)
+            throw new Error(`missing attach binding definition ${actionId}`);
+        entries.set(menuId, {
+            description: definition.name.toLowerCase(),
+            action: { kind: 'literal-input', input: encodeAttachControlInput(actionId) },
+        });
+    }
+    const attachItems = boundMenuItems(ATTACH_CONTROL_BINDINGS.map(({ menuId }) => menuId), entries, bindings);
+    if (attachItems.length > 0) {
+        entries.set('crtr.tmux.menu.attach', {
+            description: 'attach ›',
+            action: { kind: 'submenu', title: ' attach ', items: attachItems },
+        });
+    }
     const showItems = boundMenuItems([
         'crtr.tmux.menu.metadata',
         'crtr.tmux.menu.context',
@@ -687,6 +710,7 @@ function menuItems(bindings, entries) {
         'crtr.tmux.menu.view-settings',
     ]));
     addGroup('Current node', boundItems([
+        'crtr.tmux.menu.attach',
         'crtr.tmux.menu.background-bash',
         'crtr.tmux.menu.file-review',
         'crtr.tmux.menu.pin',
@@ -865,8 +889,11 @@ export function installTmuxBindings(bindings = resolveUserKeybindings()) {
     for (const definition of BINDING_CATALOG) {
         if (definition.pair?.field !== 'menu')
             continue;
+        const paired = BINDING_CATALOG.find((candidate) => candidate.id === definition.pair?.pairedId);
+        if (paired?.pair?.field !== 'global')
+            continue;
         const menuId = definition.id;
-        const globalId = definition.pair.pairedId;
+        const globalId = paired.id;
         const entry = menuActions.get(menuId);
         const command = entry === undefined ? null : menuActionCommand(entry.action);
         if (command === null)