@sagmans/dsh-tui 0.1.0

package/lib/subagents.d.ts

@@ -0,0 +1,74 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** One delegation this session started, as the surface shows it. */
+export interface SubagentRun {
+    readonly runId: string;
+    readonly provider: string;
+    readonly id: string;
+    readonly startedAt: number;
+    readonly status: 'running' | 'completed' | 'failed';
+    readonly stopReason?: string;
+    readonly finishedAt?: number;
+}
+/** Child rows the dock lists before the count takes over. */
+export declare const DOCK_SUBAGENT_LIMIT = 2;
+/** Short form of a child session id: enough to tell two children apart. */
+export declare function shortId(id: string): string;
+/**
+ * Track the delegations of one session.
+ *
+ * Subagent lifecycle arrives as service events rather than durable session
+ * events, so this is live state: the durable record of a delegation is the tool
+ * call that asked for it, and a resumed run starts with an empty roster.
+ */
+export declare class SubagentRoster {
+    private readonly now;
+    private readonly runs;
+    constructor(now?: () => number);
+    /** Record a started run; an unknown shape is ignored rather than guessed at. */
+    start(info: unknown): void;
+    /** Settle a run; an end without its start still becomes a row. */
+    end(info: unknown): void;
+    list(): readonly SubagentRun[];
+    running(): readonly SubagentRun[];
+    reset(): void;
+}
+/** One delegation as a row. */
+export declare function describeSubagent(run: SubagentRun, now: number): string;
+/** The whole roster as lines. */
+export declare function describeSubagents(runs: readonly SubagentRun[], now: number): string;
+/** What a `/subagents` argument asks the surface to do. */
+export type SubagentsCommand = {
+    readonly kind: 'list';
+} | {
+    readonly kind: 'open';
+    readonly id: string;
+} | {
+    readonly kind: 'kill';
+    readonly id: string;
+} | {
+    readonly kind: 'invalid';
+    readonly reason: string;
+};
+/** Read a `/subagents` argument; the id is the only handle, so actions stay explicit. */
+export declare function parseSubagentsArgument(argument: string): SubagentsCommand;
+/** Names the most recent run, for a reader who just watched one start. */
+export declare const LAST_RUN = "last";
+/**
+ * Find one run by exact id or unambiguous prefix.
+ *
+ * Rows show a short id, so the reader types what they can see; an ambiguous
+ * prefix resolves to nothing rather than to the wrong child. \`last\` names the
+ * newest run, because copying a uuid out of a terminal is not a workflow.
+ */
+export declare function resolveRun(runs: readonly SubagentRun[], idOrPrefix: string): SubagentRun | undefined;
+/**
+ * Stop one live child.
+ *
+ * A delegation is an ordinary agent in the same process, so a stop is the same
+ * cancel a reader's Ctrl+C sends to the parent; a child that already settled is
+ * reported rather than pretended away.
+ */
+export declare function createSubagentControl(ctx: Context): {
+    stop(id: string): boolean;
+} | undefined;
+//# sourceMappingURL=subagents.d.ts.map

package/lib/subagents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../src/subagents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAA;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,IAAI,CAAA;AASpC,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;gBAEzB,GAAG,GAAE,MAAM,MAAyB;IAEjE,gFAAgF;IAChF,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAc1B,kEAAkE;IAClE,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAiBxB,IAAI,IAAI,SAAS,WAAW,EAAE;IAI9B,OAAO,IAAI,SAAS,WAAW,EAAE;IAIjC,KAAK,IAAI,IAAI;CAGd;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED,iCAAiC;AACjC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKnF;AAED,2DAA2D;AAC3D,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAKzD,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CASzE;AAED,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,SAAS,CAAA;AAE9B;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAapG;AAOD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,SAAS,CAW7F"}

package/lib/subagents.js

@@ -0,0 +1,141 @@
+import { describeDuration } from "./jobs.js";
+/** Child rows the dock lists before the count takes over. */
+export const DOCK_SUBAGENT_LIMIT = 2;
+/** Id characters kept in a row, so an id cannot smuggle in a control sequence. */
+const SHORT_ID_LENGTH = 8;
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+/** Short form of a child session id: enough to tell two children apart. */
+export function shortId(id) {
+    return id.length <= SHORT_ID_LENGTH ? id : id.slice(0, SHORT_ID_LENGTH);
+}
+/**
+ * Track the delegations of one session.
+ *
+ * Subagent lifecycle arrives as service events rather than durable session
+ * events, so this is live state: the durable record of a delegation is the tool
+ * call that asked for it, and a resumed run starts with an empty roster.
+ */
+export class SubagentRoster {
+    now;
+    runs = new Map();
+    constructor(now = () => Date.now()) {
+        this.now = now;
+    }
+    /** Record a started run; an unknown shape is ignored rather than guessed at. */
+    start(info) {
+        const record = asRecord(info);
+        const runId = record?.runId;
+        const id = record?.id;
+        if (typeof runId !== 'string' || typeof id !== 'string')
+            return;
+        this.runs.set(runId, {
+            runId,
+            id,
+            provider: typeof record?.provider === 'string' ? record.provider : 'subagent',
+            startedAt: this.now(),
+            status: 'running',
+        });
+    }
+    /** Settle a run; an end without its start still becomes a row. */
+    end(info) {
+        const record = asRecord(info);
+        const runId = record?.runId;
+        if (typeof runId !== 'string')
+            return;
+        const existing = this.runs.get(runId);
+        const stopReason = typeof record?.stopReason === 'string' ? record.stopReason : undefined;
+        this.runs.set(runId, {
+            runId,
+            id: typeof record?.id === 'string' ? record.id : existing?.id ?? runId,
+            provider: typeof record?.provider === 'string' ? record.provider : existing?.provider ?? 'subagent',
+            startedAt: existing?.startedAt ?? this.now(),
+            status: stopReason === undefined || stopReason === 'completed' ? 'completed' : 'failed',
+            ...(stopReason === undefined ? {} : { stopReason }),
+            finishedAt: this.now(),
+        });
+    }
+    list() {
+        return [...this.runs.values()].sort((left, right) => right.startedAt - left.startedAt);
+    }
+    running() {
+        return this.list().filter(run => run.status === 'running');
+    }
+    reset() {
+        this.runs.clear();
+    }
+}
+/** One delegation as a row. */
+export function describeSubagent(run, now) {
+    const age = run.status === 'running'
+        ? `running ${describeDuration(now - run.startedAt)}`
+        : `${run.status}${run.stopReason === undefined || run.stopReason === 'completed' ? '' : ` (${run.stopReason})`} ${describeDuration((run.finishedAt ?? run.startedAt) - run.startedAt)}`;
+    return `${shortId(run.id)} · ${run.provider} · ${age}`;
+}
+/** The whole roster as lines. */
+export function describeSubagents(runs, now) {
+    if (runs.length === 0)
+        return 'no subagents have run in this session';
+    const running = runs.filter(run => run.status === 'running').length;
+    const header = `subagents · ${runs.length}${running === 0 ? '' : ` (${running} running)`}`;
+    return [header, ...runs.map(run => `  ${describeSubagent(run, now)}`)].join('\n');
+}
+/** Actions a reader can name, so an unknown verb is refused instead of guessed at. */
+const ACTIONS = new Set(['open', 'kill']);
+/** Read a `/subagents` argument; the id is the only handle, so actions stay explicit. */
+export function parseSubagentsArgument(argument) {
+    const parts = argument.trim().split(/\s+/u).filter(part => part !== '');
+    if (parts.length === 0)
+        return { kind: 'list' };
+    const [verb = '', id = ''] = parts;
+    if (!ACTIONS.has(verb)) {
+        return { kind: 'invalid', reason: `unknown action "${verb}" — use /subagents, /subagents open <id>, or /subagents kill <id>` };
+    }
+    if (id === '')
+        return { kind: 'invalid', reason: `${verb} needs a child id; /subagents lists them` };
+    return verb === 'open' ? { kind: 'open', id } : { kind: 'kill', id };
+}
+/** Names the most recent run, for a reader who just watched one start. */
+export const LAST_RUN = 'last';
+/**
+ * Find one run by exact id or unambiguous prefix.
+ *
+ * Rows show a short id, so the reader types what they can see; an ambiguous
+ * prefix resolves to nothing rather than to the wrong child. \`last\` names the
+ * newest run, because copying a uuid out of a terminal is not a workflow.
+ */
+export function resolveRun(runs, idOrPrefix) {
+    // The roster happens to hand these over newest first; picking by time keeps
+    // the shortcut honest even if a caller ever hands them over differently.
+    if (idOrPrefix === LAST_RUN) {
+        return runs.reduce((newest, run) => newest === undefined || run.startedAt > newest.startedAt ? run : newest, undefined);
+    }
+    const exact = runs.find(run => run.id === idOrPrefix);
+    if (exact !== undefined)
+        return exact;
+    const matches = runs.filter(run => run.id.startsWith(idOrPrefix));
+    return matches.length === 1 ? matches[0] : undefined;
+}
+/**
+ * Stop one live child.
+ *
+ * A delegation is an ordinary agent in the same process, so a stop is the same
+ * cancel a reader's Ctrl+C sends to the parent; a child that already settled is
+ * reported rather than pretended away.
+ */
+export function createSubagentControl(ctx) {
+    const agents = ctx.get('agents');
+    if (typeof agents?.get !== 'function')
+        return undefined;
+    return {
+        stop: id => {
+            const child = agents.get?.(id);
+            if (child?.cancel === undefined)
+                return false;
+            child.cancel({ kind: 'user' });
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=subagents.js.map

package/lib/subagents.js.map

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

package/lib/terminal/bell.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The terminal bell.
+ *
+ * A bell is a courtesy for the turn the reader walked away from, and noise for
+ * every other one, so it is bound to how long the turn ran and can be turned
+ * off entirely.
+ */
+/** The terminal bell character. */
+export declare const BELL = "\u0007";
+/** How long a turn has to run before its end is worth a bell. */
+export declare const BELL_AFTER_MS = 10000;
+/** Whether this turn's end should ring. */
+export declare function shouldRingBell(input: {
+    readonly bell: boolean;
+    readonly ranForMs: number;
+    readonly exiting: boolean;
+}): boolean;
+//# sourceMappingURL=bell.d.ts.map

package/lib/terminal/bell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bell.d.ts","sourceRoot":"","sources":["../../src/terminal/bell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mCAAmC;AACnC,eAAO,MAAM,IAAI,WAAW,CAAA;AAE5B,iEAAiE;AACjE,eAAO,MAAM,aAAa,QAAS,CAAA;AAEnC,2CAA2C;AAC3C,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B,GAAG,OAAO,CAEV"}

package/lib/terminal/bell.js

@@ -0,0 +1,16 @@
+/**
+ * The terminal bell.
+ *
+ * A bell is a courtesy for the turn the reader walked away from, and noise for
+ * every other one, so it is bound to how long the turn ran and can be turned
+ * off entirely.
+ */
+/** The terminal bell character. */
+export const BELL = '\u0007';
+/** How long a turn has to run before its end is worth a bell. */
+export const BELL_AFTER_MS = 10_000;
+/** Whether this turn's end should ring. */
+export function shouldRingBell(input) {
+    return input.bell && !input.exiting && input.ranForMs >= BELL_AFTER_MS;
+}
+//# sourceMappingURL=bell.js.map

package/lib/terminal/bell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bell.js","sourceRoot":"","sources":["../../src/terminal/bell.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mCAAmC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAA;AAE5B,iEAAiE;AACjE,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAA;AAEnC,2CAA2C;AAC3C,MAAM,UAAU,cAAc,CAAC,KAI9B;IACC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,aAAa,CAAA;AACxE,CAAC"}

package/lib/terminal/clipboard.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Clipboard writes.
+ *
+ * OSC 52 is the only clipboard a terminal program has: it asks the terminal to
+ * put text on the reader's clipboard, and it works over SSH, where no local
+ * clipboard API exists. The payload is base64 by design, so no control
+ * character in the copied text can end the sequence early.
+ */
+/** The sequence that asks the terminal to copy `text`. */
+export declare function clipboardSequence(text: string): string;
+//# sourceMappingURL=clipboard.d.ts.map

package/lib/terminal/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/terminal/clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/lib/terminal/clipboard.js

@@ -0,0 +1,18 @@
+/**
+ * Clipboard writes.
+ *
+ * OSC 52 is the only clipboard a terminal program has: it asks the terminal to
+ * put text on the reader's clipboard, and it works over SSH, where no local
+ * clipboard API exists. The payload is base64 by design, so no control
+ * character in the copied text can end the sequence early.
+ */
+const OSC_INTRODUCER = '\u001b]';
+const STRING_TERMINATOR = '\u0007';
+const CLIPBOARD_CODE = '52';
+/** `c` selects the system clipboard, as opposed to the primary selection. */
+const CLIPBOARD_SELECTION = 'c';
+/** The sequence that asks the terminal to copy `text`. */
+export function clipboardSequence(text) {
+    return `${OSC_INTRODUCER}${CLIPBOARD_CODE};${CLIPBOARD_SELECTION};${Buffer.from(text, 'utf8').toString('base64')}${STRING_TERMINATOR}`;
+}
+//# sourceMappingURL=clipboard.js.map

package/lib/terminal/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../src/terminal/clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,cAAc,GAAG,SAAS,CAAA;AAChC,MAAM,iBAAiB,GAAG,QAAQ,CAAA;AAClC,MAAM,cAAc,GAAG,IAAI,CAAA;AAC3B,6EAA6E;AAC7E,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAE/B,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,GAAG,cAAc,GAAG,cAAc,IAAI,mBAAmB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,iBAAiB,EAAE,CAAA;AACxI,CAAC"}

package/lib/terminal/restore.d.ts

@@ -0,0 +1,17 @@
+/** One reversible terminal mutation. */
+export type RestoreHook = () => void;
+/** Registry that guarantees every registered hook runs exactly once. */
+export interface RestoreRegistry {
+    add(hook: RestoreHook): () => void;
+    restore(): void;
+    readonly size: number;
+}
+/**
+ * Collect the terminal-release hooks for one surface.
+ *
+ * Restoring the terminal is the one thing that must happen even when boot
+ * fails halfway, so hooks run in reverse registration order, each isolated:
+ * a throwing hook must not strand the ones registered before it.
+ */
+export declare function createRestoreRegistry(): RestoreRegistry;
+//# sourceMappingURL=restore.d.ts.map

package/lib/terminal/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../src/terminal/restore.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAA;AAEpC,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,IAAI,CAAA;IAClC,OAAO,IAAI,IAAI,CAAA;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAgCvD"}

package/lib/terminal/restore.js

@@ -0,0 +1,43 @@
+/**
+ * Collect the terminal-release hooks for one surface.
+ *
+ * Restoring the terminal is the one thing that must happen even when boot
+ * fails halfway, so hooks run in reverse registration order, each isolated:
+ * a throwing hook must not strand the ones registered before it.
+ */
+export function createRestoreRegistry() {
+    const hooks = [];
+    let restored = false;
+    return {
+        add(hook) {
+            if (restored) {
+                // Registering after release means the owner is already gone; run it now
+                // rather than silently keeping a mutation the terminal never reclaims.
+                hook();
+                return () => { };
+            }
+            hooks.push(hook);
+            return () => {
+                const index = hooks.indexOf(hook);
+                if (index >= 0)
+                    hooks.splice(index, 1);
+            };
+        },
+        restore() {
+            restored = true;
+            while (hooks.length > 0) {
+                const hook = hooks.pop();
+                try {
+                    hook?.();
+                }
+                catch {
+                    // A failing hook must not prevent the remaining ones from running.
+                }
+            }
+        },
+        get size() {
+            return hooks.length;
+        },
+    };
+}
+//# sourceMappingURL=restore.js.map

package/lib/terminal/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../src/terminal/restore.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,OAAO;QACL,GAAG,CAAC,IAAI;YACN,IAAI,QAAQ,EAAE,CAAC;gBACb,wEAAwE;gBACxE,uEAAuE;gBACvE,IAAI,EAAE,CAAA;gBACN,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;YACjB,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAChB,OAAO,GAAG,EAAE;gBACV,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBACjC,IAAI,KAAK,IAAI,CAAC;oBAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;YACxC,CAAC,CAAA;QACH,CAAC;QACD,OAAO;YACL,QAAQ,GAAG,IAAI,CAAA;YACf,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;gBACxB,IAAI,CAAC;oBACH,IAAI,EAAE,EAAE,CAAA;gBACV,CAAC;gBAAC,MAAM,CAAC;oBACP,mEAAmE;gBACrE,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,IAAI;YACN,OAAO,KAAK,CAAC,MAAM,CAAA;QACrB,CAAC;KACF,CAAA;AACH,CAAC"}

package/lib/terminal/title.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Terminal title.
+ *
+ * The window title is the one piece of terminal state a reader sees while the
+ * surface is not on screen — in a tab bar, a window list, or a multiplexer — so
+ * it says what this session is and whether it is working.
+ */
+/** How much of a directory name the title keeps. */
+export declare const TITLE_DIR_LIMIT = 40;
+/**
+ * Build the title sequence.
+ *
+ * Anything a terminal would read as the end of the title is removed rather than
+ * escaped: this is a window label, and a hostile directory name has no business
+ * reaching the terminal as a control character.
+ */
+export declare function titleSequence(title: string): string;
+/** The window title for a session, in the terms a tab bar can show. */
+export declare function windowTitle(cwd: string, activity: 'ready' | 'working'): string;
+/** Hand the title back: the shell sets its own on the next prompt. */
+export declare const CLEAR_TITLE: string;
+//# sourceMappingURL=title.d.ts.map

package/lib/terminal/title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../src/terminal/title.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,oDAAoD;AACpD,eAAO,MAAM,eAAe,KAAK,CAAA;AAEjC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAK9E;AAED,sEAAsE;AACtE,eAAO,MAAM,WAAW,QAAoB,CAAA"}

package/lib/terminal/title.js

@@ -0,0 +1,34 @@
+/**
+ * Terminal title.
+ *
+ * The window title is the one piece of terminal state a reader sees while the
+ * surface is not on screen — in a tab bar, a window list, or a multiplexer — so
+ * it says what this session is and whether it is working.
+ */
+const OSC_INTRODUCER = '\u001b]';
+const STRING_TERMINATOR = '\u0007';
+const TITLE_CODE = '0';
+/** Characters that would end the sequence early and let the rest execute. */
+const UNSAFE = /[\u0000-\u001f\u007f]/gu;
+/** How much of a directory name the title keeps. */
+export const TITLE_DIR_LIMIT = 40;
+/**
+ * Build the title sequence.
+ *
+ * Anything a terminal would read as the end of the title is removed rather than
+ * escaped: this is a window label, and a hostile directory name has no business
+ * reaching the terminal as a control character.
+ */
+export function titleSequence(title) {
+    return `${OSC_INTRODUCER}${TITLE_CODE};${title.replace(UNSAFE, '')}${STRING_TERMINATOR}`;
+}
+/** The window title for a session, in the terms a tab bar can show. */
+export function windowTitle(cwd, activity) {
+    const segments = cwd.split('/').filter(segment => segment !== '');
+    const tail = segments.slice(-2).join('/');
+    const cut = tail.length > TITLE_DIR_LIMIT ? `…${tail.slice(-(TITLE_DIR_LIMIT - 1))}` : tail;
+    return titleSequence(`dsh-tui · ${cut === '' ? cwd : cut} · ${activity}`);
+}
+/** Hand the title back: the shell sets its own on the next prompt. */
+export const CLEAR_TITLE = titleSequence('');
+//# sourceMappingURL=title.js.map

package/lib/terminal/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../../src/terminal/title.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,cAAc,GAAG,SAAS,CAAA;AAChC,MAAM,iBAAiB,GAAG,QAAQ,CAAA;AAClC,MAAM,UAAU,GAAG,GAAG,CAAA;AAEtB,6EAA6E;AAC7E,MAAM,MAAM,GAAG,yBAAyB,CAAA;AAExC,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAA;AAEjC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,GAAG,cAAc,GAAG,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,iBAAiB,EAAE,CAAA;AAC1F,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,QAA6B;IACpE,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC,CAAA;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3F,OAAO,aAAa,CAAC,aAAa,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,QAAQ,EAAE,CAAC,CAAA;AAC3E,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC,EAAE,CAAC,CAAA"}

package/lib/text.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Make untrusted text safe to hand to a terminal.
+ *
+ * Model output, tool output, and file content all reach the screen, and a
+ * terminal executes the escape sequences it is given: a crafted result could
+ * repaint the frame, retitle the window, or write the clipboard. Escaping here,
+ * at the one boundary every rendered fragment crosses, means no component has
+ * to remember to do it.
+ */
+/**
+ * Render control characters as visible escapes, keeping line feeds.
+ *
+ * A line feed is the only control a renderer already understands; everything
+ * else becomes text so the reader can see that it was there instead of the
+ * terminal acting on it. Tabs are escaped too: a tab advances the cursor by a
+ * stop the layout cannot predict, which would desynchronize wrapping.
+ */
+export declare function displayText(raw: string): string;
+//# sourceMappingURL=text.d.ts.map

package/lib/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAwBH;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAwB/C"}

package/lib/text.js

@@ -0,0 +1,61 @@
+/**
+ * Make untrusted text safe to hand to a terminal.
+ *
+ * Model output, tool output, and file content all reach the screen, and a
+ * terminal executes the escape sequences it is given: a crafted result could
+ * repaint the frame, retitle the window, or write the clipboard. Escaping here,
+ * at the one boundary every rendered fragment crosses, means no component has
+ * to remember to do it.
+ */
+const LINE_FEED = 0x0a;
+const LAST_C0 = 0x1f;
+const DELETE = 0x7f;
+const FIRST_C1 = 0x80;
+const LAST_C1 = 0x9f;
+const FIRST_SURROGATE = 0xd800;
+const LAST_SURROGATE = 0xdfff;
+const REPLACEMENT = '\uFFFD';
+const C0_PREFIX = '\\x';
+const UNICODE_PREFIX = '\\u';
+/** Directional overrides and isolates can reorder the frame around a payload. */
+const BIDI_CONTROLS = new Set([0x202a, 0x202b, 0x202c, 0x202d, 0x202e, 0x2066, 0x2067, 0x2068, 0x2069]);
+/** Separators that end a line without a line feed. */
+const LINE_SEPARATOR = 0x2028;
+const PARAGRAPH_SEPARATOR = 0x2029;
+function escapeCode(prefix, code, digits) {
+    return prefix + code.toString(16).toUpperCase().padStart(digits, '0');
+}
+/**
+ * Render control characters as visible escapes, keeping line feeds.
+ *
+ * A line feed is the only control a renderer already understands; everything
+ * else becomes text so the reader can see that it was there instead of the
+ * terminal acting on it. Tabs are escaped too: a tab advances the cursor by a
+ * stop the layout cannot predict, which would desynchronize wrapping.
+ */
+export function displayText(raw) {
+    let out = '';
+    for (const character of raw) {
+        const code = character.codePointAt(0) ?? 0;
+        if (code === LINE_FEED) {
+            out += character;
+            continue;
+        }
+        if (code <= LAST_C0 || code === DELETE || (code >= FIRST_C1 && code <= LAST_C1)) {
+            out += escapeCode(C0_PREFIX, code, 2);
+            continue;
+        }
+        // A code point in this range is an unpaired half, which no terminal font has.
+        if (code >= FIRST_SURROGATE && code <= LAST_SURROGATE) {
+            out += REPLACEMENT;
+            continue;
+        }
+        if (BIDI_CONTROLS.has(code) || code === LINE_SEPARATOR || code === PARAGRAPH_SEPARATOR) {
+            out += escapeCode(UNICODE_PREFIX, code, 4);
+            continue;
+        }
+        out += character;
+    }
+    return out;
+}
+//# sourceMappingURL=text.js.map

package/lib/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,SAAS,GAAG,IAAI,CAAA;AACtB,MAAM,OAAO,GAAG,IAAI,CAAA;AACpB,MAAM,MAAM,GAAG,IAAI,CAAA;AACnB,MAAM,QAAQ,GAAG,IAAI,CAAA;AACrB,MAAM,OAAO,GAAG,IAAI,CAAA;AACpB,MAAM,eAAe,GAAG,MAAM,CAAA;AAC9B,MAAM,cAAc,GAAG,MAAM,CAAA;AAC7B,MAAM,WAAW,GAAG,QAAQ,CAAA;AAC5B,MAAM,SAAS,GAAG,KAAK,CAAA;AACvB,MAAM,cAAc,GAAG,KAAK,CAAA;AAE5B,iFAAiF;AACjF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAEvG,sDAAsD;AACtD,MAAM,cAAc,GAAG,MAAM,CAAA;AAC7B,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAElC,SAAS,UAAU,CAAC,MAAc,EAAE,IAAY,EAAE,MAAc;IAC9D,OAAO,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,MAAM,SAAS,IAAI,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC1C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,GAAG,IAAI,SAAS,CAAA;YAChB,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,IAAI,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,EAAE,CAAC;YAChF,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;YACrC,SAAQ;QACV,CAAC;QACD,8EAA8E;QAC9E,IAAI,IAAI,IAAI,eAAe,IAAI,IAAI,IAAI,cAAc,EAAE,CAAC;YACtD,GAAG,IAAI,WAAW,CAAA;YAClB,SAAQ;QACV,CAAC;QACD,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACvF,GAAG,IAAI,UAAU,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;YAC1C,SAAQ;QACV,CAAC;QACD,GAAG,IAAI,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/lib/theme.d.ts

@@ -0,0 +1,47 @@
+import type { EditorTheme, MarkdownTheme } from '@earendil-works/pi-tui';
+/** Glyph that introduces each transcript row kind. */
+export interface TranscriptGlyphs {
+    readonly user: string;
+    readonly assistant: string;
+    readonly tool: string;
+    readonly notice: string;
+    readonly reasoning: string;
+    readonly marker: string;
+}
+/** Styling the surface applies, and the editor/select themes pi-tui needs. */
+export interface TuiTheme {
+    readonly color: boolean;
+    readonly glyphs: TranscriptGlyphs;
+    dim(text: string): string;
+    bold(text: string): string;
+    tool(text: string): string;
+    notice(text: string): string;
+    /** Diff additions and removals, colored by background rather than by hue alone. */
+    added(text: string): string;
+    removed(text: string): string;
+    /** A boundary in the conversation rather than something anyone said. */
+    marker(text: string): string;
+    /** Structure the reader scans for: headings, links, inline code, list bullets. */
+    accent(text: string): string;
+    italic(text: string): string;
+    readonly editor: EditorTheme;
+    readonly markdown: MarkdownTheme;
+}
+/**
+ * Whether styling is on, given the launch flag and the environment.
+ *
+ * `NO_COLOR` is a cross-tool convention (no-color.org): when it is present and
+ * not empty, a program that colors by default must not, regardless of its own
+ * flags. Honouring it means one environment variable turns styling off for
+ * every tool in a session, which is how a reader actually wants it to work.
+ */
+export declare function colorEnabled(requested: boolean, env?: Record<string, string | undefined>): boolean;
+/**
+ * Build the surface theme.
+ *
+ * Styling uses the standard 16 ANSI colors and terminal defaults rather than
+ * true-color values, so a light or dark terminal remaps the interface on its
+ * own and the surface needs no theme setting.
+ */
+export declare function createTheme(color: boolean): TuiTheme;
+//# sourceMappingURL=theme.d.ts.map

package/lib/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAmB,MAAM,wBAAwB,CAAA;AAQzF,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,mFAAmF;IACnF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC3B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC7B,wEAAwE;IACxE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,kFAAkF;IAClF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CACjC;AA6CD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,OAAO,CAG/G;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAyBpD"}