@qilin-agent/client-ui-settings-models 3.1.4 → 3.1.6

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

@@ -14,11 +14,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';
@@ -29,6 +30,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

@@ -11,17 +11,18 @@
  * display name and wire protocol of a pi-ai route the adapter does not ship —
  * the two fields the create card asked that route for, editable here for the
  * same reason).
- * Reasoning effort is deliberately absent: it 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; `settings.yaml` keeps the
- * profile field for a deployment that knows its route. Everything else stays
+ * 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. Everything else stays
  * owned by `settings.yaml`. Profile edits land as minimal `settings.mutate`
  * path ops against the stored section — the card names only the fields it can
  * see instead of rebuilding the whole subtree from a partial descriptor.
  */
 import type { ReactNode } from 'react';
-import type { SettingsNamespaceView, SettingsPathOpView } from '@qilin-agent/api-remotes/client';
+import type { CredentialInfo, LlmNativeAuth, SettingsNamespaceView, SettingsPathOpView } from '@qilin-agent/api-remotes/client';
 import type { ModelsOperations } from './operations.ts';
 import type { SettingsSchemaOperations } from './schema-operations.ts';
 import type { en } from './locales.ts';
@@ -45,6 +46,12 @@ export interface ProviderEditorProps {
     namespace: SettingsNamespaceView;
     /** Settings-owned synchronous schema and immutable path operations. */
     schema: SettingsSchemaOperations;
+    /** 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 checks for the profile's named reference or the provider's native variables. */
+    credentialChecks?: Readonly<Record<string, CredentialInfo>>;
     /** Path from the section root to this provider's profile. */
     settingsPath: readonly string[];
     /** The Host operations this card writes and interrogates through. */

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

@@ -27,13 +27,22 @@ export declare const en: {
     conflict: string;
     retry: string;
     keyInput: string;
+    keyReveal: string;
+    keyHide: string;
     keyPlaceholder: string;
     keyPlaceholderNative: string;
     keyStored: string;
     keyEnvLocked: string;
+    keyPlaceholderSaved: string;
+    keyFallbackMissing: string;
+    keyFallbackDetected: string;
+    keyFallbackDetectedHidden: string;
+    keyFallbackUnchecked: string;
     customized: string;
     baseUrl: string;
     baseUrlDefault: string;
+    baseUrlEnvironment: string;
+    baseUrlConfigured: string;
     deepSeekBaseUrl: string;
     deepSeekEndpointHint: string;
     models: string;
@@ -52,6 +61,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/store.d.ts

@@ -7,7 +7,7 @@
  * re-renders from the next describe, pushed or refetched.
  */
 import type { Context as ClientContext } from '@qilin-agent/kylin';
-import type { CredentialInfo, LlmConfigurableProvider, LlmProviderInfo, SettingsNamespaceView } from '@qilin-agent/api-remotes/client';
+import type { CredentialInfo, LlmConfigurableProvider, LlmNativeAuth, LlmProviderInfo, SettingsNamespaceView } from '@qilin-agent/api-remotes/client';
 import type { SnapshotStore } from '@qilin-agent/client-store';
 import type { SettingsDescribeFace } from '@qilin-agent/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;
 }
 /**
@@ -47,6 +50,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 {
@@ -80,6 +85,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;
@@ -89,6 +104,8 @@ export declare class ModelsSettingsStore {
     readonly store: SnapshotStore<ModelsSettingsState>;
     /** Latest load wins; an older response never overwrites a newer one. */
     private generation;
+    /** Callers follow the current refresh's outcome, including callers whose read was superseded. */
+    private readonly pendingLoads;
     /**
      * @param ctx - the page plugin's context, whose `remote.llm` and
      * `remote.credentials` namespaces carry the directory and credential reads.
@@ -101,11 +118,17 @@ export declare class ModelsSettingsStore {
      * settings answer in parallel, then one batched credential describe over
      * every referenced ref. Provider failure or absence of an initial settings
      * answer keeps the last good rows and surfaces an error; a failed settings
-     * refresh reuses the mirror's held view.
-     * @returns nothing; the snapshot carries the outcome.
+     * refresh reuses the mirror's held view. Concurrent callers resolve only
+     * after the current refresh publishes its ready or error snapshot.
+     * @returns resolution after the current snapshot is published.
+     * @throws the current read's unexpected rejection; superseded rejections are ignored.
      */
     load(): Promise<void>;
-    /** Publish one load's failure text, unless a newer load already took over. */
+    /** Publish one joined answer; stale answers leave the current refresh in charge. */
+    private read;
+    /** Settle callers only while this read still owns the current refresh. */
+    private settleLoads;
+    /** Publish one load's failure text; the caller checked the current generation. */
     private failLoad;
 }
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-settings-models",
   "description": "Models settings and shared product-onboarding dialogs over existing settings and credential joins",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -40,22 +40,22 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@qilin-agent/remote-mock": "3.1.4",
-    "@qilin-agent/api-remotes": "3.1.4",
-    "@qilin-agent/client-locale": "3.1.4",
-    "@qilin-agent/client-test-runtime": "3.1.4",
-    "@qilin-agent/client-store": "3.1.4",
-    "@qilin-agent/client-ui-primitives": "3.1.4",
-    "@qilin-agent/client-ui-settings": "3.1.4",
-    "@qilin-agent/client-ui-slots": "3.1.4",
-    "@qilin-agent/client-ui-renderer": "3.1.4",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/util-values": "3.1.4"
+    "@qilin-agent/remote-mock": "3.1.6",
+    "@qilin-agent/api-remotes": "3.1.6",
+    "@qilin-agent/client-locale": "3.1.6",
+    "@qilin-agent/client-test-runtime": "3.1.6",
+    "@qilin-agent/client-store": "3.1.6",
+    "@qilin-agent/client-ui-primitives": "3.1.6",
+    "@qilin-agent/client-ui-settings": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/client-ui-slots": "3.1.6",
+    "@qilin-agent/util-values": "3.1.6",
+    "@qilin-agent/client-ui-renderer": "3.1.6"
   },
   "files": [
     "lib/index.js",