@trigger.dev/sdk 4.5.0-rc.0 → 4.5.0-rc.2

package/dist/commonjs/v3/triggerClient.test.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const v3_1 = require("@trigger.dev/core/v3");
+const auth_js_1 = require("./auth.js");
+const runs_js_1 = require("./runs.js");
+const triggerClient_js_1 = require("./triggerClient.js");
+function installFetchSpy() {
+    const captured = [];
+    const originalFetch = globalThis.fetch;
+    globalThis.fetch = (async (input, init) => {
+        const url = typeof input === "string" ? input : input?.url ?? String(input);
+        const headers = new Headers(init?.headers);
+        captured.push({
+            url,
+            authorization: headers.get("authorization") ?? undefined,
+            branch: headers.get("x-trigger-branch") ?? undefined,
+        });
+        // Return a fake successful response shaped like an empty run retrieval.
+        return new Response(JSON.stringify({}), {
+            status: 200,
+            headers: { "content-type": "application/json" },
+        });
+    });
+    return {
+        captured,
+        restore: () => {
+            globalThis.fetch = originalFetch;
+        },
+    };
+}
+(0, vitest_1.describe)("TriggerClient", () => {
+    let fetchSpy;
+    (0, vitest_1.beforeEach)(() => {
+        v3_1.apiClientManager.disable();
+        fetchSpy = installFetchSpy();
+    });
+    (0, vitest_1.afterEach)(() => {
+        fetchSpy.restore();
+        v3_1.apiClientManager.disable();
+        v3_1.taskContext.disable();
+        vitest_1.vi.unstubAllEnvs();
+    });
+    (0, vitest_1.it)("throws on first API call when no accessToken is configured anywhere", () => {
+        const client = new triggerClient_js_1.TriggerClient();
+        (0, vitest_1.expect)(() => client.runs.list({ limit: 1 })).toThrow(/TRIGGER_SECRET_KEY/);
+    });
+    (0, vitest_1.it)("falls back to env vars when constructor config is empty", async () => {
+        vitest_1.vi.stubEnv("TRIGGER_SECRET_KEY", "tr_dev_env_token");
+        vitest_1.vi.stubEnv("TRIGGER_PREVIEW_BRANCH", "env-branch");
+        const client = new triggerClient_js_1.TriggerClient();
+        await client.runs.retrieve("run_abc").catch(() => undefined);
+        (0, vitest_1.expect)(fetchSpy.captured).toHaveLength(1);
+        (0, vitest_1.expect)(fetchSpy.captured[0].authorization).toBe("Bearer tr_dev_env_token");
+        (0, vitest_1.expect)(fetchSpy.captured[0].branch).toBe("env-branch");
+    });
+    (0, vitest_1.it)("uses the instance accessToken and previewBranch on outgoing requests", async () => {
+        const client = new triggerClient_js_1.TriggerClient({
+            accessToken: "tr_preview_instance_token",
+            previewBranch: "signup-flow",
+        });
+        await client.runs.retrieve("run_abc").catch(() => undefined);
+        (0, vitest_1.expect)(fetchSpy.captured).toHaveLength(1);
+        const req = fetchSpy.captured[0];
+        (0, vitest_1.expect)(req.authorization).toBe("Bearer tr_preview_instance_token");
+        (0, vitest_1.expect)(req.branch).toBe("signup-flow");
+    });
+    (0, vitest_1.it)("fills missing fields from env, but explicit constructor values still win", async () => {
+        vitest_1.vi.stubEnv("TRIGGER_SECRET_KEY", "tr_env_token");
+        vitest_1.vi.stubEnv("TRIGGER_PREVIEW_BRANCH", "env-branch");
+        vitest_1.vi.stubEnv("TRIGGER_API_URL", "https://env.example.com");
+        const explicit = new triggerClient_js_1.TriggerClient({
+            accessToken: "tr_explicit",
+            previewBranch: "explicit-branch",
+        });
+        const fromEnv = new triggerClient_js_1.TriggerClient();
+        await Promise.all([
+            explicit.runs.retrieve("run_a").catch(() => undefined),
+            fromEnv.runs.retrieve("run_b").catch(() => undefined),
+        ]);
+        const byRun = Object.fromEntries(fetchSpy.captured.map((r) => [r.url.split("/runs/")[1]?.split(/[/?]/)[0], r]));
+        (0, vitest_1.expect)(byRun["run_a"].authorization).toBe("Bearer tr_explicit");
+        (0, vitest_1.expect)(byRun["run_a"].branch).toBe("explicit-branch");
+        (0, vitest_1.expect)(byRun["run_b"].authorization).toBe("Bearer tr_env_token");
+        (0, vitest_1.expect)(byRun["run_b"].branch).toBe("env-branch");
+        (0, vitest_1.expect)(byRun["run_a"].url.startsWith("https://env.example.com/")).toBe(true);
+    });
+    (0, vitest_1.it)("does not leak instance config to the global apiClientManager", async () => {
+        (0, auth_js_1.configure)({ accessToken: "tr_dev_global_token" });
+        const client = new triggerClient_js_1.TriggerClient({
+            accessToken: "tr_preview_instance_token",
+            previewBranch: "signup-flow",
+        });
+        await client.runs.retrieve("run_instance").catch(() => undefined);
+        await runs_js_1.runs.retrieve("run_global").catch(() => undefined);
+        (0, vitest_1.expect)(fetchSpy.captured).toHaveLength(2);
+        (0, vitest_1.expect)(fetchSpy.captured[0].authorization).toBe("Bearer tr_preview_instance_token");
+        (0, vitest_1.expect)(fetchSpy.captured[0].branch).toBe("signup-flow");
+        (0, vitest_1.expect)(fetchSpy.captured[1].authorization).toBe("Bearer tr_dev_global_token");
+        (0, vitest_1.expect)(fetchSpy.captured[1].branch).toBeUndefined();
+    });
+    (0, vitest_1.it)("keeps two concurrent instances isolated from each other", async () => {
+        const prod = new triggerClient_js_1.TriggerClient({ accessToken: "tr_prod_key" });
+        const preview = new triggerClient_js_1.TriggerClient({
+            accessToken: "tr_preview_key",
+            previewBranch: "feature-x",
+        });
+        await Promise.all([
+            prod.runs.retrieve("run_a").catch(() => undefined),
+            preview.runs.retrieve("run_b").catch(() => undefined),
+            prod.runs.retrieve("run_c").catch(() => undefined),
+            preview.runs.retrieve("run_d").catch(() => undefined),
+        ]);
+        (0, vitest_1.expect)(fetchSpy.captured).toHaveLength(4);
+        const byPath = Object.fromEntries(fetchSpy.captured.map((r) => [r.url.split("/runs/")[1]?.split(/[/?]/)[0], r]));
+        (0, vitest_1.expect)(byPath["run_a"].authorization).toBe("Bearer tr_prod_key");
+        (0, vitest_1.expect)(byPath["run_a"].branch).toBeUndefined();
+        (0, vitest_1.expect)(byPath["run_c"].authorization).toBe("Bearer tr_prod_key");
+        (0, vitest_1.expect)(byPath["run_c"].branch).toBeUndefined();
+        (0, vitest_1.expect)(byPath["run_b"].authorization).toBe("Bearer tr_preview_key");
+        (0, vitest_1.expect)(byPath["run_b"].branch).toBe("feature-x");
+        (0, vitest_1.expect)(byPath["run_d"].authorization).toBe("Bearer tr_preview_key");
+        (0, vitest_1.expect)(byPath["run_d"].branch).toBe("feature-x");
+    });
+    (0, vitest_1.it)("masks taskContext.ctx inside an isolated scope (default)", () => {
+        const fakeCtx = {
+            run: { id: "run_parent", isTest: true },
+            project: { ref: "proj_xyz" },
+            environment: { slug: "preview" },
+        };
+        v3_1.taskContext.setGlobalTaskContext({ ctx: fakeCtx });
+        (0, vitest_1.expect)(v3_1.taskContext.ctx).toBe(fakeCtx);
+        const observed = v3_1.sdkScope.withScope({ apiClientConfig: { accessToken: "x" }, inheritContext: false }, () => v3_1.taskContext.ctx);
+        (0, vitest_1.expect)(observed).toBeUndefined();
+    });
+    (0, vitest_1.it)("exposes taskContext.ctx inside a scope when inheritContext is true", () => {
+        const fakeCtx = {
+            run: { id: "run_parent", isTest: true },
+            project: { ref: "proj_xyz" },
+            environment: { slug: "preview" },
+        };
+        v3_1.taskContext.setGlobalTaskContext({ ctx: fakeCtx });
+        const observed = v3_1.sdkScope.withScope({ apiClientConfig: { accessToken: "x" }, inheritContext: true }, () => v3_1.taskContext.ctx);
+        (0, vitest_1.expect)(observed).toBe(fakeCtx);
+    });
+});
+(0, vitest_1.describe)("configure()", () => {
+    (0, vitest_1.beforeEach)(() => {
+        v3_1.apiClientManager.disable();
+    });
+    (0, vitest_1.afterEach)(() => {
+        v3_1.apiClientManager.disable();
+    });
+    (0, vitest_1.it)("overrides previously-set configuration on a second call", async () => {
+        (0, auth_js_1.configure)({ accessToken: "tr_first" });
+        (0, vitest_1.expect)(v3_1.apiClientManager.accessToken).toBe("tr_first");
+        (0, auth_js_1.configure)({ accessToken: "tr_second", previewBranch: "branch-b" });
+        (0, vitest_1.expect)(v3_1.apiClientManager.accessToken).toBe("tr_second");
+        (0, vitest_1.expect)(v3_1.apiClientManager.branchName).toBe("branch-b");
+    });
+});
+(0, vitest_1.describe)("auth.withAuth", () => {
+    (0, vitest_1.beforeEach)(() => {
+        v3_1.apiClientManager.disable();
+    });
+    (0, vitest_1.afterEach)(() => {
+        v3_1.apiClientManager.disable();
+    });
+    (0, vitest_1.it)("inherits TRIGGER_SECRET_KEY from env when called with a partial config", async () => {
+        vitest_1.vi.stubEnv("TRIGGER_SECRET_KEY", "tr_dev_env_token");
+        let observed;
+        await auth_js_1.auth.withAuth({ baseURL: "https://override.example.com" }, async () => {
+            observed = v3_1.apiClientManager.accessToken;
+        });
+        // The scoped `inheritContext: true` path falls back to TRIGGER_SECRET_KEY
+        // so callers can override only baseURL without re-passing the token.
+        (0, vitest_1.expect)(observed).toBe("tr_dev_env_token");
+        // baseURL override still applies.
+        (0, vitest_1.expect)(await auth_js_1.auth.withAuth({ baseURL: "https://override.example.com" }, async () => v3_1.apiClientManager.baseURL)).toBe("https://override.example.com");
+    });
+    (0, vitest_1.it)("composes nested withAuth: outer-scope fields flow into the inner scope", async () => {
+        vitest_1.vi.stubEnv("TRIGGER_SECRET_KEY", "tr_env_token");
+        let observedBaseURL;
+        let observedAuth;
+        await auth_js_1.auth.withAuth({ baseURL: "https://outer.example.com" }, async () => {
+            await auth_js_1.auth.withAuth({ accessToken: "tr_inner_token" }, async () => {
+                observedBaseURL = v3_1.apiClientManager.baseURL;
+                observedAuth = v3_1.apiClientManager.accessToken;
+            });
+        });
+        (0, vitest_1.expect)(observedBaseURL).toBe("https://outer.example.com");
+        (0, vitest_1.expect)(observedAuth).toBe("tr_inner_token");
+    });
+    (0, vitest_1.it)("does not stomp on a parallel withAuth call with a different config", async () => {
+        (0, auth_js_1.configure)({ accessToken: "tr_global" });
+        const tokenA = "tr_concurrent_a";
+        const tokenB = "tr_concurrent_b";
+        const settle = {
+            resolveA: () => { },
+            resolveB: () => { },
+        };
+        const gateA = new Promise((r) => (settle.resolveA = r));
+        const gateB = new Promise((r) => (settle.resolveB = r));
+        const runA = auth_js_1.auth.withAuth({ accessToken: tokenA }, async () => {
+            // Suspend mid-scope so the parallel B scope opens while A is still pending.
+            await gateA;
+            return v3_1.apiClientManager.accessToken;
+        });
+        const runB = auth_js_1.auth.withAuth({ accessToken: tokenB }, async () => {
+            // Open B's scope first, then unblock A. If withAuth used the old
+            // mutate-and-restore pattern, A would observe tokenB or B's
+            // .finally would restore the wrong "original".
+            const seenInB = v3_1.apiClientManager.accessToken;
+            settle.resolveA();
+            await gateB;
+            return seenInB;
+        });
+        settle.resolveB(); // let B finish after A reads
+        const [seenInA, seenInB] = await Promise.all([runA, runB]);
+        (0, vitest_1.expect)(seenInA).toBe(tokenA);
+        (0, vitest_1.expect)(seenInB).toBe(tokenB);
+        // Global remains unchanged after both scopes exit.
+        (0, vitest_1.expect)(v3_1.apiClientManager.accessToken).toBe("tr_global");
+    });
+});
+//# sourceMappingURL=triggerClient.test.js.map

package/dist/commonjs/v3/triggerClient.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggerClient.test.js","sourceRoot":"","sources":["../../../src/v3/triggerClient.test.ts"],"names":[],"mappings":";;AAAA,mCAAyE;AACzE,6CAA+E;AAC/E,uCAA4C;AAC5C,uCAAiC;AACjC,yDAAmD;AAQnD,SAAS,eAAe;IACtB,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC;IAEvC,UAAU,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,KAAU,EAAE,IAAkB,EAAE,EAAE;QAC3D,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC;YACZ,GAAG;YACH,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,SAAS;YACxD,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,SAAS;SACrD,CAAC,CAAC;QACH,wEAAwE;QACxE,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE;YACtC,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,CAAC;IACL,CAAC,CAAiB,CAAC;IAEnB,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,GAAG,EAAE;YACZ,UAAU,CAAC,KAAK,GAAG,aAAa,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,IAAA,iBAAQ,EAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,QAA4C,CAAC;IAEjD,IAAA,mBAAU,EAAC,GAAG,EAAE;QACd,qBAAgB,CAAC,OAAO,EAAE,CAAC;QAC3B,QAAQ,GAAG,eAAe,EAAE,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,qBAAgB,CAAC,OAAO,EAAE,CAAC;QAC3B,gBAAW,CAAC,OAAO,EAAE,CAAC;QACtB,WAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,MAAM,GAAG,IAAI,gCAAa,EAAE,CAAC;QACnC,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,WAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QACrD,WAAE,CAAC,OAAO,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAC;QAEnD,MAAM,MAAM,GAAG,IAAI,gCAAa,EAAE,CAAC;QACnC,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE7D,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC5E,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,sEAAsE,EAAE,KAAK,IAAI,EAAE;QACpF,MAAM,MAAM,GAAG,IAAI,gCAAa,CAAC;YAC/B,WAAW,EAAE,2BAA2B;YACxC,aAAa,EAAE,aAAa;SAC7B,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE7D,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC;QAClC,IAAA,eAAM,EAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACnE,IAAA,eAAM,EAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,WAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;QACjD,WAAE,CAAC,OAAO,CAAC,wBAAwB,EAAE,YAAY,CAAC,CAAC;QACnD,WAAE,CAAC,OAAO,CAAC,iBAAiB,EAAE,yBAAyB,CAAC,CAAC;QAEzD,MAAM,QAAQ,GAAG,IAAI,gCAAa,CAAC;YACjC,WAAW,EAAE,aAAa;YAC1B,aAAa,EAAE,iBAAiB;SACjC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,gCAAa,EAAE,CAAC;QAEpC,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;SACtD,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC9E,CAAC;QAEF,IAAA,eAAM,EAAC,KAAK,CAAC,OAAO,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjE,IAAA,eAAM,EAAC,KAAK,CAAC,OAAO,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvD,IAAA,eAAM,EAAC,KAAK,CAAC,OAAO,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClE,IAAA,eAAM,EAAC,KAAK,CAAC,OAAO,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClD,IAAA,eAAM,EAAC,KAAK,CAAC,OAAO,CAAE,CAAC,GAAG,CAAC,UAAU,CAAC,0BAA0B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC5E,IAAA,mBAAS,EAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,IAAI,gCAAa,CAAC;YAC/B,WAAW,EAAE,2BAA2B;YACxC,aAAa,EAAE,aAAa;SAC7B,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,cAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAEzD,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACrF,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC/E,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,IAAI,GAAG,IAAI,gCAAa,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,gCAAa,CAAC;YAChC,WAAW,EAAE,gBAAgB;YAC7B,aAAa,EAAE,WAAW;SAC3B,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;SACtD,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAC9E,CAAC;QAEF,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAClE,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAE,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QAChD,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAClE,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAE,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;QAChD,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACrE,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACrE,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,OAAO,GAAG;YACd,GAAG,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE;YACvC,OAAO,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE;YAC5B,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1B,CAAC;QAET,gBAAW,CAAC,oBAAoB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAS,CAAC,CAAC;QAC1D,IAAA,eAAM,EAAC,gBAAW,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,aAAQ,CAAC,SAAS,CACjC,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,EAChE,GAAG,EAAE,CAAC,gBAAW,CAAC,GAAG,CACtB,CAAC;QAEF,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,OAAO,GAAG;YACd,GAAG,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE;YACvC,OAAO,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE;YAC5B,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC1B,CAAC;QAET,gBAAW,CAAC,oBAAoB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAS,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAG,aAAQ,CAAC,SAAS,CACjC,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,EAC/D,GAAG,EAAE,CAAC,gBAAW,CAAC,GAAG,CACtB,CAAC;QAEF,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAA,mBAAU,EAAC,GAAG,EAAE;QACd,qBAAgB,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,qBAAgB,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,IAAA,mBAAS,EAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;QACvC,IAAA,eAAM,EAAC,qBAAgB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEtD,IAAA,mBAAS,EAAC,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC;QACnE,IAAA,eAAM,EAAC,qBAAgB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvD,IAAA,eAAM,EAAC,qBAAgB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAA,mBAAU,EAAC,GAAG,EAAE;QACd,qBAAgB,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,qBAAgB,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,WAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QAErD,IAAI,QAA4B,CAAC;QACjC,MAAM,cAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,EAAE,KAAK,IAAI,EAAE;YAC1E,QAAQ,GAAG,qBAAgB,CAAC,WAAW,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,0EAA0E;QAC1E,qEAAqE;QACrE,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC1C,kCAAkC;QAClC,IAAA,eAAM,EACJ,MAAM,cAAI,CAAC,QAAQ,CACjB,EAAE,OAAO,EAAE,8BAA8B,EAAE,EAC3C,KAAK,IAAI,EAAE,CAAC,qBAAgB,CAAC,OAAO,CACrC,CACF,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,WAAE,CAAC,OAAO,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC;QAEjD,IAAI,eAAmC,CAAC;QACxC,IAAI,YAAgC,CAAC;QACrC,MAAM,cAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,EAAE,KAAK,IAAI,EAAE;YACvE,MAAM,cAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,EAAE,KAAK,IAAI,EAAE;gBAChE,eAAe,GAAG,qBAAgB,CAAC,OAAO,CAAC;gBAC3C,YAAY,GAAG,qBAAgB,CAAC,WAAW,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,eAAe,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1D,IAAA,eAAM,EAAC,YAAY,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,IAAA,mBAAS,EAAC,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;QAExC,MAAM,MAAM,GAAG,iBAAiB,CAAC;QACjC,MAAM,MAAM,GAAG,iBAAiB,CAAC;QAEjC,MAAM,MAAM,GAAG;YACb,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;YAClB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;SACnB,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;QAE9D,MAAM,IAAI,GAAG,cAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,IAAI,EAAE;YAC7D,4EAA4E;YAC5E,MAAM,KAAK,CAAC;YACZ,OAAO,qBAAgB,CAAC,WAAW,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,cAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,IAAI,EAAE;YAC7D,iEAAiE;YACjE,4DAA4D;YAC5D,+CAA+C;YAC/C,MAAM,OAAO,GAAG,qBAAgB,CAAC,WAAW,CAAC;YAC7C,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,6BAA6B;QAChD,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAE3D,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,mDAAmD;QACnD,IAAA,eAAM,EAAC,qBAAgB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commonjs/v3/triggerClient.types.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commonjs/v3/triggerClient.types.test.js

@@ -0,0 +1,113 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const batch_js_1 = require("./batch.js");
+const schedules = __importStar(require("./schedules/index.js"));
+const prompts = __importStar(require("./prompts.js"));
+const auth_js_1 = require("./auth.js");
+const triggerClient_js_1 = require("./triggerClient.js");
+const client = new triggerClient_js_1.TriggerClient({ accessToken: "tr_x" });
+(0, vitest_1.describe)("TriggerClient surface — type-level guarantees", () => {
+    (0, vitest_1.it)("preserves generic inference on tasks.trigger<typeof t>", () => {
+        (0, vitest_1.expectTypeOf)().resolves.toHaveProperty("id");
+        (0, vitest_1.expectTypeOf)().resolves.toHaveProperty("taskIdentifier");
+    });
+    (0, vitest_1.it)("preserves return type on runs.retrieve (no double-wrap)", () => {
+        // bindToScope wraps the impl as () => sdkScope.withScope(...). If the
+        // wrapper were typed loosely it could surface as Promise<ApiPromise<...>>.
+        // We want the original ApiPromise<...> to flow through unchanged.
+        const handle = client.runs.retrieve("run_x");
+        (0, vitest_1.expectTypeOf)(handle).toEqualTypeOf();
+        // And it should be assignable to a plain Promise (since ApiPromise extends Promise).
+        (0, vitest_1.expectTypeOf)(handle).toMatchTypeOf();
+    });
+    (0, vitest_1.it)("preserves envvars.list overloads (projectRef+slug form AND zero-arg form)", () => {
+        // Two-arg form
+        (0, vitest_1.expectTypeOf)(client.envvars.list).toBeCallableWith("proj_1234", "dev");
+        // Zero-arg form (uses task context — still typeable at the call site)
+        (0, vitest_1.expectTypeOf)(client.envvars.list).toBeCallableWith();
+    });
+});
+(0, vitest_1.describe)("TriggerClient surface — curated subsets", () => {
+    (0, vitest_1.it)("instance.tasks drops inside-task-only and definition-time helpers", () => {
+        (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        // @ts-expect-error — triggerAndWait is not on the instance surface.
+        client.tasks.triggerAndWait;
+        // @ts-expect-error — batchTriggerAndWait is not on the instance surface.
+        client.tasks.batchTriggerAndWait;
+        // @ts-expect-error — triggerAndSubscribe requires a task context; not on the instance surface.
+        client.tasks.triggerAndSubscribe;
+        // @ts-expect-error — hooks like onStart are task-definition-time, not on the client.
+        client.tasks.onStart;
+    });
+    (0, vitest_1.it)("instance.batch drops the *AndWait variants that depend on the runtime", () => {
+        (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        // @ts-expect-error
+        client.batch.triggerAndWait;
+        // @ts-expect-error
+        client.batch.triggerByTaskAndWait;
+        // The module-level export still has them — sanity check we didn't change that.
+        (0, vitest_1.expectTypeOf)(batch_js_1.batch).toHaveProperty("triggerAndWait");
+    });
+    (0, vitest_1.it)("instance.schedules drops `task` definition helper and `timezones` stateless helper", () => {
+        (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        // @ts-expect-error
+        client.schedules.task;
+        // @ts-expect-error
+        client.schedules.timezones;
+        // Module-level export still has them.
+        (0, vitest_1.expectTypeOf)(schedules).toHaveProperty("task");
+        (0, vitest_1.expectTypeOf)(schedules).toHaveProperty("timezones");
+    });
+    (0, vitest_1.it)("instance.prompts drops `define`", () => {
+        // @ts-expect-error
+        client.prompts.define;
+        // Module-level export still has it.
+        (0, vitest_1.expectTypeOf)(prompts).toHaveProperty("define");
+    });
+    (0, vitest_1.it)("instance.auth is the public-token subset only (no configure/withAuth)", () => {
+        (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        // @ts-expect-error — configure is global-only, not on the instance.
+        client.auth.configure;
+        // @ts-expect-error — withAuth is global-only.
+        client.auth.withAuth;
+        // Module-level export still has them.
+        (0, vitest_1.expectTypeOf)(auth_js_1.auth).toHaveProperty("configure");
+        (0, vitest_1.expectTypeOf)(auth_js_1.auth).toHaveProperty("withAuth");
+    });
+});
+(0, vitest_1.describe)("TriggerClient surface — namespaces match their module sources", () => {
+    // These are the load-bearing assertions for the bindToScope cast. If the
+    // `as unknown as Pick<T, K>` ever drops or widens the underlying signatures,
+    // these break.
+    (0, vitest_1.it)("client.runs is structurally `typeof runs`", () => {
+        (0, vitest_1.expectTypeOf)(client.runs).toEqualTypeOf();
+    });
+    (0, vitest_1.it)("client.envvars is structurally `typeof envvars`", () => {
+        (0, vitest_1.expectTypeOf)(client.envvars).toEqualTypeOf();
+    });
+});
+//# sourceMappingURL=triggerClient.types.test.js.map

package/dist/commonjs/v3/triggerClient.types.test.js.map

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

package/dist/commonjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = "4.5.0-rc.0";
+exports.VERSION = "4.5.0-rc.2";
 //# sourceMappingURL=version.js.map

package/dist/esm/v3/ai-shared.d.ts

@@ -171,3 +171,73 @@ export type InferChatClientData<TTask extends AnyTask> = TTask extends Task<stri
  * ```
  */
 export type InferChatUIMessage<TTask extends AnyTask> = TTask extends Task<string, ChatTaskWirePayload<infer TUIM extends UIMessage, any>, any> ? TUIM : UIMessage;
+/**
+ * Upsert an incoming wire message into the customer's DB-backed chain
+ * inside a `hydrateMessages` hook. Returns `true` iff the chain was
+ * mutated (the caller should persist).
+ *
+ * Handles the three cases that matter:
+ *
+ *  - **Non-submit-message trigger** (`regenerate-message` / `action`,
+ *    or `submit-message` with no incoming): no-op. Returns `false`.
+ *  - **Incoming id already in `stored`** (HITL `addToolOutput` /
+ *    `addToolApproveResponse` continuation — the wire carries the
+ *    existing assistant's id with a slim resolution payload): no-op.
+ *    The runtime's per-turn merge overlays the new tool-state advance
+ *    onto the existing entry; pushing again would duplicate the row
+ *    in the chain you return, and the duplicate slim copy would hit
+ *    `toModelMessages` with no `input`. Returns `false`.
+ *  - **Incoming id not in `stored`** (typically a fresh user message
+ *    on a new turn): push. Returns `true`.
+ *
+ * Mutates `stored` in place. The caller persists `stored`, not the
+ * return value.
+ *
+ * @example
+ * ```ts
+ * import { chat, upsertIncomingMessage } from "@trigger.dev/sdk/ai";
+ *
+ * chat.agent({
+ *   hydrateMessages: async ({ chatId, trigger, incomingMessages }) => {
+ *     const record = await db.chat.findUnique({ where: { id: chatId } });
+ *     const stored = record?.messages ?? [];
+ *     if (upsertIncomingMessage(stored, { trigger, incomingMessages })) {
+ *       await db.chat.update({ where: { id: chatId }, data: { messages: stored } });
+ *     }
+ *     return stored;
+ *   },
+ * });
+ * ```
+ */
+export declare function upsertIncomingMessage<TMsg extends UIMessage = UIMessage>(stored: TMsg[], event: {
+    trigger: "submit-message" | "regenerate-message" | "action";
+    incomingMessages: TMsg[];
+}): boolean;
+/**
+ * Slim an outgoing assistant message before it ships on `submit-message`.
+ *
+ * When the client calls `addToolOutput(...)` to resolve a HITL tool (or
+ * `addToolApproveResponse(...)` to approve/deny one), the AI SDK turns
+ * it into a `submit-message` whose `messages.at(-1)` is the existing
+ * assistant message with the new state stitched onto a single tool
+ * part. On a reasoning-heavy multi-step turn, that full assistant
+ * message can be 600 KB – 1 MB (encrypted reasoning blobs, reasoning
+ * text, full tool `input` JSON, prior tool outputs) — well over the
+ * `.in/append` cap.
+ *
+ * The agent runtime only consumes the wire-advanced fields of those
+ * tool parts (state + output / errorText / approval). Everything else
+ * (text, reasoning, tool `input`) is rebuilt server-side from the
+ * durable snapshot or `hydrateMessages`. So we drop everything but
+ * the advanced tool parts here, and reduce those to just the fields
+ * the server overlays.
+ *
+ * The slim only fires when the assistant message carries at least one
+ * wire-advanceable tool part. Plain assistant resends (no resolved /
+ * approval-responded tool) and non-assistant messages pass through
+ * untouched.
+ *
+ * Pairs with the per-turn merge on the agent side
+ * (`mergeIncomingIntoHydrated` in `ai.ts`).
+ */
+export declare function slimSubmitMessageForWire<TMsg extends UIMessage | undefined>(message: TMsg): TMsg;

package/dist/esm/v3/ai-shared.js

@@ -19,4 +19,146 @@
  * injects when a follow-up message arrives mid-turn.
  */
 export const PENDING_MESSAGE_INJECTED_TYPE = "data-pending-message-injected";
+/**
+ * Upsert an incoming wire message into the customer's DB-backed chain
+ * inside a `hydrateMessages` hook. Returns `true` iff the chain was
+ * mutated (the caller should persist).
+ *
+ * Handles the three cases that matter:
+ *
+ *  - **Non-submit-message trigger** (`regenerate-message` / `action`,
+ *    or `submit-message` with no incoming): no-op. Returns `false`.
+ *  - **Incoming id already in `stored`** (HITL `addToolOutput` /
+ *    `addToolApproveResponse` continuation — the wire carries the
+ *    existing assistant's id with a slim resolution payload): no-op.
+ *    The runtime's per-turn merge overlays the new tool-state advance
+ *    onto the existing entry; pushing again would duplicate the row
+ *    in the chain you return, and the duplicate slim copy would hit
+ *    `toModelMessages` with no `input`. Returns `false`.
+ *  - **Incoming id not in `stored`** (typically a fresh user message
+ *    on a new turn): push. Returns `true`.
+ *
+ * Mutates `stored` in place. The caller persists `stored`, not the
+ * return value.
+ *
+ * @example
+ * ```ts
+ * import { chat, upsertIncomingMessage } from "@trigger.dev/sdk/ai";
+ *
+ * chat.agent({
+ *   hydrateMessages: async ({ chatId, trigger, incomingMessages }) => {
+ *     const record = await db.chat.findUnique({ where: { id: chatId } });
+ *     const stored = record?.messages ?? [];
+ *     if (upsertIncomingMessage(stored, { trigger, incomingMessages })) {
+ *       await db.chat.update({ where: { id: chatId }, data: { messages: stored } });
+ *     }
+ *     return stored;
+ *   },
+ * });
+ * ```
+ */
+export function upsertIncomingMessage(stored, event) {
+    if (event.trigger !== "submit-message")
+        return false;
+    if (event.incomingMessages.length === 0)
+        return false;
+    const newMsg = event.incomingMessages[event.incomingMessages.length - 1];
+    if (!newMsg)
+        return false;
+    if (newMsg.id) {
+        const existingIdx = stored.findIndex((m) => m.id === newMsg.id);
+        if (existingIdx !== -1)
+            return false;
+    }
+    stored.push(newMsg);
+    return true;
+}
+/**
+ * Tool-part states that the client advances and ships back over the wire.
+ * Covers HITL `addToolOutput` (output-available / output-error) and the
+ * approval flow (approval-responded / output-denied). `input-streaming` /
+ * `input-available` / `approval-requested` are server-emitted only — if
+ * we see them on the wire we treat them as no-ops and skip the slim/merge.
+ */
+function isWireAdvanceableToolState(state) {
+    return (state === "output-available" ||
+        state === "output-error" ||
+        state === "approval-responded" ||
+        state === "output-denied");
+}
+/** Whether a tool-UI part is a static (`tool-${name}`) or dynamic tool. */
+function isToolPartType(type) {
+    return typeof type === "string" && (type.startsWith("tool-") || type === "dynamic-tool");
+}
+/**
+ * Slim an outgoing assistant message before it ships on `submit-message`.
+ *
+ * When the client calls `addToolOutput(...)` to resolve a HITL tool (or
+ * `addToolApproveResponse(...)` to approve/deny one), the AI SDK turns
+ * it into a `submit-message` whose `messages.at(-1)` is the existing
+ * assistant message with the new state stitched onto a single tool
+ * part. On a reasoning-heavy multi-step turn, that full assistant
+ * message can be 600 KB – 1 MB (encrypted reasoning blobs, reasoning
+ * text, full tool `input` JSON, prior tool outputs) — well over the
+ * `.in/append` cap.
+ *
+ * The agent runtime only consumes the wire-advanced fields of those
+ * tool parts (state + output / errorText / approval). Everything else
+ * (text, reasoning, tool `input`) is rebuilt server-side from the
+ * durable snapshot or `hydrateMessages`. So we drop everything but
+ * the advanced tool parts here, and reduce those to just the fields
+ * the server overlays.
+ *
+ * The slim only fires when the assistant message carries at least one
+ * wire-advanceable tool part. Plain assistant resends (no resolved /
+ * approval-responded tool) and non-assistant messages pass through
+ * untouched.
+ *
+ * Pairs with the per-turn merge on the agent side
+ * (`mergeIncomingIntoHydrated` in `ai.ts`).
+ */
+export function slimSubmitMessageForWire(message) {
+    if (!message)
+        return message;
+    if (message.role !== "assistant")
+        return message;
+    const parts = (message.parts ?? []);
+    const advancedToolParts = parts.filter((p) => p &&
+        typeof p === "object" &&
+        isToolPartType(p.type) &&
+        isWireAdvanceableToolState(p.state));
+    if (advancedToolParts.length === 0)
+        return message;
+    const slimParts = advancedToolParts.map((p) => {
+        const base = {
+            type: p.type,
+            toolCallId: p.toolCallId,
+            state: p.state,
+        };
+        if (p.type === "dynamic-tool" && typeof p.toolName === "string") {
+            base.toolName = p.toolName;
+        }
+        if (p.state === "output-available") {
+            base.output = p.output;
+            if (p.approval !== undefined)
+                base.approval = p.approval;
+        }
+        else if (p.state === "output-error") {
+            if (p.errorText !== undefined)
+                base.errorText = p.errorText;
+            if (p.approval !== undefined)
+                base.approval = p.approval;
+        }
+        else if (p.state === "approval-responded" || p.state === "output-denied") {
+            if (p.approval !== undefined)
+                base.approval = p.approval;
+        }
+        return base;
+    });
+    return {
+        id: message.id,
+        role: message.role,
+        parts: slimParts,
+    };
+}
 //# sourceMappingURL=ai-shared.js.map

package/dist/esm/v3/ai-shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-shared.js","sourceRoot":"","sources":["../../../src/v3/ai-shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,+BAAwC,CAAC"}
+{"version":3,"file":"ai-shared.js","sourceRoot":"","sources":["../../../src/v3/ai-shared.ts"],"names":[],"mappings":"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"}