@superdurable/dex-agents 0.0.0-stage → 0.2.0

package/dist/src/testing/coordination.js

@@ -0,0 +1,155 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+import { pollUntil } from "./polling.js";
+const gatePollIntervalMs = 50;
+/**
+ * Pauses code in a Worker child at an exact point until the test releases it.
+ *
+ * The child calls {@link markReached} and then awaits {@link waitForRelease}. The test awaits
+ * {@link waitUntilReached} and then kills the Worker, or calls {@link release}. Both sides construct
+ * the gate with the same directory and name. The gate survives Worker kills, so a replacement Worker
+ * passes a released gate immediately. It mirrors the Python core's `FileGate`.
+ *
+ * @example
+ * ```ts
+ * // In the tool, inside the Worker child:
+ * const gate = new FileGate(stateDirectory, "charge");
+ * gate.markReached();
+ * await gate.waitForRelease(call.cancellationSignal);
+ *
+ * // In the test:
+ * await new FileGate(stateDirectory, "charge").waitUntilReached();
+ * await worker.kill();
+ * ```
+ */
+export class FileGate {
+    reachedPath;
+    releasedPath;
+    /**
+     * Names a gate inside a directory both processes can read.
+     * @param directory - Shared directory, created when needed.
+     * @param name - Gate name, unique within the directory.
+     */
+    constructor(directory, name) {
+        this.reachedPath = join(directory, `${name}.reached`);
+        this.releasedPath = join(directory, `${name}.released`);
+    }
+    /** Records that code reached the gate; repeated calls count each arrival. */
+    markReached() {
+        mkdirSync(dirname(this.reachedPath), { recursive: true });
+        appendFileSync(this.reachedPath, "reached\n");
+    }
+    /**
+     * Returns how many times code reached the gate.
+     * @returns The number of {@link markReached} calls across all processes.
+     */
+    reachedCount() {
+        return readLines(this.reachedPath).length;
+    }
+    /**
+     * Reports whether the test released the gate.
+     * @returns `true` after {@link release}.
+     */
+    isReleased() {
+        return existsSync(this.releasedPath);
+    }
+    /** Lets current and future waiters pass the gate. */
+    release() {
+        mkdirSync(dirname(this.releasedPath), { recursive: true });
+        writeFileSync(this.releasedPath, "");
+    }
+    /**
+     * Waits until the test releases the gate.
+     *
+     * It never times out: the test either releases the gate or kills the waiting process. Pass the
+     * attempt's cancellation signal so a canceled attempt stops waiting.
+     * @param signal - Optional signal that ends the wait with an `AbortError`.
+     * @returns A Promise that resolves once the gate is released.
+     */
+    async waitForRelease(signal) {
+        while (!this.isReleased()) {
+            await delay(gatePollIntervalMs, undefined, signal === undefined ? {} : { signal });
+        }
+    }
+    /**
+     * Waits until code reached the gate `count` times.
+     * @param count - Arrivals to wait for. Defaults to 1.
+     * @param timeoutMs - Maximum wait in milliseconds. Defaults to 90,000.
+     * @returns A Promise that resolves once the gate was reached often enough.
+     * @throws {Error} When the timeout passes first.
+     */
+    async waitUntilReached(count = 1, timeoutMs = 90_000) {
+        await pollUntil(() => (this.reachedCount() >= count ? true : undefined), {
+            description: `gate ${this.reachedPath} reached ${count} time(s)`,
+            timeoutMs,
+            intervalMs: gatePollIntervalMs,
+        });
+    }
+}
+/**
+ * Counts how often named operations ran, across Worker processes.
+ *
+ * A tool in the Worker child records each real run; the test then asserts that a write ran exactly
+ * once, even across a Worker kill. Each record is appended synchronously, so it survives a SIGKILL
+ * right after. It mirrors the Python core's `InvocationLog`.
+ *
+ * @example
+ * ```ts
+ * new InvocationLog(join(stateDirectory, "invocations.log")).record("send_email");
+ * assert.equal(new InvocationLog(join(stateDirectory, "invocations.log")).count("send_email"), 1);
+ * ```
+ */
+export class InvocationLog {
+    path;
+    /**
+     * Uses one append-only file shared by the test and its Workers.
+     * @param path - Log file, created on the first record.
+     */
+    constructor(path) {
+        this.path = path;
+    }
+    /**
+     * Appends one run of `name`.
+     * @param name - Operation name without line breaks.
+     * @throws {TypeError} When `name` contains a line break.
+     */
+    record(name) {
+        if (/[\r\n]/.test(name)) {
+            throw new TypeError("InvocationLog names cannot contain line breaks");
+        }
+        mkdirSync(dirname(this.path), { recursive: true });
+        appendFileSync(this.path, `${name}\n`);
+    }
+    /**
+     * Returns how many runs of `name` were recorded.
+     * @param name - Operation name.
+     * @returns The number of matching records.
+     */
+    count(name) {
+        return this.names().filter((recordedName) => recordedName === name).length;
+    }
+    /**
+     * Returns every recorded name in order.
+     * @returns The records, oldest first, or an empty array before the first record.
+     */
+    names() {
+        return readLines(this.path);
+    }
+}
+function readLines(path) {
+    if (!existsSync(path)) {
+        return [];
+    }
+    return readFileSync(path, "utf8")
+        .split("\n")
+        .filter((line) => line !== "");
+}
+//# sourceMappingURL=coordination.js.map

package/dist/src/testing/coordination.js.map

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

package/dist/src/testing/index.d.ts

@@ -0,0 +1,8 @@
+export { AgentSessionTestClient, type AgentSessionWaitOptions, } from "./agent-session-test-client.js";
+export { AgentTestEnvironment, type AgentTestEnvironmentOptions, } from "./agent-test-environment.js";
+export { KillableWorkerProcess, agentWorkerBlobCacheDirectoryVariable, agentWorkerReadyLine, agentWorkerServerAddressVariable, runAgentWorkerProcess, type KillableWorkerProcessOptions, } from "./agent-worker-process.js";
+export { FileGate, InvocationLog } from "./coordination.js";
+export { pollUntil, type PollOptions } from "./polling.js";
+export { ScriptedModelClient, scriptedModelApi, scriptedModelProvider, type ScriptedModelReply, type ScriptedModelResponder, type ScriptedToolCall, } from "./scripted-model-client.js";
+export { executeCompletedEvent, readStepHistory, waitForCompletedEvent, type ReadStepHistoryOptions, type StepHistoryEntry, } from "./step-history.js";
+export { PrivateDexEngine, findFreeLoopbackPort, findFreeLoopbackPorts, type PrivateDexEngineOptions, } from "./private-dex-engine.js";

package/dist/src/testing/index.js

@@ -0,0 +1,16 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+export { AgentSessionTestClient, } from "./agent-session-test-client.js";
+export { AgentTestEnvironment, } from "./agent-test-environment.js";
+export { KillableWorkerProcess, agentWorkerBlobCacheDirectoryVariable, agentWorkerReadyLine, agentWorkerServerAddressVariable, runAgentWorkerProcess, } from "./agent-worker-process.js";
+export { FileGate, InvocationLog } from "./coordination.js";
+export { pollUntil } from "./polling.js";
+export { ScriptedModelClient, scriptedModelApi, scriptedModelProvider, } from "./scripted-model-client.js";
+export { executeCompletedEvent, readStepHistory, waitForCompletedEvent, } from "./step-history.js";
+export { PrivateDexEngine, findFreeLoopbackPort, findFreeLoopbackPorts, } from "./private-dex-engine.js";
+//# sourceMappingURL=index.js.map

package/dist/src/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,EACL,sBAAsB,GAEvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,oBAAoB,GAErB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,qBAAqB,EACrB,qCAAqC,EACrC,oBAAoB,EACpB,gCAAgC,EAChC,qBAAqB,GAEtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAoB,MAAM,cAAc,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,qBAAqB,GAGtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,yBAAyB,CAAC"}

package/dist/src/testing/polling.d.ts

@@ -0,0 +1,31 @@
+/** Options of {@link pollUntil}. */
+export interface PollOptions {
+    /** What is awaited, used in the timeout error. */
+    readonly description: string;
+    /** Total milliseconds to wait. Defaults to 90,000. */
+    readonly timeoutMs?: number;
+    /** Milliseconds between probes. Defaults to 200. */
+    readonly intervalMs?: number;
+    /** Signal that ends the wait early with an `AbortError`. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Calls a probe until it returns a value other than `undefined`, or the deadline passes.
+ *
+ * A probe that throws counts as not ready, so a probe can call an RPC while no Worker runs.
+ * Use it only for state that has no direct Client wait.
+ *
+ * @example
+ * ```ts
+ * const toolCall = await pollUntil(async () => {
+ *   const [record] = await client.getAttributes(sessionId, flow.persistence.agentToolCalls.instance(id));
+ *   return record?.status === "outcome_unknown" ? record : undefined;
+ * }, { description: "outcome_unknown tool call" });
+ * ```
+ * @typeParam Value - Value returned by the probe once ready.
+ * @param probe - Returns the awaited value, or `undefined` while not ready.
+ * @param options - Description, timeout, interval, and signal.
+ * @returns The first value the probe returned.
+ * @throws {Error} When the deadline passes; the message holds the description and the last probe error.
+ */
+export declare function pollUntil<Value>(probe: () => Value | undefined | Promise<Value | undefined>, options: PollOptions): Promise<Value>;

package/dist/src/testing/polling.js

@@ -0,0 +1,51 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { setTimeout as delay } from "node:timers/promises";
+/**
+ * Calls a probe until it returns a value other than `undefined`, or the deadline passes.
+ *
+ * A probe that throws counts as not ready, so a probe can call an RPC while no Worker runs.
+ * Use it only for state that has no direct Client wait.
+ *
+ * @example
+ * ```ts
+ * const toolCall = await pollUntil(async () => {
+ *   const [record] = await client.getAttributes(sessionId, flow.persistence.agentToolCalls.instance(id));
+ *   return record?.status === "outcome_unknown" ? record : undefined;
+ * }, { description: "outcome_unknown tool call" });
+ * ```
+ * @typeParam Value - Value returned by the probe once ready.
+ * @param probe - Returns the awaited value, or `undefined` while not ready.
+ * @param options - Description, timeout, interval, and signal.
+ * @returns The first value the probe returned.
+ * @throws {Error} When the deadline passes; the message holds the description and the last probe error.
+ */
+export async function pollUntil(probe, options) {
+    const deadline = Date.now() + (options.timeoutMs ?? 90_000);
+    let lastError;
+    for (;;) {
+        options.signal?.throwIfAborted();
+        try {
+            const value = await probe();
+            if (value !== undefined) {
+                return value;
+            }
+        }
+        catch (error) {
+            lastError = error;
+        }
+        if (Date.now() >= deadline) {
+            const lastErrorText = lastError === undefined ? "" : `; last probe error: ${String(lastError)}`;
+            throw new Error(`timed out waiting for ${options.description}${lastErrorText}`, {
+                cause: lastError,
+            });
+        }
+        await delay(options.intervalMs ?? 200, undefined, options.signal === undefined ? {} : { signal: options.signal });
+    }
+}
+//# sourceMappingURL=polling.js.map

package/dist/src/testing/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../../../src/testing/polling.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAE1D,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAc3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAA2D,EAC3D,OAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;IAC5D,IAAI,SAAkB,CAAC;IACvB,SAAS,CAAC;QACR,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC;YAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,aAAa,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAChG,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,WAAW,GAAG,aAAa,EAAE,EAAE;gBAC9E,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,IAAI,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpH,CAAC;AACH,CAAC"}

package/dist/src/testing/private-dex-engine.d.ts

@@ -0,0 +1,101 @@
+/** Options of {@link PrivateDexEngine.start}. */
+export interface PrivateDexEngineOptions {
+    /**
+     * Path to the `dexcli` executable. Defaults to the `DEXCLI` environment variable, then `dexcli`
+     * on `PATH`.
+     */
+    readonly dexcliPath?: string;
+    /**
+     * Path to `dex-server-zd`. Defaults to `DEX_SERVER_ZD_BINARY`, then the file next to `dexcli`,
+     * then the `dexcli` default.
+     */
+    readonly serverZdPath?: string;
+    /**
+     * Directory for engine state and logs. Defaults to a new temporary directory, which
+     * {@link PrivateDexEngine.stop} deletes. A supplied directory is kept.
+     */
+    readonly stateDirectory?: string;
+    /** Milliseconds to wait for the engine to report readiness. Defaults to 60,000. */
+    readonly readyTimeoutMs?: number;
+    /**
+     * Path of a `dex-server-zd` YAML file with configuration overrides, passed as `dexcli dev -zd-config`.
+     * Use it to test server settings, such as `streamStore: { backend: disabled }`, which drops
+     * Step Stream writes. When omitted, the engine gets a file that sets only
+     * `dev.durabilityMode: processCrashSafe`, which skips fsync and survives a process kill but not a host
+     * crash. A file of your own replaces it, so set `dev.durabilityMode` there too, or the engine uses the
+     * slower `strict` default of `dex-server-zd` 0.1.18 and later.
+     */
+    readonly serverZdConfigPath?: string;
+}
+/**
+ * A private `dexcli dev --engine zd` instance on free loopback ports, owned by one test process.
+ *
+ * Each instance has its own state directory and ports, so tests and other engines on the machine
+ * never share state. The engine runs in its own process group; {@link stop} ends `dexcli` and
+ * `dex-server-zd` together. Engines still running when the test process exits receive SIGKILL.
+ *
+ * @example
+ * ```ts
+ * import { before, after } from "node:test";
+ * import { PrivateDexEngine } from "@superdurable/dex-agents/testing";
+ *
+ * let engine: PrivateDexEngine;
+ * before(async () => { engine = await PrivateDexEngine.start(); });
+ * after(async () => { await engine.stop(); });
+ * ```
+ */
+export declare class PrivateDexEngine {
+    /** Dex Server gRPC address, `127.0.0.1:<port>`, for Client and Worker `serverAddress`. */
+    readonly serverAddress: string;
+    /** Dex Web URL of this engine, useful when debugging a failing test. */
+    readonly webUrl: string;
+    /** Directory holding the engine state, its log, and test-owned files. */
+    readonly stateDirectory: string;
+    /** Path of the combined `dexcli` and `dex-server-zd` log. */
+    readonly logPath: string;
+    private readonly processGroup;
+    private readonly isStateDirectoryOwned;
+    private constructor();
+    /**
+     * Starts an engine and waits until it reports readiness.
+     *
+     * Ports are chosen by the operating system. A start that loses a port race is retried with new
+     * ports, up to three times.
+     *
+     * @param options - Executable paths, state directory, and readiness timeout.
+     * @returns The running engine.
+     * @throws {Error} When `dexcli` cannot start or never reports readiness; the message holds its log.
+     */
+    static start(options?: PrivateDexEngineOptions): Promise<PrivateDexEngine>;
+    /**
+     * Returns the engine log written since it started.
+     * @returns The combined `dexcli` and `dex-server-zd` output.
+     */
+    readLog(): string;
+    /**
+     * Stops the engine and, when the state directory was created by {@link start}, deletes it.
+     *
+     * Sends SIGTERM to the engine's process group and SIGKILL after 15 seconds. Calling it again is safe.
+     * @returns A Promise that resolves after the engine exited.
+     */
+    stop(): Promise<void>;
+}
+/**
+ * Returns a TCP port on 127.0.0.1 that was free when checked.
+ *
+ * Another process can still take the port before it is used, so callers retry on bind failures.
+ * Use {@link findFreeLoopbackPorts} when a caller needs several ports at once.
+ * @returns A port number chosen by the operating system.
+ */
+export declare function findFreeLoopbackPort(): Promise<number>;
+/**
+ * Returns distinct TCP ports on 127.0.0.1 that were free when checked.
+ *
+ * Every listener stays open until all ports are chosen, so the operating system never hands out
+ * the same port twice. Another process can still take a port after the listeners close, so callers
+ * retry on bind failures.
+ * @param count - Number of ports, at least 1.
+ * @returns `count` distinct port numbers chosen by the operating system.
+ * @throws {RangeError} When `count` is not a positive integer.
+ */
+export declare function findFreeLoopbackPorts(count: number): Promise<number[]>;

package/dist/src/testing/private-dex-engine.js

@@ -0,0 +1,223 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+import { existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { createServer } from "node:net";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { ChildProcessGroup } from "./child-process-group.js";
+const engineReadyLine = "Dex development environment is ready";
+const startAttempts = 3;
+// A config file also works with dexcli releases that predate --durability.
+const processCrashSafeServerZdConfig = "dev:\n  durabilityMode: processCrashSafe\n";
+/**
+ * A private `dexcli dev --engine zd` instance on free loopback ports, owned by one test process.
+ *
+ * Each instance has its own state directory and ports, so tests and other engines on the machine
+ * never share state. The engine runs in its own process group; {@link stop} ends `dexcli` and
+ * `dex-server-zd` together. Engines still running when the test process exits receive SIGKILL.
+ *
+ * @example
+ * ```ts
+ * import { before, after } from "node:test";
+ * import { PrivateDexEngine } from "@superdurable/dex-agents/testing";
+ *
+ * let engine: PrivateDexEngine;
+ * before(async () => { engine = await PrivateDexEngine.start(); });
+ * after(async () => { await engine.stop(); });
+ * ```
+ */
+export class PrivateDexEngine {
+    serverAddress;
+    webUrl;
+    stateDirectory;
+    logPath;
+    processGroup;
+    isStateDirectoryOwned;
+    constructor(
+    /** Dex Server gRPC address, `127.0.0.1:<port>`, for Client and Worker `serverAddress`. */
+    serverAddress, 
+    /** Dex Web URL of this engine, useful when debugging a failing test. */
+    webUrl, 
+    /** Directory holding the engine state, its log, and test-owned files. */
+    stateDirectory, 
+    /** Path of the combined `dexcli` and `dex-server-zd` log. */
+    logPath, processGroup, isStateDirectoryOwned) {
+        this.serverAddress = serverAddress;
+        this.webUrl = webUrl;
+        this.stateDirectory = stateDirectory;
+        this.logPath = logPath;
+        this.processGroup = processGroup;
+        this.isStateDirectoryOwned = isStateDirectoryOwned;
+    }
+    /**
+     * Starts an engine and waits until it reports readiness.
+     *
+     * Ports are chosen by the operating system. A start that loses a port race is retried with new
+     * ports, up to three times.
+     *
+     * @param options - Executable paths, state directory, and readiness timeout.
+     * @returns The running engine.
+     * @throws {Error} When `dexcli` cannot start or never reports readiness; the message holds its log.
+     */
+    static async start(options = {}) {
+        const dexcliPath = options.dexcliPath ?? process.env.DEXCLI ?? "dexcli";
+        const serverZdPath = options.serverZdPath ?? resolveServerZdPath(dexcliPath);
+        const isStateDirectoryOwned = options.stateDirectory === undefined;
+        const stateDirectory = options.stateDirectory ?? mkdtempSync(join(tmpdir(), "dex-agents-engine-"));
+        mkdirSync(stateDirectory, { recursive: true });
+        const logPath = join(stateDirectory, "dexcli.log");
+        let configPath = options.serverZdConfigPath;
+        if (configPath === undefined) {
+            configPath = join(stateDirectory, "zd-overrides.yaml");
+            writeFileSync(configPath, processCrashSafeServerZdConfig);
+        }
+        let lastFailure;
+        for (let attempt = 1; attempt <= startAttempts; attempt += 1) {
+            const [dexPort, webPort] = await findFreeLoopbackPorts(2);
+            if (dexPort === undefined || webPort === undefined) {
+                throw new Error("findFreeLoopbackPorts returned too few ports");
+            }
+            const commandArguments = [
+                "dev",
+                "-engine",
+                "zd",
+                "-bind-address",
+                "127.0.0.1",
+                "-dex-port",
+                String(dexPort),
+                "-web-port",
+                String(webPort),
+                "-open=false",
+                "-zd-data-dir",
+                join(stateDirectory, `zd-${attempt}`),
+                "-connector-config-dir",
+                join(stateDirectory, "connectors"),
+            ];
+            if (serverZdPath !== undefined) {
+                commandArguments.push("-zd-binary", serverZdPath);
+            }
+            commandArguments.push("-zd-config", configPath);
+            try {
+                const processGroup = await ChildProcessGroup.start({
+                    description: "dexcli dev",
+                    command: dexcliPath,
+                    commandArguments,
+                    environment: process.env,
+                    logPath,
+                    readyLine: engineReadyLine,
+                    readyTimeoutMs: options.readyTimeoutMs ?? 60_000,
+                });
+                return new PrivateDexEngine(`127.0.0.1:${dexPort}`, `http://127.0.0.1:${webPort}`, stateDirectory, logPath, processGroup, isStateDirectoryOwned);
+            }
+            catch (error) {
+                lastFailure = error;
+            }
+        }
+        if (isStateDirectoryOwned) {
+            rmSync(stateDirectory, { recursive: true, force: true });
+        }
+        throw new Error(`dexcli dev did not start after ${startAttempts} attempts`, {
+            cause: lastFailure,
+        });
+    }
+    /**
+     * Returns the engine log written since it started.
+     * @returns The combined `dexcli` and `dex-server-zd` output.
+     */
+    readLog() {
+        return this.processGroup.readLog();
+    }
+    /**
+     * Stops the engine and, when the state directory was created by {@link start}, deletes it.
+     *
+     * Sends SIGTERM to the engine's process group and SIGKILL after 15 seconds. Calling it again is safe.
+     * @returns A Promise that resolves after the engine exited.
+     */
+    async stop() {
+        await this.processGroup.stop();
+        if (this.isStateDirectoryOwned) {
+            rmSync(this.stateDirectory, { recursive: true, force: true });
+        }
+    }
+}
+/**
+ * Returns a TCP port on 127.0.0.1 that was free when checked.
+ *
+ * Another process can still take the port before it is used, so callers retry on bind failures.
+ * Use {@link findFreeLoopbackPorts} when a caller needs several ports at once.
+ * @returns A port number chosen by the operating system.
+ */
+export async function findFreeLoopbackPort() {
+    const [port] = await findFreeLoopbackPorts(1);
+    if (port === undefined) {
+        throw new Error("no loopback port was chosen");
+    }
+    return port;
+}
+/**
+ * Returns distinct TCP ports on 127.0.0.1 that were free when checked.
+ *
+ * Every listener stays open until all ports are chosen, so the operating system never hands out
+ * the same port twice. Another process can still take a port after the listeners close, so callers
+ * retry on bind failures.
+ * @param count - Number of ports, at least 1.
+ * @returns `count` distinct port numbers chosen by the operating system.
+ * @throws {RangeError} When `count` is not a positive integer.
+ */
+export async function findFreeLoopbackPorts(count) {
+    if (!Number.isSafeInteger(count) || count <= 0) {
+        throw new RangeError(`port count must be a positive integer: ${count}`);
+    }
+    const servers = [];
+    try {
+        const ports = [];
+        for (let index = 0; index < count; index += 1) {
+            const server = createServer();
+            servers.push(server);
+            ports.push(await listenOnFreeLoopbackPort(server));
+        }
+        return ports;
+    }
+    finally {
+        await Promise.all(servers.map((server) => closeServer(server)));
+    }
+}
+function listenOnFreeLoopbackPort(server) {
+    return new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            const address = server.address();
+            if (address === null || typeof address === "string") {
+                reject(new Error("loopback listener has no port"));
+                return;
+            }
+            resolve(address.port);
+        });
+    });
+}
+function closeServer(server) {
+    return new Promise((resolve) => {
+        if (!server.listening) {
+            resolve();
+            return;
+        }
+        server.close(() => resolve());
+    });
+}
+function resolveServerZdPath(dexcliPath) {
+    const fromEnvironment = process.env.DEX_SERVER_ZD_BINARY;
+    if (fromEnvironment !== undefined && fromEnvironment !== "") {
+        return fromEnvironment;
+    }
+    if (!dexcliPath.includes("/")) {
+        return undefined;
+    }
+    const sibling = join(dirname(dexcliPath), "dex-server-zd");
+    return existsSync(sibling) ? sibling : undefined;
+}
+//# sourceMappingURL=private-dex-engine.js.map

package/dist/src/testing/private-dex-engine.js.map

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

package/dist/src/testing/scripted-model-client.d.ts

@@ -0,0 +1 @@
+export { ScriptedModelClient, scriptedModelApi, scriptedModelProvider, type ScriptedModelReply, type ScriptedModelResponder, type ScriptedToolCall, } from "../stepwise/scripted-model-client.js";

package/dist/src/testing/scripted-model-client.js

@@ -0,0 +1,10 @@
+// Copyright (c) 2026 Super Durable, Inc.
+//
+// Licensed under the Sustainable Use License 1.0.
+// You may not use this file except in compliance with the License.
+// See the LICENSE file in the repository root.
+//
+// SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+// The scripted model client lives in the stepwise entry point; this path keeps the 0.1.0 module.
+export { ScriptedModelClient, scriptedModelApi, scriptedModelProvider, } from "../stepwise/scripted-model-client.js";
+//# sourceMappingURL=scripted-model-client.js.map

package/dist/src/testing/scripted-model-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted-model-client.js","sourceRoot":"","sources":["../../../src/testing/scripted-model-client.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,kDAAkD;AAClD,mEAAmE;AACnE,+CAA+C;AAC/C,EAAE;AACF,0DAA0D;AAG1D,iGAAiG;AACjG,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,GAItB,MAAM,sCAAsC,CAAC"}