tracia 0.3.1 → 0.3.3

package/dist/index.d.mts

@@ -267,8 +267,8 @@ interface RunLocalInput {
     stopSequences?: string[];
     /** Timeout in milliseconds for the LLM call */
     timeoutMs?: number;
-    /** Provider-specific options passed directly to the SDK */
-    customOptions?: Record<string, unknown>;
+    /** Provider-specific options passed directly to the AI SDK (e.g., { openai: { strictJsonSchema: true } }) */
+    customOptions?: Record<string, Record<string, unknown>>;
     variables?: Record<string, string>;
     providerApiKey?: string;
     tags?: string[];
@@ -466,6 +466,8 @@ interface RunResponsesInput {
     traceId?: string;
     /** Parent span ID for chaining spans in a sequence */
     parentSpanId?: string;
+    /** Provider-specific options passed directly to the AI SDK (e.g., { openai: { strictJsonSchema: true } }) */
+    customOptions?: Record<string, Record<string, unknown>>;
 }
 /**
  * Final result from a Responses API call.
@@ -613,8 +615,13 @@ declare class TraciaSession {
     private readonly tracia;
     private traceId;
     private lastSpanId;
-    /** @internal */
-    constructor(tracia: Tracia);
+    /**
+     * @internal
+     * @param tracia - The Tracia client instance
+     * @param initialTraceId - Optional trace ID to continue an existing trace
+     * @param initialParentSpanId - Optional parent span ID to chain from
+     */
+    constructor(tracia: Tracia, initialTraceId?: string, initialParentSpanId?: string);
     /**
      * Get the current session's trace ID (the ID that groups all spans together).
      * Returns null if no spans have been made yet.
@@ -784,11 +791,19 @@ declare class Tracia {
      * Sessions automatically chain spans by setting traceId and parentSpanId,
      * creating a linked sequence of spans that can be viewed together in the Tracia dashboard.
      *
+     * @param options - Optional configuration for the session
+     * @param options.traceId - Continue an existing trace instead of starting a new one
+     * @param options.parentSpanId - Chain from an existing span
+     *
      * @example
      * ```typescript
+     * // Start a new trace
      * const session = tracia.createSession()
      *
-     * // First call - creates the trace group
+     * // Or continue an existing trace (e.g., across HTTP requests)
+     * const session = tracia.createSession({ traceId: previousTraceId })
+     *
+     * // First call - creates or continues the trace group
      * const result1 = await session.runLocal({
      *   model: 'gpt-4o',
      *   messages: [{ role: 'user', content: 'What is the weather?' }],
@@ -801,7 +816,10 @@ declare class Tracia {
      * })
      * ```
      */
-    createSession(): TraciaSession;
+    createSession(options?: {
+        traceId?: string;
+        parentSpanId?: string;
+    }): TraciaSession;
     private validateRunLocalInput;
     private scheduleSpanCreation;
     private createSpanWithRetry;

package/dist/index.d.ts

@@ -267,8 +267,8 @@ interface RunLocalInput {
     stopSequences?: string[];
     /** Timeout in milliseconds for the LLM call */
     timeoutMs?: number;
-    /** Provider-specific options passed directly to the SDK */
-    customOptions?: Record<string, unknown>;
+    /** Provider-specific options passed directly to the AI SDK (e.g., { openai: { strictJsonSchema: true } }) */
+    customOptions?: Record<string, Record<string, unknown>>;
     variables?: Record<string, string>;
     providerApiKey?: string;
     tags?: string[];
@@ -466,6 +466,8 @@ interface RunResponsesInput {
     traceId?: string;
     /** Parent span ID for chaining spans in a sequence */
     parentSpanId?: string;
+    /** Provider-specific options passed directly to the AI SDK (e.g., { openai: { strictJsonSchema: true } }) */
+    customOptions?: Record<string, Record<string, unknown>>;
 }
 /**
  * Final result from a Responses API call.
@@ -613,8 +615,13 @@ declare class TraciaSession {
     private readonly tracia;
     private traceId;
     private lastSpanId;
-    /** @internal */
-    constructor(tracia: Tracia);
+    /**
+     * @internal
+     * @param tracia - The Tracia client instance
+     * @param initialTraceId - Optional trace ID to continue an existing trace
+     * @param initialParentSpanId - Optional parent span ID to chain from
+     */
+    constructor(tracia: Tracia, initialTraceId?: string, initialParentSpanId?: string);
     /**
      * Get the current session's trace ID (the ID that groups all spans together).
      * Returns null if no spans have been made yet.
@@ -784,11 +791,19 @@ declare class Tracia {
      * Sessions automatically chain spans by setting traceId and parentSpanId,
      * creating a linked sequence of spans that can be viewed together in the Tracia dashboard.
      *
+     * @param options - Optional configuration for the session
+     * @param options.traceId - Continue an existing trace instead of starting a new one
+     * @param options.parentSpanId - Chain from an existing span
+     *
      * @example
      * ```typescript
+     * // Start a new trace
      * const session = tracia.createSession()
      *
-     * // First call - creates the trace group
+     * // Or continue an existing trace (e.g., across HTTP requests)
+     * const session = tracia.createSession({ traceId: previousTraceId })
+     *
+     * // First call - creates or continues the trace group
      * const result1 = await session.runLocal({
      *   model: 'gpt-4o',
      *   messages: [{ role: 'user', content: 'What is the weather?' }],
@@ -801,7 +816,10 @@ declare class Tracia {
      * })
      * ```
      */
-    createSession(): TraciaSession;
+    createSession(options?: {
+        traceId?: string;
+        parentSpanId?: string;
+    }): TraciaSession;
     private validateRunLocalInput;
     private scheduleSpanCreation;
     private createSpanWithRetry;

package/dist/index.js

@@ -76,7 +76,7 @@ var LLMProvider = /* @__PURE__ */ ((LLMProvider2) => {
 })(LLMProvider || {});
 
 // src/client.ts
-var SDK_VERSION = "0.3.1";
+var SDK_VERSION = "0.3.3";
 var DEFAULT_TIMEOUT_MS = 12e4;
 function mapApiErrorCodeToTraciaErrorCode(apiCode) {
   const codeMap = {
@@ -513,6 +513,17 @@ function extractToolCalls(toolCalls) {
     arguments: tc.input ?? {}
   }));
 }
+function mergeProviderOptions(userOptions) {
+  const defaults = {
+    openai: { strictJsonSchema: false }
+  };
+  if (!userOptions) return defaults;
+  const merged = { ...defaults };
+  for (const [provider, options] of Object.entries(userOptions)) {
+    merged[provider] = { ...merged[provider], ...options };
+  }
+  return merged;
+}
 async function complete(options) {
   const { generateText } = await loadAISdk();
   const provider = resolveProvider(options.model, options.provider);
@@ -531,7 +542,8 @@ async function complete(options) {
       stopSequences: options.stopSequences,
       tools: convertedTools,
       toolChoice: convertedToolChoice,
-      abortSignal: options.timeoutMs ? AbortSignal.timeout(options.timeoutMs) : void 0
+      abortSignal: options.timeoutMs ? AbortSignal.timeout(options.timeoutMs) : void 0,
+      providerOptions: mergeProviderOptions(options.providerOptions)
     });
     const toolCalls = extractToolCalls(result.toolCalls);
     return {
@@ -578,7 +590,8 @@ function stream(options) {
         stopSequences: options.stopSequences,
         tools: convertedTools,
         toolChoice: convertedToolChoice,
-        abortSignal
+        abortSignal,
+        providerOptions: mergeProviderOptions(options.providerOptions)
       });
       for await (const chunk of result.textStream) {
         yield chunk;
@@ -683,7 +696,8 @@ function responsesStream(options) {
         messages: convertedMessages,
         maxOutputTokens: options.maxOutputTokens,
         tools: convertedTools,
-        abortSignal
+        abortSignal,
+        providerOptions: mergeProviderOptions(options.providerOptions)
       });
       for await (const chunk of result.textStream) {
         fullText += chunk;
@@ -764,11 +778,18 @@ function responsesStream(options) {
 
 // src/session.ts
 var TraciaSession = class {
-  /** @internal */
-  constructor(tracia) {
+  /**
+   * @internal
+   * @param tracia - The Tracia client instance
+   * @param initialTraceId - Optional trace ID to continue an existing trace
+   * @param initialParentSpanId - Optional parent span ID to chain from
+   */
+  constructor(tracia, initialTraceId, initialParentSpanId) {
     this.traceId = null;
     this.lastSpanId = null;
     this.tracia = tracia;
+    this.traceId = initialTraceId ?? null;
+    this.lastSpanId = initialParentSpanId ?? null;
   }
   /**
    * Get the current session's trace ID (the ID that groups all spans together).
@@ -1059,6 +1080,7 @@ var Tracia = class {
         stopSequences: input.stopSequences,
         tools: input.tools,
         toolChoice: input.toolChoice,
+        providerOptions: input.customOptions,
         timeoutMs: input.timeoutMs
       });
     } catch (error) {
@@ -1217,7 +1239,8 @@ var Tracia = class {
       tools: input.tools,
       maxOutputTokens: input.maxOutputTokens,
       timeoutMs: input.timeoutMs,
-      signal
+      signal,
+      providerOptions: input.customOptions
     });
     let collectedText = "";
     const scheduleSpan = this.scheduleSpanCreation.bind(this);
@@ -1347,7 +1370,8 @@ var Tracia = class {
       tools: input.tools,
       toolChoice: input.toolChoice,
       timeoutMs: input.timeoutMs,
-      signal
+      signal,
+      providerOptions: input.customOptions
     });
     let collectedText = "";
     const scheduleSpan = this.scheduleSpanCreation.bind(this);
@@ -1500,11 +1524,19 @@ var Tracia = class {
    * Sessions automatically chain spans by setting traceId and parentSpanId,
    * creating a linked sequence of spans that can be viewed together in the Tracia dashboard.
    *
+   * @param options - Optional configuration for the session
+   * @param options.traceId - Continue an existing trace instead of starting a new one
+   * @param options.parentSpanId - Chain from an existing span
+   *
    * @example
    * ```typescript
+   * // Start a new trace
    * const session = tracia.createSession()
    *
-   * // First call - creates the trace group
+   * // Or continue an existing trace (e.g., across HTTP requests)
+   * const session = tracia.createSession({ traceId: previousTraceId })
+   *
+   * // First call - creates or continues the trace group
    * const result1 = await session.runLocal({
    *   model: 'gpt-4o',
    *   messages: [{ role: 'user', content: 'What is the weather?' }],
@@ -1517,8 +1549,8 @@ var Tracia = class {
    * })
    * ```
    */
-  createSession() {
-    return new TraciaSession(this);
+  createSession(options) {
+    return new TraciaSession(this, options?.traceId, options?.parentSpanId);
   }
   validateRunLocalInput(input) {
     if (!input.model || input.model.trim() === "") {