tracia 0.3.0 → 0.3.2

package/README.md

@@ -1,6 +1,6 @@
 # Tracia SDK
 
-TypeScript SDK for [Tracia](https://tracia.io) — store, test, and trace LLM prompts.
+TypeScript SDK for [Tracia](https://tracia.io) - store, test, and trace LLM prompts.
 
 ## Installation
 
@@ -15,8 +15,16 @@ import { Tracia } from 'tracia';
 
 const tracia = new Tracia({ apiKey: process.env.TRACIA_API_KEY });
 
+// Run a prompt stored in Tracia
 const result = await tracia.prompts.run('welcome-email', { name: 'Alice' });
 console.log(result.text);
+
+// Or call LLM directly with automatic tracing
+const response = await tracia.runLocal({
+  model: 'gpt-4o',
+  messages: [{ role: 'user', content: 'Hello!' }],
+});
+console.log(response.text);
 ```
 
 ## Documentation

package/dist/index.d.mts

@@ -613,8 +613,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 +789,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 +814,10 @@ declare class Tracia {
      * })
      * ```
      */
-    createSession(): TraciaSession;
+    createSession(options?: {
+        traceId?: string;
+        parentSpanId?: string;
+    }): TraciaSession;
     private validateRunLocalInput;
     private scheduleSpanCreation;
     private createSpanWithRetry;

package/dist/index.d.ts

@@ -613,8 +613,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 +789,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 +814,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.0";
+var SDK_VERSION = "0.3.2";
 var DEFAULT_TIMEOUT_MS = 12e4;
 function mapApiErrorCodeToTraciaErrorCode(apiCode) {
   const codeMap = {
@@ -764,11 +764,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).
@@ -1091,7 +1098,7 @@ var Tracia = class {
         topP: input.topP,
         tools: input.tools,
         toolCalls: completionResult?.toolCalls,
-        traceId: input.traceId,
+        traceId,
         parentSpanId: input.parentSpanId
       });
     }
@@ -1254,7 +1261,7 @@ var Tracia = class {
               name: tc.name,
               arguments: tc.arguments
             })),
-            traceId: input.traceId,
+            traceId,
             parentSpanId: input.parentSpanId
           });
         }
@@ -1290,7 +1297,7 @@ var Tracia = class {
             userId: input.userId,
             sessionId: input.sessionId,
             tools: input.tools,
-            traceId: input.traceId,
+            traceId,
             parentSpanId: input.parentSpanId
           });
         }
@@ -1382,7 +1389,7 @@ var Tracia = class {
             topP: input.topP,
             tools: input.tools,
             toolCalls: completionResult.toolCalls,
-            traceId: input.traceId,
+            traceId,
             parentSpanId: input.parentSpanId
           });
         }
@@ -1431,7 +1438,7 @@ var Tracia = class {
             temperature: input.temperature,
             maxOutputTokens: input.maxOutputTokens,
             topP: input.topP,
-            traceId: input.traceId,
+            traceId,
             parentSpanId: input.parentSpanId
           });
         }
@@ -1500,11 +1507,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 +1532,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() === "") {