@sagmans/dsh-tui 0.6.0 → 0.8.0

package/lib/subagents.d.ts

@@ -4,26 +4,30 @@ export interface SubagentRun {
     readonly runId: string;
     readonly provider: string;
     readonly id: string;
+    readonly label?: 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;
+export declare const DOCK_SUBAGENT_LIMIT = 3;
 /** 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.
+ * events, while the parent's catalog supplies the task. This roster remains
+ * live state, so a resumed run starts empty even when its catalog is durable.
  */
 export declare class SubagentRoster {
     private readonly now;
     private readonly runs;
+    private readonly labels;
     constructor(now?: () => number);
+    /** Catalog entries precede starts normally; keep them for either event order. */
+    catalog(info: unknown): void;
     /** 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. */

package/lib/subagents.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"subagents.d.ts","sourceRoot":"","sources":["../src/subagents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,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,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,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;AAYpC,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHhC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEtB,GAAG,GAAE,MAAM,MAAyB;IAEjE,iFAAiF;IACjF,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAa5B,gFAAgF;IAChF,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAgB1B,kEAAkE;IAClE,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAkBxB,IAAI,IAAI,SAAS,WAAW,EAAE;IAI9B,OAAO,IAAI,SAAS,WAAW,EAAE;IAIjC,KAAK,IAAI,IAAI;CAId;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

@@ -1,8 +1,11 @@
 import { describeDuration } from "./jobs.js";
+import { stripControlCharacters } from "./text.js";
 /** Child rows the dock lists before the count takes over. */
-export const DOCK_SUBAGENT_LIMIT = 2;
+export const DOCK_SUBAGENT_LIMIT = 3;
 /** Id characters kept in a row, so an id cannot smuggle in a control sequence. */
 const SHORT_ID_LENGTH = 8;
+/** Maximum task words the dock can show without hiding child status. */
+const MAX_TASK_WORDS = 10;
 function asRecord(value) {
     return typeof value === 'object' && value !== null ? value : undefined;
 }
@@ -14,15 +17,32 @@ export function shortId(id) {
  * 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.
+ * events, while the parent's catalog supplies the task. This roster remains
+ * live state, so a resumed run starts empty even when its catalog is durable.
  */
 export class SubagentRoster {
     now;
     runs = new Map();
+    labels = new Map();
     constructor(now = () => Date.now()) {
         this.now = now;
     }
+    /** Catalog entries precede starts normally; keep them for either event order. */
+    catalog(info) {
+        const record = asRecord(info);
+        const id = record?.childId;
+        const raw = record?.label;
+        if (typeof id !== 'string' || typeof raw !== 'string')
+            return;
+        const label = stripControlCharacters(raw).trim().replace(/\s+/gu, ' ').split(' ').slice(0, MAX_TASK_WORDS).join(' ');
+        if (label === '')
+            return;
+        this.labels.set(id, label);
+        for (const [runId, run] of this.runs) {
+            if (run.id === id)
+                this.runs.set(runId, { ...run, label });
+        }
+    }
     /** Record a started run; an unknown shape is ignored rather than guessed at. */
     start(info) {
         const record = asRecord(info);
@@ -30,9 +50,11 @@ export class SubagentRoster {
         const id = record?.id;
         if (typeof runId !== 'string' || typeof id !== 'string')
             return;
+        const label = this.labels.get(id);
         this.runs.set(runId, {
             runId,
             id,
+            ...(label === undefined ? {} : { label }),
             provider: typeof record?.provider === 'string' ? record.provider : 'subagent',
             startedAt: this.now(),
             status: 'running',
@@ -49,6 +71,7 @@ export class SubagentRoster {
         this.runs.set(runId, {
             runId,
             id: typeof record?.id === 'string' ? record.id : existing?.id ?? runId,
+            ...(existing?.label === undefined ? {} : { label: existing.label }),
             provider: typeof record?.provider === 'string' ? record.provider : existing?.provider ?? 'subagent',
             startedAt: existing?.startedAt ?? this.now(),
             status: stopReason === undefined || stopReason === 'completed' ? 'completed' : 'failed',
@@ -64,6 +87,7 @@ export class SubagentRoster {
     }
     reset() {
         this.runs.clear();
+        this.labels.clear();
     }
 }
 /** One delegation as a row. */
@@ -71,7 +95,7 @@ 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}`;
+    return `${shortId(run.id)}${run.label === undefined ? '' : ` · ${run.label}`} · ${run.provider} · ${age}`;
 }
 /** The whole roster as lines. */
 export function describeSubagents(runs, now) {

package/lib/subagents.js.map

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

package/lib/surface/appearance-preferences.d.ts

@@ -0,0 +1,26 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type TuiSettings } from '../theme-settings.ts';
+/** The painter keeps applied state; this owner only coordinates its durable preference source. */
+export interface AppearancePreferencePorts {
+    readonly rowSettings: () => unknown;
+    readonly rowSettingsLive: boolean;
+    readonly applied: () => TuiSettings | undefined;
+    readonly apply: () => void;
+    readonly restyle: () => void;
+    readonly restorePreview: () => void;
+    readonly disableHistory: () => void;
+    readonly notice: (message: string) => void;
+    readonly problem: (message: string) => void;
+}
+/** Preference ownership stays independent of theme files, rendering, and picker state. */
+export interface AppearancePreferences {
+    readonly read: () => TuiSettings;
+    readonly configBacked: () => boolean;
+    readonly chooseTheme: (name: string) => void;
+    readonly allowsHistory: (field: 'enabled' | 'ghost', applied: boolean) => boolean;
+    readonly register: () => void;
+    readonly listen: () => () => void;
+}
+/** Keep attachment, persistence, and notifications on the same checked settings source. */
+export declare function createAppearancePreferences(ctx: Context, ports: AppearancePreferencePorts): AppearancePreferences;
+//# sourceMappingURL=appearance-preferences.d.ts.map

package/lib/surface/appearance-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance-preferences.d.ts","sourceRoot":"","sources":["../../src/surface/appearance-preferences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAgF,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIrI,kGAAkG;AAClG,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAA;IACnC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAA;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5C;AAED,0FAA0F;AAC1F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,WAAW,CAAA;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAA;IACpC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAA;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,IAAI,CAAA;CAClC;AAED,2FAA2F;AAC3F,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,yBAAyB,GAAG,qBAAqB,CA4HjH"}

package/lib/surface/appearance-preferences.js

@@ -0,0 +1,139 @@
+import { openSection } from "../compat/section.js";
+import { asRecord } from "../theme-schema.js";
+import { TUI_SETTINGS_NAMESPACE, TuiSettingsSchema, readScope, settingsProblemMessage } from "../theme-settings.js";
+const WRITE_UNSUPPORTED = 'the settings service cannot write the section; the patch was not applied';
+/** Keep attachment, persistence, and notifications on the same checked settings source. */
+export function createAppearancePreferences(ctx, ports) {
+    let configBacked = false;
+    let activeScope;
+    let privacyRevision;
+    let hadUser = false;
+    let blocked = { enabled: false, ghost: false };
+    const observePrivacy = () => {
+        try {
+            const user = activeScope?.readUser();
+            if (user === undefined)
+                return;
+            if (user.revision !== privacyRevision) {
+                privacyRevision = user.revision;
+                hadUser = false;
+                blocked = { enabled: false, ghost: false };
+            }
+            // An invalid root is omitted by describe(); valid removal advances the revision.
+            if (user.value === undefined && hadUser)
+                blocked = { enabled: true, ghost: true };
+            hadUser ||= user.value !== undefined;
+            const section = asRecord(user.value);
+            const history = asRecord(section?.history);
+            if ((user.value !== undefined && section === undefined) || (section?.history !== undefined && history === undefined)) {
+                blocked = { enabled: true, ghost: true };
+            }
+            else {
+                if (history?.enabled !== undefined && history.enabled !== true)
+                    blocked.enabled = true;
+                if (history?.ghost !== undefined && history.ghost !== true)
+                    blocked.ghost = true;
+            }
+        }
+        catch {
+            blocked = { enabled: true, ghost: true };
+        }
+    };
+    let readSection = () => {
+        const row = readScope({ get: ports.rowSettings }, ports.problem);
+        // Until a supported owner can read preferences, absence cannot authorize recording.
+        return { ...row, history: { ...row.history, enabled: false, ghost: false } };
+    };
+    let chooseTheme = (_name) => {
+        ports.restorePreview();
+        ports.problem(WRITE_UNSUPPORTED);
+    };
+    // Profile settings address local row IDs, not the Loader's qualified entry paths.
+    const configNamespace = ctx.fiber.entry?.options.id;
+    const register = () => {
+        // Row appearance must exist before prompt memory, even when Cordis defers attachment.
+        ports.apply();
+        ctx.inject(['settings'], settingsCtx => {
+            let scope;
+            try {
+                scope = openSection(settingsCtx.settings, {
+                    owner: settingsCtx,
+                    ns: TUI_SETTINGS_NAMESPACE,
+                    schema: TuiSettingsSchema,
+                    entry: ports.rowSettings(),
+                    config: { ns: configNamespace, get: ports.rowSettings, live: ports.rowSettingsLive },
+                    onChange: () => {
+                        ports.apply();
+                        ports.restyle();
+                    },
+                });
+            }
+            catch (error) {
+                ports.disableHistory();
+                ports.problem(settingsProblemMessage(error) + ' · prompt history stays off until the section parses');
+                return;
+            }
+            activeScope = scope;
+            privacyRevision = undefined;
+            hadUser = false;
+            blocked = { enabled: false, ghost: false };
+            configBacked = scope.kind === 'config';
+            readSection = () => readScope({ get: () => {
+                    const raw = scope.get();
+                    if (scope.kind !== 'config')
+                        return raw;
+                    const record = asRecord(raw);
+                    if (record === undefined)
+                        return raw;
+                    const history = asRecord(record.history);
+                    // Legacy import follows Loader activation. Missing switches cannot opt in first.
+                    if (record.history !== undefined && history === undefined)
+                        return raw;
+                    return { ...record, history: {
+                            ...history,
+                            enabled: history?.enabled === undefined ? false : history.enabled,
+                            ghost: history?.ghost === undefined ? false : history.ghost,
+                        } };
+                } }, ports.problem, ports.applied());
+            chooseTheme = name => {
+                void scope.update({ theme: name }).then(() => {
+                    ports.apply();
+                    ports.restyle();
+                    ports.notice(`theme · ${name} · written to the settings document`);
+                }, (error) => {
+                    ports.restorePreview();
+                    ports.problem(settingsProblemMessage(error));
+                });
+            };
+            ports.apply();
+        });
+    };
+    const listen = () => {
+        const changed = (ns) => {
+            if (String(ns) !== TUI_SETTINGS_NAMESPACE && String(ns) !== configNamespace)
+                return;
+            ports.apply();
+            ports.restyle();
+        };
+        const section = ctx.on('settings/updated', changed);
+        const config = ctx.on('settings/document-updated', changed);
+        return () => { section(); config(); };
+    };
+    return {
+        read: () => {
+            const section = readSection();
+            // Attachment and commits must establish raw-layer presence before the first history use.
+            observePrivacy();
+            return section;
+        },
+        configBacked: () => configBacked,
+        chooseTheme: name => chooseTheme(name),
+        allowsHistory: (field, applied) => {
+            observePrivacy();
+            return applied && !blocked[field];
+        },
+        register,
+        listen,
+    };
+}
+//# sourceMappingURL=appearance-preferences.js.map

package/lib/surface/appearance-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appearance-preferences.js","sourceRoot":"","sources":["../../src/surface/appearance-preferences.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAqB,MAAM,sBAAsB,CAAA;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,SAAS,EAAE,sBAAsB,EAAoB,MAAM,sBAAsB,CAAA;AAErI,MAAM,iBAAiB,GAAG,0EAA0E,CAAA;AAyBpG,2FAA2F;AAC3F,MAAM,UAAU,2BAA2B,CAAC,GAAY,EAAE,KAAgC;IACxF,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,IAAI,WAAqC,CAAA;IACzC,IAAI,eAAmC,CAAA;IACvC,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,OAAO,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;IAC9C,MAAM,cAAc,GAAG,GAAS,EAAE;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,WAAW,EAAE,QAAQ,EAAE,CAAA;YACpC,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAM;YAC9B,IAAI,IAAI,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;gBACtC,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAA;gBAC/B,OAAO,GAAG,KAAK,CAAA;gBACf,OAAO,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;YAC5C,CAAC;YACD,iFAAiF;YACjF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO;gBAAE,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;YACjF,OAAO,KAAK,IAAI,CAAC,KAAK,KAAK,SAAS,CAAA;YACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YAC1C,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,CAAC,EAAE,CAAC;gBACrH,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;YAC1C,CAAC;iBAAM,CAAC;gBACN,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;oBAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAA;gBACtF,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI;oBAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAA;YAClF,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;QAC1C,CAAC;IACH,CAAC,CAAA;IACD,IAAI,WAAW,GAAG,GAAgB,EAAE;QAClC,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;QAChE,oFAAoF;QACpF,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAA;IAC9E,CAAC,CAAA;IACD,IAAI,WAAW,GAAG,CAAC,KAAa,EAAQ,EAAE;QACxC,KAAK,CAAC,cAAc,EAAE,CAAA;QACtB,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAClC,CAAC,CAAA;IACD,kFAAkF;IAClF,MAAM,eAAe,GAAI,GAAG,CAAC,KAAkD,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAA;IACjG,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,sFAAsF;QACtF,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,GAAG,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,EAAE;YACrC,IAAI,KAAmB,CAAA;YACvB,IAAI,CAAC;gBACH,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,QAAQ,EAAE;oBACxC,KAAK,EAAE,WAAW;oBAClB,EAAE,EAAE,sBAAsB;oBAC1B,MAAM,EAAE,iBAAiB;oBACzB,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE;oBAC1B,MAAM,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,eAAe,EAAE;oBACpF,QAAQ,EAAE,GAAG,EAAE;wBACb,KAAK,CAAC,KAAK,EAAE,CAAA;wBACb,KAAK,CAAC,OAAO,EAAE,CAAA;oBACjB,CAAC;iBACF,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC,cAAc,EAAE,CAAA;gBACtB,KAAK,CAAC,OAAO,CAAC,sBAAsB,CAAC,KAAK,CAAC,GAAG,sDAAsD,CAAC,CAAA;gBACrG,OAAM;YACR,CAAC;YACD,WAAW,GAAG,KAAK,CAAA;YACnB,eAAe,GAAG,SAAS,CAAA;YAC3B,OAAO,GAAG,KAAK,CAAA;YACf,OAAO,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;YAC1C,YAAY,GAAG,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAA;YACtC,WAAW,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE;oBACxC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;oBACvB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;wBAAE,OAAO,GAAG,CAAA;oBACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;oBAC5B,IAAI,MAAM,KAAK,SAAS;wBAAE,OAAO,GAAG,CAAA;oBACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;oBACxC,iFAAiF;oBACjF,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;wBAAE,OAAO,GAAG,CAAA;oBACrE,OAAO,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE;4BAC3B,GAAG,OAAO;4BACV,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;4BACjE,KAAK,EAAE,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK;yBAC5D,EAAE,CAAA;gBACL,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YACpC,WAAW,GAAG,IAAI,CAAC,EAAE;gBACnB,KAAK,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACrC,GAAG,EAAE;oBACH,KAAK,CAAC,KAAK,EAAE,CAAA;oBACb,KAAK,CAAC,OAAO,EAAE,CAAA;oBACf,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,qCAAqC,CAAC,CAAA;gBACpE,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;oBACjB,KAAK,CAAC,cAAc,EAAE,CAAA;oBACtB,KAAK,CAAC,OAAO,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAA;gBAC9C,CAAC,CACF,CAAA;YACH,CAAC,CAAA;YACD,KAAK,CAAC,KAAK,EAAE,CAAA;QACf,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,GAAiB,EAAE;QAChC,MAAM,OAAO,GAAG,CAAC,EAAW,EAAQ,EAAE;YACpC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,sBAAsB,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,eAAe;gBAAE,OAAM;YACnF,KAAK,CAAC,KAAK,EAAE,CAAA;YACb,KAAK,CAAC,OAAO,EAAE,CAAA;QACjB,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAA;QAC3D,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA,CAAC,CAAC,CAAA;IACtC,CAAC,CAAA;IACD,OAAO;QACL,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA;YAC7B,yFAAyF;YACzF,cAAc,EAAE,CAAA;YAChB,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,YAAY,EAAE,GAAG,EAAE,CAAC,YAAY;QAChC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;QACtC,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAChC,cAAc,EAAE,CAAA;YAChB,OAAO,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACnC,CAAC;QACD,QAAQ;QACR,MAAM;KACP,CAAA;AACH,CAAC"}

package/lib/surface/appearance.d.ts

@@ -0,0 +1,87 @@
+import type { KeyId } from '@earendil-works/pi-tui';
+import type { Context } from '@deepseek-ai/cordis';
+import { type Keymap } from '../input/actions.ts';
+import { type NoticeSink } from '../settings-notice.ts';
+import { type TuiTheme } from '../theme.ts';
+import { type MermaidMode } from '../theme-settings.ts';
+import type { ToolDisplayTable } from '../tool-display.ts';
+import { type ViewState } from '../ui/view.ts';
+import type { Picker } from './modal-input.ts';
+import type { PromptInput } from './prompt-input.ts';
+/**
+ * What the appearance owner needs from the surface that composes it.
+ *
+ * The sinks are ports because the caches they clear belong to the markdown view and
+ * the transcript view. The keyboard is a reader because the settings scope applies
+ * before the prompt bar's own owner exists, and the chord an edit has to end is
+ * armed at that moment.
+ */
+export interface AppearancePorts {
+    /** Whether colour was asked for at launch; the flag outranks anything configured. */
+    readonly color: () => boolean;
+    /**
+     * The theme the row's own configuration pins, or nothing when it pins none.
+     *
+     * Read from the row rather than taken from the section, because a harness that
+     * keeps configuration per row has no `dsh-tui:` section to write a name into:
+     * the row is then the only layer a profile patch can carry a theme in.
+     */
+    readonly rowTheme: string | undefined;
+    /** Keep source Config references live rather than capturing their startup values. */
+    readonly rowSettings: () => unknown;
+    /** Source Loader can apply live edits only when its schema runtime created native references. */
+    readonly rowSettingsLive: boolean;
+    readonly notice: (message: string) => void;
+    readonly render: () => void;
+    readonly invalidateMarkdown: () => void;
+    readonly invalidateView: () => void;
+    /** The keys an edit re-installs, and the chord it has to end. */
+    readonly keybindings: () => Pick<PromptInput, 'installBindings' | 'disarmChord'>;
+    /** Run a list the surface answers for; the modal owner drives every gate and picker. */
+    readonly openPicker: (picker: Picker) => Promise<string | undefined>;
+}
+/**
+ * The surface's appearance, rebuilt whenever the reader's settings change.
+ *
+ * Renderers hold this object for the life of the session, so the current theme
+ * is swapped *behind* a stable delegate rather than reassigned: every row then
+ * reads one whole table, and a repaint can never observe a half-applied one.
+ * `--no-color` still outranks anything configured.
+ */
+export interface Appearance {
+    readonly theme: TuiTheme;
+    /** The folds the transcript is drawn with, and the keys that flip them. */
+    readonly viewState: () => ViewState;
+    readonly toggleCards: () => void;
+    readonly toggleSubCalls: () => void;
+    readonly toggleReasoning: () => void;
+    readonly mermaidMode: () => MermaidMode;
+    readonly toolDisplay: () => ToolDisplayTable;
+    readonly keymap: () => Keymap;
+    readonly prefixKeys: () => readonly KeyId[];
+    readonly prefixWindowMs: () => number;
+    /** Whether prompts are recorded and offered, and the cap on how many. */
+    readonly historyEnabled: () => boolean;
+    readonly historyGhost: () => boolean;
+    readonly historyMaxEntries: () => number;
+    /** Print whatever the settings scope held back, where the reader can read it. */
+    readonly openNotices: (sink: NoticeSink) => void;
+    readonly registerSection: () => void;
+    readonly createThemesHome: () => void;
+    /** Register the settings listener; the answer takes it back off. */
+    readonly settingsListener: () => () => void;
+    /** Watch the reader's own themes; the answer stops the watch. */
+    readonly watchThemes: () => () => void;
+    /** Carry out one `theme` command line. */
+    readonly runThemeCommand: (argument: string) => void;
+}
+/**
+ * The reader's appearance and display preferences, and the theme's lifetime.
+ *
+ * Every preference is read through a getter rather than captured, and the theme
+ * table is replaced behind a delegate the renderers already hold, because the
+ * document is hot-reloaded and the shade the reader saves has to reach a session
+ * that is already on screen.
+ */
+export declare function createAppearance(ctx: Context, ports: AppearancePorts): Appearance;
+//# sourceMappingURL=appearance.d.ts.map

package/lib/surface/appearance.d.ts.map

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