@deepseek-ai/dsh-agent-loop-testkit 0.2.1-alpha.1 → 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

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

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

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.1-alpha.1",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,24 +27,28 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
+    "@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-session-projection": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-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-loop": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
+    "@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-system-prompt": "0.2.1-alpha.1"
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-fs-local": "0.2.1-alpha.2"
   }
 }