@deepseek-ai/dsh-client-ui-settings-models 0.2.1-alpha.2 → 0.2.1-alpha.4

package/lib/types/client/ApiKeyInput.d.ts

@@ -0,0 +1,17 @@
+import type { InputHTMLAttributes, ReactNode } from 'react';
+import type { en } from './locales.ts';
+/** Input attributes and section copy for the current credential draft. */
+interface ApiKeyInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'type' | 'className' | 'autoComplete'> {
+    /** Unsaved input; stored credentials are never read into this field. */
+    readonly value: string;
+    /** Section copy, including the same reveal labels as SecretText. */
+    readonly t: (key: keyof typeof en) => string;
+}
+/**
+ * Reveal only a nonempty draft; a different value starts masked, as in SecretText.
+ * @param props - current draft, input attributes, and translated control labels.
+ * @returns a password input with an optional reveal button.
+ */
+export declare function ApiKeyInput({ value, t, ...props }: ApiKeyInputProps): ReactNode;
+export {};
+//# sourceMappingURL=ApiKeyInput.d.ts.map

package/lib/types/client/CustomProviderCard.d.ts

@@ -17,11 +17,12 @@
  * and at least one model — are required here rather than at load, so the
  * failure names the field while the user is still looking at it.
  *
- * There is deliberately no reasoning-effort control, here or on the editor
- * card: effort is a per-MODEL capability, and the models under one provider
- * disagree about it, so a provider-scoped control can only be set to a value
- * some of them reject. The composer's model picker offers each model its own
- * levels instead.
+ * There is deliberately no provider-scoped reasoning-effort control, here or
+ * on the editor card: effort is a per-MODEL capability, and the models under
+ * one provider disagree about it, so a provider-scoped control can only be set
+ * to a value some of them reject. Each model row of a hand-declared route
+ * declares its own `reasoningEfforts` instead, and the composer's model picker
+ * offers each model those levels.
  */
 import type { ReactNode } from 'react';
 import type { ModelsOperations } from './operations.ts';
@@ -32,6 +33,8 @@ export interface CustomProviderCardProps {
     taken: readonly string[];
     /** Wire protocols the adapter can serve, in the order it reports them. */
     protocols: readonly string[];
+    /** Reasoning levels the adapter's schema accepts, in escalation order; empty shows no reasoning control. */
+    reasoningLevels: readonly string[];
     /**
      * Revision of the `llm-pi-ai` user section this card opened at, sent with
      * the create so a route another tab declared meanwhile is a refusal rather

package/lib/types/client/ModelListEditor.d.ts

@@ -45,6 +45,12 @@ export interface ModelListEditorProps {
     models: readonly ModelDraft[];
     /** Installed provider whose catalog supplies defaults without endpoint I/O. */
     catalogProvider?: string | undefined;
+    /**
+     * Reasoning levels a hand-declared route's rows may declare in
+     * `reasoningEfforts`, in escalation order; absent or empty shows no
+     * reasoning control, leaving a catalog model's levels to the catalog.
+     */
+    reasoningLevels?: readonly string[] | undefined;
     /** Route input types for models absent from the installed catalog. */
     defaultInput?: readonly string[] | undefined;
     /** Whether the user layer currently owns the whole array; absent on a create. */

package/lib/types/client/ModelReasoningEfforts.d.ts

@@ -0,0 +1,43 @@
+/** Reasoning-level declarations for a model on a hand-declared pi-ai route. */
+import type { ReactNode } from 'react';
+import type { DeepSeekModelDraft } from './DeepSeekModelsEditor.tsx';
+import type { ModelsKey } from './locales.ts';
+/** A reasoning-level failure the Models cards name by row. */
+export interface ReasoningEffortsFailure {
+    /** Zero-based model position. */
+    index: number;
+    /** Message key owned by the Models settings section. */
+    key: 'modelReasoningValueRequired' | 'modelReasoningNeedsLevel';
+}
+/**
+ * Mirror the pi-ai refusals of a hand-declared `reasoningEfforts`, so a card
+ * names the row instead of failing at the write.
+ * @param value - drafted `models` value, or `undefined` while inherited.
+ * @returns the first refused row, or `undefined` when the adapter will accept every row.
+ */
+export declare function validateReasoningEfforts(value: unknown): ReasoningEffortsFailure | undefined;
+/** Props of {@link ModelReasoningEfforts}. */
+interface ModelReasoningEffortsProps {
+    /** Effective model row, including fields outside the curated editor. */
+    model: DeepSeekModelDraft;
+    /** Levels the adapter's schema accepts as `reasoningEfforts` keys, in escalation order. */
+    levels: readonly string[];
+    /** One-based row position for accessible names. */
+    position: number;
+    /** Prevent changes while read-only or saving. */
+    disabled: boolean;
+    /** Section copy. */
+    t: (key: ModelsKey) => string;
+    /** Replace this row, preserving unrelated configuration. */
+    onChange: (model: DeepSeekModelDraft) => void;
+}
+/**
+ * Edit the `reasoningEfforts` a hand-declared pi-ai model offers: a switch,
+ * then one row per level pairing the level with the value sent for it. Every
+ * row is read from the model, so a reused instance shows its new model.
+ * @param props - model declaration and row replacement action.
+ * @returns the reasoning-level group.
+ */
+export declare function ModelReasoningEfforts({ model, levels, position, disabled, t, onChange }: ModelReasoningEffortsProps): ReactNode;
+export {};
+//# sourceMappingURL=ModelReasoningEfforts.d.ts.map

package/lib/types/client/ModelRow.d.ts

@@ -16,6 +16,8 @@ interface ModelRowProps {
     inputField: 'inputModalities' | 'input';
     inputFallback?: readonly string[] | undefined;
     inputLoading?: boolean;
+    /** Levels the row's `reasoningEfforts` may declare; absent or empty shows no reasoning control. */
+    reasoningLevels?: readonly string[] | undefined;
     expanded: boolean;
     disabled: boolean;
     t: (key: ModelsKey) => string;

package/lib/types/client/ProviderEditor.d.ts

@@ -21,7 +21,7 @@
  * see instead of rebuilding the whole subtree from a partial descriptor.
  */
 import type { ReactNode } from 'react';
-import type { SettingsNamespaceView, SettingsPathOpView } from '@deepseek-ai/dsh-api-remotes/client';
+import type { CredentialInfo, LlmNativeAuth, SettingsNamespaceView, SettingsPathOpView } from '@deepseek-ai/dsh-api-remotes/client';
 import type { ModelsOperations } from './operations.ts';
 import type { SettingsSchemaOperations } from './schema-operations.ts';
 import type { en } from './locales.ts';
@@ -49,6 +49,16 @@ export interface ProviderEditorProps {
     settingsPath: readonly string[];
     /** The Host operations this card writes and interrogates through. */
     operations: ModelsOperations;
+    /** Endpoint the route uses when its profile sets no `baseURL`; absent when the adapter reports none. */
+    defaultBaseURL?: string;
+    /** Environment variables used by the provider to construct its endpoint. */
+    baseURLEnv?: readonly string[];
+    /** Authentication the route performs when its profile names no credential reference; absent when the adapter reports none. */
+    nativeAuth?: LlmNativeAuth;
+    /** Redacted state of the profile's named credential reference, from the page snapshot. */
+    credential?: CredentialInfo;
+    /** Redacted checks for the profile's named reference or the provider's native variables. */
+    credentialChecks?: Readonly<Record<string, CredentialInfo>>;
     /** Section copy. */
     t: (key: keyof typeof en) => string;
     /** Disable writes (read-only settings provider). */

package/lib/types/client/WelcomeNotice.d.ts

@@ -7,7 +7,7 @@ import type { en } from './locales.ts';
 /** Registration-side dependencies of {@link WelcomeNotice}. */
 export interface WelcomeNoticeInjected {
     hooks: {
-        /** Durable or process-local acknowledgement state. */
+        /** Durable acknowledgement state. */
         welcome: SnapshotStore<WelcomeNoticeState>;
     };
     /** Welcome acknowledgement controller. */

package/lib/types/client/locales.d.ts

@@ -30,18 +30,29 @@ export declare const en: {
     savedProvider: string;
     credentialConfigured: string;
     credentialMissing: string;
+    accountSignedIn: string;
     readOnly: string;
     loadFailed: string;
     conflict: string;
     retry: string;
     keyInput: string;
+    keyReveal: string;
+    keyHide: string;
     keyPlaceholder: string;
-    keyPlaceholderNative: string;
-    keyStored: string;
-    keyEnvLocked: string;
+    keyPlaceholderFallback: string;
+    keyPlaceholderSaved: string;
+    keyFallbackMissing: string;
+    keyFallbackDetected: string;
+    keyFallbackDetectedHidden: string;
+    keyFallbackUnchecked: string;
+    keyHelp: string;
+    authHelp: string;
     customized: string;
     baseUrl: string;
     baseUrlDefault: string;
+    baseUrlEnvironment: string;
+    baseUrlConfigured: string;
+    baseUrlPlaceholder: string;
     deepSeekBaseUrl: string;
     deepSeekEndpointHint: string;
     models: string;
@@ -60,6 +71,16 @@ export declare const en: {
     modelInputTypes: string;
     modelInputText: string;
     modelInputImage: string;
+    modelReasoning: string;
+    modelReasoningLevel: string;
+    modelReasoningValue: string;
+    modelReasoningHelp: string;
+    modelReasoningHelpText: string;
+    modelReasoningNeedsLevel: string;
+    modelReasoningValueRequired: string;
+    modelReasoningAdd: string;
+    modelReasoningRemove: string;
+    modelReasoningOffValuePlaceholder: string;
     addModel: string;
     removeModel: string;
     modelsEmpty: string;

package/lib/types/client/operations.d.ts

@@ -5,7 +5,7 @@
  * failure codes and Remote namespaces stay in the apply world.
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-import type { CredentialInfo, LlmDiscoveredModel, LlmModelDiscoveryRequest, SettingsNamespaceView, SettingsPathOpView } from '@deepseek-ai/dsh-api-remotes/client';
+import type { LlmDiscoveredModel, LlmModelDiscoveryRequest, SettingsNamespaceView, SettingsPathOpView } from '@deepseek-ai/dsh-api-remotes/client';
 /** What one namespace write answered. */
 export type SettingsWriteOutcome = 
 /** Committed; the view carries the stored user subtree and the new revision. */
@@ -40,12 +40,6 @@ export type ModelDiscoveryOutcome =
 };
 /** The Host operations the Models page and its cards invoke. */
 export interface ModelsOperations {
-    /**
-     * Read one credential reference's state.
-     * @param ref - credential reference name.
-     * @returns the state, or undefined when the reference is unknown or the read was refused.
-     */
-    describeCredential(ref: string): Promise<CredentialInfo | undefined>;
     /**
      * Store one credential literal under its reference.
      * @param ref - credential reference name.

package/lib/types/client/store.d.ts

@@ -7,7 +7,7 @@
  * re-renders from the next describe, pushed or refetched.
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-import type { CredentialInfo, LlmConfigurableProvider, LlmProviderInfo, SettingsNamespaceView } from '@deepseek-ai/dsh-api-remotes/client';
+import type { CredentialInfo, LlmConfigurableProvider, LlmNativeAuth, LlmProviderInfo, SettingsNamespaceView } from '@deepseek-ai/dsh-api-remotes/client';
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { SettingsDescribeFace } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { SettingsSchemaOperations } from './schema-operations.ts';
@@ -19,6 +19,9 @@ export interface ProviderDirectoryEntry {
     readonly settingsPath: readonly string[];
     readonly active: boolean;
     readonly declared?: boolean;
+    readonly defaultBaseURL?: string;
+    readonly baseURLEnv?: readonly string[];
+    readonly nativeAuth?: LlmNativeAuth;
     readonly error?: string;
 }
 /**
@@ -49,6 +52,8 @@ export interface ProviderRow {
      * own derivation rule.
      */
     derivedCredential?: CredentialInfo;
+    /** Redacted checks for named or native references; absent when their read failed. */
+    credentialChecks?: Readonly<Record<string, CredentialInfo>>;
 }
 /** Page snapshot. */
 export interface ModelsSettingsState {
@@ -82,6 +87,16 @@ export declare function deriveKeyRef(provider: string): string;
  * @returns the protocol identifiers, or an empty list when the schema has none.
  */
 export declare function protocolChoices(namespace: SettingsNamespaceView | undefined, schema: SettingsSchemaOperations): string[];
+/**
+ * The reasoning levels a hand-declared route's models may declare, read out of
+ * the owning namespace's own schema for the same reason as
+ * {@link protocolChoices}: the levels the page offers and the keys the
+ * adapter accepts in `reasoningEfforts` come from the same `Config`.
+ * @param namespace - the namespace view whose schema declares the profile shape.
+ * @param schema - settings schema operations.
+ * @returns the levels in the schema's escalation order, or an empty list when the schema has none.
+ */
+export declare function reasoningLevelChoices(namespace: SettingsNamespaceView | undefined, schema: SettingsSchemaOperations): string[];
 /** The models settings page controller (one per settings surface). */
 export declare class ModelsSettingsStore {
     private readonly ctx;

package/lib/types/client/welcome-store.d.ts

@@ -1,8 +1,6 @@
 /**
- * Welcome-notice state derived from the welcome settings scope. The scope is
- * the transport: a loopback browser follows the durable Host section, while a
- * remote browser's memory-mode scope never answers and the acknowledgement
- * stays process-local here.
+ * Welcome-notice state derived from the welcome settings scope: the notice
+ * follows the Host section and records its acknowledgement through it.
  */
 import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
@@ -22,18 +20,13 @@ export type WelcomeSection = Record<string, unknown>;
  * @returns the section object, or an empty one for non-object values.
  */
 export declare function decodeWelcomeSection(section: unknown): WelcomeSection;
-/** Coordinates durable Host acknowledgement or a process-local remote fallback. */
+/** Coordinates the durable Host acknowledgement. */
 export declare class WelcomeNoticeStore {
     private readonly scope;
     /** uSES-safe state source shared by the registered welcome step. */
     readonly store: SnapshotStore<WelcomeNoticeState>;
-    private localAcknowledged;
     private saving;
     private following;
-    /**
-     * @param scope - the welcome settings namespace scope; its memory mode is
-     * what keeps a remote browser process-local.
-     */
     constructor(scope: ConfigForm<WelcomeSection>);
     /**
      * Begin following the bound scope (idempotent) and publish its current answer.
@@ -41,10 +34,10 @@ export declare class WelcomeNoticeStore {
      */
     load(): Promise<void>;
     /**
-     * Persist this copy version, or advance only this process for a remote
-     * browser. Success is judged against the state the write left behind, so a
-     * refused or failed write reports false after its recovery read settles.
-     * @returns true when the selected persistence mode holds the acknowledgement.
+     * Persist this copy version through the scope. Success is judged against the
+     * state the write left behind, so a refused or failed write reports false
+     * after its recovery read settles.
+     * @returns true when the Host holds the acknowledgement.
      */
     acknowledge(): Promise<boolean>;
     /** Stop following the scope. */

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "title": "ui-settings-models"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "模型设置界面",
+    "description": "管理模型服务及其接入配置，并提供相关引导。"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-settings-models",
   "description": "Models settings and shared product-onboarding dialogs over existing settings and credential joins",
-  "version": "0.2.1-alpha.2",
+  "version": "0.2.1-alpha.4",
   "publishConfig": {
     "access": "public"
   },
@@ -23,7 +23,8 @@
       "default": "./lib/client.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "dsh": {
     "client": {
@@ -37,29 +38,29 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.2",
-    "@types/react": "~18.3.1",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.4",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-remote-mock": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-client-product-analytics": "0.2.1-alpha.2"
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-remote-mock": "0.2.1-alpha.4",
+    "@deepseek-ai/dsh-client-product-analytics": "0.2.1-alpha.4"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/client.js",
     "lib/types/**/*.d.ts"