@monotykamary/dsh-agent-loop-testkit 0.1.0-rc.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# 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
+README.md: 3cc29ddefb169b6c3bbd209cc0470d45be384835
+README.zh.md: cccc41e546cb8d9c695ad22f8541f58793eee6c2

package/README.md

@@ -0,0 +1,33 @@
+# `@monotykamary/dsh-agent-loop-testkit`
+
+English | [中文](README.zh.md)
+
+Shared prerequisite mounting for tests that exercise the concrete `AgentLoop`. `mountAgentLoopTestDependencies(ctx, options?)` installs the LLM, session, system-prompt, tool, and agent services in dependency order, then returns before the loop is mounted.
+
+The caller registers adapters and optional plugins, mounts `AgentLoop` with the configuration under test, and disposes its own Context. System-prompt and tool-registry configuration can be forwarded through `options`; the helper does not provide test defaults beyond those owned by the services. A plugin-load failure rejects the helper call, while services activated earlier in the sequence remain owned by the caller's Context.
+
+```ts
+import { Context } from '@monotykamary/cordis'
+import AgentLoop from '@monotykamary/dsh-agent-loop'
+import { mountAgentLoopTestDependencies } from '@monotykamary/dsh-agent-loop-testkit'
+
+const ctx = new Context()
+
+await mountAgentLoopTestDependencies(ctx)
+// Register the test adapter and any optional plugins here.
+await ctx.plugin(AgentLoop, { agents: [] })
+```
+
+Tests of injection failures, partial topology, service load order, or service teardown mount their dependencies directly instead of using this helper.
+
+## Model Experience
+
+None, as this test-only composition helper neither drives nor modifies model requests.
+
+#### KV Cache effect
+
+None; this package neither assembles nor sends a provider request.
+
+## Known Limitations and Deferred Work
+
+- **Only the mandatory prerequisite spine is shared** — adapters, optional plugins, `AgentLoop`, agents, and Context teardown remain caller-owned so scenario-specific ordering stays visible.

package/README.zh.md

@@ -0,0 +1,33 @@
+# `@monotykamary/dsh-agent-loop-testkit`
+
+[English](README.md) | 中文
+
+为运行具体 `AgentLoop` 的测试共享挂载先决依赖。`mountAgentLoopTestDependencies(ctx, options?)` 按依赖顺序安装 LLM（大语言模型）、会话、系统提示词、工具和 agent（智能体）服务，然后在 agent loop 挂载前返回。
+
+调用方注册适配器和可选插件，使用待测配置挂载 `AgentLoop`，并 dispose（资源释放）自己的 Context。系统提示词和工具注册表配置可通过 `options` 转发；该辅助函数不提供超出服务自有默认值的测试默认值。插件加载失败会使辅助函数调用被拒绝，而顺序中较早激活的服务仍归调用方的 Context 所有。
+
+```ts
+import { Context } from '@monotykamary/cordis'
+import AgentLoop from '@monotykamary/dsh-agent-loop'
+import { mountAgentLoopTestDependencies } from '@monotykamary/dsh-agent-loop-testkit'
+
+const ctx = new Context()
+
+await mountAgentLoopTestDependencies(ctx)
+// Register the test adapter and any optional plugins here.
+await ctx.plugin(AgentLoop, { agents: [] })
+```
+
+针对注入失败、部分拓扑、服务加载顺序或服务清理的测试会直接挂载其依赖，而不使用此辅助函数。
+
+## 模型体验
+
+无。该测试专用组合辅助工具既不驱动也不修改模型请求。
+
+#### KV Cache 影响
+
+无；该包既不组装也不发送提供方请求。
+
+## 已知限制与暂缓事项
+
+- **只共享必需的先决主干**：适配器、可选插件、`AgentLoop`、agent 和 Context 清理仍由调用方负责，以使特定场景的挂载顺序清晰可见。

package/lib/index.js

@@ -0,0 +1,33 @@
+import AgentRegistry from "@monotykamary/dsh-agent";
+import LlmRuntime from "@monotykamary/dsh-llm";
+import SessionStore from "@monotykamary/dsh-session";
+import SystemPrompt from "@monotykamary/dsh-system-prompt";
+import ToolRuntime from "@monotykamary/dsh-tools";
+//#region lib/types/index.js
+/**
+* Shared mounting for the services required before tests load the concrete
+* agent loop. The caller retains ownership of the context, loop, adapters,
+* optional plugins, and teardown.
+* @module @monotykamary/dsh-agent-loop-testkit
+*/
+/**
+* Mount the standard prerequisite services for an AgentLoop test.
+*
+* The function deliberately does not mount AgentLoop or register an adapter,
+* so tests retain control of load order and the topology under test. The
+* context owns every mounted service and remains responsible for disposal. A
+* plugin-load failure rejects the promise; services activated earlier in the
+* sequence remain context-owned and unwind with that context.
+* @param ctx - test context that owns the mounted services.
+* @param options - optional service configuration forwarded without mutation.
+* @returns after every prerequisite service has activated.
+*/
+async function mountAgentLoopTestDependencies(ctx, options = {}) {
+	await ctx.plugin(LlmRuntime);
+	await ctx.plugin(SessionStore);
+	await ctx.plugin(SystemPrompt, options.systemPrompt ?? {});
+	await ctx.plugin(ToolRuntime, options.tools ?? {});
+	await ctx.plugin(AgentRegistry);
+}
+//#endregion
+export { mountAgentLoopTestDependencies };

package/lib/invariant.js

@@ -0,0 +1,23 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@monotykamary/dsh-agent-loop-testkit`.
+* @module @monotykamary/dsh-agent-loop-testkit/invariant
+*/
+const PACKAGE_NAME = "@monotykamary/dsh-agent-loop-testkit";
+/** Cordis companion plugin name. */
+const name = "agent-loop-testkit-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this test-support package owns no production event stream or mutable data;
+* consuming test suites exercise its behavior.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared mounting for the services required before tests load the concrete
+ * agent loop. The caller retains ownership of the context, loop, adapters,
+ * optional plugins, and teardown.
+ * @module @monotykamary/dsh-agent-loop-testkit
+ */
+import type { Context } from '@monotykamary/cordis';
+import type { Config as SystemPromptConfig } from '@monotykamary/dsh-system-prompt';
+import type { Config as ToolRuntimeConfig } from '@monotykamary/dsh-tools';
+/** Configuration forwarded to the prerequisite service plugins. */
+export interface AgentLoopTestDependenciesOptions {
+    /** Configuration for the system-prompt registry. */
+    readonly systemPrompt?: SystemPromptConfig;
+    /** Configuration for the tool registry. */
+    readonly tools?: ToolRuntimeConfig;
+}
+/**
+ * Mount the standard prerequisite services for an AgentLoop test.
+ *
+ * The function deliberately does not mount AgentLoop or register an adapter,
+ * so tests retain control of load order and the topology under test. The
+ * context owns every mounted service and remains responsible for disposal. A
+ * plugin-load failure rejects the promise; services activated earlier in the
+ * sequence remain context-owned and unwind with that context.
+ * @param ctx - test context that owns the mounted services.
+ * @param options - optional service configuration forwarded without mutation.
+ * @returns after every prerequisite service has activated.
+ */
+export declare function mountAgentLoopTestDependencies(ctx: Context, options?: AgentLoopTestDependenciesOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@monotykamary/dsh-agent-loop-testkit`.
+ * @module @monotykamary/dsh-agent-loop-testkit/invariant
+ */
+import type { Context } from '@monotykamary/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "agent-loop-testkit-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@monotykamary/dsh-agent-loop-testkit",
+  "description": "Shared prerequisite mounting for tests that exercise the concrete agent loop",
+  "version": "0.1.0-rc.10",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/test-support/agent-loop-testkit"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@monotykamary/dsh-llm": "^0.1.0-rc.10",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.10",
+    "@monotykamary/dsh-system-prompt": "^0.1.0-rc.10",
+    "@monotykamary/dsh-agent": "^0.1.0-rc.10",
+    "@monotykamary/dsh-session": "^0.1.0-rc.10",
+    "@monotykamary/dsh-tools": "^0.1.0-rc.10",
+    "@monotykamary/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@monotykamary/dsh-agent": "^0.1.0-rc.10",
+    "@monotykamary/dsh-agent-loop": "^0.1.0-rc.10",
+    "@monotykamary/dsh-invariants": "^0.1.0-rc.10",
+    "@monotykamary/dsh-llm": "^0.1.0-rc.10",
+    "@monotykamary/dsh-system-prompt": "^0.1.0-rc.10",
+    "@monotykamary/dsh-session": "^0.1.0-rc.10",
+    "@monotykamary/dsh-tools": "^0.1.0-rc.10",
+    "@monotykamary/cordis": "^4.0.1"
+  }
+}