@qilin-agent/client-ui-settings-models 3.1.5 → 3.1.7

package/lib/index.js

@@ -1,6 +1,26 @@
+import z from "@qilin-agent/schemastery";
+//#region lib/types/onboarding-config.js
+/** Public page-bootstrap options shared by the Host and Client halves. */
+/** Validate Host configuration and its public page-bootstrap payload. */
+const Config = z.object({ credentialOnboarding: z.boolean().default(true) });
+/** Page-global key carrying only the public onboarding options. */
+const ONBOARDING_CONFIG_GLOBAL = "__QILIN_MODELS_ONBOARDING__";
+//#endregion
 //#region lib/types/index.js
-/** Host loader entry for the browser implementation exported from `./client`. */
-/** Host plugin body — no host-side behavior for the models settings plugin. */
-function apply() {}
+/** Host configuration and page bootstrap for Models credential onboarding. */
+/**
+* Publish the credential-onboarding choice before browser plugins activate.
+* @param ctx - Host context collecting the page's initialization data.
+* @param config - plugin options with schema defaults applied by the Loader.
+*/
+function apply(ctx, config) {
+	ctx.on("webserver/index-inject", (table) => {
+		table.push({
+			kind: "global",
+			name: ONBOARDING_CONFIG_GLOBAL,
+			value: { credentialOnboarding: config.credentialOnboarding }
+		});
+	});
+}
 //#endregion
-export { apply };
+export { Config, apply };

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
@@ -43,6 +46,11 @@ export interface CustomProviderCardProps {
     readOnly: boolean;
     /** Close the card; `changed` reports whether a provider was created. */
     onClose: (changed: boolean) => void;
+    /**
+     * Called once per change with whether the create or the list's endpoint
+     * interrogation is in flight, so the owner can hold its surface still.
+     */
+    onBusyChange?: (busy: boolean) => void;
 }
 /**
  * Render the custom-provider creation card.

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. */
@@ -68,6 +74,13 @@ export interface ModelListEditorProps {
     t: (key: keyof typeof en) => string;
     /** Disable every control (read-only deployment or a pending write). */
     disabled: boolean;
+    /**
+     * Called once per change with whether an endpoint interrogation is in
+     * flight. The owning card folds it into its own busy state so the surface
+     * around the card — a mode switch, say — can refuse to move while the
+     * answer, and the picker it opens, is still bound for this list.
+     */
+    onBusyChange: (busy: boolean) => void;
 }
 /**
  * Render the model list with its fetch action.

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,16 @@ export interface ProviderEditorProps {
     namespace: SettingsNamespaceView;
     /** Settings-owned synchronous schema and immutable path operations. */
     schema: SettingsSchemaOperations;
+    /** 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>>;
     /** Path from the section root to this provider's profile. */
     settingsPath: readonly string[];
     /** The Host operations this card writes and interrogates through. */
@@ -67,6 +78,14 @@ export interface ProviderEditorProps {
     submitBusyLabelKey?: keyof typeof en;
     /** Close the editor; `changed` reports whether an Apply committed. */
     onClose: (changed: boolean) => void;
+    /** Called on a credential form submission before the save starts. */
+    onSubmitCredential?: () => void;
+    /**
+     * Called once per change with whether the apply or the model list's
+     * endpoint interrogation is in flight, so the owner can hold its surface
+     * still.
+     */
+    onBusyChange?: (busy: boolean) => void;
 }
 /**
  * The minimal path ops carrying `after` over `before`, both as the card sees

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

@@ -1,8 +1,10 @@
 /**
  * Models settings and product-onboarding plugin, browser half. It registers
  * the Models page plus the official-DeepSeek onboarding dialog, whose UI is
- * this package's modal wrapper. The Host settings and credential contracts
- * stay behind their existing wire APIs. Export discipline:
+ * this package's modal wrapper; the dialog registers only when the Host's
+ * published credentialOnboarding choice leaves the API-key step to the
+ * browser. The Host settings and credential contracts stay behind their
+ * existing wire APIs. Export discipline:
  * packages/client/AGENTS.md.
  */
 import type { Context as ClientContext } from '@qilin-agent/kylin';

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

@@ -27,13 +27,23 @@ export declare const en: {
     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;
@@ -52,6 +62,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;
@@ -94,6 +114,7 @@ export declare const en: {
     customBaseUrlInvalid: string;
     customNeedsModels: string;
     customBaseUrlPlaceholder: string;
+    customAnthropicBaseUrlPlaceholder: string;
     settingsPathUnresolvable: string;
     create: string;
     creating: 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 '@qilin-agent/kylin';
-import type { CredentialInfo, LlmDiscoveredModel, LlmModelDiscoveryRequest, SettingsNamespaceView, SettingsPathOpView } from '@qilin-agent/api-remotes/client';
+import type { LlmDiscoveredModel, LlmModelDiscoveryRequest, SettingsNamespaceView, SettingsPathOpView } from '@qilin-agent/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 '@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/lib/types/index.d.ts

@@ -1,4 +1,11 @@
-/** Host loader entry for the browser implementation exported from `./client`. */
-/** Host plugin body — no host-side behavior for the models settings plugin. */
-export declare function apply(): void;
+/** Host configuration and page bootstrap for Models credential onboarding. */
+import type { Context } from '@qilin-agent/kylin';
+import { type Config } from './onboarding-config.ts';
+export { Config } from './onboarding-config.ts';
+/**
+ * Publish the credential-onboarding choice before browser plugins activate.
+ * @param ctx - Host context collecting the page's initialization data.
+ * @param config - plugin options with schema defaults applied by the Loader.
+ */
+export declare function apply(ctx: Context, config: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/onboarding-config.d.ts

@@ -0,0 +1,16 @@
+/** Public page-bootstrap options shared by the Host and Client halves. */
+import z from '@qilin-agent/schemastery';
+/** Onboarding options after schema defaults are applied. */
+export interface Config {
+    /** Offer the browser API-key step when no native shell owns credential onboarding. */
+    credentialOnboarding: boolean;
+}
+/** Validate Host configuration and its public page-bootstrap payload. */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    credentialOnboarding: z<boolean, boolean, "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    credentialOnboarding: z<boolean, boolean, "defined">;
+}>>, "plain">;
+/** Page-global key carrying only the public onboarding options. */
+export declare const ONBOARDING_CONFIG_GLOBAL = "__QILIN_MODELS_ONBOARDING__";
+//# sourceMappingURL=onboarding-config.d.ts.map

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.5",
+  "version": "3.1.7",
   "publishConfig": {
     "access": "public"
   },
@@ -40,22 +40,27 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
+    "@testing-library/react": "^16.3.2",
     "react": "^18.2.0",
-    "@qilin-agent/api-remotes": "3.1.5",
-    "@qilin-agent/remote-mock": "3.1.5",
-    "@qilin-agent/client-store": "3.1.5",
-    "@qilin-agent/client-test-runtime": "3.1.5",
-    "@qilin-agent/client-locale": "3.1.5",
-    "@qilin-agent/client-ui-primitives": "3.1.5",
-    "@qilin-agent/client-ui-settings": "3.1.5",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/client-ui-renderer": "3.1.5",
-    "@qilin-agent/util-values": "3.1.5",
-    "@qilin-agent/client-ui-slots": "3.1.5"
+    "@qilin-agent/remote-mock": "3.1.7",
+    "@qilin-agent/client-locale": "3.1.7",
+    "@qilin-agent/api-remotes": "3.1.7",
+    "@qilin-agent/client-store": "3.1.7",
+    "@qilin-agent/client-test-runtime": "3.1.7",
+    "@qilin-agent/client-ui-primitives": "3.1.7",
+    "@qilin-agent/client-ui-settings": "3.1.7",
+    "@qilin-agent/client-ui-slots": "3.1.7",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/host-webserver": "3.1.7",
+    "@qilin-agent/client-ui-renderer": "3.1.7",
+    "@qilin-agent/util-values": "3.1.7"
+  },
+  "dependencies": {
+    "@qilin-agent/schemastery": "~3.18.5"
   },
   "files": [
     "lib/index.js",