@aiwayds/dsh-tui-pi 1.0.8 → 1.2.0

package/lib/btw.d.ts

@@ -0,0 +1,224 @@
+/**
+ * /btw — by-the-way side questions (CONTEXT.md: Btw, Side call, Btw overlay,
+ * Last-btw slot, Queued btw).
+ *
+ * While the main agent is mid-turn, `/btw <question>` fires ONE tool-less
+ * one-shot model call over a read-only snapshot of the recent conversation
+ * and streams the answer into a framed overlay. The main line never sees it:
+ * nothing enters the session log, the inbox, or any main-line model request.
+ * The overlay is the only surface; closing it (Esc) does not stop the call —
+ * the finished exchange lands in the in-process Last-btw slot, reviewable
+ * via bare `/btw` until the process dies.
+ *
+ * Concurrency: at most one side call runs (BtwQueue); further submits queue
+ * behind it (bounded). Lifecycle: a main-line disruption — /new, /resume,
+ * a remote takeover, the stop gesture — cancels the running call and drops
+ * the queue; the caller wires `cancelAll` into those paths. Placement rationale:
+ * docs/adr/0001-btw-tui-owned-command.md.
+ *
+ * Split: pure decision layer here — arg parsing, snapshot assembly, the queue
+ * state machine, stream consumption and the controller, all over structural
+ * slices so the matrix runs without a terminal (test/btw.test.mjs). The
+ * overlay component + PanelHost glue live in btw-overlay.ts; the command
+ * wiring in index.ts.
+ */
+import { type Message, type ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+export declare const BTW_IDLE_NOTICE = "/btw answers alongside a running turn \u2014 the main line is idle, so just ask directly.";
+export declare const BTW_USAGE: string;
+export type ParsedBtwInput = {
+    kind: 'empty';
+} | {
+    kind: 'ok';
+    question: string;
+    modelOverride?: string;
+} | {
+    kind: 'error';
+    error: string;
+};
+/**
+ * Parse the text after `/btw`. Everything is the question except one
+ * optional `--model provider/model` override (extractable from anywhere in
+ * the line). No input at all → `'empty'` (review / usage hint); a `--model`
+ * flag without a question, or a value without a `/`, → `'error'`.
+ */
+export declare function parseBtwInput(rawInput: string | undefined): ParsedBtwInput;
+/** Structural input event — the subset of SessionEvent the snapshot needs. */
+export interface BtwSnapshotEvent {
+    readonly type: string;
+    readonly data: unknown;
+}
+/** Default recent-conversation messages carried into a side call. */
+export declare const BTW_SNAPSHOT_DEFAULT_MESSAGES = 6;
+/** Hard ceiling for the configurable snapshot size (env override clamp). */
+export declare const BTW_SNAPSHOT_MAX_MESSAGES = 50;
+/** Per-message text cap — the snapshot is context, not a transcript replay. */
+export declare const BTW_MAX_MESSAGE_CHARS = 4000;
+/**
+ * Resolve the snapshot size from the `DSH_TUI_BTW_CONTEXT_MESSAGES` env value:
+ * integer clamped to [0, BTW_SNAPSHOT_MAX_MESSAGES], anything else (unset,
+ * non-numeric) falls back to the default. 0 disables the snapshot — the side
+ * call then answers from the question alone.
+ */
+export declare function resolveSnapshotLimit(env: string | undefined): number;
+/**
+ * Project the last `limit` user/assistant text exchanges out of the session
+ * event log, oldest first. Tool calls, reasoning, usage and every
+ * non-message event are dropped; text-only fresh blocks keep each source
+ * message's identity (id/role/source) while shedding everything a tool-less
+ * call cannot use. Malformed event data is skipped, never thrown.
+ */
+export declare function buildBtwSnapshot(events: readonly BtwSnapshotEvent[], limit: number): Message[];
+/**
+ * The side-call message list: the snapshot in order, then the question as a
+ * plugin-sourced user message (it is not a real user turn of any session).
+ */
+export declare function buildBtwMessages(snapshot: readonly Message[], question: string): Message[];
+/** System prompt for the side call — no tools, snapshot is context only. */
+export declare const BTW_SYSTEM_PROMPT: string;
+/** Maximum queued btw requests while one is running. */
+export declare const BTW_QUEUE_CAP = 5;
+export interface BtwJob {
+    readonly question: string;
+    readonly modelOverride?: string;
+}
+export type BtwSubmitResult = {
+    kind: 'started';
+} | {
+    kind: 'queued';
+    position: number;
+} | {
+    kind: 'rejected';
+    reason: string;
+};
+/**
+ * Single-flight queue: one running btw, bounded FIFO behind it. The queue is
+ * the concurrency truth — the controller's view state is derived from it.
+ */
+export declare class BtwQueue {
+    private currentJob;
+    private readonly waiting;
+    get running(): boolean;
+    get queuedCount(): number;
+    submit(job: BtwJob): BtwSubmitResult;
+    /** Settle the current job; returns the next job to launch, if any. */
+    finishCurrent(): BtwJob | undefined;
+    cancelAll(): {
+        canceledRunning: boolean;
+        canceledQueued: number;
+    };
+}
+/**
+ * Structural stream chunk — the subset of dsh-llm's StreamChunk a side call
+ * consumes (text deltas for the live view, the finish chunk for the outcome).
+ */
+export interface BtwStreamChunk {
+    readonly type: string;
+    readonly text?: string;
+    readonly reason?: {
+        readonly kind: string;
+        readonly failure?: {
+            readonly message?: string;
+        };
+    };
+}
+export interface BtwCallOptions {
+    provider: string;
+    model: string;
+    reasoningEffort?: ReasoningEffortId;
+    messages: Message[];
+    system: string;
+    signal?: AbortSignal;
+}
+export type BtwStreamFn = (options: BtwCallOptions) => AsyncIterable<BtwStreamChunk>;
+export type BtwFinish = {
+    kind: 'stop';
+    answer: string;
+} | {
+    kind: 'aborted';
+} | {
+    kind: 'error';
+    message: string;
+};
+/**
+ * Drain one side-call stream: forward text deltas as they arrive, map the
+ * finish chunk (or the stream's end / a throw) to a terminal outcome. A
+ * stream that ends without a finish chunk is an error, never a silent
+ * success; an aborted signal wins over whatever the iterator does next.
+ */
+export declare function consumeBtwStream(chunks: AsyncIterable<BtwStreamChunk>, onDelta: (text: string) => void, signal?: AbortSignal): Promise<BtwFinish>;
+export type BtwRunStatus = 'streaming' | 'done' | 'error' | 'canceled';
+/** View state of the running (or just-finished) side call; overlay-facing. */
+export interface BtwRunState {
+    readonly question: string;
+    readonly modelLabel: string;
+    status: BtwRunStatus;
+    answerText: string;
+    error?: string;
+}
+/** The Last-btw slot — the in-process record of the most recent exchange. */
+export interface BtwLastExchange {
+    readonly question: string;
+    readonly answer: string;
+    readonly modelLabel: string;
+}
+export type BtwNoticeKind = 'info' | 'error' | 'warning';
+export interface BtwSelection {
+    provider: string;
+    model: string;
+    reasoningEffort?: ReasoningEffortId;
+}
+export interface BtwControllerDeps {
+    stream: BtwStreamFn;
+    resolveSelection: () => BtwSelection | undefined;
+    buildSnapshot: () => readonly Message[];
+    requestRender: () => void;
+    notify: (message: string, kind: BtwNoticeKind) => void;
+    /** The glue opens (or swaps) the overlay for a launched run. */
+    onRunStarted: (run: BtwRunState) => void;
+    /** cancelAll: the glue closes the overlay (the run is gone either way). */
+    onOverlayRequestedClose: () => void;
+    /**
+     * Whether a capturing surface (overlay / docked ask-user panel) currently
+     * owns the keyboard. Queue-drained launches under one skip the popup and
+     * run into the slot instead — the answer is reviewable via bare /btw.
+     */
+    hasCapturingSurface?: () => boolean;
+}
+/**
+ * Owns the btw concurrency, the side-call execution and the Last-btw slot.
+ * The overlay glue (btw-overlay.ts) renders `currentRun` / `last` on every
+ * frame and reports overlay open/close back through `setOverlayOpen`.
+ */
+export declare class BtwController {
+    private readonly deps;
+    private readonly queue;
+    private abortController;
+    private run;
+    private lastExchange;
+    private overlayOpen;
+    constructor(deps: BtwControllerDeps);
+    /** View state for the overlay: the live/just-settled run wins over the slot. */
+    get currentRun(): BtwRunState | undefined;
+    get last(): BtwLastExchange | undefined;
+    get queuedCount(): number;
+    /** The glue reports overlay lifecycle so error notices know where to land. */
+    setOverlayOpen(open: boolean): void;
+    submit(job: BtwJob): BtwSubmitResult;
+    /**
+     * Bare `/btw`: an active run reopens live on its overlay; otherwise the
+     * Last-btw slot is shown; nothing at all → the caller shows the usage.
+     */
+    openReview(): 'live' | 'review' | 'empty';
+    /**
+     * Main-line disruption (/new, /resume, remote takeover, stop gesture):
+     * abort the running call, drop the queue, close the overlay. The slot is
+     * untouched — a canceled run never overwrites the last completed one.
+     */
+    cancelAll(): void;
+    /** TUI teardown: same as cancelAll without the overlay ceremony. */
+    dispose(): void;
+    private launch;
+    private execute;
+    /** Settle the queue slot; a queued job (if any) launches immediately. */
+    private drain;
+}

package/lib/btw.js

@@ -0,0 +1,419 @@
+/**
+ * /btw — by-the-way side questions (CONTEXT.md: Btw, Side call, Btw overlay,
+ * Last-btw slot, Queued btw).
+ *
+ * While the main agent is mid-turn, `/btw <question>` fires ONE tool-less
+ * one-shot model call over a read-only snapshot of the recent conversation
+ * and streams the answer into a framed overlay. The main line never sees it:
+ * nothing enters the session log, the inbox, or any main-line model request.
+ * The overlay is the only surface; closing it (Esc) does not stop the call —
+ * the finished exchange lands in the in-process Last-btw slot, reviewable
+ * via bare `/btw` until the process dies.
+ *
+ * Concurrency: at most one side call runs (BtwQueue); further submits queue
+ * behind it (bounded). Lifecycle: a main-line disruption — /new, /resume,
+ * a remote takeover, the stop gesture — cancels the running call and drops
+ * the queue; the caller wires `cancelAll` into those paths. Placement rationale:
+ * docs/adr/0001-btw-tui-owned-command.md.
+ *
+ * Split: pure decision layer here — arg parsing, snapshot assembly, the queue
+ * state machine, stream consumption and the controller, all over structural
+ * slices so the matrix runs without a terminal (test/btw.test.mjs). The
+ * overlay component + PanelHost glue live in btw-overlay.ts; the command
+ * wiring in index.ts.
+ */
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+// ------------------------------------------------------------ UI copy (English-only, AGENTS.md #4) --
+export const BTW_IDLE_NOTICE = '/btw answers alongside a running turn — the main line is idle, so just ask directly.';
+export const BTW_USAGE = 'Usage: /btw <question> — ask a side question while the main task runs. ' +
+    'The answer streams into a temporary overlay and is not kept in the session.';
+/**
+ * Parse the text after `/btw`. Everything is the question except one
+ * optional `--model provider/model` override (extractable from anywhere in
+ * the line). No input at all → `'empty'` (review / usage hint); a `--model`
+ * flag without a question, or a value without a `/`, → `'error'`.
+ */
+export function parseBtwInput(rawInput) {
+    const raw = (rawInput ?? '').trim();
+    if (raw === '')
+        return { kind: 'empty' };
+    let modelOverride;
+    let question = raw;
+    const match = /(?:^|\s)--model\s+(\S+)/.exec(raw);
+    if (match !== null) {
+        modelOverride = match[1];
+        question = `${raw.slice(0, match.index)} ${raw.slice(match.index + match[0].length)}`.trim();
+    }
+    if (question === '')
+        return { kind: 'error', error: 'No question after /btw --model.' };
+    if (modelOverride !== undefined && !modelOverride.includes('/')) {
+        return { kind: 'error', error: `Invalid --model "${modelOverride}" — expected provider/model.` };
+    }
+    // The override key is omitted (not undefined-valued) when absent.
+    return modelOverride === undefined
+        ? { kind: 'ok', question }
+        : { kind: 'ok', question, modelOverride };
+}
+/** Default recent-conversation messages carried into a side call. */
+export const BTW_SNAPSHOT_DEFAULT_MESSAGES = 6;
+/** Hard ceiling for the configurable snapshot size (env override clamp). */
+export const BTW_SNAPSHOT_MAX_MESSAGES = 50;
+/** Per-message text cap — the snapshot is context, not a transcript replay. */
+export const BTW_MAX_MESSAGE_CHARS = 4000;
+const TRUNCATION_SUFFIX = '\n…[truncated]';
+/**
+ * Resolve the snapshot size from the `DSH_TUI_BTW_CONTEXT_MESSAGES` env value:
+ * integer clamped to [0, BTW_SNAPSHOT_MAX_MESSAGES], anything else (unset,
+ * non-numeric) falls back to the default. 0 disables the snapshot — the side
+ * call then answers from the question alone.
+ */
+export function resolveSnapshotLimit(env) {
+    const parsed = Number.parseInt(env ?? '', 10);
+    if (Number.isNaN(parsed))
+        return BTW_SNAPSHOT_DEFAULT_MESSAGES;
+    return Math.min(Math.max(parsed, 0), BTW_SNAPSHOT_MAX_MESSAGES);
+}
+/** Join an unknown message `content` into plain text (text blocks only). */
+function textOf(content) {
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const block of content) {
+        if (block !== null && typeof block === 'object' &&
+            block.type === 'text' &&
+            typeof block.text === 'string') {
+            parts.push(block.text);
+        }
+    }
+    return parts.join('\n');
+}
+function clipMessage(text) {
+    return text.length > BTW_MAX_MESSAGE_CHARS
+        ? text.slice(0, BTW_MAX_MESSAGE_CHARS) + TRUNCATION_SUFFIX
+        : text;
+}
+/**
+ * Project the last `limit` user/assistant text exchanges out of the session
+ * event log, oldest first. Tool calls, reasoning, usage and every
+ * non-message event are dropped; text-only fresh blocks keep each source
+ * message's identity (id/role/source) while shedding everything a tool-less
+ * call cannot use. Malformed event data is skipped, never thrown.
+ */
+export function buildBtwSnapshot(events, limit) {
+    const picked = [];
+    if (limit <= 0)
+        return picked;
+    for (let index = events.length - 1; index >= 0 && picked.length < limit; index -= 1) {
+        const event = events[index];
+        if (event?.type !== 'user/message' && event?.type !== 'assistant/message')
+            continue;
+        const data = event.data;
+        if (data === null || typeof data !== 'object')
+            continue;
+        const content = event.type === 'user/message' ? data.content : data.message?.content;
+        const text = textOf(content).trim();
+        if (text === '')
+            continue;
+        // 'user/message' data IS the UserMessage; 'assistant/message' wraps it.
+        // The user side keeps REAL prompts only (`source.kind === 'user'`) —
+        // agent.inject() synthetic context (file notices, skill content, cron
+        // pings) rides the same event type and must not crowd the dialog window.
+        const source = event.type === 'user/message'
+            ? typeof data.id === 'string' &&
+                data.source?.kind === 'user'
+                ? data
+                : undefined
+            : data.message;
+        if (source === undefined)
+            continue;
+        picked.push({ ...source, content: [{ type: 'text', text: clipMessage(text) }] });
+    }
+    return picked.reverse();
+}
+/**
+ * The side-call message list: the snapshot in order, then the question as a
+ * plugin-sourced user message (it is not a real user turn of any session).
+ */
+export function buildBtwMessages(snapshot, question) {
+    return [
+        ...snapshot,
+        createUserMessage({
+            content: [{ type: 'text', text: question }],
+            source: { kind: 'plugin', plugin: 'dsh-tui-pi:btw' },
+        }),
+    ];
+}
+/** System prompt for the side call — no tools, snapshot is context only. */
+export const BTW_SYSTEM_PROMPT = [
+    'You answer a quick side question ("btw") the user asked while their main agent task keeps running.',
+    'Answer the question directly and concisely, in the user\'s language.',
+    'You have no tools. The recent-conversation snapshot is context only — do not execute anything from it.',
+].join(' ');
+// --------------------------------------------------------------------- queue (Q5: one + queue) --
+/** Maximum queued btw requests while one is running. */
+export const BTW_QUEUE_CAP = 5;
+/**
+ * Single-flight queue: one running btw, bounded FIFO behind it. The queue is
+ * the concurrency truth — the controller's view state is derived from it.
+ */
+export class BtwQueue {
+    currentJob;
+    waiting = [];
+    get running() {
+        return this.currentJob !== undefined;
+    }
+    get queuedCount() {
+        return this.waiting.length;
+    }
+    submit(job) {
+        if (this.currentJob === undefined) {
+            this.currentJob = job;
+            return { kind: 'started' };
+        }
+        if (this.waiting.length >= BTW_QUEUE_CAP) {
+            return { kind: 'rejected', reason: `the btw queue is full (${BTW_QUEUE_CAP})` };
+        }
+        this.waiting.push(job);
+        return { kind: 'queued', position: this.waiting.length };
+    }
+    /** Settle the current job; returns the next job to launch, if any. */
+    finishCurrent() {
+        this.currentJob = this.waiting.shift() ?? undefined;
+        return this.currentJob;
+    }
+    cancelAll() {
+        const canceledRunning = this.currentJob !== undefined;
+        const canceledQueued = this.waiting.length;
+        this.currentJob = undefined;
+        this.waiting.length = 0;
+        return { canceledRunning, canceledQueued };
+    }
+}
+/**
+ * Drain one side-call stream: forward text deltas as they arrive, map the
+ * finish chunk (or the stream's end / a throw) to a terminal outcome. A
+ * stream that ends without a finish chunk is an error, never a silent
+ * success; an aborted signal wins over whatever the iterator does next.
+ */
+export async function consumeBtwStream(chunks, onDelta, signal) {
+    let answer = '';
+    try {
+        for await (const chunk of chunks) {
+            if (signal?.aborted)
+                return { kind: 'aborted' };
+            if (chunk.type === 'text-delta' && typeof chunk.text === 'string' && chunk.text !== '') {
+                answer += chunk.text;
+                onDelta(chunk.text);
+            }
+            else if (chunk.type === 'finish') {
+                switch (chunk.reason?.kind) {
+                    case 'stop':
+                        return { kind: 'stop', answer };
+                    case 'aborted':
+                        return { kind: 'aborted' };
+                    case 'error':
+                        return { kind: 'error', message: chunk.reason.failure?.message ?? 'Unknown model stream error.' };
+                    case 'max-tokens':
+                        return { kind: 'error', message: 'The answer hit the output token cap.' };
+                    case 'tool-calls':
+                        return { kind: 'error', message: 'The side model unexpectedly requested tools.' };
+                    default:
+                        return { kind: 'error', message: `Unsupported stream finish: ${String(chunk.reason?.kind)}` };
+                }
+            }
+        }
+        return { kind: 'error', message: 'The model stream ended without a finish chunk.' };
+    }
+    catch (error) {
+        if (signal?.aborted)
+            return { kind: 'aborted' };
+        return { kind: 'error', message: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Owns the btw concurrency, the side-call execution and the Last-btw slot.
+ * The overlay glue (btw-overlay.ts) renders `currentRun` / `last` on every
+ * frame and reports overlay open/close back through `setOverlayOpen`.
+ */
+export class BtwController {
+    deps;
+    queue = new BtwQueue();
+    abortController;
+    run;
+    lastExchange;
+    overlayOpen = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** View state for the overlay: the live/just-settled run wins over the slot. */
+    get currentRun() {
+        return this.run;
+    }
+    get last() {
+        return this.lastExchange;
+    }
+    get queuedCount() {
+        return this.queue.queuedCount;
+    }
+    /** The glue reports overlay lifecycle so error notices know where to land. */
+    setOverlayOpen(open) {
+        this.overlayOpen = open;
+        // A settled run whose only surface closed has no further viewer — prune
+        // it so a later render never resurrects a stale answer. A streaming run
+        // must survive the close (it delivers into the slot on settle).
+        if (!open && this.run !== undefined && this.run.status !== 'streaming') {
+            this.run = undefined;
+            this.deps.requestRender();
+        }
+    }
+    submit(job) {
+        const outcome = this.queue.submit(job);
+        if (outcome.kind === 'started')
+            this.launch(job);
+        return outcome;
+    }
+    /**
+     * Bare `/btw`: an active run reopens live on its overlay; otherwise the
+     * Last-btw slot is shown; nothing at all → the caller shows the usage.
+     */
+    openReview() {
+        if (this.run !== undefined) {
+            this.deps.onRunStarted(this.run);
+            return 'live';
+        }
+        if (this.lastExchange === undefined)
+            return 'empty';
+        this.deps.onRunStarted({
+            question: this.lastExchange.question,
+            modelLabel: this.lastExchange.modelLabel,
+            status: 'done',
+            answerText: this.lastExchange.answer,
+        });
+        return 'review';
+    }
+    /**
+     * Main-line disruption (/new, /resume, remote takeover, stop gesture):
+     * abort the running call, drop the queue, close the overlay. The slot is
+     * untouched — a canceled run never overwrites the last completed one.
+     */
+    cancelAll() {
+        const { canceledRunning, canceledQueued } = this.queue.cancelAll();
+        this.abortController?.abort();
+        this.abortController = undefined;
+        this.run = undefined;
+        if (canceledRunning || canceledQueued > 0)
+            this.deps.onOverlayRequestedClose();
+    }
+    /** TUI teardown: same as cancelAll without the overlay ceremony. */
+    dispose() {
+        this.queue.cancelAll();
+        this.abortController?.abort();
+        this.abortController = undefined;
+        this.run = undefined;
+        this.overlayOpen = false;
+    }
+    launch(job, promoted = false) {
+        const selection = job.modelOverride === undefined
+            ? this.deps.resolveSelection()
+            : resolveOverride(job.modelOverride);
+        if (selection === undefined) {
+            this.deps.notify(job.modelOverride === undefined
+                ? 'No model selected — btw cannot run.'
+                : `btw model "${job.modelOverride}" is not available.`, 'error');
+            this.drain();
+            return;
+        }
+        const run = {
+            question: job.question,
+            modelLabel: `${selection.provider}/${selection.model}`,
+            status: 'streaming',
+            answerText: '',
+        };
+        this.run = run;
+        const abort = new AbortController();
+        this.abortController = abort;
+        if (promoted && this.deps.hasCapturingSurface?.() === true) {
+            // A drained job popping up under an active dialog/overlay would steal
+            // the keyboard mid-flow — run into the slot instead; /btw reopens it.
+            this.deps.notify('btw running in the background — /btw to view the answer.', 'info');
+        }
+        else {
+            this.deps.onRunStarted(run);
+        }
+        void this.execute(run, job, selection, abort.signal);
+    }
+    async execute(run, job, selection, signal) {
+        let finish;
+        try {
+            const messages = buildBtwMessages(this.deps.buildSnapshot(), job.question);
+            finish = await consumeBtwStream(this.deps.stream({
+                provider: selection.provider,
+                model: selection.model,
+                ...(selection.reasoningEffort === undefined ? {} : { reasoningEffort: selection.reasoningEffort }),
+                messages,
+                system: BTW_SYSTEM_PROMPT,
+                signal,
+            }), delta => {
+                run.answerText += delta;
+                this.deps.requestRender();
+            }, signal);
+        }
+        catch (error) {
+            // deps.stream throws synchronously (service missing / bad route) —
+            // same terminal path as a stream error, never an unhandled rejection.
+            finish = { kind: 'error', message: error instanceof Error ? error.message : String(error) };
+        }
+        // A cancelAll between launch and settle already reaped the run — never
+        // resurrect it (identity guard, steer-flow's flush-time liveness check).
+        if (this.run !== run)
+            return;
+        this.abortController = undefined;
+        if (finish.kind === 'stop') {
+            run.status = 'done';
+            // consumeBtwStream's accumulation and the onDelta mirror are the same
+            // sequence — the returned answer is the single source of truth.
+            this.lastExchange = {
+                question: run.question,
+                answer: finish.answer,
+                modelLabel: run.modelLabel,
+            };
+        }
+        else if (finish.kind === 'aborted') {
+            run.status = 'canceled';
+            this.run = undefined;
+            this.deps.requestRender();
+            // Normally unreachable: aborts come from cancelAll/dispose, which reap
+            // the run first (the identity guard above returns). But an adapter may
+            // report an aborted finish on its own — never strand the queue on it.
+            this.drain();
+            return;
+        }
+        else {
+            run.status = 'error';
+            run.error = finish.message;
+            // No surface to show the failure on — the footer notice is the only
+            // channel left (the overlay path renders it in place).
+            if (!this.overlayOpen)
+                this.deps.notify(`btw failed: ${finish.message}`, 'error');
+        }
+        this.deps.requestRender();
+        this.drain();
+    }
+    /** Settle the queue slot; a queued job (if any) launches immediately. */
+    drain() {
+        const next = this.queue.finishCurrent();
+        if (next !== undefined)
+            this.launch(next, true);
+    }
+}
+/**
+ * Parse a `provider/model` override. Returns undefined when either half is
+ * empty — the caller surfaces the rejection; no throwing across the queue.
+ */
+function resolveOverride(modelOverride) {
+    const slash = modelOverride.indexOf('/');
+    if (slash <= 0 || slash === modelOverride.length - 1)
+        return undefined;
+    return { provider: modelOverride.slice(0, slash), model: modelOverride.slice(slash + 1) };
+}
+//# sourceMappingURL=btw.js.map

package/lib/btw.js.map

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

package/lib/clipboard.d.ts

@@ -112,3 +112,13 @@ export declare function readClipboard(impl?: ClipboardImpl): Promise<string | nu
  * full from a previous run; the seam keeps the test order independent.
  */
 export declare function __resetClipboardUnavailableForTest(): void;
+/** Environment variable selecting fullscreen copy-on-select (`DSH_TUI_COPY_ON_SELECT`). */
+export declare const COPY_ON_SELECT_ENV = "DSH_TUI_COPY_ON_SELECT";
+/**
+ * Resolve whether releasing a fullscreen mouse selection copies it to the
+ * clipboard (pi-tui `TuiAltScreen` `copyOnSelect`). Enabled by default — the
+ * same trade-off pi-tui picks and the behavior the plugin always had — so an
+ * unset/invalid value must never accidentally disable the feature; only an
+ * explicit off value (`0`/`false`/`off`) turns it off.
+ */
+export declare function resolveCopyOnSelect(env?: NodeJS.ProcessEnv): boolean;