@agi-fans/dsh-tui 0.19.0 → 0.20.0

package/lib/commands/files.js

@@ -0,0 +1,137 @@
+/** Workspace browsing, deliverables, and durable file attachments. */
+import { createReadStream } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { basename, dirname, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { deliverableFiles, logAttachments } from "../views/session-files.js";
+import { filePreview, openSystemFile, reviewFiles } from "../runtime/file-review.js";
+import { previewImages } from "../runtime/image-preview.js";
+import { registerCommands } from "./registration.js";
+export const name = 'omdsh-command-files';
+export const inject = ['commands', 'tui', 'attachments'];
+export function userPath(input, cwd) {
+    const unquoted = input.replace(/^(?:"(.*)"|'(.*)')$/u, '$1$2');
+    return resolve(cwd, unquoted.startsWith('~/') ? homedir() + unquoted.slice(1) : unquoted);
+}
+async function browse(ctx, invocation) {
+    const cwd = invocation.agent.session.header.cwd ?? process.cwd();
+    let path = userPath(invocation.rawInput.trim(), cwd);
+    while (!invocation.signal.aborted) {
+        const info = await stat(path);
+        if (info.isFile()) {
+            if (ctx.tui.interactive !== true)
+                return { kind: 'success', text: await filePreview(path, invocation.signal) };
+            const directory = dirname(path);
+            const files = (await readdir(directory, { withFileTypes: true })).filter(entry => entry.isFile())
+                .sort((a, b) => a.name.localeCompare(b.name)).slice(0, 500)
+                .map(entry => ({ path: resolve(directory, entry.name), label: entry.name }));
+            if (!files.some(file => file.path === path))
+                files.push({ path, label: basename(path) });
+            await reviewFiles(ctx.tui, `Files · ${directory}`, directory, files, index => filePreview(files[index].path, invocation.signal), invocation.signal, files.findIndex(file => file.path === path), false);
+            path = directory;
+            continue;
+        }
+        const entries = (await readdir(path, { withFileTypes: true })).filter(entry => entry.name !== '.git' && entry.name !== 'node_modules')
+            .sort((a, b) => Number(b.isDirectory()) - Number(a.isDirectory()) || a.name.localeCompare(b.name));
+        const page = entries.slice(0, 500);
+        if (ctx.tui.interactive !== true)
+            return { kind: 'success', text: page.map(entry => entry.name + (entry.isDirectory() ? '/' : '')).join('\n') };
+        const answer = await ctx.tui.prompt({ title: `Files · ${path}`, question: path, presentation: 'fullscreen-list', optionLayout: 'compact',
+            allowCustom: false, filterable: true, signal: invocation.signal, notify: false,
+            detail: entries.length > page.length ? `Showing ${page.length} of ${entries.length} entries; /files <path> opens a specific path.` : 'Shift+P shows this session’s deliverables.',
+            options: [{ label: '../', value: dirname(path) }, ...page.map(entry => ({ label: entry.name + (entry.isDirectory() ? '/' : ''), value: resolve(path, entry.name) }))],
+            actions: [{ key: 'P', label: 'deliverables', valuePrefix: 'present:' }] });
+        if (answer === null)
+            break;
+        if (answer.startsWith('present:')) {
+            const files = deliverableFiles(invocation.agent.session.snapshotEvents()).map(path => ({ path, label: path }));
+            if (files.length === 0) {
+                ctx.tui.notice('No deliverables in this session.');
+                continue;
+            }
+            await reviewFiles(ctx.tui, 'Deliverables', cwd, files, index => filePreview(resolve(cwd, files[index]?.path ?? ''), invocation.signal), invocation.signal, undefined, false);
+        }
+        else
+            path = answer;
+    }
+    return { kind: 'success' };
+}
+export async function attachFile(ctx, invocation) {
+    if (ctx.tui.interactive !== true || ctx.tui.stageFileAttachment === undefined)
+        return { kind: 'error', text: 'File drafts require an interactive composer.' };
+    let input = invocation.rawInput.trim();
+    if (input === '')
+        input = await ctx.tui.prompt({ title: 'Attach file', question: 'Path to the file', allowCustom: true, signal: invocation.signal }) ?? '';
+    if (input === '' || invocation.signal.aborted)
+        return { kind: 'success' };
+    const path = userPath(input, invocation.agent.session.header.cwd ?? process.cwd());
+    const info = await stat(path);
+    if (!info.isFile())
+        return { kind: 'error', text: 'Select a regular file to attach.' };
+    const source = createReadStream(path, { highWaterMark: 64 * 1024, signal: invocation.signal });
+    try {
+        const ref = await ctx.attachments.saveFileStream({ data: source, name: basename(path), signal: invocation.signal });
+        invocation.signal.throwIfAborted();
+        ctx.tui.stageFileAttachment(ref);
+        return { kind: 'success', text: `Attached ${ref.name} · ${ref.bytes.toLocaleString()} bytes. Add a message and press Enter to send; deleting its marker removes the draft.` };
+    }
+    finally {
+        source.destroy();
+    }
+}
+async function attachments(ctx, invocation) {
+    const refs = logAttachments(invocation.agent.session.snapshotEvents());
+    if (ctx.tui.interactive !== true)
+        return { kind: 'success', text: refs.map(ref => `${ref.name ?? ref.attachmentId} · ${ref.bytes} bytes`).join('\n') || 'No attachments in this session.' };
+    while (!invocation.signal.aborted) {
+        const answer = await ctx.tui.prompt({ title: 'Attachments', question: 'Choose a stored attachment', emptyText: 'No attachments in this session.',
+            presentation: 'fullscreen-list', optionLayout: 'compact', filterable: true, allowCustom: false, signal: invocation.signal,
+            notify: false,
+            options: refs.map((ref, index) => ({ label: ref.name ?? String(ref.attachmentId), value: String(index), description: `${ref.bytes.toLocaleString()} bytes · ${'mediaType' in ref ? ref.mediaType : 'file'}` })) });
+        if (answer === null)
+            break;
+        const ref = refs[Number(answer)];
+        if (ref === undefined)
+            continue;
+        // Verify the durable bytes before opening the provider-owned original.
+        if ('mediaType' in ref) {
+            const stored = await ctx.attachments.readImage(ref, invocation.signal);
+            const path = ctx.attachments.imageHostPath(ref);
+            await previewImages(ctx.tui, [{ ...ref, data: stored.data }], invocation.signal, path === undefined ? undefined : () => openSystemFile(path));
+            continue;
+        }
+        else
+            for await (const chunk of ctx.attachments.readFileStream(ref, invocation.signal)) {
+                void chunk;
+            }
+        const path = ctx.attachments.fileHostPath(ref);
+        if (path === undefined) {
+            ctx.tui.notice('This attachment provider does not expose a local file to open.');
+            continue;
+        }
+        const action = await ctx.tui.prompt({ title: ref.name ?? 'Attachment', question: 'Open the stored original or preview it?', allowCustom: false, signal: invocation.signal,
+            notify: false,
+            options: [{ label: 'Preview', value: 'preview' }, { label: 'Open original', value: 'open' }] });
+        if (action === 'open')
+            await openSystemFile(path);
+        else if (action === 'preview')
+            await reviewFiles(ctx.tui, 'Attachment', '/', [{ path, label: ref.name ?? path }], () => filePreview(path, invocation.signal), invocation.signal, 0, false);
+    }
+    return { kind: 'success' };
+}
+export function apply(ctx) {
+    const safe = (handler) => async (invocation) => {
+        try {
+            return await handler(ctx, invocation);
+        }
+        catch (error) {
+            return { kind: 'error', text: invocation.signal.aborted ? 'File operation cancelled.' : error instanceof Error ? error.message : String(error) };
+        }
+    };
+    registerCommands(ctx, [
+        { name: 'files', description: 'Browse workspace files and session deliverables', input: { hint: '[path]' }, handler: safe(browse) },
+        { name: 'attach', description: 'Add a file to the composer without sending it', input: { hint: '[path]' }, handler: safe(attachFile) },
+        { name: 'attachments', description: 'View this session’s stored attachments', handler: safe(attachments) },
+    ], 'omdsh file interaction');
+}
+//# sourceMappingURL=files.js.map

package/lib/commands/files.js.map

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

package/lib/commands/plugins.d.ts

@@ -0,0 +1,8 @@
+/** Native profile management over the published Harness transaction service. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ChangeResult, PluginInfo } from '@deepseek-ai/dsh-plugin-manager';
+export declare const name = "omdsh-command-plugins";
+export declare const inject: string[];
+export declare function pluginReadOnly(row: PluginInfo): string | undefined;
+export declare function changeText(result: ChangeResult): string;
+export declare function apply(ctx: Context): void;

package/lib/commands/plugins.js

@@ -0,0 +1,158 @@
+/** Native profile management over the published Harness transaction service. */
+import { randomUUID } from 'node:crypto';
+import { registerCommands } from "./registration.js";
+export const name = 'omdsh-command-plugins';
+export const inject = ['commands', 'pluginManager', 'tui'];
+// Removing the command's own presentation or session owner during its awaited
+// handler would make disposal wait for the operation that caused disposal.
+const TERMINAL_OWNERS = new Set([
+    'commands', 'agent', 'session', 'agent-preset-registry', 'tools', 'llm',
+    'settings', 'config-editor', 'credentials', 'agent-default-model',
+    'session-persistence', 'session-projection', 'authorization', 'approval',
+    'user-questions', 'plan-mode',
+]);
+export function pluginReadOnly(row) {
+    if (row.moduleName.startsWith('@agi-fans/') || TERMINAL_OWNERS.has(row.patchId ?? ''))
+        return 'terminal-required';
+    return row.readOnlyReason;
+}
+export function changeText(result) {
+    return [
+        `${result.target}: ${result.application}${result.enabled === undefined ? '' : result.enabled ? ' · enabled' : ' · disabled'}`,
+        ...(result.error === undefined ? [] : [result.error.diagnostic ?? result.error.code]),
+        ...(result.error?.incompatible ?? []).map(item => `${item.name}@${item.version}: DSH ${item.runtimeVersion} rejects ${JSON.stringify(item.peers)}`),
+        ...(result.warnings ?? []),
+        ...(result.packageResult === undefined ? [] : [result.packageResult.output, `Full installation log: ${result.packageResult.logPath}`]),
+    ].filter(Boolean).join('\n');
+}
+const list = { presentation: 'fullscreen-list', filterable: true, allowCustom: false, optionLayout: 'compact' };
+async function install(ctx, spec, signal, approvedBuilds) {
+    signal.throwIfAborted();
+    const requestId = randomUUID();
+    const promptAbort = new AbortController();
+    const cancel = () => { void ctx.pluginManager.cancelInstall(requestId).catch(() => { }); };
+    signal.addEventListener('abort', cancel, { once: true });
+    const off = ctx.on('plugin-manager/install-state', progress => {
+        if (progress.requestId !== requestId)
+            return;
+        const attempt = progress.attempt;
+        ctx.tui.notice(`Plugin ${progress.phase}${attempt === undefined ? '' : ` · ${attempt.index}/${attempt.total} · ${attempt.registry ?? 'configured registry'}`}`);
+        if (progress.phase === 'applying')
+            promptAbort.abort();
+    });
+    const operation = ctx.pluginManager.installBundle(spec, { requestId, ...(approvedBuilds === undefined ? {} : { approvedBuilds }) });
+    // The installer owns cancellation through restoration, even after the
+    // prompt closes. Never abandon its promise or report cancellation early.
+    const prompt = ctx.tui.prompt({
+        title: 'Install plugin', question: spec,
+        detail: 'Installing into this profile. Enter or Esc cancels; applying a finished installation cannot be cancelled.',
+        options: [{ label: 'Cancel installation', value: 'cancel' }],
+        allowCustom: false, signal: AbortSignal.any([signal, promptAbort.signal]),
+    }).then(() => { if (!promptAbort.signal.aborted)
+        cancel(); }, () => { cancel(); });
+    try {
+        return await operation;
+    }
+    finally {
+        promptAbort.abort();
+        await prompt;
+        off();
+        signal.removeEventListener('abort', cancel);
+    }
+}
+async function manage(ctx, invocation, signal) {
+    if (invocation.rawInput.trim() !== '')
+        return { kind: 'error', text: 'Usage: /plugins' };
+    if (invocation.agent.status === 'running')
+        return { kind: 'error', text: 'Wait for the current turn to finish before managing plugins.' };
+    while (!signal.aborted) {
+        const action = await ctx.tui.prompt({ ...list, title: 'Plugins', question: 'Manage this profile',
+            detail: 'Changes affect every session using this profile. Package replacements may require a restart.',
+            options: [{ label: 'Plugin entries', value: 'entries' }, { label: 'Bundles', value: 'bundles' }, { label: 'Install bundle', value: 'install' }], signal });
+        if (action === null)
+            break;
+        let result;
+        if (action === 'entries') {
+            const rows = await ctx.pluginManager.listPlugins();
+            const id = await ctx.tui.prompt({ ...list, title: 'Plugin entries', question: 'Choose an entry to inspect or toggle',
+                options: rows.map(row => ({ label: row.patchId ?? String(row.entryId), value: String(row.entryId),
+                    description: `${row.enabled ? 'Enabled' : 'Disabled'} · ${row.fiberPhase ?? 'not mounted'} · ${row.moduleName}${pluginReadOnly(row) === undefined ? '' : ` · ${pluginReadOnly(row)}`}` })), signal });
+            const row = rows.find(row => row.entryId === id);
+            if (row === undefined)
+                continue;
+            const reason = pluginReadOnly(row);
+            if (reason !== undefined) {
+                ctx.tui.notice(`${row.moduleName}: read-only (${reason}).`);
+                continue;
+            }
+            const choice = await ctx.tui.prompt({ title: 'Plugin entry', question: row.moduleName,
+                options: [{ label: row.enabled ? 'Disable' : 'Enable', value: 'toggle' }], allowCustom: false, signal });
+            if (choice === 'toggle' && !signal.aborted)
+                result = await ctx.pluginManager.setPluginEnabled(row.entryId, !row.enabled);
+        }
+        else if (action === 'bundles') {
+            const rows = await ctx.pluginManager.listBundles();
+            const selected = await ctx.tui.prompt({ ...list, title: 'Bundles', question: 'Choose a bundle',
+                options: rows.map(row => ({ label: row.name, value: row.name,
+                    description: `${row.version ?? ''} · ${row.enabled ? 'Enabled' : 'Disabled'}${row.error === undefined ? '' : ` · ${row.error.diagnostic ?? row.error.code}`}` })), signal });
+            const row = rows.find(row => row.name === selected);
+            if (row === undefined)
+                continue;
+            if (row.readOnlyReason !== undefined) {
+                ctx.tui.notice(`${row.name}: read-only (${row.readOnlyReason}).`);
+                continue;
+            }
+            const choice = await ctx.tui.prompt({ title: row.name, question: 'Manage bundle', ...(row.description === undefined ? {} : { detail: row.description }),
+                options: [
+                    ...(row.error !== undefined && !row.enabled ? [] : [{ label: row.enabled ? 'Disable' : 'Enable', value: 'toggle' }]),
+                    ...(row.removable ? [{ label: 'Remove package', value: 'remove' }] : []),
+                ], allowCustom: false, signal });
+            if (signal.aborted)
+                break;
+            if (choice === 'toggle')
+                result = await ctx.pluginManager.setBundleEnabled(row.name, !row.enabled);
+            if (choice === 'remove')
+                result = await ctx.pluginManager.removeBundle(row.name);
+        }
+        else if (action === 'install') {
+            const spec = await ctx.tui.prompt({ title: 'Install bundle', question: 'Package name, version, Git URL, or absolute path', allowCustom: true, signal });
+            if (spec === null || spec.trim() === '' || signal.aborted)
+                continue;
+            const inspected = await ctx.pluginManager.inspect(spec.trim(), undefined, signal);
+            if (inspected.status === 'refused') {
+                ctx.tui.notice(inspected.reason, { level: 'error' });
+                continue;
+            }
+            const consent = await ctx.tui.prompt({ title: 'Install bundle', question: inspected.name ?? spec.trim(),
+                detail: `${inspected.version ?? ''} ${inspected.description ?? ''}\nInstalled Host code runs with your user permissions and affects all sessions in this profile.`,
+                options: [{ label: 'Install and enable', value: 'install' }], allowCustom: false, signal });
+            if (consent !== 'install' || signal.aborted)
+                continue;
+            result = await install(ctx, spec.trim(), signal);
+            if (result.pendingBuilds?.length && !signal.aborted) {
+                ctx.tui.commandOutput('/plugins', changeText(result));
+                const approved = await ctx.tui.prompt({ title: 'Dependency scripts', question: 'Allow these scripts and retry?',
+                    detail: `${result.pendingBuilds.join('\n')}\nPermission persists by package name in this profile. Scripts run with your user permissions.`,
+                    options: [{ label: 'Allow scripts and retry', value: 'approve' }], allowCustom: false, signal });
+                if (approved === 'approve' && !signal.aborted)
+                    result = await install(ctx, spec.trim(), signal, result.pendingBuilds);
+            }
+        }
+        if (result !== undefined)
+            ctx.tui.commandOutput('/plugins', changeText(result));
+    }
+    return { kind: 'success' };
+}
+export function apply(ctx) {
+    const closing = new AbortController();
+    registerCommands(ctx, [{ name: 'plugins', description: 'Manage profile plugins and bundles', handler: async (invocation) => {
+                try {
+                    return await manage(ctx, invocation, AbortSignal.any([invocation.signal, closing.signal]));
+                }
+                catch (error) {
+                    return { kind: 'error', text: error instanceof Error ? error.message : String(error) };
+                }
+            } }], 'omdsh plugin commands');
+    ctx.effect(() => () => { closing.abort(); });
+}
+//# sourceMappingURL=plugins.js.map

package/lib/commands/plugins.js.map

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

package/lib/commands/session-configuration.d.ts

@@ -1,5 +1,9 @@
 /** Interactive selectors for the independent Agent and Workflow concepts. */
 import type { Context } from '@deepseek-ai/cordis';
+import type { AgentPresetRegistry } from '@deepseek-ai/dsh-agent-preset-registry';
+import type { Agent } from '@deepseek-ai/dsh-agent';
 export declare const name = "omdsh-command-session-configuration";
 export declare const inject: string[];
+/** Read current declarations beside the exact composition retained by this Agent. */
+export declare function presetDiagnostics(registry: AgentPresetRegistry, agent: Agent, requested?: string): Promise<string>;
 export declare function apply(ctx: Context): void;

package/lib/commands/session-configuration.js

@@ -4,28 +4,37 @@ import { registerCommands } from "./registration.js";
 export const name = 'omdsh-command-session-configuration';
 export const inject = ['commands', 'omdshSession', 'tui', 'agentPresets', 'planMode'];
 async function selectAgent(ctx, invocation) {
+    const args = invocation.rawInput.trim().split(/\s+/u);
+    if (args[0] === 'inspect' && args.length <= 2) {
+        return { kind: 'success', text: await presetDiagnostics(ctx.agentPresets, invocation.agent, args[1]) };
+    }
     if (invocation.rawInput.trim() !== '')
-        return { kind: 'error', text: 'Usage: /agent' };
+        return { kind: 'error', text: 'Usage: /agent [inspect [preset-id]]' };
     const controls = ctx.omdshSession.controls(invocation.agent);
     const presets = await ctx.omdshSession.agentPresets();
-    const available = presets.filter(preset => preset.broken === undefined);
-    if (available.length === 0)
-        return { kind: 'error', text: 'No usable Agent presets are configured.' };
+    if (presets.length === 0)
+        return { kind: 'error', text: 'No Agent presets are configured.' };
     const selected = await ctx.tui.prompt({
         title: 'Agent',
         question: 'Choose the Agent composition for this blank session',
-        detail: 'Locked after the first prompt',
-        options: available.map(preset => ({
+        detail: 'Locked after the first prompt · /agent inspect shows composition diagnostics',
+        options: presets.map(preset => ({
             label: preset.name ?? formatAgentPreset(preset.id),
             value: preset.id,
-            description: `${preset.id === controls.agentPreset ? 'Current · ' : ''}${preset.description ?? preset.id}`,
+            description: `${preset.id === controls.agentPreset ? 'Current · ' : ''}${preset.broken ?? preset.description ?? preset.id}`,
+            ...(preset.broken === undefined ? {} : { badge: { label: 'Unavailable', tone: 'error' } }),
         })),
         ...(controls.agentPreset === undefined ? {} : { initialValue: controls.agentPreset }),
         allowCustom: false,
         submitLabel: 'apply',
         signal: invocation.signal,
     });
-    if (selected === null || selected === controls.agentPreset)
+    if (selected === null)
+        return { kind: 'success' };
+    const broken = presets.find(preset => preset.id === selected)?.broken;
+    if (broken !== undefined)
+        return { kind: 'error', text: broken };
+    if (selected === controls.agentPreset)
         return { kind: 'success' };
     try {
         const agentPreset = await ctx.omdshSession.changeAgentPreset(invocation.agent, selected);
@@ -35,6 +44,28 @@ async function selectAgent(ctx, invocation) {
         return { kind: 'error', text: error instanceof Error ? error.message : String(error) };
     }
 }
+/** Read current declarations beside the exact composition retained by this Agent. */
+export async function presetDiagnostics(registry, agent, requested) {
+    const declared = await registry.compositionInventory();
+    const retained = registry.inspectCompositions(agent.ctx);
+    const rows = requested === undefined ? declared : declared.filter(row => row.id === requested);
+    if (rows.length === 0)
+        return `No declared preset: ${requested ?? '(none)'}`;
+    return [
+        'Agent compositions',
+        'Current declarations apply to new sessions. Existing sessions retain their mounted revision.',
+        ...rows.flatMap(row => [
+            '', `${row.name ?? row.id} (${row.id})${row.isDefault ? ' · default' : ''}${row.broken === undefined ? '' : ' · unavailable'}`,
+            ...(row.broken === undefined ? row.rows.map(plugin => `  ${plugin.entryId ?? '(no id)'} · ${plugin.enabled === 'conditional' ? 'conditional' : plugin.enabled ? 'enabled' : 'disabled'} · ${plugin.moduleName}${plugin.fiberState === undefined ? '' : ` · ${['pending', 'loading', 'active', 'failed', 'disposed', 'unloading'][plugin.fiberState] ?? 'unknown'}`}`) : [row.broken]),
+        ]),
+        '', 'This session’s retained composition',
+        ...(retained.length === 0 ? ['No preset composition is bound to this session.'] : retained.flatMap(row => [
+            row.id,
+            ...row.modules.map(module => `  ${module.moduleName}`),
+            ...(row.leakedServices.length === 0 ? [] : [`Isolation errors: ${row.leakedServices.join(', ')}`]),
+        ])),
+    ].join('\n');
+}
 async function selectWorkflow(ctx, invocation) {
     if (invocation.rawInput.trim() !== '')
         return { kind: 'error', text: 'Usage: /workflow' };

package/lib/commands/session-configuration.js.map

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

package/lib/commands/session.js

@@ -1,11 +1,9 @@
 /** Session lifecycle and inspection commands registered through dsh-commands. */
-import { homedir } from 'node:os';
-import { join } from 'node:path';
 import { registerCommands } from "./registration.js";
 import { formatRelativeAge } from "../chrome/relative-time.js";
 import { formatPermission, formatTokens } from "../chrome/status-line.js";
 import { formatAgentPreset } from "../session/session-configuration.js";
-import { readPinnedSessions, sortSessionRows, togglePinnedSession, writePinnedSessions } from "../session/session-library.js";
+import { readSessionLibrary, sortSessionRows, togglePinnedSession, updateSessionLibrary } from "../session/session-library.js";
 import { contextDiagnosticsMarkdown } from "../session/context-diagnostics.js";
 import { blocksText } from "../session/content-text.js";
 export const name = 'omdsh-command-session';
@@ -36,24 +34,27 @@ async function resumeSession(ctx, invocation) {
     await ctx.omdshSession.refreshRecent();
     let id = invocation.rawInput.trim();
     if (id === '') {
-        const dshHome = process.env.OMDSH_HOME ?? process.env.DSH_HOME ?? join(homedir(), '.dsh');
-        const pinsPath = join(dshHome, 'omdsh', 'session-library.json');
-        let pinned = readPinnedSessions(pinsPath);
+        const libraryPath = ctx.omdshSession.sessionLibraryPath;
+        let archivedView = false;
+        let selectedId;
         while (id === '') {
-            const recent = sortSessionRows(ctx.omdshSession.recentSessions, pinned);
-            if (recent.length === 0)
+            const library = readSessionLibrary(libraryPath);
+            const recent = sortSessionRows(ctx.omdshSession.recentSessions.filter(row => library.archived.includes(row.id) === archivedView), library.pinned);
+            if (ctx.omdshSession.recentSessions.length === 0)
                 return { kind: 'success', text: 'No durable sessions found.' };
             const answer = await ctx.tui.prompt({
-                title: 'Session Library',
+                title: archivedView ? 'Session Library · Archived' : 'Session Library',
+                notify: false,
+                ...(selectedId === undefined ? {} : { initialValue: selectedId }),
                 question: '',
                 // Filtering can empty the list even when the library is not empty.
-                emptyText: 'No sessions found.',
+                emptyText: archivedView ? 'No archived sessions. Alt+V returns to active sessions.' : 'No active sessions. Alt+V shows archived sessions.',
                 options: recent.map(row => ({
-                    label: `${pinned.includes(row.id) ? '◆ ' : ''}${row.title}`,
+                    label: `${library.pinned.includes(row.id) ? '◆ ' : ''}${row.title}`,
                     value: row.id,
                     ...(row.preview === undefined ? {} : { preview: row.preview }),
                     description: [
-                        ...(pinned.includes(row.id) ? ['pinned'] : []),
+                        ...(library.pinned.includes(row.id) ? ['pinned'] : []),
                         formatRelativeAge(row.updatedAt ?? row.createdAt),
                         ...(row.eventCount === undefined ? [] : [`${row.eventCount} events`]),
                     ].join(' · '),
@@ -73,6 +74,8 @@ async function resumeSession(ctx, invocation) {
                 actions: [
                     { key: 'r', label: 'rename', valuePrefix: 'rename:' },
                     { key: 'p', label: 'pin/unpin', valuePrefix: 'pin:' },
+                    { key: 'Alt+A', label: archivedView ? 'restore' : 'archive', valuePrefix: 'archive:' },
+                    { key: 'Alt+V', label: archivedView ? 'active sessions' : 'archived sessions', valuePrefix: 'view:', scope: 'list' },
                 ],
                 presentation: 'fullscreen-list',
                 filterable: true,
@@ -81,9 +84,22 @@ async function resumeSession(ctx, invocation) {
             });
             if (answer === null)
                 return { kind: 'success' };
-            if (answer.startsWith('pin:')) {
-                pinned = togglePinnedSession(pinned, answer.slice('pin:'.length));
-                writePinnedSessions(pinsPath, pinned);
+            invocation.signal.throwIfAborted();
+            if (answer === 'view:') {
+                archivedView = !archivedView;
+                continue;
+            }
+            if (answer.startsWith('pin:') || answer.startsWith('archive:')) {
+                const [action, ...parts] = answer.split(':');
+                const target = parts.join(':');
+                if (!recent.some(row => row.id === target))
+                    continue;
+                selectedId = target;
+                updateSessionLibrary(libraryPath, current => action === 'pin'
+                    ? { ...current, pinned: togglePinnedSession(current.pinned, target) }
+                    : { ...current, archived: archivedView ? current.archived.filter(id => id !== target) : [...new Set([...current.archived, target])] });
+                if (action === 'archive')
+                    await ctx.omdshSession.refreshRecent();
                 continue;
             }
             if (answer.startsWith('rename:')) {
@@ -91,9 +107,11 @@ async function resumeSession(ctx, invocation) {
                 const row = recent.find(item => item.id === target);
                 if (row === undefined)
                     continue;
+                selectedId = target;
                 const title = await ctx.tui.prompt({
                     title: 'Rename Session',
                     question: `New title for “${row.title}”`,
+                    initialInput: row.title,
                     allowCustom: true,
                     signal: invocation.signal,
                 });
@@ -250,6 +268,12 @@ function showTodo(invocation) {
 }
 export function apply(ctx) {
     registerCommands(ctx, [
+        { name: 'queue', description: 'Review, edit, delete, and reorder pending messages', handler: async (invocation) => {
+                if (invocation.rawInput.trim() !== '')
+                    return { kind: 'error', text: 'Usage: /queue' };
+                await ctx.omdshSession.openQueue(invocation.signal, invocation.agent);
+                return { kind: 'success' };
+            } },
         { name: 'context', description: 'Inspect projection-backed context usage', handler: invocation => showContext(ctx, invocation) },
         { name: 'new', description: 'Start a new session', handler: invocation => newSession(ctx, invocation) },
         {
@@ -264,6 +288,14 @@ export function apply(ctx) {
             input: { hint: '[query]' },
             handler: invocation => sessionsCommand(ctx, invocation),
         },
+        { name: 'tree', description: 'Browse conversation turns and branches', handler: async (invocation) => {
+                if (invocation.rawInput.trim() !== '')
+                    return { kind: 'error', text: 'Usage: /tree' };
+                if (invocation.agent.status !== 'idle')
+                    return { kind: 'error', text: 'Finish or interrupt the active turn before opening the Session Tree.' };
+                await ctx.omdshSession.openSessionTree(invocation.signal);
+                return { kind: 'success' };
+            } },
         { 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 },