@sentrial/sdk 0.4.3 → 0.4.5

package/dist/index.d.cts

@@ -270,6 +270,9 @@ declare function redactPayload(payload: Record<string, unknown>, config: PiiConf
  * calls (createSession, completeSession) bypass the batcher entirely
  * because they need synchronous responses.
  *
+ * Events are delivered in enqueue order so server-assigned sequence numbers
+ * match the order an agent actually executed steps.
+ *
  * Flush triggers:
  *  1. Timer — every `flushIntervalMs` (default 1 000 ms)
  *  2. Queue size — when queue reaches `flushThreshold` (default 10)
@@ -312,7 +315,7 @@ declare class EventBatcher {
     /**
      * Flush all queued events to the API.
      *
-     * Drains the queue and fires all requests in parallel. Safe to call
+     * Drains the queue and sends requests in enqueue order. Safe to call
      * concurrently — only one flush runs at a time.
      */
     flush(): Promise<void>;
@@ -385,6 +388,8 @@ interface CreateSessionParams {
     convoId?: string;
     /** Optional metadata */
     metadata?: Record<string, unknown>;
+    /** Production experiment assignment ids to link to this session */
+    experimentAssignmentIds?: string[];
 }
 /**
  * Parameters for completing a session
@@ -582,6 +587,50 @@ interface FinishParams {
     /** Duration in milliseconds (auto-calculated from begin/finish if not provided) */
     durationMs?: number;
 }
+interface ProductionVariantConfig {
+    name: string;
+    weight?: number;
+    prompt?: string;
+    systemPrompt?: string;
+    model?: string;
+    promptVersion?: string;
+    toolConfig?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface GetVariantParams {
+    /** Production experiment name configured in Sentrial */
+    experimentName: string;
+    /** Agent name this variant is for */
+    agentName?: string;
+    /** External user id for sticky bucketing */
+    userId?: string;
+    /** Conversation id for sticky multi-turn bucketing */
+    convoId?: string;
+    /** Stable anonymous id if no user/conversation id exists */
+    anonymousId?: string;
+    /** Optional existing Sentrial session id */
+    sessionId?: string;
+    /** Variant to use when no active live experiment matches */
+    defaultVariant?: string;
+    /** Prompt version currently running in the customer app */
+    promptVersion?: string;
+    /** Model currently running in the customer app */
+    model?: string;
+    /** Extra assignment metadata */
+    metadata?: Record<string, unknown>;
+}
+interface VariantAssignment {
+    active: boolean;
+    reason: 'assigned' | 'holdout' | 'not_found';
+    experimentId?: string;
+    assignmentId?: string;
+    variant: string;
+    variantConfig?: ProductionVariantConfig;
+    prompt?: string;
+    systemPrompt?: string;
+    model?: string;
+    promptVersion?: string;
+}
 /**
  * Parameters for cost calculation
  */
@@ -719,6 +768,7 @@ declare class SentrialClient {
     private piiHydrationPromise?;
     private readonly _stateVar;
     private readonly batcher?;
+    private pendingExperimentAssignmentIds;
     /** Per-session cost/token accumulator — populated by trackToolCall/trackDecision */
     private sessionAccumulators;
     private get currentState();
@@ -747,6 +797,13 @@ declare class SentrialClient {
      * @returns Session ID, or null if the request failed and failSilently is true
      */
     createSession(params: CreateSessionParams): Promise<string | null>;
+    /**
+     * Get a sticky production experiment variant for this user/conversation.
+     *
+     * The returned assignment id is automatically linked to the next session
+     * created by this client. You can also pass `sessionId` to link immediately.
+     */
+    getVariant(params: GetVariantParams): Promise<VariantAssignment>;
     /**
      * Track a tool call event
      *
@@ -986,6 +1043,7 @@ declare function configure(config: SentrialClientConfig): void;
  * ```
  */
 declare function begin(params: BeginParams): Promise<Interaction>;
+declare function getVariant(params: GetVariantParams): Promise<VariantAssignment>;
 /**
  * Simple API namespace for module-level usage
  */
@@ -994,6 +1052,7 @@ declare function shutdown(): Promise<void>;
 declare const sentrial: {
     configure: typeof configure;
     begin: typeof begin;
+    getVariant: typeof getVariant;
     flush: typeof flush;
     shutdown: typeof shutdown;
 };
@@ -1187,11 +1246,13 @@ type StreamTextResult = {
     }>;
     [key: string]: unknown;
 };
+/** String or function that returns a string (for dynamic per-request values) */
+type StringOrFn = string | (() => string | undefined);
 /** Per-instance config passed through closures (not global) */
 type WrapperConfig = {
     defaultAgent?: string;
-    userId?: string;
-    convoId?: string;
+    userId?: StringOrFn;
+    convoId?: StringOrFn;
 };
 /**
  * Configure the Sentrial SDK for Vercel AI SDK integration.
@@ -1211,8 +1272,8 @@ declare function configureVercel(config: {
     apiKey?: string;
     apiUrl?: string;
     defaultAgent?: string;
-    userId?: string;
-    convoId?: string;
+    userId?: StringOrFn;
+    convoId?: StringOrFn;
     failSilently?: boolean;
 }): void;
 declare function wrapGenerateText(originalFn: Function, client: SentrialClient, config: WrapperConfig): (params: GenerateTextParams) => Promise<GenerateTextResult>;
@@ -1246,8 +1307,8 @@ declare function wrapStreamObject(originalFn: Function, client: SentrialClient,
 declare function wrapAISDK(ai: AIModule, options?: {
     client?: SentrialClient;
     defaultAgent?: string;
-    userId?: string;
-    convoId?: string;
+    userId?: StringOrFn;
+    convoId?: StringOrFn;
 }): {
     generateText: ReturnType<typeof wrapGenerateText>;
     streamText: ReturnType<typeof wrapStreamText>;
@@ -1887,4 +1948,4 @@ declare class Experiment {
     getResults(): Promise<ExperimentResults | null>;
 }
 
-export { ApiError, type ApiResponse, type BatcherConfig, type BeginParams, type CompleteSessionParams, type ContextToken, type ContextVar, type CostParams, type CreateSessionParams, type Event, EventBatcher, EventType, Experiment, type ExperimentContext, type ExperimentResults, type ExperimentRunResult, ExperimentRunTracker, type ExperimentTestCase, type ExperimentVariant, type FinishParams, type GenerateTextParams, type GenerateTextResult, Interaction, NetworkError, type PiiBuiltinPatterns, type PiiConfig, type PiiCustomPattern, type PiiField, type PiiMode, SentrialClient, type SentrialClientConfig, SentrialError, type Session, SessionContext, type SessionStatus, type StreamTextResult, Tool, type TrackDecisionParams, type TrackErrorParams, TrackSession, type TrackToolCallParams, ValidationError, type WrapClaudeAgentOptions, begin, calculateAnthropicCost, calculateGoogleCost, calculateOpenAICost, clearExperimentContext, clearSessionContext, configure, configureVercel, createContextVar, getCurrentInteraction, getCurrentSessionId, getExperimentContext, getExperimentId, getSessionContext, getSystemPrompt, getVariantName, hashValue, isExperimentMode, redactPayload, redactString, redactValue, replaceMatch, sentrial, setClient, setDefaultClient, setExperimentContext, setSessionContext, withSession, withTool, wrapAISDK, wrapAnthropic, wrapClaudeAgent, wrapGoogle, wrapLLM, wrapOpenAI };
+export { ApiError, type ApiResponse, type BatcherConfig, type BeginParams, type CompleteSessionParams, type ContextToken, type ContextVar, type CostParams, type CreateSessionParams, type Event, EventBatcher, EventType, Experiment, type ExperimentContext, type ExperimentResults, type ExperimentRunResult, ExperimentRunTracker, type ExperimentTestCase, type ExperimentVariant, type FinishParams, type GenerateTextParams, type GenerateTextResult, type GetVariantParams, Interaction, NetworkError, type PiiBuiltinPatterns, type PiiConfig, type PiiCustomPattern, type PiiField, type PiiMode, type ProductionVariantConfig, SentrialClient, type SentrialClientConfig, SentrialError, type Session, SessionContext, type SessionStatus, type StreamTextResult, Tool, type TrackDecisionParams, type TrackErrorParams, TrackSession, type TrackToolCallParams, ValidationError, type VariantAssignment, type WrapClaudeAgentOptions, begin, calculateAnthropicCost, calculateGoogleCost, calculateOpenAICost, clearExperimentContext, clearSessionContext, configure, configureVercel, createContextVar, getCurrentInteraction, getCurrentSessionId, getExperimentContext, getExperimentId, getSessionContext, getSystemPrompt, getVariant, getVariantName, hashValue, isExperimentMode, redactPayload, redactString, redactValue, replaceMatch, sentrial, setClient, setDefaultClient, setExperimentContext, setSessionContext, withSession, withTool, wrapAISDK, wrapAnthropic, wrapClaudeAgent, wrapGoogle, wrapLLM, wrapOpenAI };

package/dist/index.d.ts

@@ -270,6 +270,9 @@ declare function redactPayload(payload: Record<string, unknown>, config: PiiConf
  * calls (createSession, completeSession) bypass the batcher entirely
  * because they need synchronous responses.
  *
+ * Events are delivered in enqueue order so server-assigned sequence numbers
+ * match the order an agent actually executed steps.
+ *
  * Flush triggers:
  *  1. Timer — every `flushIntervalMs` (default 1 000 ms)
  *  2. Queue size — when queue reaches `flushThreshold` (default 10)
@@ -312,7 +315,7 @@ declare class EventBatcher {
     /**
      * Flush all queued events to the API.
      *
-     * Drains the queue and fires all requests in parallel. Safe to call
+     * Drains the queue and sends requests in enqueue order. Safe to call
      * concurrently — only one flush runs at a time.
      */
     flush(): Promise<void>;
@@ -385,6 +388,8 @@ interface CreateSessionParams {
     convoId?: string;
     /** Optional metadata */
     metadata?: Record<string, unknown>;
+    /** Production experiment assignment ids to link to this session */
+    experimentAssignmentIds?: string[];
 }
 /**
  * Parameters for completing a session
@@ -582,6 +587,50 @@ interface FinishParams {
     /** Duration in milliseconds (auto-calculated from begin/finish if not provided) */
     durationMs?: number;
 }
+interface ProductionVariantConfig {
+    name: string;
+    weight?: number;
+    prompt?: string;
+    systemPrompt?: string;
+    model?: string;
+    promptVersion?: string;
+    toolConfig?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface GetVariantParams {
+    /** Production experiment name configured in Sentrial */
+    experimentName: string;
+    /** Agent name this variant is for */
+    agentName?: string;
+    /** External user id for sticky bucketing */
+    userId?: string;
+    /** Conversation id for sticky multi-turn bucketing */
+    convoId?: string;
+    /** Stable anonymous id if no user/conversation id exists */
+    anonymousId?: string;
+    /** Optional existing Sentrial session id */
+    sessionId?: string;
+    /** Variant to use when no active live experiment matches */
+    defaultVariant?: string;
+    /** Prompt version currently running in the customer app */
+    promptVersion?: string;
+    /** Model currently running in the customer app */
+    model?: string;
+    /** Extra assignment metadata */
+    metadata?: Record<string, unknown>;
+}
+interface VariantAssignment {
+    active: boolean;
+    reason: 'assigned' | 'holdout' | 'not_found';
+    experimentId?: string;
+    assignmentId?: string;
+    variant: string;
+    variantConfig?: ProductionVariantConfig;
+    prompt?: string;
+    systemPrompt?: string;
+    model?: string;
+    promptVersion?: string;
+}
 /**
  * Parameters for cost calculation
  */
@@ -719,6 +768,7 @@ declare class SentrialClient {
     private piiHydrationPromise?;
     private readonly _stateVar;
     private readonly batcher?;
+    private pendingExperimentAssignmentIds;
     /** Per-session cost/token accumulator — populated by trackToolCall/trackDecision */
     private sessionAccumulators;
     private get currentState();
@@ -747,6 +797,13 @@ declare class SentrialClient {
      * @returns Session ID, or null if the request failed and failSilently is true
      */
     createSession(params: CreateSessionParams): Promise<string | null>;
+    /**
+     * Get a sticky production experiment variant for this user/conversation.
+     *
+     * The returned assignment id is automatically linked to the next session
+     * created by this client. You can also pass `sessionId` to link immediately.
+     */
+    getVariant(params: GetVariantParams): Promise<VariantAssignment>;
     /**
      * Track a tool call event
      *
@@ -986,6 +1043,7 @@ declare function configure(config: SentrialClientConfig): void;
  * ```
  */
 declare function begin(params: BeginParams): Promise<Interaction>;
+declare function getVariant(params: GetVariantParams): Promise<VariantAssignment>;
 /**
  * Simple API namespace for module-level usage
  */
@@ -994,6 +1052,7 @@ declare function shutdown(): Promise<void>;
 declare const sentrial: {
     configure: typeof configure;
     begin: typeof begin;
+    getVariant: typeof getVariant;
     flush: typeof flush;
     shutdown: typeof shutdown;
 };
@@ -1187,11 +1246,13 @@ type StreamTextResult = {
     }>;
     [key: string]: unknown;
 };
+/** String or function that returns a string (for dynamic per-request values) */
+type StringOrFn = string | (() => string | undefined);
 /** Per-instance config passed through closures (not global) */
 type WrapperConfig = {
     defaultAgent?: string;
-    userId?: string;
-    convoId?: string;
+    userId?: StringOrFn;
+    convoId?: StringOrFn;
 };
 /**
  * Configure the Sentrial SDK for Vercel AI SDK integration.
@@ -1211,8 +1272,8 @@ declare function configureVercel(config: {
     apiKey?: string;
     apiUrl?: string;
     defaultAgent?: string;
-    userId?: string;
-    convoId?: string;
+    userId?: StringOrFn;
+    convoId?: StringOrFn;
     failSilently?: boolean;
 }): void;
 declare function wrapGenerateText(originalFn: Function, client: SentrialClient, config: WrapperConfig): (params: GenerateTextParams) => Promise<GenerateTextResult>;
@@ -1246,8 +1307,8 @@ declare function wrapStreamObject(originalFn: Function, client: SentrialClient,
 declare function wrapAISDK(ai: AIModule, options?: {
     client?: SentrialClient;
     defaultAgent?: string;
-    userId?: string;
-    convoId?: string;
+    userId?: StringOrFn;
+    convoId?: StringOrFn;
 }): {
     generateText: ReturnType<typeof wrapGenerateText>;
     streamText: ReturnType<typeof wrapStreamText>;
@@ -1887,4 +1948,4 @@ declare class Experiment {
     getResults(): Promise<ExperimentResults | null>;
 }
 
-export { ApiError, type ApiResponse, type BatcherConfig, type BeginParams, type CompleteSessionParams, type ContextToken, type ContextVar, type CostParams, type CreateSessionParams, type Event, EventBatcher, EventType, Experiment, type ExperimentContext, type ExperimentResults, type ExperimentRunResult, ExperimentRunTracker, type ExperimentTestCase, type ExperimentVariant, type FinishParams, type GenerateTextParams, type GenerateTextResult, Interaction, NetworkError, type PiiBuiltinPatterns, type PiiConfig, type PiiCustomPattern, type PiiField, type PiiMode, SentrialClient, type SentrialClientConfig, SentrialError, type Session, SessionContext, type SessionStatus, type StreamTextResult, Tool, type TrackDecisionParams, type TrackErrorParams, TrackSession, type TrackToolCallParams, ValidationError, type WrapClaudeAgentOptions, begin, calculateAnthropicCost, calculateGoogleCost, calculateOpenAICost, clearExperimentContext, clearSessionContext, configure, configureVercel, createContextVar, getCurrentInteraction, getCurrentSessionId, getExperimentContext, getExperimentId, getSessionContext, getSystemPrompt, getVariantName, hashValue, isExperimentMode, redactPayload, redactString, redactValue, replaceMatch, sentrial, setClient, setDefaultClient, setExperimentContext, setSessionContext, withSession, withTool, wrapAISDK, wrapAnthropic, wrapClaudeAgent, wrapGoogle, wrapLLM, wrapOpenAI };
+export { ApiError, type ApiResponse, type BatcherConfig, type BeginParams, type CompleteSessionParams, type ContextToken, type ContextVar, type CostParams, type CreateSessionParams, type Event, EventBatcher, EventType, Experiment, type ExperimentContext, type ExperimentResults, type ExperimentRunResult, ExperimentRunTracker, type ExperimentTestCase, type ExperimentVariant, type FinishParams, type GenerateTextParams, type GenerateTextResult, type GetVariantParams, Interaction, NetworkError, type PiiBuiltinPatterns, type PiiConfig, type PiiCustomPattern, type PiiField, type PiiMode, type ProductionVariantConfig, SentrialClient, type SentrialClientConfig, SentrialError, type Session, SessionContext, type SessionStatus, type StreamTextResult, Tool, type TrackDecisionParams, type TrackErrorParams, TrackSession, type TrackToolCallParams, ValidationError, type VariantAssignment, type WrapClaudeAgentOptions, begin, calculateAnthropicCost, calculateGoogleCost, calculateOpenAICost, clearExperimentContext, clearSessionContext, configure, configureVercel, createContextVar, getCurrentInteraction, getCurrentSessionId, getExperimentContext, getExperimentId, getSessionContext, getSystemPrompt, getVariant, getVariantName, hashValue, isExperimentMode, redactPayload, redactString, redactValue, replaceMatch, sentrial, setClient, setDefaultClient, setExperimentContext, setSessionContext, withSession, withTool, wrapAISDK, wrapAnthropic, wrapClaudeAgent, wrapGoogle, wrapLLM, wrapOpenAI };

package/dist/index.js

@@ -70,7 +70,7 @@ var ValidationError = class extends SentrialError {
 // src/redact.ts
 var _createHash;
 try {
-  const mod = eval("require")("crypto");
+  const mod = new Function('return require("crypto")')();
   if (mod?.createHash) {
     _createHash = mod.createHash;
   }
@@ -175,7 +175,7 @@ function redactPayload(payload, config) {
 // src/async-context.ts
 var _AsyncLocalStorage = null;
 try {
-  const mod = eval("require")("node:async_hooks");
+  const mod = new Function('return require("node:async_hooks")')();
   if (mod?.AsyncLocalStorage) {
     _AsyncLocalStorage = mod.AsyncLocalStorage;
   }
@@ -325,6 +325,9 @@ function getSessionContext() {
 function setDefaultClient(client) {
   _defaultClient = client;
 }
+function getDefaultClient() {
+  return _defaultClient;
+}
 function _setSessionContextWithTokens(sessionId, client) {
   const _sessionToken = _currentSessionId.set(sessionId);
   const _clientToken = client ? _currentClient.set(client) : _currentClient.set(_currentClient.get());
@@ -882,7 +885,7 @@ var EventBatcher = class {
   /**
    * Flush all queued events to the API.
    *
-   * Drains the queue and fires all requests in parallel. Safe to call
+   * Drains the queue and sends requests in enqueue order. Safe to call
    * concurrently — only one flush runs at a time.
    */
   async flush() {
@@ -890,15 +893,15 @@ var EventBatcher = class {
     this.flushing = true;
     const batch = this.queue.splice(0, this.queue.length);
     try {
-      await Promise.all(
-        batch.map(
-          (event) => this.sendFn(event.method, event.url, event.body).catch((err) => {
-            if (typeof console !== "undefined") {
-              console.warn("Sentrial: Batched event failed:", err);
-            }
-          })
-        )
-      );
+      for (const event of batch) {
+        try {
+          await this.sendFn(event.method, event.url, event.body);
+        } catch (err) {
+          if (typeof console !== "undefined") {
+            console.warn("Sentrial: Batched event failed:", err);
+          }
+        }
+      }
     } finally {
       this.flushing = false;
     }
@@ -951,6 +954,7 @@ var SentrialClient = class {
   piiHydrationPromise;
   _stateVar = createContextVar({});
   batcher;
+  pendingExperimentAssignmentIds = [];
   /** Per-session cost/token accumulator — populated by trackToolCall/trackDecision */
   sessionAccumulators = /* @__PURE__ */ new Map();
   get currentState() {
@@ -1101,12 +1105,12 @@ var SentrialClient = class {
         }
       }
     }
-    const networkError = new NetworkError(
-      lastError?.message ?? "Unknown network error",
-      lastError
-    );
+    const networkError = new NetworkError(lastError?.message ?? "Unknown network error", lastError);
     if (this.failSilently) {
-      console.warn(`Sentrial: Request failed after ${MAX_RETRIES + 1} attempts (${method} ${url}):`, networkError.message);
+      console.warn(
+        `Sentrial: Request failed after ${MAX_RETRIES + 1} attempts (${method} ${url}):`,
+        networkError.message
+      );
       return null;
     }
     throw networkError;
@@ -1149,13 +1153,53 @@ var SentrialClient = class {
     if (params.convoId) {
       payload.convoId = params.convoId;
     }
+    const experimentAssignmentIds = [
+      ...params.experimentAssignmentIds || [],
+      ...this.pendingExperimentAssignmentIds
+    ];
+    if (experimentAssignmentIds.length > 0) {
+      payload.experimentAssignmentIds = Array.from(new Set(experimentAssignmentIds));
+      payload.metadata = {
+        ...params.metadata || {},
+        sentrial_experiment_assignment_ids: payload.experimentAssignmentIds
+      };
+    }
     const response = await this.safeRequest(
       "POST",
       `${this.apiUrl}/api/sdk/sessions`,
       payload
     );
+    if (response?.id && experimentAssignmentIds.length > 0) {
+      this.pendingExperimentAssignmentIds = [];
+    }
     return response?.id ?? null;
   }
+  /**
+   * Get a sticky production experiment variant for this user/conversation.
+   *
+   * The returned assignment id is automatically linked to the next session
+   * created by this client. You can also pass `sessionId` to link immediately.
+   */
+  async getVariant(params) {
+    const fallback = {
+      active: false,
+      reason: "not_found",
+      variant: params.defaultVariant || "control"
+    };
+    const response = await this.safeRequest(
+      "POST",
+      `${this.apiUrl}/api/sdk/experiments/variant`,
+      {
+        ...params,
+        sdkName: "@sentrial/sdk"
+      }
+    );
+    if (!response) return fallback;
+    if (response.active && response.assignmentId && !params.sessionId) {
+      this.pendingExperimentAssignmentIds.push(response.assignmentId);
+    }
+    return response;
+  }
   /**
    * Track a tool call event
    *
@@ -1264,11 +1308,9 @@ var SentrialClient = class {
    * @returns Updated session or null on error
    */
   async setInput(sessionId, input) {
-    return this.safeRequest(
-      "PATCH",
-      `${this.apiUrl}/api/sdk/sessions/${sessionId}`,
-      { userInput: input }
-    );
+    return this.safeRequest("PATCH", `${this.apiUrl}/api/sdk/sessions/${sessionId}`, {
+      userInput: input
+    });
   }
   /**
    * Track a generic event
@@ -1328,10 +1370,14 @@ var SentrialClient = class {
     }
     const acc = this.sessionAccumulators.get(params.sessionId);
     if (acc) {
-      if (params.estimatedCost === void 0 && acc.cost > 0) params = { ...params, estimatedCost: acc.cost };
-      if (params.promptTokens === void 0 && acc.promptTokens > 0) params = { ...params, promptTokens: acc.promptTokens };
-      if (params.completionTokens === void 0 && acc.completionTokens > 0) params = { ...params, completionTokens: acc.completionTokens };
-      if (params.totalTokens === void 0 && acc.totalTokens > 0) params = { ...params, totalTokens: acc.totalTokens };
+      if (params.estimatedCost === void 0 && acc.cost > 0)
+        params = { ...params, estimatedCost: acc.cost };
+      if (params.promptTokens === void 0 && acc.promptTokens > 0)
+        params = { ...params, promptTokens: acc.promptTokens };
+      if (params.completionTokens === void 0 && acc.completionTokens > 0)
+        params = { ...params, completionTokens: acc.completionTokens };
+      if (params.totalTokens === void 0 && acc.totalTokens > 0)
+        params = { ...params, totalTokens: acc.totalTokens };
       this.sessionAccumulators.delete(params.sessionId);
     }
     const payload = {
@@ -1565,10 +1611,14 @@ function getClient() {
 }
 function configure(config) {
   defaultClient = new SentrialClient(config);
+  setDefaultClient(defaultClient);
 }
 function begin(params) {
   return getClient().begin(params);
 }
+function getVariant(params) {
+  return getClient().getVariant(params);
+}
 async function flush() {
   if (defaultClient) await defaultClient.flush();
 }
@@ -1578,11 +1628,16 @@ async function shutdown() {
 var sentrial = {
   configure,
   begin,
+  getVariant,
   flush,
   shutdown
 };
 
 // src/vercel.ts
+function resolveStringOrFn(value, fallback) {
+  if (typeof value === "function") return value() ?? fallback;
+  return value ?? fallback;
+}
 var _defaultClient2 = null;
 var _globalConfig = {};
 function configureVercel(config) {
@@ -1591,6 +1646,7 @@ function configureVercel(config) {
     apiUrl: config.apiUrl,
     failSilently: config.failSilently ?? true
   });
+  setDefaultClient(_defaultClient2);
   _globalConfig = {
     defaultAgent: config.defaultAgent,
     userId: config.userId,
@@ -1640,14 +1696,26 @@ function calculateCostForCall(provider, modelId, promptTokens, completionTokens)
       return 0;
   }
 }
+function extractContentText(content) {
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    const textParts = content.filter((part) => part && part.type === "text" && typeof part.text === "string").map((part) => part.text);
+    if (textParts.length > 0) return textParts.join("\n");
+  }
+  return JSON.stringify(content);
+}
 function extractInput(params) {
   if (params.prompt) return params.prompt;
   if (params.messages && params.messages.length > 0) {
     const lastUserMessage = [...params.messages].reverse().find((m) => m.role === "user");
     if (lastUserMessage) {
-      return typeof lastUserMessage.content === "string" ? lastUserMessage.content : JSON.stringify(lastUserMessage.content);
+      return extractContentText(lastUserMessage.content);
     }
-    return JSON.stringify(params.messages);
+    const lastNonSystem = [...params.messages].reverse().find((m) => m.role !== "system");
+    if (lastNonSystem) {
+      return extractContentText(lastNonSystem.content);
+    }
+    return "";
   }
   return "";
 }
@@ -1761,8 +1829,8 @@ function wrapGenerateText(originalFn, client, config) {
     const sessionId = await client.createSession({
       name: `generateText: ${input.slice(0, 50)}${input.length > 50 ? "..." : ""}`,
       agentName: config.defaultAgent ?? "vercel-ai-sdk",
-      userId: config.userId ?? "anonymous",
-      convoId: config.convoId,
+      userId: resolveStringOrFn(config.userId, "anonymous"),
+      convoId: resolveStringOrFn(config.convoId),
       metadata: {
         model: modelId,
         provider,
@@ -1862,6 +1930,7 @@ function wrapStreamText(originalFn, client, config) {
     const { modelId, provider } = extractModelInfo(params.model);
     const input = extractInput(params);
     let sessionId = null;
+    let sessionCompleted = false;
     let resolveSessionReady;
     const sessionReady = new Promise((resolve) => {
       resolveSessionReady = resolve;
@@ -1871,8 +1940,8 @@ function wrapStreamText(originalFn, client, config) {
         const id = await client.createSession({
           name: `streamText: ${input.slice(0, 50)}${input.length > 50 ? "..." : ""}`,
           agentName: config.defaultAgent ?? "vercel-ai-sdk",
-          userId: config.userId ?? "anonymous",
-          convoId: config.convoId,
+          userId: resolveStringOrFn(config.userId, "anonymous"),
+          convoId: resolveStringOrFn(config.convoId),
           metadata: {
             model: modelId,
             provider,
@@ -1928,7 +1997,8 @@ function wrapStreamText(originalFn, client, config) {
       },
       onFinish: async (event) => {
         await sessionReady;
-        if (sessionId) {
+        if (sessionId && !sessionCompleted) {
+          sessionCompleted = true;
           const durationMs = Date.now() - startTime;
           const usage = normalizeUsage(event.totalUsage ?? event.usage);
           const resolvedModelId = event.response?.modelId ?? modelId;
@@ -1958,7 +2028,8 @@ function wrapStreamText(originalFn, client, config) {
       },
       onError: async (event) => {
         await sessionReady;
-        if (sessionId) {
+        if (sessionId && !sessionCompleted) {
+          sessionCompleted = true;
           const durationMs = Date.now() - startTime;
           const msg = event.error?.message ?? "Unknown error";
           await client.trackError({
@@ -2008,8 +2079,8 @@ function wrapGenerateObject(originalFn, client, config) {
     const sessionId = await client.createSession({
       name: `generateObject: ${input.slice(0, 50)}${input.length > 50 ? "..." : ""}`,
       agentName: config.defaultAgent ?? "vercel-ai-sdk",
-      userId: config.userId ?? "anonymous",
-      convoId: config.convoId,
+      userId: resolveStringOrFn(config.userId, "anonymous"),
+      convoId: resolveStringOrFn(config.convoId),
       metadata: {
         model: modelId,
         provider,
@@ -2084,8 +2155,8 @@ function wrapStreamObject(originalFn, client, config) {
         const id = await client.createSession({
           name: `streamObject: ${input.slice(0, 50)}${input.length > 50 ? "..." : ""}`,
           agentName: config.defaultAgent ?? "vercel-ai-sdk",
-          userId: config.userId ?? "anonymous",
-          convoId: config.convoId,
+          userId: resolveStringOrFn(config.userId, "anonymous"),
+          convoId: resolveStringOrFn(config.convoId),
           metadata: {
             model: modelId,
             provider,
@@ -2375,6 +2446,11 @@ function wrapClaudeAgent(queryFn, wrapOptions) {
 var _defaultClient3 = null;
 var _currentInteraction = createContextVar(null);
 function getClient3() {
+  const configuredClient = getDefaultClient();
+  if (configuredClient) {
+    _defaultClient3 = configuredClient;
+    return configuredClient;
+  }
   if (!_defaultClient3) {
     try {
       _defaultClient3 = new SentrialClient();
@@ -3142,6 +3218,7 @@ export {
   getExperimentId,
   getSessionContext,
   getSystemPrompt,
+  getVariant,
   getVariantName,
   hashValue,
   isExperimentMode,