@trigger.dev/sdk 4.7.4 → 4.7.6

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

@@ -33,6 +33,7 @@ type ChatTurnContext<TClientData = unknown> = {
     turn: number;
     continuation: boolean;
     clientData?: TClientData;
+    recordUserMessage?: boolean;
 };
 export { __readChatSnapshotProductionPathForTests, __setReadChatSnapshotImplForTests, __setWriteChatSnapshotImplForTests, __writeChatSnapshotProductionPathForTests, } from "./chatSnapshotIo.js";
 export { defaultStorage, memoryTranscriptStorage, reduceTranscriptChanges, snapshotTranscriptStorage, type LoadContextEvent, type MemoryTranscriptStorage, type TranscriptChange, type TranscriptChangeReason, type TranscriptChangeset, type TranscriptCursors, type TranscriptLoadOptions, type TranscriptLoadResult, type TranscriptScope, type TranscriptState, type TranscriptStorage, type TranscriptStorageContext, } from "./transcriptStorage.js";
@@ -1677,6 +1678,31 @@ export type ChatAgentOptions<TIdentifier extends string, TClientDataSchema exten
      * Ignored for sessions with no pin, and for sessions using `lockToVersion`.
      */
     versionSkew?: ChatVersionSkewPolicy;
+    /**
+     * Controls which chat content the chat runtime records on its spans in the run trace.
+     *
+     * - `recordUserMessage` (default `true`) records the last user message as `chat.user_message`
+     *   and as the turn span's preview text, and messages sent mid-turn as `pending.messages`.
+     * - `recordClientData` (default `true`) records the raw `clientData` sent by the frontend as
+     *   `chat.client_data`.
+     *
+     * Set either to `false` to keep that content out of telemetry. Content recorded by the AI SDK's
+     * own spans is controlled separately, through `experimental_telemetry` on the model call.
+     *
+     * @example
+     * ```ts
+     * chat.agent({
+     *   id: "my-chat",
+     *   telemetry: { recordUserMessage: false, recordClientData: false },
+     *   run: async ({ messages, signal, streamText }) =>
+     *     streamText({ model, messages, abortSignal: signal }),
+     * });
+     * ```
+     */
+    telemetry?: {
+        recordUserMessage?: boolean;
+        recordClientData?: boolean;
+    };
     /**
      * Schema for validating `clientData` from the frontend.
      * Accepts Zod, ArkType, Valibot, or any supported schema library.

package/dist/commonjs/v3/ai.js

@@ -2880,7 +2880,6 @@ async function drainSteeringQueue(config, messages, steps, queueOverride) {
     // Span attributes describe the offered batch; the chunk and callback below
     // describe what was actually claimed and injected.
     const messageTexts = uiMessages.map(textOfUIMessage);
-    const _previewText = messageTexts.length === 1 ? messageTexts[0].slice(0, 80) : `${queue.length} messages`;
     return tracer_js_1.tracer.startActiveSpan("pending message injected", async () => {
         /**
          * Claim before transforming, and inject only what was claimed.
@@ -3019,7 +3018,7 @@ async function drainSteeringQueue(config, messages, steps, queueOverride) {
             [v3_1.SemanticInternalAttributes.STYLE_ICON]: "tabler-message-forward",
             "pending.message_count": uiMessages.length,
             "pending.step_number": stepNumber,
-            "pending.messages": messageTexts,
+            ...(ctx?.recordUserMessage === false ? {} : { "pending.messages": messageTexts }),
             ...(ctx?.chatId ? { "pending.chat_id": ctx.chatId } : {}),
             ...(ctx?.turn != null ? { "pending.turn": ctx.turn } : {}),
             ...(0, v3_1.accessoryAttributes)({
@@ -3858,7 +3857,9 @@ function chatCustomAgent(options) {
     return task;
 }
 function chatAgent(options) {
-    const { run: userRun, clientDataSchema, onBoot, onRecoveryBoot, onPreload, onChatStart, onValidateMessages, hydrateMessages, storage, actionSchema, onAction, onTurnStart, onBeforeTurnComplete, onCompacted, compaction, pendingMessages: pendingMessagesConfig, prepareMessages, tools: toolsOption, onTurnComplete, maxTurns = 100, turnTimeout = "1h", idleTimeoutInSeconds = 30, chatAccessTokenTTL = "1h", preloadIdleTimeoutInSeconds, preloadTimeout, uiMessageStreamOptions, onChatSuspend, onChatResume, exitAfterPreloadIdle = false, oomMachine, registry: promptRegistry, system: agentSystem, cacheControl: agentCacheControl, systemProviderOptions: agentSystemProviderOptions, versionSkew, ...restOptions } = options;
+    const { run: userRun, clientDataSchema, onBoot, onRecoveryBoot, onPreload, onChatStart, onValidateMessages, hydrateMessages, storage, actionSchema, onAction, onTurnStart, onBeforeTurnComplete, onCompacted, compaction, pendingMessages: pendingMessagesConfig, prepareMessages, tools: toolsOption, onTurnComplete, maxTurns = 100, turnTimeout = "1h", idleTimeoutInSeconds = 30, chatAccessTokenTTL = "1h", preloadIdleTimeoutInSeconds, preloadTimeout, uiMessageStreamOptions, onChatSuspend, onChatResume, exitAfterPreloadIdle = false, oomMachine, registry: promptRegistry, system: agentSystem, cacheControl: agentCacheControl, systemProviderOptions: agentSystemProviderOptions, versionSkew, telemetry: telemetryOptions, ...restOptions } = options;
+    const recordUserMessage = telemetryOptions?.recordUserMessage ?? true;
+    const recordClientData = telemetryOptions?.recordClientData ?? true;
     if (hydrateMessages) {
         if (storage) {
             throw new Error(`chat.agent: "${options.id}" sets both \`hydrateMessages\` and \`storage\`. ` +
@@ -4995,7 +4996,7 @@ function chatAgent(options) {
                                 : "tabler-message-chatbot",
                             [v3_1.SemanticInternalAttributes.ENTITY_TYPE]: isAction ? "chat-action" : "chat-turn",
                         };
-                        if (lastUserMessage) {
+                        if (lastUserMessage && recordUserMessage) {
                             turnAttributes["chat.user_message"] = lastUserMessage;
                             // Show a truncated preview of the user message as an accessory
                             const preview = lastUserMessage.length > 80
@@ -5006,7 +5007,7 @@ function chatAgent(options) {
                                 style: "codepath",
                             }));
                         }
-                        if (wireMetadata !== undefined) {
+                        if (wireMetadata !== undefined && recordClientData) {
                             turnAttributes["chat.client_data"] =
                                 typeof wireMetadata === "string" ? wireMetadata : JSON.stringify(wireMetadata);
                         }
@@ -5031,6 +5032,7 @@ function chatAgent(options) {
                                 turn,
                                 continuation,
                                 clientData,
+                                recordUserMessage,
                             });
                             // Resolve the per-turn `tools` set now that turn context
                             // (incl. parsed clientData) exists, so every toModelMessages