@north-light/api 0.3.503 → 0.3.505

package/dist/api/client.d.ts

@@ -30,7 +30,7 @@ import type { CancelReviewRequest, CreateReviewRequest, ListReviewsQuery, Review
 import type { CreateReviewCommentRequest, EditReviewCommentRequest, ListReviewCommentsQuery, ReadReviewCommentEventsQuery, ReviewCommentActionRequest, ReviewCommentDetailDTO, ReviewCommentEventsDTO, ReviewCommentForkDTO, ReviewCommentListDTO, ReviewCommentMutationDTO, ReviewCommentRangeBatchRequest, ReviewCommentRangeBatchResultDTO } from './dto/review-comments.js';
 import type { CancelInboxTicketRequest, CanceledTicketResultDTO, InboxListDTO, InboxPageDTO, InboxPageHistoryDTO, InboxPageResponseDTO, InboxTicketIdDTO, PageFeedbackResolutionDTO, PageResponsesDTO, PageTicketResultDTO, RespondInboxPageRequest } from './dto/inbox.js';
 import type { CreateHumanRequestDTO, CreateHumanRequestRequest, HumanRequestDTO, HumanRequestIdDTO, ReplaceHumanRequestRequest, RespondHumanRequestRequest, SettleHumanRequestRequest, PageComponentListDTO } from './dto/human-requests.js';
-import type { AttentionCountsDTO, AttentionDTO, DashboardDTO, DashboardQuery, HistoryGrepQuery, HistoryGrepResultDTO, HistoryReadQuery, HistoryStatsQuery, HistoryStatsResultDTO, HistoryReadResultDTO, HistorySearchQuery, HistorySearchResultDTO, GraphDTO, PruneRequest, PruneResultDTO, RosterDTO, SnapshotDTO } from './dto/canvas.js';
+import type { AttentionCountsDTO, AttentionDTO, DashboardDTO, DashboardQuery, HistoryGrepQuery, HistoryGrepResultDTO, HistoryReadQuery, HistoryStatsQuery, HistoryStatsResultDTO, HistoryReadResultDTO, HistorySearchQuery, HistorySearchResultDTO, GraphDTO, PruneRequest, PruneResultDTO, LiveRootsDTO, RosterDTO, SnapshotDTO } from './dto/canvas.js';
 import type { AbandonWorktreeRequest, AbandonWorktreeResultDTO, CloseWorktreeResultDTO, QuarantinedWorktreeDTO, SpaceListDTO } from './dto/worktree.js';
 import type { BrokerExtensionStateDTO, BrokerExecutionRequest, BrokerGeneratedNameRequest, BrokerGeneratedNameResultDTO, BrokerModelCommitRequest, BrokerModelCommitResultDTO, BrokerParkActivityResultDTO, BrokerParkCompleteRequest, BrokerPersonaAckRequest, BrokerPersonaAckResultDTO, BrokerSessionBoundRequest, BrokerSessionBoundResultDTO, BrokerSettleDirective, BrokerSettleRequest, BrokerTelemetryRequest } from './dto/broker-ops.js';
 import type { AcknowledgeMailRequest, AcknowledgeMailResultDTO, ClaimMailRequest, ClaimMailResultDTO } from './dto/mail.js';
@@ -200,6 +200,7 @@ export declare class CrtrClient {
     commitBrokerGeneratedName(id: string, req: BrokerGeneratedNameRequest): Promise<BrokerGeneratedNameResultDTO>;
     commitBrokerPersonaAck(id: string, req: BrokerPersonaAckRequest): Promise<BrokerPersonaAckResultDTO>;
     closeNode(id: string, req?: CloseRequest): Promise<CloseResultDTO>;
+    markNodeRead(id: string): Promise<void>;
     recycleNode(id: string): Promise<NodeDetailDTO>;
     demoteNode(id: string): Promise<NodeDetailDTO>;
     promoteNode(id: string, req: PromoteRequest): Promise<NodeDetailDTO>;
@@ -447,6 +448,9 @@ export declare class CrtrClient {
      *  two indexed queries server-side, no per-row enrichment. The recurring
      *  poll target for attach/browser topology; use `canvasSnapshot` for the
      *  enriched on-demand view. */
+    liveRoots(q?: {
+        profile?: string;
+    }): Promise<LiveRootsDTO>;
     canvasRoster(): Promise<RosterDTO>;
     /** Explicitly compressed browse snapshot; the Node-only canvas source
      * decompresses it because socketFetch does not interpret content-encoding. */

package/dist/api/client.js

@@ -334,6 +334,9 @@ export class CrtrClient {
     closeNode(id, req) {
         return this.request('POST', routes.nodeClose(this.nodePath(id)), req ?? {});
     }
+    async markNodeRead(id) {
+        await this.request('POST', routes.nodeRead(this.nodePath(id)), {});
+    }
     recycleNode(id) {
         return this.request('POST', routes.nodeRecycle(this.nodePath(id)), {});
     }
@@ -824,6 +827,9 @@ export class CrtrClient {
      *  two indexed queries server-side, no per-row enrichment. The recurring
      *  poll target for attach/browser topology; use `canvasSnapshot` for the
      *  enriched on-demand view. */
+    liveRoots(q = {}) {
+        return this.request('GET', withQuery(routes.canvasLiveRoots(), q));
+    }
     canvasRoster() {
         return this.request('GET', routes.canvasRoster());
     }

package/dist/api/contract.d.ts

@@ -1,5 +1,5 @@
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export declare const CONTRACT_LEVEL = "1.17";
+export declare const CONTRACT_LEVEL = "1.18";
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export declare const REQUIRED_CONTRACT_HEADER = "Crouter-Required-Contract";
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/contract.js

@@ -12,7 +12,7 @@
 //
 // PURITY (spec §3.1): Node built-ins + `src/api/*` only.
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export const CONTRACT_LEVEL = '1.17';
+export const CONTRACT_LEVEL = '1.18';
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export const REQUIRED_CONTRACT_HEADER = 'Crouter-Required-Contract';
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/dto/canvas.d.ts

@@ -68,6 +68,8 @@ export interface HistorySearchQuery {
     from?: string;
     /** Weigh full body text in ranking (`--body`). */
     weigh_body?: boolean;
+    /** One hit per node (its best-scoring artifact), every matching node, unpaginated. Requires non-empty `nodes`; each hit carries `node_id`. */
+    per_node?: boolean;
     /** relevance | recency | oldest — already resolved to the effective sort. */
     sort?: string;
     snippet_lines?: number;
@@ -303,6 +305,44 @@ export interface BrowseCanvasDTO {
     nodes: BrowseNodeDTO[];
     edges: RosterEdgeDTO[];
 }
+/** One in-tree child of a live root, for the dashboard's expansion. */
+export interface LiveRootChildDTO {
+    node_id: NodeIdDTO;
+    name: string;
+    status: NodeStatusDTO;
+    streaming: boolean;
+    asks: number;
+    fault: string | null;
+}
+/** One live root conversation with everything the dashboard row shows, counted over its whole subtree. */
+export interface LiveRootDTO {
+    node_id: NodeIdDTO;
+    name: string;
+    cwd: string;
+    profile_id: string | null;
+    status: NodeStatusDTO;
+    /** The State line of the last recap; null before the first recap. */
+    state_line: string | null;
+    /** The persisted first message, shown while `state_line` is null. */
+    goal: string | null;
+    /** Pending inbox items (asks and reviews) from any node in the subtree. */
+    asks: number;
+    /** The oldest pending ask's inbox ticket id. */
+    first_ask_ticket_id: string | null;
+    /** The first fault in root-then-subtree order, as a short summary. */
+    fault: string | null;
+    /** Nodes in the subtree, root included, with an open turn and a live process. */
+    running_count: number;
+    /** The root settled a turn after a viewer was last shown the conversation. */
+    unread: boolean;
+    last_activity: IsoTime;
+    children: LiveRootChildDTO[];
+}
+/** `GET /v1/canvas/live-roots` — the dashboard's one-read projection. Person callers only. */
+export interface LiveRootsDTO {
+    generated_at: IsoTime;
+    rows: LiveRootDTO[];
+}
 /** One row in `GET /v1/canvas/graph`: exactly the node fields the attach graph displays. */
 export interface GraphNodeDTO {
     node_id: NodeIdDTO;

package/dist/api/routes.d.ts

@@ -59,6 +59,7 @@ export declare const routes: {
     readonly brokerRecovery: (id: string) => string;
     readonly nodeFault: (id: string) => string;
     readonly nodeClose: (id: string) => string;
+    readonly nodeRead: (id: string) => string;
     readonly nodeRecycle: (id: string) => string;
     readonly nodeDemote: (id: string) => string;
     readonly nodePromote: (id: string) => string;
@@ -92,6 +93,7 @@ export declare const routes: {
     readonly canvasHistoryRead: () => string;
     readonly canvasHistoryStats: () => string;
     readonly canvasSnapshot: () => string;
+    readonly canvasLiveRoots: () => string;
     readonly canvasRoster: () => string;
     readonly canvasBrowse: () => string;
     readonly canvasAnalytics: () => string;

package/dist/api/routes.js

@@ -77,6 +77,7 @@ export const routes = {
     brokerRecovery: (id) => `${V}/broker/${id}/recovery`,
     nodeFault: (id) => `${V}/nodes/${id}/fault`,
     nodeClose: (id) => `${V}/nodes/${id}/close`,
+    nodeRead: (id) => `${V}/nodes/${id}/read`,
     nodeRecycle: (id) => `${V}/nodes/${id}/recycle`,
     nodeDemote: (id) => `${V}/nodes/${id}/demote`,
     nodePromote: (id) => `${V}/nodes/${id}/promote`,
@@ -114,6 +115,7 @@ export const routes = {
     canvasHistoryRead: () => `${V}/canvas/history/read`,
     canvasHistoryStats: () => `${V}/canvas/history/stats`,
     canvasSnapshot: () => `${V}/canvas/snapshot`,
+    canvasLiveRoots: () => `${V}/canvas/live-roots`,
     canvasRoster: () => `${V}/canvas/roster`,
     canvasBrowse: () => `${V}/canvas/browse`,
     canvasAnalytics: () => `${V}/canvas/analytics`,

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

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

package/dist/core/keybindings/catalog.js

@@ -12,12 +12,12 @@ function binding(id, group, name, description, defaults, inputKind, contexts, sa
     });
 }
 const b = binding;
-function menuEntry(action, name, description, defaults, contexts) {
+function menuEntry(action, name, description, defaults, contexts, globalDefaults = []) {
     const menuId = `crtr.tmux.menu.${action}`;
     const globalId = `crtr.tmux.menu-global.${action}`;
     return [
         b(menuId, 'Global tmux', name, description, defaults, 'tmux-menu-selector', contexts, undefined, { field: 'menu', pairedId: globalId }),
-        b(globalId, 'Global tmux', name, description, [], 'tmux-global-action', ['tmux.root'], undefined, { field: 'global', pairedId: menuId }),
+        b(globalId, 'Global tmux', name, description, globalDefaults, 'tmux-global-action', ['tmux.root'], undefined, { field: 'global', pairedId: menuId }),
     ];
 }
 function attachEntry(menuId, actionId, name, description, 
@@ -38,6 +38,7 @@ const SETUP_TAB_CONTEXTS = ['setup.login', 'setup.list', 'setup.keybindings', 's
 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('dashboard', 'Dashboard', 'Show the live root conversations in this pane: which need you, which are running, which are idle.', ['w'], ['tmux.menu'], ['alt+shift+d']),
     ...menuEntry('promote', 'Promote to orchestrator', 'Promote the focused node to orchestrator — it holds a roadmap and delegates.', ['o'], ['tmux.menu']),
     ...menuEntry('demote-mode', 'Demote to base node', 'Demote the focused orchestrator back to a base node — hands-on again in its own window, no roadmap to drive.', ['shift+o'], ['tmux.menu']),
     ...menuEntry('resume', 'Find node', 'Open the canvas navigator and go to the chosen node.', ['/'], ['tmux.menu']),
@@ -129,6 +130,7 @@ export const BINDING_CATALOG = Object.freeze([
     b('crtr.inspector.refresh', 'Inspector', 'Refresh', 'Refresh the Inspector now.', ['g', 'r'], 'terminal', ['inspector']),
     b('crtr.inspector.quit', 'Inspector', 'Quit', 'Leave the Inspector.', ['q'], 'terminal', ['inspector'], 'leave-screen'),
     ...browseBindings(),
+    ...dashboardBindings(),
     ...profileBindings(),
     ...setupBindings(),
 ]);
@@ -166,6 +168,33 @@ function browseBindings() {
         b('crtr.browse.search.quit', 'Browse and pickers', 'Quit browse', 'Leave canvas browse from search.', ['ctrl+c'], 'terminal', ['browse.search'], 'leave-screen'),
     ];
 }
+function dashboardBindings() {
+    const ctx = 'dashboard';
+    const confirm = 'dashboard.confirm';
+    const input = 'dashboard.input';
+    const g = 'Dashboard';
+    return [
+        b('crtr.dashboard.down', g, 'Move down', 'Move to the next row.', ['j', 'down'], 'terminal', [ctx]),
+        b('crtr.dashboard.up', g, 'Move up', 'Move to the previous row.', ['k', 'up'], 'terminal', [ctx]),
+        b('crtr.dashboard.first', g, 'First row', 'Move to the first row.', ['g'], 'terminal', [ctx]),
+        b('crtr.dashboard.last', g, 'Last row', 'Move to the last row.', ['shift+g'], 'terminal', [ctx]),
+        b('crtr.dashboard.expand', g, 'Expand', 'Show the selected conversation’s children.', ['l', 'right'], 'terminal', [ctx]),
+        b('crtr.dashboard.collapse', g, 'Collapse', 'Hide the selected conversation’s children.', ['h', 'left'], 'terminal', [ctx]),
+        b('crtr.dashboard.open', g, 'Open', 'Open the selected conversation in this pane.', ['enter'], 'terminal', [ctx]),
+        b('crtr.dashboard.pin', g, 'Pin', 'Star or unstar the selected conversation.', ['p'], 'terminal', [ctx]),
+        b('crtr.dashboard.rename', g, 'Rename', 'Rename the selected conversation.', ['shift+r'], 'terminal', [ctx]),
+        b('crtr.dashboard.close', g, 'Close', 'Finish the selected conversation and remove its row.', ['x'], 'terminal', [ctx]),
+        b('crtr.dashboard.confirm-close', g, 'Confirm close', 'Close a conversation that is running.', ['y'], 'terminal', [confirm]),
+        b('crtr.dashboard.cancel-close', g, 'Cancel close', 'Keep the running conversation.', ['n', 'escape'], 'terminal', [confirm]),
+        b('crtr.dashboard.profile', g, 'Toggle profile', 'Switch between this profile and all profiles.', ['shift+p'], 'terminal', [ctx]),
+        b('crtr.dashboard.input', g, 'New conversation', 'Focus the new-conversation input.', ['n'], 'terminal', [ctx]),
+        b('crtr.dashboard.input-cancel', g, 'Leave input', 'Leave the input without clearing it.', ['escape'], 'terminal', [input]),
+        b('crtr.dashboard.input-submit', g, 'Start conversation', 'Start a root conversation from the input text.', ['enter'], 'terminal', [input]),
+        b('crtr.dashboard.directory-next', g, 'Next directory', 'Select the next directory for the new conversation.', ['tab'], 'terminal', [input]),
+        b('crtr.dashboard.directory-previous', g, 'Previous directory', 'Select the previous directory for the new conversation.', ['shift+tab'], 'terminal', [input]),
+        b('crtr.dashboard.help', g, 'Help', 'Show the dashboard keys.', ['?'], 'terminal', [ctx]),
+    ];
+}
 function profileBindings() {
     const menu = 'profile.menu';
     const search = 'profile.search';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.503",
+  "version": "0.3.505",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",