@agi-fans/dsh-tui 0.20.0 → 0.22.0

package/lib/session/session-controller.js

@@ -11,12 +11,10 @@ import { steerAgent } from "./steering.js";
 import { openMessageQueue } from "./message-queue.js";
 import { WorkflowProjection } from "./workflow-projection.js";
 import { join } from 'node:path';
-import { installModelSelection, } from '@deepseek-ai/dsh-agent';
 import { createUserMessage, } from '@deepseek-ai/dsh-llm';
 import { isUserInvocable } from '@deepseek-ai/dsh-skill';
-import { SessionAlreadyOwnedError } from '@deepseek-ai/dsh-session-persistence';
 import { readColdSessionLog } from '@deepseek-ai/dsh-session-query';
-import { SESSION_FORMAT_VERSION, SessionId, SessionLogOffset } from '@deepseek-ai/dsh-session';
+import { appendPluginRecord, pluginRecordOf, SessionId, SessionLogOffset } from '@deepseek-ai/dsh-session';
 import { queueHostSubagentPrompt } from '@deepseek-ai/dsh-subagent/internal';
 import { firstVisibleStreamTime } from "../views/stream-time.js";
 import { LiveAttemptTracker } from "./live-attempt-tracker.js";
@@ -27,22 +25,18 @@ export { conversationTurns } from "./conversation-turns.js";
 import { jobNoticeFor } from "./job-notice.js";
 import { descendantDepth, isSteerableSubagent } from "./subagent-roster.js";
 import { readRecentRows, writeRecentRows, readSessionLibrary, sessionLibraryPath, setSessionLabel } from "./session-library.js";
-import { readJsonFile, writeJsonAtomic } from "./json-file.js";
+import { currentWorkingDirectory } from "./working-directory.js";
 import { SubagentTracker } from "./subagent-tracker.js";
 import { commandPermission } from "../commands/permission.js";
+import { configureAgentContext } from "../runtime/agent-profile.js";
+import { BTW_PRESET } from "../runtime/btw-policy.js";
+import { reviewFileRecovery } from "../runtime/file-recovery-review.js";
 import { isBlankSession, } from "./session-configuration.js";
 import { stripComposerImageMarkers } from "../input/image-paste.js";
 async function setupAgentContext(agentCtx, agent, selection) {
-    installModelSelection(agentCtx, selection);
-    const agentPresets = agentCtx.get('agentPresets');
-    const sessionProjections = agentCtx.get('sessionProjections');
-    if (agentPresets === undefined || sessionProjections === undefined) {
-        throw new Error('agent configuration services are unavailable');
-    }
-    const agentPreset = sessionProjections.stateOf(agent.session, 'agentPreset') ?? agentPresets.defaultId;
-    const mounted = await agentPresets.mount(agentCtx, agentPreset);
+    const configured = await configureAgentContext(agentCtx, agent, selection);
     await agentCtx.plugin(commandPermission(agent));
-    return { agentPreset: mounted.id };
+    return configured;
 }
 function parseControl(line) {
     const match = /^\/([a-z][a-z0-9_-]*(?::[a-z0-9][a-z0-9_-]*)?)(?:\s+(.*))?$/su.exec(line.trim());
@@ -317,11 +311,38 @@ export async function createSubmissionMessage(submission, attachments) {
     const refs = inputs.length === 0 || attachments === undefined
         ? []
         : [...await attachments.saveImages(inputs)];
-    const content = [
-        ...(submission.text === '' ? [] : [{ type: 'text', text: submission.text }]),
-        ...refs.map(attachment => ({ type: 'image', attachment })),
-        ...(submission.files ?? []).map(attachment => ({ type: 'file', attachment })),
-    ];
+    // A recorded order keeps the picture where the reader put it; without one the
+    // message falls back to text followed by its attachments.
+    const content = [];
+    if (submission.segments === undefined || submission.segments.length === 0) {
+        if (submission.text !== '')
+            content.push({ type: 'text', text: submission.text });
+        for (const attachment of refs)
+            content.push({ type: 'image', attachment });
+        for (const attachment of submission.files ?? [])
+            content.push({ type: 'file', attachment });
+    }
+    else {
+        for (const segment of submission.segments) {
+            if (segment.kind === 'text') {
+                if (segment.text !== '')
+                    content.push({ type: 'text', text: segment.text });
+                continue;
+            }
+            const attachment = refs[segment.index];
+            if (attachment !== undefined)
+                content.push({ type: 'image', attachment });
+        }
+        // An attachment the composer did not mark in the text still belongs to the
+        // message: keep it rather than dropping it with the marker.
+        const placedImages = new Set(submission.segments.flatMap(segment => segment.kind === 'image' ? [segment.index] : []));
+        for (const [index, attachment] of refs.entries()) {
+            if (!placedImages.has(index))
+                content.push({ type: 'image', attachment });
+        }
+        for (const attachment of submission.files ?? [])
+            content.push({ type: 'file', attachment });
+    }
     if (content.length === 0)
         throw new Error('Cannot submit an empty message.');
     return createUserMessage({ content, source: { kind: 'user' } });
@@ -368,6 +389,14 @@ export class SessionRuntime {
     #recent = [];
     #archivedSessions = new Set();
     #skillCommands = [];
+    /**
+     * Live argument vocabularies, keyed by command.
+     *
+     * A snapshot rather than a callback into the services: completion runs on every
+     * keystroke and must not await a catalog. It is rebuilt whenever the commands
+     * are pushed, which is also when a model or provider list can have changed.
+     */
+    #argumentOptions = new Map();
     #started = false;
     #retired = [];
     // Weak: deduplication must not retain disposed session graphs.
@@ -380,7 +409,6 @@ export class SessionRuntime {
     #recentCache = new Map();
     #libraryPath;
     #recentRowsPath;
-    #upgradeMarkerPath;
     #recentRowsLoaded = false;
     #refreshInFlight = null;
     #refreshDirty = false;
@@ -392,7 +420,6 @@ export class SessionRuntime {
         this.#tui = tui;
         this.#libraryPath = sessionLibraryPath(options.stateDir);
         this.#recentRowsPath = options.stateDir === undefined ? undefined : join(options.stateDir, 'recent-sessions.json');
-        this.#upgradeMarkerPath = options.stateDir === undefined ? undefined : join(options.stateDir, 'sessions-upgraded.json');
         this.#tracker = new SubagentTracker({
             rootId: () => this.#active?.handle.agent.id,
             depth: (session) => {
@@ -424,7 +451,7 @@ export class SessionRuntime {
         const fileReferences = this.#ctx.get('fileReferences');
         if (fileReferences !== undefined) {
             tui.setFileSearch(async (query, signal) => {
-                const agent = this.#active?.handle.agent;
+                const agent = this.#inspectedId === undefined ? this.#active?.handle.agent : this.#ctx.get('agents')?.get(SessionId(this.#inspectedId));
                 if (agent === undefined)
                     return [];
                 return fileReferences.list(agent, query, signal ?? new AbortController().signal);
@@ -471,6 +498,9 @@ export class SessionRuntime {
         this.#off.push(ctx.on('session/created', (session) => {
             this.#tracker.noteSession(session);
         }));
+        this.#off.push(ctx.on('subagent/start', info => { this.#tracker.noteExternalRun(info); }));
+        this.#off.push(ctx.on('subagent/end', info => { this.#tracker.noteExternalRun(info); }));
+        this.#off.push(ctx.on('subagent/external-activity', info => { this.#tracker.noteExternalActivity(info.id, info.activity); }));
         this.#off.push(ctx.on('session/disposed', (session) => {
             this.#tracker.noteGone(session);
         }));
@@ -478,6 +508,13 @@ export class SessionRuntime {
             const active = this.#active;
             if (active === undefined)
                 return;
+            if (event.type === 'working-directory/change') {
+                if (session.id === (this.#inspectedId ?? active.handle.agent.id)) {
+                    tui.setWorkingDirectory?.(currentWorkingDirectory(ctx, session));
+                }
+                if (session === active.handle.agent.session)
+                    void this.#refreshSkills().catch(error => { ctx.logger.warn(error); });
+            }
             if (session.id === this.#inspectedId) {
                 const child = ctx.get('agents')?.get(session.id);
                 tui.event(event, child === undefined ? undefined : ctx.get('tuiToolPresentation')?.event(child, event));
@@ -485,6 +522,8 @@ export class SessionRuntime {
                 return;
             }
             if (session === active.handle.agent.session) {
+                if (event.type === 'turn/end')
+                    tui.setStatus(active.handle.agent.status, { root: true, outcome: event.data.reason.kind });
                 if (this.#workflows.apply(event))
                     tui.setSubagents(this.#workflows.roster(this.#tracker.snapshot()));
                 if (this.#inspectedId === undefined) {
@@ -545,13 +584,6 @@ export class SessionRuntime {
                     this.#pushSessionInfo();
             }));
         }
-        // One-time per session format, off the first render: stored logs an earlier
-        // release wrote get their current-format generation here rather than on the
-        // next listing or search that has to decode them.
-        ctx.inject(['sessionPersistence'], (persistenceCtx) => {
-            void this.#upgradeStoredSessions(persistenceCtx.sessionPersistence)
-                .catch((error) => { persistenceCtx.logger.warn(error); });
-        });
     }
     get agent() {
         return this.#active?.handle.agent;
@@ -685,11 +717,11 @@ export class SessionRuntime {
         active.contextWindow = resolved?.context?.contextWindow;
         const status = modelStatus(selection, resolved);
         active.reasoningEffort = status.reasoningEffort;
-        this.#tui.setModel(status.model, status.reasoningEffort);
-        this.#pushSessionInfo();
         if (options?.persist !== false) {
             await this.#ctx.get('agentDefaultModel')?.saveSelection(selection);
         }
+        this.#tui.setModel(status.model, status.reasoningEffort);
+        this.#pushSessionInfo();
     }
     /** Start a new top-level session with the current model selection. */
     async newSession(agent) {
@@ -806,7 +838,7 @@ export class SessionRuntime {
                     return {
                         label: label === undefined ? node.label : `◆ ${label} · ${node.label}`,
                         value: node.id, ...(node.parentId === undefined ? {} : { parentValue: node.parentId }),
-                        preview: node.preview, description: node.description,
+                        preview: node.preview, previewFormat: node.previewFormat, description: node.description,
                         submitLabel: node.kind === 'turn' ? 'edit from here' : 'continue branch',
                         ...(node.current ? { badge: { label: 'Current', tone: 'success' } } : {}),
                     };
@@ -816,8 +848,9 @@ export class SessionRuntime {
                     { key: 'Alt+L', label: 'label', valuePrefix: 'label:' },
                     { key: 'Alt+U', label: 'clear label', valuePrefix: 'unlabel:' },
                     { key: 'Alt+B', label: markedOnly ? 'full tree' : 'marked nodes', valuePrefix: 'marked:', scope: 'list' },
+                    ...(this.#ctx.get('omdshFileRecovery') === undefined ? [] : [{ key: 'Alt+R', label: 'restore Turn files', valuePrefix: 'restore:' }]),
                 ],
-                ...(selectedId === undefined ? {} : { initialValue: selectedId }), presentation: 'fullscreen-tree', filterable: true, allowCustom: false, signal,
+                ...(selectedId === undefined ? {} : { initialValue: selectedId }), presentation: 'tree', filterable: true, allowCustom: false, signal,
             });
             if (answer === null)
                 return;
@@ -829,6 +862,17 @@ export class SessionRuntime {
                 markedOnly = !markedOnly;
                 continue;
             }
+            if (answer.startsWith('restore:')) {
+                const restoreId = answer.slice('restore:'.length);
+                const node = visible.find(item => item.id === restoreId);
+                if (node?.kind !== 'turn' || node.turn === undefined) {
+                    this.#tui.notice('Select a Turn to restore its files.');
+                    continue;
+                }
+                selectedId = node.id;
+                await reviewFileRecovery(this.#ctx, agent, node.sessionId, node.turn, signal, () => this.assertActive(agent));
+                continue;
+            }
             const clear = answer.startsWith('unlabel:');
             if (clear || answer.startsWith('label:')) {
                 const id = answer.slice(clear ? 'unlabel:'.length : 'label:'.length);
@@ -846,7 +890,7 @@ export class SessionRuntime {
                     const label = await this.#tui.prompt({
                         title: 'Label Conversation Node', question: `Label for ${node.label}`,
                         initialInput: draft, detail: error ?? 'Up to 120 characters. Alt+U in the tree clears a label.',
-                        allowCustom: true, notify: false, signal,
+                        signal,
                     });
                     if (label === null)
                         break;
@@ -982,7 +1026,7 @@ export class SessionRuntime {
     }
     /** Agent presets available from the live Harness roster. */
     async agentPresets() {
-        return (await this.#ctx.agentPresets.list()).sort((left, right) => (left.order ?? Number.MAX_SAFE_INTEGER) - (right.order ?? Number.MAX_SAFE_INTEGER)
+        return (await this.#ctx.agentPresets.list()).filter(preset => preset.id !== BTW_PRESET).sort((left, right) => (left.order ?? Number.MAX_SAFE_INTEGER) - (right.order ?? Number.MAX_SAFE_INTEGER)
             || left.id.localeCompare(right.id));
     }
     /** Recompose one blank session, including the preset's fixed tool exposure. */
@@ -1004,16 +1048,6 @@ export class SessionRuntime {
         this.#pushSessionInfo();
         return active.agentPreset;
     }
-    /** Select the Harness Plan Mode controller and immediately refresh terminal state. */
-    changeWorkflow(agent, active) {
-        this.assertActive(agent);
-        const planMode = this.#ctx.get('planMode');
-        if (planMode === undefined)
-            throw new Error('Plan workflow is not configured.');
-        const outcome = planMode.set(agent, active);
-        this.#pushSessionInfo();
-        return outcome;
-    }
     /**
      * Resolve and attach the changed-file summary a `workspace/changes` event
      * announces.
@@ -1038,53 +1072,57 @@ export class SessionRuntime {
         const { seq, data } = event;
         queueMicrotask(() => {
             const summary = service.summary(id, seq);
-            if (summary !== undefined)
-                tui.setWorkspaceSummary(data.turn, summary);
+            if (summary === undefined)
+                return;
+            tui.setWorkspaceSummary(data.turn, summary);
+            const recorded = session.snapshotEvents().some(candidate => {
+                const record = pluginRecordOf(candidate);
+                return record?.type === 'plugin:omdsh/workspace-changes'
+                    && typeof record.data === 'object'
+                    && record.data !== null
+                    && record.data.turn === data.turn;
+            });
+            if (!recorded) {
+                try {
+                    appendPluginRecord(session, 'plugin:omdsh/workspace-changes', { turn: data.turn, summary });
+                }
+                catch {
+                    // A read-only or closed session log still keeps the in-memory summary.
+                }
+            }
         });
     }
     /**
-     * Publish a current-format generation for every stored session an earlier
-     * release wrote. A read open never upgrades a log, so without this pass
-     * every listing and search keeps decoding the historical corpus — the pass
-     * runs once per session format, in the background, and skips a session
-     * another live process owns.
+     * Rebuild the argument vocabularies the composer completes.
+     *
+     * A snapshot, because completion runs per keystroke: `/model provider/model`,
+     * `/resume <id>` and `/login <provider>` are all names that already exist in
+     * this process, so the reader types toward them instead of opening a picker.
      */
-    async #upgradeStoredSessions(persistence) {
-        const markerPath = this.#upgradeMarkerPath;
-        if (markerPath === undefined)
-            return;
-        const marker = readJsonFile(markerPath);
-        if (typeof marker?.sessionFormat === 'number' && marker.sessionFormat >= SESSION_FORMAT_VERSION)
-            return;
-        const before = await persistence.list();
-        const revisions = new Map(before.map(snapshot => [String(snapshot.header.id), snapshot.revision]));
-        const active = this.#active?.handle.agent.id;
-        for (const snapshot of before) {
-            if (this.#disposed)
-                return;
-            if (String(snapshot.header.id) === active)
-                continue;
-            try {
-                const handle = await persistence.open(snapshot.header.id, 'write');
-                await handle.close();
-            }
-            catch (error) {
-                // Another process owns it, or the log is unreadable: leave it alone.
-                if (!(error instanceof SessionAlreadyOwnedError))
-                    this.#ctx.logger.debug(error);
+    async #refreshArgumentOptions() {
+        const options = new Map();
+        const llm = this.#ctx.get('llm');
+        if (llm !== undefined) {
+            const models = [];
+            const providers = [];
+            for (const provider of llm.listProviders()) {
+                providers.push({ value: provider.id, ...(provider.name === undefined ? {} : { description: provider.name }) });
+                for (const model of await llm.listModels(provider.id)) {
+                    models.push({
+                        value: `${provider.id}/${model.id}`,
+                        ...(model.name === undefined ? {} : { description: model.name }),
+                    });
+                }
             }
+            options.set('model', models);
+            options.set('login', providers);
         }
-        if (this.#disposed)
-            return;
-        let upgraded = 0;
-        for (const snapshot of await persistence.list()) {
-            if (revisions.get(String(snapshot.header.id)) !== snapshot.revision)
-                upgraded += 1;
-        }
-        writeJsonAtomic(markerPath, { sessionFormat: SESSION_FORMAT_VERSION });
-        if (upgraded > 0) {
-            this.#tui.notice(`Upgraded ${upgraded} stored session${upgraded === 1 ? '' : 's'} to the current format.`);
-        }
+        options.set('resume', this.#recent.map(row => ({
+            value: row.id,
+            ...(row.title === undefined ? {} : { description: row.title }),
+        })));
+        this.#argumentOptions = options;
+        this.#pushCommands();
     }
     async refreshRecent() {
         // Coalesce concurrent callers: the recent list is one snapshot, and a
@@ -1108,6 +1146,9 @@ export class SessionRuntime {
     }
     async #refreshRecentNow() {
         this.#archivedSessions = new Set(readSessionLibrary(this.#libraryPath).archived);
+        // The recent list is what `/resume` completes from, so a refresh of one is a
+        // refresh of the other. Deferred to avoid recursing through #pushCommands.
+        queueMicrotask(() => { void this.#refreshArgumentOptions().catch(() => { }); });
         const persistence = this.#ctx.get('sessionPersistence');
         if (persistence === undefined) {
             this.#recent = [];
@@ -1136,9 +1177,15 @@ export class SessionRuntime {
         for (const snapshot of snapshots) {
             const header = snapshot.header;
             const cached = this.#recentCache.get(header.id);
+            if (snapshot.formatStatus === 'migration-required') {
+                // Do not open the log merely to browse it. A previous label is a hint;
+                // the stored format classification always comes from this listing.
+                rows.push({ ...(cached?.row ?? { id: header.id, title: header.id, createdAt: header.createdAt }), formatStatus: 'migration-required' });
+                continue;
+            }
             if (cached?.revision === snapshot.revision) {
                 if (cached.row !== null)
-                    rows.push(cached.row);
+                    rows.push({ ...cached.row, ...(snapshot.formatStatus === undefined ? {} : { formatStatus: snapshot.formatStatus }) });
                 continue;
             }
             try {
@@ -1194,7 +1241,7 @@ export class SessionRuntime {
         // Own every handle here so a late activation cannot double-release it.
         for (const handle of handles)
             this.#releasedHandles.add(handle);
-        await Promise.allSettled(handles.map(handle => handle.dispose()));
+        await this.#disposeHandles(handles);
     }
     async #create(selection) {
         const ref = { current: selection, assembled: undefined };
@@ -1330,15 +1377,15 @@ export class SessionRuntime {
         this.#tui.setStatus(agent.status);
         this.#tracker.sync();
         this.#tui.setSubagents(this.#workflows.roster(this.#tracker.snapshot()));
+        const selected = this.selection(agent);
+        const status = modelStatus(selected, undefined);
+        this.#tui.setModel(status.model, status.reasoningEffort ?? active.reasoningEffort);
         // Seed welcome metadata before replaceSession commits the startup header to
         // native scrollback; later updates cannot rewrite that frozen first frame.
         this.#pushSessionInfo();
         this.#replaceTranscript(agent, reason);
         this.#pushTools();
         this.#pushCommands();
-        const selected = this.selection(agent);
-        const status = modelStatus(selected, undefined);
-        this.#tui.setModel(status.model, status.reasoningEffort ?? active.reasoningEffort);
     }
     /** Retire one agent handle once; a raced dispose takes it directly. */
     #releaseHandle(handle) {
@@ -1354,11 +1401,15 @@ export class SessionRuntime {
     #pushCommands() {
         const agent = this.agent;
         const runtime = agent === undefined ? [] : (this.#ctx.get('commands')?.list(agent) ?? []);
-        const commands = runtime.map(command => ({
-            name: command.name,
-            description: command.description,
-            ...(command.input?.hint === undefined ? {} : { inputHint: command.input.hint }),
-        }));
+        const commands = runtime.map(command => {
+            const options = this.#argumentOptions.get(command.name);
+            return {
+                name: command.name,
+                description: command.description,
+                ...(command.input?.hint === undefined ? {} : { inputHint: command.input.hint }),
+                ...(options === undefined ? {} : { complete: (prefix) => matchArgumentOptions(options, prefix) }),
+            };
+        });
         const names = new Set(commands.map(command => command.name));
         for (const skill of this.#skillCommands) {
             if (names.has(skill.name))
@@ -1385,7 +1436,10 @@ export class SessionRuntime {
             this.#skillCommands = [];
         }
         else {
-            const list = await skills.list({ cwd: agent.session.header.cwd, scope: agent, signal });
+            const cwd = currentWorkingDirectory(this.#ctx, agent.session);
+            const list = await skills.list({ cwd, scope: agent, signal });
+            if (this.#disposed || this.agent !== agent || currentWorkingDirectory(this.#ctx, agent.session) !== cwd)
+                return;
             this.#skillCommands = userSkillCommands(list);
         }
         this.#pushCommands();
@@ -1395,7 +1449,7 @@ export class SessionRuntime {
         const skills = this.#ctx.get('skills');
         if (skills === undefined)
             return undefined;
-        const list = await skills.list({ cwd: agent.session.header.cwd, scope: agent, signal });
+        const list = await skills.list({ cwd: currentWorkingDirectory(this.#ctx, agent.session), scope: agent, signal });
         return list.find(skill => skill.name === name && isUserInvocable(skill));
     }
     #lookupSession = (id) => this.#ctx.get('sessions')?.get(SessionId(id));
@@ -1456,6 +1510,7 @@ export class SessionRuntime {
         });
     }
     #replaceTranscript(agent, reason = 'refresh') {
+        this.#tui.setWorkingDirectory?.(currentWorkingDirectory(this.#ctx, agent.session));
         const events = agent.session.snapshotEvents();
         this.#tracker.observeCatalog(agent.session, events);
         this.#tui.replaceSession(events, this.#ctx.get('tuiToolPresentation')?.session(agent, events), agent.status, reason);
@@ -1489,7 +1544,12 @@ export class SessionRuntime {
             this.#tui.notice('That subagent is no longer available.', { level: 'error' });
             return;
         }
+        if (this.#tracker.snapshot()?.agents.find(agent => agent.id === id)?.mode === 'external') {
+            this.#tui.notice('External executions have no local transcript. Their results appear in the parent session.');
+            return;
+        }
         const live = this.#ctx.get('sessions')?.get(SessionId(id));
+        let cwd = live === undefined ? undefined : currentWorkingDirectory(this.#ctx, live);
         let events;
         if (live !== undefined) {
             events = live.ownEvents();
@@ -1501,6 +1561,8 @@ export class SessionRuntime {
                 if (log === undefined)
                     throw new Error('subagent transcript is unavailable');
                 events = log.events.slice(log.inheritedEventCount);
+                const change = log.events.findLast(event => event.type === 'working-directory/change');
+                cwd = change?.type === 'working-directory/change' ? change.data.cwd : log.header.cwd;
             }
             catch {
                 if (request === this.#inspectEpoch) {
@@ -1512,6 +1574,8 @@ export class SessionRuntime {
         if (request !== this.#inspectEpoch)
             return;
         this.#inspectedId = id;
+        if (cwd !== undefined)
+            this.#tui.setWorkingDirectory?.(cwd);
         const child = this.#ctx.get('agents')?.get(SessionId(id));
         this.#tui.replaceSession(events, child === undefined ? undefined : this.#ctx.get('tuiToolPresentation')?.session(child, events), child?.status ?? 'idle', 'refresh');
         this.#replayLivePrefix(id);
@@ -1586,7 +1650,28 @@ export class SessionRuntime {
         return this.#requiredActive().handle.agent;
     }
     async #disposeRetired() {
-        await Promise.allSettled(this.#retired.splice(0).map(handle => handle.dispose()));
+        await this.#disposeHandles(this.#retired.splice(0));
+    }
+    async #disposeHandles(handles) {
+        if (handles.length === 0)
+            return;
+        try {
+            await this.#ctx.get('subagents')?.drainDescendants(handles.map(handle => handle.agent));
+        }
+        catch (error) {
+            this.#ctx.logger.warn(error);
+        }
+        finally {
+            await Promise.allSettled(handles.map(handle => handle.dispose()));
+        }
     }
 }
+/** Candidates for an argument prefix, matched the way the command list matches. */
+export function matchArgumentOptions(options, prefix) {
+    const lower = prefix.trim().toLowerCase();
+    if (lower === '')
+        return options;
+    return options.filter(option => option.value.toLowerCase().includes(lower)
+        || (option.description ?? '').toLowerCase().includes(lower));
+}
 //# sourceMappingURL=session-controller.js.map