@trigger.dev/sdk 4.5.1 → 4.5.3

package/dist/commonjs/v3/chat-react.d.ts

@@ -15,6 +15,7 @@ export type UseTriggerChatTransportOptions<TTask extends AnyTask = AnyTask> = Om
     task: TaskIdentifier<TTask>;
 };
 export type { InferChatUIMessage };
+export type { ChatTransportEvent, ChatTransportSendSource } from "./chat.js";
 /**
  * React hook that creates and memoizes a `TriggerChatTransport` instance.
  *

package/dist/commonjs/v3/chat-react.js

@@ -65,10 +65,13 @@ function useTriggerChatTransport(options) {
         ref.current = new chat_js_1.TriggerChatTransport(options);
     }
     // Keep callbacks up to date without recreating the transport.
-    const { onSessionChange, clientData } = options;
+    const { onSessionChange, clientData, onEvent } = options;
     (0, react_1.useEffect)(() => {
         ref.current?.setOnSessionChange(onSessionChange);
     }, [onSessionChange]);
+    (0, react_1.useEffect)(() => {
+        ref.current?.setOnEvent(onEvent);
+    }, [onEvent]);
     // Keep `clientData` up to date so the transport's per-turn merge and
     // `startSession` callback both see the latest value without
     // reconstructing the transport.

package/dist/commonjs/v3/chat-react.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-react.js","sourceRoot":"","sources":["../../../src/v3/chat-react.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;AAmFb,0DA2BC;AAmBD,0CAmEC;AA8FD,gDAiLC;AAjdD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,iCAAiE;AACjE,uCAAmF;AAEnF,iDAIwB;AAqBxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,uBAAuB,CACrC,OAA8C;IAE9C,MAAM,GAAG,GAAG,IAAA,cAAM,EAA8B,IAAI,CAAC,CAAC;IACtD,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACzB,GAAG,CAAC,OAAO,GAAG,IAAI,8BAAoB,CAAC,OAAsC,CAAC,CAAC;IACjF,CAAC;IAED,8DAA8D;IAC9D,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAChD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,GAAG,CAAC,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACnD,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAEtB,qEAAqE;IACrE,4DAA4D;IAC5D,gCAAgC;IAChC,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,UAAiD,CAAC,CAAC;IAChF,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,4EAA4E;IAC5E,+EAA+E;IAC/E,kEAAkE;IAClE,4EAA4E;IAE5E,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAC7B,SAA+B,EAC/B,MAAc,EACd,QAAa,EACb,WAAoC;IAEpC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,IAAA,gBAAQ,EAAC,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjF,wBAAwB;IACxB,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,QAAiB,EAAE,EAAE;YACjD,IAAI,EAAE,KAAK,MAAM;gBAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC,CAAC;QACF,SAAS,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACxC,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5C,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAExB,0DAA0D;IAC1D,wEAAwE;IACxE,8DAA8D;IAC9D,wEAAwE;IACxE,MAAM,OAAO,GAAG,IAAA,cAAM,EAAgD,IAAI,CAAC,CAAC;IAC5E,MAAM,iBAAiB,GAAG,IAAA,cAAM,EAAC,QAAQ,CAAC,CAAC;IAC3C,iBAAiB,CAAC,OAAO,GAAG,QAAQ,CAAC;IAErC,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjE,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;YAAE,OAAO,CAAC,oBAAoB;QAE1D,MAAM,QAAQ,GACZ,OAAO,mBAAmB,KAAK,UAAU;YACvC,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,CAAC,EAAc,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAE7C,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE;YAC9B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YACvB,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,CAAC,OAAoB,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAElC,2DAA2D;IAC3D,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxE,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,OAAO,kBAAkB,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC;gBAC5F,MAAM,CAAC,OAAO,CAAC,OAAc,CAAC,CAAC;gBAC/B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YACzB,CAAC;YACD,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,CAAC,OAAoB,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAEpC,sDAAsD;IACtD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,IAAe,EAAE,EAAE;YAC/C,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;gBAClB,WAAW,CAAC,IAAW,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC;QACF,SAAS,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAErC,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AA0DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,SAAgB,kBAAkB,CAChC,OAA8C;IAE9C,MAAM,EACJ,SAAS,EACT,MAAM,EACN,MAAM,EACN,QAAQ,EACR,WAAW,EAAE,YAAY,EACzB,WAAW,EACX,QAAQ,GACT,GAAG,OAAO,CAAC;IAIZ,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,IAAA,gBAAQ,EAAoB,EAAE,CAAC,CAAC;IACtE,MAAM,cAAc,GAAG,IAAA,cAAM,EAAC,WAAW,CAAC,CAAC;IAC3C,cAAc,CAAC,OAAO,GAAG,WAAW,CAAC;IACrC,MAAM,cAAc,GAAG,IAAA,cAAM,EAAc,IAAI,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,IAAA,cAAM,EAAC,MAAM,CAAC,CAAC;IAErC,gEAAgE;IAChE,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,MAAM,KAAK,WAAW;YAAE,OAAO;QACnC,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;gBAAE,SAAS;YACvC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBACnC,IAAK,IAAY,CAAC,IAAI,KAAK,4CAA6B,EAAE,CAAC;oBACzD,MAAM,UAAU,GAAI,IAAY,CAAC,IAAI,EAAE,UAAU,CAAC;oBAClD,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;wBAC9B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;4BAC5B,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gCACpC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gCAC/B,aAAa,GAAG,IAAI,CAAC;4BACvB,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,yEAAyE;QACzE,IAAI,aAAa,EAAE,CAAC;YAClB,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAClF,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEvB,yBAAyB;IACzB,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,KAAK,WAAW,IAAI,MAAM,KAAK,OAAO,CAAC;QAClF,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC;QAC/B,IAAI,CAAC,aAAa;YAAE,OAAO;QAE3B,oDAAoD;QACpD,mEAAmE;QACnE,8DAA8D;QAC9D,mEAAmE;QACnE,mEAAmE;QACnE,uEAAuE;QACvE,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5E,WAAW;QACX,cAAc,CAAC,EAAE,CAAC,CAAC;QACnB,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/B,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAE/B,yBAAyB;QACzB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7E,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE3D,kEAAkE;IAClE,MAAM,KAAK,GAAG,IAAA,mBAAW,EACvB,CAAC,IAAY,EAAE,EAAE;QACf,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG;gBACV,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;gBACvB,IAAI,EAAE,MAAe;gBACrB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;gBACxC,KAAK,EAAE,UAAmB;aACR,CAAC;YACrB,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;YACpD,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,qCAAqC;YACrC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,EACD,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CACnD,CAAC;IAEF,2DAA2D;IAC3D,MAAM,KAAK,GAAG,IAAA,mBAAW,EACvB,CAAC,IAAY,EAAE,EAAE;QACf,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG;gBACV,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;gBACvB,IAAI,EAAE,MAAe;gBACrB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;gBACxC,KAAK,EAAE,QAAiB;aACN,CAAC;YACrB,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,EACD,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAChC,CAAC;IAEF,2EAA2E;IAC3E,MAAM,cAAc,GAAG,IAAA,cAAM,EAAc,IAAI,GAAG,EAAE,CAAC,CAAC;IACtD,MAAM,iBAAiB,GAAG,IAAA,mBAAW,EACnC,CAAC,EAAU,EAAE,EAAE;QACb,wDAAwD;QACxD,IAAI,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QAED,sEAAsE;QACtE,sEAAsE;QACtE,mCAAmC;QACnC,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO;QAC3C,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAEpD,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,UAAmB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC1E,CAAC;IACJ,CAAC,EACD,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAC9B,CAAC;IAEF,MAAM,gBAAgB,GAAG,IAAA,mBAAW,EAClC,CAAC,IAAa,EAAW,EAAE,CACzB,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACZ,IAAY,CAAC,IAAI,KAAK,4CAA6B,EACtD,EAAE,CACH,CAAC;IAEF,MAAM,qBAAqB,GAAG,IAAA,mBAAW,EACvC,CAAC,IAAa,EAAY,EAAE;QAC1B,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACvC,MAAM,GAAG,GAAI,IAAY,CAAC,IAAI,EAAE,UAAU,CAAC;QAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,CAAC,EACD,CAAC,gBAAgB,CAAC,CACnB,CAAC;IAEF,MAAM,mBAAmB,GAAG,IAAA,mBAAW,EACrC,CAAC,IAAa,EAAqB,EAAE;QACnC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACvC,MAAM,IAAI,GAAI,IAAY,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,CAAC,EACD,CAAC,gBAAgB,CAAC,CACnB,CAAC;IAEF,MAAM,OAAO,GAAqB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAS,EAAE,IAAI,IAAI,EAAE;QACvC,IAAI,EAAE,CAAC,CAAC,KAAK;QACb,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3C,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,OAAO;QACP,KAAK;QACL,KAAK;QACL,iBAAiB;QACjB,gBAAgB;QAChB,qBAAqB;QACrB,mBAAmB;KACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"chat-react.js","sourceRoot":"","sources":["../../../src/v3/chat-react.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/v3/chat.d.ts

@@ -22,7 +22,110 @@
  * }
  * ```
  */
-import type { ChatTransport, UIMessage, UIMessageChunk, ChatRequestOptions } from "ai";
+import type { ChatTransport, ModelMessage, UIMessage, UIMessageChunk, ChatRequestOptions } from "ai";
+/**
+ * The wire payload shape sent by `TriggerChatTransport`.
+ * Uses `metadata` to match the AI SDK's `ChatRequestOptions` field name.
+ *
+ * Slim wire: at most ONE message per record. The agent runtime
+ * reconstructs prior history at run boot from a durable S3 snapshot +
+ * `session.out` replay (or `hydrateMessages` if registered).
+ *
+ * Declared here (rather than the internal shared module) so `declaration:
+ * true` consumers can name inferred agent types via this public subpath.
+ */
+export type ChatTaskWirePayload<TMessage extends UIMessage = UIMessage, TMetadata = unknown> = {
+    /**
+     * The single message being delivered on this trigger. Set for:
+     *   - `submit-message`: the new user message OR a tool-approval-responded
+     *     assistant message (with `state: "approval-responded"` tool parts).
+     *   - `regenerate-message`: omitted (the agent slices its own history).
+     *   - `preload` / `close` / `action`: omitted.
+     *   - `handover-prepare`: omitted (use `headStartMessages` instead).
+     */
+    message?: TMessage;
+    /**
+     * Bespoke escape hatch for `chat.headStart`. The customer's HTTP route
+     * handler ships full `UIMessage[]` history at the very first turn — before
+     * any snapshot exists. The route handler isn't subject to the
+     * `MAX_APPEND_BODY_BYTES` cap on `/in/append` because it goes through the
+     * customer's own HTTP endpoint. Used ONLY by `trigger: "handover-prepare"`.
+     * Ignored on every other trigger.
+     */
+    headStartMessages?: TMessage[];
+    chatId: string;
+    trigger: "submit-message" | "regenerate-message" | "preload" | "close" | "action"
+    /**
+     * The customer's `chat.handover` route handler kicked us off in
+     * parallel with the first-turn `streamText` running in the warm
+     * Next.js process. The run sits idle on `session.in` waiting for
+     * a `kind: "handover"` (continue from tool execution) or
+     * `kind: "handover-skip"` (handler finished pure-text, exit
+     * cleanly). See `chat.handover` in `@trigger.dev/sdk/chat-server`.
+     */
+     | "handover-prepare";
+    messageId?: string;
+    metadata?: TMetadata;
+    /** Custom action payload when `trigger` is `"action"`. Validated against `actionSchema` on the backend. */
+    action?: unknown;
+    /** Whether this run is continuing an existing chat whose previous run ended. */
+    continuation?: boolean;
+    /** The run ID of the previous run (only set when `continuation` is true). */
+    previousRunId?: string;
+    /** Override idle timeout for this run (seconds). Set by transport.preload(). */
+    idleTimeoutInSeconds?: number;
+    /**
+     * The friendlyId of the Session primitive backing this chat. The
+     * transport opens (or lazy-creates) the session with
+     * `externalId = chatId` on first message, then sends this friendlyId
+     * through to the run so the agent can attach to `.in` / `.out`
+     * without needing to round-trip through the control plane again.
+     * Optional for backward-compat while the migration is in flight;
+     * required once the legacy run-scoped stream path is removed.
+     */
+    sessionId?: string;
+};
+/**
+ * One chunk on the chat input stream. `kind` discriminates the variants —
+ * a single ordered stream carries all the signals (`message`, `stop`,
+ * `handover`, `handover-skip`).
+ */
+export type ChatInputChunk<TMessage extends UIMessage = UIMessage, TMetadata = unknown> = {
+    kind: "message";
+    /** Full wire payload for a new user message or regeneration. */
+    payload: ChatTaskWirePayload<TMessage, TMetadata>;
+} | {
+    kind: "stop";
+    /** Optional human-readable reason. */
+    message?: string;
+} | {
+    /**
+     * Sent by `chat.headStart` when the customer's first-turn
+     * `streamText` finishes. The agent run (parked in
+     * `handover-prepare`) wakes, seeds its accumulators with
+     * `partialAssistantMessage`, and runs the normal turn loop.
+     * `isFinal: false` means step 1 ended in tool-calls (the agent
+     * executes them and continues); `isFinal: true` means step 1 was
+     * the complete response (the agent skips the LLM call).
+     */
+    kind: "handover";
+    /** Customer's step-1 response messages (ModelMessage form). */
+    partialAssistantMessage: ModelMessage[];
+    /**
+     * The UI messageId the customer's handler used for its step-1
+     * assistant message, reused so post-handover chunks merge into
+     * the SAME assistant message on the browser side.
+     */
+    messageId?: string;
+    isFinal: boolean;
+} | {
+    /**
+     * Sent by `chat.headStart` only when the customer's handler
+     * ABORTS before producing a finishReason. The agent run exits
+     * cleanly without firing turn hooks.
+     */
+    kind: "handover-skip";
+};
 /**
  * Discriminator passed to per-endpoint `baseURL` and `fetch` callbacks.
  *
@@ -52,6 +155,81 @@ export type ChatBaseURLResolver = (ctx: ChatTransportEndpointContext) => string;
  * what `globalThis.fetch(url, init)` would have returned.
  */
 export type ChatFetchOverride = (url: string, init: RequestInit, ctx: ChatTransportEndpointContext) => Promise<Response>;
+/**
+ * Which transport path produced a send-lifecycle event: `useChat` sends,
+ * steering (`sendPendingMessage`), actions, stops, or the first-turn
+ * `headStart` POST.
+ */
+export type ChatTransportSendSource = "submit-message" | "regenerate-message" | "steer" | "action" | "stop" | "head-start";
+/**
+ * Lifecycle events emitted through the transport's `onEvent` callback.
+ *
+ * Send events are terminal: `message-sent` fires when the append is
+ * durably acknowledged (2xx from the session input stream, after any
+ * internal token-refresh retries), `message-send-failed` when the send
+ * definitively failed. Response events follow the output stream:
+ * `stream-connected` when the SSE subscription opens, `first-chunk` on
+ * the first response chunk of a turn, `turn-completed` when the agent's
+ * turn-complete control record arrives, and `stream-error` when the
+ * stream fails unrecoverably.
+ */
+export type ChatTransportEvent = {
+    type: "message-sent";
+    chatId: string;
+    timestamp: number;
+    messageId?: string;
+    source: ChatTransportSendSource;
+    durationMs: number;
+    /** The append's idempotency key — also stored on the server-side record. */
+    partId?: string;
+    /** Serialized request body size in bytes. */
+    bodyBytes?: number;
+} | {
+    type: "message-send-failed";
+    chatId: string;
+    timestamp: number;
+    messageId?: string;
+    source: ChatTransportSendSource;
+    error: Error;
+    status?: number;
+    durationMs: number;
+    partId?: string;
+    bodyBytes?: number;
+} | {
+    type: "stream-connected";
+    chatId: string;
+    timestamp: number;
+    resumed: boolean;
+    /** The resume cursor the subscription connected from, if any. */
+    lastEventId?: string;
+    /** The last turn-producing send on this chat (client-side attribution). */
+    messageId?: string;
+} | {
+    type: "stream-error";
+    chatId: string;
+    timestamp: number;
+    error: Error;
+    status?: number;
+} | {
+    type: "first-chunk";
+    chatId: string;
+    timestamp: number;
+    chunkType?: string;
+    lastEventId?: string;
+    messageId?: string;
+    /** Milliseconds since the last turn-producing send on this chat (time to first token). */
+    sinceSendMs?: number;
+} | {
+    type: "turn-completed";
+    chatId: string;
+    timestamp: number;
+    lastEventId?: string;
+    /** The agent's committed input-stream cursor from the turn-complete record. */
+    sessionInEventId?: string;
+    messageId?: string;
+    /** Milliseconds since the last turn-producing send on this chat (full turn latency). */
+    sinceSendMs?: number;
+};
 /**
  * Arguments for the `accessToken` callback. The transport invokes this
  * whenever it needs a fresh session-scoped PAT — initial use, and
@@ -204,6 +382,22 @@ export type TriggerChatTransportOptions<TClientData = unknown> = {
      * ```
      */
     fetch?: ChatFetchOverride;
+    /**
+     * Observability callback for transport lifecycle events (sends,
+     * stream connects, first chunk, turn completion). See
+     * {@link ChatTransportEvent} for the event catalog and semantics.
+     * Exceptions thrown by the callback are swallowed.
+     *
+     * @example Record send metrics:
+     * ```ts
+     * onEvent: (event) => {
+     *   if (event.type === "message-sent") {
+     *     metrics.timing("chat.send", event.durationMs);
+     *   }
+     * },
+     * ```
+     */
+    onEvent?: (event: ChatTransportEvent) => void;
     /** Additional headers included in every API request. */
     headers?: Record<string, string>;
     /**
@@ -305,9 +499,11 @@ export declare class TriggerChatTransport implements ChatTransport<UIMessage> {
     private readonly headStart;
     private coordinator;
     private _onSessionChange;
+    private _onEvent;
     private sessions;
     private activeStreams;
     private pendingStarts;
+    private lastTurnSends;
     constructor(options: TriggerChatTransportOptions);
     /**
      * Eagerly create a Session and trigger its first run. Useful as a
@@ -382,6 +578,13 @@ export declare class TriggerChatTransport implements ChatTransport<UIMessage> {
     getSession: (chatId: string) => ChatSessionPersistedState | undefined;
     setSession(chatId: string, session: ChatSessionPersistedState): void;
     setOnSessionChange(callback: ((chatId: string, session: ChatSessionPersistedState | null) => void) | undefined): void;
+    /** Update the `onEvent` callback without recreating the transport. */
+    setOnEvent(callback: ((event: ChatTransportEvent) => void) | undefined): void;
+    private emitEvent;
+    /** Run a send op, emitting the terminal message-sent / message-send-failed event. */
+    private sendWithEvents;
+    /** Attribution fields for response-side events. */
+    private turnAttribution;
     /**
      * Update the transport's `clientData`. Used by `useTriggerChatTransport`
      * to keep the latest value reachable from inside `startSession` and

package/dist/commonjs/v3/chat.js

@@ -27,6 +27,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChatStream = exports.AgentChat = exports.TriggerChatTransport = void 0;
 exports.createChatTransport = createChatTransport;
 const v3_1 = require("@trigger.dev/core/v3");
+function byteLength(body) {
+    return new TextEncoder().encode(body).byteLength;
+}
 const chat_tab_coordinator_js_1 = require("./chat-tab-coordinator.js");
 const ai_shared_js_1 = require("./ai-shared.js");
 const DEFAULT_BASE_URL = "https://api.trigger.dev";
@@ -144,9 +147,13 @@ class TriggerChatTransport {
     headStart;
     coordinator = null;
     _onSessionChange;
+    _onEvent;
     sessions = new Map();
     activeStreams = new Map();
     pendingStarts = new Map();
+    // Last turn-producing send per chat — attribution source for the
+    // response-side events' `messageId` / `sinceSendMs`.
+    lastTurnSends = new Map();
     constructor(options) {
         this.taskId = options.task;
         this.resolveAccessToken = options.accessToken;
@@ -162,6 +169,7 @@ class TriggerChatTransport {
         this.streamTimeoutSeconds = options.streamTimeoutSeconds ?? DEFAULT_STREAM_TIMEOUT_SECONDS;
         this.defaultMetadata = options.clientData;
         this._onSessionChange = options.onSessionChange;
+        this._onEvent = options.onEvent;
         this.watchMode = options.watch ?? false;
         this.headStart = options.headStart;
         if (options.multiTab && !this.watchMode) {
@@ -286,10 +294,15 @@ class TriggerChatTransport {
         // Generated outside the closure so auth-retries reuse the same part id
         // and the server-side dedupe sees one logical append.
         const partId = crypto.randomUUID();
+        const serializedBody = this.serializeInputChunk({ kind: "message", payload: wirePayload });
         const sendChatMessage = async (token) => {
-            await this.appendInputChunk(chatId, token, this.serializeInputChunk({ kind: "message", payload: wirePayload }), partId);
+            await this.appendInputChunk(chatId, token, serializedBody, partId);
         };
-        await this.callWithAuthRetry(chatId, state, sendChatMessage);
+        await this.sendWithEvents(chatId, trigger, {
+            messageId: messageId ?? messages.at(-1)?.id,
+            partId,
+            bodyBytes: byteLength(serializedBody),
+        }, () => this.callWithAuthRetry(chatId, state, sendChatMessage));
         // Cancel any in-flight stream for this chat — the new turn supersedes it.
         const activeStream = this.activeStreams.get(chatId);
         if (activeStream) {
@@ -324,18 +337,27 @@ class TriggerChatTransport {
             messageId: args.messageId,
             metadata: args.metadata,
         };
-        const response = await fetch(this.headStart, {
-            method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                ...this.extraHeaders,
-            },
-            body: JSON.stringify(wirePayload),
-            signal: args.abortSignal,
+        let response;
+        const serializedBody = JSON.stringify(wirePayload);
+        await this.sendWithEvents(args.chatId, "head-start", {
+            messageId: args.messageId ?? args.messages.at(-1)?.id,
+            bodyBytes: byteLength(serializedBody),
+        }, async () => {
+            response = await fetch(this.headStart, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    ...this.extraHeaders,
+                },
+                body: serializedBody,
+                signal: args.abortSignal,
+            });
+            if (!response.ok) {
+                const err = new Error(`chat.handover endpoint returned ${response.status} ${response.statusText}`);
+                err.status = response.status;
+                throw err;
+            }
         });
-        if (!response.ok) {
-            throw new Error(`chat.handover endpoint returned ${response.status} ${response.statusText}`);
-        }
         if (!response.body) {
             throw new Error("chat.handover endpoint returned no response body");
         }
@@ -389,7 +411,17 @@ class TriggerChatTransport {
                 notifyChange(chatId, state);
             }
         };
-        return response.body
+        const emit = (event) => this.emitEvent(event);
+        const attribution = () => this.turnAttribution(chatId);
+        let sawFirstChunk = false;
+        emit({
+            type: "stream-connected",
+            chatId,
+            timestamp: Date.now(),
+            resumed: false,
+            messageId: this.lastTurnSends.get(chatId)?.messageId,
+        });
+        const piped = response.body
             .pipeThrough(new TextDecoderStream())
             .pipeThrough(parseUIMessageSseTransform())
             .pipeThrough(new TransformStream({
@@ -398,6 +430,13 @@ class TriggerChatTransport {
                     const type = chunk.type;
                     if (type === TRIGGER_TURN_COMPLETE) {
                         clearStreaming();
+                        emit({
+                            type: "turn-completed",
+                            chatId,
+                            timestamp: Date.now(),
+                            lastEventId: sessions.get(chatId)?.lastEventId,
+                            ...attribution(),
+                        });
                         return; // drop — not a real UIMessageChunk
                     }
                     if (type === TRIGGER_SESSION_STATE) {
@@ -408,12 +447,61 @@ class TriggerChatTransport {
                         return; // drop
                     }
                 }
+                if (!sawFirstChunk) {
+                    sawFirstChunk = true;
+                    emit({
+                        type: "first-chunk",
+                        chatId,
+                        timestamp: Date.now(),
+                        chunkType: chunk?.type,
+                        ...attribution(),
+                    });
+                }
                 controller.enqueue(chunk);
             },
             flush() {
                 clearStreaming();
             },
         }));
+        // Pump wrapper: a TransformStream can't observe upstream errors, so
+        // read here to emit stream-error (aborts close cleanly, matching the
+        // session subscribe path).
+        const pipedReader = piped.getReader();
+        return new ReadableStream({
+            async pull(controller) {
+                try {
+                    const next = await pipedReader.read();
+                    if (next.done) {
+                        controller.close();
+                        return;
+                    }
+                    controller.enqueue(next.value);
+                }
+                catch (error) {
+                    if (error instanceof Error && error.name === "AbortError") {
+                        try {
+                            controller.close();
+                        }
+                        catch {
+                            /* already closed */
+                        }
+                        return;
+                    }
+                    const errorStatus = error.status;
+                    emit({
+                        type: "stream-error",
+                        chatId,
+                        timestamp: Date.now(),
+                        error: error instanceof Error ? error : new Error(String(error)),
+                        status: typeof errorStatus === "number" ? errorStatus : undefined,
+                    });
+                    controller.error(error);
+                }
+            },
+            cancel(reason) {
+                return pipedReader.cancel(reason);
+            },
+        });
     }
     /**
      * Send a steering message during an active stream without disrupting
@@ -434,11 +522,12 @@ class TriggerChatTransport {
             metadata: mergedMetadata,
         };
         const partId = crypto.randomUUID();
+        const serializedBody = this.serializeInputChunk({ kind: "message", payload: wirePayload });
         const send = async (token) => {
-            await this.appendInputChunk(chatId, token, this.serializeInputChunk({ kind: "message", payload: wirePayload }), partId);
+            await this.appendInputChunk(chatId, token, serializedBody, partId);
         };
         try {
-            await this.callWithAuthRetry(chatId, state, send);
+            await this.sendWithEvents(chatId, "steer", { messageId: message.id, partId, bodyBytes: byteLength(serializedBody) }, () => this.callWithAuthRetry(chatId, state, send));
             return true;
         }
         catch {
@@ -464,6 +553,7 @@ class TriggerChatTransport {
             ? AbortSignal.any([options.abortSignal, abortController.signal])
             : abortController.signal;
         return this.subscribeToSessionStream(state, abortSignal, options.chatId, {
+            resumed: true,
             sendStopOnAbort: !!options.abortSignal,
             // Reconnect-on-reload opts into the server's settled-peek shortcut
             // so the SSE doesn't hang for 60s when no turn is in flight. Active
@@ -482,11 +572,12 @@ class TriggerChatTransport {
         if (!state)
             return false;
         const partId = crypto.randomUUID();
+        const serializedBody = this.serializeInputChunk({ kind: "stop" });
         const send = async (token) => {
-            await this.appendInputChunk(chatId, token, this.serializeInputChunk({ kind: "stop" }), partId);
+            await this.appendInputChunk(chatId, token, serializedBody, partId);
         };
         try {
-            await this.callWithAuthRetry(chatId, state, send);
+            await this.sendWithEvents(chatId, "stop", { partId, bodyBytes: byteLength(serializedBody) }, () => this.callWithAuthRetry(chatId, state, send));
         }
         catch {
             return false;
@@ -532,7 +623,7 @@ class TriggerChatTransport {
         const send = async (token) => {
             await this.appendInputChunk(chatId, token, body, partId);
         };
-        await this.callWithAuthRetry(chatId, state, send);
+        await this.sendWithEvents(chatId, "action", { partId, bodyBytes: byteLength(body) }, () => this.callWithAuthRetry(chatId, state, send));
         // Supersede any in-flight reader before subscribing — same as
         // `sendMessages`. Two concurrent readers both write `state.lastEventId`
         // and the slower one can regress the cursor, replaying records on the
@@ -568,6 +659,61 @@ class TriggerChatTransport {
     setOnSessionChange(callback) {
         this._onSessionChange = callback;
     }
+    /** Update the `onEvent` callback without recreating the transport. */
+    setOnEvent(callback) {
+        this._onEvent = callback;
+    }
+    emitEvent(event) {
+        const cb = this._onEvent;
+        if (!cb)
+            return;
+        try {
+            cb(event);
+        }
+        catch {
+            // observability must never break the chat
+        }
+    }
+    /** Run a send op, emitting the terminal message-sent / message-send-failed event. */
+    async sendWithEvents(chatId, source, extras, op) {
+        const startedAt = Date.now();
+        try {
+            await op();
+            const turnProducing = source === "submit-message" || source === "regenerate-message" || source === "head-start";
+            if (turnProducing) {
+                this.lastTurnSends.set(chatId, { messageId: extras.messageId, at: Date.now() });
+            }
+            this.emitEvent({
+                type: "message-sent",
+                chatId,
+                timestamp: Date.now(),
+                source,
+                durationMs: Date.now() - startedAt,
+                ...extras,
+            });
+        }
+        catch (error) {
+            const status = error.status;
+            this.emitEvent({
+                type: "message-send-failed",
+                chatId,
+                timestamp: Date.now(),
+                source,
+                error: error instanceof Error ? error : new Error(String(error)),
+                status: typeof status === "number" ? status : undefined,
+                durationMs: Date.now() - startedAt,
+                ...extras,
+            });
+            throw error;
+        }
+    }
+    /** Attribution fields for response-side events. */
+    turnAttribution(chatId) {
+        const lastSend = this.lastTurnSends.get(chatId);
+        if (!lastSend)
+            return {};
+        return { messageId: lastSend.messageId, sinceSendMs: Date.now() - lastSend.at };
+    }
     /**
      * Update the transport's `clientData`. Used by `useTriggerChatTransport`
      * to keep the latest value reachable from inside `startSession` and
@@ -934,6 +1080,15 @@ class TriggerChatTransport {
                             throw e;
                         }
                     }
+                    this.emitEvent({
+                        type: "stream-connected",
+                        chatId,
+                        timestamp: Date.now(),
+                        resumed: options?.resumed ?? false,
+                        lastEventId: state.lastEventId,
+                        messageId: this.lastTurnSends.get(chatId)?.messageId,
+                    });
+                    let sawFirstChunk = false;
                     while (true) {
                         let value;
                         if (primed !== undefined) {
@@ -1005,12 +1160,22 @@ class TriggerChatTransport {
                             if (refreshedToken) {
                                 state.publicAccessToken = refreshedToken;
                             }
+                            this.emitEvent({
+                                type: "turn-completed",
+                                chatId,
+                                timestamp: Date.now(),
+                                lastEventId: state.lastEventId,
+                                sessionInEventId: (0, v3_1.headerValue)(value.headers, v3_1.SESSION_IN_EVENT_ID_HEADER),
+                                ...this.turnAttribution(chatId),
+                            });
                             state.isStreaming = false;
                             this.notifySessionChange(chatId, state);
                             this.coordinator?.release(chatId);
                             this.coordinator?.broadcastSession(chatId, {
                                 lastEventId: state.lastEventId,
                             });
+                            // Re-arm per-turn events for watch mode's next turn.
+                            sawFirstChunk = false;
                             if (this.watchMode)
                                 continue;
                             internalAbort.abort();
@@ -1027,6 +1192,17 @@ class TriggerChatTransport {
                         // JSON unwrap). Drop empty/malformed payloads defensively.
                         if (value.chunk == null)
                             continue;
+                        if (!sawFirstChunk) {
+                            sawFirstChunk = true;
+                            this.emitEvent({
+                                type: "first-chunk",
+                                chatId,
+                                timestamp: Date.now(),
+                                chunkType: value.chunk.type,
+                                lastEventId: value.id || undefined,
+                                ...this.turnAttribution(chatId),
+                            });
+                        }
                         controller.enqueue(value.chunk);
                     }
                 }
@@ -1040,6 +1216,14 @@ class TriggerChatTransport {
                         }
                         return;
                     }
+                    const errorStatus = error.status;
+                    this.emitEvent({
+                        type: "stream-error",
+                        chatId,
+                        timestamp: Date.now(),
+                        error: error instanceof Error ? error : new Error(String(error)),
+                        status: typeof errorStatus === "number" ? errorStatus : undefined,
+                    });
                     controller.error(error);
                 }
                 finally {