@trigger.dev/core 0.0.0-prerelease-20260508094307 → 0.0.0-prerelease-deployment-base-image-20260814120901

package/dist/esm/v3/telnetLogServer.test.js

@@ -0,0 +1,139 @@
+import net from "node:net";
+import { afterEach, describe, expect, test } from "vitest";
+import { formatConsoleLine, formatLogLine, stripAnsi, TelnetLogServer } from "./telnetLogServer.js";
+const servers = [];
+afterEach(() => {
+    while (servers.length) {
+        servers.pop()?.close();
+    }
+});
+/** Grab a port the OS just told us is free, then hand it to a TelnetLogServer. */
+async function startServerOnFreePort(name = "test") {
+    const probe = net.createServer();
+    const port = await listening(probe, 0);
+    await new Promise((resolve) => probe.close(() => resolve()));
+    // A banner lets clients deterministically wait until the server has registered them
+    // (it's written in the connection handler), removing the connect/register race.
+    const server = new TelnetLogServer({ port, name, banner: "ready" });
+    servers.push(server);
+    server.start();
+    await delay(30);
+    return { server, port };
+}
+/** Connects and resolves only once the first bytes (the banner) arrive — server-side socket is registered by then. */
+function connectAndCollect(port) {
+    return new Promise((resolve, reject) => {
+        let buffer = "";
+        const socket = net.connect(port, "127.0.0.1");
+        socket.setEncoding("utf8");
+        socket.on("data", (chunk) => {
+            const first = buffer === "";
+            buffer += chunk;
+            if (first) {
+                resolve({ socket, lines: () => buffer });
+            }
+        });
+        socket.on("error", reject);
+    });
+}
+function listening(server, port, host = "127.0.0.1") {
+    return new Promise((resolve) => {
+        server.listen(port, host, () => {
+            const address = server.address();
+            resolve(typeof address === "object" && address ? address.port : port);
+        });
+    });
+}
+describe("stripAnsi", () => {
+    test("removes color escape codes", () => {
+        const colored = "2026-06-11 ERROR boom";
+        expect(stripAnsi(colored)).toBe("2026-06-11 ERROR boom");
+    });
+});
+describe("formatLogLine", () => {
+    test("formats a core Logger-shaped object (level/name)", () => {
+        const line = formatLogLine({
+            timestamp: new Date("2026-06-11T12:00:00.000Z"),
+            name: "webapp",
+            level: "info",
+            message: "queue drained",
+            count: 3,
+        });
+        expect(line).toBe("2026-06-11T12:00:00.000Z INFO  [webapp] queue drained {count=3}");
+    });
+    test("formats a SimpleStructuredLogger-shaped object ($level/$name)", () => {
+        const line = formatLogLine({
+            timestamp: new Date("2026-06-11T12:00:00.000Z"),
+            $name: "supervisor",
+            $level: "warn",
+            message: "retrying",
+            attempt: 2,
+        });
+        expect(line).toBe("2026-06-11T12:00:00.000Z WARN  [supervisor] retrying {attempt=2}");
+    });
+    test("omits empty name and extras", () => {
+        const line = formatLogLine({
+            timestamp: "2026-06-11T12:00:00.000Z",
+            level: "log",
+            message: "hello",
+        });
+        expect(line).toBe("2026-06-11T12:00:00.000Z LOG   hello");
+    });
+});
+describe("formatConsoleLine", () => {
+    test("pretty-formats a JSON structured-log line", () => {
+        const raw = JSON.stringify({
+            timestamp: "2026-06-11T12:00:00.000Z",
+            name: "sso-plugin",
+            level: "info",
+            message: "sso.webhook.connection.activated: connection marked active",
+            connId: "conn_123",
+        });
+        expect(formatConsoleLine(raw)).toBe("2026-06-11T12:00:00.000Z INFO  [sso-plugin] sso.webhook.connection.activated: connection marked active {connId=conn_123}");
+    });
+    test("passes non-JSON console output through unchanged", () => {
+        expect(formatConsoleLine("GET /healthcheck 200 1.2 ms")).toBe("GET /healthcheck 200 1.2 ms");
+    });
+    test("passes JSON that isn't a structured log through unchanged", () => {
+        const raw = JSON.stringify({ foo: "bar" });
+        expect(formatConsoleLine(raw)).toBe(raw);
+    });
+});
+describe("TelnetLogServer", () => {
+    test("broadcasts a line to a connected client", async () => {
+        const { server, port } = await startServerOnFreePort();
+        const client = await connectAndCollect(port);
+        server.broadcast("first line");
+        await delay(50);
+        expect(client.lines()).toContain("first line\r\n");
+        client.socket.destroy();
+    });
+    test("close() ends connected sockets", async () => {
+        const { server, port } = await startServerOnFreePort();
+        const client = await connectAndCollect(port);
+        server.broadcast("alive");
+        await delay(30);
+        expect(client.lines()).toContain("alive\r\n");
+        let closed = false;
+        client.socket.on("close", () => {
+            closed = true;
+        });
+        server.close();
+        await delay(30);
+        expect(closed).toBe(true);
+    });
+    test("EADDRINUSE does not throw", async () => {
+        const blocker = net.createServer();
+        const port = await listening(blocker, 0);
+        const server = new TelnetLogServer({ port, name: "test" });
+        servers.push(server);
+        // Must not throw even though the port is taken.
+        expect(() => server.start()).not.toThrow();
+        await delay(30);
+        blocker.close();
+    });
+});
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=telnetLogServer.test.js.map

package/dist/esm/v3/telnetLogServer.test.js.map

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

package/dist/esm/v3/test/index.d.ts

@@ -0,0 +1,8 @@
+export { runInMockTaskContext, type MockTaskContextDrivers, type MockTaskContextOptions, } from "./mock-task-context.js";
+export { TestInputStreamManager } from "./test-input-stream-manager.js";
+export { TestRealtimeStreamsManager } from "./test-realtime-streams-manager.js";
+export { TestRunMetadataManager } from "./test-run-metadata-manager.js";
+export { TestSessionStreamManager } from "./test-session-stream-manager.js";
+export { StandardSessionStreamManager } from "../sessionStreams/manager.js";
+export type { SessionStreamManager } from "../sessionStreams/types.js";
+export { SessionWaitpointBackend, TestRuntimeManager, installSessionWaitpointBackend, } from "./session-waitpoint-backend.js";

package/dist/esm/v3/test/index.js

@@ -0,0 +1,8 @@
+export { runInMockTaskContext, } from "./mock-task-context.js";
+export { TestInputStreamManager } from "./test-input-stream-manager.js";
+export { TestRealtimeStreamsManager } from "./test-realtime-streams-manager.js";
+export { TestRunMetadataManager } from "./test-run-metadata-manager.js";
+export { TestSessionStreamManager } from "./test-session-stream-manager.js";
+export { StandardSessionStreamManager } from "../sessionStreams/manager.js";
+export { SessionWaitpointBackend, TestRuntimeManager, installSessionWaitpointBackend, } from "./session-waitpoint-backend.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/v3/test/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/test/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAGrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,gCAAgC,CAAC"}

package/dist/esm/v3/test/mock-task-context.d.ts

@@ -0,0 +1,138 @@
+import type { RuntimeManager } from "../runtime/manager.js";
+import type { ServerBackgroundWorker, TaskRunContext } from "../schemas/index.js";
+import type { LocalsKey } from "../locals/types.js";
+import type { SessionChannelIO, SessionStreamManager } from "../sessionStreams/types.js";
+/**
+ * Shallow-partial overrides applied on top of the default mock
+ * `TaskRunContext`. Each sub-object is a partial of its real shape —
+ * unset fields get sensible defaults.
+ */
+export type MockTaskRunContextOverrides = {
+    task?: Partial<TaskRunContext["task"]>;
+    attempt?: Partial<TaskRunContext["attempt"]>;
+    run?: Partial<TaskRunContext["run"]>;
+    machine?: Partial<TaskRunContext["machine"]>;
+    queue?: Partial<TaskRunContext["queue"]>;
+    environment?: Partial<TaskRunContext["environment"]>;
+    organization?: Partial<TaskRunContext["organization"]>;
+    project?: Partial<TaskRunContext["project"]>;
+    batch?: TaskRunContext["batch"];
+};
+/**
+ * Options for overriding parts of the mock task context.
+ */
+export type MockTaskContextOptions = {
+    /** Overrides applied on top of the default mock `TaskRunContext`. */
+    ctx?: MockTaskRunContextOverrides;
+    /** Overrides applied on top of the default `ServerBackgroundWorker`. */
+    worker?: Partial<ServerBackgroundWorker>;
+    /** Whether this is a warm start. */
+    isWarmStart?: boolean;
+    /**
+     * Session-streams manager installed as the `session-streams` global. Defaults
+     * to an in-memory {@link TestSessionStreamManager}. Pass a real
+     * `StandardSessionStreamManager` (with an ApiClient pointed at a running
+     * webapp) to drive the task's `.in`/`.out` against real streams.
+     */
+    sessionStreamManager?: SessionStreamManager;
+    /**
+     * Runtime manager installed as the `runtime` global. Defaults to a
+     * {@link NoopRuntimeManager}. Pass a `TestRuntimeManager` (wired to a
+     * {@link SessionWaitpointBackend}) to make `session.in.wait()` suspend and
+     * resume in place against real streams, without the run-engine.
+     */
+    runtimeManager?: RuntimeManager;
+};
+/**
+ * Drivers passed to the function running inside `runInMockTaskContext`.
+ */
+export type MockTaskContextDrivers = {
+    /** Push data into input streams — simulates realtime input from outside the task. */
+    inputs: {
+        /**
+         * Send `data` to the named input stream. Resolves when all `.on()`
+         * handlers have run.
+         */
+        send(streamId: string, data: unknown): Promise<void>;
+        /** Resolve any pending `.once()` waiters with a timeout error. */
+        close(streamId: string): void;
+    };
+    /** Inspect chunks written to output (realtime) streams. */
+    outputs: {
+        /** All chunks for a given stream, in the order they were written. */
+        chunks<T = unknown>(streamId: string): T[];
+        /** All chunks across every stream, keyed by stream id. */
+        all(): Record<string, unknown[]>;
+        /** Clear chunks for one stream, or all streams if no id is provided. */
+        clear(streamId?: string): void;
+        /**
+         * Register a listener fired for every chunk written to any stream.
+         * Returns an unsubscribe function.
+         */
+        onWrite(listener: (streamId: string, chunk: unknown) => void): () => void;
+    };
+    /** Read or seed locals for the run. */
+    locals: {
+        /** Read a local set by either the task or `set()` below. */
+        get<T>(key: LocalsKey<T>): T | undefined;
+        /**
+         * Pre-seed a local before the task runs. Use this for dependency
+         * injection — e.g. supply a test database client that the agent's
+         * hooks read via `locals.get()` instead of constructing the prod one.
+         */
+        set<T>(key: LocalsKey<T>, value: T): void;
+    };
+    /**
+     * Session-scoped channel drivers. The `.in` side is backed by a
+     * {@link TestSessionStreamManager} installed as the `sessionStreams`
+     * global — so the task's `session.in.on/once/peek/waitWithIdleTimeout`
+     * calls receive records sent through this driver.
+     */
+    sessions: {
+        in: {
+            /**
+             * Send a record onto `session.in` for the given session. Resolves
+             * pending `once()` waiters and fires all `on()` handlers.
+             */
+            send(sessionId: string, data: unknown, io?: SessionChannelIO): Promise<void>;
+            /** Close pending `once()` waiters with a timeout error. */
+            close(sessionId: string, io?: SessionChannelIO): void;
+        };
+    };
+    /** The mock `TaskRunContext` assembled from defaults + user overrides. */
+    ctx: TaskRunContext;
+};
+/**
+ * Run a function inside a fully mocked task runtime context.
+ *
+ * Installs in-memory test managers for `locals`, `inputStreams`,
+ * `realtimeStreams`, `lifecycleHooks`, and `runtime`, sets a mock
+ * `TaskContext`, and tears everything down when the function returns.
+ *
+ * Inside the function, any code that reads from `locals`, `inputStreams`,
+ * `realtimeStreams`, or `taskContext.ctx` will see the mock context —
+ * so you can directly invoke the internal `run` function of any task
+ * (including `chat.agent`) without hitting the Trigger.dev runtime.
+ *
+ * @example
+ * ```ts
+ * import { runInMockTaskContext } from "@trigger.dev/core/v3/test";
+ *
+ * await runInMockTaskContext(
+ *   async ({ inputs, outputs, ctx }) => {
+ *     // Fire an input stream from the "outside"
+ *     setTimeout(() => {
+ *       inputs.send("chat-messages", { messages: [], chatId: "c1" });
+ *     }, 0);
+ *
+ *     // Run task code that reads from inputStreams.once(...)
+ *     await myTask.fns.run(payload, { ctx, signal: new AbortController().signal });
+ *
+ *     // Inspect chunks written to the output stream
+ *     expect(outputs.chunks("chat")).toContainEqual({ type: "text-delta", delta: "hi" });
+ *   },
+ *   { ctx: { run: { id: "run_abc" } } }
+ * );
+ * ```
+ */
+export declare function runInMockTaskContext<T>(fn: (drivers: MockTaskContextDrivers) => T | Promise<T>, options?: MockTaskContextOptions): Promise<T>;

package/dist/esm/v3/test/mock-task-context.js

@@ -0,0 +1,198 @@
+import { inputStreams } from "../input-streams-api.js";
+import { realtimeStreams } from "../realtime-streams-api.js";
+import { sessionStreams } from "../session-streams-api.js";
+import { localsAPI } from "../locals-api.js";
+import { runMetadata } from "../run-metadata-api.js";
+import { taskContext } from "../task-context-api.js";
+import { lifecycleHooks } from "../lifecycle-hooks-api.js";
+import { runtime } from "../runtime-api.js";
+import { StandardLocalsManager } from "../locals/manager.js";
+import { StandardLifecycleHooksManager } from "../lifecycleHooks/manager.js";
+import { NoopRuntimeManager } from "../runtime/noopRuntimeManager.js";
+import { unregisterGlobal } from "../utils/globals.js";
+import { TestInputStreamManager } from "./test-input-stream-manager.js";
+import { TestRealtimeStreamsManager } from "./test-realtime-streams-manager.js";
+import { TestRunMetadataManager } from "./test-run-metadata-manager.js";
+import { TestSessionStreamManager } from "./test-session-stream-manager.js";
+function defaultTaskRunContext(overrides) {
+    return {
+        task: {
+            id: "test-task",
+            filePath: "test-task.ts",
+            ...overrides?.task,
+        },
+        attempt: {
+            number: 1,
+            startedAt: new Date(),
+            ...overrides?.attempt,
+        },
+        run: {
+            id: "run_test",
+            tags: [],
+            isTest: false,
+            isReplay: false,
+            createdAt: new Date(),
+            startedAt: new Date(),
+            ...overrides?.run,
+        },
+        machine: {
+            name: "micro",
+            cpu: 1,
+            memory: 0.5,
+            centsPerMs: 0,
+            ...overrides?.machine,
+        },
+        queue: {
+            name: "test-queue",
+            id: "test-queue-id",
+            ...overrides?.queue,
+        },
+        environment: {
+            id: "test-env-id",
+            slug: "test-env",
+            type: "DEVELOPMENT",
+            ...overrides?.environment,
+        },
+        organization: {
+            id: "test-org-id",
+            slug: "test-org",
+            name: "Test Org",
+            ...overrides?.organization,
+        },
+        project: {
+            id: "test-project-id",
+            ref: "test-project-ref",
+            slug: "test-project",
+            name: "Test Project",
+            ...overrides?.project,
+        },
+        batch: overrides?.batch,
+    };
+}
+function defaultWorker(overrides) {
+    return {
+        id: "test-worker-id",
+        version: "test-version",
+        contentHash: "test-content-hash",
+        engine: "V2",
+        ...overrides,
+    };
+}
+/**
+ * Run a function inside a fully mocked task runtime context.
+ *
+ * Installs in-memory test managers for `locals`, `inputStreams`,
+ * `realtimeStreams`, `lifecycleHooks`, and `runtime`, sets a mock
+ * `TaskContext`, and tears everything down when the function returns.
+ *
+ * Inside the function, any code that reads from `locals`, `inputStreams`,
+ * `realtimeStreams`, or `taskContext.ctx` will see the mock context —
+ * so you can directly invoke the internal `run` function of any task
+ * (including `chat.agent`) without hitting the Trigger.dev runtime.
+ *
+ * @example
+ * ```ts
+ * import { runInMockTaskContext } from "@trigger.dev/core/v3/test";
+ *
+ * await runInMockTaskContext(
+ *   async ({ inputs, outputs, ctx }) => {
+ *     // Fire an input stream from the "outside"
+ *     setTimeout(() => {
+ *       inputs.send("chat-messages", { messages: [], chatId: "c1" });
+ *     }, 0);
+ *
+ *     // Run task code that reads from inputStreams.once(...)
+ *     await myTask.fns.run(payload, { ctx, signal: new AbortController().signal });
+ *
+ *     // Inspect chunks written to the output stream
+ *     expect(outputs.chunks("chat")).toContainEqual({ type: "text-delta", delta: "hi" });
+ *   },
+ *   { ctx: { run: { id: "run_abc" } } }
+ * );
+ * ```
+ */
+export async function runInMockTaskContext(fn, options) {
+    const ctx = defaultTaskRunContext(options?.ctx);
+    const worker = defaultWorker(options?.worker);
+    const localsManager = new StandardLocalsManager();
+    const lifecycleManager = new StandardLifecycleHooksManager();
+    const runtimeManager = options?.runtimeManager ?? new NoopRuntimeManager();
+    const metadataManager = new TestRunMetadataManager();
+    const inputManager = new TestInputStreamManager();
+    const outputManager = new TestRealtimeStreamsManager();
+    const sessionStreamManager = options?.sessionStreamManager ?? new TestSessionStreamManager();
+    // Unregister any previously-installed managers so `setGlobal*` wins —
+    // `registerGlobal` returns false silently if an entry already exists.
+    unregisterGlobal("locals");
+    unregisterGlobal("lifecycle-hooks");
+    unregisterGlobal("runtime");
+    unregisterGlobal("run-metadata");
+    unregisterGlobal("input-streams");
+    unregisterGlobal("realtime-streams");
+    unregisterGlobal("session-streams");
+    unregisterGlobal("task-context");
+    localsAPI.setGlobalLocalsManager(localsManager);
+    lifecycleHooks.setGlobalLifecycleHooksManager(lifecycleManager);
+    runtime.setGlobalRuntimeManager(runtimeManager);
+    runMetadata.setGlobalManager(metadataManager);
+    inputStreams.setGlobalManager(inputManager);
+    realtimeStreams.setGlobalManager(outputManager);
+    sessionStreams.setGlobalManager(sessionStreamManager);
+    taskContext.setGlobalTaskContext({
+        ctx,
+        worker,
+        isWarmStart: options?.isWarmStart ?? false,
+    });
+    const drivers = {
+        inputs: {
+            send: (streamId, data) => inputManager.__sendFromTest(streamId, data),
+            close: (streamId) => inputManager.__closeFromTest(streamId),
+        },
+        outputs: {
+            chunks: (streamId) => outputManager.__chunksFromTest(streamId),
+            all: () => outputManager.__allChunksFromTest(),
+            clear: (streamId) => outputManager.__clearFromTest(streamId),
+            onWrite: (listener) => outputManager.onWrite(listener),
+        },
+        locals: {
+            get: (key) => localsManager.getLocal(key),
+            set: (key, value) => localsManager.setLocal(key, value),
+        },
+        sessions: {
+            in: {
+                send: (sessionId, data, io = "in") => sessionStreamManager instanceof TestSessionStreamManager
+                    ? sessionStreamManager.__sendFromTest(sessionId, io, data)
+                    : Promise.reject(new Error("drivers.sessions.in.send requires the default TestSessionStreamManager")),
+                close: (sessionId, io = "in") => {
+                    if (sessionStreamManager instanceof TestSessionStreamManager) {
+                        sessionStreamManager.__closeFromTest(sessionId, io);
+                    }
+                },
+            },
+        },
+        ctx,
+    };
+    try {
+        return await fn(drivers);
+    }
+    finally {
+        localsAPI.disable();
+        lifecycleHooks.disable();
+        runtime.disable();
+        // taskContext.disable() only sets a flag — unregister the global so
+        // `taskContext.ctx` returns undefined after the harness returns.
+        unregisterGlobal("task-context");
+        unregisterGlobal("input-streams");
+        unregisterGlobal("realtime-streams");
+        unregisterGlobal("session-streams");
+        unregisterGlobal("run-metadata");
+        localsManager.reset();
+        inputManager.reset();
+        outputManager.reset();
+        if (sessionStreamManager instanceof TestSessionStreamManager) {
+            sessionStreamManager.reset();
+        }
+        metadataManager.reset();
+    }
+}
+//# sourceMappingURL=mock-task-context.js.map

package/dist/esm/v3/test/mock-task-context.js.map

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

package/dist/esm/v3/test/session-waitpoint-backend.d.ts

@@ -0,0 +1,68 @@
+import { ApiClient } from "../apiClient/index.js";
+import { NoopRuntimeManager } from "../runtime/noopRuntimeManager.js";
+import type { CreateSessionStreamWaitpointRequestBody, CreateSessionStreamWaitpointResponseBody } from "../schemas/api.js";
+import type { WaitpointTokenResult } from "../schemas/common.js";
+/**
+ * In-process stand-in for the run-engine's session-stream waitpoint machinery.
+ *
+ * `session.in.wait()` suspends a run on a waitpoint; in production the run-engine
+ * completes that waitpoint (and the supervisor resumes the run) when the next
+ * `.in` record arrives. This backend reproduces the task-observable half in one
+ * process: `register()` mints a waitpoint id when the SDK creates the waitpoint,
+ * and `wait()` opens its own short-lived tail on the session channel and resolves
+ * with the next record. That record is handed back through `TestRuntimeManager`
+ * exactly as the real runtime hands back a completed waitpoint's output, so the
+ * same `run()` invocation continues in place (the faithful dev / deployed
+ * task-observable semantics: same promise, same record, no re-invocation).
+ *
+ * It deliberately does not model server-side waitpoint bookkeeping, process
+ * checkpoint/restore, or client-vs-server timeout, none of which are visible to
+ * task code on the resume path.
+ */
+export declare class SessionWaitpointBackend {
+    private readonly apiClient;
+    private readonly pending;
+    private disabled;
+    constructor(apiClient: ApiClient);
+    register(body: CreateSessionStreamWaitpointRequestBody): CreateSessionStreamWaitpointResponseBody;
+    wait(waitpointFriendlyId: string): Promise<WaitpointTokenResult>;
+    disable(): void;
+    /**
+     * Opens an independent tail on the session channel starting after the
+     * caller's last-seen seq and resolves with the next record. For `.in` the
+     * tail yields the raw appended JSON string (already `JSON.stringify(chunk)`),
+     * which {@link wait} passes straight to the packet parser so it round-trips
+     * to the same object `session.in.once()` returns.
+     */
+    private readNextRecord;
+}
+/**
+ * A {@link NoopRuntimeManager} whose `waitForWaitpoint` resolves in place from a
+ * {@link SessionWaitpointBackend} instead of hanging. Install it as the `runtime`
+ * global via `runInMockTaskContext({ runtimeManager })`.
+ */
+export declare class TestRuntimeManager extends NoopRuntimeManager {
+    private readonly backend;
+    constructor(backend: SessionWaitpointBackend);
+    waitForWaitpoint(params: {
+        waitpointFriendlyId: string;
+        finishDate?: Date;
+    }): Promise<WaitpointTokenResult>;
+}
+/**
+ * Route the two waitpoint apiClient calls through an in-process backend for the
+ * duration of a harness run, and hand back a {@link TestRuntimeManager} to
+ * install as the `runtime` global.
+ *
+ * `apiClientManager.clientOrThrow()` builds a fresh `ApiClient` per call, so
+ * there is no instance to swap; the two methods are patched on the prototype
+ * (ref-counted, restored by `restore()`). `createSessionStreamWaitpoint`
+ * registers a pending wait and returns a real-shaped `{ waitpointId, isCached }`;
+ * `waitForWaitpointToken` returns `{ success: true }` exactly like the real route,
+ * which only creates the block edge and returns synchronously.
+ */
+export declare function installSessionWaitpointBackend(apiClient: ApiClient): {
+    backend: SessionWaitpointBackend;
+    runtimeManager: TestRuntimeManager;
+    restore: () => void;
+};