@aiwayds/dsh-tui-pi 0.5.2 → 0.7.0

package/lib/settings.d.ts

@@ -3,8 +3,8 @@
  * settings surface (schema-form driven there, pi-tui overlays here).
  *
  * Walks `ctx.settings.describe()` (registered namespaces → serialized
- * schemastery schemas → resolved values) and renders it as nested
- * SettingsList overlays, one level per schema depth:
+ * schemastery schemas → resolved values) and renders it as nested FW list
+ * panels (src/panels.ts SettingsListPanel), one level per schema depth:
  *
  *   level 0   category list (searchable): general / models / plugins / agent,
  *             then `other` for unmapped namespaces. Namespace→category comes
@@ -37,6 +37,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import { type SchemaNode } from '@deepseek-ai/dsh-client-schema-form';
 import { type Component, type TUI } from '@earendil-works/pi-tui';
 import { type TuiTheme } from './theme/index.ts';
+import { type ProviderCatalogEntry } from './provider-catalog.ts';
 export interface SettingsCategory {
     id: string;
     label: string;
@@ -138,6 +139,7 @@ export interface EditOptions {
 /** Inline value editor: title, current-value line, error/notice line, Input. */
 export declare class EditField implements Component {
     private readonly tui;
+    private readonly theme;
     private readonly options;
     private readonly input;
     private error;
@@ -147,11 +149,7 @@ export declare class EditField implements Component {
     private pending;
     /** Guards onDone: exactly one terminal transition (submit success/keep/escape). */
     private done;
-    private readonly fg;
-    private readonly fgMuted;
     private readonly fgDanger;
-    /** Popup-surface background for the secret mask line. */
-    private readonly maskBg;
     constructor(tui: TUI, options: EditOptions, theme: TuiTheme);
     /** Terminal transition — runs the caller's onDone exactly once. */
     private finish;
@@ -161,11 +159,69 @@ export declare class EditField implements Component {
      * Masked input line for secret fields: a dot row (one dot per visible
      * column of the value, capped to the popup width) with a `▎` marker at the
      * cursor position. The real cursor is not rendered — the marker only hints
-     * at the editing position; input semantics live in the internal Input.
+     * at the editing position; input semantics live in the internal Input. The
+     * row needs no background of its own — FramedOverlay fills the canvasSubtle
+     * backdrop.
      */
     private maskLine;
     handleInput(data: string): void;
 }
+/** Commit a provider (profile + key); resolves with an outcome or none. */
+export interface AddProviderOptions {
+    /** Catalog entries the picker offers, in directory order. */
+    entries: readonly ProviderCatalogEntry[];
+    /**
+     * When set, skip the picker and open the key editor for this entry
+     * directly — the `/login <provider>` fast path. Esc in the editor pops the
+     * whole flow.
+     */
+    initialEntry?: ProviderCatalogEntry;
+    /** Commit the provider: write the profile, then store the key. */
+    onCommit: (entry: ProviderCatalogEntry, key: string) => Promise<CommitResult | undefined>;
+    /** Pop the whole flow (Esc, or right after a successful commit). */
+    onExit: () => void;
+    /** Error sink for writes that fail after the editor already closed. */
+    onError: (message: string) => void;
+}
+/**
+ * Add-provider flow for the Models category — the terminal counterpart of
+ * pi-agent's /login, trimmed to the information a user actually needs: pick
+ * a provider from the built-in directory (searchable FW list panel, accent
+ * BOLD title), enter exactly one API key, done. The key editor reuses
+ * EditField (pending guard, late-error sink); the picker is a searchable
+ * SettingsListPanel of the directory entries. `/login <provider>` reuses this
+ * flow through `initialEntry`, which swaps the picker for a direct key
+ * editor. Exported because /login instantiates it as a top-level overlay.
+ */
+export declare class AddProviderFlow implements Component {
+    private readonly tui;
+    private readonly theme;
+    private readonly list;
+    /** Direct-launch key editor (`initialEntry` set); replaces the picker list. */
+    private readonly direct;
+    private readonly empty;
+    private readonly onExit;
+    constructor(tui: TUI, theme: TuiTheme, options: AddProviderOptions);
+    /** Key editor for one directory entry; commits through the write chain. */
+    private keyEditor;
+    invalidate(): void;
+    render(width: number): string[];
+    handleInput(data: string): void;
+}
+/**
+ * Commit a provider (profile + key) through the settings + credentials seams —
+ * the same two writes the web Models page performs. Shared by the Models
+ * category's add flow and the /login command; the caller supplies the profile
+ * write (each surface keeps its own serialized settings chain). A missing
+ * credentials service still commits the profile (it names the derived ref; the
+ * key then has to come from the environment).
+ *
+ * Outcome surface: a write failure is an `error`; a committed profile whose
+ * key could not be stored is an `error` with the manual fallback spelled out
+ * (B3); a committed profile with no credentials service at all is a `notice`
+ * (success + hint, no ✘ — C11). Resolves `undefined` on a full success.
+ */
+export declare function commitProvider(ctx: Context, writeProfile: () => Promise<string | undefined>, entry: ProviderCatalogEntry, key: string): Promise<CommitResult | undefined>;
 export interface OpenSettingsBrowserOptions {
     ctx: Context;
     tui: TUI;