@prettier-ai/dsh-client-ui-model-selection 0.1.2-alpha.1

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* Model selection plugin, node half. Pure UI plugin: the empty apply exists
+* so the plugin appears in the host cordis.yml / Loader; the browser half
+* ships via exports["./client"], discovered through the package.json
+* dsh.client declaration.
+*/
+/** Host plugin body — no host-side behavior for this surface plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,24 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@prettier-ai/dsh-client-ui-model-selection`.
+* @module @prettier-ai/dsh-client-ui-model-selection/invariant
+*/
+const PACKAGE_NAME = "@prettier-ai/dsh-client-ui-model-selection";
+/** Cordis companion plugin name. */
+const name = "client-ui-model-selection-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: a single command contribution registration whose disposal is
+* proven by the HMR-safety spec — it emits no cordis events and owns no
+* cross-plugin mutable state.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,12 @@
+import type { PropsLocale } from '@prettier-ai/dsh-client-ui-slots';
+import type { ModelSelectInjected } from './slots.ts';
+/**
+ * Render the composer model seat.
+ * @param props - owner share (locked) + injected face (shared directory
+ * store/verbs) + the standard locale seat.
+ * @returns the trigger and, while open, the two-level menu.
+ */
+export declare function ModelSelect({ locked, available, directory, load, select, t }: ModelSelectInjected & {
+    locked: boolean;
+} & PropsLocale<'model'>): import("react").JSX.Element | null;
+//# sourceMappingURL=ModelSelect.d.ts.map

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

@@ -0,0 +1,34 @@
+/** One Host-generation model catalog shared by every Session selector. */
+import type { ClientRemote, ModelCatalog } from '@prettier-ai/dsh-api-remotes/client';
+import { type SnapshotStore } from '@prettier-ai/dsh-client-store';
+/** Observable lifecycle of the shared model catalog. */
+export interface ModelCatalogState {
+    value: ModelCatalog | null;
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    error: string | null;
+}
+/** Loads at most one model catalog for the current Host generation. */
+export declare class ModelCatalogDirectory {
+    private readonly session;
+    /** Current shared catalog value and load lifecycle. */
+    readonly store: SnapshotStore<ModelCatalogState>;
+    private generation;
+    private inflight;
+    /** @param session - Session Remote namespace carrying the Host-generation catalog. */
+    constructor(session: Pick<ClientRemote['session'], 'modelCatalog'>);
+    /**
+     * Return the current generation's catalog, sharing its one in-flight load.
+     * @returns the loaded global catalog.
+     */
+    load(): Promise<ModelCatalog>;
+    /**
+     * Invalidate the loaded catalog; the next explicit menu read reloads it.
+     * @param clear - whether values from the previous Host generation must be hidden.
+     */
+    private invalidate;
+    /** Invalidate and reload the catalog after a Host-side model input changes. */
+    refresh(): void;
+    /** Clear Host-specific values and load the replacement Host generation. */
+    resetGeneration(): void;
+}
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1,77 @@
+/**
+ * Per-session model directory: the ONE state both selection entries share.
+ * The /model popup and composer seat combine one shared Host catalog with the
+ * Session's durable selection projection, then submit through the same
+ * selectModel call. A switch made in either entry updates this shared state.
+ */
+import type { ModelCatalogFailure, ModelProviderGroup, ModelSelection } from '@prettier-ai/dsh-api-session-controller/types';
+import type { SessionId } from '@prettier-ai/dsh-api-remotes/client';
+import type { TypertClientRemote } from '@prettier-ai/dsh-typert-protocol';
+import type { ObservableSnapshot, SnapshotStore } from '@prettier-ai/dsh-client-store';
+import type { ModelCatalogDirectory } from './catalog.ts';
+/** Directory snapshot both entries render from. */
+export interface ModelDirectoryState {
+    /** Effective selection: durable next-request projection, then Host default. */
+    current: ModelSelection | null;
+    /**
+     * Whether an adapter serves the current selection's provider, as the host reports
+     * it — null before the first load, which is NOT the same as blocked. Read
+     * this rather than "current matches no group": catalog membership is
+     * advisory, so a route serving a model it stopped advertising is missing
+     * from the groups yet perfectly usable.
+     */
+    routable: boolean | null;
+    /** Successfully loaded provider groups (last good load). */
+    groups: readonly ModelProviderGroup[];
+    /** Provider-local failures from the last load; usable groups stay usable. */
+    failures: readonly ModelCatalogFailure[];
+    /** Lifecycle of the in-flight operation. */
+    status: 'idle' | 'loading' | 'ready' | 'selecting' | 'error';
+    /** Whole-request or selection failure text; null when none. */
+    error: string | null;
+}
+/** One session's shared directory controller; disposed with the session scope. */
+export declare class ModelDirectory {
+    private readonly sessions;
+    private readonly sessionId;
+    private readonly available;
+    private readonly catalog;
+    private readonly projected;
+    /** The shared snapshot both entries render from (uSES-safe store). */
+    readonly store: SnapshotStore<ModelDirectoryState>;
+    /** Latest selection operation wins; an older response never overwrites a newer one. */
+    private generation;
+    private disposed;
+    private resolved;
+    private readonly unsubscribeCatalog;
+    private readonly unsubscribeSelection;
+    /**
+     * @param sessions - the session wire face (captured from the plugin's root connection).
+     * @param sessionId - the owning session.
+     * @param available - whether this session may use Agent-bound model RPCs.
+     * @param catalog - Host-generation catalog shared by every Session.
+     * @param projected - durable model selection projected from Session history.
+     */
+    constructor(sessions: Pick<TypertClientRemote['session'], 'selectModel'>, sessionId: SessionId, available: () => boolean, catalog: ModelCatalogDirectory, projected: ObservableSnapshot<unknown>);
+    /**
+     * Ensure the Host generation's shared advisory catalog is loaded.
+     * @returns the fresh directory value.
+     */
+    load(): Promise<ModelDirectoryState>;
+    /**
+     * Select the complete provider/model/reasoning selection. The durable
+     * projection frame updates the shared current; failures surface on the store
+     * and throw so each entry's own retry surface engages.
+     * @param selection - provider, provider-owned model id, and optional adapter-owned effort.
+   */
+    select(selection: ModelSelection): Promise<void>;
+    /**
+     * Invalidate an in-flight selection response from the previous Host generation.
+     */
+    resetConnected(): void;
+    /** Scope teardown: late settlements lose write access to the store. */
+    dispose(): void;
+    private assertAvailable;
+    private syncInputs;
+}
+//# sourceMappingURL=directory.d.ts.map

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

@@ -0,0 +1,23 @@
+import type { Context as ClientContext } from '@prettier-ai/cordis';
+import { type ModelKey } from './locales.ts';
+export { ModelDirectory } from './directory.ts';
+export type { ModelDirectoryState } from './directory.ts';
+export { ModelDirectoryResolver } from './service.ts';
+export type { ModelSelectInjected } from './slots.ts';
+export type { ModelKey } from './locales.ts';
+declare module '@prettier-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The model selection surfaces' copy (/model popup + composer seat). */
+        model: ModelKey;
+    }
+}
+/** Required services: the contribution registry, the seat's slot registry, locale, and the service's own faces. */
+export declare const inject: string[];
+/**
+ * Client plugin body: mount ModelDirectoryResolver, register the `model` dictionaries,
+ * then register the /model popup contribution and the composer model seat
+ * over the service.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,54 @@
+/**
+ * `model` namespace dictionaries.
+ *
+ * `trigger.selectAria` intentionally matches `trigger.fallback` but remains a
+ * separate key: the visible fallback label and the accessible name of
+ * an unset trigger are free to diverge per locale, and folding it into
+ * `trigger.aria` would announce the degenerate "Select model, current Select
+ * model".
+ */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'command.description': string;
+    'option.loadError': string;
+    'trigger.fallback': string;
+    'trigger.loading': string;
+    'trigger.selectAria': string;
+    'trigger.aria': string;
+    'trigger.ariaEffort': string;
+    'menu.aria': string;
+    'menu.model': string;
+    'menu.effort': string;
+    'effort.providerDefault': string;
+    'status.loading': string;
+    'error.action': string;
+    'action.reload': string;
+    'warning.groupLoad': string;
+    'empty.models': string;
+    'blocked.composer': string;
+    'empty.efforts': string;
+};
+/** The model namespace key union. */
+export type ModelKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'command.description': string;
+    'option.loadError': string;
+    'trigger.fallback': string;
+    'trigger.loading': string;
+    'trigger.selectAria': string;
+    'trigger.aria': string;
+    'trigger.ariaEffort': string;
+    'menu.aria': string;
+    'menu.model': string;
+    'menu.effort': string;
+    'effort.providerDefault': string;
+    'status.loading': string;
+    'error.action': string;
+    'action.reload': string;
+    'warning.groupLoad': string;
+    'empty.models': string;
+    'blocked.composer': string;
+    'empty.efforts': string;
+};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1,46 @@
+/**
+ * ModelDirectoryResolver (`ctx.modelDirectories`): the root owner of per-session
+ * {@link ModelDirectory} instances. Both selection entries (the /model popup
+ * and the composer model seat) resolve their session's directory through
+ * this service, which is what makes the dual entry one shared state.
+ *
+ * Per-session storage follows the client service pattern (InputTriggerService /
+ * CommandUiRuntime): a lazy service-internal map whose entry is deleted by the
+ * owning scope's disposer. The host `dsh-scope` ScopedLayers registry does
+ * does not belong here: it derives scope from the host carrier mechanism
+ * (object-keyed), while client scopes tag contexts with branded SessionId
+ * strings, and it models global+shadow named registries — this is a
+ * per-session singleton with no global layer to merge.
+ */
+import { Service } from '@prettier-ai/cordis';
+import type { Context } from '@prettier-ai/cordis';
+import type { SessionId } from '@prettier-ai/dsh-session/types';
+import { ModelDirectory } from './directory.ts';
+declare module '@prettier-ai/cordis' {
+    interface Context {
+        modelDirectories: ModelDirectoryResolver;
+    }
+}
+/** The `ctx.modelDirectories` session model-selection service. */
+export declare class ModelDirectoryResolver extends Service {
+    static inject: string[];
+    private readonly live;
+    private readonly catalog;
+    /** Localized composer-block copy; this plugin owns the string it raises. */
+    private readonly blockReason;
+    /**
+     * @param ctx - owning root context (the service registers itself as `models`).
+     * @param config - the bound translator for this plugin's own dictionary.
+     */
+    constructor(ctx: Context, config: {
+        blockReason: () => string;
+    });
+    /**
+     * Resolve the per-session shared directory (lazy; the scope disposer
+     * removes and disposes it). Unknown sessions fail loud.
+     * @param sessionId - the owning session.
+     * @returns the resident directory both entries share.
+     */
+    directoryFor(sessionId: SessionId): ModelDirectory;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1,25 @@
+/**
+ * ModelSelect's injected face. The target 'conversation.input.model' seat is
+ * declared (children table) and typed by ui-conversation's composer-bar
+ * entry; this package only contributes the single occupant, so no SlotMap
+ * merge lives here.
+ */
+import type { ModelSelection } from '@prettier-ai/dsh-api-remotes/client';
+import type { SnapshotStore } from '@prettier-ai/dsh-client-store';
+import type { ModelDirectoryState } from './directory.ts';
+/** Injected business face of the composer model seat. */
+export interface ModelSelectInjected {
+    /** Whether this session supports Agent-bound model inspection and selection. */
+    available: boolean;
+    /** The session's shared directory store (same instance the /model popup reads). */
+    directory: SnapshotStore<ModelDirectoryState>;
+    /** Ensure the shared advisory catalog is loaded (errors land on the store). */
+    load: () => void;
+    /**
+     * Select a complete provider/model/reasoning selection.
+     * @param selection - model selection and optional adapter-owned effort.
+     * @returns whether the host accepted the selection.
+     */
+    select: (selection: ModelSelection) => Promise<boolean>;
+}
+//# sourceMappingURL=slots.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Model selection plugin, node half. Pure UI plugin: the empty apply exists
+ * so the plugin appears in the host cordis.yml / Loader; the browser half
+ * ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this surface 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 `@prettier-ai/dsh-client-ui-model-selection`.
+ * @module @prettier-ai/dsh-client-ui-model-selection/invariant
+ */
+import type { Context } from '@prettier-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-model-selection-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,91 @@
+{
+  "name": "@prettier-ai/dsh-client-ui-model-selection",
+  "description": "Model selection over the shared model catalog, Session projection, and session.selectModel",
+  "version": "0.1.2-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-model-selection"
+  },
+  "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": [
+        "@prettier-ai/dsh-api-session-controller",
+        "@prettier-ai/dsh-client-locale",
+        "@prettier-ai/dsh-client-ui-commands",
+        "@prettier-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-commands": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-client-ui-input-trigger": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-test-runtime": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-commands": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-input-trigger": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-client-store": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "dependencies": {
+    "clsx": "^2.1.1"
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}