@deepseek-ai/dsh-agent-loop-testkit 0.2.1-rc.4 → 0.2.2-alpha.2

package/README.i18n.yaml

@@ -3,7 +3,7 @@
 # After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/test-support/agent-loop-testkit/README.md
 /:
-  en: 56bf98b380f80f74
+  en: 4ec754be137aecb6
   zh: 4e26deb963e89c68
 /deepseek-ai-dsh-agent-loop-testkit:
   en: 52b308fffde03f7e
@@ -21,8 +21,8 @@
   en: 55af6e8dcc16bf46
   zh: 9e1a6a7f70fde817
 /deepseek-ai-dsh-agent-loop-testkit/use-this-package/build-a-structural-agent-stub:
-  en: 0b80eeb902e129d0
-  zh: 93352ffbc3154bef
+  en: 84a12ebbcfe2ea7d
+  zh: 9ef2bc1e2389cde1
 /deepseek-ai-dsh-agent-loop-testkit/use-this-package/when-to-use-it:
   en: 7afa2a3c8ff17664
   zh: 6c8cad1daf3a5df3

package/README.md

@@ -1,5 +1,5 @@
 ---
-description: "Prerequisite mounting, production AgentLoop drivers, and explicit Inbox stubs for agent-loop tests."
+description: "Prerequisite mounting, production AgentLoop drivers, and explicit Agent stubs for agent-loop tests."
 kind: "package-library"
 ---
 
@@ -57,14 +57,15 @@ The dependency helper forwards system-prompt and tool-registry configuration thr
 
 ### Build a structural Agent stub
 
-Use `createInboxStub()` when the test subject needs mutable pending lists but does not exercise durability, projection validation, live Inbox notifications, or the driver's claim policy. The stub implements the public queue operations with two process-local arrays and never writes to a Session. Use `unsupportedInbox()` when the test subject must not touch pending input; every mutation throws at the first unexpected dependency.
+Use `createInboxStub()` when the test subject needs mutable pending lists but does not exercise durability, projection validation, live Inbox notifications, or the driver's claim policy. The stub implements the public queue operations with two process-local arrays and never writes to a Session. Use `unsupportedInbox()` when the test subject must not touch pending input; every mutation throws at the first unexpected dependency. Use `unsupportedModel()` when the test does not read or change model selection; all its operations throw.
 
 ```ts
-import { createInboxStub } from '@deepseek-ai/dsh-agent-loop-testkit'
+import { createInboxStub, unsupportedModel } from '@deepseek-ai/dsh-agent-loop-testkit'
 
 const agent = {
   // ...
   inbox: createInboxStub(),
+  model: unsupportedModel(),
 }
 ```
 

package/README.zh.md

@@ -57,14 +57,15 @@ const admitted = harness.claim(agent, 'next-turn', 1)
 
 ### 构造结构化 Agent 桩
 
-当测试对象需要可变的待处理列表，但不测试持久性、投影校验、实时 Inbox 通知或驱动的认领策略时，使用 `createInboxStub()`。该桩通过两个进程内数组实现公开队列操作，且绝不会写入 Session。当测试对象不应访问待处理输入时，使用 `unsupportedInbox()`；每次变更都会在首个意外依赖处抛错。
+当测试对象需要可变的待处理列表，但不测试持久性、投影校验、实时 Inbox 通知或驱动的认领策略时，使用 `createInboxStub()`。该桩通过两个进程内数组实现公开队列操作，且绝不会写入 Session。当测试对象不应访问待处理输入时，使用 `unsupportedInbox()`；每次变更都会在首个意外依赖处抛错。当测试不读取或更改模型选择时，使用 `unsupportedModel()`；它的所有操作都会抛错。
 
 ```ts
-import { createInboxStub } from '@deepseek-ai/dsh-agent-loop-testkit'
+import { createInboxStub, unsupportedModel } from '@deepseek-ai/dsh-agent-loop-testkit'
 
 const agent = {
   // ...
   inbox: createInboxStub(),
+  model: unsupportedModel(),
 }
 ```
 

package/lib/index.js

@@ -5,6 +5,8 @@ import SessionStore from "@deepseek-ai/dsh-session";
 import SessionProjectionRegistry from "@deepseek-ai/dsh-session-projection";
 import SystemPrompt from "@deepseek-ai/dsh-system-prompt";
 import ToolRuntime from "@deepseek-ai/dsh-tools";
+import * as NativeToolExecutor from "@deepseek-ai/dsh-tool-executor-native";
+import * as PtcToolExecutor from "@deepseek-ai/dsh-tool-executor-ptc";
 import FsLocal from "@deepseek-ai/dsh-fs-local";
 import WorkingDirectory from "@deepseek-ai/dsh-working-directory";
 //#region lib/types/inbox.js
@@ -82,6 +84,21 @@ function unsupportedInbox() {
 	};
 }
 //#endregion
+//#region lib/types/model.js
+/**
+* Create an unsupported Model placeholder for structural Agent stubs.
+* @returns a Model whose operations throw at the first unexpected dependency.
+*/
+function unsupportedModel() {
+	const reject = () => {
+		throw new Error("this test Agent does not support model selection");
+	};
+	return {
+		current: reject,
+		select: reject
+	};
+}
+//#endregion
 //#region lib/types/working-directory-fixture.js
 /**
 * Supply fixed directory values without filesystem checks or durable changes.
@@ -99,7 +116,7 @@ function provideWorkingDirectoryFixture(ctx, defaultDirectory = process.cwd()) {
 //#endregion
 //#region lib/types/index.js
 /**
-* Shared service mounting, real AgentLoop drivers, and structural Inbox stubs
+* Shared service mounting, real AgentLoop drivers, and structural Agent stubs
 * for agent-loop tests. Callers retain ownership of their contexts, adapters,
 * optional plugins, agents, and teardown.
 * @module @deepseek-ai/dsh-agent-loop-testkit
@@ -125,7 +142,9 @@ async function mountAgentLoopTestDependencies(ctx, options = {}) {
 		if (ctx.get("fs") === void 0) await ctx.plugin(FsLocal);
 		await ctx.plugin(WorkingDirectory);
 	}
-	await ctx.plugin(ToolRuntime, options.tools ?? {});
+	await ctx.plugin(ToolRuntime);
+	if (options.tools?.mode === "ptc") await ctx.plugin(PtcToolExecutor, { ...options.tools.maxParallelSubCalls !== void 0 ? { maxParallelSubCalls: options.tools.maxParallelSubCalls } : {} });
+	else await ctx.plugin(NativeToolExecutor);
 	await ctx.plugin(AgentRegistry);
 }
 /**
@@ -144,4 +163,4 @@ async function mountAgentLoopTestHarness(ctx) {
 	};
 }
 //#endregion
-export { createInboxStub, mountAgentLoopTestDependencies, mountAgentLoopTestHarness, provideWorkingDirectoryFixture, unsupportedInbox };
+export { createInboxStub, mountAgentLoopTestDependencies, mountAgentLoopTestHarness, provideWorkingDirectoryFixture, unsupportedInbox, unsupportedModel };

package/lib/types/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Shared service mounting, real AgentLoop drivers, and structural Inbox stubs
+ * Shared service mounting, real AgentLoop drivers, and structural Agent stubs
  * for agent-loop tests. Callers retain ownership of their contexts, adapters,
  * optional plugins, agents, and teardown.
  * @module @deepseek-ai/dsh-agent-loop-testkit
@@ -8,8 +8,8 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { Agent, AgentOptions, InboxTarget } from '@deepseek-ai/dsh-agent';
 import type { SessionHeader, SessionId, UserMessage } from '@deepseek-ai/dsh-session';
 import type { Config as SystemPromptConfig } from '@deepseek-ai/dsh-system-prompt';
-import type { Config as ToolRuntimeConfig } from '@deepseek-ai/dsh-tools';
 export { createInboxStub, unsupportedInbox } from './inbox.ts';
+export { unsupportedModel } from './model.ts';
 export { provideWorkingDirectoryFixture } from './working-directory-fixture.ts';
 /** Test driver for production Agents created by a mounted AgentLoop. */
 export interface AgentLoopTestHarness {
@@ -37,7 +37,10 @@ export interface AgentLoopTestDependenciesOptions {
     /** Configuration for the system-prompt registry. */
     readonly systemPrompt?: SystemPromptConfig;
     /** Configuration for the tool registry. */
-    readonly tools?: ToolRuntimeConfig;
+    readonly tools?: {
+        mode?: 'native' | 'ptc';
+        maxParallelSubCalls?: number;
+    };
 }
 /**
  * Mount the standard prerequisite services for an AgentLoop test.

package/lib/types/model.d.ts

@@ -0,0 +1,8 @@
+/** Model placeholder for consumer tests that do not read or change model selection. */
+import type { Model } from '@deepseek-ai/dsh-agent';
+/**
+ * Create an unsupported Model placeholder for structural Agent stubs.
+ * @returns a Model whose operations throw at the first unexpected dependency.
+ */
+export declare function unsupportedModel(): Model;
+//# sourceMappingURL=model.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-agent-loop-testkit",
   "description": "Prerequisite mounting, production AgentLoop drivers, and Inbox stubs for tests",
-  "version": "0.2.1-rc.4",
+  "version": "0.2.2-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,28 +27,32 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.4",
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-working-directory": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-fs-local": "0.2.1-rc.4"
+    "@deepseek-ai/dsh-agent": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.2-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.6-alpha.1",
+    "@deepseek-ai/dsh-working-directory": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.2-alpha.2"
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-tool-executor-native": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-tool-executor-ptc": "0.2.2-alpha.2"
   },
-  "dependencies": {},
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.4",
-    "@deepseek-ai/cordis": "~4.0.5",
-    "@deepseek-ai/dsh-working-directory": "0.2.1-rc.4",
-    "@deepseek-ai/dsh-fs-local": "0.2.1-rc.4"
+    "@deepseek-ai/dsh-agent": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-ptc-runtime": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.2-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.6-alpha.1",
+    "@deepseek-ai/dsh-working-directory": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.2-alpha.2"
   }
 }