@agi-fans/dsh-tui 0.9.0 → 0.10.0

package/lib/commands/trajectory.js

@@ -0,0 +1,20 @@
+/** Full-screen session Trajectory command registered through dsh-commands. */
+import { registerCommands } from "./registration.js";
+export const name = 'omdsh-command-trajectory';
+export const inject = ['commands', 'tui'];
+function openTrajectory(ctx, invocation) {
+    if (invocation.rawInput.trim() !== '')
+        return { kind: 'error', text: 'Usage: /trajectory' };
+    if (!ctx.tui.openTrajectory(invocation.agent.session.events)) {
+        return { kind: 'error', text: 'Trajectory requires an interactive terminal.' };
+    }
+    return { kind: 'success' };
+}
+export function apply(ctx) {
+    registerCommands(ctx, [{
+            name: 'trajectory',
+            description: 'Inspect the session event trajectory',
+            handler: invocation => openTrajectory(ctx, invocation),
+        }], 'omdsh trajectory command');
+}
+//# sourceMappingURL=trajectory.js.map

package/lib/commands/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../../src/commands/trajectory.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAI9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,MAAM,CAAC,MAAM,IAAI,GAAG,0BAA0B,CAAA;AAC9C,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;AAEzC,SAAS,cAAc,CAAC,GAAY,EAAE,UAA6B;IACjE,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAA;IAC3F,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,8CAA8C,EAAE,CAAA;IAChF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,gBAAgB,CAAC,GAAG,EAAE,CAAC;YACrB,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,sCAAsC;YACnD,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC;SACvD,CAAC,EAAE,0BAA0B,CAAC,CAAA;AACjC,CAAC"}

package/lib/definition.d.ts

@@ -48,6 +48,13 @@ export interface TuiPrompt {
             tone: 'success' | 'warning' | 'error' | 'muted';
         };
     }[];
+    /** Optional single-key actions applied to the active option while the filter is empty. */
+    actions?: readonly {
+        key: string;
+        label: string;
+        /** Prefix returned before the selected option value. */
+        valuePrefix: string;
+    }[];
     multiSelect?: boolean;
     allowCustom?: boolean;
     /** Mask custom input while retaining the real value only in the prompt editor. */
@@ -110,6 +117,9 @@ export interface TuiSubagentView {
     readonly mode?: 'one-shot' | 'continuable';
     readonly phase: TuiSubagentPhase;
     readonly activity: readonly TuiSubagentActivity[];
+    /** First and latest durable event timestamps for elapsed-time presentation. */
+    readonly startedAt?: number;
+    readonly updatedAt?: number;
 }
 /** Live descendant roster for the active root session. */
 export interface TuiSubagentRoster {
@@ -196,6 +206,8 @@ export interface TuiService {
     }[]): void;
     /** Replace commands contributed by the active agent's Harness scope. */
     setCommands(commands: readonly TuiCommand[]): void;
+    /** Open a keyboard-driven event ledger for the active session. */
+    openTrajectory(events: readonly SessionEvent[]): boolean;
     /** Append a direct UI/command result without fabricating a session event. */
     notice(text: string, options?: TuiNoticeOptions): void;
     /** Append one successful plugin command result using the command-output surface. */

package/lib/input/keybindings-config.d.ts

@@ -1,5 +1,5 @@
 /** User-overridable application keybindings loaded from one JSON document. */
-export type TuiAction = 'external-editor' | 'retry' | 'paste-clipboard' | 'copy-prompt' | 'copy-line' | 'inspect-subagent';
+export type TuiAction = 'external-editor' | 'retry' | 'paste-clipboard' | 'copy-prompt' | 'copy-line' | 'inspect-subagent' | 'cycle-model-forward' | 'cycle-model-backward' | 'cycle-reasoning';
 export declare const DEFAULT_KEYBINDINGS: Readonly<Record<string, TuiAction>>;
 /** Load `{ "key-id": "action" }`; invalid rows are ignored independently. */
 export declare function loadKeybindings(path: string | undefined): Record<string, TuiAction>;

package/lib/input/keybindings-config.js

@@ -7,8 +7,14 @@ export const DEFAULT_KEYBINDINGS = Object.freeze({
     'alt+c': 'copy-prompt',
     'ctrl+alt+c': 'copy-line',
     'alt+a': 'inspect-subagent',
+    'ctrl+p': 'cycle-model-forward',
+    'alt+p': 'cycle-model-backward',
+    'ctrl+t': 'cycle-reasoning',
 });
-const ACTIONS = ['external-editor', 'retry', 'paste-clipboard', 'copy-prompt', 'copy-line', 'inspect-subagent'];
+const ACTIONS = [
+    'external-editor', 'retry', 'paste-clipboard', 'copy-prompt', 'copy-line', 'inspect-subagent',
+    'cycle-model-forward', 'cycle-model-backward', 'cycle-reasoning',
+];
 /** Load `{ "key-id": "action" }`; invalid rows are ignored independently. */
 export function loadKeybindings(path) {
     const result = { ...DEFAULT_KEYBINDINGS };

package/lib/input/keybindings-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"keybindings-config.js","sourceRoot":"","sources":["../../src/input/keybindings-config.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAItC,MAAM,CAAC,MAAM,mBAAmB,GAAwC,MAAM,CAAC,MAAM,CAAC;IACpF,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,aAAa;IACtB,YAAY,EAAE,WAAW;IACzB,OAAO,EAAE,kBAAkB;CAC5B,CAAC,CAAA;AAEF,MAAM,OAAO,GAAyB,CAAC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAA;AAErI,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,IAAwB;IACtD,MAAM,MAAM,GAA8B,EAAE,GAAG,mBAAmB,EAAE,CAAA;IACpE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QAC9D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAA;QAChE,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAmB,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,MAAmB,CAAA;QAC1H,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,kEAAkE,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAA;AACf,CAAC"}
+{"version":3,"file":"keybindings-config.js","sourceRoot":"","sources":["../../src/input/keybindings-config.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAKtC,MAAM,CAAC,MAAM,mBAAmB,GAAwC,MAAM,CAAC,MAAM,CAAC;IACpF,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,iBAAiB;IAC3B,OAAO,EAAE,aAAa;IACtB,YAAY,EAAE,WAAW;IACzB,OAAO,EAAE,kBAAkB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,iBAAiB;CAC5B,CAAC,CAAA;AAEF,MAAM,OAAO,GAAyB;IACpC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB;IAC7F,qBAAqB,EAAE,sBAAsB,EAAE,iBAAiB;CACjE,CAAA;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,IAAwB;IACtD,MAAM,MAAM,GAA8B,EAAE,GAAG,mBAAmB,EAAE,CAAA;IACpE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QAC9D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAA;QAChE,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAmB,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,MAAmB,CAAA;QAC1H,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,kEAAkE,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAA;AACf,CAAC"}

package/lib/runtime/provider-local.d.ts

@@ -92,6 +92,7 @@ export declare class LocalTui implements TuiService {
     setInspectedSubagent(inspected: TuiInspectedSubagent | undefined): void;
     setTools(tools: readonly ToolInfo[]): void;
     setCommands(commands: readonly TuiCommand[]): void;
+    openTrajectory(events: readonly SessionEvent[]): boolean;
     setSessionSearch(search?: SessionSearcher): void;
     setFileSearch(search?: FileSearcher): void;
     setImageValidator(validate?: (image: TuiInputImage) => Promise<void>): void;

package/lib/runtime/provider-local.js

@@ -10,6 +10,7 @@
  * printing of settled blocks.
  * @module @agi-fans/dsh-tui
  */
+import { TerminalNotificationController, terminalNotificationSequence } from "./terminal-notifications.js";
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
@@ -24,6 +25,8 @@ import { buildCopyTargets, extractCopyTarget, parseCopyKind } from "../views/cop
 import { applyHistorySearchEvent, createHistorySearch, } from "../views/history-search.js";
 import { InputEditor, lineEnd, lineStart } from "../input/editor.js";
 import { applySettingsEvent, createSettings, } from "../views/settings-list.js";
+import { appendTrajectoryEvent, applyTrajectoryEvent, createTrajectory, } from "../views/trajectory.js";
+import { applyAgentHubEvent, createAgentHub, updateAgentHub, } from "../views/agent-hub.js";
 import { applyEvent, blockLines, initialTranscript, replayEvents, renderView, TRANSCRIPT_FAST_SCROLL, } from "../views/event-views.js";
 import { flushPending, parseKeys } from "../input/keys.js";
 import { MainScreenRenderer } from "../chrome/main-screen-renderer.js";
@@ -83,6 +86,8 @@ export class LocalTui {
     #search = null;
     #settings = null;
     #copySelector = null;
+    #trajectory = null;
+    #agentHub = null;
     #pending = null;
     #queuedSubmissions = [];
     /** Newer queue entries temporarily detached while Up browses backward. */
@@ -128,6 +133,9 @@ export class LocalTui {
     #expandTools = false;
     #checkUpdates = true;
     #startupChangelog = 'summary';
+    #notifications = new TerminalNotificationController();
+    #notificationPolicy = 'off';
+    #notificationThreshold = '30s';
     #statusBar = defaultStatusBarConfig();
     #toolsExpanded = false;
     #expandedToolCalls = new Set();
@@ -238,6 +246,9 @@ export class LocalTui {
     }
     event(event, presentation) {
         this.#state = applyEvent(this.#state, event, presentation);
+        this.#emitNotification(this.#notifications.event({ type: event.type, ...('reason' in event && typeof event.reason === 'string' ? { reason: event.reason } : {}) }));
+        if (this.#trajectory !== null)
+            this.#trajectory = appendTrajectoryEvent(this.#trajectory, event);
         this.#syncTick();
         if (this.#tty) {
             if (event.type === 'assistant/chunk' && this.#streamRenderMs > 0) {
@@ -277,6 +288,12 @@ export class LocalTui {
             : { agents: roster.agents.map(agent => ({ ...agent, activity: [...agent.activity] })) };
         if ((this.#subagents?.agents.length ?? 0) === 0)
             this.#subagentLauncherFocused = false;
+        if (this.#agentHub !== null) {
+            if (this.#subagents === undefined)
+                this.#agentHub = null;
+            else
+                this.#agentHub = updateAgentHub(this.#agentHub, this.#subagents);
+        }
         const inspected = this.#inspected;
         if (inspected !== undefined) {
             const current = this.#subagents?.agents.find(agent => agent.id === inspected.id);
@@ -315,6 +332,19 @@ export class LocalTui {
         if (this.#tty)
             this.#render();
     }
+    openTrajectory(events) {
+        if (!this.#tty)
+            return false;
+        this.#trajectory = createTrajectory(events);
+        this.#agentHub = null;
+        this.#prompt = null;
+        this.#settings = null;
+        this.#copySelector = null;
+        this.#search = null;
+        this.#ac = null;
+        this.#render();
+        return true;
+    }
     setSessionSearch(search) {
         this.#searchSessions = search;
         this.#refreshAutocomplete();
@@ -355,6 +385,7 @@ export class LocalTui {
             return Promise.reject(new Error('omdsh-tui: prompt already in flight'));
         if (this.#disposed || request.signal?.aborted === true)
             return Promise.resolve(null);
+        this.#emitNotification(this.#notifications.humanPrompt());
         this.#editor.setText('');
         this.#ac = null;
         return new Promise((resolve) => {
@@ -386,6 +417,7 @@ export class LocalTui {
         });
     }
     replaceSession(events, presentations, status = 'idle') {
+        this.#trajectory = null;
         const state = replayEvents(events, presentations);
         this.#state = { ...state, status, compactCommandId: undefined };
         this.#plainPrinted = 0;
@@ -417,6 +449,9 @@ export class LocalTui {
         this.#expandTools = prefs.expandTools;
         this.#checkUpdates = prefs.checkUpdates ?? true;
         this.#startupChangelog = prefs.startupChangelog ?? 'summary';
+        this.#notificationPolicy = prefs.notifications ?? 'off';
+        this.#notificationThreshold = prefs.notificationThreshold ?? '30s';
+        this.#configureNotifications();
         this.#statusBar = resolveStatusBarConfig(prefs.statusBar, prefs.statusPreset);
         this.#toolsExpanded = prefs.expandTools;
         if (this.#settings !== null)
@@ -714,6 +749,8 @@ export class LocalTui {
                 ...(this.#subagents === undefined ? {} : { subagents: this.#subagents }),
                 subagentLauncherFocused: this.#subagentLauncherFocused,
                 ...(this.#inspected === undefined ? {} : { inspected: this.#inspected }),
+                ...(this.#trajectory === null ? {} : { trajectory: this.#trajectory }),
+                ...(this.#agentHub === null ? {} : { agentHub: this.#agentHub }),
                 statusBar: this.#statusBar,
                 ...(this.#prompt === null ? {} : { promptSelector: this.#prompt }),
                 ...(this.#settings !== null
@@ -1026,6 +1063,28 @@ export class LocalTui {
             this.#lastEscapeTime = 0;
         if (this.#handlePrompt(event))
             return;
+        if (this.#trajectory !== null) {
+            const command = applyTrajectoryEvent(this.#trajectory, event);
+            if ('close' in command)
+                this.#trajectory = null;
+            else
+                this.#trajectory = command.state;
+            this.#render();
+            return;
+        }
+        if (this.#agentHub !== null) {
+            const command = applyAgentHubEvent(this.#agentHub, event);
+            if ('close' in command)
+                this.#agentHub = null;
+            else if ('open' in command) {
+                this.#agentHub = null;
+                this.#openInspect(command.open);
+            }
+            else
+                this.#agentHub = command.state;
+            this.#render();
+            return;
+        }
         if (event.type === 'key') {
             const action = this.#keybindings[event.id];
             if (action !== undefined) {
@@ -1184,6 +1243,15 @@ export class LocalTui {
             return false;
         if (prompt.request.presentation === 'plan-review')
             return this.#handlePlanReview(event, prompt);
+        if (event.type === 'text' && this.#editor.text === '') {
+            const action = prompt.request.actions?.find(item => item.key === event.value);
+            const selected = filteredPromptOptions(prompt.request, '')[prompt.selected];
+            if (action !== undefined && selected !== undefined) {
+                this.#finishPrompt(action.valuePrefix + (selected.value ?? selected.label));
+                this.#render();
+                return true;
+            }
+        }
         if (event.type === 'text' && event.value === ' ' && prompt.request.multiSelect === true && this.#editor.text === '') {
             this.#prompt = togglePromptSelection(prompt);
             this.#render();
@@ -1391,31 +1459,21 @@ export class LocalTui {
         for (const listener of this.#inspectCloses)
             listener();
     }
-    async #pickSubagent() {
+    #pickSubagent() {
         this.#subagentLauncherFocused = false;
         const agents = this.#subagents?.agents ?? [];
         if (agents.length === 0) {
             this.notice('No subagents are available in this session.');
             return;
         }
-        const initialValue = this.#inspected?.id ?? agents[0]?.id;
-        const answer = await this.prompt({
-            title: 'Agent Hub',
-            question: 'Open a subagent transcript',
-            options: agents.map(agent => ({
-                label: agent.label,
-                value: agent.id,
-                description: agent.activity.at(-1)?.text ?? agent.phase,
-            })),
-            ...(initialValue === undefined ? {} : { initialValue }),
-            allowCustom: false,
-            presentation: 'fullscreen-list',
-            filterable: true,
-            submitLabel: 'open',
-        });
-        if (answer === null || answer === '')
-            return;
-        this.#openInspect(answer);
+        this.#prompt = null;
+        this.#settings = null;
+        this.#copySelector = null;
+        this.#search = null;
+        this.#trajectory = null;
+        this.#ac = null;
+        this.#agentHub = createAgentHub({ agents });
+        this.#render();
     }
     #prefs() {
         return {
@@ -1424,6 +1482,8 @@ export class LocalTui {
             expandTools: this.#expandTools,
             checkUpdates: this.#checkUpdates,
             startupChangelog: this.#startupChangelog,
+            notifications: this.#notificationPolicy,
+            notificationThreshold: this.#notificationThreshold,
             statusBar: {
                 ...this.#statusBar,
                 groups: [...this.#statusBar.groups],
@@ -1442,6 +1502,9 @@ export class LocalTui {
         this.#expandTools = prefs.expandTools;
         this.#checkUpdates = prefs.checkUpdates ?? true;
         this.#startupChangelog = prefs.startupChangelog ?? 'summary';
+        this.#notificationPolicy = prefs.notifications ?? 'off';
+        this.#notificationThreshold = prefs.notificationThreshold ?? '30s';
+        this.#configureNotifications();
         this.#statusBar = resolveStatusBarConfig(prefs.statusBar, prefs.statusPreset);
         if (expandChanged)
             this.#toolsExpanded = prefs.expandTools;
@@ -1827,6 +1890,8 @@ export class LocalTui {
         this.#search = null;
         this.#settings = null;
         this.#copySelector = null;
+        this.#trajectory = null;
+        this.#agentHub = null;
         this.#followTail();
         // Image placeholders are TUI-owned. Mixed image+slash drafts stay a
         // submission so restore can keep the original markers; the runner strips
@@ -2031,6 +2096,20 @@ export class LocalTui {
             blocks: [...this.#state.blocks, { kind: 'notice', level: 'info', text }],
         };
     }
+    #configureNotifications() {
+        const thresholds = { '15s': 15_000, '30s': 30_000, '1m': 60_000, '2m': 120_000 };
+        this.#notifications.configure({
+            policy: this.#notificationPolicy,
+            thresholdMs: thresholds[this.#notificationThreshold],
+        });
+    }
+    #emitNotification(notification) {
+        if (notification === undefined || !this.#tty)
+            return;
+        const sequence = terminalNotificationSequence(notification);
+        if (sequence !== '')
+            this.#term.output.write(sequence);
+    }
     #toolCatalog() {
         this.#state = {
             ...this.#state,
@@ -2053,6 +2132,18 @@ export class LocalTui {
             this.#submit('/retry');
             return;
         }
+        if (action === 'cycle-model-forward') {
+            this.#submit('/model next');
+            return;
+        }
+        if (action === 'cycle-model-backward') {
+            this.#submit('/model previous');
+            return;
+        }
+        if (action === 'cycle-reasoning') {
+            this.#submit('/model reasoning');
+            return;
+        }
         if (action === 'copy-prompt') {
             void this.#copyPicked(this.#editor.text, 'current prompt');
             return;