dsh-llm-fallbacks 0.1.2 → 0.1.4

package/dist/client/locales.d.ts

@@ -34,6 +34,9 @@ export declare const zh: {
     'alwaysModeRetryCap.label': string;
     'alwaysModeRetryCap.hint': string;
     'alwaysModeRetryCap.tooltip': string;
+    'advanced.label': string;
+    'advanced.expand': string;
+    'advanced.collapse': string;
     'rootChain.label': string;
     'rootChain.hint': string;
     'rootChain.tooltip': string;
@@ -41,16 +44,16 @@ export declare const zh: {
     'chains.selector.remove': string;
     'chains.selector.providerPlaceholder': string;
     'chains.selector.modelPlaceholder': string;
-    'chains.selector.wildcard': string;
-    'chains.selector.noModels': string;
+    'chains.selector.wildcardLegacy': string;
+    'chains.selector.noModelsStrict': string;
     'roles.list.label': string;
     'roles.list.hint': string;
     'roles.list.tooltip': string;
     'roles.id': string;
     'roles.id.hint': string;
     'roles.idPlaceholder': string;
-    'roles.label': string;
-    'roles.description': string;
+    'roles.persona': string;
+    'roles.personaPlaceholder': string;
     'roles.fallback': string;
     'roles.fallback.inherit-root': string;
     'roles.fallback.none': string;
@@ -163,6 +166,9 @@ export declare const en: {
     'alwaysModeRetryCap.label': string;
     'alwaysModeRetryCap.hint': string;
     'alwaysModeRetryCap.tooltip': string;
+    'advanced.label': string;
+    'advanced.expand': string;
+    'advanced.collapse': string;
     'rootChain.label': string;
     'rootChain.hint': string;
     'rootChain.tooltip': string;
@@ -170,16 +176,16 @@ export declare const en: {
     'chains.selector.remove': string;
     'chains.selector.providerPlaceholder': string;
     'chains.selector.modelPlaceholder': string;
-    'chains.selector.wildcard': string;
-    'chains.selector.noModels': string;
+    'chains.selector.wildcardLegacy': string;
+    'chains.selector.noModelsStrict': string;
     'roles.list.label': string;
     'roles.list.hint': string;
     'roles.list.tooltip': string;
     'roles.id': string;
     'roles.id.hint': string;
     'roles.idPlaceholder': string;
-    'roles.label': string;
-    'roles.description': string;
+    'roles.persona': string;
+    'roles.personaPlaceholder': string;
     'roles.fallback': string;
     'roles.fallback.inherit-root': string;
     'roles.fallback.none': string;

package/dist/config.d.ts

@@ -1,10 +1,13 @@
 /**
- * The `fallbacks` settings namespace: plugin config schema + defaults.
+ * The `fallbacks` settings namespace: config types + defaults (the
+ * schemastery `Config` schema lives in `./schema.ts`, host-only — this
+ * module must stay free of `@deepseek-ai/*` value imports so the client
+ * bundle never reaches schemastery).
  *
  * Two-block config model (plan fallbacks-role-config-model): block 1
  * `rootChain` — the root agent's single fallback chain (empty = no
  * degradation) — plus block 2 declared role entities: `roles.list`
- * (id/label/description/prompt?/permissions?/chain?/fallback) and
+ * (id/persona/prompt?/permissions?/chain?/fallback) and
  * `roles.rules` enum references into the declared ids (or the built-in
  * `'inherit'` role). The legacy `chains` / `roles.default` keys are gone
  * from the schema and type (zero residual, migration table excepted); the
@@ -19,12 +22,11 @@
  *
  * This module is pure logic: it must not import any `@deepseek-ai/*` package
  * (types included) — `FallbacksConfig` is the plugin's own type. Task 3
- * registers this schema with `installSettingsSection` under the `fallbacks`
- * settings namespace.
+ * registers the schemastery schema (see `./schema.ts`) with
+ * `installSettingsSection` under the `fallbacks` settings namespace.
  *
  * @module dsh-llm-fallbacks/config
  */
-import z from '@deepseek-ai/schemastery';
 /** How a cooled-down model comes back (spec §4). */
 export type RevertPolicy = 'cooldown-expiry' | 'never';
 /** A single role rule: match on origin/provider/model patterns (spec §3). */
@@ -49,8 +51,8 @@ export type FallbackStrategy = 'inherit-root' | 'none';
  */
 export interface FallbacksRole {
     id: string;
-    label: string;
-    description: string;
+    /** Personality hint (人格提示) — free text, never validated. */
+    persona: string;
     /** Reserved for next iteration — no consumer this round. */
     prompt?: string;
     /** Reserved for next iteration — no consumer this round. */
@@ -110,7 +112,7 @@ export interface FallbacksConfigLogger {
  * `rootChain`/role-chain selector legality, and the role model-config
  * requirement (a declared role with a missing/empty chain warns — a role
  * without a model config is meaningless, plan fallbacks-feedback-round
- * T2). `label`/`description` are free text and are deliberately not
+ * T2). `persona` is free text and is deliberately not
  * validated. Each violation emits one `llm-fallbacks: ...` warn and "does
  * not take effect" — the config stays usable (spec §4 / AC-4
  * warn-not-crash semantics).
@@ -119,21 +121,13 @@ export declare function validateFallbacksConfig(config: FallbacksConfig, logger:
 /**
  * Detect legacy (two-block-era) leftovers in a config SOURCE — the composed
  * object `source()` returns, or a raw settings document. Recognizes the
- * removed `chains` key, the removed `roles.default` field, and
- * `roles.rules[].role` values that reference no declared `roles.list` id
- * and are not the built-in `'inherit'`. Returns descriptive key/role names;
- * the gateway attaches them as `get().legacyKeys` so the client can show a
- * migration banner (spec §9 — the source is read directly because
- * schemastery retains unknown keys, verified plan Task 1 Step 1).
+ * removed `chains` key, the removed `roles.default` field, the removed
+ * role-entity fields `roles.list[].label` / `roles.list[].description`
+ * (renamed to `persona`), and `roles.rules[].role` values that reference no
+ * declared `roles.list` id and are not the built-in `'inherit'`. Returns
+ * descriptive key/role names; the gateway attaches them as `get().legacyKeys`
+ * so the client can show a migration banner (spec §9 — the source is read
+ * directly because schemastery retains unknown keys, verified plan Task 1
+ * Step 1).
  */
 export declare function detectLegacyKeys(source: Record<string, unknown>): string[];
-/**
- * Plugin Config schema (schemastery), mirroring {@link FallbacksConfig}.
- * Object fields are optional by default in schemastery; `.default()` fills
- * the spec defaults, `.required()` keeps mandatory fields. Unknown keys are
- * RETAINED by the composition (verified plan Task 1 Step 1) — that is what
- * lets `detectLegacyKeys` flag two-block-era leftovers (`chains` /
- * `roles.default`) on the composed object at startup (warn + gateway
- * `legacyKeys`, see `src/index.ts` apply()).
- */
-export declare const Config: z<FallbacksConfig>;

package/dist/index.d.ts

@@ -29,7 +29,8 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import type { Session } from '@deepseek-ai/dsh-session';
-import { Config, detectLegacyKeys, validateFallbacksConfig, type FallbacksConfig } from './config.ts';
+import { detectLegacyKeys, validateFallbacksConfig, type FallbacksConfig } from './config.ts';
+import { Config } from './schema.ts';
 import { resolveChain } from './chains.ts';
 import { resolveRole } from './roles.ts';
 import { FallbackStateStore } from './state.ts';

package/dist/index.js

@@ -86,8 +86,11 @@ function detectLegacyKeys(source) {
 	if (isRecordLike(roles)) {
 		if (Object.hasOwn(roles, "default")) keys.push("roles.default");
 		const declared = new Set();
-		if (Array.isArray(roles.list)) {
-			for (const item of roles.list) if (isRecordLike(item) && typeof item.id === "string") declared.add(item.id);
+		if (Array.isArray(roles.list)) for (const item of roles.list) {
+			if (!isRecordLike(item)) continue;
+			if (typeof item.id === "string") declared.add(item.id);
+			if (Object.hasOwn(item, "label")) keys.push("roles.list[].label");
+			if (Object.hasOwn(item, "description")) keys.push("roles.list[].description");
 		}
 		if (Array.isArray(roles.rules)) {
 			for (const rule of roles.rules) if (isRecordLike(rule) && typeof rule.role === "string" && rule.role !== "inherit" && !declared.has(rule.role)) keys.push(`roles.rules[].role: ${rule.role}`);
@@ -98,6 +101,8 @@ function detectLegacyKeys(source) {
 function isRecordLike(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+//#endregion
+//#region .build/host/schema.js
 const Config = z.object({
 	enabled: z.boolean().default(false),
 	triggerCodes: z.array(z.string()).default([
@@ -109,8 +114,7 @@ const Config = z.object({
 	roles: z.object({
 		list: z.array(z.object({
 			id: z.string().required(),
-			label: z.string().default(""),
-			description: z.string().default(""),
+			persona: z.string().default(""),
 			prompt: z.string(),
 			permissions: z.object({
 				allow: z.array(z.string()),

package/dist/schema.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The `fallbacks` settings schema (schemastery), mirroring
+ * {@link FallbacksConfig}.
+ *
+ * Host-only module: `Config` is the schemastery schema the settings section
+ * validates/composes against, and `@deepseek-ai/schemastery` is an
+ * `@deepseek-ai/*` RUNTIME value import — it must never enter the client
+ * bundle, because the web loader module table cannot answer that require
+ * (build-time externals drift, 20260815: the client bundle previously
+ * externalized `@deepseek-ai/schemastery` and the web settings card failed
+ * to load). The client half consumes `FallbacksConfig` and the other
+ * config types from `./config.ts` type-only, so the schema stays here, out
+ * of the client module graph.
+ *
+ * Object fields are optional by default in schemastery; `.default()` fills
+ * the spec defaults, `.required()` keeps mandatory fields. Unknown keys are
+ * RETAINED by the composition (verified plan Task 1 Step 1) — that is what
+ * lets `detectLegacyKeys` flag two-block-era leftovers (`chains` /
+ * `roles.default`) on the composed object at startup (warn + gateway
+ * `legacyKeys`, see `src/index.ts` apply()).
+ *
+ * @module dsh-llm-fallbacks/schema
+ */
+import z from '@deepseek-ai/schemastery';
+import type { FallbacksConfig } from './config.ts';
+export declare const Config: z<FallbacksConfig>;

package/package.json

@@ -5,7 +5,7 @@
     "dsh",
     "dsh-plugin"
   ],
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -49,6 +49,7 @@
     "release:prepare": "tsx scripts/prepare-release.ts",
     "release:validate": "tsx scripts/validate-release-version.ts",
     "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit && tsc --noEmit",
     "prepare": "pnpm run build"
   },
   "engines": {

package/scripts/build-client.ts

@@ -66,11 +66,6 @@ export const CLIENT_EXTERNALS: readonly string[] = [
   '@deepseek-ai/dsh-client-ui-attachment',
   '@deepseek-ai/dsh-client-schema-form',
   '@deepseek-ai/dsh-client-runtime/client',
-  // @deepseek-ai/schemastery: config.ts's schema value import reaches the
-  // client module graph (client consumes FallbacksConfig types via config.ts);
-  // the dsh host provides the package in-box (dsh-settings depends on it), so
-  // it stays external like the other @deepseek-ai/* runtime faces.
-  '@deepseek-ai/schemastery',
 ]
 
 /**