@deepseek-harness-tui/dsh-tui 0.7.2 → 0.8.0

package/lib/types/dsh-adapter/providerWizard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providerWizard.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/providerWizard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,QAAoC,CAAA;AAElE,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,2EAIrB,CAAA;AAEV;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,mEAAmE;AACnE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,oBAAoB,IAAI,SAAS,wBAAwB,EAAE,CAAA;IAC3D,kEAAkE;IAClE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,sEAAsE;IACtE,cAAc,CAAC,OAAO,EAAE;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAA;IAC1C,0EAA0E;IAC1E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACxD,2EAA2E;IAC3E,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,yDAAyD;IACzD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7E;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,GAAG,EAAE,CACZ,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAC3B,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KACtE,IAAI,CAAA;IACT,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAA;IACrE,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5E;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAA;AAgDpE;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,qBAAqB,CAAC,CA4MhC"}
+{"version":3,"file":"providerWizard.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/providerWizard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,QAAoC,CAAA;AAElE,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,2EAIrB,CAAA;AAEV;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,mEAAmE;AACnE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,oBAAoB,IAAI,SAAS,wBAAwB,EAAE,CAAA;IAC3D,kEAAkE;IAClE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,sEAAsE;IACtE,cAAc,CAAC,OAAO,EAAE;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAA;IAC1C,0EAA0E;IAC1E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACxD,2EAA2E;IAC3E,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,yDAAyD;IACzD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7E;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,GAAG,EAAE,CACZ,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAC3B,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KACtE,IAAI,CAAA;IACT,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAA;IACrE,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5E;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAA;AAgDpE;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,qBAAqB,CAAC,CA8MhC"}

package/lib/types/dsh-adapter/providerWizard.js

@@ -86,7 +86,9 @@ export async function runProviderWizard(deps) {
                     questions: [optionQuestion('catalog', t('provider-q-catalog'), [
                             ...candidates.map(candidate => ({
                                 label: candidate.provider,
-                                description: candidate.displayName,
+                                description: candidate.displayName === candidate.provider
+                                    ? undefined
+                                    : candidate.displayName,
                             })),
                             { label: otherLabel, description: t('provider-opt-other-route-desc') },
                         ], { hideCustomInput: true })],

package/lib/types/dsh-adapter/scenes.d.ts

@@ -0,0 +1,75 @@
+/** Provider-neutral full-screen scene registry for terminal front doors. */
+import type React from 'react';
+import { Context, Service } from '@deepseek-ai/cordis';
+import type { Channel } from './channel.js';
+/**
+ * Props every plugin scene receives. Both element creation and hooks must go
+ * through the HOST's React, never the plugin's own copy:
+ *
+ * - Hooks: a component rendered by this TUI's reconciler but calling hooks
+ *   imported from a second React copy (the plugin's own node_modules) dies
+ *   with an invalid-hook-call on first render. Use the injected `React`.
+ * - Elements: this app's reconciler (React 19) accepts only
+ *   `Symbol.for('react.transitional.element')` elements. JSX compiled
+ *   against a plugin-bundled older React emits `Symbol.for('react.element')`
+ *   and throws on first render. Create elements with the injected `React`
+ *   (`React.createElement`/`React.Fragment`), or compile JSX against the
+ *   host runtime via tsconfig
+ *   `"jsxImportSource": "@deepseek-harness-tui/dsh-tui"` (its `./jsx-runtime`
+ *   subpath re-exports this app's own react/jsx-runtime). A plugin-owned
+ *   React copy works ONLY if it is the same React 19 line — and its hooks
+ *   remain off-limits regardless.
+ */
+export interface TuiSceneProps {
+    /** The TUI's React instance — use THIS for every hook and element. */
+    React: typeof React;
+    /** The TUI's ui kit (Box/Text/useInput/useTerminalSize/…). */
+    ui: typeof import('../ui.js');
+    /** Live session channel: rows, status, trace events, notifications. */
+    channel: Channel;
+    /** Leave the scene and return to whatever screen was up before. */
+    close(): void;
+}
+export interface TuiSceneDescriptor {
+    /** Unique scene id (kebab-case); the plugin's own commands open it by id. */
+    id: string;
+    /** Optional human label for logs/debugging; the scene renders its own header. */
+    title?: string;
+    component: React.ComponentType<TuiSceneProps>;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        tuiScenes: TuiSceneRuntime;
+    }
+}
+export declare const name = "dsh-tui-scenes";
+/**
+ * Small host-only registry; command execution remains owned by dsh-commands.
+ *
+ * A plugin registers a scene once (`ctx.tuiScenes.register(...)`, keep the
+ * dispose) and opens it from anywhere host-side — typically its own
+ * dsh-commands handler: `ctx.tuiScenes.open('my-scene')` plus a silent
+ * `success` result, so the conversation stays untouched while the scene
+ * takes the whole terminal the way the trajectory scene does.
+ */
+export declare class TuiSceneRuntime extends Service {
+    private readonly scenes;
+    private readonly listeners;
+    private current;
+    constructor(ctx: Context);
+    register(descriptor: TuiSceneDescriptor): () => void;
+    /**
+     * Swap the conversation for the named scene. Returns false (and warns)
+     * when no plugin registered that id — a mistyped id must fail visibly in
+     * the log, not silently do nothing in the UI.
+     */
+    open(id: string): boolean;
+    close(): void;
+    /** The scene currently replacing the conversation, if any. */
+    get active(): TuiSceneDescriptor | undefined;
+    /** UI-side change feed: fired after every open/close/dispose transition. */
+    subscribe(listener: () => void): () => void;
+    private notify;
+}
+export default TuiSceneRuntime;
+//# sourceMappingURL=scenes.d.ts.map

package/lib/types/dsh-adapter/scenes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenes.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/scenes.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,8DAA8D;IAC9D,EAAE,EAAE,cAAc,UAAU,CAAC,CAAA;IAC7B,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAA;IAChB,mEAAmE;IACnE,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAA;IACV,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,aAAa,CAAC,CAAA;CAC9C;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,SAAS,EAAE,eAAe,CAAA;KAC3B;CACF;AAED,eAAO,MAAM,IAAI,mBAAmB,CAAA;AAEpC;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,OAAO;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,OAAO,CAAgC;gBAEnC,GAAG,EAAE,OAAO;IAIxB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAiBpD;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAYzB,KAAK,IAAI,IAAI;IAMb,8DAA8D;IAC9D,IAAI,MAAM,IAAI,kBAAkB,GAAG,SAAS,CAE3C;IAED,4EAA4E;IAC5E,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C,OAAO,CAAC,MAAM;CAGf;AAED,eAAe,eAAe,CAAA"}

package/lib/types/dsh-adapter/scenes.js

@@ -0,0 +1,78 @@
+/** Provider-neutral full-screen scene registry for terminal front doors. */
+import { Service } from '@deepseek-ai/cordis';
+export const name = 'dsh-tui-scenes';
+/**
+ * Small host-only registry; command execution remains owned by dsh-commands.
+ *
+ * A plugin registers a scene once (`ctx.tuiScenes.register(...)`, keep the
+ * dispose) and opens it from anywhere host-side — typically its own
+ * dsh-commands handler: `ctx.tuiScenes.open('my-scene')` plus a silent
+ * `success` result, so the conversation stays untouched while the scene
+ * takes the whole terminal the way the trajectory scene does.
+ */
+export class TuiSceneRuntime extends Service {
+    scenes = new Map();
+    listeners = new Set();
+    current;
+    constructor(ctx) {
+        super(ctx, 'tuiScenes');
+    }
+    register(descriptor) {
+        const id = descriptor.id.trim().toLowerCase();
+        if (!/^[a-z][a-z0-9_-]*$/u.test(id))
+            throw new TypeError(`invalid TUI scene id: ${descriptor.id}`);
+        if (this.scenes.has(id))
+            throw new Error(`TUI scene "${id}" is already registered`);
+        const normalized = { ...descriptor, id };
+        this.scenes.set(id, normalized);
+        return () => {
+            if (this.scenes.get(id) !== normalized)
+                return;
+            this.scenes.delete(id);
+            // Disposing the open scene must not strand the user on a dead screen.
+            if (this.current === normalized) {
+                this.current = undefined;
+                this.notify();
+            }
+        };
+    }
+    /**
+     * Swap the conversation for the named scene. Returns false (and warns)
+     * when no plugin registered that id — a mistyped id must fail visibly in
+     * the log, not silently do nothing in the UI.
+     */
+    open(id) {
+        const scene = this.scenes.get(id.trim().toLowerCase());
+        if (scene === undefined) {
+            this.ctx.logger.warn(`dsh-tui: no TUI scene registered as "${id}"`);
+            return false;
+        }
+        if (scene === this.current)
+            return true;
+        this.current = scene;
+        this.notify();
+        return true;
+    }
+    close() {
+        if (this.current === undefined)
+            return;
+        this.current = undefined;
+        this.notify();
+    }
+    /** The scene currently replacing the conversation, if any. */
+    get active() {
+        return this.current;
+    }
+    /** UI-side change feed: fired after every open/close/dispose transition. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    notify() {
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+export default TuiSceneRuntime;

package/lib/types/dsh-adapter/settings-sections.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Plugin settings-section extension seam for terminal front doors.
+ *
+ * The TUI owns the settings screen: rendering, staged editing, and the
+ * revision-fenced `settings.mutate` writes. Optional plugins declare WHAT is
+ * editable — a section over their settings namespace — without coupling the
+ * TUI to them, mirroring the web front door's `settings.plugin.item` slot
+ * (plugins ship cards; the host ships the chrome). Storage, validation and
+ * layering stay with the dsh settings service; this registry is display
+ * metadata only.
+ */
+import { Context, Service } from '@deepseek-ai/cordis';
+import type { LocalizedDescriptions } from '../commands.js';
+/** Control kinds the TUI settings screen knows how to render. */
+export type TuiSettingsFieldKind = 'text' | 'number' | 'boolean' | 'select';
+export interface TuiSettingsFieldOption {
+    /** Stored value. */
+    value: string;
+    /** Display label (English; also the fallback). */
+    label: string;
+    /** Provider-owned translations for the label. */
+    descriptions?: LocalizedDescriptions;
+}
+/** The write one field's draft stages when the section is saved. */
+export type TuiSettingsFieldWrite = {
+    kind: 'set';
+    value: unknown;
+} | {
+    kind: 'clear';
+};
+export interface TuiSettingsField {
+    /**
+     * Key path from the section root, in the settings service's `mutate` path
+     * vocabulary (object keys; dict keys name their entry directly).
+     */
+    path: readonly string[];
+    /** Short field label (English; also the fallback). */
+    label: string;
+    /** Provider-owned translations for the label. */
+    descriptions?: LocalizedDescriptions;
+    /** Optional one-line help rendered under the field. */
+    hint?: string;
+    /** Provider-owned translations for the hint. */
+    hintDescriptions?: LocalizedDescriptions;
+    kind: TuiSettingsFieldKind;
+    /** Choices for `kind: 'select'` (ignored otherwise). */
+    options?: readonly TuiSettingsFieldOption[];
+    /** Input placeholder for `kind: 'text' | 'number'`. */
+    placeholder?: string;
+    /**
+     * Credential control (mirrors the web cards' CardSecretSpec): the literal
+     * never rides the settings document — the draft starts blank on every
+     * open, a blank draft writes nothing, and a typed draft writes through the
+     * credentials seam under `ref`. The screen shows only whether a value is
+     * configured.
+     */
+    secret?: {
+        ref: string;
+    };
+    /**
+     * Render a stored value as draft text. Defaults to the kind's conversion
+     * (strings verbatim, numbers via `String`, booleans/selects by value).
+     */
+    format?(value: unknown): string;
+    /**
+     * The write this draft text stages, or `undefined` when the text is not a
+     * value this field accepts — an invalid draft blocks the save rather than
+     * being discarded. Defaults to the kind's conversion (an empty text/number
+     * draft stages a clear, letting the field re-inherit the composition
+     * layer).
+     */
+    parse?(text: string): TuiSettingsFieldWrite | undefined;
+}
+/** One plugin's section inside the TUI settings screen. */
+export interface TuiSettingsSection {
+    /**
+     * Settings namespace this section edits. Should match a namespace the
+     * plugin registers on the dsh settings service; the screen marks the
+     * section unavailable when the composition serves no such namespace.
+     */
+    ns: string;
+    /** Section title (English; also the fallback). */
+    title: string;
+    /** Provider-owned translations for the title. */
+    descriptions?: LocalizedDescriptions;
+    /** Editable fields, in display order. */
+    fields: readonly TuiSettingsField[];
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        tuiSettingsSections: TuiSettingsSectionsRuntime;
+    }
+}
+export declare const name = "dsh-tui-settings-sections";
+/**
+ * Small host-only registry; settings storage and validation remain owned by
+ * the dsh settings service (`ctx.settings`).
+ */
+export declare class TuiSettingsSectionsRuntime extends Service {
+    private readonly sections;
+    private readonly listeners;
+    constructor(ctx: Context);
+    register(section: TuiSettingsSection): () => void;
+    /** Registered sections in registration order. */
+    list(): readonly TuiSettingsSection[];
+    /** The section registered for a namespace, if any. */
+    section(ns: string): TuiSettingsSection | undefined;
+    /**
+     * Subscribe to register/unregister events so an open settings screen can
+     * re-read the section list (a plugin (un)loading mid-session changes it).
+     */
+    subscribe(listener: () => void): () => void;
+    private emit;
+}
+export default TuiSettingsSectionsRuntime;
+//# sourceMappingURL=settings-sections.d.ts.map

package/lib/types/dsh-adapter/settings-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-sections.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/settings-sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAE3D,iEAAiE;AACjE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE3E,MAAM,WAAW,sBAAsB;IACrC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,YAAY,CAAC,EAAE,qBAAqB,CAAA;CACrC;AAED,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAErB,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,qBAAqB,CAAA;IACxC,IAAI,EAAE,oBAAoB,CAAA;IAC1B,wDAAwD;IACxD,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;IAC3C,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;IACxB;;;OAGG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAA;IAC/B;;;;;;OAMG;IACH,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAA;CACxD;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAA;IACV,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,yCAAyC;IACzC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAA;CACpC;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,mBAAmB,EAAE,0BAA0B,CAAA;KAChD;CACF;AAED,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAE/C;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,OAAO;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;gBAEtC,GAAG,EAAE,OAAO;IAIxB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAejD,iDAAiD;IACjD,IAAI,IAAI,SAAS,kBAAkB,EAAE;IAIrC,sDAAsD;IACtD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAInD;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C,OAAO,CAAC,IAAI;CAGb;AAED,eAAe,0BAA0B,CAAA"}

package/lib/types/dsh-adapter/settings-sections.js

@@ -0,0 +1,63 @@
+/**
+ * Plugin settings-section extension seam for terminal front doors.
+ *
+ * The TUI owns the settings screen: rendering, staged editing, and the
+ * revision-fenced `settings.mutate` writes. Optional plugins declare WHAT is
+ * editable — a section over their settings namespace — without coupling the
+ * TUI to them, mirroring the web front door's `settings.plugin.item` slot
+ * (plugins ship cards; the host ships the chrome). Storage, validation and
+ * layering stay with the dsh settings service; this registry is display
+ * metadata only.
+ */
+import { Service } from '@deepseek-ai/cordis';
+export const name = 'dsh-tui-settings-sections';
+/**
+ * Small host-only registry; settings storage and validation remain owned by
+ * the dsh settings service (`ctx.settings`).
+ */
+export class TuiSettingsSectionsRuntime extends Service {
+    sections = new Map();
+    listeners = new Set();
+    constructor(ctx) {
+        super(ctx, 'tuiSettingsSections');
+    }
+    register(section) {
+        const ns = section.ns.trim();
+        if (!/^[a-z][a-z0-9_-]*$/u.test(ns))
+            throw new TypeError(`invalid TUI settings-section namespace: ${section.ns}`);
+        if (this.sections.has(ns))
+            throw new Error(`TUI settings section "${ns}" is already registered`);
+        const normalized = { ...section, ns };
+        this.sections.set(ns, normalized);
+        this.emit();
+        return () => {
+            if (this.sections.get(ns) === normalized) {
+                this.sections.delete(ns);
+                this.emit();
+            }
+        };
+    }
+    /** Registered sections in registration order. */
+    list() {
+        return [...this.sections.values()];
+    }
+    /** The section registered for a namespace, if any. */
+    section(ns) {
+        return this.sections.get(ns.trim());
+    }
+    /**
+     * Subscribe to register/unregister events so an open settings screen can
+     * re-read the section list (a plugin (un)loading mid-session changes it).
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    emit() {
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+export default TuiSettingsSectionsRuntime;

package/lib/types/dsh-adapter/settingsEditor.d.ts

@@ -0,0 +1,128 @@
+/**
+ * React-free form model behind the `/settings` screen (issue #165), mirroring
+ * the web front door's card-form.ts semantics: a section stages what the user
+ * types and writes it only on save — every settings write is a durable,
+ * revision-fenced `settings.mutate`, so a control that committed as it
+ * settled turned one edit into a write the user never asked for and could
+ * not preview; staged text makes what is on screen exactly what a save would
+ * store.
+ *
+ * A field shows its effective value — the user layer over the composition
+ * layer over the schema default — and whether the user layer carries it. That
+ * presence, not a value comparison, is what marks a field overridden: an
+ * override equal to the composition default is still an override.
+ *
+ * The kernel side (storage, schema validation, layering, revision fencing)
+ * stays with the dsh settings / credentials services; this module only
+ * translates between drafts and `mutate` path ops.
+ */
+import type { TuiSettingsField } from './settings-sections.js';
+/** One settings namespace as the screen reads it (secrets redacted). */
+export interface SettingsNamespaceView {
+    readonly ns: string;
+    /** Monotonic revision of the raw user section; fences writes. */
+    readonly revision: number;
+    /** 'live' applies immediately; 'restart' needs a relaunch. */
+    readonly applies: 'live' | 'restart';
+    /** Current resolved value (all layers composed). */
+    readonly value: unknown;
+    /** Raw user layer; a path present here is a user override. */
+    readonly user: unknown;
+}
+/**
+ * Runtime capabilities the settings screen needs, implemented by the channel
+ * over the dsh `settings` / `credentials` seams. `undefined` from
+ * `channel.settingsHost()` means the composition lacks them (bare cordis.yml
+ * start) and the screen shows namespaces read-only.
+ */
+export interface SettingsHost {
+    /** Every registered namespace, secrets redacted, in registration order. */
+    listNamespaces(): readonly SettingsNamespaceView[];
+    /** Write path ops against a namespace, fenced by its current revision. */
+    write(ns: string, ops: readonly SettingsPathOp[], expectedRevision?: number): Promise<void>;
+    /** Whether any layer supplies a credential under `ref`. */
+    credentialConfigured(ref: string): Promise<boolean>;
+    /** Persist a credential; rejects when env-shadowed or the store is read-only. */
+    writeCredential(ref: string, value: string): Promise<void>;
+}
+export type SettingsPathOp = {
+    op: 'set';
+    path: readonly string[];
+    value: unknown;
+} | {
+    op: 'unset';
+    path: readonly string[];
+};
+/** One field as the screen renders it. */
+export interface SettingsFieldState {
+    /** Draft text the control renders. */
+    text: string;
+    /** Whether saving would leave a user-layer entry for this field. */
+    overridden: boolean;
+    /** Whether the draft is not a value this field accepts, blocking the save. */
+    invalid: boolean;
+}
+/** Form state every settings section shares. */
+export interface SettingsSectionShell {
+    /** False while the settings service serves no such namespace. */
+    available: boolean;
+    /** Whether the form holds edits that a save would write. */
+    dirty: boolean;
+    /** Whether any staged draft is invalid, which blocks the save. */
+    invalid: boolean;
+    /** Whether a save is in flight. */
+    saving: boolean;
+    /** Whether the last save failed; cleared by the next edit or save. */
+    failed: boolean;
+}
+/** Read a nested value by path (array indexes as strings). */
+export declare function getPath(value: unknown, path: readonly string[]): unknown;
+/**
+ * Whether a value explicitly carries the path — its presence marks a user
+ * override, independent of the value stored there.
+ */
+export declare function hasPath(value: unknown, path: readonly string[]): boolean;
+/**
+ * The staged form over one settings namespace's declared fields. The screen
+ * re-seeds it from a fresh namespace view after every save and whenever the
+ * underlying document changes.
+ */
+export declare class SettingsForm {
+    private readonly host;
+    private readonly view;
+    private readonly fields;
+    private readonly edits;
+    saving: boolean;
+    failed: boolean;
+    constructor(host: SettingsHost, view: SettingsNamespaceView | undefined, fields: readonly TuiSettingsField[]);
+    get available(): boolean;
+    /** The namespace view the form was seeded from (undefined = not served). */
+    get namespace(): SettingsNamespaceView | undefined;
+    field(field: TuiSettingsField): SettingsFieldState;
+    shell(): SettingsSectionShell;
+    /** Whether the field holds a staged (unsaved) edit. */
+    isStaged(field: TuiSettingsField): boolean;
+    /** Stage draft text for one field. */
+    edit(field: TuiSettingsField, text: string): void;
+    /** Stage a clear, so saving lets the field re-inherit the composition layer. */
+    resetField(field: TuiSettingsField): void;
+    /** Drop every staged edit. */
+    discard(): void;
+    /** Whether any staged draft is invalid, which blocks the save. */
+    get invalid(): boolean;
+    /**
+     * Write every staged edit. Settings fields land as one revision-fenced
+     * `mutate` (one retry on a stale-revision conflict); credential fields
+     * write through the credentials seam. Resolves to whether every write
+     * landed — the caller re-seeds from a fresh namespace view afterwards.
+     *
+     * Only the edits THIS save snapshotted are cleared on success, and only
+     * when they are still the same edit: a draft typed while the write was in
+     * flight is a newer object and survives — it was never written, so it must
+     * not be silently dropped.
+     */
+    save(): Promise<boolean>;
+    /** Whether any layer supplies the credential a secret field addresses. */
+    credentialConfigured(field: TuiSettingsField): Promise<boolean>;
+}
+//# sourceMappingURL=settingsEditor.d.ts.map

package/lib/types/dsh-adapter/settingsEditor.d.ts.map

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