@deepseek-ai/dsh-client-ui-settings-models 0.1.6-alpha.2 → 0.1.7-alpha.2

package/lib/index.js

@@ -1,6 +1,26 @@
+import z from "@deepseek-ai/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 = "__DSH_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

@@ -3,12 +3,15 @@
  * gateway, a self-hosted server, or a provider newer than the installed
  * catalog.
  *
- * This is a create, not an edit, which is why it is its own card rather than
+ * This is a create, not an edit, which is why it is its own form rather than
  * the provider editor with extra fields: the route id is being *chosen* here,
- * and the settings address does not exist until it is. One `settings.mutate`
- * sets the whole profile at `providers.<route>`; the key travels separately
- * through `credentials/set` under the reference the profile records, exactly as
- * an existing provider's key does.
+ * and the settings address does not exist until it is. It renders as the
+ * custom-API panel of the section's add card; the card's mode switch names it
+ * when both modes are offered, and with the custom mode alone the card shows
+ * this form directly. One `settings.mutate` sets the whole profile at
+ * `providers.<route>`; the key travels separately through `credentials/set`
+ * under the reference the profile records, exactly as an existing provider's
+ * key does.
  *
  * The three fields a hand-declared route cannot default — endpoint, protocol,
  * and at least one model — are required here rather than at load, so the
@@ -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/DeepSeekOnboardingDialog.d.ts

@@ -7,13 +7,15 @@
  */
 import type { ReactNode } from 'react';
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
-import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { InjectFace, PropsRuntime, PropsRenderSlots } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ModelsSettingsState, ModelsSettingsStore } from './store.ts';
 import type { ModelsOperations } from './operations.ts';
 import type { SettingsSchemaOperations } from './schema-operations.ts';
 import type { en } from './locales.ts';
 /** Registration-side dependencies of {@link DeepSeekOnboardingDialog}. */
 export interface DeepSeekOnboardingInjected {
+    /** Whether first-run setup should show automatically. Explicit requests remain available. */
+    automatic: boolean;
     hooks: {
         /** Shared Models-page join state, bound by the slot renderer. */
         models: SnapshotStore<ModelsSettingsState>;
@@ -28,7 +30,7 @@ export interface DeepSeekOnboardingInjected {
     t: (key: keyof typeof en) => string;
 }
 /** Slot owner props plus the feature's injected dependencies. */
-export type DeepSeekOnboardingDialogProps = PropsRuntime<'settings.onboarding'> & InjectFace<DeepSeekOnboardingInjected>;
+export type DeepSeekOnboardingDialogProps = PropsRuntime<'settings.onboarding'> & PropsRenderSlots<'settings.models.sign-in'> & InjectFace<DeepSeekOnboardingInjected>;
 /**
  * Prompt a first-run user for the official DeepSeek credential while no
  * provider can serve requests and that credential is writable.

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

@@ -68,6 +68,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/ModelsSection.d.ts

@@ -5,11 +5,19 @@
  * solid configured or missing dots. A whole-section provider without a
  * configured key renders as its open setup card instead of a row, but only in
  * the first-run posture — no provider on the page can serve requests yet — and
- * only until the user closes that card; the add flow is a card carrying the
- * dormant-provider select. Each card kind owns its own open state, so closing
- * one never discards a draft in another. Every mutation writes through the
- * wire, while a provider removal first requires confirmation; the page
- * re-renders from pushed invalidations or the post-apply reload.
+ * only until the user closes that card. The add flow is one card behind one
+ * button: a mode switch chooses between adopting a dormant directory provider
+ * (the catalog select over the provider editor) and declaring a custom model
+ * API (the create form). A panel mounts the first time its mode is shown and
+ * stays mounted, hidden, while the card is open and its mode stays offered,
+ * so switching modes discards neither draft and an unvisited mode costs
+ * nothing; the switch holds still while either panel has a write or an
+ * endpoint interrogation in flight, since a switch underneath one would
+ * orphan the answer. Each card kind owns its own open state, so closing one
+ * never discards a draft in another. Every
+ * mutation writes through the wire, while a provider removal first requires
+ * confirmation; the page re-renders from pushed invalidations or the
+ * post-apply reload.
  */
 import type { ReactNode } from 'react';
 import type { InjectFace, PropsRenderSlots } from '@deepseek-ai/dsh-client-ui-slots';

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

@@ -14,9 +14,9 @@
  * 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
+ * model picker offers each model its own levels; `cordis.patch.yml` keeps the
  * profile field for a deployment that knows its route. Everything else stays
- * owned by `settings.yaml`. Profile edits land as minimal `settings.mutate`
+ * owned by `cordis.patch.yml`. 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.
  */
@@ -67,6 +67,12 @@ export interface ProviderEditorProps {
     submitBusyLabelKey?: keyof typeof en;
     /** Close the editor; `changed` reports whether an Apply committed. */
     onClose: (changed: boolean) => 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/locales.d.ts

@@ -14,6 +14,13 @@ export declare const en: {
     deleteConfirm: string;
     deleting: string;
     add: string;
+    addMode: string;
+    addCatalog: string;
+    addCustom: string;
+    addCatalogHint: string;
+    addCustomHint: string;
+    addCatalogExhausted: string;
+    addCustomUnavailable: string;
     provider: string;
     close: string;
     cancel: string;
@@ -34,8 +41,7 @@ export declare const en: {
     customized: string;
     baseUrl: string;
     baseUrlDefault: string;
-    deepSeekChatBaseUrl: string;
-    deepSeekMessagesBaseUrl: string;
+    deepSeekBaseUrl: string;
     deepSeekEndpointHint: string;
     models: string;
     modelsInherited: string;
@@ -78,8 +84,6 @@ export declare const en: {
     fetchSelectAll: string;
     fetchDeselectAll: string;
     fetchAdopt: string;
-    customAdd: string;
-    customTitle: string;
     customTag: string;
     customRoute: string;
     customRouteHint: string;
@@ -88,10 +92,14 @@ export declare const en: {
     customDisplayName: string;
     customApi: string;
     customApiUnset: string;
+    protocolOpenAiCompletions: string;
+    protocolOpenAiResponses: string;
+    protocolAnthropicMessages: string;
     customNeedsBaseUrl: string;
     customBaseUrlInvalid: string;
     customNeedsModels: string;
     customBaseUrlPlaceholder: string;
+    customAnthropicBaseUrlPlaceholder: string;
     settingsPathUnresolvable: string;
     create: string;
     creating: string;

package/lib/types/client/protocol-label.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Product names for the wire protocols a pi-ai route may speak. The pickers
+ * show these instead of the schema identifiers (`openai-completions`), which
+ * are what `settings.yaml` carries and what the option values stay.
+ */
+import type { ModelsKey } from './locales.ts';
+/**
+ * The picker text for one protocol identifier.
+ * @param t - section copy.
+ * @param protocol - the schema identifier of the protocol.
+ * @returns the product name this page knows the protocol by; a protocol the
+ * adapter adds before this page names it shows its identifier, the spelling
+ * `settings.yaml` needs anyway.
+ */
+export declare function protocolLabel(t: (key: ModelsKey) => string, protocol: string): string;
+//# sourceMappingURL=protocol-label.d.ts.map

package/lib/types/client/slot-contract.d.ts

@@ -32,6 +32,15 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
             scope: 'root';
             owner: ProviderCardExtrasOwnerProps;
         };
+        /** Optional account login choice before the credential editor. */
+        'settings.models.sign-in': {
+            kind: 'single';
+            scope: 'root';
+            owner: {
+                complete: () => void;
+                useApiKey: () => void;
+            };
+        };
         /**
          * Ordered extension area after the provider rows and the add controls.
          * Without a registrant the area renders nothing.

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

@@ -5,7 +5,7 @@
  * stays process-local here.
  */
 import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
-import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 /** State rendered by the welcome step. */
 export interface WelcomeNoticeState {
     status: 'idle' | 'loading' | 'ready' | 'saving' | 'error';
@@ -34,7 +34,7 @@ export declare class WelcomeNoticeStore {
      * @param scope - the welcome settings namespace scope; its memory mode is
      * what keeps a remote browser process-local.
      */
-    constructor(scope: SettingsScope<WelcomeSection>);
+    constructor(scope: ConfigForm<WelcomeSection>);
     /**
      * Begin following the bound scope (idempotent) and publish its current answer.
      * @returns settlement after the current answer is published.

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 '@deepseek-ai/cordis';
+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,12 @@
+/** Public page-bootstrap options shared by the Host and Client halves. */
+import z from '@deepseek-ai/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<Partial<Config>, Config>;
+/** Page-global key carrying only the public onboarding options. */
+export declare const ONBOARDING_CONFIG_GLOBAL = "__DSH_MODELS_ONBOARDING__";
+//# sourceMappingURL=onboarding-config.d.ts.map

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

@@ -1,5 +1,5 @@
 /** Durable settings namespace for product-wide GUI onboarding facts. */
-export declare const WELCOME_NOTICE_SETTINGS_NAMESPACE = "ui-onboarding";
+export declare const WELCOME_NOTICE_SETTINGS_NAMESPACE = "ui-settings-general";
 /** Field storing the last welcome notice version the user acknowledged. */
 export declare const WELCOME_NOTICE_ACK_FIELD = "welcomeNoticeVersion";
 /**

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.1.6-alpha.2",
+  "version": "0.1.7-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -37,22 +37,26 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-remote-mock": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.2"
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-remote-mock": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "~3.18.4"
   },
   "files": [
     "lib/index.js",