@fonlan/dsh-model-router 0.3.6 → 0.3.8

package/lib/index.js

@@ -311,10 +311,36 @@ function setOrder(config, modelId, order, catalogProviderIds) {
 		changed: true
 	};
 }
+/**
+* Dereference one config field as the loader may hand it over.
+*
+* dsh >= 0.1.7 owns plugin configuration as entry config, and every field the
+* `Config` schema marks `.volatile()` arrives as a stable REFERENCE
+* (`{ get() }`, schemastery's `Volatile<T>`) instead of a plain value — a
+* reference serializes to `{}`. Reading such a field raw silently yields
+* `models: {}`, `modelSort: 'custom'`, an empty `modelOrder` and no
+* `recentlyUsed`: the stored document is dropped, and the next persist
+* overwrites it with catalog defaults. Plain values pass through unchanged, so
+* this is safe for the write paths and for callers that already hold a
+* resolved document.
+*/
+function derefField(value) {
+	if (value !== null && typeof value === "object" && typeof value.get === "function") return value.get();
+	return value;
+}
+/** Dereference every own field of a config object (per-field volatile refs). */
+function derefConfig(value) {
+	const root = derefField(value);
+	if (root === null || typeof root !== "object" || Array.isArray(root)) return root;
+	const out = {};
+	for (const [key, field] of Object.entries(root)) out[key] = derefField(field);
+	return out;
+}
 /** Shape-validate an unknown value as a RouterConfigShape (lenient). */
 function normalizeConfig(value) {
 	const models = {};
-	if (typeof value !== "object" || value === null) return {
+	const source = derefConfig(value);
+	if (typeof source !== "object" || source === null) return {
 		models,
 		showQuickSwitch: true,
 		ignoreModelIdPrefix: true,
@@ -322,7 +348,7 @@ function normalizeConfig(value) {
 		modelOrder: [],
 		recentlyUsed: {}
 	};
-	const root = value;
+	const root = source;
 	const showQuickSwitch = root.showQuickSwitch !== false;
 	const ignoreModelIdPrefix = root.ignoreModelIdPrefix !== false;
 	const modelSort = root.modelSort === "name" || root.modelSort === "recent" ? root.modelSort : "custom";
@@ -362,10 +388,18 @@ function normalizeConfig(value) {
 }
 //#endregion
 //#region src/server/catalog.ts
-/** Read the resolved value of another plugin's settings section, if registered. */
+/**
+* Read the resolved value of another plugin's settings section, if the
+* settings plane describes it. The descriptor's `ns` is the profile entry id,
+* so the value is that entry's resolved Config (defaults → composition base →
+* user layer). `describe()` lists only entries that declare volatile
+* (form-writable) fields, and redaction is off here because the caller reads a
+* non-secret field (`apiKeyEnv`). An undescribed section, or an unavailable
+* settings service, yields undefined.
+*/
 function settingsSection(ctx, ns) {
 	try {
-		return ctx.settings.get(ns);
+		return ctx.settings.describe({ redactSecrets: false }).find((candidate) => candidate.ns === ns)?.value;
 	} catch {
 		return;
 	}
@@ -584,30 +618,39 @@ var ModelRouterAdapter = class extends LlmAdapter {
 //#endregion
 //#region src/server/service.ts
 const NS = ROUTER_SETTINGS_NS;
-/** Settings document schema: one entry per model id. */
+/**
+* Settings document schema: one entry per model id.
+*
+* Every writable field stays `.volatile()`: the settings plane refuses a
+* namespace whose form has no volatile field, and `settings.replace` refuses
+* non-volatile paths. The exported schema is nevertheless ASSERTED to the
+* plain `z<RouterConfigShape>` (the declared type it had before the
+* schemastery bump) for two reasons:
+*  - since schemastery 3.18.3 a `.volatile()` field's output types as
+*    `Volatile<T>`, so `: z<RouterConfigShape>` no longer *compiles*, while the
+*    inferred schema type cannot be named in the emitted declarations either
+*    (TS2742: it would need a pnpm-nested cosmokit type, and `pnpm build` runs
+*    tsc in declaration mode);
+*  - the plain shape is what consumers actually observe: the loader hands the
+*    fields over as live `{ get() }` cells and `normalizeConfig` unwinds them.
+* The assertion is type-level only — the runtime schema keeps its volatile
+* markers, which is what the settings plane reads.
+*/
 const RouterConfigSchema = z.object({
 	models: z.dict(z.object({
 		order: z.array(z.string()),
 		active: z.string()
-	})),
-	showQuickSwitch: z.boolean(),
-	ignoreModelIdPrefix: z.boolean(),
+	})).volatile(),
+	showQuickSwitch: z.boolean().volatile(),
+	ignoreModelIdPrefix: z.boolean().volatile(),
 	modelSort: z.union([
 		z.const("custom"),
 		z.const("name"),
 		z.const("recent")
-	]),
-	modelOrder: z.array(z.string()),
-	recentlyUsed: z.dict(z.number())
+	]).volatile(),
+	modelOrder: z.array(z.string()).volatile(),
+	recentlyUsed: z.dict(z.number()).volatile()
 });
-const EMPTY_CONFIG = {
-	models: {},
-	showQuickSwitch: true,
-	ignoreModelIdPrefix: true,
-	modelSort: "custom",
-	modelOrder: [],
-	recentlyUsed: {}
-};
 var ModelRouterService = class {
 	ctx;
 	cached = {
@@ -619,22 +662,30 @@ var ModelRouterService = class {
 	};
 	inflight = null;
 	cachedAt = 0;
-	scope;
+	/** Optional host settings service; absent in profiles without one (no persistence). */
+	settings;
+	/** Live config document (seeded from the entry config, updated on write). */
+	configDoc;
 	registration;
 	/** How long a built catalog is considered fresh before being rebuilt. */
 	catalogTtlMs = 3e4;
-	/** Debounced recent-use persistence (see noteModelUsed / flushUsage). */
-	usageFlushMs = 1500;
+	/**
+	* Debounced recent-use persistence (see noteModelUsed / flushUsage). Kept
+	* long on purpose: every persist writes the entry config, which restarts
+	* this plugin's entry, so usage bookkeeping must not stream live traffic.
+	*/
+	usageFlushMs = 6e4;
 	usageDebounce = null;
 	pendingUsage = {};
 	usageFlushRunning = false;
-	constructor(ctx) {
+	constructor(ctx, config) {
 		this.ctx = ctx;
+		this.configDoc = normalizeConfig(config);
 	}
-	/** Register settings + adapter and wire topology listeners. */
+	/** Register the settings seam + adapter and wire topology listeners. */
 	start() {
 		this.ctx.inject(["settings"], (sctx) => {
-			this.scope = sctx.settings.register(NS, RouterConfigSchema);
+			this.settings = sctx.settings;
 		});
 		const adapter = new ModelRouterAdapter(this);
 		this.registration = this.ctx.llm.registerAdapter([ROUTER_PROVIDER_ID], adapter);
@@ -648,7 +699,7 @@ var ModelRouterService = class {
 			clearTimeout(this.usageDebounce);
 			this.usageDebounce = null;
 		}
-		if (Object.keys(this.pendingUsage).length > 0) this.flushUsage();
+		this.pendingUsage = {};
 		this.registration?.();
 		this.registration = void 0;
 	}
@@ -659,12 +710,7 @@ var ModelRouterService = class {
 		};
 	}
 	config() {
-		if (this.scope === void 0) return EMPTY_CONFIG;
-		try {
-			return normalizeConfig(this.scope.get());
-		} catch {
-			return EMPTY_CONFIG;
-		}
+		return this.configDoc;
 	}
 	providerNames() {
 		return this.cached.providerNames;
@@ -679,7 +725,7 @@ var ModelRouterService = class {
 	* write.
 	*/
 	noteModelUsed(modelId) {
-		if (this.scope === void 0) return;
+		if (this.settings === void 0) return;
 		this.pendingUsage[modelId] = Date.now();
 		if (this.usageDebounce !== null) return;
 		this.usageDebounce = setTimeout(() => {
@@ -694,9 +740,9 @@ var ModelRouterService = class {
 		const pending = this.pendingUsage;
 		this.pendingUsage = {};
 		try {
-			if (this.scope === void 0 || Object.keys(pending).length === 0) return;
+			if (this.settings === void 0 || Object.keys(pending).length === 0) return;
 			const current = this.config();
-			await this.scope.replace({
+			await this.writeConfig({
 				...current,
 				recentlyUsed: {
 					...current.recentlyUsed,
@@ -743,12 +789,12 @@ var ModelRouterService = class {
 	/** Refresh (forced), then persist any config drift (migration, new/vanished models). */
 	async refreshAndReconcile() {
 		const catalog = await this.refreshCatalog(true);
-		if (this.scope === void 0) return;
+		if (this.settings === void 0) return;
 		const current = this.config();
 		const { models, modelOrder, changed } = reconcileConfig(current, catalog.models);
 		if (!changed) return;
 		try {
-			await this.scope.replace({
+			await this.writeConfig({
 				...current,
 				models,
 				...modelOrder === void 0 ? {} : { modelOrder }
@@ -770,6 +816,7 @@ var ModelRouterService = class {
 		const names = catalog.providerNames;
 		const creds = catalog.credentialConfigured;
 		return {
+			writable: this.settings !== void 0,
 			showQuickSwitch: config.showQuickSwitch,
 			ignoreModelIdPrefix: config.ignoreModelIdPrefix,
 			modelSort: config.modelSort,
@@ -818,10 +865,9 @@ var ModelRouterService = class {
 	}
 	/** Toggle the composer quick route-switcher button (global, persisted). */
 	async setShowQuickSwitch(value) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		const current = this.config();
 		if (current.showQuickSwitch === value) return;
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			showQuickSwitch: value
 		});
@@ -833,10 +879,9 @@ var ModelRouterService = class {
 	* turning on; split models re-initialize when turning off).
 	*/
 	async setIgnoreModelIdPrefix(value) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		const current = this.config();
 		if (current.ignoreModelIdPrefix === value) return;
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			ignoreModelIdPrefix: value
 		});
@@ -844,10 +889,9 @@ var ModelRouterService = class {
 	}
 	/** Switch the model-list display order mode (global, persisted). */
 	async setModelSort(mode) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		const current = this.config();
 		if (current.modelSort === mode) return;
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			modelSort: mode
 		});
@@ -858,22 +902,26 @@ var ModelRouterService = class {
 	* always covers the live catalog.
 	*/
 	async setModelOrder(order) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		await this.refreshCatalog();
 		const ids = new Set(this.cached.models.map((model) => model.id));
 		const clean = order.filter((id) => ids.has(id));
 		for (const model of this.cached.models) if (!clean.includes(model.id)) clean.push(model.id);
 		const current = this.config();
 		if (clean.length === current.modelOrder.length && clean.every((id, at) => id === current.modelOrder[at])) return;
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			modelOrder: clean
 		});
 	}
+	/** Write the document through the host settings service (entry config). */
+	async writeConfig(next) {
+		if (this.settings === void 0) throw new Error("model-router: settings service is not available in this profile");
+		await this.settings.replace(NS, next, void 0);
+		this.configDoc = normalizeConfig(next);
+	}
 	async persist(models) {
-		if (this.scope === void 0) throw new Error("model-router: settings service is not available in this profile");
 		const current = this.config();
-		await this.scope.replace({
+		await this.writeConfig({
 			...current,
 			models
 		});
@@ -1023,9 +1071,9 @@ function requireString(value, name) {
 //#region src/index.ts
 const name = "@fonlan/dsh-model-router";
 const inject = ["llm"];
-const Config = z.object({});
-function apply(ctx) {
-	const service = new ModelRouterService(ctx);
+const Config = RouterConfigSchema;
+function apply(ctx, config) {
+	const service = new ModelRouterService(ctx, config);
 	ctx.effect(() => {
 		service.start();
 		return () => service.stop();

package/lib/types/index.d.ts

@@ -3,13 +3,14 @@
  *
  * Registers one `model-router` LLM adapter that aggregates every configured
  * provider and model (strict model-id merge), routes each request to the
- * model's currently active provider by in-process delegation, persists the
- * per-model provider order/active config in the `model-router` settings
- * namespace, and serves the fenced JSON API the web settings page calls.
+ * model's currently active provider by in-process delegation, keeps the
+ * per-model provider order/active config in the entry config of this bundle
+ * (dsh >= 0.1.7: the `Config` schema below is the settings document), and
+ * serves the fenced JSON API the web settings page calls.
  */
 import type { Context } from '@deepseek-ai/cordis';
-import z from '@deepseek-ai/schemastery';
+import type { RouterConfigShape } from './shared/config.js';
 export declare const name = "@fonlan/dsh-model-router";
 export declare const inject: string[];
-export declare const Config: z<Schemastery.ObjectS<{}>, Schemastery.ObjectT<{}>>;
-export declare function apply(ctx: Context): void;
+export declare const Config: import("@deepseek-ai/schemastery").default<RouterConfigShape>;
+export declare function apply(ctx: Context, config: RouterConfigShape): void;

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

@@ -9,10 +9,41 @@ import { type ModelSortMode, type RouterConfigShape } from '../shared/config.js'
 import { type RouterCatalog } from './catalog.js';
 import { type RouterFacts } from './adapter.js';
 export declare const NS = "model-router";
-/** Settings document schema: one entry per model id. */
+/**
+ * The slice of the host settings service this plugin writes through. dsh >=
+ * 0.1.7 owns plugin configuration as entry config (the plugin's `Config`
+ * schema), so the router reads the document it was applied with and persists
+ * updates via `settings.replace`, which writes the profile patch.
+ */
+export interface SettingsReplaceFace {
+    replace(ns: string, section: object, expectedRevision?: number): Promise<void>;
+}
+/**
+ * Settings document schema: one entry per model id.
+ *
+ * Every writable field stays `.volatile()`: the settings plane refuses a
+ * namespace whose form has no volatile field, and `settings.replace` refuses
+ * non-volatile paths. The exported schema is nevertheless ASSERTED to the
+ * plain `z<RouterConfigShape>` (the declared type it had before the
+ * schemastery bump) for two reasons:
+ *  - since schemastery 3.18.3 a `.volatile()` field's output types as
+ *    `Volatile<T>`, so `: z<RouterConfigShape>` no longer *compiles*, while the
+ *    inferred schema type cannot be named in the emitted declarations either
+ *    (TS2742: it would need a pnpm-nested cosmokit type, and `pnpm build` runs
+ *    tsc in declaration mode);
+ *  - the plain shape is what consumers actually observe: the loader hands the
+ *    fields over as live `{ get() }` cells and `normalizeConfig` unwinds them.
+ * The assertion is type-level only — the runtime schema keeps its volatile
+ * markers, which is what the settings plane reads.
+ */
 export declare const RouterConfigSchema: z<RouterConfigShape>;
 /** The settings-page state view served by the API. */
 export interface ModelRouterState {
+    /**
+     * Whether this deployment can persist configuration. False (a profile
+     * without the host settings service) makes the page render read-only.
+     */
+    writable: boolean;
     /** Whether provider switching is shown inside the composer model picker menu. */
     showQuickSwitch: boolean;
     /** Whether model ids are matched with their leading vendor/ prefix ignored. */
@@ -46,17 +77,24 @@ export declare class ModelRouterService implements RouterFacts {
     private cached;
     private inflight;
     private cachedAt;
-    private scope;
+    /** Optional host settings service; absent in profiles without one (no persistence). */
+    private settings;
+    /** Live config document (seeded from the entry config, updated on write). */
+    private configDoc;
     private registration;
     /** How long a built catalog is considered fresh before being rebuilt. */
     private readonly catalogTtlMs;
-    /** Debounced recent-use persistence (see noteModelUsed / flushUsage). */
+    /**
+     * Debounced recent-use persistence (see noteModelUsed / flushUsage). Kept
+     * long on purpose: every persist writes the entry config, which restarts
+     * this plugin's entry, so usage bookkeeping must not stream live traffic.
+     */
     private readonly usageFlushMs;
     private usageDebounce;
     private pendingUsage;
     private usageFlushRunning;
-    constructor(ctx: Context);
-    /** Register settings + adapter and wire topology listeners. */
+    constructor(ctx: Context, config: RouterConfigShape);
+    /** Register the settings seam + adapter and wire topology listeners. */
     start(): void;
     stop(): void;
     catalog(): {
@@ -115,5 +153,7 @@ export declare class ModelRouterService implements RouterFacts {
      * always covers the live catalog.
      */
     setModelOrder(order: string[]): Promise<void>;
+    /** Write the document through the host settings service (entry config). */
+    private writeConfig;
     private persist;
 }

package/lib/types/shared/config.d.ts

@@ -198,5 +198,7 @@ export declare function setOrder(config: RouterConfigShape, modelId: string, ord
     models: Record<string, RouterModelConfig>;
     changed: boolean;
 };
+/** Dereference every own field of a config object (per-field volatile refs). */
+export declare function derefConfig(value: unknown): unknown;
 /** Shape-validate an unknown value as a RouterConfigShape (lenient). */
 export declare function normalizeConfig(value: unknown): RouterConfigShape;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonlan/dsh-model-router",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "DSH plugin: a virtual model-router provider that aggregates every configured provider and model, routes each request to the model's currently active provider, and ships a settings page for per-model provider ordering and switching.",
   "license": "MIT",
   "repository": {
@@ -63,36 +63,36 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.2-alpha.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2 || ^0.2.0-rc.1",
     "@deepseek-ai/schemastery": "^3.18.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.2-alpha.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-attachment": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-brand": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-timeout": "0.1.2-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/dsh-attachment": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-model-selection": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-credentials": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-timeout": "0.2.0-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.3",
     "@types/node": "^22.0.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",

package/src/client/api.ts

@@ -16,6 +16,11 @@ export interface RouterModelView {
 }
 
 export interface ModelRouterState {
+  /**
+   * Whether this deployment can persist router configuration (the host half
+   * found the settings service). False renders the page read-only.
+   */
+  writable: boolean
   /** Whether provider switching is shown inside the composer model picker menu. */
   showQuickSwitch: boolean
   /** Whether model ids are matched with their leading vendor/ prefix ignored. */

package/src/client/icons.tsx

@@ -0,0 +1,97 @@
+import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+
+/** Props every shell icon accepts: square edge in px, color rides currentColor. */
+export interface IconProps {
+  size?: number
+  className?: string
+}
+
+/** One shell icon component. */
+export type IconComponent = (props: IconProps) => JSX.Element
+
+/** The runtime export table, read by capability instead of by one hard-coded name. */
+const table = primitives as unknown as Record<string, IconComponent | undefined>
+
+/** First name the runtime actually provides (a missing export is `undefined`). */
+function firstDefined(...names: string[]): IconComponent | undefined {
+  for (const name of names) {
+    let candidate: IconComponent | undefined
+    try {
+      candidate = table[name]
+    } catch {
+      // Some module namespaces reject unknown names instead of yielding
+      // `undefined`; a rename must never throw on its way to the fallback.
+      continue
+    }
+    if (typeof candidate === 'function') return candidate
+  }
+  return undefined
+}
+
+/** One-path stroked glyph fallback (16×16 viewBox — the 0.1.7 artwork). */
+function glyph(path: string, defaultSize: number): IconComponent {
+  return function Glyph({ size = defaultSize, className }: IconProps): JSX.Element {
+    return (
+      <svg
+        width={size}
+        height={size}
+        className={className}
+        viewBox="0 0 16 16"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+        aria-hidden="true"
+        strokeWidth={1}
+      >
+        <path d={path} stroke="currentColor" />
+      </svg>
+    )
+  }
+}
+
+/** Warning circle fallback (the 0.1.7 artwork: ring, stem, dot). */
+function WarningFallback({ size = 16, className }: IconProps): JSX.Element {
+  return (
+    <svg
+      width={size}
+      height={size}
+      className={className}
+      viewBox="0 0 16 16"
+      fill="none"
+      xmlns="http://www.w3.org/2000/svg"
+      aria-hidden="true"
+      strokeWidth={1}
+    >
+      <path d="M8 14.5C11.5899 14.5 14.5 11.5899 14.5 8C14.5 4.41015 11.5899 1.5 8 1.5C4.41015 1.5 1.5 4.41015 1.5 8C1.5 11.5899 4.41015 14.5 8 14.5Z" stroke="currentColor" />
+      <path d="M8 4.29199V9.79199" stroke="currentColor" />
+      <path d="M8 10.708V11.708" stroke="currentColor" />
+    </svg>
+  )
+}
+
+/**
+ * Shell icons used by the model seat.
+ *
+ * DSH 0.1.7 renamed every size-suffixed icon export (`IconCheckOutline16`,
+ * `IconChevronDownOutline14`, …) into stroke-weight variants (`…OutlineRegular`
+ * 1px / `…OutlineMedium` 1.3px). A stale named import resolves to `undefined`
+ * and React then throws "Element type is invalid" while rendering the slot
+ * entry — the whole seat is dropped from the conversation input instead of
+ * degrading (this is exactly what the 0.1.7 upgrade did to this plugin).
+ * Resolve the names at runtime, newest first, so the next rename lands on
+ * another shipped variant or on the inlined artwork below.
+ */
+export const CheckIcon: IconComponent =
+  firstDefined('IconCheckOutlineRegular', 'IconCheckOutlineMedium', 'IconCheckOutline16')
+  ?? glyph('M2.25 8.5L5.49732 11.7473C5.90519 12.1552 6.57263 12.1344 6.95426 11.7018L13.75 4', 16)
+
+export const ChevronDownIcon: IconComponent =
+  firstDefined('IconChevronDownOutlineRegular', 'IconChevronDownOutlineMedium', 'IconChevronDownOutline14')
+  ?? glyph('M4 6L7.29289 9.29289C7.68342 9.68342 8.31658 9.68342 8.70711 9.29289L12 6', 14)
+
+export const ChevronRightIcon: IconComponent =
+  firstDefined('IconChevronRightOutlineRegular', 'IconChevronRightOutlineMedium', 'IconChevronRightOutline14')
+  ?? glyph('M6 12L9.29289 8.70711C9.68342 8.31658 9.68342 7.68342 9.29289 7.29289L6 4', 14)
+
+export const WarningIcon: IconComponent =
+  firstDefined('IconWarningOutlineRegular', 'IconWarningOutlineMedium', 'IconWarningOutline16')
+  ?? WarningFallback