@crouton-kit/crouter 0.3.83 → 0.3.85

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

@@ -7,8 +7,8 @@ type BrowseAction = 'quit' | 'down' | 'up' | 'first' | 'last' | 'expand-or-child
 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';
 type SetupKeybindingAction = 'edit' | 'commit-edit' | 'cancel-edit' | 'unbind' | 'reset-row' | 'reset-all' | 'save' | 'discard' | 'page-up' | 'page-down' | 'filter' | 'filter-delete' | 'filter-clear';
-export type BindingId = `crtr.tmux.menu.${TmuxMenuAction}` | `crtr.tmux.menu.issue.${'idea' | 'bug'}` | `crtr.tmux.node.${'next' | 'previous'}` | `crtr.tmux.view.${'next' | 'previous'}` | `crtr.attach.${'detach' | 'clear-or-detach' | 'graph.toggle' | 'model-ladder.next' | 'model-ladder.previous'}` | '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' | 'request-control' | 'release-control' | '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.settings.${'down' | 'up' | 'cell-previous' | 'cell-next' | 'refresh' | 'quit' | 'edit-or-submit' | 'cancel-edit'}` | `crtr.view.workspace-sidebar.${'down' | 'up' | 'open' | '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}`;
-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.demote">, BindingDefinition<"crtr.tmux.menu.detach">, BindingDefinition<"crtr.tmux.menu.close-subtree">, 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.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.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.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.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.request-control">, BindingDefinition<"crtr.view.chat.release-control">, 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.settings.down"> | BindingDefinition<"crtr.view.settings.up"> | BindingDefinition<"crtr.view.settings.cell-previous"> | BindingDefinition<"crtr.view.settings.cell-next"> | BindingDefinition<"crtr.view.settings.refresh"> | BindingDefinition<"crtr.view.settings.quit"> | BindingDefinition<"crtr.view.settings.edit-or-submit"> | BindingDefinition<"crtr.view.settings.cancel-edit"> | 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-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.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | 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.8" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.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">];
+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'}` | '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' | 'request-control' | 'release-control' | '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.settings.${'down' | 'up' | 'cell-previous' | 'cell-next' | 'refresh' | 'quit' | 'edit-or-submit' | 'cancel-edit'}` | `crtr.view.workspace-sidebar.${'down' | 'up' | 'open' | '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}`;
+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.demote">, BindingDefinition<"crtr.tmux.menu.detach">, BindingDefinition<"crtr.tmux.menu.close-subtree">, 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.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.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.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.request-control">, BindingDefinition<"crtr.view.chat.release-control">, 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.settings.down"> | BindingDefinition<"crtr.view.settings.up"> | BindingDefinition<"crtr.view.settings.cell-previous"> | BindingDefinition<"crtr.view.settings.cell-next"> | BindingDefinition<"crtr.view.settings.refresh"> | BindingDefinition<"crtr.view.settings.quit"> | BindingDefinition<"crtr.view.settings.edit-or-submit"> | BindingDefinition<"crtr.view.settings.cancel-edit"> | 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-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.residents"> | BindingDefinition<"crtr.browse.preview"> | BindingDefinition<"crtr.browse.search"> | BindingDefinition<"crtr.browse.revive-now"> | BindingDefinition<"crtr.browse.focus"> | 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.8" | "crtr.profile.menu.slot.6" | "crtr.profile.menu.slot.7" | "crtr.profile.menu.slot.9">)[], BindingDefinition<"crtr.profile.menu.create">, BindingDefinition<"crtr.profile.menu.search-existing">, BindingDefinition<"crtr.profile.menu.use-root">, BindingDefinition<"crtr.profile.menu.set-default">, BindingDefinition<"crtr.profile.menu.add-directory">, BindingDefinition<"crtr.profile.menu.unpin">, BindingDefinition<"crtr.profile.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">];
 export declare const BINDING_IDS: ReadonlySet<string>;
 export declare const SAFETY_REQUIREMENTS: readonly SafetyRequirement[];
 export {};

package/dist/core/keybindings/catalog.js

@@ -40,6 +40,7 @@ export const BINDING_CATALOG = Object.freeze([
     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),

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

@@ -1,5 +1,6 @@
 export { BINDING_CATALOG, BINDING_IDS, SAFETY_REQUIREMENTS, type BindingId, } from './catalog.js';
 export { GestureSyntaxError, KeybindingValidationError, normalizeGesture, normalizeSparseOverrides, normalizeStroke, resolveKeybindings, resolveUserKeybindings, } 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 { 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

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

package/dist/core/preview-registry.js

@@ -1085,11 +1085,12 @@ const ASK_TEASER_CHARS = 160;
 /** `crtr human ask` (humanAsk.run, src/commands/human/prompts.ts) returns
  *  `{job_id, dir, follow_up}` — `job_id` is always short (a node id) so it
  *  always bullets; `dir`/`follow_up` cross the prose threshold depending on
- *  path length, so the shape is recognized by `job_id` plus the single FIXED
- *  QUEUED_FOLLOW_UP road-sign (`Queued for the human`, prompts.ts) appearing
+ *  path length, so the shape is recognized by `job_id` plus the stable road-sign
+ *  prefix `Queued for the human` (queuedFollowUp, prompts.ts — its inbox-
+ *  affordance tail resolves per call, the prefix never varies) appearing
  *  anywhere in the text — never by assuming dir/follow_up's bullet vs. prose
- *  form. Arrival is now always just durable queue state (no tmux/non-tmux
- *  drained-vs-delivered fork), so the card collapses to one posted line. The
+ *  form. Arrival is always just durable queue state, so the card collapses to
+ *  one posted line. The
  *  question text isn't in the output at all (only the bare-question invocation
  *  echoes it), so it's recovered from argv: the first non-flag token after
  *  `human ask`, skipping `--context-file`'s value — absent for a
@@ -1113,8 +1114,8 @@ function summarizeHumanAsk(text, tokens) {
 }
 /** `crtr human review` (humanReview.run, src/commands/human/prompts.ts)
  *  returns `{job_id, dir, output, follow_up}` — same recognition strategy as
- *  summarizeHumanAsk (job_id bullet + the single fixed QUEUED_FOLLOW_UP
- *  road-sign, `Queued for the human`, which review shares with ask). The
+ *  summarizeHumanAsk (job_id bullet + the stable `Queued for the human`
+ *  road-sign prefix, which review shares with ask). The
  *  reviewed file isn't in the output either, so its basename is recovered
  *  from argv (the file positional, skipping `--output`'s value). Returns null
  *  when the road-sign is absent. */

package/dist/core/runtime/spawn.js

@@ -24,7 +24,6 @@ import { appendSituationalContext } from './situational-context.js';
 import { hasRoadmap, seedRoadmap } from './roadmap.js';
 import { buildIdentityAssertion, buildWakeBearings } from './bearings.js';
 import { installTmuxBindings } from './tmux-chrome.js';
-import { installInboxBinding } from '@crouton-kit/humanloop';
 import { getNode, fullName, recordPid } from '../canvas/index.js';
 import { registerViewerFocus, openViewerWindow, waitForBrokerViewSocket, viewerSplitEnv, windowOfPane, currentTmux, inTmux, focusWindow, } from './placement.js';
 import { transition } from './lifecycle.js';
@@ -98,19 +97,12 @@ export async function bootRoot(opts) {
     // mandate (bare `crtr` has none — writeGoal no-ops on empty).
     if (opts.prompt !== undefined)
         writeGoal(meta.node_id, opts.prompt);
-    // Reconcile the crouter-owned tmux bindings on this server.
+    // Reconcile the crouter-owned tmux bindings on this server, including the
+    // inbox-toggle key (crtr.tmux.inbox.toggle) folded into the same manifest sweep.
     try {
         installTmuxBindings();
     }
     catch { /* best-effort */ }
-    // Reconcile humanloop's collision-safe M-i inbox popup binding on the same
-    // server so the inbox is reachable from any window. Crouter calls humanloop's
-    // installer — it never authors or parses its own tmux command; the installer
-    // is idempotent and leaves any pre-existing M-i binding untouched.
-    try {
-        installInboxBinding();
-    }
-    catch { /* best-effort */ }
     // This terminal becomes the root's attach VIEWER in the user's CURRENT session,
     // so its window stays where the user already is. The node row carries NO
     // presence — a broker node's pane/window/tmux_session stay NULL; the viewer

package/dist/core/runtime/tmux-chrome.d.ts

@@ -1 +1 @@
-export { installTmuxBindings, sendKeysEnter, displayMessage, paneCurrentPath, type TmuxInstalledPair, type TmuxInstallDiagnostic, type TmuxInstallResult, } from './tmux.js';
+export { installTmuxBindings, legacyInboxKeyFile, sendKeysEnter, displayMessage, paneCurrentPath, type TmuxInstalledPair, type TmuxInstallDiagnostic, type TmuxInstallResult, } from './tmux.js';

package/dist/core/runtime/tmux-chrome.js

@@ -1,4 +1,4 @@
 // tmux-chrome.ts — chrome seam (§2.1): stateless keybind/input verbs.
 // The ONLY non-placement module allowed to import the tmux driver, per the
 // §5.1 lint. Re-exports the server chrome callers need.
-export { installTmuxBindings, sendKeysEnter, displayMessage, paneCurrentPath, } from './tmux.js';
+export { installTmuxBindings, legacyInboxKeyFile, sendKeysEnter, displayMessage, paneCurrentPath, } from './tmux.js';

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

@@ -218,5 +218,6 @@ export interface TmuxInstallResult {
     readonly installed: readonly TmuxInstalledPair[];
     readonly diagnostics: readonly TmuxInstallDiagnostic[];
 }
+export declare function legacyInboxKeyFile(): string;
 /** Reconcile the tmux server with one immutable crouter binding snapshot. */
 export declare function installTmuxBindings(bindings?: BindingResolution<BindingId>): TmuxInstallResult;

package/dist/core/runtime/tmux.js

@@ -8,9 +8,13 @@
 // root) or switch-client + select-window (across roots). done/dead nodes close
 // their window; reviving opens a fresh one.
 import { spawnSync } from 'node:child_process';
+import { readFileSync, rmSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
 import { resolveUserKeybindings, } from '../keybindings/index.js';
 import { bundledPiCommandForShell } from './pi-cli.js';
 import { surfaceTmuxStyleArgs } from './surface-bg.js';
+import { inboxToggleTmuxCommand } from '@crouton-kit/humanloop';
 // ---------------------------------------------------------------------------
 // Shell quoting + tmux invocation
 // ---------------------------------------------------------------------------
@@ -428,6 +432,7 @@ const MENU_ACTIONS = {
     'crtr.tmux.menu.issue.bug': undefined,
     'crtr.tmux.node.next': undefined,
     'crtr.tmux.node.previous': undefined,
+    'crtr.tmux.inbox.toggle': undefined,
     'crtr.tmux.view.next': undefined,
     'crtr.tmux.view.previous': undefined,
 };
@@ -546,12 +551,28 @@ function readManifest() {
         return null;
     }
 }
+// Crouter's own pre-manifest root bindings. When a machine had these installed
+// before the ownership manifest existed, the first reconciliation adopts them
+// into the manifest (unbinding the stale copy so it reinstalls cleanly) instead
+// of reporting them foreign. Gated on a fresh manifest — once one exists these
+// keys are already crouter-owned through it.
 const LEGACY_ROOT_BINDINGS = [
     { key: 'M-c', markers: ['display-menu', 'promote to orchestrator', 'crtr canvas chord', 'new issue / todo'] },
     { key: 'M-]', markers: ['run-shell', 'crtr node cycle --dir next', "--pane '#{pane_id}'"] },
     { key: 'M-[', markers: ['run-shell', 'crtr node cycle --dir prev', "--pane '#{pane_id}'"] },
     { key: 'M-v', markers: ['switch-client', '-T crtr-view'] },
 ];
+// The inbox toggle is a crouter-owned root binding, resolved from keybindings.json
+// and installed through the manifest sweep like every sibling. Root bindings
+// matching these markers that are NOT tracked in the manifest are hl-owned
+// strays; reconciliation removes them (and the state file naming their key) so
+// the manifest stays the sole owner of the inbox command.
+const LEGACY_INBOX_MARKERS = ['run-shell', 'hl inbox toggle'];
+const LEGACY_INBOX_DEFAULT_KEY = 'M-i';
+export function legacyInboxKeyFile() {
+    const stateHome = process.env['XDG_STATE_HOME'] || join(homedir(), '.local', 'state');
+    return join(stateHome, 'humanloop', 'inbox-key');
+}
 function adoptLegacyBindings() {
     for (const legacy of LEGACY_ROOT_BINDINGS) {
         const existing = bindingAt(ROOT_TABLE, legacy.key);
@@ -560,10 +581,42 @@ function adoptLegacyBindings() {
         }
     }
 }
+// Enforce the manifest's sole ownership of the inbox command: any hl-owned
+// inbox binding not tracked in the manifest is unbound, and the humanloop
+// state file is discarded. Runs on every reconciliation regardless of whether
+// a manifest already exists. Checks the default key plus the key the state
+// file records (the file's value only locates a stray binding — it is never
+// imported into crouter config). A key tracked in the manifest is crouter's
+// own and left alone; a foreign non-hl binding never matches the markers and
+// is preserved. Idempotent: with no file and no untracked hl binding, a no-op.
+function removeLegacyInboxBindings(manifestPairs) {
+    const owned = new Set(manifestPairs.filter((pair) => pair.table === ROOT_TABLE).map((pair) => pair.key));
+    const keys = new Set([LEGACY_INBOX_DEFAULT_KEY]);
+    const file = legacyInboxKeyFile();
+    try {
+        const configured = readFileSync(file, 'utf8').trim();
+        if (configured !== '')
+            keys.add(configured);
+    }
+    catch { /* no state file: only the default key can hold a stale binding */ }
+    for (const key of keys) {
+        if (owned.has(key))
+            continue;
+        const existing = bindingAt(ROOT_TABLE, key);
+        if (existing !== null && LEGACY_INBOX_MARKERS.every((marker) => existing.includes(marker))) {
+            tmux(['unbind-key', '-T', ROOT_TABLE, key]);
+        }
+    }
+    try {
+        rmSync(file, { force: true });
+    }
+    catch { /* best-effort */ }
+}
 function actionCommand(id) {
     switch (id) {
         case 'crtr.tmux.node.next': return ['run-shell', `crtr node cycle --dir next --pane '#{pane_id}' >/dev/null 2>&1`];
         case 'crtr.tmux.node.previous': return ['run-shell', `crtr node cycle --dir prev --pane '#{pane_id}' >/dev/null 2>&1`];
+        case 'crtr.tmux.inbox.toggle': return inboxToggleTmuxCommand();
         case 'crtr.tmux.view.next': return ['run-shell', `crtr surface view cycle --dir next --pane '#{pane_id}' >/dev/null 2>&1`];
         case 'crtr.tmux.view.previous': return ['run-shell', `crtr surface view cycle --dir prev --pane '#{pane_id}' >/dev/null 2>&1`];
         default: throw new Error(`no tmux command for ${id}`);
@@ -580,6 +633,7 @@ export function installTmuxBindings(bindings = resolveUserKeybindings()) {
     }
     if (!manifest.existed)
         adoptLegacyBindings();
+    removeLegacyInboxBindings(manifest.pairs);
     for (const pair of manifest.pairs) {
         const result = tmux(['unbind-key', '-T', pair.table, pair.key]);
         if (!result.ok && bindingAt(pair.table, pair.key) !== null) {
@@ -606,7 +660,7 @@ export function installTmuxBindings(bindings = resolveUserKeybindings()) {
     for (const gesture of bindings.gestures('crtr.tmux.menu.open')) {
         install(ROOT_TABLE, tmuxKey(gesture), menuCommand, 'crtr.tmux.menu.open', gesture);
     }
-    for (const id of ['crtr.tmux.node.next', 'crtr.tmux.node.previous']) {
+    for (const id of ['crtr.tmux.node.next', 'crtr.tmux.node.previous', 'crtr.tmux.inbox.toggle']) {
         for (const gesture of bindings.gestures(id))
             install(ROOT_TABLE, tmuxKey(gesture), actionCommand(id), id, gesture);
     }

package/dist/daemon/crtrd.js

@@ -56,7 +56,7 @@ import { dirname, join } from 'node:path';
 import { homedir } from 'node:os';
 import { spawnSync } from 'node:child_process';
 import { crtrHome, nodeDir, jobDir } from '../core/canvas/paths.js';
-import { listNodes, getRow, getNode, dueClockTriggers, consumeTrigger, advanceTrigger, listFocuses, closeFocusRow, pruneToLimit, subscribersOf, } from '../core/canvas/index.js';
+import { listNodes, getRow, getNode, migrateLegacyPidIdentities, dueClockTriggers, consumeTrigger, advanceTrigger, listFocuses, closeFocusRow, pruneToLimit, subscribersOf, } from '../core/canvas/index.js';
 import { fullName } from '../core/canvas/labels.js';
 import { transition } from '../core/runtime/lifecycle.js';
 import { isBusy, busySince } from '../core/runtime/busy.js';
@@ -65,7 +65,7 @@ import { fanDoctrineWake } from '../core/runtime/close.js';
 import { logger } from '../core/log.js';
 export { FAULT_QUIET_MS };
 import { isPidAlive, isRecordedPidAlive, recordedPidLiveness } from '../core/canvas/pid.js';
-import { reconcileBootLiveness } from '../core/canvas/boot.js';
+import { reconcileAndMigrateBoot } from '../core/canvas/boot.js';
 import { listLivePanes, tearDownNode } from '../core/runtime/placement.js';
 import { reviveNode } from '../core/runtime/revive.js';
 import { isBrokerLive } from '../core/runtime/model-swap.js';
@@ -1614,9 +1614,33 @@ export function runDaemon(opts = {}) {
     // "leave it, nothing to revive" and never calls reviveNode at all — a
     // pid-reuse collision on the first post-boot tick would silently no-op
     // forever with no revive attempt to even hit reviveNode's own reconcile call.
-    const { changed, cleared } = reconcileBootLiveness();
-    if (changed) {
-        process.stderr.write(`[crtrd] boot change detected — cleared ${cleared.length} stale pi_pid(s) recorded before this boot\n`);
+    //
+    // Ordering + gate live in reconcileAndMigrateBoot (canvas/boot.ts) so the
+    // migration-gate regression tests exercise the real composition rather than a
+    // test-side copy of these lines.
+    const { reconcile, migrated } = reconcileAndMigrateBoot(migrateLegacyPidIdentities);
+    if (reconcile.changed) {
+        process.stderr.write(`[crtrd] boot change detected — cleared ${reconcile.cleared.length} stale pi_pid(s) recorded before this boot\n`);
+    }
+    // Then, once, complete the boot-scoped-identity format migration for any
+    // broker that survived an in-place crouter upgrade and still carries a legacy
+    // `lstart#ticks` baseline: re-record it as `<bootId>#<ticks>` if its pid still
+    // names the same live process. `identitiesMatch` only TOLERATES legacy rows;
+    // this is what actually closes the cross-boot ticks-collision exposure for
+    // them, so the legacy compare lane then only engages for genuinely no-boot_id
+    // hosts.
+    //
+    // GATED on PROVEN same-boot provenance: the sweep blesses a legacy row's pid
+    // as a current-boot process (`<currentBootId>#<ticks>`) on a ticks match, so
+    // it is correct ONLY when the recorded pid provably belongs to THIS boot. We
+    // run it solely when reconciliation matched an exact kernel `boot_id` on both
+    // sides (`sameBootProven`) — never on a first-ever/absent/malformed marker or
+    // the wall-clock epoch fallback, where an equal-ticks collision with an
+    // unrelated cross-boot process could otherwise baptize a stranger. (On a
+    // detected boot change the prior-boot pids were just cleared, so there is
+    // nothing left to migrate either.)
+    if (migrated.length > 0) {
+        process.stderr.write(`[crtrd] migrated ${migrated.length} legacy pi_pid identity baseline(s) to boot-scoped format\n`);
     }
     writePidfile();
     log.info(`started (pid ${process.pid}, interval ${interval}ms)`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crouton-kit/crouter",
-  "version": "0.3.83",
+  "version": "0.3.85",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",
@@ -54,7 +54,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@crouton-kit/humanloop": "^0.3.35",
+    "@crouton-kit/humanloop": "^0.3.37",
     "@earendil-works/pi-agent-core": "0.80.6",
     "@earendil-works/pi-ai": "0.80.6",
     "@earendil-works/pi-coding-agent": "0.80.6",