@trigger.dev/sdk 4.7.3 → 4.8.0-webhooks.20261015065339

package/dist/esm/v3/modelFileDownload.js

@@ -0,0 +1,161 @@
+const MAX_MODEL_FILE_BYTES = 100 * 1024 * 1024;
+const MAX_REDIRECTS = 5;
+/**
+ * Fetches a file for the model from a URL no channel connector owns, with the AI SDK default
+ * downloader's protections: only http(s) URLs on public hosts (each redirect is checked too), and a
+ * size cap.
+ */
+export async function fetchPublicFile(url, maxBytes = MAX_MODEL_FILE_BYTES) {
+    let current = url;
+    for (let redirects = 0;; redirects++) {
+        assertPublicUrl(current);
+        const res = await fetch(current, { redirect: "manual" });
+        const location = res.headers.get("location");
+        if (res.status >= 300 && res.status < 400 && location) {
+            await res.body?.cancel();
+            if (redirects >= MAX_REDIRECTS) {
+                throw new Error(`Failed to download ${url.href}: too many redirects`);
+            }
+            current = new URL(location, current);
+            continue;
+        }
+        if (!res.ok) {
+            throw new Error(`Failed to download ${current.href}: ${res.status} ${res.statusText}`);
+        }
+        return {
+            data: await readWithLimit(res, current, maxBytes),
+            mediaType: res.headers.get("content-type") ?? undefined,
+        };
+    }
+}
+async function readWithLimit(res, url, maxBytes) {
+    const declared = Number(res.headers.get("content-length") ?? 0);
+    if (declared > maxBytes) {
+        await res.body?.cancel();
+        throw new Error(`Failed to download ${url.href}: larger than ${maxBytes} bytes`);
+    }
+    if (!res.body)
+        return new Uint8Array(await res.arrayBuffer());
+    const reader = res.body.getReader();
+    const chunks = [];
+    let total = 0;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        total += value.byteLength;
+        if (total > maxBytes) {
+            await reader.cancel();
+            throw new Error(`Failed to download ${url.href}: larger than ${maxBytes} bytes`);
+        }
+        chunks.push(value);
+    }
+    const data = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        data.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return data;
+}
+function assertPublicUrl(url) {
+    if (url.protocol !== "http:" && url.protocol !== "https:") {
+        throw new Error(`Refusing to download ${url.href}: only http and https URLs are fetched`);
+    }
+    const hostname = url.hostname.toLowerCase().replace(/\.+$/, "");
+    const ipv6 = hostname.startsWith("[") && hostname.endsWith("]") ? hostname.slice(1, -1) : undefined;
+    const internal = !hostname ||
+        hostname === "localhost" ||
+        hostname.endsWith(".localhost") ||
+        hostname.endsWith(".local") ||
+        (ipv6 !== undefined ? isInternalIPv6(ipv6) : isIPv4(hostname) && isInternalIPv4(hostname));
+    if (internal) {
+        throw new Error(`Refusing to download ${url.href}: the host is not a public address`);
+    }
+}
+function isIPv4(host) {
+    const parts = host.split(".");
+    return (parts.length === 4 &&
+        parts.every((part) => {
+            const n = Number(part);
+            return Number.isInteger(n) && n >= 0 && n <= 255 && String(n) === part;
+        }));
+}
+function isInternalIPv4(ip) {
+    const [a = 0, b = 0, c = 0] = ip.split(".").map(Number);
+    return (a === 0 ||
+        a === 10 ||
+        (a === 100 && b >= 64 && b <= 127) ||
+        a === 127 ||
+        (a === 169 && b === 254) ||
+        (a === 172 && b >= 16 && b <= 31) ||
+        (a === 192 && b === 0 && c === 0) ||
+        (a === 192 && b === 168) ||
+        (a === 198 && (b === 18 || b === 19)) ||
+        a >= 240);
+}
+function parseIPv6(ip) {
+    const address = ip.toLowerCase().split("%")[0];
+    const halves = address.split("::");
+    if (halves.length > 2)
+        return null;
+    const toGroups = (segment) => {
+        if (segment === "")
+            return [];
+        const groups = [];
+        const parts = segment.split(":");
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i];
+            if (part.includes(".")) {
+                if (i !== parts.length - 1 || !isIPv4(part))
+                    return null;
+                const [a = 0, b = 0, c = 0, d = 0] = part.split(".").map(Number);
+                groups.push((a << 8) | b, (c << 8) | d);
+                continue;
+            }
+            if (!/^[0-9a-f]{1,4}$/.test(part))
+                return null;
+            groups.push(parseInt(part, 16));
+        }
+        return groups;
+    };
+    const head = toGroups(halves[0]);
+    if (head === null)
+        return null;
+    if (halves.length === 1)
+        return head.length === 8 ? head : null;
+    const tail = toGroups(halves[1]);
+    if (tail === null)
+        return null;
+    const fill = 8 - head.length - tail.length;
+    if (fill < 0)
+        return null;
+    return [...head, ...new Array(fill).fill(0), ...tail];
+}
+function isInternalIPv6(ip) {
+    const g = parseIPv6(ip);
+    if (g === null)
+        return true;
+    const zero = (count) => g.slice(0, count).every((group) => group === 0);
+    if (zero(7) && (g[7] === 0 || g[7] === 1))
+        return true;
+    const first = g[0];
+    if ((first & 0xfe00) === 0xfc00)
+        return true;
+    if ((first & 0xffc0) === 0xfe80)
+        return true;
+    if ((first & 0xffc0) === 0xfec0)
+        return true;
+    if ((first & 0xff00) === 0xff00)
+        return true;
+    const embedsIPv4 = zero(6) ||
+        (zero(5) && g[5] === 0xffff) ||
+        (zero(4) && g[4] === 0xffff && g[5] === 0) ||
+        (first === 0x64 && g[1] === 0xff9b && g[2] === 0 && g[3] === 0 && g[4] === 0 && g[5] === 0) ||
+        (first === 0x64 && g[1] === 0xff9b && g[2] === 1);
+    if (!embedsIPv4)
+        return false;
+    const v4 = [g[6] >> 8, g[6] & 0xff, g[7] >> 8, g[7] & 0xff].join(".");
+    return isInternalIPv4(v4);
+}
+//# sourceMappingURL=modelFileDownload.js.map

package/dist/esm/v3/modelFileDownload.js.map

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

package/dist/esm/v3/runs.d.ts

@@ -1,4 +1,4 @@
-import type { AnyRetrieveRunResult, AnyRunShape, ApiRequestOptions, CreateBulkCancelActionOptions, CreateBulkReplayActionOptions, InferRunTypes, ListBulkActionsQueryParams, ListProjectRunsQueryParams, ListRunsQueryParams, RescheduleRunRequestBody, RetrieveRunResult, RunShape, RealtimeRun, AnyRealtimeRun, RunSubscription, TaskRunShape, AnyBatchedRunHandle, AsyncIterableStream, ApiPromise, RealtimeRunSkipColumns, AbortBulkActionResponseBody, BulkActionObject, CanceledRunResponse, CreateBulkActionResponseBody, CursorPagePromise, ListRunResponseItem, ReplayRunResponse, RetrieveRunResponse } from "@trigger.dev/core/v3";
+import type { AnyRetrieveRunResult, AnyRunShape, ApiRequestOptions, CreateBulkCancelActionOptions, CreateBulkReplayActionOptions, InferRunTypes, ListBulkActionsQueryParams, ListProjectRunsQueryParams, ListRunsQueryParams, RescheduleRunRequestBody, RetrieveRunResult, RunShape, RealtimeRun, AnyRealtimeRun, RunSubscription, TaskRunShape, AnyBatchedRunHandle, AsyncIterableStream, ApiPromise, RealtimeRunSkipColumns, AbortBulkActionResponseBody, BulkActionObject, CanceledRunResponse, CreateBulkActionResponseBody, CursorPagePromise, IdempotencyKey, ListRunResponseItem, ReplayRunResponse, RetrieveRunResponse, TriggerOptions } from "@trigger.dev/core/v3";
 import type { AnyRunHandle, AnyTask } from "./shared.js";
 export type { AnyRetrieveRunResult, AnyRunShape, RetrieveRunResult, RunShape, TaskRunShape, RealtimeRun, AnyRealtimeRun, };
 export declare const runs: {
@@ -26,6 +26,27 @@ declare function listRuns(projectRef: string, params?: ListProjectRunsQueryParam
 declare function listRuns(params?: ListRunsQueryParams, requestOptions?: ApiRequestOptions): CursorPagePromise<typeof ListRunResponseItem>;
 type RunId<TRunId> = TRunId extends AnyRunHandle | AnyBatchedRunHandle ? TRunId : TRunId extends AnyTask ? string : TRunId extends string ? TRunId : never;
 declare function retrieveRun<TRunId extends AnyRunHandle | AnyBatchedRunHandle | AnyTask | string>(runId: RunId<TRunId>, requestOptions?: ApiRequestOptions): ApiPromise<RetrieveRunResult<TRunId>>;
+export type ReplayRunOptions = Pick<TriggerOptions, "metadata" | "tags" | "queue" | "concurrencyKey" | "machine" | "version" | "region" | "delay" | "ttl" | "idempotencyKeyTTL" | "maxAttempts" | "maxDuration" | "priority"> & {
+    /**
+     * The payload for the new run. Omit it to reuse the original run's payload.
+     */
+    payload?: unknown;
+    /**
+     * An idempotency key for the new run. A plain string is used as-is: unlike `trigger()`, it is
+     * not scoped to the current run. Use `idempotencyKeys.create()` for a scoped key.
+     */
+    idempotencyKey?: IdempotencyKey | string;
+};
+/**
+ * Replays a run: creates a new run of the same task from the original run's payload and options.
+ * Pass `options` to override any of them for the new run.
+ *
+ * @example
+ * ```ts
+ * const { id } = await runs.replay("run_1234", { payload: { userId: "123" }, delay: "1h" });
+ * ```
+ */
+declare function replayRun(runId: string, options?: ReplayRunOptions, requestOptions?: ApiRequestOptions): ApiPromise<ReplayRunResponse>;
 declare function replayRun(runId: string, requestOptions?: ApiRequestOptions): ApiPromise<ReplayRunResponse>;
 declare function cancelRun(runId: string, requestOptions?: ApiRequestOptions): ApiPromise<CanceledRunResponse>;
 declare function bulkCancelRuns(options: CreateBulkCancelActionOptions, requestOptions?: ApiRequestOptions): ApiPromise<CreateBulkActionResponseBody>;

package/dist/esm/v3/runs.js

@@ -126,8 +126,11 @@ async function resolvePayloadAndOutputUrls(run) {
     }
     return resolvedRun;
 }
-function replayRun(runId, requestOptions) {
+function replayRun(runId, optionsOrRequestOptions, requestOptions) {
     const apiClient = apiClientManager.clientOrThrow();
+    const options = isRequestOptions(optionsOrRequestOptions)
+        ? undefined
+        : optionsOrRequestOptions;
     const $requestOptions = mergeRequestOptions({
         tracer,
         name: "runs.replay()",
@@ -144,8 +147,8 @@ function replayRun(runId, requestOptions) {
                 style: "codepath",
             }),
         },
-    }, requestOptions);
-    return apiClient.replayRun(runId, $requestOptions);
+    }, isRequestOptions(optionsOrRequestOptions) ? optionsOrRequestOptions : requestOptions);
+    return apiClient.replayRun(runId, options, $requestOptions);
 }
 function cancelRun(runId, requestOptions) {
     const apiClient = apiClientManager.clientOrThrow();

package/dist/esm/v3/runs.js.map

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

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

@@ -1,4 +1,5 @@
 import "./setup-catalog.js";
-export { mockChatAgent, type MockChatAgentOptions, type MockChatAgentHarness, type MockChatAgentTurn, } from "./mock-chat-agent.js";
+export { mockChatAgent, DEFAULT_TEST_CONNECTOR_ID, type MockChatAgentOptions, type MockChatAgentHarness, type MockChatAgentTurn, type SeededChannelDelivery, } from "./mock-chat-agent.js";
 export { runTranscriptStorageTests, type TranscriptStorageTestOptions, } from "./transcript-storage-tests.js";
+export { recordingChannelConnector, type RecordingChannelConnector, type RecordingChannelConnectorOptions, type RecordedSend, type RecordedReaction, type RecordedFinalize, type RecordedLifecycle, type RecordedReplyStream, type RecordedCancel, type TestChannelEvent, type TestChannelHandle, } from "./mock-channel-connector.js";
 export { runInMockTaskContext, type MockTaskContextDrivers, type MockTaskContextOptions, } from "@trigger.dev/core/v3/test";

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

@@ -5,8 +5,9 @@
 // Users should import `@trigger.dev/sdk/ai/test` BEFORE their agent
 // modules so the registration side-effect runs first.
 import "./setup-catalog.js";
-export { mockChatAgent, } from "./mock-chat-agent.js";
+export { mockChatAgent, DEFAULT_TEST_CONNECTOR_ID, } from "./mock-chat-agent.js";
 export { runTranscriptStorageTests, } from "./transcript-storage-tests.js";
+export { recordingChannelConnector, } from "./mock-channel-connector.js";
 // Re-export the lower-level task context harness so consumers can build
 // their own test helpers without adding a separate `@trigger.dev/core`
 // dependency to their reference projects.

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/test/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oEAAoE;AACpE,kDAAkD;AAClD,EAAE;AACF,oEAAoE;AACpE,sDAAsD;AACtD,OAAO,oBAAoB,CAAC;AAE5B,OAAO,EACL,aAAa,GAId,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,yBAAyB,GAE1B,MAAM,+BAA+B,CAAC;AAEvC,wEAAwE;AACxE,uEAAuE;AACvE,0CAA0C;AAC1C,OAAO,EACL,oBAAoB,GAGrB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/test/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,oEAAoE;AACpE,kDAAkD;AAClD,EAAE;AACF,oEAAoE;AACpE,sDAAsD;AACtD,OAAO,oBAAoB,CAAC;AAE5B,OAAO,EACL,aAAa,EACb,yBAAyB,GAK1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,yBAAyB,GAE1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,yBAAyB,GAW1B,MAAM,6BAA6B,CAAC;AAErC,wEAAwE;AACxE,uEAAuE;AACvE,0CAA0C;AAC1C,OAAO,EACL,oBAAoB,GAGrB,MAAM,2BAA2B,CAAC"}

package/dist/esm/v3/test/mock-channel-connector.d.ts

@@ -0,0 +1,172 @@
+import type { ChannelAckCtx, ChannelCancelledToolCall, ChannelDownloadedFile, ChannelConnector, ChannelControl, ChannelInbound, ChannelInteractionCtx, ChannelInteractionResolution, ChannelLifecycleCtx, ChannelLifecycleState, ChannelMessage, ChannelPendingToolCall, ChannelProgressEvent, ChannelReaction, ChannelReactions, ChannelReply, ChannelReplyStreamEnd, ChannelSeedMessage, ChannelSendCtx, ChannelTurnCtx } from "../ai.js";
+/** The default event shape {@link recordingChannelConnector} maps when no `inbound` is given. */
+export type TestChannelEvent = {
+    text: string;
+    threadId?: string;
+    userId?: string;
+};
+/** The posting handle the default `bind` derives: the event's `threadId`. */
+export type TestChannelHandle = {
+    threadId: string;
+};
+/** A single `send()` call captured by {@link recordingChannelConnector}. */
+export type RecordedSend<TEvent = unknown> = {
+    /** The channel message the connector was asked to post (or edit into place). */
+    message: ChannelMessage;
+    /** The egress context: `final`, `mode`, `previousRef`, the raw `event`, `deliveryId`. */
+    ctx: ChannelSendCtx<TEvent>;
+    /** The ref this send resolved to (echoes `previousRef` on an edit, else a fresh id). */
+    ref: string;
+};
+/** A reaction applied to the triggering message, captured by {@link recordingChannelConnector}. */
+export type RecordedReaction<TEvent = unknown> = {
+    reaction: ChannelReaction;
+    event: TEvent;
+};
+/** A `progress()` call, captured by {@link recordingChannelConnector}. */
+type RecordedProgress<TEvent = unknown> = {
+    event: ChannelProgressEvent;
+    ctx: ChannelTurnCtx<TEvent>;
+};
+/** A `lifecycle()` report, captured by {@link recordingChannelConnector}. */
+export type RecordedLifecycle<TEvent = unknown> = {
+    state: ChannelLifecycleState;
+    ctx: ChannelLifecycleCtx<TEvent>;
+};
+/** One turn's native reply stream (`stream: true`), captured by {@link recordingChannelConnector}. */
+export type RecordedReplyStream<TEvent = unknown> = {
+    ctx: ChannelTurnCtx<TEvent>;
+    /** Every text delta, in order. */
+    deltas: string[];
+    progress: ChannelProgressEvent[];
+    /** How the runtime ended the stream; unset while the turn runs. */
+    ended?: ChannelReplyStreamEnd;
+    /** How many times `end()` was called (the runtime ends each stream once). */
+    endCalls: number;
+};
+/** A HITL `cancelInteraction()` call, captured by {@link recordingChannelConnector}. */
+export type RecordedCancel<TEvent = unknown> = {
+    cancelled: ChannelCancelledToolCall[];
+    ctx: ChannelTurnCtx<TEvent>;
+};
+/** A HITL `finalizeInteraction()` call, captured by {@link recordingChannelConnector}. */
+export type RecordedFinalize<TEvent = unknown> = {
+    event: TEvent;
+    resolution: ChannelInteractionResolution;
+};
+/**
+ * A real {@link ChannelConnector} whose egress hooks record what they were
+ * asked to do instead of touching a network, so a test can assert the channel
+ * round-trip a `chat.agent` turn produced. Built through the real
+ * `chat.channels.custom` factory, so it is a genuinely-shaped connector; only
+ * `send` / `ack` / `react` / `finalizeInteraction` are swapped for recorders.
+ */
+export type RecordingChannelConnector<TEvent = unknown> = ChannelConnector<TEvent> & {
+    /** Every `send()` call in order: the ack, any stream edits, and the final reply. */
+    readonly sent: ReadonlyArray<RecordedSend<TEvent>>;
+    /** Turn-start placeholder posts ("final" delivery): `final: false`, no `previousRef`. */
+    readonly acks: ReadonlyArray<RecordedSend<TEvent>>;
+    /** Stream-mode intermediate edits: `mode: "stream"`, `final: false`, with `previousRef`. */
+    readonly edits: ReadonlyArray<RecordedSend<TEvent>>;
+    /** Every reaction applied to the triggering message (lifecycle + `run().channel`). */
+    readonly reactionsApplied: ReadonlyArray<RecordedReaction<TEvent>>;
+    /** Every HITL `finalizeInteraction()` call. */
+    readonly finalized: ReadonlyArray<RecordedFinalize<TEvent>>;
+    /** Every `seed()` call's triggering event, in order. */
+    readonly seeded: ReadonlyArray<TEvent>;
+    /** Every `progress()` call (tool calls and results the turn streamed), in order. */
+    readonly progressed: ReadonlyArray<RecordedProgress<TEvent>>;
+    /** Every `lifecycle()` report, in order (`lifecycle: true`). */
+    readonly lifecycles: ReadonlyArray<RecordedLifecycle<TEvent>>;
+    /** Every native reply stream the runtime opened, one per turn (`stream: true`). */
+    readonly streams: ReadonlyArray<RecordedReplyStream<TEvent>>;
+    /** Every `cancelInteraction()` call. */
+    readonly cancelled: ReadonlyArray<RecordedCancel<TEvent>>;
+    /** Every `endInterruptedStream()` call: the ref of a stream a dead worker left open. */
+    readonly interrupted: ReadonlyArray<{
+        ref: string;
+        ctx: ChannelTurnCtx<TEvent>;
+    }>;
+    /** The ref of the most recent `send()`, i.e. the current edit target. */
+    readonly lastRef: string | undefined;
+    /** Text of the final reply (`final: true`), or `undefined` if none posted yet. */
+    finalText(): string | undefined;
+};
+/** Options for {@link recordingChannelConnector}. */
+export type RecordingChannelConnectorOptions<TEvent = TestChannelEvent> = {
+    /** Connector id. Defaults to {@link DEFAULT_TEST_CONNECTOR_ID} so it lines up with `sendChannelEvent`. */
+    id?: string;
+    /** The endpoint id the connector subscribes to. Server-side routing only; defaults to `"test-channel"`. */
+    endpointId?: string;
+    /** `"final"` (default: ack then edit-to-answer) or `"stream"` (debounced live edits). */
+    delivery?: "final" | "stream";
+    /** Session key template. Unused in-run (server-side routing only); defaults to `"{event.threadId}"`. */
+    key?: string;
+    /** Map the raw event to the turn's message. Defaults to `event.text`, attributed to `event.userId`. */
+    inbound?: (event: TEvent) => ChannelInbound;
+    /** Map the reply to the posted message. Defaults to `{ text }`; receives the full {@link ChannelReply}. */
+    outbound?: (reply: ChannelReply) => ChannelMessage | null;
+    /**
+     * Derive the session's posting handle from an event, so turns that no channel delivery started
+     * (an action turn, a browser message) still egress through this connector with `ctx.handle` and
+     * `ctx.bound: true`. Defaults to `{ threadId: event.threadId }`; pass `null` to make the
+     * connector unbindable.
+     */
+    bind?: ((event: TEvent) => unknown | null) | null;
+    /** Prior surface messages to seed a new session with (what `seed()` returns). Recorded per call. */
+    seed?: (event: TEvent) => Promise<ChannelSeedMessage[]> | ChannelSeedMessage[];
+    /**
+     * Placeholder posted at turn start ("final" delivery). Defaults to `{ text: "..." }`.
+     * Pass `null` (or a function returning `null`) to post no ack, so the final reply
+     * arrives as a fresh message instead of an edit.
+     */
+    ack?: ChannelMessage | null | ((event: TEvent, ctx: ChannelAckCtx) => ChannelMessage | null);
+    /** HITL: map a verified callback event to a tool resolution (null => treat as a normal message). */
+    onInteraction?: (event: TEvent) => ChannelInteractionResolution | null;
+    /** Fetch a file URL the connector owns for the model; null for URLs it does not own. */
+    download?: (url: URL, ctx: {
+        handle?: unknown;
+    }) => Promise<ChannelDownloadedFile | null>;
+    /** Map a click on an agent-posted control to an action for `onAction` (null for anything else). */
+    toAction?: (event: TEvent) => unknown | null;
+    /** Acknowledge a message that arrives while a turn is running. */
+    received?: (ctx: ChannelTurnCtx<TEvent>) => Promise<void> | void;
+    /** HITL: map the pending tool call(s) to the controls posted in the thread. */
+    renderInteraction?: (pending: ChannelPendingToolCall[], ctx: ChannelInteractionCtx<TEvent>) => ChannelMessage | null;
+    /** Lifecycle reaction choices (working/done/error). Requires nothing extra; `react` is always recorded. */
+    reactions?: ChannelReactions<TEvent>;
+    /** Record tool-call progress (`progress()` hook). Off by default so existing turns post nothing extra. */
+    progress?: boolean;
+    /** Provider helpers merged into `run({ channel })`. */
+    surface?: (ctx: ChannelTurnCtx<TEvent>) => Record<string, unknown>;
+    /** Map an event to a control (`{ kind: "stop" }`) while a turn runs. */
+    onControl?: (event: TEvent) => ChannelControl | null;
+    /** Record `lifecycle()` reports. Off by default. */
+    lifecycle?: boolean;
+    /**
+     * Stream replies natively (`delivery: "stream"` with a recording `stream()` hook): each turn's
+     * deltas and end outcome land in `streams`, the stream reports `opened("stream_<n>")` on its
+     * first delta, and it reports delivered when it saw text. `{ delivered: false }` reports every
+     * stream undelivered, like a Slack stream whose fallback post of the rest of the reply failed.
+     */
+    stream?: boolean | {
+        delivered: false;
+    };
+};
+/**
+ * Create a {@link RecordingChannelConnector} for driving a `chat.agent`
+ * channel turn offline. Pair it with `mockChatAgent(...).sendChannelEvent(...)`:
+ * list the connector on the agent's `channels`, deliver an event, then assert
+ * against `connector.sent` / `.acks` / `.edits` / `.finalText()`.
+ *
+ * @example
+ * ```ts
+ * const channel = recordingChannelConnector();
+ * const agent = chat.agent({ id: "support", channels: [channel], run: ... });
+ * const harness = mockChatAgent(agent);
+ * await harness.sendChannelEvent({ event: { text: "hi", threadId: "t1" } });
+ * expect(channel.finalText()).toBe("hello");
+ * ```
+ */
+export declare function recordingChannelConnector<TEvent = TestChannelEvent>(options?: RecordingChannelConnectorOptions<TEvent>): RecordingChannelConnector<TEvent>;
+export {};

package/dist/esm/v3/test/mock-channel-connector.js

@@ -0,0 +1,170 @@
+import { chat } from "../ai.js";
+import { DEFAULT_TEST_CONNECTOR_ID } from "./mock-chat-agent.js";
+const DEFAULT_TEST_ENDPOINT_ID = "test-channel";
+/**
+ * Create a {@link RecordingChannelConnector} for driving a `chat.agent`
+ * channel turn offline. Pair it with `mockChatAgent(...).sendChannelEvent(...)`:
+ * list the connector on the agent's `channels`, deliver an event, then assert
+ * against `connector.sent` / `.acks` / `.edits` / `.finalText()`.
+ *
+ * @example
+ * ```ts
+ * const channel = recordingChannelConnector();
+ * const agent = chat.agent({ id: "support", channels: [channel], run: ... });
+ * const harness = mockChatAgent(agent);
+ * await harness.sendChannelEvent({ event: { text: "hi", threadId: "t1" } });
+ * expect(channel.finalText()).toBe("hello");
+ * ```
+ */
+export function recordingChannelConnector(options = {}) {
+    const sent = [];
+    const reactionsApplied = [];
+    const finalized = [];
+    const seeded = [];
+    const progressed = [];
+    const lifecycles = [];
+    const streams = [];
+    const cancelled = [];
+    const interrupted = [];
+    let refCounter = 0;
+    let lastRef;
+    const inbound = options.inbound ??
+        ((event) => {
+            const e = event;
+            return { message: e?.text ?? "", externalUserId: e?.userId };
+        });
+    const bind = options.bind === null
+        ? undefined
+        : (options.bind ??
+            ((event) => {
+                const threadId = event?.threadId;
+                return threadId ? { threadId } : null;
+            }));
+    const ackFn = options.ack === undefined
+        ? () => ({ text: "..." })
+        : typeof options.ack === "function"
+            ? options.ack
+            : () => options.ack;
+    const send = async (message, ctx) => {
+        const ref = ctx.previousRef ?? `ref_${++refCounter}`;
+        sent.push({ message, ctx, ref });
+        lastRef = ref;
+        return { ref };
+    };
+    const react = async (reaction, ctx) => {
+        reactionsApplied.push({ reaction, event: ctx.event });
+    };
+    const finalizeInteraction = async (event, resolution) => {
+        finalized.push({ event, resolution });
+    };
+    const connector = chat.channels.custom({
+        id: options.id ?? DEFAULT_TEST_CONNECTOR_ID,
+        endpoint: {
+            id: options.endpointId ?? DEFAULT_TEST_ENDPOINT_ID,
+            source: "custom",
+        },
+        key: (options.key ?? "{event.threadId}"),
+        inbound: inbound,
+        ...(bind ? { bind: bind } : {}),
+        ...(options.seed
+            ? {
+                seed: (async (event) => {
+                    seeded.push(event);
+                    return options.seed(event);
+                }),
+            }
+            : {}),
+        ack: ackFn,
+        ...(options.outbound ? { outbound: options.outbound } : {}),
+        send: send,
+        react: react,
+        finalizeInteraction: finalizeInteraction,
+        ...(options.onInteraction ? { onInteraction: options.onInteraction } : {}),
+        ...(options.download ? { download: options.download } : {}),
+        ...(options.toAction ? { toAction: options.toAction } : {}),
+        ...(options.received ? { received: options.received } : {}),
+        ...(options.renderInteraction ? { renderInteraction: options.renderInteraction } : {}),
+        ...(options.reactions ? { reactions: options.reactions } : {}),
+        ...(options.progress
+            ? {
+                progress: ((event, ctx) => {
+                    progressed.push({ event, ctx });
+                }),
+            }
+            : {}),
+        ...(options.surface ? { surface: options.surface } : {}),
+        ...(options.onControl ? { onControl: options.onControl } : {}),
+        ...(options.lifecycle
+            ? {
+                lifecycle: ((state, ctx) => {
+                    lifecycles.push({ state, ctx });
+                }),
+            }
+            : {}),
+        ...(options.stream
+            ? {
+                stream: ((ctx) => {
+                    const recorded = {
+                        ctx,
+                        deltas: [],
+                        progress: [],
+                        endCalls: 0,
+                    };
+                    streams.push(recorded);
+                    return {
+                        text: (delta) => {
+                            if (recorded.deltas.length === 0)
+                                ctx.opened(`stream_${streams.length}`);
+                            recorded.deltas.push(delta);
+                        },
+                        progress: (event) => {
+                            recorded.progress.push(event);
+                        },
+                        end: async (outcome) => {
+                            recorded.endCalls += 1;
+                            recorded.ended = outcome;
+                            const undelivered = typeof options.stream === "object" && options.stream.delivered === false;
+                            return { delivered: !undelivered && recorded.deltas.join("").length > 0 };
+                        },
+                    };
+                }),
+            }
+            : {}),
+        endInterruptedStream: ((ref, ctx) => {
+            interrupted.push({ ref, ctx });
+        }),
+        cancelInteraction: ((cancelledCalls, ctx) => {
+            cancelled.push({ cancelled: cancelledCalls, ctx });
+        }),
+        delivery: options.delivery ?? (options.stream ? "stream" : "final"),
+    });
+    Object.defineProperties(connector, {
+        sent: { get: () => sent, enumerable: true },
+        reactionsApplied: { get: () => reactionsApplied, enumerable: true },
+        finalized: { get: () => finalized, enumerable: true },
+        seeded: { get: () => seeded, enumerable: true },
+        progressed: { get: () => progressed, enumerable: true },
+        lifecycles: { get: () => lifecycles, enumerable: true },
+        streams: { get: () => streams, enumerable: true },
+        cancelled: { get: () => cancelled, enumerable: true },
+        interrupted: { get: () => interrupted, enumerable: true },
+        lastRef: { get: () => lastRef, enumerable: true },
+        acks: {
+            get: () => sent.filter((s) => s.ctx.final === false && s.ctx.previousRef === undefined),
+            enumerable: true,
+        },
+        edits: {
+            get: () => sent.filter((s) => s.ctx.mode === "stream" && s.ctx.final === false && s.ctx.previousRef !== undefined),
+            enumerable: true,
+        },
+    });
+    connector.finalText = () => {
+        for (let i = sent.length - 1; i >= 0; i--) {
+            if (sent[i].ctx.final)
+                return sent[i].message.text;
+        }
+        return undefined;
+    };
+    return connector;
+}
+//# sourceMappingURL=mock-channel-connector.js.map