@atoms-agent/testing 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 atoms_agent contributors
+
+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.md

@@ -0,0 +1,47 @@
+# @atoms-agent/testing
+
+Offline test helpers for `atoms_agent`: ScriptedModel, fake clock, and
+deterministic IDs.
+
+**Dev/test dependency only.** Production application runtimes should depend on
+`@atoms-agent/core` and `@atoms-agent/llm` only. Do not ship this package in
+application runtime installs unless you intentionally run offline demos.
+
+## Install
+
+```bash
+npm install -D @atoms-agent/testing
+```
+
+Local tarball (publish-ready verification):
+
+```bash
+npm install ./atoms-agent-llm-0.3.0.tgz ./atoms-agent-core-0.3.0.tgz ./atoms-agent-testing-0.3.0.tgz
+```
+
+## Usage
+
+```typescript
+import { createScriptedModel } from "@atoms-agent/testing";
+import { createAgent } from "@atoms-agent/core";
+
+const model = createScriptedModel({
+  script: [{ kind: "text", deltas: ["hello from scripted model"] }],
+});
+
+const agent = createAgent({
+  model,
+  systemPrompt: "Reply briefly.",
+});
+```
+
+Only import from the package root. Subpath / deep imports are not supported.
+
+## Requirements
+
+- Node.js >= 22.13
+- ESM
+
+## License
+
+MIT

package/dist/clock.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fake Clock（任务 B002）：让 timeout/retry 测试确定化，
+ * 默认测试不依赖真实时间流逝。
+ */
+export interface FakeClock {
+    now(): number;
+    sleep(ms: number, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    advance(ms: number): Promise<void>;
+}
+export declare function createFakeClock(startMs?: number): FakeClock;
+//# sourceMappingURL=clock.d.ts.map

package/dist/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,IAAI,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAUD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAwE3D"}

package/dist/clock.js

@@ -0,0 +1,78 @@
+import { AtomsAgentError } from "@atoms-agent/llm";
+export function createFakeClock(startMs) {
+    let currentMs = startMs ?? 0;
+    let nextOrder = 0;
+    let pendingSleeps = [];
+    if (!Number.isFinite(currentMs)) {
+        throw new RangeError("Fake clock start time must be finite.");
+    }
+    return {
+        now() {
+            return currentMs;
+        },
+        sleep(ms, options) {
+            assertDuration(ms);
+            const deadlineMs = currentMs + ms;
+            if (!Number.isFinite(deadlineMs)) {
+                throw new RangeError("Fake clock sleep deadline must be finite.");
+            }
+            if (options?.signal?.aborted === true) {
+                return Promise.reject(clockCancellationError(options.signal));
+            }
+            if (ms === 0) {
+                return Promise.resolve();
+            }
+            return new Promise((resolve, reject) => {
+                const pending = {
+                    deadlineMs,
+                    order: nextOrder,
+                    resolve,
+                    signal: options?.signal,
+                };
+                nextOrder += 1;
+                if (options?.signal !== undefined) {
+                    pending.onAbort = () => {
+                        const index = pendingSleeps.indexOf(pending);
+                        if (index < 0) {
+                            return;
+                        }
+                        pendingSleeps.splice(index, 1);
+                        reject(clockCancellationError(options.signal));
+                    };
+                    options.signal.addEventListener("abort", pending.onAbort, { once: true });
+                }
+                pendingSleeps.push(pending);
+            });
+        },
+        async advance(ms) {
+            assertDuration(ms);
+            const nextMs = currentMs + ms;
+            if (!Number.isFinite(nextMs)) {
+                throw new RangeError("Fake clock time must remain finite.");
+            }
+            currentMs = nextMs;
+            const ready = pendingSleeps
+                .filter((pending) => pending.deadlineMs <= currentMs)
+                .sort((left, right) => left.deadlineMs - right.deadlineMs || left.order - right.order);
+            pendingSleeps = pendingSleeps.filter((pending) => pending.deadlineMs > currentMs);
+            for (const pending of ready) {
+                if (pending.signal !== undefined && pending.onAbort !== undefined) {
+                    pending.signal.removeEventListener("abort", pending.onAbort);
+                }
+                pending.resolve();
+            }
+            await Promise.resolve();
+        },
+    };
+}
+function assertDuration(ms) {
+    if (!Number.isFinite(ms) || ms < 0) {
+        throw new RangeError("Fake clock durations must be finite and non-negative.");
+    }
+}
+function clockCancellationError(signal) {
+    return new AtomsAgentError("CANCELLED", "Fake clock sleep was cancelled.", {
+        cause: signal.reason,
+    });
+}
+//# sourceMappingURL=clock.js.map

package/dist/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"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"}

package/dist/ids.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Deterministic ID 工厂（任务 B002）：相同前缀产生 `prefix-1`、`prefix-2`…，
+ * 让 Event 快照测试可重复。
+ */
+export type IdFactory = (prefix: string) => string;
+export declare function createDeterministicIds(): IdFactory;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;AAEnD,wBAAgB,sBAAsB,IAAI,SAAS,CAQlD"}

package/dist/ids.js

@@ -0,0 +1,9 @@
+export function createDeterministicIds() {
+    const counters = new Map();
+    return (prefix) => {
+        const next = (counters.get(prefix) ?? 0) + 1;
+        counters.set(prefix, next);
+        return `${prefix}-${next}`;
+    };
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,sBAAsB;IACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,OAAO,CAAC,MAAc,EAAU,EAAE;QAChC,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7C,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createScriptedModel } from "./scripted-model.js";
+export type { ScriptedModel, ScriptedModelOptions, ScriptedToolCall, ScriptedTurn, } from "./scripted-model.js";
+export { createFakeClock } from "./clock.js";
+export type { FakeClock } from "./clock.js";
+export { createDeterministicIds } from "./ids.js";
+export type { IdFactory } from "./ids.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createScriptedModel } from "./scripted-model.js";
+export { createFakeClock } from "./clock.js";
+export { createDeterministicIds } from "./ids.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAO1D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC"}

package/dist/scripted-model.d.ts

@@ -0,0 +1,58 @@
+import type { AssistantMessage, FinishReason, JsonValue, ModelAdapter, ModelCapabilities, ModelRequest, Usage } from "@atoms-agent/llm";
+/**
+ * ScriptedModel —— 离线、确定性的 ModelAdapter（PRD TEST-001，任务 B002）。
+ *
+ * 每次 stream() 调用消费脚本中的下一段 turn，按声明产出事件。
+ * 相同脚本必须产生相同 Event 序列。
+ */
+export type ScriptedToolCall = {
+    /** 缺省时由 Harness 生成稳定的 `tool-call-N`。 */
+    toolCallId?: string;
+    toolName: string;
+    input: JsonValue;
+};
+type ScriptedMessageResult = {
+    usage?: Usage;
+    finishReason?: FinishReason;
+};
+export type ScriptedTurn = ({
+    kind: "text";
+    /** 按 delta 逐段吐出，message_end 拼接为完整文本。 */
+    deltas: readonly string[];
+} & ScriptedMessageResult) | ({
+    kind: "tool_calls";
+    calls: readonly ScriptedToolCall[];
+    /** 模型在 Tool Call 前产生的可选文本。 */
+    deltas?: readonly string[];
+} & ScriptedMessageResult) | ({
+    kind: "message";
+    /** 直接产出完整 Canonical Assistant Message。 */
+    message: AssistantMessage;
+    /** 若提供，拼接结果必须与 message 中全部文本块一致。 */
+    deltas?: readonly string[];
+} & ScriptedMessageResult) | {
+    kind: "provider_error";
+    /** 用于测试有限 Retry：retryable=true 的错误按策略重试。 */
+    retryable: boolean;
+    retryAfterMs?: number;
+    message: string;
+} | {
+    kind: "hang";
+};
+export type ScriptedModelOptions = {
+    script: readonly ScriptedTurn[];
+    modelId?: string;
+    /** 用于 Capability Missing 场景；缺省声明 Streaming + Parallel Tool Call。 */
+    capabilities?: Partial<ModelCapabilities>;
+};
+/**
+ * ModelAdapter 之外暴露只读观测数据，供 Loop Fixture 核对 Tool Result，
+ * 包括 `isError=true` 的 Validation/Authorization/Execution Error 回填。
+ */
+export interface ScriptedModel extends ModelAdapter {
+    readonly requests: readonly ModelRequest[];
+    readonly remainingTurns: number;
+}
+export declare function createScriptedModel(options: ScriptedModelOptions): ScriptedModel;
+export {};
+//# sourceMappingURL=scripted-model.d.ts.map

package/dist/scripted-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted-model.d.ts","sourceRoot":"","sources":["../src/scripted-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,YAAY,EAGZ,KAAK,EACN,MAAM,kBAAkB,CAAC;AAK1B;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB,CAAC;IACC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,GAAG,qBAAqB,CAAC,GAC1B,CAAC;IACC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B,GAAG,qBAAqB,CAAC,GAC1B,CAAC;IACC,IAAI,EAAE,SAAS,CAAC;IAChB,0CAA0C;IAC1C,OAAO,EAAE,gBAAgB,CAAC;IAC1B,oCAAoC;IACpC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B,GAAG,qBAAqB,CAAC,GAC1B;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,4CAA4C;IAC5C,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CAEd,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3C,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAOD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAmEhF"}

package/dist/scripted-model.js

@@ -0,0 +1,158 @@
+import { assertModelRequestCapabilities, AtomsAgentError } from "@atoms-agent/llm";
+import { createDeterministicIds } from "./ids.js";
+const EMPTY_USAGE = {
+    inputTokens: 0,
+    outputTokens: 0,
+};
+export function createScriptedModel(options) {
+    const script = structuredClone(options.script);
+    const requests = [];
+    const nextId = createDeterministicIds();
+    const modelId = options.modelId ?? "scripted:model";
+    const capabilities = Object.freeze({
+        streaming: true,
+        toolCalls: "parallel",
+        structuredOutput: "none",
+        ...options.capabilities,
+    });
+    let cursor = 0;
+    if (modelId.length === 0) {
+        throw new AtomsAgentError("CONFIG_ERROR", "Scripted modelId must not be empty.");
+    }
+    return {
+        modelId,
+        capabilities,
+        get requests() {
+            return structuredClone(requests);
+        },
+        get remainingTurns() {
+            return script.length - cursor;
+        },
+        stream(request, streamOptions) {
+            assertModelRequestCapabilities({ modelId, capabilities }, request);
+            return runTurn(request, streamOptions);
+        },
+    };
+    async function* runTurn(request, streamOptions) {
+        throwIfCancelled(streamOptions?.signal);
+        const turn = script[cursor];
+        if (turn === undefined) {
+            throw new AtomsAgentError("CONFIG_ERROR", `Scripted model has no turn configured for request ${cursor + 1}.`);
+        }
+        cursor += 1;
+        requests.push(structuredClone(request));
+        if (turn.kind === "provider_error") {
+            throw new AtomsAgentError("PROVIDER_ERROR", turn.message, {
+                retryable: turn.retryable,
+                retryAfterMs: turn.retryAfterMs,
+            });
+        }
+        if (turn.kind === "hang") {
+            await waitForCancellation(streamOptions?.signal);
+            return;
+        }
+        const events = buildMessageEvents(turn, nextId);
+        for (const event of events) {
+            throwIfCancelled(streamOptions?.signal);
+            yield event;
+        }
+    }
+}
+function buildMessageEvents(turn, nextId) {
+    if (turn.kind === "text") {
+        const text = turn.deltas.join("");
+        const message = {
+            role: "assistant",
+            content: [{ type: "text", text }],
+        };
+        return messageEvents(message, turn.deltas, turn.usage, turn.finishReason ?? "stop");
+    }
+    if (turn.kind === "tool_calls") {
+        if (turn.calls.length === 0) {
+            throw new AtomsAgentError("CONFIG_ERROR", "A scripted tool_calls turn requires a call.");
+        }
+        const deltas = turn.deltas ?? [];
+        const text = deltas.join("");
+        const message = {
+            role: "assistant",
+            content: [
+                ...(text.length > 0 ? [{ type: "text", text }] : []),
+                ...turn.calls.map((call) => ({
+                    type: "tool_call",
+                    toolCallId: call.toolCallId ?? nextId("tool-call"),
+                    toolName: call.toolName,
+                    input: structuredClone(call.input),
+                })),
+            ],
+        };
+        assertUniqueToolCallIds(message);
+        return messageEvents(message, deltas, turn.usage, turn.finishReason ?? "tool_calls");
+    }
+    const message = structuredClone(turn.message);
+    const deltas = turn.deltas ?? [];
+    if (turn.deltas !== undefined && deltas.join("") !== messageText(message)) {
+        throw new AtomsAgentError("CONFIG_ERROR", "Scripted message deltas do not match the complete assistant message.");
+    }
+    assertUniqueToolCallIds(message);
+    const hasToolCalls = message.content.some((block) => block.type === "tool_call");
+    return messageEvents(message, deltas, turn.usage, turn.finishReason ?? (hasToolCalls ? "tool_calls" : "stop"));
+}
+function messageEvents(message, deltas, usage, finishReason) {
+    const toolCalls = message.content
+        .filter((block) => block.type === "tool_call")
+        .map((block) => ({
+        type: "tool_call",
+        toolCallId: block.toolCallId,
+        toolName: block.toolName,
+        input: structuredClone(block.input),
+    }));
+    return [
+        { type: "message_start" },
+        ...deltas.map((delta) => ({ type: "text_delta", delta })),
+        ...toolCalls,
+        {
+            type: "message_end",
+            message: structuredClone(message),
+            usage: structuredClone(usage ?? EMPTY_USAGE),
+            finishReason,
+        },
+    ];
+}
+function messageText(message) {
+    return message.content
+        .filter((block) => block.type === "text")
+        .map((block) => block.text)
+        .join("");
+}
+function assertUniqueToolCallIds(message) {
+    const seen = new Set();
+    for (const block of message.content) {
+        if (block.type !== "tool_call") {
+            continue;
+        }
+        if (block.toolCallId.length === 0 || seen.has(block.toolCallId)) {
+            throw new AtomsAgentError("CONFIG_ERROR", "Scripted assistant messages require unique, non-empty Tool Call IDs.");
+        }
+        seen.add(block.toolCallId);
+    }
+}
+function throwIfCancelled(signal) {
+    if (signal?.aborted === true) {
+        throw cancellationError(signal);
+    }
+}
+async function waitForCancellation(signal) {
+    if (signal === undefined) {
+        return new Promise(() => undefined);
+    }
+    throwIfCancelled(signal);
+    return new Promise((_resolve, reject) => {
+        signal.addEventListener("abort", () => reject(cancellationError(signal)), { once: true });
+    });
+}
+function cancellationError(signal) {
+    return new AtomsAgentError("CANCELLED", "Scripted model stream was cancelled.", {
+        cause: signal.reason,
+    });
+}
+//# sourceMappingURL=scripted-model.js.map

package/dist/scripted-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted-model.js","sourceRoot":"","sources":["../src/scripted-model.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@atoms-agent/testing",
+  "version": "0.3.0",
+  "type": "module",
+  "description": "ScriptedModel, fake clock, deterministic ids and loop fixtures for offline agent testing",
+  "license": "MIT",
+  "author": "atoms_agent contributors",
+  "homepage": "https://github.com/Fufu-0101/atoms_agent#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Fufu-0101/atoms_agent.git",
+    "directory": "packages/testing"
+  },
+  "bugs": {
+    "url": "https://github.com/Fufu-0101/atoms_agent/issues"
+  },
+  "keywords": [
+    "agent",
+    "testing",
+    "scripted-model",
+    "fixtures",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.13"
+  },
+  "dependencies": {
+    "@atoms-agent/core": "0.3.0",
+    "@atoms-agent/llm": "0.3.0"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsc -b"
+  }
+}