@klarkxy/dsh-plugin-kit 0.1.0 → 0.3.0

package/lib/model-menu.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-menu.js","names":[],"sources":["../src/model-menu.ts"],"sourcesContent":["/**\n * Shared plugin-page model menu.\n *\n * A feature plugin's own settings row exposes a model select. An empty\n * selection means the host default chat model for that feature's own call.\n *\n * Browser-safe and React-optional: pure helpers live here so hosts and clients\n * share one catalog contract without bundling React into the host build.\n */\nimport { useEffect, useState } from 'react'\nimport type { ModelRoute } from './contracts.ts'\n\n/** One selectable model. `efforts` are the advertised reasoning efforts. */\nexport interface ModelMenuChoice {\n  readonly provider: string\n  readonly model: string\n  readonly label: string\n  readonly efforts: ReadonlyArray<{ id: string; name: string }>\n}\n\n/** The stored selection. Empty provider/model means \"follow the default\". */\nexport type ModelMenuRoute = ModelRoute\n\n/** The catalog face this helper needs; stays structural so hosts may add more. */\nexport interface ModelCatalogClient {\n  readonly remote?: {\n    readonly session?: { readonly modelCatalog?: () => Promise<unknown> }\n  }\n}\n\nconst KEY_SEPARATOR = '\\u001f'\n\nexport function modelMenuChoiceKey(provider: string, model: string): string {\n  return provider && model ? `${provider}${KEY_SEPARATOR}${model}` : ''\n}\n\nexport function parseModelMenuChoiceKey(value: string): { provider: string; model: string } | undefined {\n  const index = value.indexOf(KEY_SEPARATOR)\n  if (index <= 0) return undefined\n  const provider = value.slice(0, index)\n  const model = value.slice(index + KEY_SEPARATOR.length)\n  if (!provider || !model) return undefined\n  return { provider, model }\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : undefined\n}\n\nfunction asText(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined\n}\n\nfunction parseEffort(value: unknown): { id: string; name: string } | undefined {\n  const row = asRecord(value)\n  const id = row ? asText(row.id) : undefined\n  if (!id) return undefined\n  return { id, name: row ? asText(row.name) ?? id : id }\n}\n\n/** Parse the host session catalog into flat choices, keeping a saved route selectable. */\nexport function parseModelMenuChoices(value: unknown, bound?: ModelMenuRoute): ModelMenuChoice[] {\n  const envelope = asRecord(value)\n  // Host remote calls resolve to a result envelope ({ ok, value }); older hosts\n  // and unit tests hand over the bare catalog. Accept both.\n  const root = (envelope && envelope.ok === true ? asRecord(envelope.value) : undefined) ?? envelope ?? {}\n  const groups = Array.isArray(root.groups) ? root.groups : []\n  const choices: ModelMenuChoice[] = []\n  for (const group of groups) {\n    const groupRow = asRecord(group)\n    const provider = groupRow ? asText(groupRow.id) : undefined\n    if (!provider || !groupRow || !Array.isArray(groupRow.models)) continue\n    const providerName = asText(groupRow.name) ?? provider\n    for (const entry of groupRow.models) {\n      const modelRow = asRecord(entry)\n      const model = modelRow ? asText(modelRow.id) : undefined\n      if (!model || !modelRow) continue\n      const name = asText(modelRow.name) ?? model\n      const reasoning = asRecord(modelRow.reasoning)\n      const efforts = reasoning && Array.isArray(reasoning.efforts)\n        ? reasoning.efforts.flatMap(effort => { const parsed = parseEffort(effort); return parsed ? [parsed] : [] })\n        : []\n      choices.push({ provider, model, label: `${providerName} / ${name}`, efforts })\n    }\n  }\n  if (bound?.provider && bound.model && !choices.some(item => item.provider === bound.provider && item.model === bound.model)) {\n    choices.push({ provider: bound.provider, model: bound.model, label: `${bound.provider} / ${bound.model}`, efforts: [] })\n  }\n  return choices\n}\n\n/** An empty saved route means no explicit model. */\nexport function modelMenuOverride(route: ModelMenuRoute | undefined): ModelRoute | undefined {\n  const provider = route?.provider?.trim()\n  const model = route?.model?.trim()\n  if (!provider || !model) return undefined\n  const effort = route?.reasoningEffort?.trim()\n  return effort ? { provider, model, reasoningEffort: effort } : { provider, model }\n}\n\nexport function normalizeModelMenuRoute(value: unknown): ModelMenuRoute {\n  const row = asRecord(value)\n  if (!row) return { provider: '', model: '' }\n  const provider = asText(row.provider) ?? ''\n  const model = asText(row.model) ?? ''\n  const effort = asText(row.reasoningEffort)\n  if (!provider || !model || provider.length > 250 || model.length > 250) return { provider: '', model: '' }\n  return effort && effort.length <= 80 ? { provider, model, reasoningEffort: effort } : { provider, model }\n}\n\n/** Load the host catalog once per mount and republish whenever it answers. */\nexport function useModelMenuChoices(client: ModelCatalogClient, bound?: ModelMenuRoute): ModelMenuChoice[] {\n  const [choices, setChoices] = useState<ModelMenuChoice[]>([])\n  useEffect(() => {\n    if (typeof document === 'undefined') return\n    let live = true\n    const load = () => {\n      void client.remote?.session?.modelCatalog?.()\n        ?.then(value => { if (live) setChoices(parseModelMenuChoices(value, bound)) })\n        .catch(() => { if (live) setChoices([]) })\n    }\n    load()\n    return () => { live = false }\n  }, [client, bound?.provider, bound?.model])\n  return choices\n}\n\n/** Reasoning-effort options for one choice; the saved value stays selectable. */\nexport function modelMenuEffortOptions(\n  choice: ModelMenuChoice | undefined,\n  current?: string,\n): Array<{ id: string; name: string }> {\n  const listed = (choice?.efforts ?? []).map(item => ({ ...item }))\n  if (current && !listed.some(item => item.id === current)) listed.push({ id: current, name: current })\n  return listed\n}\n"],"mappings":";;;;;;;;;;;AA8BA,MAAM,gBAAgB;AAEtB,SAAgB,mBAAmB,UAAkB,OAAuB;CAC1E,OAAO,YAAY,QAAQ,GAAG,WAAW,gBAAgB,UAAU;AACrE;AAEA,SAAgB,wBAAwB,OAAgE;CACtG,MAAM,QAAQ,MAAM,QAAQ,aAAa;CACzC,IAAI,SAAS,GAAG,OAAO,KAAA;CACvB,MAAM,WAAW,MAAM,MAAM,GAAG,KAAK;CACrC,MAAM,QAAQ,MAAM,MAAM,QAAQ,CAAoB;CACtD,IAAI,CAAC,YAAY,CAAC,OAAO,OAAO,KAAA;CAChC,OAAO;EAAE;EAAU;CAAM;AAC3B;AAEA,SAAS,SAAS,OAAqD;CACrE,OAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAAI,QAAmC,KAAA;AAC1G;AAEA,SAAS,OAAO,OAAoC;CAClD,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,IAAI,MAAM,KAAK,IAAI,KAAA;AACpE;AAEA,SAAS,YAAY,OAA0D;CAC7E,MAAM,MAAM,SAAS,KAAK;CAC1B,MAAM,KAAK,MAAM,OAAO,IAAI,EAAE,IAAI,KAAA;CAClC,IAAI,CAAC,IAAI,OAAO,KAAA;CAChB,OAAO;EAAE;EAAI,MAAM,MAAM,OAAO,IAAI,IAAI,KAAK,KAAK;CAAG;AACvD;;AAGA,SAAgB,sBAAsB,OAAgB,OAA2C;CAC/F,MAAM,WAAW,SAAS,KAAK;CAG/B,MAAM,QAAQ,YAAY,SAAS,OAAO,OAAO,SAAS,SAAS,KAAK,IAAI,KAAA,MAAc,YAAY,CAAC;CACvG,MAAM,SAAS,MAAM,QAAQ,KAAK,MAAM,IAAI,KAAK,SAAS,CAAC;CAC3D,MAAM,UAA6B,CAAC;CACpC,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,WAAW,SAAS,KAAK;EAC/B,MAAM,WAAW,WAAW,OAAO,SAAS,EAAE,IAAI,KAAA;EAClD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,QAAQ,SAAS,MAAM,GAAG;EAC/D,MAAM,eAAe,OAAO,SAAS,IAAI,KAAK;EAC9C,KAAK,MAAM,SAAS,SAAS,QAAQ;GACnC,MAAM,WAAW,SAAS,KAAK;GAC/B,MAAM,QAAQ,WAAW,OAAO,SAAS,EAAE,IAAI,KAAA;GAC/C,IAAI,CAAC,SAAS,CAAC,UAAU;GACzB,MAAM,OAAO,OAAO,SAAS,IAAI,KAAK;GACtC,MAAM,YAAY,SAAS,SAAS,SAAS;GAC7C,MAAM,UAAU,aAAa,MAAM,QAAQ,UAAU,OAAO,IACxD,UAAU,QAAQ,SAAQ,WAAU;IAAE,MAAM,SAAS,YAAY,MAAM;IAAG,OAAO,SAAS,CAAC,MAAM,IAAI,CAAC;GAAE,CAAC,IACzG,CAAC;GACL,QAAQ,KAAK;IAAE;IAAU;IAAO,OAAO,GAAG,aAAa,KAAK;IAAQ;GAAQ,CAAC;EAC/E;CACF;CACA,IAAI,OAAO,YAAY,MAAM,SAAS,CAAC,QAAQ,MAAK,SAAQ,KAAK,aAAa,MAAM,YAAY,KAAK,UAAU,MAAM,KAAK,GACxH,QAAQ,KAAK;EAAE,UAAU,MAAM;EAAU,OAAO,MAAM;EAAO,OAAO,GAAG,MAAM,SAAS,KAAK,MAAM;EAAS,SAAS,CAAC;CAAE,CAAC;CAEzH,OAAO;AACT;;AAGA,SAAgB,kBAAkB,OAA2D;CAC3F,MAAM,WAAW,OAAO,UAAU,KAAK;CACvC,MAAM,QAAQ,OAAO,OAAO,KAAK;CACjC,IAAI,CAAC,YAAY,CAAC,OAAO,OAAO,KAAA;CAChC,MAAM,SAAS,OAAO,iBAAiB,KAAK;CAC5C,OAAO,SAAS;EAAE;EAAU;EAAO,iBAAiB;CAAO,IAAI;EAAE;EAAU;CAAM;AACnF;AAEA,SAAgB,wBAAwB,OAAgC;CACtE,MAAM,MAAM,SAAS,KAAK;CAC1B,IAAI,CAAC,KAAK,OAAO;EAAE,UAAU;EAAI,OAAO;CAAG;CAC3C,MAAM,WAAW,OAAO,IAAI,QAAQ,KAAK;CACzC,MAAM,QAAQ,OAAO,IAAI,KAAK,KAAK;CACnC,MAAM,SAAS,OAAO,IAAI,eAAe;CACzC,IAAI,CAAC,YAAY,CAAC,SAAS,SAAS,SAAS,OAAO,MAAM,SAAS,KAAK,OAAO;EAAE,UAAU;EAAI,OAAO;CAAG;CACzG,OAAO,UAAU,OAAO,UAAU,KAAK;EAAE;EAAU;EAAO,iBAAiB;CAAO,IAAI;EAAE;EAAU;CAAM;AAC1G;;AAGA,SAAgB,oBAAoB,QAA4B,OAA2C;CACzG,MAAM,CAAC,SAAS,cAAc,SAA4B,CAAC,CAAC;CAC5D,gBAAgB;EACd,IAAI,OAAO,aAAa,aAAa;EACrC,IAAI,OAAO;EACX,MAAM,aAAa;GACjB,OAAY,QAAQ,SAAS,eAAe,CAAC,EACzC,MAAK,UAAS;IAAE,IAAI,MAAM,WAAW,sBAAsB,OAAO,KAAK,CAAC;GAAE,CAAC,CAAC,CAC7E,YAAY;IAAE,IAAI,MAAM,WAAW,CAAC,CAAC;GAAE,CAAC;EAC7C;EACA,KAAK;EACL,aAAa;GAAE,OAAO;EAAM;CAC9B,GAAG;EAAC;EAAQ,OAAO;EAAU,OAAO;CAAK,CAAC;CAC1C,OAAO;AACT;;AAGA,SAAgB,uBACd,QACA,SACqC;CACrC,MAAM,UAAU,QAAQ,WAAW,CAAC,EAAA,CAAG,KAAI,UAAS,EAAE,GAAG,KAAK,EAAE;CAChE,IAAI,WAAW,CAAC,OAAO,MAAK,SAAQ,KAAK,OAAO,OAAO,GAAG,OAAO,KAAK;EAAE,IAAI;EAAS,MAAM;CAAQ,CAAC;CACpG,OAAO;AACT"}
+{"version":3,"file":"model-menu.js","names":["parseModelMenuChoices"],"sources":["../src/model-menu.ts"],"sourcesContent":["/**\n * Shared plugin-page model menu.\n *\n * Everything lives in @klarkxy/dsh-model-route: the pure contract (route\n * values, schema marker, catalog parsing, menu grouping) in its core entry,\n * and the ModelMenu popover component in its `./ui` browser entry. This entry\n * re-exports the core so existing plugin-kit consumers keep working, and adds\n * the React catalog hook on top. It must stay free of any ui-primitives\n * import so host-side and node-test consumers never load the component\n * bundle — the popover component and its styles live in\n * `@klarkxy/dsh-model-route/ui`.\n */\nimport { useEffect, useState } from 'react'\nimport { parseModelMenuChoices, type ModelCatalogClient, type ModelMenuChoice, type ModelRoute } from '@klarkxy/dsh-model-route'\n\nexport type { ModelCatalogClient, ModelMenuChoice, ModelMenuGroup } from '@klarkxy/dsh-model-route'\nexport {\n  groupModelMenuChoices,\n  knownModelFromChoices,\n  modelMenuEffortOptions,\n  modelMenuEffortLabel,\n  modelMenuShortName,\n  modelRouteKey as modelMenuChoiceKey,\n  modelRouteOverride as modelMenuOverride,\n  normalizeModelRoute as normalizeModelMenuRoute,\n  parseModelMenuChoices,\n  parseModelRouteKey as parseModelMenuChoiceKey,\n} from '@klarkxy/dsh-model-route'\n\n/** The stored selection. Empty provider/model means \"follow the default\". */\nexport type ModelMenuRoute = ModelRoute\n\n/** Load the host catalog once per mount and republish whenever it answers. */\nexport function useModelMenuChoices(client: ModelCatalogClient, bound?: ModelMenuRoute): ModelMenuChoice[] {\n  const [choices, setChoices] = useState<ModelMenuChoice[]>([])\n  useEffect(() => {\n    if (typeof document === 'undefined') return\n    let live = true\n    const load = () => {\n      void client.remote?.session?.modelCatalog?.()\n        ?.then(value => { if (live) setChoices(parseModelMenuChoices(value, bound)) })\n        .catch(() => { if (live) setChoices([]) })\n    }\n    load()\n    return () => { live = false }\n  }, [client, bound?.provider, bound?.model])\n  return choices\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiCA,SAAgB,oBAAoB,QAA4B,OAA2C;CACzG,MAAM,CAAC,SAAS,cAAc,SAA4B,CAAC,CAAC;CAC5D,gBAAgB;EACd,IAAI,OAAO,aAAa,aAAa;EACrC,IAAI,OAAO;EACX,MAAM,aAAa;GACjB,OAAY,QAAQ,SAAS,eAAe,CAAC,EACzC,MAAK,UAAS;IAAE,IAAI,MAAM,WAAWA,wBAAsB,OAAO,KAAK,CAAC;GAAE,CAAC,CAAC,CAC7E,YAAY;IAAE,IAAI,MAAM,WAAW,CAAC,CAAC;GAAE,CAAC;EAC7C;EACA,KAAK;EACL,aAAa;GAAE,OAAO;EAAM;CAC9B,GAAG;EAAC;EAAQ,OAAO;EAAU,OAAO;CAAK,CAAC;CAC1C,OAAO;AACT"}

package/lib/model-settings-client.d.ts

@@ -0,0 +1,47 @@
+import { TypertRemoteContribution } from "@deepseek-ai/dsh-typert-protocol";
+//#region src/model-settings-client.d.ts
+type ModelSettingsChangeFrame = {
+  kind: 'ready';
+} | {
+  kind: 'changed';
+  ns: string;
+  revision: number;
+};
+/** This stream carries invalidations only; ready is never a settings snapshot. */
+declare function parseModelSettingsChangeFrame(value: unknown): ModelSettingsChangeFrame;
+/** One contribution mounted by Model Hub; consumers only inject its service. */
+declare const modelSettingsChangesRemote: TypertRemoteContribution;
+interface StreamItem {
+  generation: number;
+  value: unknown;
+  signal: AbortSignal;
+  accept(): void;
+}
+interface ChangeStream extends AsyncIterable<StreamItem> {
+  dispose(): Promise<void>;
+}
+interface ModelSettingsSubscriberScope {
+  remote: {
+    modelSettingsChanges: {
+      watch(signal: AbortSignal): AsyncIterable<unknown>;
+    };
+    $stream(options: {
+      name: string;
+      open(signal: AbortSignal): AsyncIterable<unknown>;
+      ended(accepted: boolean): Error;
+    }): ChangeStream;
+  };
+  effect(callback: () => () => void | Promise<void>): unknown;
+}
+interface ModelSettingsSubscriberContext {
+  inject(dependencies: string[], callback: (scope: unknown) => void): unknown;
+}
+interface ModelSettingsSubscriber {
+  subscribe(onChange: () => void, onError?: (message: string) => void): () => void;
+}
+/** Native RemoteStream owns carrier reconnects; no timers or browser transport.
+ * A factory shares one logical stream while at least one subscriber remains. */
+declare function createModelSettingsSubscriber(ctx: ModelSettingsSubscriberContext, namespace: string): ModelSettingsSubscriber;
+//#endregion
+export { ModelSettingsChangeFrame, ModelSettingsSubscriber, ModelSettingsSubscriberContext, ModelSettingsSubscriberScope, createModelSettingsSubscriber, modelSettingsChangesRemote, parseModelSettingsChangeFrame };
+//# sourceMappingURL=model-settings-client.d.ts.map

package/lib/model-settings-client.js

@@ -0,0 +1,143 @@
+import { MODEL_SETTINGS_CHANGES_REMOTE } from "./contracts.js";
+//#region src/model-settings-client.ts
+/** This stream carries invalidations only; ready is never a settings snapshot. */
+function parseModelSettingsChangeFrame(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Invalid model settings change frame");
+	const frame = value;
+	if (frame.kind === "ready" && Object.keys(frame).length === 1) return { kind: "ready" };
+	if (frame.kind === "changed" && Object.keys(frame).length === 3 && typeof frame.ns === "string" && frame.ns.length > 0 && typeof frame.revision === "number" && Number.isSafeInteger(frame.revision) && frame.revision >= 0) return {
+		kind: "changed",
+		ns: frame.ns,
+		revision: frame.revision
+	};
+	throw new Error("Invalid model settings change frame");
+}
+/** One contribution mounted by Model Hub; consumers only inject its service. */
+const modelSettingsChangesRemote = {
+	package: MODEL_SETTINGS_CHANGES_REMOTE.package,
+	descriptors: MODEL_SETTINGS_CHANGES_REMOTE.descriptors.map((descriptor) => ({
+		...descriptor,
+		result: {
+			mode: "strict",
+			typeSymbol: "ModelSettings.ChangeFrame",
+			create: () => ({ parse: parseModelSettingsChangeFrame })
+		}
+	}))
+};
+/** Native RemoteStream owns carrier reconnects; no timers or browser transport.
+* A factory shares one logical stream while at least one subscriber remains. */
+function createModelSettingsSubscriber(ctx, namespace) {
+	const listeners = /* @__PURE__ */ new Set();
+	let injection;
+	let current;
+	let lifecycle = 0;
+	let failureMessage;
+	const report = (message) => {
+		failureMessage = message;
+		for (const listener of [...listeners]) try {
+			listener.error?.(message);
+		} catch {}
+	};
+	const invalidate = () => {
+		for (const listener of [...listeners]) {
+			if (!listeners.has(listener)) continue;
+			try {
+				listener.change();
+			} catch (error) {
+				try {
+					listener.error?.(error instanceof Error ? error.message : String(error));
+				} catch {}
+			}
+		}
+	};
+	const start = () => {
+		const life = ++lifecycle;
+		injection = ctx.inject(["remote", "remote.modelSettingsChanges"], (injected) => {
+			if (life !== lifecycle || !listeners.size) return;
+			const scope = injected;
+			const stream = scope.remote.$stream({
+				name: "Model settings sync",
+				open: (signal) => scope.remote.modelSettingsChanges.watch(signal),
+				ended: (accepted) => /* @__PURE__ */ new Error(`Model settings sync stream ended ${accepted ? "after" : "before"} ready; refresh or reopen the page`)
+			});
+			const session = {
+				stream,
+				active: true
+			};
+			current = session;
+			scope.effect(() => () => {
+				session.active = false;
+				if (current === session) {
+					current = void 0;
+					if (life === lifecycle && listeners.size) report("Model settings sync service unavailable");
+				}
+				return stream.dispose();
+			});
+			(async () => {
+				let generation;
+				let ready = false;
+				try {
+					for await (const item of stream) {
+						if (!session.active || life !== lifecycle || !listeners.size) break;
+						if (item.signal.aborted) continue;
+						if (generation !== item.generation) {
+							generation = item.generation;
+							ready = false;
+						}
+						const frame = parseModelSettingsChangeFrame(item.value);
+						if (frame.kind === "ready") {
+							ready = true;
+							failureMessage = void 0;
+							item.accept();
+							invalidate();
+						} else {
+							if (!ready) throw new Error("Model settings sync change arrived before ready");
+							if (namespace === "*" || frame.ns === namespace) invalidate();
+						}
+					}
+				} catch (error) {
+					if (session.active && life === lifecycle) report(error instanceof Error ? error.message : String(error));
+				} finally {
+					if (current === session) current = void 0;
+					session.active = false;
+					await stream.dispose().catch(() => {});
+				}
+			})();
+		});
+		queueMicrotask(() => {
+			if (life === lifecycle && listeners.size && !current) report("Model settings sync service unavailable");
+		});
+	};
+	return Object.freeze({ subscribe(onChange, onError) {
+		const listener = {
+			change: onChange,
+			error: onError
+		};
+		listeners.add(listener);
+		if (!injection) start();
+		else if (failureMessage) queueMicrotask(() => {
+			if (listeners.has(listener) && failureMessage) try {
+				listener.error?.(failureMessage);
+			} catch {}
+		});
+		return () => {
+			if (!listeners.delete(listener) || listeners.size) return;
+			lifecycle++;
+			if (current) {
+				current.active = false;
+				current.stream.dispose().catch(() => {});
+			}
+			current = void 0;
+			failureMessage = void 0;
+			const previous = injection;
+			injection = void 0;
+			try {
+				Promise.resolve(previous?.dispose()).catch(() => {});
+			} catch {}
+		};
+	} });
+}
+//#endregion
+export { createModelSettingsSubscriber, modelSettingsChangesRemote, parseModelSettingsChangeFrame };
+
+//# sourceMappingURL=model-settings-client.js.map

package/lib/model-settings-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-settings-client.js","names":[],"sources":["../src/model-settings-client.ts"],"sourcesContent":["import type { TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol'\nimport { MODEL_SETTINGS_CHANGES_REMOTE } from './contracts.ts'\n\nexport type ModelSettingsChangeFrame = { kind: 'ready' } | { kind: 'changed'; ns: string; revision: number }\n\n/** This stream carries invalidations only; ready is never a settings snapshot. */\nexport function parseModelSettingsChangeFrame(value: unknown): ModelSettingsChangeFrame {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('Invalid model settings change frame')\n  const frame = value as Record<string, unknown>\n  if (frame.kind === 'ready' && Object.keys(frame).length === 1) return { kind: 'ready' }\n  if (frame.kind === 'changed' && Object.keys(frame).length === 3 && typeof frame.ns === 'string' && frame.ns.length > 0\n    && typeof frame.revision === 'number' && Number.isSafeInteger(frame.revision) && frame.revision >= 0) {\n    return { kind: 'changed', ns: frame.ns, revision: frame.revision }\n  }\n  throw new Error('Invalid model settings change frame')\n}\n\n/** One contribution mounted by Model Hub; consumers only inject its service. */\nexport const modelSettingsChangesRemote: TypertRemoteContribution = {\n  package: MODEL_SETTINGS_CHANGES_REMOTE.package,\n  descriptors: MODEL_SETTINGS_CHANGES_REMOTE.descriptors.map(descriptor => ({\n    ...descriptor,\n    result: { mode: 'strict' as const, typeSymbol: 'ModelSettings.ChangeFrame', create: () => ({ parse: parseModelSettingsChangeFrame }) },\n  })),\n}\n\ninterface StreamItem {\n  generation: number\n  value: unknown\n  signal: AbortSignal\n  accept(): void\n}\ninterface ChangeStream extends AsyncIterable<StreamItem> { dispose(): Promise<void> }\nexport interface ModelSettingsSubscriberScope {\n  remote: {\n    modelSettingsChanges: { watch(signal: AbortSignal): AsyncIterable<unknown> }\n    $stream(options: {\n      name: string\n      open(signal: AbortSignal): AsyncIterable<unknown>\n      ended(accepted: boolean): Error\n    }): ChangeStream\n  }\n  effect(callback: () => () => void | Promise<void>): unknown\n}\nexport interface ModelSettingsSubscriberContext {\n  inject(dependencies: string[], callback: (scope: unknown) => void): unknown\n}\nexport interface ModelSettingsSubscriber {\n  subscribe(onChange: () => void, onError?: (message: string) => void): () => void\n}\n\n/** Native RemoteStream owns carrier reconnects; no timers or browser transport.\n * A factory shares one logical stream while at least one subscriber remains. */\nexport function createModelSettingsSubscriber(ctx: ModelSettingsSubscriberContext, namespace: string): ModelSettingsSubscriber {\n  const listeners = new Set<{ change: () => void; error?: (message: string) => void }>()\n  let injection: { dispose(): void | Promise<void> } | undefined\n  let current: { stream: ChangeStream; active: boolean } | undefined\n  let lifecycle = 0\n  let failureMessage: string | undefined\n  const report = (message: string) => {\n    failureMessage = message\n    for (const listener of [...listeners]) {\n      try { listener.error?.(message) } catch { /* Isolate page callbacks. */ }\n    }\n  }\n  const invalidate = () => {\n    for (const listener of [...listeners]) {\n      if (!listeners.has(listener)) continue\n      try { listener.change() } catch (error) {\n        try { listener.error?.(error instanceof Error ? error.message : String(error)) } catch { /* Isolate callbacks. */ }\n      }\n    }\n  }\n  const start = () => {\n    const life = ++lifecycle\n    injection = ctx.inject(['remote', 'remote.modelSettingsChanges'], injected => {\n      if (life !== lifecycle || !listeners.size) return\n      const scope = injected as ModelSettingsSubscriberScope\n      const stream = scope.remote.$stream({\n        name: 'Model settings sync',\n        open: signal => scope.remote.modelSettingsChanges.watch(signal),\n        ended: accepted => new Error(`Model settings sync stream ended ${accepted ? 'after' : 'before'} ready; refresh or reopen the page`),\n      })\n      const session = { stream, active: true }\n      current = session\n      scope.effect(() => () => {\n        session.active = false\n        if (current === session) {\n          current = undefined\n          if (life === lifecycle && listeners.size) report('Model settings sync service unavailable')\n        }\n        return stream.dispose()\n      })\n      void (async () => {\n        let generation: number | undefined\n        let ready = false\n        try {\n          for await (const item of stream) {\n            if (!session.active || life !== lifecycle || !listeners.size) break\n            if (item.signal.aborted) continue\n            if (generation !== item.generation) { generation = item.generation; ready = false }\n            const frame = parseModelSettingsChangeFrame(item.value)\n            if (frame.kind === 'ready') {\n              ready = true\n              failureMessage = undefined\n              // Accept the validated invalidation baseline, not fetched data.\n              // Every current listener queues its own latest settings read.\n              item.accept()\n              invalidate()\n            } else {\n              if (!ready) throw new Error('Model settings sync change arrived before ready')\n              if (namespace === '*' || frame.ns === namespace) invalidate()\n            }\n          }\n        } catch (error) {\n          if (session.active && life === lifecycle) report(error instanceof Error ? error.message : String(error))\n        } finally {\n          if (current === session) current = undefined\n          session.active = false\n          await stream.dispose().catch(() => {})\n        }\n      })()\n    }) as { dispose(): void | Promise<void> }\n    queueMicrotask(() => {\n      if (life === lifecycle && listeners.size && !current) report('Model settings sync service unavailable')\n    })\n  }\n  return Object.freeze({ subscribe(onChange: () => void, onError?: (message: string) => void) {\n    const listener = { change: onChange, error: onError }\n    listeners.add(listener)\n    if (!injection) start()\n    else if (failureMessage) queueMicrotask(() => {\n      if (listeners.has(listener) && failureMessage) {\n        try { listener.error?.(failureMessage) } catch { /* Isolate callbacks. */ }\n      }\n    })\n    return () => {\n      if (!listeners.delete(listener) || listeners.size) return\n      lifecycle++\n      if (current) { current.active = false; void current.stream.dispose().catch(() => {}) }\n      current = undefined\n      failureMessage = undefined\n      const previous = injection\n      injection = undefined\n      try { void Promise.resolve(previous?.dispose()).catch(() => {}) } catch { /* Already unloaded. */ }\n    }\n  } })\n}\n"],"mappings":"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"}

package/lib/model-settings.d.ts

@@ -0,0 +1,55 @@
+import { ModelRoute } from "@klarkxy/dsh-model-route";
+//#region src/model-settings.d.ts
+/** Built-in display copy; plain strings preserve third-party and user-provided text. */
+type ModelSettingsText = string | {
+  zh: string;
+  en: string;
+};
+/** Plugin-owned model settings, independent of native volatile Config forms. */
+interface ModelSettingsField {
+  path: string[];
+  label: ModelSettingsText;
+  description?: ModelSettingsText;
+  current?: ModelRoute;
+  editable?: false;
+  allowFollow?: boolean;
+  followLabel?: ModelSettingsText;
+}
+interface ModelSettingsSnapshot {
+  revision: number;
+  fields: ModelSettingsField[];
+  /** A separate model domain, e.g. external Codex; never use the DSH catalog here. */
+  catalog?: unknown;
+  catalogError?: ModelSettingsText;
+}
+interface ModelSettingsProvider {
+  ns: string;
+  title: ModelSettingsText;
+  instanceId?: string;
+  read(signal: AbortSignal): ModelSettingsSnapshot | Promise<ModelSettingsSnapshot>;
+  write(path: readonly string[], route: ModelRoute, expectedRevision: number, signal: AbortSignal): Promise<unknown>;
+}
+declare const MODEL_SETTINGS_EVENT = "model-settings/collect";
+declare const MODEL_SETTINGS_CHANGED_EVENT = "model-settings/changed";
+interface ModelSettingsChange {
+  ns: string;
+  revision: number;
+}
+/** Publish only after the owner's save commits. A failed observer must never
+ * turn an already committed write into an apparent save failure. */
+declare function notifyModelSettingsChanged(ctx: {
+  parallel(name: typeof MODEL_SETTINGS_CHANGED_EVENT, change: ModelSettingsChange): Promise<void>;
+}, ns: string, revision: number): void;
+type Collector = (provider: ModelSettingsProvider) => void;
+interface ModelSettingsEvents {
+  on(name: typeof MODEL_SETTINGS_EVENT, callback: (collect: Collector) => void): () => void;
+}
+interface ModelSettingsDiscovery {
+  parallel(name: typeof MODEL_SETTINGS_EVENT, collect: Collector): Promise<void>;
+}
+/** Cordis disposes the listener with its fiber. In-flight references also fail closed. */
+declare function registerModelSettings(ctx: ModelSettingsEvents, provider: ModelSettingsProvider): () => void;
+declare function collectModelSettings(ctx: ModelSettingsDiscovery): Promise<ModelSettingsProvider[]>;
+//#endregion
+export { MODEL_SETTINGS_CHANGED_EVENT, MODEL_SETTINGS_EVENT, ModelSettingsChange, ModelSettingsDiscovery, ModelSettingsEvents, ModelSettingsField, ModelSettingsProvider, ModelSettingsSnapshot, ModelSettingsText, collectModelSettings, notifyModelSettingsChanged, registerModelSettings };
+//# sourceMappingURL=model-settings.d.ts.map

package/lib/model-settings.js

@@ -0,0 +1,60 @@
+//#region src/model-settings.ts
+const MODEL_SETTINGS_EVENT = "model-settings/collect";
+const MODEL_SETTINGS_CHANGED_EVENT = "model-settings/changed";
+/** Publish only after the owner's save commits. A failed observer must never
+* turn an already committed write into an apparent save failure. */
+function notifyModelSettingsChanged(ctx, ns, revision) {
+	try {
+		ctx.parallel(MODEL_SETTINGS_CHANGED_EVENT, {
+			ns,
+			revision
+		}).catch(() => {});
+	} catch {}
+}
+/** Cordis disposes the listener with its fiber. In-flight references also fail closed. */
+function registerModelSettings(ctx, provider) {
+	let active = true;
+	const requireActive = (signal) => {
+		signal.throwIfAborted();
+		if (!active) throw new Error("Model settings owner unloaded; refresh and retry");
+	};
+	const guarded = {
+		ns: provider.ns,
+		title: provider.title,
+		instanceId: globalThis.crypto.randomUUID(),
+		async read(signal) {
+			requireActive(signal);
+			const value = await provider.read(signal);
+			requireActive(signal);
+			return value;
+		},
+		async write(path, route, revision, signal) {
+			requireActive(signal);
+			return provider.write(path, route, revision, signal);
+		}
+	};
+	const off = ctx.on(MODEL_SETTINGS_EVENT, (collect) => {
+		if (active) collect(guarded);
+	});
+	return () => {
+		active = false;
+		off();
+	};
+}
+async function collectModelSettings(ctx) {
+	const providers = [];
+	const duplicates = [];
+	await ctx.parallel(MODEL_SETTINGS_EVENT, (provider) => {
+		if (!provider.ns || providers.some((item) => item.ns === provider.ns)) {
+			duplicates.push(provider.ns);
+			return;
+		}
+		providers.push(provider);
+	});
+	if (duplicates.length) throw new Error(`Duplicate model settings owner: ${duplicates.join(", ")}`);
+	return providers.sort((a, b) => a.ns.localeCompare(b.ns));
+}
+//#endregion
+export { MODEL_SETTINGS_CHANGED_EVENT, MODEL_SETTINGS_EVENT, collectModelSettings, notifyModelSettingsChanged, registerModelSettings };
+
+//# sourceMappingURL=model-settings.js.map

package/lib/model-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-settings.js","names":[],"sources":["../src/model-settings.ts"],"sourcesContent":["import type { ModelRoute } from '@klarkxy/dsh-model-route'\n\n/** Built-in display copy; plain strings preserve third-party and user-provided text. */\nexport type ModelSettingsText = string | { zh: string; en: string }\n\n/** Plugin-owned model settings, independent of native volatile Config forms. */\nexport interface ModelSettingsField {\n  path: string[]\n  label: ModelSettingsText\n  description?: ModelSettingsText\n  current?: ModelRoute\n  editable?: false\n  allowFollow?: boolean\n  followLabel?: ModelSettingsText\n}\nexport interface ModelSettingsSnapshot {\n  revision: number\n  fields: ModelSettingsField[]\n  /** A separate model domain, e.g. external Codex; never use the DSH catalog here. */\n  catalog?: unknown\n  catalogError?: ModelSettingsText\n}\nexport interface ModelSettingsProvider {\n  ns: string\n  title: ModelSettingsText\n  instanceId?: string\n  read(signal: AbortSignal): ModelSettingsSnapshot | Promise<ModelSettingsSnapshot>\n  write(path: readonly string[], route: ModelRoute, expectedRevision: number, signal: AbortSignal): Promise<unknown>\n}\n\nexport const MODEL_SETTINGS_EVENT = 'model-settings/collect'\nexport const MODEL_SETTINGS_CHANGED_EVENT = 'model-settings/changed'\nexport interface ModelSettingsChange { ns: string; revision: number }\n\n/** Publish only after the owner's save commits. A failed observer must never\n * turn an already committed write into an apparent save failure. */\nexport function notifyModelSettingsChanged(ctx: {\n  parallel(name: typeof MODEL_SETTINGS_CHANGED_EVENT, change: ModelSettingsChange): Promise<void>\n}, ns: string, revision: number): void {\n  try {\n    // Cordis emit returns void and cannot contain an async observer rejection.\n    void ctx.parallel(MODEL_SETTINGS_CHANGED_EVENT, { ns, revision }).catch(() => {})\n  } catch { /* The save has already committed. */ }\n}\ntype Collector = (provider: ModelSettingsProvider) => void\nexport interface ModelSettingsEvents {\n  on(name: typeof MODEL_SETTINGS_EVENT, callback: (collect: Collector) => void): () => void\n}\nexport interface ModelSettingsDiscovery {\n  parallel(name: typeof MODEL_SETTINGS_EVENT, collect: Collector): Promise<void>\n}\n\n/** Cordis disposes the listener with its fiber. In-flight references also fail closed. */\nexport function registerModelSettings(ctx: ModelSettingsEvents, provider: ModelSettingsProvider): () => void {\n  let active = true\n  const requireActive = (signal: AbortSignal) => {\n    signal.throwIfAborted()\n    if (!active) throw new Error('Model settings owner unloaded; refresh and retry')\n  }\n  const guarded: ModelSettingsProvider = {\n    ns: provider.ns, title: provider.title, instanceId: globalThis.crypto.randomUUID(),\n    async read(signal) {\n      requireActive(signal)\n      const value = await provider.read(signal)\n      requireActive(signal)\n      return value\n    },\n    async write(path, route, revision, signal) {\n      requireActive(signal)\n      return provider.write(path, route, revision, signal)\n    },\n  }\n  const off = ctx.on(MODEL_SETTINGS_EVENT, collect => { if (active) collect(guarded) })\n  // Call this disposer from ctx.effect as well: listener removal alone does not\n  // revoke a reference captured just before the owning plugin was unloaded.\n  return () => { active = false; off() }\n}\n\nexport async function collectModelSettings(ctx: ModelSettingsDiscovery): Promise<ModelSettingsProvider[]> {\n  const providers: ModelSettingsProvider[] = []\n  const duplicates: string[] = []\n  await ctx.parallel(MODEL_SETTINGS_EVENT, provider => {\n    if (!provider.ns || providers.some(item => item.ns === provider.ns)) { duplicates.push(provider.ns); return }\n    providers.push(provider)\n  })\n  if (duplicates.length) throw new Error(`Duplicate model settings owner: ${duplicates.join(', ')}`)\n  return providers.sort((a, b) => a.ns.localeCompare(b.ns))\n}\n"],"mappings":";AA8BA,MAAa,uBAAuB;AACpC,MAAa,+BAA+B;;;AAK5C,SAAgB,2BAA2B,KAExC,IAAY,UAAwB;CACrC,IAAI;EAEF,IAAS,SAAS,8BAA8B;GAAE;GAAI;EAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;CAClF,QAAQ,CAAwC;AAClD;;AAUA,SAAgB,sBAAsB,KAA0B,UAA6C;CAC3G,IAAI,SAAS;CACb,MAAM,iBAAiB,WAAwB;EAC7C,OAAO,eAAe;EACtB,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,kDAAkD;CACjF;CACA,MAAM,UAAiC;EACrC,IAAI,SAAS;EAAI,OAAO,SAAS;EAAO,YAAY,WAAW,OAAO,WAAW;EACjF,MAAM,KAAK,QAAQ;GACjB,cAAc,MAAM;GACpB,MAAM,QAAQ,MAAM,SAAS,KAAK,MAAM;GACxC,cAAc,MAAM;GACpB,OAAO;EACT;EACA,MAAM,MAAM,MAAM,OAAO,UAAU,QAAQ;GACzC,cAAc,MAAM;GACpB,OAAO,SAAS,MAAM,MAAM,OAAO,UAAU,MAAM;EACrD;CACF;CACA,MAAM,MAAM,IAAI,GAAG,uBAAsB,YAAW;EAAE,IAAI,QAAQ,QAAQ,OAAO;CAAE,CAAC;CAGpF,aAAa;EAAE,SAAS;EAAO,IAAI;CAAE;AACvC;AAEA,eAAsB,qBAAqB,KAA+D;CACxG,MAAM,YAAqC,CAAC;CAC5C,MAAM,aAAuB,CAAC;CAC9B,MAAM,IAAI,SAAS,uBAAsB,aAAY;EACnD,IAAI,CAAC,SAAS,MAAM,UAAU,MAAK,SAAQ,KAAK,OAAO,SAAS,EAAE,GAAG;GAAE,WAAW,KAAK,SAAS,EAAE;GAAG;EAAO;EAC5G,UAAU,KAAK,QAAQ;CACzB,CAAC;CACD,IAAI,WAAW,QAAQ,MAAM,IAAI,MAAM,mCAAmC,WAAW,KAAK,IAAI,GAAG;CACjG,OAAO,UAAU,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC;AAC1D"}

package/lib/official-ui.js

@@ -340,7 +340,7 @@ ${scope} {
   border: 0.5px solid var(--dsw-alias-border-l3);
   border-radius: var(--dsw-radius-md);
   background: var(--dsw-alias-bg-layer-1);
-  font-family: var(--ds-font-family-code, ui-monospace, 'Cascadia Mono', Consolas, monospace);
+  font-family: var(--ds-font-family-code);
   font-size: 12px;
   line-height: 20px;
   color: var(--dsw-alias-label-secondary);

package/lib/official-ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"official-ui.js","names":[],"sources":["../src/official-ui.ts"],"sourcesContent":["/**\n * Shared contract that keeps every plugin's browser-side UI on the official\n * DeepSeek Harness Web design language.\n *\n * Two rules produce that language, and both are load-bearing here:\n *\n * 1. Colour, radius, elevation and focus come from the host theme's real\n *    `--dsw-*` tokens, written under their own names. Plugins never invent a\n *    token, never alias the official ones behind a private palette (a private\n *    alias is just a second, diverging theme), and never carries a literal\n *    fallback — the host publishes light and dark, and a literal would pin one\n *    of them. The only non-colour custom properties used are the host's own\n *    content-font axis and frame clearance.\n *\n * 2. Anything the host already ships is used, not reimplemented. Controls come\n *    from `@deepseek-ai/dsh-client-ui-primitives` (`Button`, `Input`,\n *    `Checkbox`, `Switch`, `Tag`, `Pill`, `SegmentedControl`, `Menu`, `Modal`,\n *    `Tooltip`, `Toast`, `DisclosureRow`, `StateDot`, `PathLabel`, the settings\n *    form suite). This module only styles what primitives do not cover: page\n *    scaffolding, field layout, banners, empty states and scroll regions.\n *\n * The metrics below are transcribed from the primitives' own CSS modules so a\n * feature panel lines up pixel-for-pixel with a native one: the 14/22 body and\n * 13/20 compact type tiers, the 0.5px hairline scale, and the elevation family\n * that draws a surface's edge in its shadow (`border: 0`) instead of a border.\n */\n\n/**\n * Every `--dsw-*` token this repo is allowed to reference, grouped by role.\n *\n * Plugins may only colour through this list. It is exported so the guard test\n * can fail a build when a stylesheet reaches for anything else — the failure\n * mode this prevents is silent: an unknown token resolves to nothing, so a\n * border disappears or a label inherits the wrong colour with no error anywhere.\n */\nexport const OFFICIAL_THEME_TOKENS = {\n  /** Surfaces, from the page up to the topmost nested card. */\n  surface: [\n    '--dsw-alias-bg-base',\n    '--dsw-alias-bg-layer-1',\n    '--dsw-alias-bg-layer-2',\n    '--dsw-alias-bg-layer-3',\n    '--dsw-alias-bg-layer-4',\n    '--dsw-alias-bg-module-platform',\n    '--dsw-alias-bg-overlay',\n  ],\n  /** Hairlines. l1 is near-invisible on a menu surface, so menus use l2+. */\n  border: ['--dsw-alias-border-l1', '--dsw-alias-border-l2', '--dsw-alias-border-l3', '--dsw-alias-border-l4'],\n  /** Text. `caption` is menu shortcut text, `dimmed` is placeholder text. */\n  label: [\n    '--dsw-alias-label-primary',\n    '--dsw-alias-label-secondary',\n    '--dsw-alias-label-tertiary',\n    '--dsw-alias-label-caption',\n    '--dsw-alias-label-dimmed',\n    '--dsw-alias-label-error',\n    '--dsw-alias-label-primary-foreground',\n  ],\n  /** Interactive fills. The `-danger` hover belongs to destructive rows. */\n  interactive: [\n    '--dsw-alias-interactive-bg-hover',\n    '--dsw-alias-interactive-bg-active',\n    '--dsw-alias-interactive-bg-hover-danger',\n  ],\n  /** Accent and status. `business` is the focus ring's default colour. */\n  accent: [\n    '--dsw-alias-brand-primary',\n    '--dsw-alias-button-primary-fill',\n    '--dsw-alias-button-primary-hover',\n    '--dsw-alias-button-tool-bar-fill',\n    '--dsw-alias-button-tool-bar-hover',\n    '--dsw-alias-button-ghost-active-fill',\n    '--dsw-alias-button-ghost-active-border',\n  ],\n  state: [\n    '--dsw-alias-state-business-primary',\n    '--dsw-alias-state-success-primary',\n    '--dsw-alias-state-warn-primary',\n    '--dsw-alias-state-error-primary',\n    '--dsw-alias-state-idle-primary',\n  ],\n  /** Corner scale: sm 8, md 12, lg the large card, panel the modal. */\n  radius: ['--dsw-radius-sm', '--dsw-radius-md', '--dsw-radius-lg', '--dsw-radius-panel'],\n  /** An elevated surface draws its edge in the shadow, so it keeps border: 0. */\n  elevation: [\n    '--dsw-elevation-soft',\n    '--dsw-elevation-stroke',\n    '--dsw-elevation-stroke-color',\n    '--dsw-elevation-panel',\n    '--dsw-elevation-prominent',\n  ],\n  /** Floats, masks and scrollbars. */\n  overlay: [\n    '--dsw-menu-surface-fill',\n    '--dsw-menu-backdrop-filter',\n    '--dsw-mask-blur',\n    '--dsw-alias-bg-mask-1',\n    '--dsw-alias-menu-icon',\n    '--dsw-alias-scrollbar-bg-l2',\n    '--dsw-alias-scrollbar-hover-l2',\n    '--dsw-shadow-lv3',\n  ],\n  /** Motion, focus and type axis, published by the host rather than by a component. */\n  system: [\n    '--dsw-focus-ring-width',\n    '--dsw-focus-ring-color',\n    '--dsw-font-markdown-code-font-family',\n    '--ds-transition-duration',\n    '--ds-ease-in-out',\n    '--ds-font-family-code',\n    '--dsh-scrollbar-thumb',\n    '--dsh-scrollbar-thumb-hover',\n    '--dsh-content-font-size-secondary',\n    '--dsh-content-font-delta',\n    '--dsh-frame-top-clearance',\n  ],\n} as const\n\n/** Every official token name, flat. Used by the token guard test. */\nexport const OFFICIAL_THEME_TOKEN_NAMES: readonly string[] = Object.values(OFFICIAL_THEME_TOKENS).flat()\n\n/** The elevation steps a surface can be raised by, softest first. */\nexport type OfficialElevation = 'soft' | 'stroke' | 'panel' | 'prominent'\n\n/**\n * The host's focus ring shorthand, verbatim. Writing this per control is how\n * rings drift apart; a stylesheet that draws its own focus style should use\n * {@link officialFocus} instead. The colour fallback is the host's own default.\n */\nexport const OFFICIAL_FOCUS_RING =\n  'var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary))'\n\n/**\n * A complete `outline` declaration at the official geometry. `offset` defaults\n * to the 2px the native controls use; the host's inline field rules sit at 1px\n * and a segmented tab pulls the ring inside itself at -2px.\n */\nexport function officialFocus(offset = '2px'): string {\n  return `outline: ${OFFICIAL_FOCUS_RING}; outline-offset: ${offset}`\n}\n\n/**\n * An elevated surface. The host draws a raised surface's edge inside its\n * shadow rather than as a border, so a card sets `border: 0` and takes the edge\n * from the elevation — which is also why its border stays off the alias-border\n * set that a flat, non-elevated rule would use.\n */\nexport function officialElevation(level: OfficialElevation): string {\n  return `border: 0; box-shadow: var(--dsw-elevation-${level})`\n}\n\n/**\n * An elevated surface whose edge should read as a specific hairline. Rebinding\n * the stroke colour is how a menu card picks l1 while a panel picks l3, without\n * the two growing apart by hand.\n */\nexport function officialStrokedElevation(level: OfficialElevation, color: string): string {\n  return `--dsw-elevation-stroke-color: ${color}; ${officialElevation(level)}`\n}\n\n/**\n * The shared stylesheet for a plugin UI, scoped under that plugin's root class.\n *\n * Scoping is what keeps this safe to always-bundle into every client: the rules\n * can only match inside the plugin's own subtree, so two plugins can both mount\n * `dsh-ui-card` without either styling the other's markup.\n *\n * Each recipe matches the root element *and* its descendants, because the\n * commonest arrangement is one element that is both — a surface that carries\n * the root class and `dsh-ui-card`, or a portaled dialog that is the root and\n * the `dsh-ui-surface`. A descendant-only scope would silently leave those\n * unstyled, with no error anywhere.\n *\n * A caveat worth knowing: `Modal` and `Menu` portal to `document.body`, so their\n * content leaves the plugin's subtree entirely. A portaled surface therefore\n * needs its own root class on an element inside the portal.\n *\n * Only patterns that primitives do not provide live here. If a control appears\n * below that `Button`/`Input`/`Switch`/`Tag`/`Menu` already covers, that is a\n * bug in this file: use the primitive and delete the recipe.\n */\nexport function officialUiCss(roots: string | readonly string[]): string {\n  // One plugin often mounts several unrelated surfaces (a settings seat, a chat\n  // card, a header menu), so the caller names every root. The rules below are\n  // nested under a single selector list and use `&`, which the browser expands\n  // per root — so one stylesheet covers all of them without duplicating itself.\n  const scope = (typeof roots === 'string' ? [roots] : roots).map(root => `.${root}`).join(', ')\n  const sheet = `\n/* Official DSH Web UI contract. Generated by @klarkxy/dsh-plugin-kit/official-ui.\n * Do not hand-edit the copy inside a plugin: change this module so every plugin\n * moves together. Scope: ${scope} */\n/* The scope rule below stays open for the whole sheet: every rule after it\n * nests with the parent selector, so one stylesheet can cover several unrelated\n * roots without leaking into a neighbouring plugin. Its closing brace is last. */\n${scope} {\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: 14px;\n  line-height: 22px;\n  min-width: 0;\n\n& *, & *::before, & *::after { box-sizing: border-box; }\n& h1, & h2, & h3, & h4, & p, & figure { margin: 0; }\n/* Keyboard focus only: pointer input keeps the native resting appearance. The\n * ring needs no radius of its own — the outline already follows the control's\n * own border-radius, and overriding it here would flatten every control. */\n& :focus-visible { ${officialFocus()}; }\n& [hidden] { display: none !important; }\n\n/* --- Type tiers. The same 14/22 and 13/20 steps the primitives use. --- */\n& .dsh-ui-title { font-size: 16px; line-height: 24px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n& .dsh-ui-heading { font-size: 14px; line-height: 22px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n& .dsh-ui-compact { font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-primary); }\n& .dsh-ui-meta { font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-secondary); }\n& .dsh-ui-hint { font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-tertiary); }\n& .dsh-ui-error { font-size: 12px; line-height: 18px; color: var(--dsw-alias-state-error-primary); }\n& .dsh-ui-warn { color: var(--dsw-alias-state-warn-primary); }\n& .dsh-ui-success { color: var(--dsw-alias-state-success-primary); }\n& .dsh-ui-muted { color: var(--dsw-alias-label-tertiary); }\n& .dsh-ui-truncate { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n& .dsh-ui-wrap { min-width: 0; overflow-wrap: anywhere; }\n\n/* --- Layout scaffolding. --- */\n& .dsh-ui-stack { display: flex; flex-direction: column; gap: 12px; }\n& .dsh-ui-stack-lg { display: flex; flex-direction: column; gap: 20px; }\n& .dsh-ui-row { display: flex; align-items: center; gap: 8px; min-width: 0; }\n& .dsh-ui-row-wrap { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; }\n& .dsh-ui-spacer { flex: 1; min-width: 0; }\n/* A 0.5px l2 rule is the host's section divider; reserve the same rhythm. */\n& .dsh-ui-divider { height: 0.5px; background: var(--dsw-alias-border-l2); }\n& .dsh-ui-section { display: flex; flex-direction: column; gap: 12px; padding-top: 16px; border-top: 0.5px solid var(--dsw-alias-border-l2); }\n\n/* --- Card: a raised surface whose edge lives in the shadow. --- */\n& .dsh-ui-card {\n  ${officialElevation('stroke')}\n  display: flex;\n  flex-direction: column;\n  gap: 12px;\n  padding: 16px;\n  border-radius: var(--dsw-radius-lg);\n  background: var(--dsw-alias-bg-layer-1);\n  color: var(--dsw-alias-label-primary);\n  min-width: 0;\n}\n& .dsh-ui-card--flat { border: 0.5px solid var(--dsw-alias-border-l3); box-shadow: none; }\n& .dsh-ui-card--nested { background: var(--dsw-alias-bg-layer-2); }\n& .dsh-ui-card--plain { background: none; }\n\n/* --- Field: label, control, help, error. The control itself is an\n * official primitive, so this only owns the vertical rhythm. --- */\n& .dsh-ui-field { display: flex; flex-direction: column; gap: 6px; min-width: 0; }\n& .dsh-ui-field + .dsh-ui-field { border-top: 0.5px solid var(--dsw-alias-border-l2); padding-top: 12px; }\n& .dsh-ui-label { display: flex; align-items: center; gap: 6px; font-size: 13px; line-height: 20px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n& .dsh-ui-label-row { display: flex; align-items: baseline; justify-content: space-between; gap: 8px; }\n& .dsh-ui-help { font-size: 12px; line-height: 1.6; color: var(--dsw-alias-label-secondary); }\n& .dsh-ui-help p { margin: 0; }\n& .dsh-ui-help p + p { margin-top: 8px; }\n& .dsh-ui-required { color: var(--dsw-alias-state-error-primary); }\n& .dsh-ui-control { width: 100%; min-width: 0; }\n/* An invalid control is marked on the control, not only in the message. */\n& .dsh-ui-control[aria-invalid='true'] { border-color: var(--dsw-alias-state-error-primary); }\n& .dsh-ui-readonly { display: flex; flex-direction: column; gap: 4px; min-width: 0; }\n& .dsh-ui-readonly > dt { font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-tertiary); }\n& .dsh-ui-readonly > dd { margin: 0; font-size: 13px; line-height: 20px; overflow-wrap: anywhere; }\n\n/* --- Buttons row. A no-op container: it exists so actions line up on the\n * trailing edge the way every native panel does. --- */\n& .dsh-ui-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; padding-top: 4px; }\n& .dsh-ui-actions-end { justify-content: flex-end; }\n\n/* --- Banners. A banner is a left-rail notice, the shape used for warnings,\n * deprecations and blocking instructions. --- */\n& .dsh-ui-banner {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  padding: 10px 14px;\n  border: 0.5px solid var(--dsw-alias-border-l3);\n  border-left: 3px solid var(--dsw-alias-state-warn-primary);\n  border-radius: var(--dsw-radius-md);\n  background: var(--dsw-alias-bg-layer-1);\n  font-size: 13px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-secondary);\n}\n& .dsh-ui-banner-title { font-weight: 500; color: var(--dsw-alias-state-warn-primary); }\n& .dsh-ui-banner--info { border-left-color: var(--dsw-alias-state-business-primary); }\n& .dsh-ui-banner--danger { border-left-color: var(--dsw-alias-state-error-primary); }\n& .dsh-ui-banner--success { border-left-color: var(--dsw-alias-state-success-primary); }\n& .dsh-ui-banner p { margin: 0; }\n\n/* --- Inline notice: a transient confirmation with no chrome of its own. --- */\n& .dsh-ui-notice { display: flex; align-items: center; gap: 6px; font-size: 12px; line-height: 18px; color: var(--dsw-alias-state-success-primary); }\n& .dsh-ui-notice--error { color: var(--dsw-alias-state-error-primary); }\n\n/* --- Empty and loading states. Both sit in a dashed well so an empty panel\n * reads as \"nothing here yet\" rather than as a broken layout. --- */\n& .dsh-ui-empty {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 6px;\n  padding: 20px 16px;\n  border: 0.5px dashed var(--dsw-alias-border-l3);\n  border-radius: var(--dsw-radius-md);\n  font-size: 13px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-secondary);\n}\n& .dsh-ui-loading { display: flex; align-items: center; gap: 8px; padding: 20px 0; font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-secondary); }\n\n/* --- Selectable list. A row is a button-sized target with a hover fill and\n * a selected fill; the name carries the weight, the description does not. --- */\n& .dsh-ui-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 2px; min-width: 0; }\n& .dsh-ui-list-scroll { max-height: min(66vh, 760px); overflow-y: auto; overflow-x: hidden; }\n& .dsh-ui-list-row { border-radius: var(--dsw-radius-md); }\n& .dsh-ui-list-row:hover { background: var(--dsw-alias-interactive-bg-hover); }\n& .dsh-ui-list-row[aria-selected='true'], & .dsh-ui-list-row[data-selected] { background: var(--dsw-alias-interactive-bg-active); }\n& .dsh-ui-list-item {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 4px;\n  width: 100%;\n  min-width: 0;\n  padding: 10px 12px;\n  border: 0;\n  border-radius: var(--dsw-radius-md);\n  background: none;\n  font: inherit;\n  color: inherit;\n  text-align: start;\n  cursor: pointer;\n}\n& .dsh-ui-list-item:disabled { cursor: default; }\n& .dsh-ui-list-item:disabled:hover { background: none; }\n& .dsh-ui-list-name { font-size: 14px; line-height: 22px; font-weight: 500; color: var(--dsw-alias-label-primary); overflow-wrap: anywhere; }\n& .dsh-ui-list-desc { font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-tertiary); }\n\n/* --- Code and structured output. Wraps rather than scrolls, because a\n * feature panel is read rather than scanned. --- */\n& .dsh-ui-code {\n  padding: 10px 12px;\n  border: 0.5px solid var(--dsw-alias-border-l3);\n  border-radius: var(--dsw-radius-md);\n  background: var(--dsw-alias-bg-layer-1);\n  font-family: var(--ds-font-family-code, ui-monospace, 'Cascadia Mono', Consolas, monospace);\n  font-size: 12px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-secondary);\n  overflow-wrap: anywhere;\n  white-space: pre-wrap;\n}\n& .dsh-ui-scroll { max-height: 60vh; overflow: auto; overscroll-behavior: contain; }\n\n/* --- A toggle row: label on the left, switch on the trailing edge. This is\n * layout only; the switch itself is the official primitive. --- */\n& .dsh-ui-toggle-row { display: flex; align-items: center; justify-content: space-between; gap: 16px; min-width: 0; padding: 12px 0; }\n& .dsh-ui-toggle-row + .dsh-ui-toggle-row { border-top: 0.5px solid var(--dsw-alias-border-l2); }\n& .dsh-ui-toggle-text { display: flex; flex-direction: column; gap: 4px; min-width: 0; }\n& .dsh-ui-toggle-label { font-size: 14px; line-height: 22px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n\n/* --- Floating surface: a panel anchored to a trigger. This is the material\n * a menu card is made of — the translucent fill plus its backdrop blur, with\n * the edge riding inside the prominent elevation. A plugin that hand-rolls this\n * is how tokens like --dsw-specific-menu get invented; use this instead. --- */\n& .dsh-ui-surface {\n  --dsw-elevation-stroke-color: var(--dsw-alias-border-l1);\n  --dsh-scrollbar-thumb: var(--dsw-alias-scrollbar-bg-l2);\n  --dsh-scrollbar-thumb-hover: var(--dsw-alias-scrollbar-hover-l2);\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  border: 0;\n  border-radius: var(--dsw-radius-lg);\n  background: var(--dsw-menu-surface-fill);\n  backdrop-filter: var(--dsw-menu-backdrop-filter);\n  box-shadow: var(--dsw-elevation-prominent);\n  color: var(--dsw-alias-label-primary);\n  font-size: 13px;\n  line-height: 20px;\n  min-width: 0;\n}\n& .dsh-ui-surface-body { display: flex; flex-direction: column; gap: 8px; padding: 12px 14px 14px; overflow-y: auto; }\n& .dsh-ui-surface-head { display: flex; align-items: center; gap: 8px; min-width: 0; }\n& .dsh-ui-surface-title { font-size: 14px; line-height: 22px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n\n/* --- Native select. The primitives ship no select, so a plugin that offers a\n * closed list of choices keeps the platform control and matches the official\n * settings field geometry exactly (34px, 0.5px l4, radius-md, layer-3). A\n * SegmentedControl is the primitive to reach for when the choices are few\n * enough to show at once. --- */\n& .dsh-ui-select {\n  box-sizing: border-box;\n  width: 100%;\n  min-width: 0;\n  height: 34px;\n  padding: 0 12px;\n  border: 0.5px solid var(--dsw-alias-border-l4);\n  border-radius: var(--dsw-radius-md);\n  background: var(--dsw-alias-bg-layer-3);\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n  cursor: pointer;\n}\n& .dsh-ui-select:focus-visible { outline: none; border-color: var(--dsw-alias-state-business-primary); }\n& .dsh-ui-select:disabled { color: var(--dsw-alias-label-tertiary); cursor: default; }\n& .dsh-ui-select[aria-invalid='true'] { border-color: var(--dsw-alias-state-error-primary); }\n\n/* Long panels scroll inside themselves instead of growing the host page. */\n& .dsh-ui-panel { display: flex; flex-direction: column; gap: 16px; min-width: 0; }\n& .dsh-ui-panel-wide { max-width: 100%; }\n\n@media (prefers-reduced-motion: reduce) {\n  & *, & *::before, & *::after { transition-duration: 0.01ms !important; animation-duration: 0.01ms !important; }\n}\n}\n`\n  // Widen every recipe from \"a descendant of the root\" to \"the root, or one of\n  // its descendants\". Written as a transform rather than by hand so no recipe\n  // can be added later with only the descendant form. The pattern is narrow on\n  // purpose: a leading `&` followed by one recipe class and no combinator, so\n  // sibling and child rules such as `.dsh-ui-field + .dsh-ui-field` keep their\n  // own meaning and are left alone.\n  return sheet.replace(/^& (\\.dsh-ui-[a-z0-9-]+)(?![+>~])/gm, (_match, className: string) =>\n    `&${className}, & ${className}`)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,wBAAwB;;CAEnC,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACA;CACF;;CAEA,QAAQ;EAAC;EAAyB;EAAyB;EAAyB;CAAuB;;CAE3G,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;CACF;;CAEA,aAAa;EACX;EACA;EACA;CACF;;CAEA,QAAQ;EACN;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CACA,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;;CAEA,QAAQ;EAAC;EAAmB;EAAmB;EAAmB;CAAoB;;CAEtF,WAAW;EACT;EACA;EACA;EACA;EACA;CACF;;CAEA,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;;CAEA,QAAQ;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;AAGA,MAAa,6BAAgD,OAAO,OAAO,qBAAqB,CAAC,CAAC,KAAK;;;;;;AAUvG,MAAa,sBACX;;;;;;AAOF,SAAgB,cAAc,SAAS,OAAe;CACpD,OAAO,YAAY,oBAAoB,oBAAoB;AAC7D;;;;;;;AAQA,SAAgB,kBAAkB,OAAkC;CAClE,OAAO,8CAA8C,MAAM;AAC7D;;;;;;AAOA,SAAgB,yBAAyB,OAA0B,OAAuB;CACxF,OAAO,iCAAiC,MAAM,IAAI,kBAAkB,KAAK;AAC3E;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,cAAc,OAA2C;CAKvE,MAAM,SAAS,OAAO,UAAU,WAAW,CAAC,KAAK,IAAI,MAAA,CAAO,KAAI,SAAQ,IAAI,MAAM,CAAC,CAAC,KAAK,IAAI;CAgP7F,OAAO;;;4BA5OmB,MAAM;;;;EAIhC,MAAM;;;;;;;;;;;;qBAYa,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BjC,kBAAkB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgMjB,QAAQ,wCAAwC,QAAQ,cACnE,IAAI,UAAU,MAAM,WAAW;AACnC"}
+{"version":3,"file":"official-ui.js","names":[],"sources":["../src/official-ui.ts"],"sourcesContent":["/**\n * Shared contract that keeps every plugin's browser-side UI on the official\n * DeepSeek Harness Web design language.\n *\n * Two rules produce that language, and both are load-bearing here:\n *\n * 1. Colour, radius, elevation and focus come from the host theme's real\n *    `--dsw-*` tokens, written under their own names. Plugins never invent a\n *    token, never alias the official ones behind a private palette (a private\n *    alias is just a second, diverging theme), and never carries a literal\n *    fallback — the host publishes light and dark, and a literal would pin one\n *    of them. The only non-colour custom properties used are the host's own\n *    content-font axis and frame clearance.\n *\n * 2. Anything the host already ships is used, not reimplemented. Controls come\n *    from `@deepseek-ai/dsh-client-ui-primitives` (`Button`, `Input`,\n *    `Checkbox`, `Switch`, `Tag`, `Pill`, `SegmentedControl`, `Menu`, `Modal`,\n *    `Tooltip`, `Toast`, `DisclosureRow`, `StateDot`, `PathLabel`, the settings\n *    form suite). This module only styles what primitives do not cover: page\n *    scaffolding, field layout, banners, empty states and scroll regions.\n *\n * The metrics below are transcribed from the primitives' own CSS modules so a\n * feature panel lines up pixel-for-pixel with a native one: the 14/22 body and\n * 13/20 compact type tiers, the 0.5px hairline scale, and the elevation family\n * that draws a surface's edge in its shadow (`border: 0`) instead of a border.\n */\n\n/**\n * Every `--dsw-*` token this repo is allowed to reference, grouped by role.\n *\n * Plugins may only colour through this list. It is exported so the guard test\n * can fail a build when a stylesheet reaches for anything else — the failure\n * mode this prevents is silent: an unknown token resolves to nothing, so a\n * border disappears or a label inherits the wrong colour with no error anywhere.\n */\nexport const OFFICIAL_THEME_TOKENS = {\n  /** Surfaces, from the page up to the topmost nested card. */\n  surface: [\n    '--dsw-alias-bg-base',\n    '--dsw-alias-bg-layer-1',\n    '--dsw-alias-bg-layer-2',\n    '--dsw-alias-bg-layer-3',\n    '--dsw-alias-bg-layer-4',\n    '--dsw-alias-bg-module-platform',\n    '--dsw-alias-bg-overlay',\n  ],\n  /** Hairlines. l1 is near-invisible on a menu surface, so menus use l2+. */\n  border: ['--dsw-alias-border-l1', '--dsw-alias-border-l2', '--dsw-alias-border-l3', '--dsw-alias-border-l4'],\n  /** Text. `caption` is menu shortcut text, `dimmed` is placeholder text. */\n  label: [\n    '--dsw-alias-label-primary',\n    '--dsw-alias-label-secondary',\n    '--dsw-alias-label-tertiary',\n    '--dsw-alias-label-caption',\n    '--dsw-alias-label-dimmed',\n    '--dsw-alias-label-error',\n    '--dsw-alias-label-primary-foreground',\n  ],\n  /** Interactive fills. The `-danger` hover belongs to destructive rows. */\n  interactive: [\n    '--dsw-alias-interactive-bg-hover',\n    '--dsw-alias-interactive-bg-active',\n    '--dsw-alias-interactive-bg-hover-danger',\n  ],\n  /** Accent and status. `business` is the focus ring's default colour. */\n  accent: [\n    '--dsw-alias-brand-primary',\n    '--dsw-alias-button-primary-fill',\n    '--dsw-alias-button-primary-hover',\n    '--dsw-alias-button-tool-bar-fill',\n    '--dsw-alias-button-tool-bar-hover',\n    '--dsw-alias-button-ghost-active-fill',\n    '--dsw-alias-button-ghost-active-border',\n  ],\n  state: [\n    '--dsw-alias-state-business-primary',\n    '--dsw-alias-state-success-primary',\n    '--dsw-alias-state-warn-primary',\n    '--dsw-alias-state-error-primary',\n    '--dsw-alias-state-idle-primary',\n  ],\n  /** Corner scale: sm 8, md 12, lg the large card, panel the modal. */\n  radius: ['--dsw-radius-sm', '--dsw-radius-md', '--dsw-radius-lg', '--dsw-radius-panel'],\n  /** An elevated surface draws its edge in the shadow, so it keeps border: 0. */\n  elevation: [\n    '--dsw-elevation-soft',\n    '--dsw-elevation-stroke',\n    '--dsw-elevation-stroke-color',\n    '--dsw-elevation-panel',\n    '--dsw-elevation-prominent',\n  ],\n  /** Floats, masks and scrollbars. */\n  overlay: [\n    '--dsw-menu-surface-fill',\n    '--dsw-menu-backdrop-filter',\n    '--dsw-mask-blur',\n    '--dsw-alias-bg-mask-1',\n    '--dsw-alias-menu-icon',\n    '--dsw-alias-scrollbar-bg-l2',\n    '--dsw-alias-scrollbar-hover-l2',\n    '--dsw-shadow-lv3',\n  ],\n  /** Motion, focus and type axis, published by the host rather than by a component. */\n  system: [\n    '--dsw-focus-ring-width',\n    '--dsw-focus-ring-color',\n    '--dsw-font-markdown-code-font-family',\n    '--ds-transition-duration',\n    '--ds-ease-in-out',\n    '--ds-font-family-code',\n    '--dsh-scrollbar-thumb',\n    '--dsh-scrollbar-thumb-hover',\n    '--dsh-content-font-size-secondary',\n    '--dsh-content-font-delta',\n    '--dsh-frame-top-clearance',\n  ],\n} as const\n\n/** Every official token name, flat. Used by the token guard test. */\nexport const OFFICIAL_THEME_TOKEN_NAMES: readonly string[] = Object.values(OFFICIAL_THEME_TOKENS).flat()\n\n/** The elevation steps a surface can be raised by, softest first. */\nexport type OfficialElevation = 'soft' | 'stroke' | 'panel' | 'prominent'\n\n/**\n * The host's focus ring shorthand, verbatim. Writing this per control is how\n * rings drift apart; a stylesheet that draws its own focus style should use\n * {@link officialFocus} instead. The colour fallback is the host's own default.\n */\nexport const OFFICIAL_FOCUS_RING =\n  'var(--dsw-focus-ring-width) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary))'\n\n/**\n * A complete `outline` declaration at the official geometry. `offset` defaults\n * to the 2px the native controls use; the host's inline field rules sit at 1px\n * and a segmented tab pulls the ring inside itself at -2px.\n */\nexport function officialFocus(offset = '2px'): string {\n  return `outline: ${OFFICIAL_FOCUS_RING}; outline-offset: ${offset}`\n}\n\n/**\n * An elevated surface. The host draws a raised surface's edge inside its\n * shadow rather than as a border, so a card sets `border: 0` and takes the edge\n * from the elevation — which is also why its border stays off the alias-border\n * set that a flat, non-elevated rule would use.\n */\nexport function officialElevation(level: OfficialElevation): string {\n  return `border: 0; box-shadow: var(--dsw-elevation-${level})`\n}\n\n/**\n * An elevated surface whose edge should read as a specific hairline. Rebinding\n * the stroke colour is how a menu card picks l1 while a panel picks l3, without\n * the two growing apart by hand.\n */\nexport function officialStrokedElevation(level: OfficialElevation, color: string): string {\n  return `--dsw-elevation-stroke-color: ${color}; ${officialElevation(level)}`\n}\n\n/**\n * The shared stylesheet for a plugin UI, scoped under that plugin's root class.\n *\n * Scoping is what keeps this safe to always-bundle into every client: the rules\n * can only match inside the plugin's own subtree, so two plugins can both mount\n * `dsh-ui-card` without either styling the other's markup.\n *\n * Each recipe matches the root element *and* its descendants, because the\n * commonest arrangement is one element that is both — a surface that carries\n * the root class and `dsh-ui-card`, or a portaled dialog that is the root and\n * the `dsh-ui-surface`. A descendant-only scope would silently leave those\n * unstyled, with no error anywhere.\n *\n * A caveat worth knowing: `Modal` and `Menu` portal to `document.body`, so their\n * content leaves the plugin's subtree entirely. A portaled surface therefore\n * needs its own root class on an element inside the portal.\n *\n * Only patterns that primitives do not provide live here. If a control appears\n * below that `Button`/`Input`/`Switch`/`Tag`/`Menu` already covers, that is a\n * bug in this file: use the primitive and delete the recipe.\n */\nexport function officialUiCss(roots: string | readonly string[]): string {\n  // One plugin often mounts several unrelated surfaces (a settings seat, a chat\n  // card, a header menu), so the caller names every root. The rules below are\n  // nested under a single selector list and use `&`, which the browser expands\n  // per root — so one stylesheet covers all of them without duplicating itself.\n  const scope = (typeof roots === 'string' ? [roots] : roots).map(root => `.${root}`).join(', ')\n  const sheet = `\n/* Official DSH Web UI contract. Generated by @klarkxy/dsh-plugin-kit/official-ui.\n * Do not hand-edit the copy inside a plugin: change this module so every plugin\n * moves together. Scope: ${scope} */\n/* The scope rule below stays open for the whole sheet: every rule after it\n * nests with the parent selector, so one stylesheet can cover several unrelated\n * roots without leaking into a neighbouring plugin. Its closing brace is last. */\n${scope} {\n  color: var(--dsw-alias-label-primary);\n  font-family: inherit;\n  font-size: 14px;\n  line-height: 22px;\n  min-width: 0;\n\n& *, & *::before, & *::after { box-sizing: border-box; }\n& h1, & h2, & h3, & h4, & p, & figure { margin: 0; }\n/* Keyboard focus only: pointer input keeps the native resting appearance. The\n * ring needs no radius of its own — the outline already follows the control's\n * own border-radius, and overriding it here would flatten every control. */\n& :focus-visible { ${officialFocus()}; }\n& [hidden] { display: none !important; }\n\n/* --- Type tiers. The same 14/22 and 13/20 steps the primitives use. --- */\n& .dsh-ui-title { font-size: 16px; line-height: 24px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n& .dsh-ui-heading { font-size: 14px; line-height: 22px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n& .dsh-ui-compact { font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-primary); }\n& .dsh-ui-meta { font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-secondary); }\n& .dsh-ui-hint { font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-tertiary); }\n& .dsh-ui-error { font-size: 12px; line-height: 18px; color: var(--dsw-alias-state-error-primary); }\n& .dsh-ui-warn { color: var(--dsw-alias-state-warn-primary); }\n& .dsh-ui-success { color: var(--dsw-alias-state-success-primary); }\n& .dsh-ui-muted { color: var(--dsw-alias-label-tertiary); }\n& .dsh-ui-truncate { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n& .dsh-ui-wrap { min-width: 0; overflow-wrap: anywhere; }\n\n/* --- Layout scaffolding. --- */\n& .dsh-ui-stack { display: flex; flex-direction: column; gap: 12px; }\n& .dsh-ui-stack-lg { display: flex; flex-direction: column; gap: 20px; }\n& .dsh-ui-row { display: flex; align-items: center; gap: 8px; min-width: 0; }\n& .dsh-ui-row-wrap { display: flex; align-items: center; flex-wrap: wrap; gap: 8px; }\n& .dsh-ui-spacer { flex: 1; min-width: 0; }\n/* A 0.5px l2 rule is the host's section divider; reserve the same rhythm. */\n& .dsh-ui-divider { height: 0.5px; background: var(--dsw-alias-border-l2); }\n& .dsh-ui-section { display: flex; flex-direction: column; gap: 12px; padding-top: 16px; border-top: 0.5px solid var(--dsw-alias-border-l2); }\n\n/* --- Card: a raised surface whose edge lives in the shadow. --- */\n& .dsh-ui-card {\n  ${officialElevation('stroke')}\n  display: flex;\n  flex-direction: column;\n  gap: 12px;\n  padding: 16px;\n  border-radius: var(--dsw-radius-lg);\n  background: var(--dsw-alias-bg-layer-1);\n  color: var(--dsw-alias-label-primary);\n  min-width: 0;\n}\n& .dsh-ui-card--flat { border: 0.5px solid var(--dsw-alias-border-l3); box-shadow: none; }\n& .dsh-ui-card--nested { background: var(--dsw-alias-bg-layer-2); }\n& .dsh-ui-card--plain { background: none; }\n\n/* --- Field: label, control, help, error. The control itself is an\n * official primitive, so this only owns the vertical rhythm. --- */\n& .dsh-ui-field { display: flex; flex-direction: column; gap: 6px; min-width: 0; }\n& .dsh-ui-field + .dsh-ui-field { border-top: 0.5px solid var(--dsw-alias-border-l2); padding-top: 12px; }\n& .dsh-ui-label { display: flex; align-items: center; gap: 6px; font-size: 13px; line-height: 20px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n& .dsh-ui-label-row { display: flex; align-items: baseline; justify-content: space-between; gap: 8px; }\n& .dsh-ui-help { font-size: 12px; line-height: 1.6; color: var(--dsw-alias-label-secondary); }\n& .dsh-ui-help p { margin: 0; }\n& .dsh-ui-help p + p { margin-top: 8px; }\n& .dsh-ui-required { color: var(--dsw-alias-state-error-primary); }\n& .dsh-ui-control { width: 100%; min-width: 0; }\n/* An invalid control is marked on the control, not only in the message. */\n& .dsh-ui-control[aria-invalid='true'] { border-color: var(--dsw-alias-state-error-primary); }\n& .dsh-ui-readonly { display: flex; flex-direction: column; gap: 4px; min-width: 0; }\n& .dsh-ui-readonly > dt { font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-tertiary); }\n& .dsh-ui-readonly > dd { margin: 0; font-size: 13px; line-height: 20px; overflow-wrap: anywhere; }\n\n/* --- Buttons row. A no-op container: it exists so actions line up on the\n * trailing edge the way every native panel does. --- */\n& .dsh-ui-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; padding-top: 4px; }\n& .dsh-ui-actions-end { justify-content: flex-end; }\n\n/* --- Banners. A banner is a left-rail notice, the shape used for warnings,\n * deprecations and blocking instructions. --- */\n& .dsh-ui-banner {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  padding: 10px 14px;\n  border: 0.5px solid var(--dsw-alias-border-l3);\n  border-left: 3px solid var(--dsw-alias-state-warn-primary);\n  border-radius: var(--dsw-radius-md);\n  background: var(--dsw-alias-bg-layer-1);\n  font-size: 13px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-secondary);\n}\n& .dsh-ui-banner-title { font-weight: 500; color: var(--dsw-alias-state-warn-primary); }\n& .dsh-ui-banner--info { border-left-color: var(--dsw-alias-state-business-primary); }\n& .dsh-ui-banner--danger { border-left-color: var(--dsw-alias-state-error-primary); }\n& .dsh-ui-banner--success { border-left-color: var(--dsw-alias-state-success-primary); }\n& .dsh-ui-banner p { margin: 0; }\n\n/* --- Inline notice: a transient confirmation with no chrome of its own. --- */\n& .dsh-ui-notice { display: flex; align-items: center; gap: 6px; font-size: 12px; line-height: 18px; color: var(--dsw-alias-state-success-primary); }\n& .dsh-ui-notice--error { color: var(--dsw-alias-state-error-primary); }\n\n/* --- Empty and loading states. Both sit in a dashed well so an empty panel\n * reads as \"nothing here yet\" rather than as a broken layout. --- */\n& .dsh-ui-empty {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 6px;\n  padding: 20px 16px;\n  border: 0.5px dashed var(--dsw-alias-border-l3);\n  border-radius: var(--dsw-radius-md);\n  font-size: 13px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-secondary);\n}\n& .dsh-ui-loading { display: flex; align-items: center; gap: 8px; padding: 20px 0; font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-secondary); }\n\n/* --- Selectable list. A row is a button-sized target with a hover fill and\n * a selected fill; the name carries the weight, the description does not. --- */\n& .dsh-ui-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 2px; min-width: 0; }\n& .dsh-ui-list-scroll { max-height: min(66vh, 760px); overflow-y: auto; overflow-x: hidden; }\n& .dsh-ui-list-row { border-radius: var(--dsw-radius-md); }\n& .dsh-ui-list-row:hover { background: var(--dsw-alias-interactive-bg-hover); }\n& .dsh-ui-list-row[aria-selected='true'], & .dsh-ui-list-row[data-selected] { background: var(--dsw-alias-interactive-bg-active); }\n& .dsh-ui-list-item {\n  display: flex;\n  flex-direction: column;\n  align-items: flex-start;\n  gap: 4px;\n  width: 100%;\n  min-width: 0;\n  padding: 10px 12px;\n  border: 0;\n  border-radius: var(--dsw-radius-md);\n  background: none;\n  font: inherit;\n  color: inherit;\n  text-align: start;\n  cursor: pointer;\n}\n& .dsh-ui-list-item:disabled { cursor: default; }\n& .dsh-ui-list-item:disabled:hover { background: none; }\n& .dsh-ui-list-name { font-size: 14px; line-height: 22px; font-weight: 500; color: var(--dsw-alias-label-primary); overflow-wrap: anywhere; }\n& .dsh-ui-list-desc { font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-tertiary); }\n\n/* --- Code and structured output. Wraps rather than scrolls, because a\n * feature panel is read rather than scanned. --- */\n& .dsh-ui-code {\n  padding: 10px 12px;\n  border: 0.5px solid var(--dsw-alias-border-l3);\n  border-radius: var(--dsw-radius-md);\n  background: var(--dsw-alias-bg-layer-1);\n  font-family: var(--ds-font-family-code);\n  font-size: 12px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-secondary);\n  overflow-wrap: anywhere;\n  white-space: pre-wrap;\n}\n& .dsh-ui-scroll { max-height: 60vh; overflow: auto; overscroll-behavior: contain; }\n\n/* --- A toggle row: label on the left, switch on the trailing edge. This is\n * layout only; the switch itself is the official primitive. --- */\n& .dsh-ui-toggle-row { display: flex; align-items: center; justify-content: space-between; gap: 16px; min-width: 0; padding: 12px 0; }\n& .dsh-ui-toggle-row + .dsh-ui-toggle-row { border-top: 0.5px solid var(--dsw-alias-border-l2); }\n& .dsh-ui-toggle-text { display: flex; flex-direction: column; gap: 4px; min-width: 0; }\n& .dsh-ui-toggle-label { font-size: 14px; line-height: 22px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n\n/* --- Floating surface: a panel anchored to a trigger. This is the material\n * a menu card is made of — the translucent fill plus its backdrop blur, with\n * the edge riding inside the prominent elevation. A plugin that hand-rolls this\n * is how tokens like --dsw-specific-menu get invented; use this instead. --- */\n& .dsh-ui-surface {\n  --dsw-elevation-stroke-color: var(--dsw-alias-border-l1);\n  --dsh-scrollbar-thumb: var(--dsw-alias-scrollbar-bg-l2);\n  --dsh-scrollbar-thumb-hover: var(--dsw-alias-scrollbar-hover-l2);\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  border: 0;\n  border-radius: var(--dsw-radius-lg);\n  background: var(--dsw-menu-surface-fill);\n  backdrop-filter: var(--dsw-menu-backdrop-filter);\n  box-shadow: var(--dsw-elevation-prominent);\n  color: var(--dsw-alias-label-primary);\n  font-size: 13px;\n  line-height: 20px;\n  min-width: 0;\n}\n& .dsh-ui-surface-body { display: flex; flex-direction: column; gap: 8px; padding: 12px 14px 14px; overflow-y: auto; }\n& .dsh-ui-surface-head { display: flex; align-items: center; gap: 8px; min-width: 0; }\n& .dsh-ui-surface-title { font-size: 14px; line-height: 22px; font-weight: 500; color: var(--dsw-alias-label-primary); }\n\n/* --- Native select. The primitives ship no select, so a plugin that offers a\n * closed list of choices keeps the platform control and matches the official\n * settings field geometry exactly (34px, 0.5px l4, radius-md, layer-3). A\n * SegmentedControl is the primitive to reach for when the choices are few\n * enough to show at once. --- */\n& .dsh-ui-select {\n  box-sizing: border-box;\n  width: 100%;\n  min-width: 0;\n  height: 34px;\n  padding: 0 12px;\n  border: 0.5px solid var(--dsw-alias-border-l4);\n  border-radius: var(--dsw-radius-md);\n  background: var(--dsw-alias-bg-layer-3);\n  font: inherit;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n  cursor: pointer;\n}\n& .dsh-ui-select:focus-visible { outline: none; border-color: var(--dsw-alias-state-business-primary); }\n& .dsh-ui-select:disabled { color: var(--dsw-alias-label-tertiary); cursor: default; }\n& .dsh-ui-select[aria-invalid='true'] { border-color: var(--dsw-alias-state-error-primary); }\n\n/* Long panels scroll inside themselves instead of growing the host page. */\n& .dsh-ui-panel { display: flex; flex-direction: column; gap: 16px; min-width: 0; }\n& .dsh-ui-panel-wide { max-width: 100%; }\n\n@media (prefers-reduced-motion: reduce) {\n  & *, & *::before, & *::after { transition-duration: 0.01ms !important; animation-duration: 0.01ms !important; }\n}\n}\n`\n  // Widen every recipe from \"a descendant of the root\" to \"the root, or one of\n  // its descendants\". Written as a transform rather than by hand so no recipe\n  // can be added later with only the descendant form. The pattern is narrow on\n  // purpose: a leading `&` followed by one recipe class and no combinator, so\n  // sibling and child rules such as `.dsh-ui-field + .dsh-ui-field` keep their\n  // own meaning and are left alone.\n  return sheet.replace(/^& (\\.dsh-ui-[a-z0-9-]+)(?![+>~])/gm, (_match, className: string) =>\n    `&${className}, & ${className}`)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,wBAAwB;;CAEnC,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACA;CACF;;CAEA,QAAQ;EAAC;EAAyB;EAAyB;EAAyB;CAAuB;;CAE3G,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;CACF;;CAEA,aAAa;EACX;EACA;EACA;CACF;;CAEA,QAAQ;EACN;EACA;EACA;EACA;EACA;EACA;EACA;CACF;CACA,OAAO;EACL;EACA;EACA;EACA;EACA;CACF;;CAEA,QAAQ;EAAC;EAAmB;EAAmB;EAAmB;CAAoB;;CAEtF,WAAW;EACT;EACA;EACA;EACA;EACA;CACF;;CAEA,SAAS;EACP;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;;CAEA,QAAQ;EACN;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF;;AAGA,MAAa,6BAAgD,OAAO,OAAO,qBAAqB,CAAC,CAAC,KAAK;;;;;;AAUvG,MAAa,sBACX;;;;;;AAOF,SAAgB,cAAc,SAAS,OAAe;CACpD,OAAO,YAAY,oBAAoB,oBAAoB;AAC7D;;;;;;;AAQA,SAAgB,kBAAkB,OAAkC;CAClE,OAAO,8CAA8C,MAAM;AAC7D;;;;;;AAOA,SAAgB,yBAAyB,OAA0B,OAAuB;CACxF,OAAO,iCAAiC,MAAM,IAAI,kBAAkB,KAAK;AAC3E;;;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,cAAc,OAA2C;CAKvE,MAAM,SAAS,OAAO,UAAU,WAAW,CAAC,KAAK,IAAI,MAAA,CAAO,KAAI,SAAQ,IAAI,MAAM,CAAC,CAAC,KAAK,IAAI;CAgP7F,OAAO;;;4BA5OmB,MAAM;;;;EAIhC,MAAM;;;;;;;;;;;;qBAYa,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BjC,kBAAkB,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgMjB,QAAQ,wCAAwC,QAAQ,cACnE,IAAI,UAAU,MAAM,WAAW;AACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klarkxy/dsh-plugin-kit",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Shared types, model-menu helpers, and host RPC registration. Does not call models.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -25,6 +25,16 @@
       "import": "./lib/host-rpc.js",
       "default": "./lib/host-rpc.js"
     },
+    "./domain": {
+      "types": "./lib/domain.d.ts",
+      "import": "./lib/domain.js",
+      "default": "./lib/domain.js"
+    },
+    "./model-settings": {
+      "types": "./lib/model-settings.d.ts",
+      "import": "./lib/model-settings.js",
+      "default": "./lib/model-settings.js"
+    },
     "./client-utils": {
       "types": "./lib/client-utils.d.ts",
       "import": "./lib/client-utils.js",
@@ -45,7 +55,22 @@
       "import": "./lib/official-ui.js",
       "default": "./lib/official-ui.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./model-settings-client": {
+      "types": "./lib/model-settings-client.d.ts",
+      "import": "./lib/model-settings-client.js",
+      "default": "./lib/model-settings-client.js"
+    },
+    "./cli-process": {
+      "import": "./lib/cli-process.js",
+      "default": "./lib/cli-process.js",
+      "types": "./lib/cli-process.d.ts"
+    },
+    "./cli-media": {
+      "import": "./lib/cli-media.js",
+      "default": "./lib/cli-media.js",
+      "types": "./lib/cli-media.d.ts"
+    }
   },
   "files": [
     "lib",
@@ -58,9 +83,15 @@
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "test": "vitest run --root ../.. --config vitest.editor-plugins.config.ts --maxWorkers=2 plugins/dsh-plugin-kit/src"
   },
+  "dependencies": {
+    "@klarkxy/dsh-model-route": "0.2.0"
+  },
   "peerDependencies": {
-    "@deepseek-ai/dsh-llm": ">=0.1.7-rc.2",
-    "react": "^18.2.0"
+    "@deepseek-ai/dsh-llm": ">=0.2.0-rc.2",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-attachment": ">=0.2.0-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-llm": {
@@ -68,12 +99,30 @@
     },
     "react": {
       "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-typert-protocol": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-attachment": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
-    "react": "^18.2.0",
-    "@types/react": "18.3.31"
+    "zod": "4.5.4",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-storage-domain": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-storage-json": "0.2.0-rc.2",
+    "@types/react": "18.3.31",
+    "@types/react-dom": "^18.3.0",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-api-gateway": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.2.0-rc.2"
   },
   "keywords": [
     "dsh",
@@ -90,6 +139,6 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dshRelease": {
-    "contentHash": "ab243984edb562899e4f9e0bb6eed29c13e78592d53b360b538cbf40897b658a"
+    "contentHash": "f0d555b8f7f8ce7617868b3a33eb8e2b85fcfe3e10ebde4688fa8864cae6efa2"
   }
 }