@deepseek-ai/dsh-client-ui-settings-models 0.0.1-rc.3

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

@@ -0,0 +1,116 @@
+/**
+ * Models settings page store: one snapshot joining the configurable-provider
+ * directory (`llm.providers`), the settings namespaces (`settings.describe`),
+ * and the referenced credentials (`credentials.describe`). The host stays the
+ * single fact source — every mutation writes through the wire and the page
+ * re-renders from the next describe, pushed or refetched.
+ */
+import type { ConfigurableProviderView, CredentialView, IApiClient, SettingsNamespaceView } from '@deepseek-ai/dsh-api-remotes/client';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+/** One provider row the page renders. */
+export interface ProviderRow {
+    /** The directory entry (route id, display name, settings address, live state). */
+    entry: ConfigurableProviderView;
+    /** Whether any layer configures this provider (its profile resolves). */
+    configured: boolean;
+    /** Whether the user layer alone carries the profile (removal restores the base). */
+    removable: boolean;
+    /** The credential reference the resolved profile names, when one does. */
+    apiKeyEnv: string | undefined;
+    /** Credential state for {@link apiKeyEnv}, once described. */
+    credential: CredentialView | undefined;
+}
+/** Page snapshot. */
+export interface ModelsSettingsState {
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    /** Whole-load failure text; row-level write failures stay in the editor. */
+    error: string | null;
+    /** Credential enrichment failure; provider/settings rows remain usable. */
+    credentialError: string | null;
+    /** Whether the settings provider accepts writes. */
+    writable: boolean;
+    /** Every configurable provider joined with its configured/credential state. */
+    rows: readonly ProviderRow[];
+    /** Namespace views by ns, for the editor's schema/layers/secrets. */
+    namespaces: ReadonlyMap<string, SettingsNamespaceView>;
+}
+/**
+ * Human text for a rejected wire call. A transport failure rejects with an
+ * Error; a host or a runtime can reject with anything, and the page still has
+ * to say something.
+ * @param error - the rejection value.
+ * @returns the message to show.
+ */
+export declare function messageOf(error: unknown): string;
+/**
+ * Derive the conventional credential reference for a provider route: the v1
+ * page never asks for an environment-variable name, so a typed key stores
+ * under this derived reference and the profile records it as `apiKeyEnv`.
+ * @param provider - provider route id (e.g. `anthropic`, `minimax-cn`).
+ * @returns the derived reference name (e.g. `MINIMAX_CN_API_KEY`).
+ */
+export declare function deriveKeyRef(provider: string): string;
+/**
+ * The wire protocols a hand-declared route may name, read out of the owning
+ * namespace's own schema. This stays a schema read rather than a wire field so
+ * the choices the page offers cannot drift from the ones the adapter accepts:
+ * both come from the same `Config`.
+ * @param namespace - the namespace view whose schema declares the profile shape.
+ * @returns the protocol identifiers, or an empty list when the schema has none.
+ */
+export declare function protocolChoices(namespace: SettingsNamespaceView | undefined): string[];
+/** The models settings page controller (one per settings surface). */
+export declare class ModelsSettingsStore {
+    private readonly api;
+    /** The snapshot the section renders from (uSES-safe store). */
+    readonly store: SnapshotStore<ModelsSettingsState>;
+    /** Latest load wins; an older response never overwrites a newer one. */
+    private generation;
+    /**
+     * @param api - the wire face (settings/credentials/llm domains).
+     */
+    constructor(api: Pick<IApiClient, 'settings' | 'credentials' | 'llm'>);
+    /**
+     * Refresh the whole page snapshot: directory and namespaces in parallel,
+     * then one batched credential describe over every referenced ref. A
+     * failure keeps the last good rows and surfaces the error.
+     * @returns nothing; the snapshot carries the outcome.
+     */
+    load(): Promise<void>;
+}
+/**
+ * Whether a joined row can serve model requests as it stands: the route is
+ * registered with the adapter registry, and whatever credential its resolved
+ * profile names is stored. A profile naming no reference authenticates through
+ * the provider's own path (the Bedrock chain, Vertex ADC, a gateway that needs
+ * nothing), as does a live route with no settings address at all, so neither
+ * owes this page a key.
+ * @param row - one joined provider row.
+ * @returns whether the user already has this provider to talk to.
+ */
+export declare function providerUsable(row: ProviderRow): boolean;
+/** First-run onboarding readiness derived only from the shared Models join. */
+export type OnboardingReadiness = {
+    kind: 'loading';
+} | {
+    kind: 'adapter-absent';
+} | {
+    kind: 'provider-ready';
+} | {
+    kind: 'credential-missing';
+} | {
+    kind: 'unavailable';
+    reason: 'load-failed' | 'provider-inactive' | 'credentials-unavailable' | 'settings-read-only' | 'credential-read-only';
+};
+/**
+ * Project first-run readiness from the provider/settings/credential join used
+ * by the Models page. The step exists to leave the user with a model to talk
+ * to, so ANY usable provider ends it; only when none exists does the official
+ * DeepSeek route — the one route the prompt can offer a key field for — decide
+ * whether prompting can help. A missing official configurable-provider
+ * declaration means the adapter is not repairable by navigating to Models.
+ * @param state - current shared Models join snapshot.
+ * @returns the onboarding state without reading a parallel fact source.
+ */
+export declare function onboardingReadiness(state: ModelsSettingsState): OnboardingReadiness;
+//# sourceMappingURL=store.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+/** 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;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-settings-models`.
+ * @module @deepseek-ai/dsh-client-ui-settings-models/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-settings-models-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@deepseek-ai/dsh-client-ui-settings-models",
+  "description": "Models settings and official-DeepSeek first-run routing over one live provider/settings/credential join",
+  "version": "0.0.1-rc.3",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-settings-models"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "BSD-3-Clause",
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-schema-form": "^0.0.1-rc.3"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-schema-form": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-api-remotes": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.3",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.3",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.3"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}