@agi-fans/dsh-tui 0.18.0 → 0.20.0

package/lib/runtime/plugin-settings.d.ts

@@ -0,0 +1,17 @@
+/** Schema-driven configuration using path edits and revision-checked writes. */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { PluginSettingsEntry } from '../views/settings-list.ts';
+export interface ConfigField {
+    path: string[];
+    schema: z;
+    secret: boolean;
+    /** Compound values containing secrets must be edited through their owner's form. */
+    protected: boolean;
+}
+/** Flatten ordinary objects while retaining arrays and unions as atomic fields. */
+export declare function configFields(schema: z, path?: string[]): ConfigField[];
+export declare function configValue(value: unknown, path: readonly string[]): unknown;
+export declare function parseConfigValue(field: ConfigField, text: string): unknown;
+export declare function pluginSettingsEntries(ctx: Context): PluginSettingsEntry[];
+export declare function editPluginSettings(ctx: Context, ns: string, signal: AbortSignal): Promise<void>;

package/lib/runtime/plugin-settings.js

@@ -0,0 +1,154 @@
+/** Schema-driven configuration using path edits and revision-checked writes. */
+import { randomUUID } from 'node:crypto';
+import { credentialRef } from '@deepseek-ai/dsh-credentials';
+import z from '@deepseek-ai/schemastery';
+function containsSecret(schema, seen = new Set()) {
+    if (seen.has(schema))
+        return false;
+    seen.add(schema);
+    return schema.meta.role === 'secret' || [schema.inner, ...schema.list ?? [], ...Object.values(schema.dict ?? {})]
+        .some(child => child !== undefined && containsSecret(child, seen));
+}
+/** Flatten ordinary objects while retaining arrays and unions as atomic fields. */
+export function configFields(schema, path = []) {
+    if (schema.meta.hidden || schema.meta.disabled)
+        return [];
+    if (schema.type === 'object')
+        return Object.entries(schema.dict ?? {}).flatMap(([key, child]) => configFields(child, [...path, key]));
+    if (schema.type === 'intersect')
+        return (schema.list ?? []).flatMap(child => configFields(child, path));
+    if (path.length === 0)
+        return [];
+    const secret = schema.meta.role === 'secret';
+    return [{ path, schema, secret, protected: !secret && containsSecret(schema) }];
+}
+export function configValue(value, path) {
+    for (const key of path) {
+        if (value === null || typeof value !== 'object')
+            return undefined;
+        value = value[key];
+    }
+    return value;
+}
+function hasOverride(value, path) {
+    for (const key of path) {
+        if (value === null || typeof value !== 'object' || !Object.hasOwn(value, key))
+            return false;
+        value = value[key];
+    }
+    return true;
+}
+function display(value) {
+    return value === undefined ? 'not set' : typeof value === 'string' ? value : JSON.stringify(value);
+}
+function credentialPath(field, fields) {
+    const path = [...field.path.slice(0, -1), 'apiKeyEnv'];
+    return field.secret && field.path.at(-1) === 'apiKey' && fields.some(item => item.path.join('.') === path.join('.')) ? path : undefined;
+}
+function fieldDescription(section, field, fields) {
+    const refPath = credentialPath(field, fields);
+    const reference = refPath === undefined ? undefined : configValue(section.value, refPath);
+    const inline = section.secrets?.find(secret => secret.path.join('.') === field.path.join('.'))?.set;
+    const value = field.secret ? `secret · ${inline ? 'configured' : typeof reference === 'string' && reference !== '' ? 'credential reference configured' : 'not set'}`
+        : field.protected ? 'protected · use /auth or the owner configuration' : display(configValue(section.value, field.path));
+    const override = hasOverride(section.user, field.path) || refPath !== undefined && hasOverride(section.user, refPath);
+    const help = field.schema.meta.description;
+    return `${value} · ${override ? 'profile override' : 'inherited'}${typeof help === 'string' && help !== '' ? ` · ${help}` : ''}`;
+}
+export function parseConfigValue(field, text) {
+    const value = field.schema.type === 'string' ? text : JSON.parse(text);
+    field.schema(value);
+    return value;
+}
+const list = { presentation: 'fullscreen-list', optionLayout: 'compact', filterable: true, allowCustom: false };
+export function pluginSettingsEntries(ctx) {
+    return ctx.settings.describe({ redactSecrets: true }).flatMap(section => {
+        const fields = configFields(new z(section.schema));
+        const label = String(section.ns).replace(/[-_]+/gu, ' ').replace(/^./u, first => first.toUpperCase());
+        return fields.length === 0 ? [] : [{ id: String(section.ns), label,
+                description: `${section.ns} · ${fields.length} fields · ${ctx.settings.writable ? 'Edits apply live to this profile; Esc returns to Settings.' : 'This profile is read-only.'}` }];
+    });
+}
+export async function editPluginSettings(ctx, ns, signal) {
+    while (!signal.aborted) {
+        // Re-read after every write; never carry a stale editor into another field.
+        const section = ctx.settings.describe({ redactSecrets: true }).find(item => item.ns === ns);
+        if (section === undefined) {
+            ctx.tui.notice(`No editable configuration for ${ns}.`, { level: 'error' });
+            return;
+        }
+        const fields = configFields(new z(section.schema));
+        const selected = await ctx.tui.prompt({ ...list, title: String(section.ns), question: 'Choose a field',
+            options: fields.map((field, index) => ({ label: field.path.join('.'), value: String(index),
+                description: fieldDescription(section, field, fields) })), signal });
+        if (selected === null)
+            break;
+        const field = fields[Number(selected)];
+        if (field === undefined || field.protected)
+            continue;
+        if (!ctx.settings.writable) {
+            ctx.tui.notice('This profile is read-only.');
+            continue;
+        }
+        const action = await ctx.tui.prompt({ title: field.path.join('.'), question: 'Set a value or restore inheritance',
+            detail: field.secret ? 'Secret values are never shown. Reset removes the profile value and its paired credential reference; inherited credentials may still apply.' : `Current: ${display(configValue(section.value, field.path))}\nInherited: ${display(configValue(section.base, field.path))}`,
+            options: [{ label: 'Set value', value: 'set' }, { label: 'Reset to inherited', value: 'reset' }], allowCustom: false, signal });
+        if (action === null || signal.aborted)
+            continue;
+        try {
+            if (action === 'reset') {
+                validateModelSelection(section, field, configValue(section.base, field.path));
+                const refPath = credentialPath(field, fields);
+                await ctx.settings.mutate(ns, [{ op: 'unset', path: field.path }, ...(refPath === undefined ? [] : [{ op: 'unset', path: refPath }])], section.revision);
+            }
+            else {
+                const constants = field.schema.type === 'boolean' ? [true, false] : field.schema.type === 'union'
+                    && field.schema.list?.every(child => child.type === 'const') ? field.schema.list.map(child => child.value) : undefined;
+                const text = await ctx.tui.prompt({ title: field.path.join('.'), question: field.schema.type === 'string' ? 'Enter a value' : 'Enter a JSON value',
+                    ...(field.secret ? {} : { detail: field.schema.toString() }), secret: field.secret,
+                    ...(constants === undefined ? { allowCustom: true } : { allowCustom: false, options: constants.map(value => ({ label: display(value), value: JSON.stringify(value) })) }), signal });
+                if (text === null || signal.aborted)
+                    continue;
+                const value = parseConfigValue(field, text);
+                await saveValue(ctx, section, field, value);
+            }
+            ctx.tui.notice(`${ns}.${field.path.join('.')}: ${action === 'reset' ? 'inherited value restored' : 'saved'}.`);
+        }
+        catch (error) {
+            // Secret validation messages may echo their input.
+            ctx.tui.notice(field.secret ? 'Could not save the secret. Refresh the field and check its format or credential storage.' : error instanceof Error ? error.message : String(error), { level: 'error' });
+        }
+    }
+}
+function validateModelSelection(section, field, value) {
+    if (section.ns === 'subagent-model-selection-settings') {
+        const enabled = field.path[0] === 'enabled' ? value : configValue(section.value, ['enabled']);
+        const models = field.path[0] === 'allowedModels' ? value : configValue(section.value, ['allowedModels']);
+        if (enabled === true && (!Array.isArray(models) || models.length === 0))
+            throw new Error('Set at least one allowedModels route before enabling subagent model selection.');
+    }
+}
+async function saveValue(ctx, section, field, value) {
+    validateModelSelection(section, field, value);
+    const fields = configFields(new z(section.schema));
+    const envPath = credentialPath(field, fields);
+    if (envPath !== undefined) {
+        // Persist the key through Harness credentials; the profile holds only the
+        // reference. A fresh slot avoids changing an existing key if the fenced
+        // profile write loses a race after credential storage finishes.
+        if (ctx.settings.describe({ redactSecrets: true }).find(item => item.ns === section.ns)?.revision !== section.revision)
+            throw new Error('Configuration changed. Refresh and retry.');
+        const ref = credentialRef(`OMDSH_${[section.ns, ...field.path.slice(0, -1)].join('_').toUpperCase().replace(/[^A-Z0-9]+/gu, '_')}_API_KEY_${randomUUID().replace(/-/gu, '').toUpperCase()}`);
+        await ctx.credentials.set(ref, String(value));
+        try {
+            await ctx.settings.mutate(section.ns, [{ op: 'unset', path: field.path }, { op: 'set', path: envPath, value: String(ref) }], section.revision);
+        }
+        catch (error) {
+            await ctx.credentials.unset(ref);
+            throw error;
+        }
+    }
+    else
+        await ctx.settings.mutate(section.ns, [{ op: 'set', path: field.path, value }], section.revision);
+}
+//# sourceMappingURL=plugin-settings.js.map

package/lib/runtime/plugin-settings.js.map

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

package/lib/runtime/provider-local.d.ts

@@ -11,13 +11,16 @@
  * @module @agi-fans/dsh-tui
  */
 import { HerdrAgentReporter } from './herdr-agent.ts';
+import { type ImageProtocol } from '../chrome/terminal-images.ts';
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionEvent } from '@deepseek-ai/dsh-session';
-import { type TuiAgentBehaviorSettingsBinding, type TuiCommand, type TuiPrompt, type TuiNoticeOptions, type TuiRecentSession, type TuiService, type TuiSessionControls, type TuiSessionStats, type TuiStatus, type TuiInputImage, type TuiInspectedSubagent, type TuiLoopStatus, type TuiSubagentRoster, type TuiSubmission } from '../definition.ts';
+import type { WorkspaceChangesSummary } from '@deepseek-ai/dsh-workspace-changes';
+import type { FileAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import { type TuiAgentBehaviorSettingsBinding, type TuiCommand, type TuiOutputOptions, type TuiPrompt, type TuiNoticeOptions, type TuiRecentSession, type TuiService, type TuiSessionControls, type TuiSessionStats, type TuiStatus, type TuiTranscriptReplacement, type TuiInputImage, type TuiInspectedSubagent, type TuiLoopStatus, type TuiSubagentRoster, type TuiSubmission, type TuiPendingInputs } from '../definition.ts';
 import { type DirReader, type PathSearcher } from '../views/path-complete.ts';
 import { type FileSearcher, type SessionSearcher } from '../views/at-complete.ts';
 import { type ClipboardReader, type ClipboardWriter } from '../input/clipboard.ts';
-import { type TuiPrefs } from '../views/settings-list.ts';
+import { type PluginSettingsEntry, type TuiPrefs } from '../views/settings-list.ts';
 import { type StreamDelta } from '../views/event-views.ts';
 import { type RenderSink } from '../chrome/renderer.ts';
 import { type ThemeName } from '../chrome/theme.ts';
@@ -35,6 +38,11 @@ export interface Config extends TuiSettings {
     historyPath?: string;
     /** Optional `{ key-id: action }` JSON file. */
     keybindingsPath?: string;
+    /**
+     * Profile home. Feature toggles are edited in the Profile patch under it,
+     * which is why this row needs the path the composition already resolved.
+     */
+    dshHome?: string;
 }
 /**
  * Row schema. The durable preferences ride as volatile fields, so a settings
@@ -45,32 +53,50 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     theme: z<"dark" | "light" | "midnight" | "solarized" | "catppuccin" | "dracula" | "nord" | "gruvbox" | "rose-pine" | "mono", "dark" | "light" | "midnight" | "solarized" | "catppuccin" | "dracula" | "nord" | "gruvbox" | "rose-pine" | "mono", "volatile-defined">;
     colors: z<boolean, boolean, "volatile">;
     motion: z<"full" | "reduced" | "off", "full" | "reduced" | "off", "volatile-defined">;
+    mathMode: z<"auto" | "source", "auto" | "source", "volatile-defined">;
+    mermaidMode: z<"auto" | "source", "auto" | "source", "volatile-defined">;
+    editor: z<"auto" | "code" | "cursor" | "codium" | "nvim" | "vim" | "nano" | "vi", "auto" | "code" | "cursor" | "codium" | "nvim" | "vim" | "nano" | "vi", "volatile-defined">;
     terminalProgress: z<boolean, boolean, "volatile-defined">;
+    pasteProtection: z<boolean, boolean, "volatile-defined">;
+    copyOnSelect: z<boolean, boolean, "volatile-defined">;
+    mouseInteraction: z<"auto" | "tui" | "native", "auto" | "tui" | "native", "volatile-defined">;
+    foldDensity: z<"standard" | "compact" | "detailed" | "verbose", "standard" | "compact" | "detailed" | "verbose", "volatile-defined">;
     expandTools: z<boolean, boolean, "volatile-defined">;
     checkUpdates: z<boolean, boolean, "volatile-defined">;
     startupChangelog: z<"summary" | "expanded" | "hidden", "summary" | "expanded" | "hidden", "volatile-defined">;
     notifications: z<"off" | "long-running" | "always", "off" | "long-running" | "always", "volatile-defined">;
+    notificationFocus: z<"always" | "unfocused", "always" | "unfocused", "volatile-defined">;
     notificationThreshold: z<"15s" | "30s" | "1m" | "2m", "15s" | "30s" | "1m" | "2m", "volatile-defined">;
     statusBar: z<any, any, "volatile" | "volatile-defined">;
     statusPreset: z<"minimal" | "compact" | "full", "minimal" | "compact" | "full", "volatile">;
     model: z<string, string, "plain">;
     historyPath: z<string, string, "plain">;
     keybindingsPath: z<string, string, "plain">;
+    dshHome: z<string, string, "plain">;
 }>>, Schemastery.ObjectT<NoInfer<{
     theme: z<"dark" | "light" | "midnight" | "solarized" | "catppuccin" | "dracula" | "nord" | "gruvbox" | "rose-pine" | "mono", "dark" | "light" | "midnight" | "solarized" | "catppuccin" | "dracula" | "nord" | "gruvbox" | "rose-pine" | "mono", "volatile-defined">;
     colors: z<boolean, boolean, "volatile">;
     motion: z<"full" | "reduced" | "off", "full" | "reduced" | "off", "volatile-defined">;
+    mathMode: z<"auto" | "source", "auto" | "source", "volatile-defined">;
+    mermaidMode: z<"auto" | "source", "auto" | "source", "volatile-defined">;
+    editor: z<"auto" | "code" | "cursor" | "codium" | "nvim" | "vim" | "nano" | "vi", "auto" | "code" | "cursor" | "codium" | "nvim" | "vim" | "nano" | "vi", "volatile-defined">;
     terminalProgress: z<boolean, boolean, "volatile-defined">;
+    pasteProtection: z<boolean, boolean, "volatile-defined">;
+    copyOnSelect: z<boolean, boolean, "volatile-defined">;
+    mouseInteraction: z<"auto" | "tui" | "native", "auto" | "tui" | "native", "volatile-defined">;
+    foldDensity: z<"standard" | "compact" | "detailed" | "verbose", "standard" | "compact" | "detailed" | "verbose", "volatile-defined">;
     expandTools: z<boolean, boolean, "volatile-defined">;
     checkUpdates: z<boolean, boolean, "volatile-defined">;
     startupChangelog: z<"summary" | "expanded" | "hidden", "summary" | "expanded" | "hidden", "volatile-defined">;
     notifications: z<"off" | "long-running" | "always", "off" | "long-running" | "always", "volatile-defined">;
+    notificationFocus: z<"always" | "unfocused", "always" | "unfocused", "volatile-defined">;
     notificationThreshold: z<"15s" | "30s" | "1m" | "2m", "15s" | "30s" | "1m" | "2m", "volatile-defined">;
     statusBar: z<any, any, "volatile" | "volatile-defined">;
     statusPreset: z<"minimal" | "compact" | "full", "minimal" | "compact" | "full", "volatile">;
     model: z<string, string, "plain">;
     historyPath: z<string, string, "plain">;
     keybindingsPath: z<string, string, "plain">;
+    dshHome: z<string, string, "plain">;
 }>>, "plain">;
 /** The minimal terminal surface a LocalTui drives (process streams satisfy it). */
 export interface TerminalLike {
@@ -89,8 +115,15 @@ export interface TerminalLike {
     /** Optional resize subscription; returns a disposer. */
     onResize?(listener: () => void): () => void;
 }
+interface PluginSettingsBinding {
+    entries(): readonly PluginSettingsEntry[];
+    edit(id: string, signal: AbortSignal): Promise<void>;
+}
 export declare class LocalTui implements TuiService {
     #private;
+    get interactive(): boolean;
+    openFileInEditor(path: string): void;
+    stageFileAttachment(file: FileAttachmentRef): void;
     /**
      * @param term - terminal surface (injectable for tests).
      * @param model - model label for the status line.
@@ -110,12 +143,19 @@ export declare class LocalTui implements TuiService {
         searchSessions?: SessionSearcher;
         autocompleteDebounceMs?: number;
         historyPath?: string;
+        draftsPath?: string;
         keybindingsPath?: string;
+        /**
+         * Profile patch the Features section edits. Absent leaves the section
+         * out entirely rather than presenting toggles that cannot be written.
+         */
+        featurePatch?: string;
         readClipboard?: ClipboardReader;
         readClipboardImage?: ClipboardImageReader;
         readClipboardFiles?: ClipboardFileReader;
         readImagePath?: ImagePathReader;
         deferInitialRender?: boolean;
+        imageProtocol?: ImageProtocol | 'none';
         terminalProfile?: 'direct' | 'multiplexer' | 'conpty';
         alternateScreenOverlays?: boolean;
         resizeDebounceMs?: number;
@@ -123,14 +163,17 @@ export declare class LocalTui implements TuiService {
         /** Herdr lifecycle reporter; production injects an environment-aware one. */
         herdrReporter?: HerdrAgentReporter;
     });
-    event(event: SessionEvent, presentation?: TuiToolPresentation): void;
+    event(event: SessionEvent, presentation?: TuiToolPresentation, workspace?: WorkspaceChangesSummary): void;
+    setWorkspaceSummary(turn: number, summary: WorkspaceChangesSummary): void;
     /**
      * Fold one live `agent/assistant-stream` chunk into the transcript and
      * schedule the streaming reveal. Durable settlement follows on the session
      * log as `assistant/message` or `assistant/attempt`.
      */
     streamDelta(delta: StreamDelta): void;
-    setStatus(status: TuiStatus): void;
+    setStatus(status: TuiStatus, options?: {
+        root?: boolean;
+    }): void;
     setModel(model: string, reasoningEffort?: string): void;
     setLoopStatus(status: TuiLoopStatus | undefined): void;
     setSubagents(roster: TuiSubagentRoster | undefined): void;
@@ -143,9 +186,9 @@ export declare class LocalTui implements TuiService {
     setImageValidator(validate?: (image: TuiInputImage) => Promise<void>): void;
     toolCallContext(callId: string): string | undefined;
     notice(text: string, options?: TuiNoticeOptions): void;
-    commandOutput(command: string, text: string): void;
+    commandOutput(command: string, text: string, options?: TuiOutputOptions): void;
     prompt(request: TuiPrompt): Promise<string | null>;
-    replaceSession(events: readonly SessionEvent[], presentations?: ReadonlyMap<number, TuiToolPresentation>, status?: TuiStatus): void;
+    replaceSession(events: readonly SessionEvent[], presentations?: ReadonlyMap<number, TuiToolPresentation>, status?: TuiStatus, reason?: TuiTranscriptReplacement): void;
     setSession(info: {
         id: string;
         title?: string;
@@ -159,6 +202,8 @@ export declare class LocalTui implements TuiService {
     prefs(): TuiPrefs;
     /** Called after a live `/settings` change. */
     setPrefsPersist(persist: (prefs: TuiPrefs) => void): void;
+    /** Bind the native Plugins section; unbinding cancels and drains its active form. */
+    bindPluginSettings(binding: PluginSettingsBinding): () => Promise<void>;
     bindAgentBehaviorSettings(binding: TuiAgentBehaviorSettingsBinding): () => void;
     readInput(signal?: AbortSignal): Promise<TuiSubmission | null>;
     /** Compatibility helper for provider-level text editing tests and embedders. */
@@ -166,14 +211,19 @@ export declare class LocalTui implements TuiService {
     restoreInput(submission: TuiSubmission): void;
     resolveQueueEdit(submission: TuiSubmission | null): void;
     onInterrupt(listener: () => void): () => void;
+    readonly pendingInputs: TuiPendingInputs;
+    setQueueHandler(handler: (signal: AbortSignal) => Promise<void>): () => void;
     onQueueEdit(listener: () => void): () => void;
     onRewind(listener: () => void): () => void;
     onInspectSubagent(listener: (id: string) => void): () => void;
     onInspectClose(listener: () => void): () => void;
     onInspectSubmit(listener: (submission: TuiSubmission) => void): () => void;
-    dispose(): void;
+    setSteerHandler(handler: (text: string) => void): () => void;
+    dispose(): Promise<void>;
     /** Re-render the current frame (resize reflow). */
     refresh(): void;
+    /** Resolve one bounded tmux probe without overwriting an explicit preference. */
+    setTmuxMouseEnabled(enabled: boolean | undefined): void;
 }
 /**
  * Mount the local terminal provider as the tui service.
@@ -181,3 +231,4 @@ export declare class LocalTui implements TuiService {
  * @param config - model label and color switch.
  */
 export declare function apply(ctx: Context, config: Config): void;
+export {};