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

package/README.i18n.yaml

@@ -15,8 +15,8 @@
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
 /deepseek-ai-dsh-agent-loop-testkit/use-this-package:
-  en: c0e407323250d8a9
-  zh: 0d0d6c7862c3d61e
+  en: 6286160c69aaf1d2
+  zh: 79571cbf96335b02
 /deepseek-ai-dsh-agent-loop-testkit/use-this-package/drive-a-production-agent:
   en: 55af6e8dcc16bf46
   zh: 9e1a6a7f70fde817
@@ -33,8 +33,8 @@
   en: b2297e57abf5258a
   zh: 4595256c059896ce
 /deepseek-ai-dsh-agent-loop-testkit/understand-the-implementation/design:
-  en: 8fd7577505e2efa7
-  zh: 6bbf46bcf9e3f5bc
+  en: 88506ae955e07c17
+  zh: 9d09a35a9286105d
 /deepseek-ai-dsh-agent-loop-testkit/further-exploration:
   en: 60f39b14b0ccbcf6
   zh: f193710189d3cc10

package/README.md

@@ -25,6 +25,8 @@ Use `dsh-agent-loop-testkit` to give AgentLoop tests the standard prerequisites
 <a id="use-this-package"></a>
 ## Use this package
 
+Consumer-only tests with structural Agent stubs can use `provideWorkingDirectoryFixture(ctx, defaultDirectory?)`. It supplies directory values without validating paths, changing directories, or recording events. Tests of directory behavior use `mountAgentLoopTestDependencies(ctx, { workingDirectory: true })` and real temporary directories.
+
 This package gives an AgentLoop test a working service topology and keeps the choice between production Inbox behavior and a structural stub explicit.
 
 ### Drive a production Agent
@@ -86,7 +88,7 @@ This section explains the design of the test utilities; the observable behavior
 
 ### Design
 
-`mountAgentLoopTestDependencies` mounts six service plugins in a fixed dependency order — LLM, session, session-projection registry, system-prompt registry, tool registry, then agent registry — and stops before `AgentLoop`, so the caller controls loop load order. `mountAgentLoopTestHarness` mounts the public production plugin, creates Agents through its service, and exposes the production driver's claim operation without exporting the loop's concrete Inbox class or projection definition. [`src/inbox.ts`](src/inbox.ts) contains only the process-local mutable stub and the fail-fast unsupported placeholder; it owns no projection or durable event implementation. The mounting and driver implementation lives in [`src/index.ts`](src/index.ts). No invariant companion is published because the package owns only test helpers and has no independent production observations that can diverge.
+`mountAgentLoopTestDependencies` mounts six service plugins in a fixed dependency order — LLM, session, session-projection registry, system-prompt registry, tool registry, then agent registry — and stops before `AgentLoop`, so the caller controls loop load order. `mountAgentLoopTestHarness` mounts the public production plugin, creates Agents through its service, and exposes the production driver's claim operation without exporting the loop's concrete Inbox class or projection definition. [`src/inbox.ts`](src/inbox.ts) contains only the process-local mutable stub and the fail-fast unsupported placeholder; it owns no projection or durable event implementation. The mounting and driver implementation lives in [`src/index.ts`](src/index.ts).
 
 </details>
 

package/README.zh.md

@@ -25,6 +25,8 @@ kind: "package-library"
 <a id="use-this-package"></a>
 ## 使用本包
 
+仅测试消费方且使用结构化 Agent 桩的测试可调用 `provideWorkingDirectoryFixture(ctx, defaultDirectory?)`。它只提供目录值，不校验路径、不切换目录，也不记录事件。目录行为测试使用 `mountAgentLoopTestDependencies(ctx, { workingDirectory: true })` 与真实临时目录。
+
 本包为 AgentLoop 测试提供可用的服务拓扑，并要求测试明确选择生产 Inbox 行为或结构化桩。
 
 ### 驱动生产 Agent
@@ -86,7 +88,7 @@ harness 不会挂载任何 LLM（大语言模型）适配器。若测试发送
 
 ### 设计
 
-`mountAgentLoopTestDependencies` 按固定依赖顺序——LLM、会话、会话投影注册表、系统提示词注册表、工具注册表、agent 注册表——挂载六个服务插件，并在 `AgentLoop` 之前停下，使调用方控制 loop 加载顺序。`mountAgentLoopTestHarness` 挂载公开的生产插件，通过其服务创建 Agent，并公开生产驱动的认领操作，而不导出 loop 的具体 Inbox 类或投影定义。[`src/inbox.ts`](src/inbox.ts) 仅包含进程内可变桩和快速失败且不支持操作的占位值；它不持有投影或持久事件实现。挂载与驱动实现位于 [`src/index.ts`](src/index.ts)。本包不发布 invariant companion，因为它只持有测试辅助工具，不存在可能相互偏离的独立生产观测。
+`mountAgentLoopTestDependencies` 按固定依赖顺序——LLM、会话、会话投影注册表、系统提示词注册表、工具注册表、agent 注册表——挂载六个服务插件，并在 `AgentLoop` 之前停下，使调用方控制 loop 加载顺序。`mountAgentLoopTestHarness` 挂载公开的生产插件，通过其服务创建 Agent，并公开生产驱动的认领操作，而不导出 loop 的具体 Inbox 类或投影定义。[`src/inbox.ts`](src/inbox.ts) 仅包含进程内可变桩和快速失败且不支持操作的占位值；它不持有投影或持久事件实现。挂载与驱动实现位于 [`src/index.ts`](src/index.ts)。
 
 </details>
 

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 FsLocal from "@deepseek-ai/dsh-fs-local";
+import WorkingDirectory from "@deepseek-ai/dsh-working-directory";
 //#region lib/types/inbox.js
 /**
 * Create a mutable in-memory Inbox stub for tests that exercise only the public
@@ -80,6 +82,21 @@ function unsupportedInbox() {
 	};
 }
 //#endregion
+//#region lib/types/working-directory-fixture.js
+/**
+* Supply fixed directory values without filesystem checks or durable changes.
+* @param ctx - context owning this test collaborator.
+* @param defaultDirectory - fallback for fixtures without a Session directory.
+*/
+function provideWorkingDirectoryFixture(ctx, defaultDirectory = process.cwd()) {
+	const get = (session) => session.header.cwd ?? defaultDirectory;
+	ctx.provide("workingDirectory", {
+		defaultDirectory,
+		get,
+		ensure: (agent) => Promise.resolve(get(agent.session))
+	});
+}
+//#endregion
 //#region lib/types/index.js
 /**
 * Shared service mounting, real AgentLoop drivers, and structural Inbox stubs
@@ -104,6 +121,10 @@ async function mountAgentLoopTestDependencies(ctx, options = {}) {
 	await ctx.plugin(SessionStore);
 	await ctx.plugin(SessionProjectionRegistry);
 	await ctx.plugin(SystemPrompt, options.systemPrompt ?? {});
+	if (options.workingDirectory) {
+		if (ctx.get("fs") === void 0) await ctx.plugin(FsLocal);
+		await ctx.plugin(WorkingDirectory);
+	}
 	await ctx.plugin(ToolRuntime, options.tools ?? {});
 	await ctx.plugin(AgentRegistry);
 }
@@ -123,4 +144,4 @@ async function mountAgentLoopTestHarness(ctx) {
 	};
 }
 //#endregion
-export { createInboxStub, mountAgentLoopTestDependencies, mountAgentLoopTestHarness, unsupportedInbox };
+export { createInboxStub, mountAgentLoopTestDependencies, mountAgentLoopTestHarness, provideWorkingDirectoryFixture, unsupportedInbox };

package/lib/types/index.d.ts

@@ -10,6 +10,7 @@ import type { SessionHeader, SessionId, UserMessage } from '@deepseek-ai/dsh-ses
 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 { provideWorkingDirectoryFixture } from './working-directory-fixture.ts';
 /** Test driver for production Agents created by a mounted AgentLoop. */
 export interface AgentLoopTestHarness {
     /**
@@ -31,6 +32,8 @@ export interface AgentLoopTestHarness {
 }
 /** Configuration forwarded to the prerequisite service plugins. */
 export interface AgentLoopTestDependenciesOptions {
+    /** Mount the real directory owner and a local filesystem for directory-aware tests. */
+    readonly workingDirectory?: boolean;
     /** Configuration for the system-prompt registry. */
     readonly systemPrompt?: SystemPromptConfig;
     /** Configuration for the tool registry. */

package/lib/types/working-directory-fixture.d.ts

@@ -0,0 +1,9 @@
+/** Directory collaborator for consumer-only tests with structural Agent stubs. */
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Supply fixed directory values without filesystem checks or durable changes.
+ * @param ctx - context owning this test collaborator.
+ * @param defaultDirectory - fallback for fixtures without a Session directory.
+ */
+export declare function provideWorkingDirectoryFixture(ctx: Context, defaultDirectory?: string): void;
+//# sourceMappingURL=working-directory-fixture.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.0-rc.2",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,24 +27,28 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-agent-loop": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
-    "@deepseek-ai/cordis": "~4.0.4"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.2"
   },
   "dependencies": {},
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
-    "@deepseek-ai/cordis": "~4.0.4"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.2"
   }
 }