@aiwayds/dsh-tui-pi 1.0.8 → 1.1.0

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/index.js

@@ -44,6 +44,8 @@ import { openSubagentViewer } from "./subagent-viewer.js";
 import { commandUsagePath, CommandUsageTracker } from "./usage.js";
 import { buildUserPrompt, decideSubmitPath, deliverToAgent, promotePending, removeFromInbox, STEER_UNAVAILABLE_NOTICE, TURN_ENDED_QUEUED_NOTICE, } from "./steer-flow.js";
 import { openSubmitRouteDialog } from "./route-dialog.js";
+import { BtwController, BTW_IDLE_NOTICE, BTW_USAGE, buildBtwSnapshot, parseBtwInput, resolveSnapshotLimit, } from "./btw.js";
+import { BtwOverlayWire } from "./btw-overlay.js";
 import { openPendingQueuePanel } from "./queue-panel.js";
 import { ansiFg, BOLD, darkTheme, lightTheme, RESET, resolveTheme } from "./theme/index.js";
 import { rgbIsLight } from "./theme/palette.js";
@@ -479,6 +481,8 @@ export function apply(ctx) {
          */
         const stopTask = async () => {
             renderer.renderNotice(`${stopIcon()} canceling current turn…`, 'info');
+            // The stop gesture is the everything-stop: side calls die with the turn.
+            btwController.cancelAll();
             const cancelled = await bridge.cancelActiveTurn();
             // State raced idle between the decision and the cancel call — nothing
             // to cancel (e.g. the turn settled inside the confirm window).
@@ -609,6 +613,7 @@ export function apply(ctx) {
             onRemotePromotable: async (idRaw) => {
                 // Queued follow-ups won the writer-lock race at an idle boundary:
                 // take over EXACTLY like a manual /resume, then flush the queue.
+                btwController.cancelAll();
                 const resumed = await bridge.resume(SessionId(idRaw));
                 refreshPermissionPreset();
                 renderer.clear();
@@ -713,6 +718,89 @@ export function apply(ctx) {
         // Wiring through the handle: the editor is rebuilt on theme hot-swap, and
         // these providers are re-applied to the replacement instance.
         ui.setEditorAutocompleteProvider(commands.autocompleteProvider());
+        // ------------------------------------------------------------ /btw (TUI-owned; ADR 0001) --
+        // By-the-way side questions: one tool-less one-shot model call over a
+        // read-only recent-conversation snapshot, streaming into a framed
+        // overlay. Nothing enters the session log, the inbox, or any main-line
+        // model request. Placed here (not an independent plugin) because the
+        // deliverable — overlay, focus, cancellation timing — only exists inside
+        // dsh-tui-pi; see docs/adr/0001-btw-tui-owned-command.md.
+        const btwWire = new BtwOverlayWire({
+            tui: ui.tui,
+            theme: () => ui.theme,
+            restoreFocus: refocusEditor,
+        });
+        const btwSnapshotLimit = resolveSnapshotLimit(process.env.DSH_TUI_BTW_CONTEXT_MESSAGES);
+        const btwController = new BtwController({
+            stream: options => {
+                const llm = ctx.get('llm');
+                if (llm === undefined)
+                    throw new Error('LLM service is not available.');
+                return llm.stream({
+                    provider: options.provider,
+                    model: options.model,
+                    ...(options.reasoningEffort === undefined ? {} : { reasoningEffort: options.reasoningEffort }),
+                    messages: options.messages,
+                    system: options.system,
+                    ...(options.signal === undefined ? {} : { signal: options.signal }),
+                });
+            },
+            resolveSelection: () => {
+                const selection = bridge.getSelection();
+                return selection === undefined
+                    ? undefined
+                    : { provider: selection.provider, model: selection.model, reasoningEffort: selection.reasoningEffort };
+            },
+            buildSnapshot: () => {
+                const agent = bridge.getAgent();
+                return agent === undefined
+                    ? []
+                    : buildBtwSnapshot(agent.session.events, btwSnapshotLimit);
+            },
+            requestRender: () => ui.requestRender(),
+            notify: (message, kind) => renderer.renderNotice(message, kind),
+            onRunStarted: run => btwWire.open(run),
+            onOverlayRequestedClose: () => btwWire.requestClose(),
+            hasCapturingSurface: () => ui.tui.hasOverlay() || askUserActive,
+        });
+        btwWire.attach(btwController);
+        const btwHandler = async (rawInput) => {
+            const parsed = parseBtwInput(rawInput);
+            if (parsed.kind === 'empty') {
+                const opened = btwController.openReview();
+                return opened === 'live'
+                    ? { kind: 'success', text: 'btw — the running answer is back on screen.' }
+                    : opened === 'review'
+                        ? { kind: 'success', text: 'Last btw exchange shown.' }
+                        : { kind: 'success', text: BTW_USAGE };
+            }
+            if (parsed.kind === 'error')
+                return { kind: 'error', text: parsed.error };
+            // btw is by-the-way by definition: the main line must be running (and
+            // this must be the live view, not a read-only remote one) — when idle,
+            // a normal prompt is strictly better (tools, history, full context).
+            if (!(bridge.isRunning() && !bridge.isReadOnlyView())) {
+                return { kind: 'error', text: BTW_IDLE_NOTICE };
+            }
+            const result = btwController.submit({
+                question: parsed.question,
+                ...(parsed.modelOverride === undefined ? {} : { modelOverride: parsed.modelOverride }),
+            });
+            switch (result.kind) {
+                case 'started':
+                    return { kind: 'success', text: 'btw — answering alongside the main task.' };
+                case 'queued':
+                    return { kind: 'success', text: `btw queued (position ${result.position}).` };
+                case 'rejected':
+                    return { kind: 'error', text: `btw rejected — ${result.reason}.` };
+            }
+        };
+        commands.registerLocal('btw', btwHandler);
+        ctx.effect(() => ctx.commands.register({
+            name: 'btw',
+            description: 'Ask a side question while the main task runs (temp overlay, not kept)',
+            handler: invocation => btwHandler(invocation.rawInput, invocation.signal),
+        }), 'dsh-tui-pi: /btw');
         // ------------------------------------------- TUI-owned slash commands --
         // Web-surface parity: `model` is a browser client contribution there and
         // `export` a web-only download plugin — the terminal gets native
@@ -973,6 +1061,9 @@ export function apply(ctx) {
             // (including the WriterLockedError read-only fallback).
             const resumeAndReplay = async () => {
                 let resumed;
+                // Switching sessions cancels any in-flight btw (Q5b) — its snapshot
+                // belongs to the session being left.
+                btwController.cancelAll();
                 try {
                     resumed = await bridge.resume(target.id);
                 }
@@ -1170,6 +1261,8 @@ export function apply(ctx) {
         // detachCurrent keeps the event subscriptions alive (dispose() would
         // splice them away and no future message would ever render again).
         const newHandler = async () => {
+            // A new session strands the btw context snapshot — cancel first (Q5b).
+            btwController.cancelAll();
             try {
                 await bridge.detachCurrent();
             }
@@ -1716,6 +1809,7 @@ export function apply(ctx) {
             clearInterval(clockTimer);
             clearInterval(liveTimer);
             git.dispose();
+            btwController.dispose();
             applyThemeRef = undefined;
             applyPanelHeightRef = undefined;
             applyFooterHintsRef = undefined;