@aiwayds/dsh-tui-pi 0.1.0

package/lib/reload.js

@@ -0,0 +1,171 @@
+/**
+ * Manual hot-reload for the dsh-tui-pi plugin.
+ *
+ * Mirrors @deepseek-ai/cordis-plugin-hmr's partial reload: evict the plugin
+ * entry and its user-code dependency closure from the module caches, re-import
+ * the entry fresh, then swap the plugin runtime in the registry so a new fiber
+ * re-runs `apply` with the new code. A `/reload` after editing `src/` and
+ * running `pnpm build` picks the change up without restarting dsh.
+ *
+ * The swap disposes the old fiber — the TUI, its timers, and the live agent
+ * bridge are torn down (the session log persists and can be rejoined with
+ * /resume). Failures before the swap leave the old TUI untouched; failures
+ * during the swap roll the caches back and restart the previous code.
+ */
+import { createRequire } from 'node:module';
+import { realpathSync } from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+const require = createRequire(import.meta.url);
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Skip node: builtins and anything under node_modules (shared, stable). */
+function isUserCode(url) {
+    return !url.startsWith('node:') && !url.includes('/node_modules/');
+}
+/** Recursively collect the user-code dependency closure of a module job. */
+async function collectDependencies(job, out) {
+    if (out.has(job.url) || !isUserCode(job.url))
+        return;
+    out.add(job.url);
+    for (const child of await job.linked)
+        await collectDependencies(child, out);
+}
+/**
+ * The entry URL the loader recorded equals `import.meta.url` of the entry
+ * module, modulo symlink resolution — try both against the module cache.
+ */
+function resolveEntryUrl(fallbackUrl, internal) {
+    const candidates = [fallbackUrl];
+    try {
+        candidates.push(pathToFileURL(realpathSync(fileURLToPath(fallbackUrl))).href);
+    }
+    catch { /* non-file URL → fallbackUrl stands */ }
+    for (const url of candidates) {
+        if (Map.prototype.has.call(internal.loadCache, url))
+            return url;
+    }
+    return candidates[0];
+}
+// ------------------------------------------------------------------- reload --
+let reloading;
+/**
+ * Reload the dsh-tui-pi plugin from the current source.
+ *
+ * @param ctx — the plugin context (the fiber being reloaded).
+ * @param entryUrl — `import.meta.url` of the plugin entry module.
+ * @returns a human-readable outcome; the plugin fiber is swapped on success.
+ */
+export function reloadPlugin(ctx, entryUrl) {
+    // Re-entrancy guard: a second /reload while one is in flight joins it.
+    reloading ??= performReload(ctx, entryUrl).finally(() => { reloading = undefined; });
+    return reloading;
+}
+async function performReload(ctx, fallbackUrl) {
+    const loader = ctx.get('loader');
+    const internal = loader?.internal;
+    if (loader === undefined)
+        return 'Reload unavailable: the loader service is not mounted.';
+    if (internal === undefined)
+        return 'Reload unavailable: the module loader is not reachable.';
+    const runtime = ctx.fiber.runtime;
+    if (runtime === null || runtime === undefined)
+        return 'Reload unavailable: no plugin runtime.';
+    const url = resolveEntryUrl(fallbackUrl, internal);
+    const job = internal.loadCache.get(url);
+    if (job === undefined)
+        return `Reload failed: the plugin entry is not loaded (${url}).`;
+    // Dependency closure of the entry: our lib/*.js only. node: builtins and
+    // node_modules are shared with the rest of dsh and stay cached.
+    const files = new Set();
+    try {
+        await collectDependencies(job, files);
+    }
+    catch (error) {
+        return `Reload failed: cannot walk the module graph (${messageOf(error)}).`;
+    }
+    // Evict ESM loadCache + CJS Module._cache so the re-import re-reads source.
+    // Map.prototype methods bypass Node 24+'s typed LoadCache overrides (its
+    // `.delete` only nulls a type slot; a raw delete removes the entry).
+    const esmBackup = new Map();
+    const cjsBackup = new Map();
+    for (const filename of files) {
+        esmBackup.set(filename, Map.prototype.get.call(internal.loadCache, filename));
+        Map.prototype.delete.call(internal.loadCache, filename);
+        try {
+            const filepath = fileURLToPath(filename);
+            const cached = require.cache[filepath];
+            if (cached) {
+                cjsBackup.set(filepath, cached);
+                delete require.cache[filepath];
+            }
+        }
+        catch { /* not a file URL */ }
+    }
+    const restoreCaches = () => {
+        for (const [filename, entry] of esmBackup) {
+            if (entry === undefined)
+                Map.prototype.delete.call(internal.loadCache, filename);
+            else
+                Map.prototype.set.call(internal.loadCache, filename, entry);
+        }
+        for (const [filepath, module] of cjsBackup)
+            require.cache[filepath] = module;
+    };
+    // Re-import the entry fresh; on failure restore the caches and keep the old
+    // TUI untouched.
+    let fresh;
+    try {
+        fresh = loader.unwrapExports(await loader.import(url, () => []));
+    }
+    catch (error) {
+        restoreCaches();
+        return `Reload failed: ${messageOf(error)}`;
+    }
+    const oldFibers = [...runtime.fibers];
+    const oldCallback = runtime.callback;
+    try {
+        // Remove the runtime first: the loader's internal/plugin handler checks
+        // registry.has(callback) on disposal and must not mark the entry disabled,
+        // and the fiber disposers then skip their own registry bookkeeping.
+        ctx.registry.delete(oldCallback);
+        // registry.delete already called fiber.dispose() on every old fiber, so a
+        // second dispose() call here would be useless — cordis effect wrappers
+        // return void 0 once their cleanup is in flight — and the teardown would
+        // race the fresh fiber's start below. Await the real teardown through
+        // each fiber's lifecycle inertia instead. Yield one turn first: fibers
+        // whose "ctx.plugin()" effect is async only start their unload on a
+        // microtask, and await() must see the in-flight inertia to wait for it.
+        // This ordering matters: the old TUI's terminal stop must land BEFORE the
+        // fresh TUI takes the terminal over, or the late stop would disable raw
+        // mode and pause stdin out from under the new TUI (input deadlock).
+        await new Promise(resolve => setImmediate(resolve));
+        await Promise.allSettled(oldFibers.map(fiber => fiber.await()));
+        for (const oldFiber of oldFibers) {
+            const next = oldFiber.parent.registry.plugin(fresh, oldFiber._config, () => []);
+            next.entry = oldFiber.entry;
+            if (next.entry)
+                next.entry.fiber = next;
+            await next;
+        }
+    }
+    catch (error) {
+        // Roll back: drop the failed fresh runtime, restore caches, and restart
+        // the previous code so the TUI comes back.
+        const message = messageOf(error);
+        try {
+            ctx.registry.delete(fresh);
+        }
+        catch { /* contained */ }
+        restoreCaches();
+        try {
+            for (const oldFiber of oldFibers) {
+                await oldFiber.parent.registry.plugin(oldCallback, oldFiber._config, () => []);
+            }
+        }
+        catch { /* contained */ }
+        return `Reload failed: ${message}`;
+    }
+    return 'Reloaded — the TUI restarted from the current source.';
+}
+//# sourceMappingURL=reload.js.map

package/lib/reload.js.map

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

package/lib/selectors.d.ts

@@ -0,0 +1,48 @@
+/**
+ * TUI overlays (pi SelectList style). Currently: the `/model` picker and the
+ * reasoning effort picker — the terminal counterparts of the web UI's "model"
+ * client contribution — plus the `/theme` preference picker and the
+ * `/permission` preset picker.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ModelSelection } from '@deepseek-ai/dsh-agent';
+import type { ReasoningEffortId } from '@deepseek-ai/dsh-llm';
+import { type TUI } from '@earendil-works/pi-tui';
+import type { ThemePreference, TuiTheme } from './theme/index.ts';
+/** Outcome of the reasoning effort picker overlay. */
+export type PickEffortResult = {
+    kind: 'unsupported';
+} | {
+    kind: 'cancelled';
+} | {
+    kind: 'effort';
+    effort: ReasoningEffortId | 'default';
+};
+/**
+ * Open the reasoning effort picker for the current model. Resolves with the
+ * picked outcome: the model exposes no selectable efforts (`unsupported`),
+ * the user cancelled (`cancelled`), or a chosen effort — where `'default'`
+ * clears the effort override. Focus returns to `restoreFocus` on close.
+ */
+export declare function pickEffort(ctx: Context, tui: TUI, theme: TuiTheme, current: ModelSelection, restoreFocus: () => void): Promise<PickEffortResult>;
+/**
+ * Open the theme preference picker overlay. Resolves with the picked
+ * preference, or `undefined` when cancelled. The row matching `current` is
+ * preselected; focus returns to `restoreFocus` on close.
+ */
+export declare function pickTheme(tui: TUI, theme: TuiTheme, current: ThemePreference, restoreFocus: () => void): Promise<ThemePreference | undefined>;
+/**
+ * Open the permission preset picker overlay. Resolves with the picked preset
+ * name, or `undefined` when cancelled. The row matching `current` is
+ * preselected when present; focus returns to `restoreFocus` on close.
+ * Without a composed permission-presets service there is nothing to pick —
+ * resolves `undefined` immediately.
+ */
+export declare function pickPermission(ctx: Context, tui: TUI, theme: TuiTheme, current: string | undefined, restoreFocus: () => void): Promise<string | undefined>;
+/**
+ * Open the model picker overlay. Resolves with the picked selection, or
+ * `undefined` when cancelled. When the picked model exposes selectable
+ * reasoning efforts, a second overlay asks for one; cancelling that stage
+ * abandons the whole pick. Focus returns to `restoreFocus` on close.
+ */
+export declare function pickModel(ctx: Context, tui: TUI, theme: TuiTheme, current: ModelSelection | undefined, restoreFocus: () => void): Promise<ModelSelection | undefined>;

package/lib/selectors.js

@@ -0,0 +1,261 @@
+/**
+ * TUI overlays (pi SelectList style). Currently: the `/model` picker and the
+ * reasoning effort picker — the terminal counterparts of the web UI's "model"
+ * client contribution — plus the `/theme` preference picker and the
+ * `/permission` preset picker.
+ */
+import { SelectList } from '@earendil-works/pi-tui';
+import { wrapFramedOverlay } from "./frame.js";
+import { permissionItems } from "./permission.js";
+/** First row of the effort picker: explicitly no effort override. */
+const DEFAULT_EFFORT_ITEM = {
+    value: 'default',
+    label: '(provider default)',
+    description: 'adapter default behavior — clears the effort override',
+};
+/**
+ * Run the reasoning effort SelectList overlay over the given efforts. Resolves
+ * with the chosen effort (`'default'` meaning no override), or `undefined`
+ * when cancelled. The row matching `selectedEffort` is preselected when
+ * present. `afterShow` runs once the overlay is up (used by the two-stage
+ * model picker to hide the previous stage only after this one owns focus);
+ * focus returns to `restoreFocus` on close.
+ */
+function openEffortPicker(tui, theme, efforts, selectedEffort, restoreFocus, afterShow) {
+    const items = [
+        DEFAULT_EFFORT_ITEM,
+        ...efforts.map(effort => ({
+            value: effort.id,
+            label: effort.name,
+            ...(effort.description !== undefined ? { description: effort.description } : {}),
+        })),
+    ];
+    return new Promise(resolve => {
+        const list = new SelectList(items, 12, theme.selectList);
+        if (selectedEffort !== undefined) {
+            const index = items.findIndex(item => item.value === selectedEffort);
+            if (index >= 0)
+                list.setSelectedIndex(index);
+        }
+        // The framed overlay adds 4 rows (borders + spacers) on top of the list;
+        // the cap must leave them room or the bottom border is sliced off on
+        // small terminals (13 list rows + 4 frame rows = 17 ≤ 18 at 24 rows).
+        const overlay = tui.showOverlay(wrapFramedOverlay(theme, list), { width: '80%', maxHeight: '75%' });
+        afterShow?.();
+        const finish = (effort) => {
+            overlay.hide();
+            restoreFocus();
+            resolve(effort === undefined ? undefined : { effort });
+        };
+        list.onSelect = item => finish(item.value);
+        list.onCancel = () => finish(undefined);
+    });
+}
+/**
+ * Open the reasoning effort picker for the current model. Resolves with the
+ * picked outcome: the model exposes no selectable efforts (`unsupported`),
+ * the user cancelled (`cancelled`), or a chosen effort — where `'default'`
+ * clears the effort override. Focus returns to `restoreFocus` on close.
+ */
+export async function pickEffort(ctx, tui, theme, current, restoreFocus) {
+    const llm = ctx.get('llm');
+    if (llm === undefined)
+        return { kind: 'unsupported' };
+    let info;
+    try {
+        info = await llm.resolveModelInfo(current.provider, current.model);
+    }
+    catch {
+        return { kind: 'unsupported' };
+    }
+    const efforts = info.reasoning?.efforts;
+    if (efforts === undefined || efforts.length === 0)
+        return { kind: 'unsupported' };
+    const picked = await openEffortPicker(tui, theme, efforts, current.reasoningEffort, restoreFocus);
+    if (picked === undefined)
+        return { kind: 'cancelled' };
+    return { kind: 'effort', effort: picked.effort };
+}
+/** Theme preference rows of the picker, matching the settings schema vocabulary. */
+const THEME_ITEMS = [
+    { value: 'auto', label: 'auto (terminal detection)', description: 'follow the terminal light/dark signal' },
+    { value: 'light', label: 'light', description: 'GitHub light palette' },
+    { value: 'dark', label: 'dark', description: 'GitHub dark palette' },
+];
+/**
+ * Open the theme preference picker overlay. Resolves with the picked
+ * preference, or `undefined` when cancelled. The row matching `current` is
+ * preselected; focus returns to `restoreFocus` on close.
+ */
+export function pickTheme(tui, theme, current, restoreFocus) {
+    return new Promise(resolve => {
+        const list = new SelectList(THEME_ITEMS, 12, theme.selectList);
+        const index = THEME_ITEMS.findIndex(item => item.value === current);
+        if (index >= 0)
+            list.setSelectedIndex(index);
+        // Framed overlay: 13 list rows + 4 frame rows fit inside 75% of 24 rows.
+        const overlay = tui.showOverlay(wrapFramedOverlay(theme, list), { width: '80%', maxHeight: '75%' });
+        const finish = (picked) => {
+            overlay.hide();
+            restoreFocus();
+            resolve(picked);
+        };
+        list.onSelect = item => finish(item.value);
+        list.onCancel = () => finish(undefined);
+    });
+}
+/**
+ * Open the permission preset picker overlay. Resolves with the picked preset
+ * name, or `undefined` when cancelled. The row matching `current` is
+ * preselected when present; focus returns to `restoreFocus` on close.
+ * Without a composed permission-presets service there is nothing to pick —
+ * resolves `undefined` immediately.
+ */
+export function pickPermission(ctx, tui, theme, current, restoreFocus) {
+    const presets = ctx.get('permissionPresets');
+    if (presets === undefined)
+        return Promise.resolve(undefined);
+    const items = permissionItems(presets, current);
+    return new Promise((resolve, reject) => {
+        const list = new SelectList(items, 12, theme.selectList);
+        if (current !== undefined) {
+            const index = items.findIndex(item => item.value === current);
+            if (index >= 0)
+                list.setSelectedIndex(index);
+        }
+        // Framed overlay: 13 list rows + 4 frame rows fit inside 75% of 24 rows.
+        let overlay;
+        try {
+            overlay = tui.showOverlay(wrapFramedOverlay(theme, list), { width: '80%', maxHeight: '75%' });
+        }
+        catch (error) {
+            // Never strand the keyboard on a half-mounted picker: the rejection
+            // reaches the caller (submit's try/catch surfaces it), but focus must
+            // already be back on the editor.
+            restoreFocus();
+            reject(error);
+            return;
+        }
+        const finish = (picked) => {
+            overlay.hide();
+            restoreFocus();
+            resolve(picked);
+        };
+        list.onSelect = item => finish(item.value);
+        list.onCancel = () => finish(undefined);
+    });
+}
+/**
+ * Open the model picker overlay. Resolves with the picked selection, or
+ * `undefined` when cancelled. When the picked model exposes selectable
+ * reasoning efforts, a second overlay asks for one; cancelling that stage
+ * abandons the whole pick. Focus returns to `restoreFocus` on close.
+ */
+export async function pickModel(ctx, tui, theme, current, restoreFocus) {
+    const llm = ctx.get('llm');
+    if (llm === undefined)
+        return undefined;
+    const providers = llm.listProviders();
+    const models = [];
+    await Promise.all(providers.map(async (provider) => {
+        try {
+            for (const model of await llm.listModels(provider.id)) {
+                models.push({ provider: provider.id, id: model.id, name: model.name });
+            }
+        }
+        catch { /* one provider's listing failure must not kill the picker */ }
+    }));
+    if (models.length === 0)
+        return undefined;
+    const key = (m) => `${m.provider}/${m.id}`;
+    const items = models.map(model => ({
+        value: key(model),
+        label: model.name === '' ? model.id : model.name,
+        description: model.provider,
+    }));
+    return new Promise(resolve => {
+        const list = new SelectList(items, 12, theme.selectList);
+        const currentIndex = items.findIndex(item => item.value === `${current?.provider}/${current?.model}`);
+        if (currentIndex >= 0)
+            list.setSelectedIndex(currentIndex);
+        // Framed overlay: 13 list rows + 4 frame rows fit inside 75% of 24 rows.
+        const overlay = tui.showOverlay(wrapFramedOverlay(theme, list), { width: '80%', maxHeight: '75%' });
+        const finish = (picked) => {
+            // Detach the stage-1 input handlers on first settle: while the model
+            // info resolves (stage 2 not up yet), a stray Esc would otherwise fire
+            // a ghost settle AFTER this promise already settled, and a second
+            // Enter would run two concurrent stage-2s.
+            list.onSelect = () => { };
+            list.onCancel = () => { };
+            if (picked === undefined) {
+                overlay.hide();
+                restoreFocus();
+                resolve(undefined);
+                return;
+            }
+            // The stage-1 overlay stays visible while the model info resolves; the
+            // stage-2 picker hides it only after it owns focus (no focus trip
+            // through the editor between the two overlays).
+            void pickEffortStage(picked).catch(() => { });
+        };
+        /**
+         * Second stage: when the picked route exposes selectable reasoning
+         * efforts, ask for one. Cancelling this stage abandons the whole pick;
+         * a resolution failure skips it and keeps the current effort on the same
+         * provider only.
+         */
+        const pickEffortStage = async (picked) => {
+            // The current effort survives a pick only within the same provider; a
+            // new provider starts from its own default behavior.
+            const keptEffort = current !== undefined && current.provider === picked.provider
+                ? current.reasoningEffort
+                : undefined;
+            let efforts;
+            try {
+                efforts = (await llm.resolveModelInfo(picked.provider, picked.id)).reasoning?.efforts;
+            }
+            catch {
+                // Resolution failure: fall back to the plain selection, keeping the
+                // current effort on the same provider.
+                overlay.hide();
+                restoreFocus();
+                resolve({
+                    provider: picked.provider,
+                    model: picked.id,
+                    ...(keptEffort !== undefined ? { reasoningEffort: keptEffort } : {}),
+                });
+                return;
+            }
+            if (efforts === undefined || efforts.length === 0) {
+                // No selectable efforts on this route: same fallback as above.
+                overlay.hide();
+                restoreFocus();
+                resolve({
+                    provider: picked.provider,
+                    model: picked.id,
+                    ...(keptEffort !== undefined ? { reasoningEffort: keptEffort } : {}),
+                });
+                return;
+            }
+            const chosen = await openEffortPicker(tui, theme, efforts, keptEffort, restoreFocus, 
+            // Hide stage 1 only after stage 2 took focus.
+            () => overlay.hide());
+            if (chosen === undefined) {
+                // Escaping the effort stage is an escape from the whole pick.
+                resolve(undefined);
+                return;
+            }
+            if (chosen.effort === 'default') {
+                // Explicitly no override: clear any inherited effort.
+                resolve({ provider: picked.provider, model: picked.id });
+                return;
+            }
+            resolve({ provider: picked.provider, model: picked.id, reasoningEffort: chosen.effort });
+        };
+        list.onSelect = item => {
+            finish(models.find(model => key(model) === item.value));
+        };
+        list.onCancel = () => finish(undefined);
+    });
+}
+//# sourceMappingURL=selectors.js.map

package/lib/selectors.js.map

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

package/lib/session.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Session bridge between the dsh tree and the TUI.
+ *
+ * Responsibilities:
+ * - lazy agent creation on first prompt (openma runner pattern)
+ * - prompt delivery via agent.followup()
+ * - session-event subscription filtered to the bridge's session
+ * - O(1) incremental stats maintained as events arrive (footer reads these —
+ *   never re-scans the session log, per the pi-turbo findings)
+ * - resume of persisted sessions (log replay into stats + transcript)
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent, AgentHandle, ModelSelection } from '@deepseek-ai/dsh-agent';
+import { SessionId, type SessionEvent } from '@deepseek-ai/dsh-session';
+import type { AgentView } from './dsh-events.ts';
+export interface BridgeCallbacks {
+    /** One session-log event for the bridge's session, in log order. */
+    onEvent(event: SessionEvent): void;
+    /** Whole-agent lifecycle transition. */
+    onStatus(status: 'idle' | 'running'): void;
+    /** Live snapshot of tracked subagent (child session) rows, on any change. */
+    onLive(agents: readonly AgentView[]): void;
+}
+/** Incrementally maintained footer statistics (all O(1) reads). */
+export interface BridgeStats {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    /** User + assistant surface messages observed. */
+    msgCount: number;
+    toolCallCount: number;
+    /** Whole-log cache-hit rate: cumulative cacheReadTokens ÷ billed input (input + cacheRead + cacheWrite), matching DSH web. */
+    cacheHitRate?: number;
+}
+export declare class DshSessionBridge {
+    private readonly ctx;
+    private readonly callbacks;
+    private handle;
+    private creating;
+    private resuming;
+    private readonly disposers;
+    private sessionId;
+    private selection;
+    /** Mutable live selection installed into the agent; `/model` mutates `current`. */
+    private readonly selectionRef;
+    /** Mirror of the agent's `agent/status`; `isRunning()` reads this. */
+    private running;
+    private readonly stats;
+    /** Live subagent rows keyed by child session id. */
+    private readonly agentViews;
+    /** Child session ids whose own events we fold into the agent views. */
+    private readonly childSessions;
+    /**
+     * Session ids that can own tracked children (this session first, then every
+     * tracked child — delegation nests). Used to match `parentSession` headers
+     * and to fold workflow events of the parent log.
+     */
+    private readonly trackedSessions;
+    /** `${runId}:${seq}` → childId, for `tool-workflow/agent-end` pairing. */
+    private readonly runSeqToChild;
+    constructor(ctx: Context, callbacks: BridgeCallbacks);
+    /** Snapshot of the incremental stats (footer reads this O(1)). */
+    getStats(): BridgeStats;
+    /** Current session id, when one exists. */
+    getSessionId(): SessionId | undefined;
+    /** Queue one user prompt, creating the session lazily on first use. */
+    prompt(text: string): Promise<void>;
+    /** The live agent, creating the session lazily when needed. */
+    ensureAgent(): Promise<Agent>;
+    /** The live agent when a session already exists (no creation side effect). */
+    getAgent(): Agent | undefined;
+    /** Whether the bridge's agent is mid-turn (mirror of `agent/status`). */
+    isRunning(): boolean;
+    /**
+     * Abort the bridge's agent mid-turn, mirroring the web client's stop
+     * button: the host-side `session.cancel` handler calls
+     * `agent.cancel({ kind: 'user' }, { keepInbox: true })`
+     * (dsh-host-apiproxy), and that is exactly what the agent's public
+     * synchronous `cancel(cause, options)` API takes. `keepInbox` preserves
+     * queued prompts for a later turn; the active driver's AbortSignal fires
+     * and status converges to `idle` via the existing subscription. The API
+     * is fire-and-forget — the returned promise resolves once the call is
+     * made, not when the turn settles.
+     * @returns false when there is no agent or it is not running; true once
+     *   the cancellation was issued.
+     */
+    cancelActiveTurn(): Promise<boolean>;
+    /** Dispose the live agent (if any) and stop event subscriptions. */
+    dispose(): Promise<void>;
+    /**
+     * Detach the live agent WITHOUT tearing down the event subscriptions —
+     * `/new` wants a fresh session while the renderer keeps receiving events.
+     * The agent handle is disposed, the session id cleared, and the
+     * incremental stats zeroed (the footer must not carry the old session's
+     * numbers); the disposers stay installed, and the session-id filter
+     * re-binds on the next lazy creation. The subagent tracker is cleared and
+     * an empty `onLive` is emitted so the renderer drops the agents block.
+     */
+    detachCurrent(): Promise<void>;
+    /**
+     * Resume a persisted session: tear down the live agent (disposers are kept —
+     * the session-id filter re-binds to the resumed id) and load the persisted
+     * session in its place. The caller replays `handle.agent.session.events`
+     * through `replay()` to rebuild stats/transcript — clear the transcript
+     * BEFORE replaying (the renderer's echo dedupe must not see replayed user
+     * messages next to a stale local echo). Serialized: concurrent calls share
+     * the single in-flight resume.
+     */
+    resume(sessionId: SessionId): Promise<AgentHandle>;
+    /**
+     * Replay a persisted session log into the transcript and stats — the second
+     * half of a resume (call after `resume()`). Stats are rebuilt from zero so
+     * the footer reflects the resumed session only; replaying the same log
+     * twice is idempotent. `assistant/chunk` events are skipped: the finalized
+     * `assistant/message` carries the full text, and replaying chunks would
+     * re-run the quadratic streaming assembly for every historical step.
+     */
+    replay(events: readonly SessionEvent[]): void;
+    /** Update incremental stats from one event — one pass over the event only. */
+    private applyEvent;
+    /**
+     * Fold one event of a tracked session into the agent views (workflow events
+     * of the parent log + the child's own log). O(1) per event — Maps/Sets only,
+     * never a session-log scan. Emits `onLive` when a view actually changed.
+     * @returns whether a view changed (and `onLive` was emitted).
+     */
+    private foldTracked;
+    /** Push the current agent views (stable order) to the renderer. */
+    private emitLive;
+    private ensureSession;
+    /**
+     * Seed `selection`/`selectionRef` from the composed default — without
+     * clobbering a live user choice: `/model`/`/think` before the first prompt
+     * write the ref, and that choice must survive session creation.
+     */
+    private seedSelectionFromDefault;
+    /** Create the agent with the composed default model selection. */
+    private createSession;
+    /** The model selection shown in the footer (live value after `/model`). */
+    getSelection(): ModelSelection | undefined;
+    /** Apply a live model switch (`/model` selector outcome). */
+    setSelection(next: ModelSelection): void;
+}
+/**
+ * Persist the default model selection. Preferred path: the
+ * `agent-default-model` service's `saveSelection`, the official API (a
+ * settings.replace, last-write-wins). The namespace is read live by that
+ * service — the change takes effect on the next lazy session creation
+ * (`/new` or the next prompt) and survives restarts. Without the service,
+ * fall back to a direct settings mutate (with one optimistic-concurrency
+ * retry). Best-effort: a deployment without a settings provider is skipped
+ * silently; a failed write returns its error message for the caller to
+ * surface.
+ * @returns undefined on success, the failure message otherwise.
+ */
+export declare function persistDefaultModel(ctx: Context, selection: ModelSelection): Promise<string | undefined>;