@agi-fans/dsh-tui 0.1.0

package/lib/command-model.js

@@ -0,0 +1,87 @@
+/** Model/provider selection command registered through dsh-commands. */
+import { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+import { registerCommands } from "./command-registration.js";
+export const name = 'omdsh-command-model';
+export const inject = ['commands', 'omdshSession', 'tui', 'llm'];
+const FIXED_CHOICE = {
+    presentation: 'fullscreen-list',
+    filterable: true,
+    allowCustom: false,
+};
+function selected(raw, values) {
+    const index = /^\d+$/u.test(raw) ? Number(raw) - 1 : -1;
+    return index >= 0 ? values[index] : raw;
+}
+async function selectModel(ctx, invocation) {
+    if (invocation.rawInput.trim() !== '')
+        return { kind: 'error', text: 'Usage: /model' };
+    const providers = ctx.llm.listProviders();
+    if (providers.length === 0)
+        return { kind: 'error', text: 'No model providers are registered.' };
+    const current = ctx.omdshSession.selection(invocation.agent);
+    const providerRaw = await ctx.tui.prompt({
+        ...FIXED_CHOICE,
+        title: 'Model provider',
+        question: 'Choose a provider',
+        options: providers.map(provider => ({ label: provider.id, description: provider.name })),
+        signal: invocation.signal,
+    });
+    if (providerRaw === null)
+        return { kind: 'success' };
+    const provider = selected(providerRaw, providers.map(entry => entry.id));
+    if (provider === undefined || !providers.some(entry => entry.id === provider)) {
+        return { kind: 'error', text: `Unknown provider: ${providerRaw}` };
+    }
+    const models = await ctx.llm.listModels(provider);
+    const modelRaw = await ctx.tui.prompt({
+        ...FIXED_CHOICE,
+        title: 'Model',
+        question: `Choose a model for ${provider}`,
+        options: models.map(model => ({ label: model.id, description: model.description ?? model.name })),
+        signal: invocation.signal,
+    });
+    if (modelRaw === null)
+        return { kind: 'success' };
+    const model = selected(modelRaw, models.map(entry => entry.id));
+    if (model === undefined || !models.some(entry => entry.id === model)) {
+        return { kind: 'error', text: `Unknown model: ${modelRaw}` };
+    }
+    const info = await ctx.llm.resolveModelInfo(provider, model, invocation.signal);
+    let reasoningEffort = current.reasoningEffort;
+    if (info.reasoning === undefined) {
+        reasoningEffort = undefined;
+    }
+    else {
+        const effortRaw = await ctx.tui.prompt({
+            ...FIXED_CHOICE,
+            title: 'Reasoning effort',
+            question: 'Choose reasoning effort',
+            options: info.reasoning.efforts.map(effort => ({ label: String(effort.id), description: effort.description ?? effort.name })),
+            signal: invocation.signal,
+        });
+        if (effortRaw === null)
+            return { kind: 'success' };
+        const effortIds = info.reasoning.efforts.map(entry => String(entry.id));
+        const resolved = selected(effortRaw, effortIds);
+        if (resolved === undefined || !effortIds.includes(resolved)) {
+            return { kind: 'error', text: `Unknown reasoning effort: ${effortRaw}` };
+        }
+        reasoningEffort = ReasoningEffortId(resolved);
+    }
+    const selection = {
+        provider,
+        model,
+        ...(reasoningEffort === undefined ? {} : { reasoningEffort }),
+    };
+    await ctx.omdshSession.changeSelection(invocation.agent, selection, info);
+    return {
+        kind: 'success',
+        text: `Model: ${provider}/${model}${reasoningEffort === undefined ? '' : ` (${String(reasoningEffort)})`}`,
+    };
+}
+export function apply(ctx) {
+    registerCommands(ctx, [
+        { name: 'model', description: 'Select provider, model, and reasoning effort', handler: invocation => selectModel(ctx, invocation) },
+    ], 'omdsh model command');
+}
+//# sourceMappingURL=command-model.js.map

package/lib/command-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-model.js","sourceRoot":"","sources":["../src/command-model.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAKxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAE5D,MAAM,CAAC,MAAM,IAAI,GAAG,qBAAqB,CAAA;AACzC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;AAEhE,MAAM,YAAY,GAAG;IACnB,YAAY,EAAE,iBAA0B;IACxC,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,KAAK;CACnB,CAAA;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,MAAyB;IACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACvD,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;AACzC,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,GAAY,EAAE,UAA6B;IACpE,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAA;IACtF,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAA;IACzC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,oCAAoC,EAAE,CAAA;IAChG,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;IAC5D,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;QACvC,GAAG,YAAY;QACf,KAAK,EAAE,gBAAgB;QACvB,QAAQ,EAAE,mBAAmB;QAC7B,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACxF,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAC,CAAA;IACF,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;IACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IACxE,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,WAAW,EAAE,EAAE,CAAA;IACpE,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;QACpC,GAAG,YAAY;QACf,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,sBAAsB,QAAQ,EAAE;QAC1C,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACjG,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAC,CAAA;IACF,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,QAAQ,EAAE,EAAE,CAAA;IAC9D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;IAC/E,IAAI,eAAe,GAAG,OAAO,CAAC,eAAe,CAAA;IAC7C,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,eAAe,GAAG,SAAS,CAAA;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;YACrC,GAAG,YAAY;YACf,KAAK,EAAE,kBAAkB;YACzB,QAAQ,EAAE,yBAAyB;YACnC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7H,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAA;QACF,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;QACvE,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;QAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,6BAA6B,SAAS,EAAE,EAAE,CAAA;QAC1E,CAAC;QACD,eAAe,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAC/C,CAAC;IACD,MAAM,SAAS,GAAmB;QAChC,QAAQ;QACR,KAAK;QACL,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;KAC9D,CAAA;IACD,MAAM,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;IACzE,OAAO;QACL,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU,QAAQ,IAAI,KAAK,GAAG,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE;KAC3G,CAAA;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,gBAAgB,CAAC,GAAG,EAAE;QACpB,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,8CAA8C,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE;KACpI,EAAE,qBAAqB,CAAC,CAAA;AAC3B,CAAC"}

package/lib/command-output.d.ts

@@ -0,0 +1,6 @@
+/** Shared presentation for successful slash-command output. */
+import { type Theme } from './theme.ts';
+/** Render a command result without the generic notice frame. */
+export declare function renderCommandOutput(command: string, text: string, theme: Theme, width: number): string[];
+/** Subtle separator used only between adjacent, different command surfaces. */
+export declare function renderCommandSeparator(theme: Theme, width: number): string;

package/lib/command-output.js

@@ -0,0 +1,33 @@
+/** Shared presentation for successful slash-command output. */
+import { renderMarkdown } from "./markdown.js";
+import { BOX } from "./theme.js";
+import { truncateToWidth, visibleWidth, wrapText } from "./width.js";
+/** Render a command result without the generic notice frame. */
+export function renderCommandOutput(command, text, theme, width) {
+    const normalized = text.replaceAll('\r\n', '\n').replaceAll('\r', '\n').trimEnd();
+    const rows = normalized.split('\n');
+    if (rows.length <= 1) {
+        const prefix = width > 2 ? '  ' : '';
+        const continuation = ' '.repeat(visibleWidth(prefix));
+        return wrapText(normalized, Math.max(1, width - visibleWidth(prefix))).map((line, index) => truncateToWidth((index === 0 ? prefix : continuation) + theme.fg('dim', line), width));
+    }
+    const inset = width > 2 ? 1 : 0;
+    const contentWidth = Math.max(1, width - inset * 2);
+    const prefix = ' '.repeat(inset);
+    const first = rows.shift()?.trim() ?? '';
+    const title = first === '' ? `/${command}` : first;
+    const body = rows.join('\n').trim();
+    const heading = prefix + theme.bold(theme.fg('accent', truncateToWidth(title, contentWidth)));
+    if (body === '')
+        return [heading];
+    return [heading, '', ...renderMarkdown(body, theme, contentWidth).map(line => prefix + line)];
+}
+/** Subtle separator used only between adjacent, different command surfaces. */
+export function renderCommandSeparator(theme, width) {
+    if (width <= 0)
+        return '';
+    if (width <= 2)
+        return theme.fg('border', BOX.horizontal.repeat(width));
+    return ' ' + theme.fg('border', BOX.horizontal.repeat(width - 2)) + ' ';
+}
+//# sourceMappingURL=command-output.js.map

package/lib/command-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-output.js","sourceRoot":"","sources":["../src/command-output.ts"],"names":[],"mappings":"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"}

package/lib/command-queue.d.ts

@@ -0,0 +1,5 @@
+/** Follow-up and steering queue commands registered through dsh-commands. */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "omdsh-command-queue";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/command-queue.js

@@ -0,0 +1,62 @@
+/** Follow-up and steering queue commands registered through dsh-commands. */
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { registerCommands } from "./command-registration.js";
+export const name = 'omdsh-command-queue';
+export const inject = ['commands'];
+function messageText(message) {
+    return message.content.map(block => block.type === 'text' ? block.text : `[${block.type}]`).join('');
+}
+function tableCell(value) {
+    return value.replace(/\|/gu, '\\|').replace(/\s+/gu, ' ').trim();
+}
+function messageTable(messages) {
+    if (messages.length === 0)
+        return ['_None queued._'];
+    return [
+        '| # | Message |',
+        '|---|---|',
+        ...messages.map((message, index) => `| ${index + 1} | ${tableCell(messageText(message))} |`),
+    ];
+}
+function steer(invocation) {
+    const input = invocation.rawInput.trim();
+    if (input === '')
+        return { kind: 'error', text: 'Usage: /steer <message>' };
+    invocation.agent.steer(createUserMessage({ content: [{ type: 'text', text: input }], source: { kind: 'user' } }));
+    return { kind: 'success', text: 'Steering queued for the next step.' };
+}
+function showQueue(invocation) {
+    if (invocation.rawInput.trim() !== '')
+        return { kind: 'error', text: 'Usage: /queue' };
+    const inbox = invocation.agent.inbox;
+    const total = inbox.nextTurn.length + inbox.nextStep.length;
+    return {
+        kind: 'success',
+        text: [
+            `Queued Messages · ${total}`,
+            '',
+            `**Follow-ups · ${inbox.nextTurn.length}**`,
+            ...messageTable(inbox.nextTurn),
+            '',
+            `**Steering · ${inbox.nextStep.length}**`,
+            ...messageTable(inbox.nextStep),
+        ].join('\n'),
+    };
+}
+function dequeue(invocation) {
+    if (invocation.rawInput.trim() !== '')
+        return { kind: 'error', text: 'Usage: /dequeue' };
+    const inbox = invocation.agent.inbox;
+    const count = inbox.nextTurn.length + inbox.nextStep.length;
+    inbox.splice('next-turn', 0, inbox.nextTurn.length, []);
+    inbox.splice('next-step', 0, inbox.nextStep.length, []);
+    return { kind: 'success', text: `Removed ${count} queued message${count === 1 ? '' : 's'}.` };
+}
+export function apply(ctx) {
+    registerCommands(ctx, [
+        { name: 'steer', description: 'Send guidance to the next model step', input: { hint: '<message>' }, handler: steer },
+        { name: 'queue', description: 'Show queued follow-up and steering messages', handler: showQueue },
+        { name: 'dequeue', description: 'Clear queued follow-up and steering messages', handler: dequeue },
+    ], 'omdsh queue commands');
+}
+//# sourceMappingURL=command-queue.js.map

package/lib/command-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-queue.js","sourceRoot":"","sources":["../src/command-queue.ts"],"names":[],"mappings":"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"}

package/lib/command-registration.d.ts

@@ -0,0 +1,5 @@
+/** Shared lifecycle ownership for omdsh command plugins. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { CommandDefinition } from '@deepseek-ai/dsh-commands';
+/** Register one command group, unregister before draining in-flight handlers. */
+export declare function registerCommands(ctx: Context, definitions: readonly CommandDefinition[], label: string): void;

package/lib/command-registration.js

@@ -0,0 +1,20 @@
+/** Shared lifecycle ownership for omdsh command plugins. */
+/** Register one command group, unregister before draining in-flight handlers. */
+export function registerCommands(ctx, definitions, label) {
+    const active = new Set();
+    ctx.effect(function* () {
+        yield async () => { await Promise.allSettled(active); };
+        for (const definition of definitions) {
+            yield ctx.commands.register({
+                ...definition,
+                handler: (invocation) => {
+                    const operation = Promise.resolve(definition.handler(invocation));
+                    active.add(operation);
+                    void operation.then(() => { active.delete(operation); }, () => { active.delete(operation); });
+                    return operation;
+                },
+            });
+        }
+    }, label);
+}
+//# sourceMappingURL=command-registration.js.map

package/lib/command-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registration.js","sourceRoot":"","sources":["../src/command-registration.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAK5D,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,GAAY,EAAE,WAAyC,EAAE,KAAa;IACrG,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAA;IAChD,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;QAClB,MAAM,KAAK,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA,CAAC,CAAC,CAAA;QACtD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,GAAG,UAAU;gBACb,OAAO,EAAE,CAAC,UAAU,EAAE,EAAE;oBACtB,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;oBACjE,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;oBACrB,KAAK,SAAS,CAAC,IAAI,CACjB,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA,CAAC,CAAC,EAClC,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA,CAAC,CAAC,CACnC,CAAA;oBACD,OAAO,SAAS,CAAA;gBAClB,CAAC;aACF,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,EAAE,KAAK,CAAC,CAAA;AACX,CAAC"}

package/lib/command-session.d.ts

@@ -0,0 +1,5 @@
+/** Session lifecycle and inspection commands registered through dsh-commands. */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "omdsh-command-session";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/command-session.js

@@ -0,0 +1,153 @@
+/** Session lifecycle and inspection commands registered through dsh-commands. */
+import { registerCommands } from "./command-registration.js";
+import { formatRelativeAge } from "./relative-time.js";
+export const name = 'omdsh-command-session';
+export const inject = ['commands', 'omdshSession', 'tui'];
+function humanText(event) {
+    if (event.type !== 'user/message' || event.data.source.kind !== 'user')
+        return undefined;
+    const text = event.data.content
+        .filter((block) => block.type === 'text')
+        .map(block => block.text)
+        .join('\n');
+    return text === '' ? undefined : text;
+}
+async function newSession(ctx, invocation) {
+    if (invocation.rawInput.trim() !== '')
+        return { kind: 'error', text: 'Usage: /new' };
+    if (invocation.agent.status === 'running') {
+        return { kind: 'error', text: 'Finish or interrupt the active turn before starting a new session.' };
+    }
+    await ctx.omdshSession.newSession(invocation.agent);
+    return { kind: 'success', text: 'Started a new session.' };
+}
+async function resumeSession(ctx, invocation) {
+    if (ctx.get('sessionPersistence') === undefined)
+        return { kind: 'error', text: 'Session persistence is not configured.' };
+    if (invocation.agent.status === 'running') {
+        return { kind: 'error', text: 'Finish or interrupt the active turn before resuming another session.' };
+    }
+    await ctx.omdshSession.refreshRecent();
+    let id = invocation.rawInput.trim();
+    if (id === '') {
+        const recent = ctx.omdshSession.recentSessions;
+        if (recent.length === 0)
+            return { kind: 'success', text: 'No durable sessions found.' };
+        const answer = await ctx.tui.prompt({
+            title: 'Resume Session',
+            question: '',
+            options: recent.map(row => ({
+                label: row.title,
+                value: row.id,
+                ...(row.preview === undefined ? {} : { preview: row.preview }),
+                description: [
+                    formatRelativeAge(row.updatedAt ?? row.createdAt),
+                    ...(row.eventCount === undefined ? [] : [`${row.eventCount} events`]),
+                ].join(' · '),
+                ...(row.status === undefined
+                    ? {}
+                    : {
+                        badge: {
+                            label: row.status,
+                            tone: row.status === 'done'
+                                ? 'success'
+                                : row.status === 'failed'
+                                    ? 'error'
+                                    : 'warning',
+                        },
+                    }),
+            })),
+            presentation: 'fullscreen-list',
+            filterable: true,
+            allowCustom: false,
+            signal: invocation.signal,
+        });
+        if (answer === null)
+            return { kind: 'success' };
+        const index = /^\d+$/u.test(answer) ? Number(answer) - 1 : -1;
+        id = index >= 0 ? (recent[index]?.id ?? answer) : answer;
+    }
+    if (id === invocation.agent.id)
+        return { kind: 'success', text: 'That session is already active.' };
+    try {
+        await ctx.omdshSession.resumeSession(invocation.agent, id, invocation.signal);
+        return { kind: 'success', text: `Resumed ${id}.` };
+    }
+    catch (error) {
+        if (invocation.signal.aborted)
+            return { kind: 'error', text: 'Resume cancelled.' };
+        return { kind: 'error', text: 'Resume failed: ' + (error instanceof Error ? error.message : String(error)) };
+    }
+}
+function showSession(ctx, invocation) {
+    const stats = ctx.omdshSession.stats(invocation.agent);
+    const selection = ctx.omdshSession.selection(invocation.agent);
+    const reasoningEffort = ctx.omdshSession.reasoningEffort(invocation.agent);
+    const controls = ctx.omdshSession.controls(invocation.agent);
+    const mode = controls.plan?.pending === true
+        ? controls.plan.active ? 'Plan → Default (pending)' : 'Plan (pending)'
+        : controls.plan?.active === true ? 'Plan' : 'Default';
+    return {
+        kind: 'success',
+        text: [
+            'Session Details',
+            '',
+            '| Field | Value |',
+            '|---|---|',
+            `| Session | \`${invocation.agent.id}\` |`,
+            `| Model | \`${selection.provider}/${selection.model}\` |`,
+            `| Reasoning | \`${reasoningEffort ?? 'not available'}\` |`,
+            `| Mode | ${mode} |`,
+            ...(controls.permission === undefined ? [] : [`| Access mode | \`${controls.permission}\` |`]),
+            `| Activity | ${stats.turns} turns · ${stats.steps} steps |`,
+            `| Tokens | ${stats.inputTokens} in · ${stats.outputTokens} out |`,
+            `| Queue | ${invocation.agent.inbox.nextTurn.length} follow-up · ${invocation.agent.inbox.nextStep.length} steering |`,
+        ].join('\n'),
+    };
+}
+async function retry(ctx, invocation) {
+    if (invocation.rawInput.trim() !== '')
+        return { kind: 'error', text: 'Usage: /retry' };
+    for (let i = invocation.agent.session.events.length - 1; i >= 0; i -= 1) {
+        const text = humanText(invocation.agent.session.events[i]);
+        if (text === undefined)
+            continue;
+        await ctx.omdshSession.send(text, invocation.agent);
+        return { kind: 'success', text: 'Re-running the most recent human prompt as a new turn.' };
+    }
+    return { kind: 'success', text: 'No human prompt is available to retry.' };
+}
+function showTodo(invocation) {
+    if (invocation.rawInput.trim() !== '')
+        return { kind: 'error', text: 'Usage: /todo' };
+    const event = invocation.agent.session.events.findLast(item => item.type === 'todo/write');
+    if (event === undefined)
+        return { kind: 'success', text: 'No todo list has been recorded.' };
+    return {
+        kind: 'success',
+        text: [
+            `Todo · ${event.data.todos.length} item${event.data.todos.length === 1 ? '' : 's'}`,
+            '',
+            ...event.data.todos.map((todo) => todo.status === 'completed'
+                ? `- [x] ${todo.content}`
+                : todo.status === 'in_progress'
+                    ? `- [ ] **In progress** · ${todo.content}`
+                    : `- [ ] ${todo.content}`),
+        ].join('\n'),
+    };
+}
+export function apply(ctx) {
+    registerCommands(ctx, [
+        { name: 'new', description: 'Start a new session', handler: invocation => newSession(ctx, invocation) },
+        {
+            name: 'resume',
+            description: 'Resume a durable session',
+            input: { hint: '[session-id]' },
+            handler: invocation => resumeSession(ctx, invocation),
+        },
+        { name: 'session', description: 'Show current session details', handler: invocation => showSession(ctx, invocation) },
+        { name: 'retry', description: 'Run the most recent human prompt again', handler: invocation => retry(ctx, invocation) },
+        { name: 'todo', description: 'Show the current session todo list', handler: showTodo },
+    ], 'omdsh session commands');
+}
+//# sourceMappingURL=command-session.js.map

package/lib/command-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-session.js","sourceRoot":"","sources":["../src/command-session.ts"],"names":[],"mappings":"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"}

package/lib/command-transcript.d.ts

@@ -0,0 +1,5 @@
+/** Transcript search/export commands registered through dsh-commands. */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "omdsh-command-transcript";
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/command-transcript.js

@@ -0,0 +1,85 @@
+/** Transcript search/export commands registered through dsh-commands. */
+import { writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import { registerCommands } from "./command-registration.js";
+import { formatTranscriptMarkdown } from "./transcript-export.js";
+export const name = 'omdsh-command-transcript';
+export const inject = ['commands'];
+function tableCell(value) {
+    return value.replace(/\|/gu, '\\|').replace(/\s+/gu, ' ').trim();
+}
+function sessionTitle(events, fallback) {
+    for (let i = events.length - 1; i >= 0; i -= 1) {
+        const event = events[i];
+        if (event?.type === 'session/title')
+            return event.data.title;
+    }
+    return fallback;
+}
+async function search(ctx, invocation) {
+    const input = invocation.rawInput.trim();
+    const all = input === '--all' || input.startsWith('--all ');
+    const query = (all ? input.slice('--all'.length) : input).trim();
+    if (query === '')
+        return { kind: 'error', text: 'Usage: /search [--all] <query>' };
+    const service = ctx.get('sessionQuery');
+    if (service === undefined)
+        return { kind: 'error', text: 'Session search is not configured.' };
+    try {
+        if (all) {
+            const page = await service.searchSessions({ query, limit: 20 }, { signal: invocation.signal });
+            const lines = page.items.map((hit) => `| \`${tableCell(hit.header.id)}\` · #${hit.bestMatch.seq} ${tableCell(hit.bestMatch.type)} | ${tableCell(hit.bestMatch.snippet)} |`);
+            return {
+                kind: 'success',
+                text: lines.length === 0
+                    ? `No sessions match “${query}”.`
+                    : [`Session Matches · ${lines.length} · “${query}”`, '', '| Session / Event | Snippet |', '|---|---|', ...lines].join('\n'),
+            };
+        }
+        const page = await service.searchEvents({ sessionId: invocation.agent.session.id, query, limit: 30 }, { signal: invocation.signal });
+        const lines = page.items.map((hit) => `| #${hit.seq} ${tableCell(hit.type)} | ${tableCell(hit.snippet)} |`);
+        return {
+            kind: 'success',
+            text: lines.length === 0
+                ? `No transcript matches “${query}”.`
+                : [`Transcript Matches · ${lines.length} · “${query}”`, '', '| Event | Snippet |', '|---|---|', ...lines].join('\n'),
+        };
+    }
+    catch (error) {
+        if (invocation.signal.aborted)
+            return { kind: 'error', text: 'Search cancelled.' };
+        return { kind: 'error', text: 'Search failed: ' + (error instanceof Error ? error.message : String(error)) };
+    }
+}
+async function exportTranscript(invocation) {
+    const input = invocation.rawInput.trim();
+    const unquoted = input.replace(/^(?:"(.*)"|'(.*)')$/u, '$1$2');
+    const fallback = `omdsh-transcript-${invocation.agent.id}.md`;
+    const path = resolve(unquoted === '' ? fallback : (unquoted.startsWith('~/') ? homedir() + unquoted.slice(1) : unquoted));
+    const title = sessionTitle(invocation.agent.session.events, invocation.agent.id);
+    try {
+        await writeFile(path, formatTranscriptMarkdown(invocation.agent.id, title, invocation.agent.session.events), { encoding: 'utf8', mode: 0o600 });
+        return { kind: 'success', text: `Exported complete transcript to ${path}` };
+    }
+    catch (error) {
+        return { kind: 'error', text: 'Export failed: ' + (error instanceof Error ? error.message : String(error)) };
+    }
+}
+export function apply(ctx) {
+    registerCommands(ctx, [
+        {
+            name: 'search',
+            description: 'Search this transcript, or all sessions with --all',
+            input: { hint: '[--all] <query>' },
+            handler: invocation => search(ctx, invocation),
+        },
+        {
+            name: 'export',
+            description: 'Export the complete transcript as Markdown',
+            input: { hint: '[path]' },
+            handler: exportTranscript,
+        },
+    ], 'omdsh transcript commands');
+}
+//# sourceMappingURL=command-transcript.js.map

package/lib/command-transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-transcript.js","sourceRoot":"","sources":["../src/command-transcript.ts"],"names":[],"mappings":"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"}

package/lib/copy-selector.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `/copy` picker overlay: OMP-style list of transcript copy targets.
+ * Pure — the provider owns the clipboard write.
+ * @module @agi-fans/dsh-tui
+ */
+import type { CopyPick } from './copy-targets.ts';
+import type { KeyEvent } from './keys.ts';
+import { type Theme } from './theme.ts';
+/** Visible picker rows. */
+export declare const COPY_SELECTOR_MAX_VISIBLE = 8;
+/** Preview lines under the list. */
+export declare const COPY_SELECTOR_PREVIEW_LINES = 4;
+/** First overlay-local row that paints a target. */
+export declare const COPY_SELECTOR_ITEM_ROW = 3;
+/** Live overlay state. */
+export interface CopySelectorState {
+    items: readonly CopyPick[];
+    selected: number;
+}
+/** Outcome of one key against the overlay. */
+export type CopySelectorCommand = {
+    kind: 'update';
+    state: CopySelectorState;
+} | {
+    kind: 'pick';
+    item: CopyPick;
+} | {
+    kind: 'close';
+} | {
+    kind: 'ignore';
+};
+/** Open the picker on the assembled targets. */
+export declare function createCopySelector(items: readonly CopyPick[], selected?: number): CopySelectorState;
+/** Visible item-index window around `selected`. */
+export declare function copySelectorVisibleRange(count: number, selected: number, maxVisible?: number): {
+    start: number;
+    end: number;
+};
+/** Item index under an overlay-local row, or undefined on chrome. */
+export declare function hitTestCopySelector(count: number, selected: number, localRow: number, maxVisible?: number): number | undefined;
+/** Move the highlight to `index` without copying. */
+export declare function selectCopyTarget(state: CopySelectorState, index: number): CopySelectorState;
+/** Apply one decoded event to the overlay. */
+export declare function applyCopySelectorEvent(state: CopySelectorState, event: KeyEvent): CopySelectorCommand;
+/** Overlay frame: title, windowed rows, preview, hints. */
+export declare function renderCopySelector(state: CopySelectorState, theme: Theme, width: number, maxVisible?: number): {
+    lines: string[];
+    cursor: {
+        row: number;
+        column: number;
+    };
+};