@aiwayds/dsh-tui-pi 0.1.0

package/lib/commands.js

@@ -0,0 +1,167 @@
+/**
+ * Slash-command integration with dsh's own command registry.
+ *
+ * dsh-tui-pi never re-implements a command: autocomplete lists
+ * `ctx.commands.list(agent)` and submission routes through
+ * `ctx.commands.execute(agent, line, signal)`. Anything that is not a
+ * resolvable command falls through to the model as an ordinary prompt, so
+ * every command registered by dsh packages (plan, compact, feedback, export,
+ * permission, goal, …) works here unchanged and future registrations appear
+ * automatically.
+ *
+ * One exemption: TUI-owned commands that never touch the receiving agent
+ * (model pickers, settings browser, session info/resume) are dispatched
+ * locally when no live agent exists — dsh's execute path addresses an agent
+ * and would mint a throwaway session just to run them.
+ */
+import { parseCommand } from '@deepseek-ai/dsh-commands';
+/**
+ * Token ending at the cursor on one editor line, for command detection.
+ * Returns the leading slash token when the caret sits inside one.
+ */
+function tokenAtCursor(line, cursorCol) {
+    const upto = line.slice(0, cursorCol);
+    const match = /(^|\s)\/([a-z][a-z0-9_-]*)?$/u.exec(upto);
+    if (match === null)
+        return undefined;
+    const start = match.index + (match[1] ?? '').length;
+    return { token: upto.slice(start), start };
+}
+export class CommandService {
+    ctx;
+    bridge;
+    /** TUI-owned command bodies, dispatchable without a live agent. */
+    local = new Map();
+    constructor(ctx, bridge) {
+        this.ctx = ctx;
+        this.bridge = bridge;
+    }
+    /**
+     * Register a local command body (the same handler the ctx.commands
+     * registration wraps). It is dispatched directly when no live agent
+     * exists, avoiding a throwaway session for agentless commands.
+     */
+    registerLocal(name, handler) {
+        this.local.set(name, handler);
+    }
+    /**
+     * Try to run `line` as a dsh slash command.
+     * @returns `handled: true` when the line was admitted as a command (the
+     *   caller must not forward it to the model), with an optional `error` or
+     *   success `text` to surface; `handled: false` when it is not a command.
+     */
+    async tryExecute(line, signal) {
+        const parsed = parseCommand(line);
+        if (parsed === undefined)
+            return { handled: false };
+        const commands = this.ctx.get('commands');
+        if (commands === undefined)
+            return { handled: false };
+        // Agentless local commands never warm the session — /resume or /session
+        // on a fresh TUI must not mint a session just to run.
+        const localHandler = this.local.get(parsed.name);
+        if (localHandler !== undefined && this.bridge.getAgent() === undefined) {
+            try {
+                const result = await localHandler(parsed.rawInput, signal);
+                if (result.kind === 'error')
+                    return { handled: true, error: result.text };
+                return { handled: true, ...result.text === undefined ? {} : { text: result.text } };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return { handled: true, error: message };
+            }
+        }
+        // Commands address a live agent; warm the session when it does not exist.
+        let agent;
+        try {
+            agent = await this.bridge.ensureAgent();
+        }
+        catch (error) {
+            // Warm-up failed (e.g. provider not configured) — surface instead of
+            // rejecting into an unhandled promise rejection.
+            const message = error instanceof Error ? error.message : String(error);
+            return { handled: true, error: message };
+        }
+        if (commands.find(agent, parsed.name) === undefined) {
+            // Syntactically a command but unregistered → treat as ordinary text so
+            // the model still sees it (matches "unknown command" falling through).
+            return { handled: false };
+        }
+        try {
+            const execution = await commands.execute(agent, line, signal);
+            if (execution === undefined)
+                return { handled: false };
+            if (execution.result.kind === 'error')
+                return { handled: true, error: execution.result.text };
+            return { handled: true, ...execution.result.text === undefined ? {} : { text: execution.result.text } };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { handled: true, error: message };
+        }
+    }
+    /**
+     * Effective command descriptors for the current agent. Warms the session on
+     * first use so `/` autocompletes before any prompt was sent.
+     */
+    async list() {
+        const commands = this.ctx.get('commands');
+        if (commands === undefined)
+            return [];
+        try {
+            const agent = await this.bridge.ensureAgent();
+            return commands.list(agent);
+        }
+        catch {
+            // Session warm-up failed (e.g. provider not configured) — no completions.
+            return [];
+        }
+    }
+    /** pi-tui autocomplete provider over the live command registry. */
+    autocompleteProvider() {
+        return {
+            triggerCharacters: ['/'],
+            getSuggestions: async (lines, cursorLine, cursorCol, options) => {
+                const line = lines[cursorLine] ?? '';
+                const at = tokenAtCursor(line, cursorCol);
+                if (at === undefined)
+                    return null;
+                // Only complete the command name itself (leading token, no arguments yet).
+                if (at.start !== 0 && line.slice(0, at.start).trim() !== '')
+                    return null;
+                const descriptors = await this.list();
+                if (descriptors.length === 0)
+                    return null;
+                const query = at.token.slice(1).toLowerCase();
+                const items = descriptors
+                    .filter(d => query === '' || d.name.toLowerCase().startsWith(query))
+                    .map(d => ({
+                    value: `/${d.name}`,
+                    label: `/${d.name}`,
+                    description: d.description,
+                }));
+                if (items.length === 0)
+                    return null;
+                return { items, prefix: at.token };
+            },
+            applyCompletion: (lines, cursorLine, cursorCol, item, prefix) => {
+                const line = lines[cursorLine] ?? '';
+                const at = tokenAtCursor(line, cursorCol);
+                if (at === undefined)
+                    return { lines, cursorLine, cursorCol };
+                const before = line.slice(0, at.start);
+                const after = line.slice(cursorCol);
+                const completed = `${before}${item.value} ${after}`;
+                const nextLines = lines.slice();
+                nextLines[cursorLine] = completed;
+                return {
+                    lines: nextLines,
+                    cursorLine,
+                    cursorCol: before.length + item.value.length + 1,
+                };
+            },
+        };
+    }
+}
+//# sourceMappingURL=commands.js.map

package/lib/commands.js.map

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

package/lib/dsh-events.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Local structural types for session events whose declaring packages
+ * (`@deepseek-ai/dsh-tool-workflow`, `@deepseek-ai/dsh-subagent`,
+ * `@deepseek-ai/dsh-llm-retry`) are not installed in this plugin. The TUI
+ * receives these events on the `session/event` firehose regardless (the
+ * firehose is not scope-filtered — see dsh-scope's generated subject
+ * resolvers), so the bridge folds them through these minimal, dependency-free
+ * shapes instead of importing the augmenting packages.
+ *
+ * `SessionEvent` is a closed discriminated union over the core event map, so
+ * `switch (event.type)` falls through these types; the guards narrow them
+ * explicitly.
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+declare module '@deepseek-ai/dsh-session' {
+    interface SessionEventMap {
+        'tool-workflow/agent-start': ToolWorkflowAgentStartData;
+        'tool-workflow/agent-end': ToolWorkflowAgentEndData;
+        'subagent/descriptor': SubagentDescriptorData;
+        'llm/retry': LlmRetryData;
+    }
+}
+/** `tool-workflow/agent-start`: one workflow member, after its child Session is published. */
+export interface ToolWorkflowAgentStartData {
+    readonly runId: string;
+    readonly seq: number;
+    readonly label: string;
+    readonly phase?: string;
+    readonly childId: string;
+}
+/** `tool-workflow/agent-end`: one workflow member settlement. */
+export interface ToolWorkflowAgentEndData {
+    readonly runId: string;
+    readonly seq: number;
+    readonly outcome: 'completed' | 'failed' | 'cancelled';
+}
+/** `subagent/descriptor`: durable identity of a session-backed subagent child. */
+export interface SubagentDescriptorData {
+    readonly version: number;
+    readonly mode: 'one-shot' | 'continuable';
+    readonly provider: string;
+    readonly label?: string;
+}
+/** `llm/retry`: one provider-routed retry scheduled after a failed request attempt. */
+export interface LlmRetryData {
+    readonly retry: number;
+    /** Absent for the `mode: 'always'` arm of the real event. */
+    readonly maxRetries?: number;
+}
+/** Type guard for `tool-workflow/agent-start` events. */
+export declare function isAgentStart(event: SessionEvent): event is SessionEvent & {
+    type: 'tool-workflow/agent-start';
+    data: ToolWorkflowAgentStartData;
+};
+/** Type guard for `tool-workflow/agent-end` events. */
+export declare function isAgentEnd(event: SessionEvent): event is SessionEvent & {
+    type: 'tool-workflow/agent-end';
+    data: ToolWorkflowAgentEndData;
+};
+/** Type guard for `subagent/descriptor` events (written to the CHILD session's log). */
+export declare function isSubagentDescriptor(event: SessionEvent): event is SessionEvent & {
+    type: 'subagent/descriptor';
+    data: SubagentDescriptorData;
+};
+/** Type guard for `llm/retry` events. */
+export declare function isLlmRetry(event: SessionEvent): event is SessionEvent & {
+    type: 'llm/retry';
+    data: LlmRetryData;
+};
+/**
+ * One live subagent row the TUI renders: the bridge's per-child fold of
+ * workflow events (parent log) and the child's own session events. Children
+ * are keyed by their session id — discovered either from
+ * `tool-workflow/agent-start` or, when the deployment never emits workflow
+ * events, from the child session's header (`origin: 'subagent'` +
+ * `parentSession`). All fields are O(1)-maintained — never a session-log
+ * scan on the render path.
+ */
+export interface AgentView {
+    /** The child session id (raw string) — the stable identity key. */
+    readonly childId: string;
+    /** Subagent type name from the child's `subagent/descriptor.provider`, when known. */
+    readonly provider?: string;
+    /** Delegation label from `tool-workflow/agent-start` or the child's descriptor. */
+    readonly label: string;
+    /** Unix epoch ms when the child was first observed — the elapsed baseline. */
+    readonly startedAt: number;
+    /**
+     * Settled marker: set by `tool-workflow/agent-end` (real outcome) or,
+     * for header-discovered children, best-effort on the child's `turn/end`.
+     * A settled child drops off the live board (clear-when-done).
+     */
+    readonly outcome?: 'completed' | 'failed' | 'cancelled';
+    /** Unix epoch ms of the settle event, when settled. */
+    readonly endedAt?: number;
+    /** Cumulative tokens: input + output + cacheRead + cacheWrite. */
+    readonly tokens: number;
+    /** Latest `llm/retry` attempt number (0 = none retried). */
+    readonly retries: number;
+    /** Latest `llm/retry` maxRetries, when the policy reported one. */
+    readonly maxRetries?: number;
+    /** Last tool name the child invoked (the activity line), when any. */
+    readonly lastTool?: string;
+    /** Context window from the child's `request/context`, for the % column. */
+    readonly contextWindow?: number;
+}

package/lib/dsh-events.js

@@ -0,0 +1,30 @@
+/**
+ * Local structural types for session events whose declaring packages
+ * (`@deepseek-ai/dsh-tool-workflow`, `@deepseek-ai/dsh-subagent`,
+ * `@deepseek-ai/dsh-llm-retry`) are not installed in this plugin. The TUI
+ * receives these events on the `session/event` firehose regardless (the
+ * firehose is not scope-filtered — see dsh-scope's generated subject
+ * resolvers), so the bridge folds them through these minimal, dependency-free
+ * shapes instead of importing the augmenting packages.
+ *
+ * `SessionEvent` is a closed discriminated union over the core event map, so
+ * `switch (event.type)` falls through these types; the guards narrow them
+ * explicitly.
+ */
+/** Type guard for `tool-workflow/agent-start` events. */
+export function isAgentStart(event) {
+    return event.type === 'tool-workflow/agent-start';
+}
+/** Type guard for `tool-workflow/agent-end` events. */
+export function isAgentEnd(event) {
+    return event.type === 'tool-workflow/agent-end';
+}
+/** Type guard for `subagent/descriptor` events (written to the CHILD session's log). */
+export function isSubagentDescriptor(event) {
+    return event.type === 'subagent/descriptor';
+}
+/** Type guard for `llm/retry` events. */
+export function isLlmRetry(event) {
+    return event.type === 'llm/retry';
+}
+//# sourceMappingURL=dsh-events.js.map

package/lib/dsh-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-events.js","sourceRoot":"","sources":["../src/dsh-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqDH,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,OAAO,KAAK,CAAC,IAAI,KAAK,2BAA2B,CAAA;AACnD,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,UAAU,CAAC,KAAmB;IAC5C,OAAO,KAAK,CAAC,IAAI,KAAK,yBAAyB,CAAA;AACjD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IACtD,OAAO,KAAK,CAAC,IAAI,KAAK,qBAAqB,CAAA;AAC7C,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,UAAU,CAAC,KAAmB;IAC5C,OAAO,KAAK,CAAC,IAAI,KAAK,WAAW,CAAA;AACnC,CAAC"}

package/lib/editor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Custom editor that replaces the input's TOP BORDER row with a plain-text
+ * info line: cwd + permission badge + git branch (separator "│"), in border
+ * color only (no powerline background segments). Ported from
+ * pi-powerline-footer's CwdBorderEditor; every other editor row is left
+ * untouched.
+ */
+import { Editor, type EditorTheme, type TUI } from '@earendil-works/pi-tui';
+/** Shorten the cwd by replacing the HOME prefix with `~`. */
+export declare function formatCwd(cwd: string): string;
+export declare class CwdBorderEditor extends Editor {
+    private readonly sessionCwd;
+    private readonly infoColor;
+    private branchProvider;
+    private permissionProvider;
+    constructor(tui: TUI, theme: EditorTheme, sessionCwd: string, options?: {
+        paddingX?: number;
+        infoColor?: (str: string) => string;
+    });
+    /** Live git-branch source (polled outside; the editor only reads it). */
+    setBranchProvider(provider: () => string | undefined): void;
+    /**
+     * Live permission-preset display-name source (e.g. "Full access") — the
+     * badge shown right after the cwd; polled outside, the editor only reads it.
+     */
+    setPermissionProvider(provider: () => string | undefined): void;
+    render(width: number): string[];
+}

package/lib/editor.js

@@ -0,0 +1,70 @@
+/**
+ * Custom editor that replaces the input's TOP BORDER row with a plain-text
+ * info line: cwd + permission badge + git branch (separator "│"), in border
+ * color only (no powerline background segments). Ported from
+ * pi-powerline-footer's CwdBorderEditor; every other editor row is left
+ * untouched.
+ */
+import { Editor, truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
+/** Shorten the cwd by replacing the HOME prefix with `~`. */
+export function formatCwd(cwd) {
+    const home = process.env.HOME;
+    if (home !== undefined && cwd.startsWith(home)) {
+        return `~${cwd.slice(home.length)}`;
+    }
+    return cwd;
+}
+export class CwdBorderEditor extends Editor {
+    sessionCwd;
+    infoColor;
+    branchProvider = () => undefined;
+    permissionProvider = () => undefined;
+    constructor(tui, theme, sessionCwd, options) {
+        super(tui, theme, { paddingX: options?.paddingX ?? 0 });
+        this.sessionCwd = sessionCwd;
+        // The border dashes stay border-colored, but the cwd/branch info needs a
+        // readable foreground (border color is near-invisible on light themes).
+        this.infoColor = options?.infoColor ?? theme.borderColor;
+    }
+    /** Live git-branch source (polled outside; the editor only reads it). */
+    setBranchProvider(provider) {
+        this.branchProvider = provider;
+    }
+    /**
+     * Live permission-preset display-name source (e.g. "Full access") — the
+     * badge shown right after the cwd; polled outside, the editor only reads it.
+     */
+    setPermissionProvider(provider) {
+        this.permissionProvider = provider;
+    }
+    render(width) {
+        const lines = super.render(width);
+        if (lines.length < 2 || width < 3)
+            return lines;
+        // When scrolled, the built-in top border row is a scroll indicator
+        // ("─── ↑ N more ─…"); preserve that feedback by appending ↑ N.
+        const firstLine = lines[0] ?? '';
+        const scrollMatch = /↑\s*(\d+)/u.exec(firstLine);
+        const scrollInfo = scrollMatch === null ? '' : ` ↑ ${scrollMatch[1]}`;
+        const permission = this.permissionProvider();
+        const parts = [
+            `📁 ${formatCwd(this.sessionCwd)}` +
+                (permission !== undefined && permission !== '' ? ` (${permission})` : ''),
+        ];
+        const branch = this.branchProvider();
+        if (branch !== undefined && branch !== '')
+            parts.push(`⎇ ${branch}`);
+        const content = parts.join(' │ ') + scrollInfo;
+        // Reserve 3 fixed columns: "─ " prefix (2) + " " suffix (1).
+        const maxContent = Math.max(0, width - 3);
+        const contentText = truncateToWidth(content, maxContent, '…');
+        const fill = Math.max(0, width - 3 - visibleWidth(contentText));
+        lines[0] =
+            this.borderColor('─ ') +
+                this.infoColor(contentText) +
+                this.borderColor(' ') +
+                this.borderColor('─'.repeat(fill));
+        return lines;
+    }
+}
+//# sourceMappingURL=editor.js.map

package/lib/editor.js.map

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

package/lib/footer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Powerline-style status footer, ported from pi-powerline-footer.
+ *
+ * Segments (left → right): fixed brand "dsh" · provider · model+thinking ·
+ * context usage · cache-hit rate · message count · tool count, then a
+ * right-aligned 24h clock. Segment backgrounds are the pi-powerline-footer
+ * palette; separators are U+E0B0 powerline arrows tinted by the neighbouring
+ * segment colours.
+ *
+ * Render cost is O(segments): every statistic is read from the bridge's
+ * incrementally maintained counters (never a session-log scan). The 1s clock
+ * tick only re-renders this component's single line.
+ */
+import { type Component } from '@earendil-works/pi-tui';
+import type { BridgeStats } from './session.ts';
+export interface FooterDataSource {
+    /** O(1) incremental counters. */
+    getStats(): BridgeStats;
+    /** Current model selection (provider, model, reasoning effort). */
+    getSelection(): {
+        provider: string;
+        model: string;
+        reasoningEffort?: string;
+    } | undefined;
+    /** Model context window in tokens, when known. */
+    getContextWindow(): number | undefined;
+    /** Git branch of the session cwd, when known. */
+    getBranch(): string | undefined;
+}
+export declare function fmtNum(n: number): string;
+export declare class PowerlineFooter implements Component {
+    private readonly source;
+    constructor(source: FooterDataSource);
+    invalidate(): void;
+    render(width: number): string[];
+}

package/lib/footer.js

@@ -0,0 +1,112 @@
+/**
+ * Powerline-style status footer, ported from pi-powerline-footer.
+ *
+ * Segments (left → right): fixed brand "dsh" · provider · model+thinking ·
+ * context usage · cache-hit rate · message count · tool count, then a
+ * right-aligned 24h clock. Segment backgrounds are the pi-powerline-footer
+ * palette; separators are U+E0B0 powerline arrows tinted by the neighbouring
+ * segment colours.
+ *
+ * Render cost is O(segments): every statistic is read from the bridge's
+ * incrementally maintained counters (never a session-log scan). The 1s clock
+ * tick only re-renders this component's single line.
+ */
+import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
+import { ansiBg, ansiFg, BOLD, POWERLINE, RESET } from "./theme/index.js";
+import { clipToWidth } from "./text.js";
+const ARROW_RIGHT = '\uE0B0';
+const WHITE = ansiFg('#FFFFFF');
+export function fmtNum(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1000)
+        return `${(n / 1000).toFixed(1)}k`;
+    return `${n}`;
+}
+function buildSegments(segs) {
+    if (segs.length === 0)
+        return '';
+    let out = '';
+    for (let i = 0; i < segs.length; i++) {
+        const s = segs[i];
+        out += `${ansiBg(s.bgHex)}${BOLD}${WHITE} ${s.label} `;
+        if (i + 1 < segs.length) {
+            out += `${ansiBg(segs[i + 1].bgHex)}${ansiFg(s.bgHex)}${ARROW_RIGHT}`;
+        }
+        else {
+            out += RESET + ansiFg(s.bgHex) + ARROW_RIGHT + RESET;
+        }
+    }
+    return out;
+}
+/** Thinking-level → segment background (pi-powerline-footer mapping). */
+function thinkingBg(level) {
+    const key = (level ?? 'off');
+    return POWERLINE.thinking[key] ?? POWERLINE.thinking.off;
+}
+function thinkingIcon(level) {
+    switch (level ?? 'off') {
+        case 'minimal': return '◔';
+        case 'low': return '◑';
+        case 'medium': return '◕';
+        case 'high': return '●';
+        case 'xhigh': return '◉';
+        case 'max': return '★';
+        default: return '○';
+    }
+}
+function contextBg(percent) {
+    if (percent >= 90)
+        return POWERLINE.contextDanger;
+    if (percent >= 70)
+        return POWERLINE.contextOrange;
+    if (percent >= 50)
+        return POWERLINE.contextWarn;
+    return POWERLINE.contextOk;
+}
+export class PowerlineFooter {
+    source;
+    constructor(source) {
+        this.source = source;
+    }
+    invalidate() { }
+    render(width) {
+        const stats = this.source.getStats();
+        const selection = this.source.getSelection();
+        const segs = [{ label: 'dsh', bgHex: POWERLINE.brand }];
+        if (selection !== undefined) {
+            segs.push({ label: `☁️ ${selection.provider}`, bgHex: POWERLINE.provider });
+            const model = clipToWidth(selection.model.split('/').pop(), 24);
+            const effort = selection.reasoningEffort ?? 'off';
+            segs.push({
+                label: `🤖 ${model} ${thinkingIcon(effort)} ${effort}`,
+                bgHex: thinkingBg(effort),
+            });
+        }
+        // Context usage: latest request's input tokens vs. the model's window.
+        const window = this.source.getContextWindow();
+        const used = stats.inputTokens;
+        if (window !== undefined && window > 0) {
+            const percent = (used / window) * 100;
+            segs.push({
+                label: `🧠 ${fmtNum(used)}/${fmtNum(window)}(${percent.toFixed(1)}%)`,
+                bgHex: contextBg(percent),
+            });
+        }
+        else {
+            segs.push({ label: `🧠 ${fmtNum(used)}`, bgHex: POWERLINE.contextOk });
+        }
+        if ((stats.cacheReadTokens > 0 || stats.cacheWriteTokens > 0) && stats.cacheHitRate !== undefined) {
+            segs.push({ label: `⚡ CH${stats.cacheHitRate.toFixed(1)}%`, bgHex: POWERLINE.cache });
+        }
+        segs.push({ label: `💬 ${stats.msgCount} msgs`, bgHex: POWERLINE.messages });
+        segs.push({ label: `🔧 ${stats.toolCallCount} tools`, bgHex: POWERLINE.tools });
+        const left = buildSegments(segs);
+        const leftWidth = visibleWidth(left);
+        const clock = new Date().toLocaleTimeString('en-GB', { hour12: false });
+        const clockWidth = visibleWidth(clock);
+        const pad = Math.max(1, width - leftWidth - clockWidth);
+        return [truncateToWidth(left + ' '.repeat(pad) + clock, width)];
+    }
+}
+//# sourceMappingURL=footer.js.map

package/lib/footer.js.map

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

package/lib/frame.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Framed overlay chrome — the shared full box (`┌─┐`) every pi SelectList /
+ * SettingsList overlay gets, so a popup reads as one bounded surface instead
+ * of panel rows floating directly on the chat canvas.
+ *
+ * Replaces pi agent's DynamicBorder (bare `─` lines) with a complete box:
+ * `┌───┐` top, `│   │` side-bordered content rows, `└───┘` bottom. Width
+ * passed to `showOverlay` is unchanged — the box is self-contained within it
+ * (child renders at width − 2).
+ *
+ * The frame also paints the panel backdrop: every row (borders, spacers, and
+ * each child line — including the raw separator/search rows pi's SettingsList
+ * pushes without any theme call) is laid on a full-width canvasSubtle
+ * background, so the popup reads as one solid rectangle instead of stripes
+ * of text-width highlight.
+ */
+import type { Component } from '@earendil-works/pi-tui';
+import { type TuiTheme } from './theme/index.ts';
+/**
+ * Full-box wrapper for one overlay component: `┌─┐` top border, `│`-bordered
+ * content rows, `└─┘` bottom border — each with a blank spacer row inside
+ * the box for breathing room, colored `palette.borderDefault` on the panel's
+ * canvasSubtle backdrop. Every row spans the full overlay width on that
+ * backdrop (see fillLine); the child renders at width − 2.
+ */
+export declare class FramedOverlay implements Component {
+    private readonly theme;
+    private readonly child;
+    constructor(theme: TuiTheme, child: Component);
+    invalidate(): void;
+    render(width: number): string[];
+    handleInput(data: string): void;
+}
+/** Build the framed wrapper for `child` (see FramedOverlay). */
+export declare function wrapFramedOverlay(theme: TuiTheme, child: Component): Component;