@sentrial/sdk 0.5.0 → 0.6.0

package/dist/index.d.cts

@@ -1018,15 +1018,32 @@ declare class ValidationError extends SentrialError {
  */
 
 type AnyFunction = (...args: unknown[]) => unknown;
+type AISDKFunction = (...args: never[]) => unknown;
 type AIModule = {
-    generateText?: AnyFunction;
-    streamText?: AnyFunction;
-    generateObject?: AnyFunction;
-    streamObject?: AnyFunction;
-    experimental_generateText?: AnyFunction;
-    experimental_streamText?: AnyFunction;
-    experimental_generateObject?: AnyFunction;
-    experimental_streamObject?: AnyFunction;
+    generateText?: AISDKFunction;
+    streamText?: AISDKFunction;
+    generateObject?: AISDKFunction;
+    streamObject?: AISDKFunction;
+    experimental_generateText?: AISDKFunction;
+    experimental_streamText?: AISDKFunction;
+    experimental_generateObject?: AISDKFunction;
+    experimental_streamObject?: AISDKFunction;
+};
+type WrappedFunction<T, Stable extends PropertyKey, Experimental extends PropertyKey, Fallback> = T extends Record<Stable, infer F extends AISDKFunction> ? F : T extends Record<Experimental, infer F extends AISDKFunction> ? F : Fallback;
+type WrappedAISDK<T extends AIModule> = {
+    generateText: WrappedFunction<T, 'generateText', 'experimental_generateText', ReturnType<typeof wrapGenerateText>>;
+    streamText: WrappedFunction<T, 'streamText', 'experimental_streamText', ReturnType<typeof wrapStreamText>>;
+    generateObject: WrappedFunction<T, 'generateObject', 'experimental_generateObject', ReturnType<typeof wrapGenerateObject>>;
+    streamObject: WrappedFunction<T, 'streamObject', 'experimental_streamObject', ReturnType<typeof wrapStreamObject>>;
+};
+type WrapAISDKOptions = {
+    client?: SentrialClient;
+    defaultAgent?: string;
+    userId?: StringOrFn;
+    convoId?: StringOrFn;
+    /** Session metadata, including explicit signalActionId / signalWorkflow when known.
+     * Create a separate wrapper for each business action; no identity is inferred. */
+    metadata?: Record<string, unknown>;
 };
 type GenerateTextParams = {
     model: {
@@ -1131,6 +1148,7 @@ type WrapperConfig = {
     defaultAgent?: string;
     userId?: StringOrFn;
     convoId?: StringOrFn;
+    metadata?: Record<string, unknown>;
 };
 /**
  * Configure the Sentrial SDK for Vercel AI SDK integration.
@@ -1182,17 +1200,7 @@ declare function wrapStreamObject(originalFn: AnyFunction, client: SentrialClien
  * const { generateText } = wrapAISDK(ai, { client, defaultAgent: 'my-agent' });
  * ```
  */
-declare function wrapAISDK(ai: AIModule, options?: {
-    client?: SentrialClient;
-    defaultAgent?: string;
-    userId?: StringOrFn;
-    convoId?: StringOrFn;
-}): {
-    generateText: ReturnType<typeof wrapGenerateText>;
-    streamText: ReturnType<typeof wrapStreamText>;
-    generateObject: ReturnType<typeof wrapGenerateObject>;
-    streamObject: ReturnType<typeof wrapStreamObject>;
-};
+declare function wrapAISDK<T extends AIModule>(ai: T, options?: WrapAISDKOptions): WrappedAISDK<T>;
 
 /**
  * Options shape accepted by {@link getVariantForAISDK} — a permissive subset of

package/dist/index.d.ts

@@ -1018,15 +1018,32 @@ declare class ValidationError extends SentrialError {
  */
 
 type AnyFunction = (...args: unknown[]) => unknown;
+type AISDKFunction = (...args: never[]) => unknown;
 type AIModule = {
-    generateText?: AnyFunction;
-    streamText?: AnyFunction;
-    generateObject?: AnyFunction;
-    streamObject?: AnyFunction;
-    experimental_generateText?: AnyFunction;
-    experimental_streamText?: AnyFunction;
-    experimental_generateObject?: AnyFunction;
-    experimental_streamObject?: AnyFunction;
+    generateText?: AISDKFunction;
+    streamText?: AISDKFunction;
+    generateObject?: AISDKFunction;
+    streamObject?: AISDKFunction;
+    experimental_generateText?: AISDKFunction;
+    experimental_streamText?: AISDKFunction;
+    experimental_generateObject?: AISDKFunction;
+    experimental_streamObject?: AISDKFunction;
+};
+type WrappedFunction<T, Stable extends PropertyKey, Experimental extends PropertyKey, Fallback> = T extends Record<Stable, infer F extends AISDKFunction> ? F : T extends Record<Experimental, infer F extends AISDKFunction> ? F : Fallback;
+type WrappedAISDK<T extends AIModule> = {
+    generateText: WrappedFunction<T, 'generateText', 'experimental_generateText', ReturnType<typeof wrapGenerateText>>;
+    streamText: WrappedFunction<T, 'streamText', 'experimental_streamText', ReturnType<typeof wrapStreamText>>;
+    generateObject: WrappedFunction<T, 'generateObject', 'experimental_generateObject', ReturnType<typeof wrapGenerateObject>>;
+    streamObject: WrappedFunction<T, 'streamObject', 'experimental_streamObject', ReturnType<typeof wrapStreamObject>>;
+};
+type WrapAISDKOptions = {
+    client?: SentrialClient;
+    defaultAgent?: string;
+    userId?: StringOrFn;
+    convoId?: StringOrFn;
+    /** Session metadata, including explicit signalActionId / signalWorkflow when known.
+     * Create a separate wrapper for each business action; no identity is inferred. */
+    metadata?: Record<string, unknown>;
 };
 type GenerateTextParams = {
     model: {
@@ -1131,6 +1148,7 @@ type WrapperConfig = {
     defaultAgent?: string;
     userId?: StringOrFn;
     convoId?: StringOrFn;
+    metadata?: Record<string, unknown>;
 };
 /**
  * Configure the Sentrial SDK for Vercel AI SDK integration.
@@ -1182,17 +1200,7 @@ declare function wrapStreamObject(originalFn: AnyFunction, client: SentrialClien
  * const { generateText } = wrapAISDK(ai, { client, defaultAgent: 'my-agent' });
  * ```
  */
-declare function wrapAISDK(ai: AIModule, options?: {
-    client?: SentrialClient;
-    defaultAgent?: string;
-    userId?: StringOrFn;
-    convoId?: StringOrFn;
-}): {
-    generateText: ReturnType<typeof wrapGenerateText>;
-    streamText: ReturnType<typeof wrapStreamText>;
-    generateObject: ReturnType<typeof wrapGenerateObject>;
-    streamObject: ReturnType<typeof wrapStreamObject>;
-};
+declare function wrapAISDK<T extends AIModule>(ai: T, options?: WrapAISDKOptions): WrappedAISDK<T>;
 
 /**
  * Options shape accepted by {@link getVariantForAISDK} — a permissive subset of

package/dist/index.js

@@ -319,7 +319,7 @@ function createContextVar(defaultValue) {
 
 // src/pricing.json
 var pricing_default = {
-  _comment: "Canonical LLM pricing table, per 1,000,000 tokens (USD). Single source of truth for @sentrial/sdk (src/cost.ts imports this file directly) and the Python sentrial SDK (sentrial/pricing.py holds a per-1K mirror guarded by tests/test_pricing_sync.py). Update prices HERE; the Python drift test fails CI if the mirror falls out of sync. Updated Jan 2026.",
+  _comment: "Canonical LLM pricing table, per 1,000,000 tokens (USD). Single source of truth for @sentrial/sdk (src/cost.ts imports this file directly) and the Python sentrial SDK (sentrial/pricing.py holds a per-1K mirror guarded by tests/test_pricing_sync.py). Update prices HERE; the Python drift test fails CI if the mirror falls out of sync. Base table Jan 2026; Claude 4.5 canonical model IDs and standard first-party rates verified Nov 1, 2026 at https://platform.claude.com/docs/en/about-claude/pricing. Estimates exclude batch and regional adjustments.",
   openai: {
     "gpt-5.2": {
       input: 5,
@@ -391,6 +391,18 @@ var pricing_default = {
     }
   },
   anthropic: {
+    "claude-haiku-4-5": {
+      input: 1,
+      output: 5
+    },
+    "claude-sonnet-4-5": {
+      input: 3,
+      output: 15
+    },
+    "claude-opus-4-5": {
+      input: 5,
+      output: 25
+    },
     "claude-opus-4": {
       input: 15,
       output: 75
@@ -2596,7 +2608,7 @@ function buildTrace(spans, resourceAttrs) {
 }
 
 // package.json
-var version = "0.5.0";
+var version = "0.6.0";
 
 // src/evict.ts
 function evictStaleEntries(map, opts) {
@@ -4340,6 +4352,13 @@ function safeStringify2(value) {
     return safeString3(value);
   }
 }
+function copyWrapperMetadata(value) {
+  try {
+    return { ...value };
+  } catch {
+    return { _unserializable: true };
+  }
+}
 var _defaultClient2 = null;
 var _globalConfig = {};
 function configureVercel(config) {
@@ -4507,6 +4526,7 @@ function wrapGenerateText(originalFn, client, config) {
         userId: resolveStringOrFn(config.userId, "anonymous"),
         convoId: resolveStringOrFn(config.convoId),
         metadata: {
+          ...config.metadata,
           model: modelId,
           provider,
           function: "generateText",
@@ -4629,6 +4649,7 @@ function wrapStreamText(originalFn, client, config) {
           userId: resolveStringOrFn(config.userId, "anonymous"),
           convoId: resolveStringOrFn(config.convoId),
           metadata: {
+            ...config.metadata,
             model: modelId,
             provider,
             function: "streamText"
@@ -4822,6 +4843,7 @@ function wrapGenerateObject(originalFn, client, config) {
         userId: resolveStringOrFn(config.userId, "anonymous"),
         convoId: resolveStringOrFn(config.convoId),
         metadata: {
+          ...config.metadata,
           model: modelId,
           provider,
           function: "generateObject"
@@ -4897,6 +4919,7 @@ function wrapStreamObject(originalFn, client, config) {
           userId: resolveStringOrFn(config.userId, "anonymous"),
           convoId: resolveStringOrFn(config.convoId),
           metadata: {
+            ...config.metadata,
             model: modelId,
             provider,
             function: "streamObject"
@@ -5049,7 +5072,8 @@ function wrapAISDK(ai, options) {
   const config = {
     defaultAgent: options?.defaultAgent ?? _globalConfig.defaultAgent,
     userId: options?.userId ?? _globalConfig.userId,
-    convoId: options?.convoId ?? _globalConfig.convoId
+    convoId: options?.convoId ?? _globalConfig.convoId,
+    metadata: copyWrapperMetadata(options?.metadata)
   };
   const generateTextFn = ai.generateText ?? ai.experimental_generateText;
   const streamTextFn = ai.streamText ?? ai.experimental_streamText;