@dsh-cc/tui 0.5.0

package/lib/provider-flow.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Side-effect-free core for the `/provider` command (design doc
+ * docs/plans/2026-09-05-provider-management.md §4.2–§4.6): list merge rule,
+ * route normalization/collision, profile materialization, model-list parsing,
+ * and the verify-probe request builder. All functions are pure — seams and
+ * data arrive as plain values (D6 `*Like` pattern).
+ * @module @dsh-cc/tui/provider-flow
+ */
+import type { LlmLike } from './state/driver-types.ts';
+import { type ProviderPreset } from './provider-presets.ts';
+/**
+ * Duck-typed seam for the llm service's management surface (§5). Extends the
+ * existing {@link LlmLike} with directory discovery (C8) and draft-form model
+ * listing (C5). Declared here rather than in state/driver-types.ts, which sits
+ * at its 500-line cap.
+ */
+export type LlmManageLike = LlmLike & {
+    listConfigurableProviders(): {
+        provider: string;
+        displayName?: string;
+        settingsNs?: string;
+        settingsPath?: readonly string[];
+    }[];
+    discoverModels(ns: string, request: {
+        provider?: string;
+        baseURL?: string;
+        api?: string;
+        apiKey?: string;
+        signal?: AbortSignal;
+    }): Promise<ReadonlyArray<{
+        id: string;
+        name?: string;
+        contextWindow?: number;
+        maxTokens?: number;
+    }>>;
+};
+/** Credential-state snapshot as returned by `credentials.describe(ref)` (§4.2 badges). Nullish-tolerant at the call site. */
+export type CredentialState = {
+    configured: boolean;
+    source?: 'env' | 'managed' | (string & {});
+    writable?: boolean;
+};
+/** Duck-typed credentials-store seam (C4): describe/set/unset one ref. */
+export type CredentialsLike = {
+    describe(ref: string): Promise<{
+        configured: boolean;
+        source?: 'env' | 'managed' | (string & {});
+        writable?: boolean;
+    } | undefined>;
+    set(ref: string, value: string): Promise<void>;
+    unset(ref: string): Promise<void>;
+};
+/** One entry of the configurable-provider directory (C8 `listConfigurableProviders()`). */
+export type DirectoryEntry = {
+    provider: string;
+    displayName?: string;
+    settingsNs?: string;
+    settingsPath?: readonly string[];
+};
+export type CredentialBadge = 'managed' | 'env' | 'missing';
+/** One presentation-ready row of the `/provider` list overlay (§4.2). */
+export type ProviderRow = {
+    route: string;
+    displayName: string;
+    section: 'configured' | 'available';
+    isCurrent: boolean;
+    modelCount: number;
+    credential?: {
+        badge: CredentialBadge;
+        warning: boolean;
+        writable?: boolean;
+    };
+};
+/** Directory tail collapsed under "More providers…" (§4.2 merge rule). */
+export type MoreProviderRow = {
+    provider: string;
+    displayName: string;
+    entry: DirectoryEntry;
+};
+/** The two-section list state for the overlay home screen. */
+export type ProviderList = {
+    configured: ProviderRow[];
+    available: ProviderRow[];
+    more: MoreProviderRow[];
+};
+export type BuildProviderRowsInput = {
+    /** Live `llm-pi-ai.providers` dict, verbatim (document order preserved). */
+    configured: Record<string, unknown>;
+    directory: readonly DirectoryEntry[];
+    presets?: readonly ProviderPreset[];
+    /** Credential-state snapshots keyed by credential ref. */
+    credentialStates: Record<string, CredentialState>;
+    currentProvider?: string;
+};
+/**
+ * §4.2 merge rule (review M2), stated exactly: Configured = the live providers
+ * dict, verbatim, in document order. Available = presets whose route is not
+ * configured ∪ directory entries that are neither configured nor preset-covered,
+ * the latter collapsed into the `more` tail. A route never appears in both
+ * sections; a configured route never appears in Available.
+ */
+export declare function buildProviderRows(input: BuildProviderRowsInput): ProviderList;
+/**
+ * Normalize a user-typed route id to `^[a-z0-9][a-z0-9-]*$` (§4.6): lowercase,
+ * invalid runs collapse to `-`, leading/trailing `-` stripped. Returns null
+ * when nothing usable remains.
+ */
+export declare function normalizeRouteId(input: string): string | null;
+/** Which existing source already claims `routeId`, if any (§4.6 collision check). */
+export declare function routeCollision(routeId: string, { configured, presets, directory }: {
+    configured: Record<string, unknown>;
+    presets: readonly ProviderPreset[];
+    directory: readonly DirectoryEntry[];
+}): 'configured' | 'preset' | 'directory' | null;
+/** JSON payload for `llm-pi-ai.providers.<route>` from a preset — the preset's deltas, deep-copied. */
+export declare function materializeProfile(preset: ProviderPreset): {
+    api?: string;
+    baseURL?: string;
+    models?: {
+        id: string;
+        name: string;
+    }[];
+};
+export type CustomProfileInput = {
+    routeId: string;
+    displayName: string;
+    baseURL: string;
+    api: string;
+    models?: {
+        id: string;
+        name?: string;
+        contextWindow?: number;
+        maxTokens?: number;
+    }[];
+};
+/** JSON payload for a fully custom route (§4.6); throws on a non-absolute http(s) baseURL. */
+export declare function materializeCustomProfile(input: CustomProfileInput): {
+    api: string;
+    baseURL: string;
+    models?: CustomProfileInput['models'];
+};
+export type ParsedModel = {
+    id: string;
+    name?: string;
+    contextWindow?: number;
+    maxTokens?: number;
+};
+/**
+ * Compact wizard model entry (§4.6): entries separated by newlines or commas;
+ * each entry `id` | `id|Display Name` | `id|Display Name|contextWindow|maxTokens`.
+ * Returns per-entry errors so the wizard shows problems without inventing data.
+ */
+export declare function parseModelList(text: string): {
+    models: ParsedModel[];
+    errors: string[];
+};
+export type VerifyProbeAnswers = {
+    baseURL?: string | undefined;
+    api?: string | undefined;
+    apiKey?: string | undefined;
+    provider?: string | undefined;
+};
+/** Result of the detail-view refresh resolution: a draft probe, or why not. */
+export type RefreshProbe = {
+    ok: true;
+    baseURL: string;
+    api: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * §8-S2 "refresh list" resolution: the detail action probes the route's
+ * effective endpoint — profile.baseURL/api, else the preset's probe endpoint
+ * when the route is a preset with a non-null probe. Unresolved endpoints and
+ * non-listable protocols (everything outside LISTABLE_APIS, doc §2/C5) return
+ * an explanatory reason instead of a probe.
+ */
+export declare function refreshProbeFor(profile: Record<string, unknown>, preset: ProviderPreset | undefined): RefreshProbe;
+/**
+ * Build the §4.3 step-2 draft-form discovery probe request, or null when the
+ * protocol is not listable or the baseURL is unknown. NEVER includes
+ * `provider` — that form answers from the catalog without touching the network
+ * (doc §2/C5, review Blocker B1).
+ */
+export declare function verifyProbeFor(presetOrAnswers: ProviderPreset | VerifyProbeAnswers): {
+    baseURL: string;
+    api: string;
+    apiKey?: string;
+} | null;
+//# sourceMappingURL=provider-flow.d.ts.map

package/lib/provider-flow.d.ts.map

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

package/lib/provider-flow.js

@@ -0,0 +1,192 @@
+import { PRESETS, presetByRoute, deriveCredentialRef } from "./provider-presets.js";
+function credentialRefFor(route) {
+    return presetByRoute(route)?.credentialRef ?? deriveCredentialRef(route);
+}
+function badgeFor(route, input) {
+    const ref = credentialRefFor(route);
+    const state = input.credentialStates[ref];
+    if (state === undefined || !state.configured) {
+        return { badge: 'missing', warning: false };
+    }
+    const badge = state.source === 'env' ? 'env' : 'managed';
+    const credential = { badge, warning: false };
+    if (state.writable !== undefined)
+        credential.writable = state.writable;
+    return credential;
+}
+/**
+ * §4.2 merge rule (review M2), stated exactly: Configured = the live providers
+ * dict, verbatim, in document order. Available = presets whose route is not
+ * configured ∪ directory entries that are neither configured nor preset-covered,
+ * the latter collapsed into the `more` tail. A route never appears in both
+ * sections; a configured route never appears in Available.
+ */
+export function buildProviderRows(input) {
+    const presets = input.presets ?? PRESETS;
+    const configuredRoutes = Object.keys(input.configured);
+    const presetRoutes = new Set(presets.map((p) => p.route));
+    const configured = configuredRoutes.map((route) => {
+        const section = input.configured[route];
+        const modelCount = Array.isArray(section?.models) ? section.models.length : 0;
+        const credential = badgeFor(route, input);
+        const warning = modelCount > 0 && credential.badge === 'missing';
+        return {
+            route,
+            displayName: presetByRoute(route)?.displayName ?? route,
+            section: 'configured',
+            isCurrent: input.currentProvider === route,
+            modelCount,
+            credential: { ...credential, warning },
+        };
+    });
+    const configuredSet = new Set(configuredRoutes);
+    const available = presets
+        .filter((p) => !configuredSet.has(p.route))
+        .map((p) => ({
+        route: p.route,
+        displayName: p.displayName,
+        section: 'available',
+        isCurrent: false,
+        modelCount: 0,
+    }));
+    const more = input.directory
+        .filter((entry) => !configuredSet.has(entry.provider) && !presetRoutes.has(entry.provider))
+        .map((entry) => ({ provider: entry.provider, displayName: entry.displayName ?? entry.provider, entry }));
+    return { configured, available, more };
+}
+/**
+ * Normalize a user-typed route id to `^[a-z0-9][a-z0-9-]*$` (§4.6): lowercase,
+ * invalid runs collapse to `-`, leading/trailing `-` stripped. Returns null
+ * when nothing usable remains.
+ */
+export function normalizeRouteId(input) {
+    const id = input
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/-{2,}/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return id.length > 0 ? id : null;
+}
+/** Which existing source already claims `routeId`, if any (§4.6 collision check). */
+export function routeCollision(routeId, { configured, presets, directory }) {
+    if (Object.hasOwn(configured, routeId))
+        return 'configured';
+    if (presets.some((p) => p.route === routeId))
+        return 'preset';
+    if (directory.some((d) => d.provider === routeId))
+        return 'directory';
+    return null;
+}
+/** JSON payload for `llm-pi-ai.providers.<route>` from a preset — the preset's deltas, deep-copied. */
+export function materializeProfile(preset) {
+    const models = preset.profile.models?.map((m) => ({ ...m }));
+    return {
+        ...(preset.profile.api !== undefined ? { api: preset.profile.api } : {}),
+        ...(preset.profile.baseURL !== undefined ? { baseURL: preset.profile.baseURL } : {}),
+        ...(models !== undefined ? { models } : {}),
+    };
+}
+/** JSON payload for a fully custom route (§4.6); throws on a non-absolute http(s) baseURL. */
+export function materializeCustomProfile(input) {
+    let parsed;
+    try {
+        parsed = new URL(input.baseURL);
+    }
+    catch {
+        throw new Error(`route ${input.routeId}: baseURL must be an absolute http(s) URL`);
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new Error(`route ${input.routeId}: baseURL must be an absolute http(s) URL`);
+    }
+    return {
+        api: input.api,
+        baseURL: input.baseURL,
+        ...(input.models !== undefined && input.models.length > 0 ? { models: input.models.map((m) => ({ ...m })) } : {}),
+    };
+}
+/**
+ * Compact wizard model entry (§4.6): entries separated by newlines or commas;
+ * each entry `id` | `id|Display Name` | `id|Display Name|contextWindow|maxTokens`.
+ * Returns per-entry errors so the wizard shows problems without inventing data.
+ */
+export function parseModelList(text) {
+    const models = [];
+    const errors = [];
+    for (const raw of text.split(/\r?\n|,/)) {
+        const entry = raw.trim();
+        if (entry === '')
+            continue;
+        const fields = entry.split('|').map((f) => f.trim());
+        const id = fields[0] ?? '';
+        const name = fields[1];
+        const contextWindow = fields[2];
+        const maxTokens = fields[3];
+        const extra = fields.slice(4);
+        if (id === '' || /\s/.test(id)) {
+            errors.push(`"${entry}": model id is empty or contains whitespace`);
+            continue;
+        }
+        if (extra.length > 0) {
+            errors.push(`"${entry}": too many fields (expected id|name|contextWindow|maxTokens)`);
+            continue;
+        }
+        const model = { id };
+        if (name !== undefined && name !== '')
+            model.name = name;
+        if (contextWindow !== undefined && contextWindow !== '') {
+            const n = Number(contextWindow);
+            if (!Number.isInteger(n) || n <= 0) {
+                errors.push(`"${entry}": contextWindow must be a positive integer`);
+                continue;
+            }
+            model.contextWindow = n;
+        }
+        if (maxTokens !== undefined && maxTokens !== '') {
+            const n = Number(maxTokens);
+            if (!Number.isInteger(n) || n <= 0) {
+                errors.push(`"${entry}": maxTokens must be a positive integer`);
+                continue;
+            }
+            model.maxTokens = n;
+        }
+        models.push(model);
+    }
+    return { models, errors };
+}
+/** Protocols whose `/models` listing is supported by discovery (C5); everything else is DISCOVERY_UNSUPPORTED. */
+const LISTABLE_APIS = new Set(['openai-completions', 'openai-responses']);
+/**
+ * §8-S2 "refresh list" resolution: the detail action probes the route's
+ * effective endpoint — profile.baseURL/api, else the preset's probe endpoint
+ * when the route is a preset with a non-null probe. Unresolved endpoints and
+ * non-listable protocols (everything outside LISTABLE_APIS, doc §2/C5) return
+ * an explanatory reason instead of a probe.
+ */
+export function refreshProbeFor(profile, preset) {
+    const profileBase = typeof profile.baseURL === 'string' && profile.baseURL !== '' ? profile.baseURL : undefined;
+    const profileApi = typeof profile.api === 'string' && profile.api !== '' ? profile.api : undefined;
+    const baseURL = profileBase ?? preset?.probe?.baseURL;
+    const api = profileApi ?? preset?.probe?.api;
+    if (baseURL === undefined || api === undefined) {
+        return { ok: false, reason: 'No probeable endpoint is known for this route — set baseURL and api in the profile to enable a refresh.' };
+    }
+    if (!LISTABLE_APIS.has(api)) {
+        return { ok: false, reason: `The ${api} protocol can't be listed programmatically — the first message is the test.` };
+    }
+    return { ok: true, baseURL, api };
+}
+/**
+ * Build the §4.3 step-2 draft-form discovery probe request, or null when the
+ * protocol is not listable or the baseURL is unknown. NEVER includes
+ * `provider` — that form answers from the catalog without touching the network
+ * (doc §2/C5, review Blocker B1).
+ */
+export function verifyProbeFor(presetOrAnswers) {
+    const preset = presetOrAnswers;
+    const source = 'probe' in presetOrAnswers && preset.probe !== undefined ? preset.probe : presetOrAnswers;
+    if (source === null || source.baseURL === undefined || source.api === undefined || !LISTABLE_APIS.has(source.api))
+        return null;
+    const apiKey = presetOrAnswers instanceof Object && 'apiKey' in presetOrAnswers ? presetOrAnswers.apiKey : undefined;
+    return { baseURL: source.baseURL, api: source.api, ...(apiKey !== undefined && apiKey !== '' ? { apiKey } : {}) };
+}
+//# sourceMappingURL=provider-flow.js.map

package/lib/provider-flow.js.map

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

package/lib/provider-presets.d.ts

@@ -0,0 +1,32 @@
+/** Built-in `/provider` presets — pure data (design doc §4.5, docs/plans/2026-09-05-provider-management.md). */
+export type PresetGroup = 'kimi' | 'zhipu-zai' | 'deepseek';
+export interface CuratedModel {
+    id: string;
+    name: string;
+}
+export interface ProviderPreset {
+    /** Settings dict key under `llm-pi-ai.providers.<route>`. */
+    route: string;
+    displayName: string;
+    group: PresetGroup;
+    /** Credential store ref for the preset's API key. */
+    credentialRef: string;
+    /** Public vendor docs URL. */
+    docsUrl: string;
+    /** Minimal profile payload written into `llm-pi-ai.providers.<route>` (empty = catalog-complete, C7). */
+    profile: {
+        api?: string;
+        baseURL?: string;
+        models?: CuratedModel[];
+    };
+    /** Draft-form discovery probe endpoint (C5); null when the protocol is not listable. */
+    probe: {
+        baseURL: string;
+        api: string;
+    } | null;
+}
+export declare const PRESETS: ProviderPreset[];
+export declare function presetByRoute(route: string): ProviderPreset | undefined;
+/** Custom-provider default credential ref: `DSH_PROVIDER_` + uppercased route with non-alphanumerics mapped to `_`. */
+export declare function deriveCredentialRef(routeId: string): string;
+//# sourceMappingURL=provider-presets.d.ts.map

package/lib/provider-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-presets.d.ts","sourceRoot":"","sources":["../src/provider-presets.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAEhH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;AAE3D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,WAAW,CAAA;IAClB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,yGAAyG;IACzG,OAAO,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;KACxB,CAAA;IACD,wFAAwF;IACxF,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC/C;AAaD,eAAO,MAAM,OAAO,EAAE,cAAc,EAiFnC,CAAA;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvE;AAED,uHAAuH;AACvH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM3D"}

package/lib/provider-presets.js

@@ -0,0 +1,105 @@
+/** Built-in `/provider` presets — pure data (design doc §4.5, docs/plans/2026-09-05-provider-management.md). */
+/** Curated GLM list (§4.5), seeded from ids proven against these very endpoints. */
+const GLM_MODELS = [
+    { id: 'glm-5.3', name: 'GLM-5.3' },
+    { id: 'glm-5v-turbo', name: 'GLM-5V-TURBO' },
+    { id: 'glm-5.2', name: 'GLM-5.2' },
+    { id: 'glm-5.1', name: 'GLM-5.1' },
+    { id: 'glm-5-turbo', name: 'GLM-5-TURBO' },
+    { id: 'glm-4.7', name: 'GLM-4.7' },
+    { id: 'glm-4.5-air', name: 'GLM-4.5-AIR' },
+];
+export const PRESETS = [
+    {
+        route: 'kimi-coding',
+        displayName: 'Kimi Coding Plan',
+        group: 'kimi',
+        credentialRef: 'KIMI_API_KEY',
+        docsUrl: 'https://platform.moonshot.ai/docs/guide/kimi-coding',
+        profile: {},
+        probe: null, // anthropic-messages is not listable (§2/C5)
+    },
+    {
+        route: 'moonshotai',
+        displayName: 'Kimi API (global)',
+        group: 'kimi',
+        credentialRef: 'MOONSHOT_API_KEY',
+        docsUrl: 'https://platform.moonshot.ai/docs',
+        profile: {},
+        probe: { baseURL: 'https://api.moonshot.ai/v1', api: 'openai-completions' },
+    },
+    {
+        route: 'moonshotai-cn',
+        displayName: 'Kimi API (CN)',
+        group: 'kimi',
+        credentialRef: 'MOONSHOT_API_KEY',
+        docsUrl: 'https://platform.moonshot.cn/docs',
+        profile: {},
+        probe: { baseURL: 'https://api.moonshot.cn/v1', api: 'openai-completions' },
+    },
+    {
+        route: 'zai',
+        displayName: 'Z.AI Coding Plan (global)',
+        group: 'zhipu-zai',
+        credentialRef: 'ZAI_API_KEY',
+        docsUrl: 'https://docs.z.ai/',
+        profile: {},
+        probe: { baseURL: 'https://api.z.ai/api/coding/paas/v4', api: 'openai-completions' },
+    },
+    {
+        route: 'zai-coding-cn',
+        displayName: 'Zhipu Coding Plan (CN)',
+        group: 'zhipu-zai',
+        credentialRef: 'ZAI_CODING_CN_API_KEY',
+        docsUrl: 'https://docs.bigmodel.cn/cn/coding-plan',
+        profile: {},
+        probe: { baseURL: 'https://open.bigmodel.cn/api/coding/paas/v4', api: 'openai-completions' },
+    },
+    {
+        route: 'deepseek',
+        displayName: 'DeepSeek API',
+        group: 'deepseek',
+        credentialRef: 'DEEPSEEK_API_KEY',
+        docsUrl: 'https://api-docs.deepseek.com/',
+        profile: {},
+        probe: { baseURL: 'https://api.deepseek.com', api: 'openai-completions' },
+    },
+    {
+        route: 'zai-api',
+        displayName: 'Z.AI API (global, pay-as-you-go)',
+        group: 'zhipu-zai',
+        credentialRef: 'ZAI_API_KEY',
+        docsUrl: 'https://docs.z.ai/guides/overview/pricing',
+        profile: {
+            api: 'openai-completions',
+            baseURL: 'https://api.z.ai/api/paas/v4',
+            models: GLM_MODELS,
+        },
+        probe: { baseURL: 'https://api.z.ai/api/paas/v4', api: 'openai-completions' },
+    },
+    {
+        route: 'zhipu-api',
+        displayName: 'Zhipu API (CN, pay-as-you-go)',
+        group: 'zhipu-zai',
+        credentialRef: 'ZHIPU_API_KEY',
+        docsUrl: 'https://docs.bigmodel.cn/cn/guide/start/pricing',
+        profile: {
+            api: 'openai-completions',
+            baseURL: 'https://open.bigmodel.cn/api/paas/v4',
+            models: GLM_MODELS,
+        },
+        probe: { baseURL: 'https://open.bigmodel.cn/api/paas/v4', api: 'openai-completions' },
+    },
+];
+export function presetByRoute(route) {
+    return PRESETS.find((p) => p.route === route);
+}
+/** Custom-provider default credential ref: `DSH_PROVIDER_` + uppercased route with non-alphanumerics mapped to `_`. */
+export function deriveCredentialRef(routeId) {
+    const suffix = routeId
+        .toUpperCase()
+        .replace(/[^A-Z0-9]/g, '_')
+        .replace(/_{2,}/g, '_');
+    return `DSH_PROVIDER_${suffix}_API_KEY`;
+}
+//# sourceMappingURL=provider-presets.js.map

package/lib/provider-presets.js.map

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

package/lib/provider-read.d.ts

@@ -0,0 +1,63 @@
+/**
+ * `/provider` read paths (design doc docs/plans/2026-09-05-provider-
+ * management.md §4.1–§4.2): settings reads, credential-state snapshots, the
+ * configurable-provider directory, argument parsing, and the chat-output list
+ * renderer. Split out of provider-command.ts purely for line budget.
+ * @module @dsh-cc/tui/provider-command-read
+ */
+import { type CredentialState, type CredentialsLike, type DirectoryEntry, type LlmManageLike, type ProviderList } from './provider-flow.ts';
+/** Settings namespace carrying the provider profiles (doc D1/D2). */
+export declare const PROVIDER_SETTINGS_NAMESPACE = "llm-pi-ai";
+/** Usage line for unknown/unsupported subcommands (§4.1 — never silent). */
+export declare const PROVIDER_USAGE = "Usage: /provider [list | add <preset-id> | remove <route>]";
+/**
+ * Duck-typed seam for the settings provider. Only `describe` is needed on the
+ * read path: descriptors carry `{ns, user, revision}` (the pattern
+ * driver-approvals.writeAllowRule consumes).
+ */
+export type SettingsDescribeLike = {
+    describe?: () => ReadonlyArray<{
+        ns?: unknown;
+        user?: unknown;
+        revision?: unknown;
+    }>;
+};
+/**
+ * Read the `llm-pi-ai` section's user-layer `providers` dict (§4.2). The
+ * service may be absent, the namespace unregistered, or the stored shape
+ * junk — every degradation returns `{}` so the overlay renders honestly.
+ */
+export declare function readConfiguredProviders(settings: SettingsDescribeLike | undefined): Record<string, unknown>;
+/**
+ * Credential-state snapshots for each ref (§4.2 badges). Tolerant of an
+ * absent service and a throwing `describe` — a failed describe is an unknown
+ * state, rendered as unconfigured, never an overlay crash.
+ */
+export declare function credentialStates(credentials: CredentialsLike | undefined, refs: readonly string[]): Promise<Record<string, CredentialState>>;
+/**
+ * Configurable-provider directory (C8). Absent service or junk entries
+ * degrade to `[]`; throwing discovery degrades to `[]` too.
+ */
+export declare function loadDirectory(llm: LlmManageLike | undefined): DirectoryEntry[];
+/** Parsed `/provider …` invocation (§4.1). */
+export type ParsedProviderArgs = {
+    kind: 'open';
+} | {
+    kind: 'list';
+} | {
+    kind: 'add';
+    route: string;
+} | {
+    kind: 'remove';
+    route: string;
+} | {
+    kind: 'invalid';
+};
+/** Subcommand table per §4.1: bare, list, add/remove with a required id. */
+export declare function parseProviderArgs(rest: string): ParsedProviderArgs;
+/**
+ * §4.1 `/provider list` — plain-text rendering of the same two-section data
+ * the overlay shows (script-friendly chat output).
+ */
+export declare function renderProviderList(list: ProviderList): string;
+//# sourceMappingURL=provider-read.d.ts.map

package/lib/provider-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-read.d.ts","sourceRoot":"","sources":["../src/provider-read.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAA;AAE3B,qEAAqE;AACrE,eAAO,MAAM,2BAA2B,cAAc,CAAA;AAEtD,4EAA4E;AAC5E,eAAO,MAAM,cAAc,+DAA+D,CAAA;AAE1F;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,MAAM,aAAa,CAAC;QAAE,EAAE,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CACrF,CAAA;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqB3G;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,eAAe,GAAG,SAAS,EACxC,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAa1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,GAAG,cAAc,EAAE,CAU9E;AAED,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvB,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAYlE;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAe7D"}