dsh-llm-fallbacks 0.4.0-alpha.1 → 0.4.1

package/README.md

@@ -7,7 +7,7 @@
 ![node](https://img.shields.io/badge/node-%3E%3D22-339933.svg)
 ![pnpm](https://img.shields.io/badge/pnpm-%3E%3D10-f69220.svg)
 ![dsh tui](https://img.shields.io/badge/dsh%20tui-compatible-4B32C3.svg)
-![dsh](https://img.shields.io/badge/DSH-0.1.2--alpha.2-4B32C3.svg)
+![dsh](https://img.shields.io/badge/DSH-0.1.2--rc.1-4B32C3.svg)
 [![dshfind](https://dshfind.com/api/badge/omdsh-dev/dsh-llm-fallbacks?lang=en)](https://dshfind.com/zh/plugins/omdsh-dev/dsh-llm-fallbacks?ref=badge)
 
 Automatic provider/model fallback chains for dsh (DeepSeek Harness): when an agent's LLM requests keep failing — retries exhausted, auth errors, quota exceeded, rate limiting (429) — the plugin switches provider/model along the fallback chain for the current role, and the current step/turn continues on the target model: tasks are not interrupted by model problems.

package/README.zh-CN.md

@@ -7,7 +7,7 @@
 ![node](https://img.shields.io/badge/node-%3E%3D22-339933.svg)
 ![pnpm](https://img.shields.io/badge/pnpm-%3E%3D10-f69220.svg)
 ![dsh tui](https://img.shields.io/badge/dsh%20tui-compatible-4B32C3.svg)
-![dsh](https://img.shields.io/badge/DSH-0.1.2--alpha.2-4B32C3.svg)
+![dsh](https://img.shields.io/badge/DSH-0.1.2--rc.1-4B32C3.svg)
 [![dshfind](https://dshfind.com/api/badge/omdsh-dev/dsh-llm-fallbacks?lang=zh)](https://dshfind.com/zh/plugins/omdsh-dev/dsh-llm-fallbacks?ref=badge)
 
 dsh（DeepSeek Harness）的自动模型降级插件：当 root agent 或 subagent 的模型请求持续失败（重试耗尽、权限、配额超限、限流 429）时，按角色/模型 fallback 链自动切换 provider/model，当前 step/turn 在目标模型上继续完成——任务不因模型问题中断。

package/dist/client/index.d.ts

@@ -51,6 +51,13 @@ export { FallbacksSettingsController, FALLBACKS_SETTINGS_NS } from './fallbacks-
  * it reflectively and degrades to the switches empty state when absent
  * (`setCurrentSession` never called, `loadSwitches` ready with an empty
  * array, which the store already supports).
+ *
+ * rc.1 dotted-namespace contract: each client Remote namespace is a
+ * child-fiber service named `remote.<ns>` (upstream `remoteServiceKey`), and
+ * the traceable proxy forwards `ctx.remote.llm` / `.settings` / `.session`
+ * to those context properties — consumers MUST declare the dotted names
+ * here or the fiber walk throws `cannot get property "remote.llm" without
+ * inject`. `remote` stays for the `$on` invalidation face.
  */
 export declare const inject: string[];
 /**

package/dist/client/index.js

@@ -4489,13 +4489,23 @@ window.__ModuleLoader__.load({
 		* it reflectively and degrades to the switches empty state when absent
 		* (`setCurrentSession` never called, `loadSwitches` ready with an empty
 		* array, which the store already supports).
+		*
+		* rc.1 dotted-namespace contract: each client Remote namespace is a
+		* child-fiber service named `remote.<ns>` (upstream `remoteServiceKey`), and
+		* the traceable proxy forwards `ctx.remote.llm` / `.settings` / `.session`
+		* to those context properties — consumers MUST declare the dotted names
+		* here or the fiber walk throws `cannot get property "remote.llm" without
+		* inject`. `remote` stays for the `$on` invalidation face.
 		*/
 		const inject = [
 			"slots",
 			"locale",
 			"connection",
 			"remote",
-			"uiConversation"
+			"uiConversation",
+			"remote.llm",
+			"remote.settings",
+			"remote.session"
 		];
 		/**
 		* Register the `fallbacks` dictionaries and the plugin-config card once the

package/dist/commands.d.ts

@@ -48,7 +48,7 @@ export interface FallbacksCommandAgent {
         readonly header?: {
             readonly origin?: Origin;
         };
-        readonly events: readonly unknown[];
+        readonly snapshotEvents: () => readonly unknown[];
     };
 }
 /** One active cooldown entry displayed by `/fallbacks`. */

package/dist/index.js

@@ -2291,7 +2291,7 @@ async function makeModelExists(ctx, providers) {
 }
 function countRetryEvents(session, turn, step, provider) {
 	let count = 0;
-	const events = session.events;
+	const events = session.snapshotEvents();
 	for (let index = events.length - 1; index >= 0; index -= 1) {
 		const event = events[index];
 		const data = event.data;
@@ -2348,7 +2348,7 @@ function authorizedRouteView(ctx, agent) {
 	const parentOptions = parent?.options;
 	return {
 		requestHeader: agent.session?.requestHeader()?.config,
-		events: agent.session?.events,
+		events: agent.session?.snapshotEvents(),
 		options: agent.options,
 		inherited: parentHeader ?? (typeof parentOptions?.provider === "string" && typeof parentOptions?.model === "string" ? {
 			provider: parentOptions.provider,
@@ -2480,7 +2480,7 @@ function apply(ctx, config = defaultFallbacksConfig) {
 		};
 		if (agent.session?.header?.origin === "subagent" && target !== void 0) {
 			const settingsRead = readGuardedPolicySettings(ctx, agent.id, lastKnownPolicySettings, logger.warn);
-			const policy = settingsRead.ok ? effectivePolicy(readSessionPolicyEvent(agent.session.events), settingsRead.settings) : { state: "unprovable" };
+			const policy = settingsRead.ok ? effectivePolicy(readSessionPolicyEvent(agent.session.snapshotEvents()), settingsRead.settings) : { state: "unprovable" };
 			if (policy.state === "unprovable") {
 				logger.warn("llm-fallbacks: agent \"%s\" subagent model-selection policy is on but unreadable — skipping fallback switch", agent.id);
 				return null;
@@ -2593,7 +2593,7 @@ function apply(ctx, config = defaultFallbacksConfig) {
 			dispatchInjected.add(agent.id);
 			try {
 				const settingsRead = readGuardedPolicySettings(ctx, agent.id, lastKnownPolicySettings, logger.warn);
-				const policy = settingsRead.ok ? effectivePolicy(readSessionPolicyEvent(agent.session.events), settingsRead.settings) : { state: "unprovable" };
+				const policy = settingsRead.ok ? effectivePolicy(readSessionPolicyEvent(agent.session.snapshotEvents()), settingsRead.settings) : { state: "unprovable" };
 				if (policy.state === "unprovable") logger.warn("llm-fallbacks: agent \"%s\" subagent model-selection policy is on but unreadable — skipping role-inject", agent.id);
 				else {
 					const authorized = policy.state === "enabled" ? detectAuthorizedRoute(authorizedRouteView(ctx, agent)) : void 0;
@@ -2707,7 +2707,7 @@ function apply(ctx, config = defaultFallbacksConfig) {
 				role,
 				...resolveChainForDiagnostic(config.roles.list, config.rootChain, role, logger.warn),
 				slot: resolveSlotState(config, new Date(), config.tz ?? "Asia/Shanghai"),
-				switches: recentFallbacksSwitches(agent.session.events, 5),
+				switches: recentFallbacksSwitches(agent.session.snapshotEvents(), 5),
 				cooldown: state === void 0 ? [] : recovery === "half-open" ? [...state.cooldown.snapshot(), ...state.recovery.halfOpenEntries().map((entry) => ({
 					key: entry.key,
 					untilEpochMs: entry.untilEpochMs,

package/package.json

@@ -5,7 +5,7 @@
     "dsh",
     "dsh-plugin"
   ],
-  "version": "0.4.0-alpha.1",
+  "version": "0.4.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -60,28 +60,28 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-gateway": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm-retry": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tool-subagent": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-typert-registry": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-gateway": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm-retry": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tool-subagent": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-typert-registry": "^0.1.2-rc.1",
     "@deepseek-ai/schemastery": "^3.18.2",
     "react": "^18.2.0"
   },