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

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/CustomProviderCard.d.ts

@@ -46,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

@@ -74,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/ModelRow.d.ts

@@ -2,6 +2,7 @@
 import type { ReactNode } from 'react';
 import type { DeepSeekModelDraft } from './DeepSeekModelsEditor.tsx';
 import type { ModelsKey } from './locales.ts';
+import type { ModelRowOrder } from './useModelRows.ts';
 /** A capacity's editable text and adapter-specific inherited hint. */
 interface CapacityInput {
     value: string;
@@ -12,7 +13,9 @@ interface CapacityInput {
 /** Adapter-owned data and actions for one model row. */
 interface ModelRowProps {
     model: DeepSeekModelDraft;
+    rowKey: number;
     position: number;
+    order: ModelRowOrder;
     inputField: 'inputModalities' | 'input';
     inputFallback?: readonly string[] | undefined;
     inputLoading?: boolean;

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

@@ -46,10 +46,14 @@ 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. */
@@ -74,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

@@ -30,19 +30,20 @@ export declare const en: {
     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;
@@ -73,6 +74,8 @@ export declare const en: {
     modelReasoningOffValuePlaceholder: string;
     addModel: string;
     removeModel: string;
+    reorderModel: string;
+    reorderModelHelp: string;
     modelsEmpty: string;
     keyBlank: string;
     keyBlankNew: string;
@@ -113,6 +116,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/useModelRows.d.ts

@@ -0,0 +1,41 @@
+/** Local model-row identities, disclosures, capacity text, and draft ordering. */
+import type { DeepSeekModelDraft } from './DeepSeekModelsEditor.tsx';
+/** Text fields whose unfinished spelling belongs to one draft row. */
+export type CapacityField = 'contextWindow' | 'maxTokens';
+interface RowState {
+    key: number;
+    expanded: boolean;
+    editing: Map<CapacityField, string>;
+}
+/** Drag state and actions for one model row within its editor. */
+export interface ModelRowOrder {
+    dragging: boolean;
+    target: 'before' | 'after' | undefined;
+    canDrop: boolean;
+    onStart: () => void;
+    onEnd: () => void;
+    onOver: (half: 'before' | 'after') => void;
+    onLeave: () => void;
+    onDrop: (half: 'before' | 'after') => void;
+    onMove: (offset: -1 | 1) => void;
+}
+interface ModelRows {
+    rows: (RowState & {
+        model: DeepSeekModelDraft;
+        order: ModelRowOrder;
+    })[];
+    toggle: (index: number) => void;
+    edit: (index: number, field: CapacityField, text: string | undefined) => void;
+    forget: (removed: ReadonlySet<number>) => void;
+    reset: () => void;
+}
+/**
+ * Keep row state with its model through draft moves and removals.
+ * @param models - current draft array, owned by the provider card.
+ * @param onChange - replaces only that card's draft array.
+ * @param disabled - prevents reordering while the card cannot be edited.
+ * @returns row state and local editing and ordering actions.
+ */
+export declare function useModelRows(models: readonly DeepSeekModelDraft[], onChange: (models: DeepSeekModelDraft[]) => void, disabled: boolean): ModelRows;
+export {};
+//# sourceMappingURL=useModelRows.d.ts.map

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