@respan/tracing 1.0.45 → 1.1.0

package/README.md

@@ -1,6 +1,8 @@
-# KeywordsAI Tracing SDK
+# Respan Tracing SDK
 
-A lightweight OpenTelemetry-based tracing SDK for KeywordsAI, built with minimal dependencies and optional instrumentation support.
+**[respan.ai](https://respan.ai)** | **[Documentation](https://docs.respan.ai)**
+
+A lightweight OpenTelemetry-based tracing SDK for Respan, built with minimal dependencies and optional instrumentation support.
 Inspired by [Openllmetry](https://github.com/traceloop/openllmetry-js)
 
 ## Features
@@ -14,13 +16,13 @@ Inspired by [Openllmetry](https://github.com/traceloop/openllmetry-js)
 - **Span Management**: Full control over spans with `getClient()` API
 - **Multi-Processor Routing**: Route spans to multiple destinations
 - **Span Buffering**: Manual control over span export timing
-- **KeywordsAI Parameters**: Add customer identifiers and trace group identifiers
+- **Respan Parameters**: Add customer identifiers and trace group identifiers
 
 ## Installation
 
 ### Core Package
 ```bash
-npm install @keywordsai/tracing
+npm install @respan/tracing
 ```
 
 ### Optional Instrumentations
@@ -63,24 +65,24 @@ npm install @traceloop/instrumentation-vertexai
 ### Method 1: Dynamic Instrumentation (Recommended for Node.js)
 
 ```typescript
-import { KeywordsAITelemetry } from '@keywordsai/tracing';
+import { RespanTelemetry } from '@respan/tracing';
 import OpenAI from 'openai';
 
 // Initialize the SDK
-const keywordsAi = new KeywordsAITelemetry({
-    apiKey: process.env.KEYWORDSAI_API_KEY,
-    baseURL: process.env.KEYWORDSAI_BASE_URL,
+const respan = new RespanTelemetry({
+    apiKey: process.env.RESPAN_API_KEY,
+    baseURL: process.env.RESPAN_BASE_URL,
     appName: 'my-app'
 });
 
 // Enable instrumentations you need
-await keywordsAi.enableInstrumentation('openai');
+await respan.enableInstrumentation('openai');
 
 const openai = new OpenAI();
 
 // Use decorators to trace your functions
 const generateJoke = async () => {
-    return await keywordsAi.withTask(
+    return await respan.withTask(
         { name: 'joke_generation' },
         async () => {
             const completion = await openai.chat.completions.create({
@@ -96,14 +98,14 @@ const generateJoke = async () => {
 ### Method 2: Manual Instrumentation (Recommended for Next.js)
 
 ```typescript
-import { KeywordsAITelemetry } from '@keywordsai/tracing';
+import { RespanTelemetry } from '@respan/tracing';
 import OpenAI from 'openai';
 import Anthropic from '@anthropic-ai/sdk';
 
 // Manual instrumentation - pass the actual imported modules
-const keywordsAi = new KeywordsAITelemetry({
-    apiKey: process.env.KEYWORDSAI_API_KEY,
-    baseURL: process.env.KEYWORDSAI_BASE_URL,
+const respan = new RespanTelemetry({
+    apiKey: process.env.RESPAN_API_KEY,
+    baseURL: process.env.RESPAN_BASE_URL,
     appName: 'my-app',
     // Specify modules to instrument manually
     instrumentModules: {
@@ -114,7 +116,7 @@ const keywordsAi = new KeywordsAITelemetry({
 });
 
 // Wait for initialization (optional but recommended)
-await keywordsAi.initialize();
+await respan.initialize();
 
 // Create clients - they will be automatically instrumented
 const openai = new OpenAI();
@@ -122,7 +124,7 @@ const anthropic = new Anthropic();
 
 // Use decorators to trace your functions
 const generateContent = async () => {
-    return await keywordsAi.withWorkflow(
+    return await respan.withWorkflow(
         { name: 'content_generation', version: 1 },
         async () => {
             const result = await openai.chat.completions.create({
@@ -149,15 +151,15 @@ const generateContent = async () => {
 
 ## API Reference
 
-### KeywordsAITelemetry
+### RespanTelemetry
 
 #### Constructor Options
 
 ```typescript
-interface KeywordsAIOptions {
+interface RespanOptions {
     appName?: string;                    // App name for traces
-    apiKey?: string;                     // KeywordsAI API key
-    baseURL?: string;                    // KeywordsAI base URL
+    apiKey?: string;                     // Respan API key
+    baseURL?: string;                    // Respan base URL
     disableBatch?: boolean;              // Disable batching for development
     logLevel?: "debug" | "info" | "warn" | "error";
     traceContent?: boolean;              // Log prompts and completions
@@ -209,7 +211,7 @@ interface KeywordsAIOptions {
 #### withWorkflow
 Trace high-level workflows:
 ```typescript
-await keywordsAi.withWorkflow(
+await respan.withWorkflow(
     { name: 'my_workflow', version: 1 },
     async () => {
         // Your workflow logic
@@ -220,7 +222,7 @@ await keywordsAi.withWorkflow(
 #### withTask
 Trace individual tasks:
 ```typescript
-await keywordsAi.withTask(
+await respan.withTask(
     { name: 'my_task' },
     async () => {
         // Your task logic
@@ -231,7 +233,7 @@ await keywordsAi.withTask(
 #### withAgent
 Trace agent operations:
 ```typescript
-await keywordsAi.withAgent(
+await respan.withAgent(
     { name: 'my_agent', associationProperties: { type: 'assistant' } },
     async () => {
         // Your agent logic
@@ -242,7 +244,7 @@ await keywordsAi.withAgent(
 #### withTool
 Trace tool usage:
 ```typescript
-await keywordsAi.withTool(
+await respan.withTool(
     { name: 'my_tool' },
     async () => {
         // Your tool logic
@@ -271,9 +273,9 @@ interface DecoratorConfig {
 Get full control over your spans with the client API:
 
 ```typescript
-import { KeywordsAITelemetry, getClient } from '@keywordsai/tracing';
+import { RespanTelemetry, getClient } from '@respan/tracing';
 
-const kai = new KeywordsAITelemetry({ apiKey: 'your-key' });
+const kai = new RespanTelemetry({ apiKey: 'your-key' });
 await kai.initialize();
 
 await kai.withTask({ name: 'process_data' }, async () => {
@@ -284,9 +286,9 @@ await kai.withTask({ name: 'process_data' }, async () => {
     const spanId = client.getCurrentSpanId();
     console.log(`Trace: ${traceId}, Span: ${spanId}`);
     
-    // Update span with KeywordsAI parameters
+    // Update span with Respan parameters
     client.updateCurrentSpan({
-        keywordsaiParams: {
+        respanParams: {
             customerIdentifier: 'user-123',
             traceGroupIdentifier: 'data-pipeline',
             metadata: {
@@ -316,7 +318,7 @@ await kai.withTask({ name: 'process_data' }, async () => {
 **Available Client Methods:**
 - `getCurrentTraceId()` - Get the current trace ID
 - `getCurrentSpanId()` - Get the current span ID
-- `updateCurrentSpan(options)` - Update span attributes, name, status, or KeywordsAI params
+- `updateCurrentSpan(options)` - Update span attributes, name, status, or Respan params
 - `addEvent(name, attributes?)` - Add an event to the current span
 - `recordException(exception)` - Record an exception on the current span
 - `isRecording()` - Check if the span is recording
@@ -328,11 +330,11 @@ await kai.withTask({ name: 'process_data' }, async () => {
 Route spans to different destinations based on processor names:
 
 ```typescript
-import { KeywordsAITelemetry } from '@keywordsai/tracing';
+import { RespanTelemetry } from '@respan/tracing';
 
-const kai = new KeywordsAITelemetry({ apiKey: 'your-key' });
+const kai = new RespanTelemetry({ apiKey: 'your-key' });
 
-// Add a debug processor (in addition to default KeywordsAI processor)
+// Add a debug processor (in addition to default Respan processor)
 kai.addProcessor({
     exporter: new YourCustomExporter(),
     name: 'debug',
@@ -359,7 +361,7 @@ await kai.withTask(
 await kai.withTask(
     { name: 'normal_task' },
     async () => {
-        // This span goes to the default KeywordsAI processor
+        // This span goes to the default Respan processor
     }
 );
 ```
@@ -379,9 +381,9 @@ interface ProcessorConfig {
 Buffer spans and control when they're exported:
 
 ```typescript
-import { KeywordsAITelemetry } from '@keywordsai/tracing';
+import { RespanTelemetry } from '@respan/tracing';
 
-const kai = new KeywordsAITelemetry({ apiKey: 'your-key' });
+const kai = new RespanTelemetry({ apiKey: 'your-key' });
 const manager = kai.getSpanBufferManager();
 
 // Create a buffer (spans won't be auto-exported)
@@ -407,7 +409,7 @@ const isSuccessful = true;  // Your business logic
 const isPremiumUser = true; // Your business logic
 
 if (isSuccessful && isPremiumUser) {
-    // Export to KeywordsAI
+    // Export to Respan
     await manager.processSpans(spans);
 } else {
     // Discard spans
@@ -428,18 +430,18 @@ if (isSuccessful && isPremiumUser) {
 - `getSpanCount()` - Get the number of buffered spans
 - `clearSpans()` - Discard all buffered spans without exporting
 
-### KeywordsAI-Specific Parameters
+### Respan-Specific Parameters
 
 Add customer and trace group identifiers to your spans:
 
 ```typescript
-import { getClient } from '@keywordsai/tracing';
+import { getClient } from '@respan/tracing';
 
 await kai.withWorkflow({ name: 'user_workflow' }, async () => {
     const client = getClient();
     
     client.updateCurrentSpan({
-        keywordsaiParams: {
+        respanParams: {
             // Group traces by customer
             customerIdentifier: 'user-123',
             
@@ -518,7 +520,7 @@ Use manual instrumentation instead:
 await kai.enableInstrumentation('anthropic');
 
 // Use this:
-const kai = new KeywordsAITelemetry({
+const kai = new RespanTelemetry({
     instrumentModules: {
         anthropic: Anthropic
     }
@@ -558,16 +560,16 @@ const kai = new KeywordsAITelemetry({
 ### Spans not showing up?
 
 1. Check that you're using decorators (`withTask`, `withWorkflow`, etc.)
-2. Verify API key is set: `process.env.KEYWORDSAI_API_KEY`
+2. Verify API key is set: `process.env.RESPAN_API_KEY`
 3. Enable debug logging: `logLevel: 'debug'`
-4. Check network requests to KeywordsAI endpoint
+4. Check network requests to Respan endpoint
 
 ## Environment Variables
 
-- `KEYWORDSAI_API_KEY`: Your KeywordsAI API key
-- `KEYWORDSAI_BASE_URL`: KeywordsAI base URL (default: https://api.keywordsai.co)
-- `KEYWORDSAI_APP_NAME`: Default app name
-- `KEYWORDSAI_TRACE_CONTENT`: Enable/disable content tracing (default: true)
+- `RESPAN_API_KEY`: Your Respan API key
+- `RESPAN_BASE_URL`: Respan base URL (default: https://api.respan.ai)
+- `RESPAN_APP_NAME`: Default app name
+- `RESPAN_TRACE_CONTENT`: Enable/disable content tracing (default: true)
 
 ## Provider-Specific Examples
 
@@ -575,11 +577,11 @@ const kai = new KeywordsAITelemetry({
 
 **Method 1: Dynamic Instrumentation (Simple)**
 ```typescript
-import { KeywordsAITelemetry } from '@keywordsai/tracing';
+import { RespanTelemetry } from '@respan/tracing';
 import OpenAI from 'openai';
 
-const kai = new KeywordsAITelemetry({
-    apiKey: process.env.KEYWORDSAI_API_KEY,
+const kai = new RespanTelemetry({
+    apiKey: process.env.RESPAN_API_KEY,
     appName: 'openai-app'
 });
 
@@ -599,11 +601,11 @@ await kai.withTask({ name: 'chat' }, async () => {
 
 **Method 2: Manual Instrumentation (Next.js/Webpack)**
 ```typescript
-import { KeywordsAITelemetry } from '@keywordsai/tracing';
+import { RespanTelemetry } from '@respan/tracing';
 import OpenAI from 'openai';
 
-const kai = new KeywordsAITelemetry({
-    apiKey: process.env.KEYWORDSAI_API_KEY,
+const kai = new RespanTelemetry({
+    apiKey: process.env.RESPAN_API_KEY,
     appName: 'openai-app',
     instrumentModules: {
         openAI: OpenAI  // Pass the OpenAI class
@@ -626,12 +628,12 @@ await kai.withTask({ name: 'chat' }, async () => {
 ### Anthropic (Claude)
 
 ```typescript
-import { KeywordsAITelemetry } from '@keywordsai/tracing';
+import { RespanTelemetry } from '@respan/tracing';
 import Anthropic from '@anthropic-ai/sdk';
 
 // Initialize with Anthropic instrumentation
-const kai = new KeywordsAITelemetry({
-    apiKey: process.env.KEYWORDSAI_API_KEY,
+const kai = new RespanTelemetry({
+    apiKey: process.env.RESPAN_API_KEY,
     appName: 'anthropic-app',
     instrumentModules: {
         anthropic: Anthropic  // Pass the Anthropic class
@@ -684,11 +686,11 @@ npm install @anthropic-ai/sdk @traceloop/instrumentation-anthropic
 ### Example 1: Full Workflow with Span Management
 
 ```typescript
-import { KeywordsAITelemetry, getClient } from '@keywordsai/tracing';
+import { RespanTelemetry, getClient } from '@respan/tracing';
 import OpenAI from 'openai';
 
-const kai = new KeywordsAITelemetry({
-    apiKey: process.env.KEYWORDSAI_API_KEY,
+const kai = new RespanTelemetry({
+    apiKey: process.env.RESPAN_API_KEY,
     appName: 'my-app',
     resourceAttributes: {
         environment: 'production',
@@ -704,7 +706,7 @@ await kai.withWorkflow({ name: 'process_user_request', version: 1 }, async () =>
     
     // Set customer context
     client.updateCurrentSpan({
-        keywordsaiParams: {
+        respanParams: {
             customerIdentifier: 'user-123',
             traceGroupIdentifier: 'onboarding'
         }
@@ -737,9 +739,9 @@ await kai.withWorkflow({ name: 'process_user_request', version: 1 }, async () =>
 ### Example 2: Backend Workflow with Span Buffering
 
 ```typescript
-import { KeywordsAITelemetry } from '@keywordsai/tracing';
+import { RespanTelemetry } from '@respan/tracing';
 
-const kai = new KeywordsAITelemetry({ apiKey: 'your-key' });
+const kai = new RespanTelemetry({ apiKey: 'your-key' });
 const manager = kai.getSpanBufferManager();
 
 // Ingest workflow results from backend
@@ -781,10 +783,10 @@ async function ingestWorkflow(workflowResult: any, orgId: string) {
 ### Example 3: Multi-Destination Routing
 
 ```typescript
-import { KeywordsAITelemetry } from '@keywordsai/tracing';
+import { RespanTelemetry } from '@respan/tracing';
 import { FileExporter, AnalyticsExporter } from './exporters';
 
-const kai = new KeywordsAITelemetry({ apiKey: 'your-key' });
+const kai = new RespanTelemetry({ apiKey: 'your-key' });
 
 // Add debug file exporter
 kai.addProcessor({
@@ -799,10 +801,10 @@ kai.addProcessor({
     filter: (span) => !span.name.includes('test')
 });
 
-// Route to default KeywordsAI processor
+// Route to default Respan processor
 await kai.withTask(
     { name: 'production_task' },
-    async () => { /* goes to KeywordsAI */ }
+    async () => { /* goes to Respan */ }
 );
 
 // Route to debug processor
@@ -851,7 +853,7 @@ All new features are **backward compatible**. Existing code will continue to wor
 
 To use new features, simply import and use them:
 ```typescript
-import { getClient } from '@keywordsai/tracing';  // New in v1.1.0
+import { getClient } from '@respan/tracing';  // New in v1.1.0
 ```
 
 ## License

package/dist/contexts/index.d.ts

@@ -1 +1,2 @@
 export * from "./span.js";
+export * from "./propagation.js";

package/dist/contexts/index.js

@@ -1,2 +1,3 @@
 export * from "./span.js";
+export * from "./propagation.js";
 //# sourceMappingURL=index.js.map

package/dist/contexts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

package/dist/contexts/propagation.d.ts

@@ -0,0 +1,25 @@
+import type { RespanParams } from "@respan/respan-sdk";
+/**
+ * Run a function within a context that propagates Respan attributes to all
+ * spans created within its scope.
+ *
+ * Attributes are merged into every span at creation time via
+ * `RespanCompositeProcessor.onStart()`. Nested calls merge attributes
+ * (inner wins). Metadata dicts are merged, not replaced.
+ *
+ * @param attrs - Respan attributes to propagate (customer_identifier,
+ *   thread_identifier, metadata, prompt, environment, etc.)
+ * @param fn - The function to execute within the propagation scope
+ * @returns The result of `fn`
+ *
+ * @example
+ * ```typescript
+ * await propagateAttributes(
+ *   { customer_identifier: "user_123", thread_identifier: "conv_abc" },
+ *   async () => {
+ *     await Runner.run(agent, "Hello");
+ *   }
+ * );
+ * ```
+ */
+export declare function propagateAttributes<T>(attrs: Partial<RespanParams>, fn: () => T): T;

package/dist/contexts/propagation.js

@@ -0,0 +1,47 @@
+import { context } from "@opentelemetry/api";
+import { RESPAN_SPAN_ATTRIBUTES_MAP } from "@respan/respan-sdk";
+import { PROPAGATED_ATTRIBUTES_KEY, getPropagatedAttributes, } from "../utils/context.js";
+/**
+ * Run a function within a context that propagates Respan attributes to all
+ * spans created within its scope.
+ *
+ * Attributes are merged into every span at creation time via
+ * `RespanCompositeProcessor.onStart()`. Nested calls merge attributes
+ * (inner wins). Metadata dicts are merged, not replaced.
+ *
+ * @param attrs - Respan attributes to propagate (customer_identifier,
+ *   thread_identifier, metadata, prompt, environment, etc.)
+ * @param fn - The function to execute within the propagation scope
+ * @returns The result of `fn`
+ *
+ * @example
+ * ```typescript
+ * await propagateAttributes(
+ *   { customer_identifier: "user_123", thread_identifier: "conv_abc" },
+ *   async () => {
+ *     await Runner.run(agent, "Hello");
+ *   }
+ * );
+ * ```
+ */
+export function propagateAttributes(attrs, fn) {
+    // Merge with any already-active attributes (supports nesting)
+    const parent = getPropagatedAttributes() ?? {};
+    const merged = { ...parent };
+    for (const [key, value] of Object.entries(attrs)) {
+        if (!(key in RESPAN_SPAN_ATTRIBUTES_MAP)) {
+            console.warn(`[Respan] Ignoring unsupported attribute: ${key}`);
+            continue;
+        }
+        if (key === "metadata" && typeof value === "object" && value !== null) {
+            // Merge metadata dicts instead of replacing
+            merged.metadata = { ...(merged.metadata ?? {}), ...value };
+        }
+        else {
+            merged[key] = value;
+        }
+    }
+    const ctx = context.active().setValue(PROPAGATED_ATTRIBUTES_KEY, merged);
+    return context.with(ctx, fn);
+}
+//# sourceMappingURL=propagation.js.map

package/dist/contexts/propagation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.js","sourceRoot":"","sources":["../../src/contexts/propagation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA4B,EAC5B,EAAW;IAEX,8DAA8D;IAC9D,MAAM,MAAM,GAAG,uBAAuB,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,MAAM,GAA0B,EAAE,GAAG,MAAM,EAAE,CAAC;IAEpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,CAAC,GAAG,IAAI,0BAA0B,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,4CAA4C,GAAG,EAAE,CAAC,CAAC;YAChE,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,UAAU,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACtE,4CAA4C;YAC5C,MAAM,CAAC,QAAQ,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;QAC7D,CAAC;aAAM,CAAC;YACL,MAAc,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;IACzE,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC"}

package/dist/processor/composite.js

@@ -1,5 +1,72 @@
 import { SpanAttributes } from "@traceloop/ai-semantic-conventions";
-import { getEntityPath } from "../utils/context.js";
+import { RESPAN_SPAN_ATTRIBUTES_MAP, RespanSpanAttributes, RespanLogType, } from "@respan/respan-sdk";
+import { getEntityPath, getPropagatedAttributes } from "../utils/context.js";
+// ── OpenInference span enrichment ──────────────────────────────────────────
+/** Map OI span kinds → Traceloop span kinds */
+const OI_KIND_TO_TRACELOOP = {
+    LLM: RespanLogType.TASK,
+    CHAIN: RespanLogType.WORKFLOW,
+    TOOL: RespanLogType.TOOL,
+    AGENT: RespanLogType.AGENT,
+    EMBEDDING: RespanLogType.TASK,
+    RETRIEVER: RespanLogType.TASK,
+    RERANKER: RespanLogType.TASK,
+    GUARDRAIL: RespanLogType.TASK,
+    EVALUATOR: RespanLogType.TASK,
+};
+/** OI span kinds that imply an LLM request type */
+const OI_LLM_REQUEST_KINDS = {
+    LLM: RespanLogType.CHAT,
+    EMBEDDING: RespanLogType.EMBEDDING,
+};
+/** Map OI span kinds → respan.entity.log_type values */
+const OI_LOG_TYPE = {
+    LLM: RespanLogType.CHAT,
+    CHAIN: RespanLogType.WORKFLOW,
+    TOOL: RespanLogType.TOOL,
+    AGENT: RespanLogType.AGENT,
+    EMBEDDING: RespanLogType.EMBEDDING,
+    RETRIEVER: RespanLogType.TASK,
+    RERANKER: RespanLogType.TASK,
+    GUARDRAIL: RespanLogType.GUARDRAIL,
+    EVALUATOR: RespanLogType.TASK,
+};
+/**
+ * Build Traceloop/GenAI enrichment attributes for an OpenInference span.
+ * Returns only the attributes that need to be *added*; callers merge them
+ * on top of the original span attributes.
+ */
+function getOIEnrichmentAttrs(span) {
+    const attrs = {};
+    const oiKind = String(span.attributes[RespanSpanAttributes.OPENINFERENCE_SPAN_KIND] ?? "");
+    if (OI_KIND_TO_TRACELOOP[oiKind]) {
+        attrs[SpanAttributes.TRACELOOP_SPAN_KIND] = OI_KIND_TO_TRACELOOP[oiKind];
+    }
+    if (OI_LLM_REQUEST_KINDS[oiKind]) {
+        attrs[RespanSpanAttributes.LLM_REQUEST_TYPE] = OI_LLM_REQUEST_KINDS[oiKind];
+    }
+    if (OI_LOG_TYPE[oiKind]) {
+        attrs[RespanSpanAttributes.RESPAN_LOG_TYPE] = OI_LOG_TYPE[oiKind];
+    }
+    // Bridge OI semantic attrs → Traceloop/GenAI equivalents
+    if (span.attributes["input.value"] !== undefined)
+        attrs[SpanAttributes.TRACELOOP_ENTITY_INPUT] = span.attributes["input.value"];
+    if (span.attributes["output.value"] !== undefined)
+        attrs[SpanAttributes.TRACELOOP_ENTITY_OUTPUT] = span.attributes["output.value"];
+    if (span.attributes["llm.model_name"] !== undefined)
+        attrs[RespanSpanAttributes.GEN_AI_REQUEST_MODEL] = span.attributes["llm.model_name"];
+    if (span.attributes["llm.token_count.prompt"] !== undefined)
+        attrs[RespanSpanAttributes.GEN_AI_USAGE_PROMPT_TOKENS] = span.attributes["llm.token_count.prompt"];
+    if (span.attributes["llm.token_count.completion"] !== undefined)
+        attrs[RespanSpanAttributes.GEN_AI_USAGE_COMPLETION_TOKENS] = span.attributes["llm.token_count.completion"];
+    // Entity name / path
+    attrs[SpanAttributes.TRACELOOP_ENTITY_NAME] = span.name;
+    if (OI_KIND_TO_TRACELOOP[oiKind] !== "workflow") {
+        attrs[SpanAttributes.TRACELOOP_ENTITY_PATH] = span.name;
+    }
+    return attrs;
+}
+// ── Composite processor ────────────────────────────────────────────────────
 /**
  * Composite processor that combines filtering with multi-processor routing.
  *
@@ -28,6 +95,28 @@ export class RespanCompositeProcessor {
             // We need to cast to any to set attributes during onStart
             span.setAttribute(SpanAttributes.TRACELOOP_ENTITY_PATH, entityPath);
         }
+        // Apply propagated attributes (customer_identifier, thread_identifier, etc.)
+        const propagated = getPropagatedAttributes(parentContext);
+        if (propagated) {
+            for (const [key, value] of Object.entries(propagated)) {
+                if (value === undefined || value === null)
+                    continue;
+                const attrKey = RESPAN_SPAN_ATTRIBUTES_MAP[key];
+                if (!attrKey)
+                    continue;
+                if (key === "metadata" && typeof value === "object") {
+                    for (const [mk, mv] of Object.entries(value)) {
+                        span.setAttribute(`${RespanSpanAttributes.RESPAN_METADATA}.${mk}`, typeof mv === "string" ? mv : JSON.stringify(mv));
+                    }
+                }
+                else if (key === "prompt" && typeof value === "object") {
+                    span.setAttribute(attrKey, JSON.stringify(value));
+                }
+                else {
+                    span.setAttribute(attrKey, value);
+                }
+            }
+        }
         // Forward to processor manager
         this._processorManager.onStart(span, parentContext);
     }
@@ -45,8 +134,8 @@ export class RespanCompositeProcessor {
         }
         // Check if this is an LLM instrumentation span (OpenAI, Anthropic, etc.)
         // These have gen_ai.* or llm.* attributes
-        const isLLMSpan = span.attributes['gen_ai.system'] !== undefined ||
-            span.attributes['llm.system'] !== undefined ||
+        const isLLMSpan = span.attributes[RespanSpanAttributes.GEN_AI_SYSTEM] !== undefined ||
+            span.attributes[RespanSpanAttributes.LLM_SYSTEM] !== undefined ||
             span.attributes['gen_ai.request.model'] !== undefined ||
             span.name.includes('anthropic.messages') ||
             span.name.includes('openai.chat') ||
@@ -81,6 +170,25 @@ export class RespanCompositeProcessor {
             // Route to processors
             this._processorManager.onEnd(span);
         }
+        else if (span.attributes[RespanSpanAttributes.OPENINFERENCE_SPAN_KIND] !== undefined) {
+            // OpenInference span — enrich with Traceloop/GenAI attrs, then route
+            console.debug(`[Respan Debug] Processing OpenInference span: ${span.name} (kind: ${span.attributes[RespanSpanAttributes.OPENINFERENCE_SPAN_KIND]})`);
+            const enrichmentAttrs = getOIEnrichmentAttrs(span);
+            const enrichedSpan = Object.create(Object.getPrototypeOf(span));
+            Object.assign(enrichedSpan, span);
+            Object.defineProperty(enrichedSpan, "attributes", {
+                value: { ...span.attributes, ...enrichmentAttrs },
+                writable: false,
+                configurable: true,
+                enumerable: true,
+            });
+            this._processorManager.onEnd(enrichedSpan);
+        }
+        else if (span.attributes[RespanSpanAttributes.RESPAN_LOG_TYPE] !== undefined) {
+            // Enriched Respan span (from an instrumentation plugin)
+            console.debug(`[Respan Debug] Processing enriched Respan span: ${span.name}`);
+            this._processorManager.onEnd(span);
+        }
         else {
             // This span has none of the above - it's pure auto-instrumentation noise (HTTP calls, etc.)
             console.debug(`[Respan Debug] Filtering out auto-instrumentation span: ${span.name}`);

package/dist/processor/composite.js.map

@@ -1 +1 @@
-{"version":3,"file":"composite.js","sourceRoot":"","sources":["../../src/processor/composite.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"composite.js","sourceRoot":"","sources":["../../src/processor/composite.ts"],"names":[],"mappings":"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"}

package/dist/utils/batchLogging.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Batch API result logging utilities.
+ *
+ * Logs OpenAI Batch API results as individual chat completion spans
+ * injected into the OTEL pipeline.
+ */
+export interface BatchRequest {
+    custom_id: string;
+    body?: {
+        messages?: any[];
+        model?: string;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+export interface BatchResult {
+    custom_id: string;
+    response?: {
+        status_code?: number;
+        body?: {
+            choices?: Array<{
+                message?: any;
+                [key: string]: any;
+            }>;
+            usage?: {
+                prompt_tokens?: number;
+                completion_tokens?: number;
+            };
+            model?: string;
+            created?: number;
+            [key: string]: any;
+        };
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+/**
+ * Log OpenAI Batch API results as individual chat completion spans.
+ *
+ * Trace linking (in priority order):
+ * 1. OTEL context — when called inside a `withTask` / `withWorkflow`,
+ *    auto-links to the active trace.
+ * 2. Explicit `traceId` — for async batches where results arrive later.
+ * 3. Auto-generated — creates a new standalone trace.
+ */
+export declare function logBatchResults(requests: BatchRequest[], results: BatchResult[], traceId?: string): void;

package/dist/utils/batchLogging.js

@@ -0,0 +1,107 @@
+/**
+ * Batch API result logging utilities.
+ *
+ * Logs OpenAI Batch API results as individual chat completion spans
+ * injected into the OTEL pipeline.
+ */
+import { SpanAttributes } from "@traceloop/ai-semantic-conventions";
+import { RespanSpanAttributes } from "@respan/respan-sdk";
+import { buildReadableSpan, injectSpan, ensureSpanId } from "./spanFactory.js";
+import { getClient } from "./client.js";
+/**
+ * Log OpenAI Batch API results as individual chat completion spans.
+ *
+ * Trace linking (in priority order):
+ * 1. OTEL context — when called inside a `withTask` / `withWorkflow`,
+ *    auto-links to the active trace.
+ * 2. Explicit `traceId` — for async batches where results arrive later.
+ * 3. Auto-generated — creates a new standalone trace.
+ */
+export function logBatchResults(requests, results, traceId) {
+    const client = getClient();
+    // Resolve trace context: OTEL > explicit > auto-generated.
+    let otelTraceId = client.getCurrentTraceId();
+    let otelSpanId = client.getCurrentSpanId();
+    if (otelTraceId && /^0+$/.test(otelTraceId))
+        otelTraceId = undefined;
+    if (otelSpanId && /^0+$/.test(otelSpanId))
+        otelSpanId = undefined;
+    const resolvedTraceId = otelTraceId ?? traceId ?? undefined;
+    const parentSpanId = otelSpanId ?? undefined;
+    // Index requests by custom_id
+    const requestsById = new Map();
+    for (const req of requests) {
+        requestsById.set(req.custom_id, req.body ?? {});
+    }
+    // When no OTEL context, create a grouping span so completions are nested
+    let groupSpanId;
+    if (!otelSpanId) {
+        groupSpanId = ensureSpanId();
+    }
+    const completionTimestamps = [];
+    for (const result of results) {
+        const customId = result.custom_id ?? "";
+        const response = result.response ?? {};
+        const body = response.body ?? {};
+        const statusCode = response.status_code ?? 200;
+        const original = requestsById.get(customId) ?? {};
+        const messages = original.messages ?? [];
+        const choices = body.choices ?? [{}];
+        const output = choices[0]?.message ?? {};
+        const usage = body.usage ?? {};
+        // Extract timestamp
+        const created = body.created;
+        let endTimeIso;
+        if (created) {
+            const ts = new Date(created * 1000);
+            endTimeIso = ts.toISOString();
+            completionTimestamps.push(ts);
+        }
+        const model = body.model ?? original.model ?? "";
+        const span = buildReadableSpan({
+            name: `batch:${customId}`,
+            traceId: resolvedTraceId,
+            parentId: groupSpanId ?? parentSpanId,
+            endTimeIso,
+            attributes: {
+                "llm.request.type": "chat",
+                "gen_ai.request.model": model,
+                "gen_ai.usage.prompt_tokens": usage.prompt_tokens ?? 0,
+                "gen_ai.usage.completion_tokens": usage.completion_tokens ?? 0,
+                [SpanAttributes.TRACELOOP_ENTITY_INPUT]: JSON.stringify(messages),
+                [SpanAttributes.TRACELOOP_ENTITY_OUTPUT]: JSON.stringify(output),
+                [SpanAttributes.TRACELOOP_ENTITY_PATH]: "batch_results",
+                [SpanAttributes.TRACELOOP_SPAN_KIND]: "task",
+                [RespanSpanAttributes.RESPAN_LOG_TYPE]: "chat",
+            },
+            statusCode,
+        });
+        injectSpan(span);
+    }
+    // Create the grouping "batch_results" task span (when no OTEL context)
+    if (groupSpanId) {
+        let earliestIso;
+        let latestIso;
+        if (completionTimestamps.length > 0) {
+            completionTimestamps.sort((a, b) => a.getTime() - b.getTime());
+            earliestIso = completionTimestamps[0].toISOString();
+            latestIso =
+                completionTimestamps[completionTimestamps.length - 1].toISOString();
+        }
+        const parentSpan = buildReadableSpan({
+            name: "batch_results.task",
+            traceId: resolvedTraceId,
+            spanId: groupSpanId,
+            startTimeIso: earliestIso,
+            endTimeIso: latestIso,
+            attributes: {
+                [SpanAttributes.TRACELOOP_SPAN_KIND]: "task",
+                [SpanAttributes.TRACELOOP_ENTITY_NAME]: "batch_results",
+                [SpanAttributes.TRACELOOP_ENTITY_PATH]: "",
+                [RespanSpanAttributes.RESPAN_LOG_TYPE]: "task",
+            },
+        });
+        injectSpan(parentSpan);
+    }
+}
+//# sourceMappingURL=batchLogging.js.map

package/dist/utils/batchLogging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchLogging.js","sourceRoot":"","sources":["../../src/utils/batchLogging.ts"],"names":[],"mappings":"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"}

package/dist/utils/context.d.ts

@@ -1,4 +1,5 @@
 import { Context } from "@opentelemetry/api";
+import { RespanParams } from "@respan/respan-sdk";
 /**
  * Context Keys: Type-safe identifiers for storing values in OpenTelemetry context
  *
@@ -19,6 +20,11 @@ export declare const ASSOCIATION_PROPERTIES_KEY: symbol;
  * @returns The entity path string or undefined if not set
  */
 export declare const getEntityPath: (ctx?: Context) => string | undefined;
+export declare const PROPAGATED_ATTRIBUTES_KEY: symbol;
+/**
+ * Get propagated attributes from the given context.
+ */
+export declare const getPropagatedAttributes: (ctx?: Context) => Partial<RespanParams> | undefined;
 /**
  * Determines whether trace content (input/output data) should be captured.
  * This can be controlled via environment variable for security/privacy.

package/dist/utils/context.js

@@ -32,6 +32,15 @@ export const getEntityPath = (ctx = context.active()) => {
     const workflowName = ctx.getValue(WORKFLOW_NAME_KEY);
     return workflowName;
 };
+// Stores propagated Respan attributes (customer_identifier, thread_identifier, etc.)
+// These are merged onto every span created within the context scope.
+export const PROPAGATED_ATTRIBUTES_KEY = createContextKey("respan.propagated_attributes");
+/**
+ * Get propagated attributes from the given context.
+ */
+export const getPropagatedAttributes = (ctx = context.active()) => {
+    return ctx.getValue(PROPAGATED_ATTRIBUTES_KEY);
+};
 /**
  * Determines whether trace content (input/output data) should be captured.
  * This can be controlled via environment variable for security/privacy.

package/dist/utils/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAW,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE;;;;;;;;GAQG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAC/C,cAAc,CAAC,uBAAuB,CACvC,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAC7C,cAAc,CAAC,qBAAqB,CACrC,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CACxD,cAAc,CAAC,gCAAgC,CAChD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,EAAsB,EAAE;IAC1E,4DAA4D;IAC5D,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAuB,CAAC;IACvE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,2DAA2D;IAC3D,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAuB,CAAC;IAC3E,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,EAAE;IAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,OAAO,CAAC;AACtD,CAAC,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAW,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGpE;;;;;;;;GAQG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAC/C,cAAc,CAAC,uBAAuB,CACvC,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,eAAe,GAAG,gBAAgB,CAC7C,cAAc,CAAC,qBAAqB,CACrC,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CACxD,cAAc,CAAC,gCAAgC,CAChD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,EAAsB,EAAE;IAC1E,4DAA4D;IAC5D,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAuB,CAAC;IACvE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,2DAA2D;IAC3D,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAuB,CAAC;IAC3E,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC;AAEF,qFAAqF;AACrF,qEAAqE;AACrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CACvD,8BAA8B,CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,MAAe,OAAO,CAAC,MAAM,EAAE,EACI,EAAE;IACrC,OAAO,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAEhC,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,EAAE;IAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,OAAO,CAAC;AACtD,CAAC,CAAC"}

package/dist/utils/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./context.js";
 export * from "./span.js";
+export * from "./spanFactory.js";
 export { startTracing, forceFlush, _resolveBaseURL } from "./tracing.js";
 export * from "./client.js";
 export * from "./spanBuffer.js";

package/dist/utils/index.js

@@ -1,5 +1,6 @@
 export * from "./context.js";
 export * from "./span.js";
+export * from "./spanFactory.js";
 // Export tracing utils but avoid naming conflicts
 export { startTracing, forceFlush, _resolveBaseURL } from "./tracing.js";
 // Export client and span buffer

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAE1B,kDAAkD;AAClD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEzE,gCAAgC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AAEjC,kDAAkD;AAClD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEzE,gCAAgC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/utils/spanFactory.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared utilities for constructing and injecting ReadableSpan objects.
+ *
+ * Used by the `Respan` unified entry point (e.g. `logBatchResults`) and
+ * instrumentation plugins to emit spans into the OTEL pipeline without
+ * going through a live tracer context.
+ */
+import type { ReadableSpan } from "@opentelemetry/sdk-trace-base";
+export declare function ensureTraceId(id?: string): string;
+export declare function ensureSpanId(id?: string): string;
+export declare function parseISOToHrTime(iso: string | undefined): [number, number] | null;
+export interface BuildSpanOptions {
+    name: string;
+    traceId?: string;
+    spanId?: string;
+    parentId?: string;
+    startTimeIso?: string;
+    endTimeIso?: string;
+    startTimeHr?: [number, number] | null;
+    endTimeHr?: [number, number] | null;
+    attributes: Record<string, any>;
+    statusCode?: number;
+    errorMessage?: string;
+    /** Merge propagated attributes from context. Default: true (matches Python). */
+    mergePropagated?: boolean;
+}
+/**
+ * Construct a ReadableSpan-compatible object with explicit IDs and attributes.
+ */
+export declare function buildReadableSpan(opts: BuildSpanOptions): ReadableSpan;
+/**
+ * Push a ReadableSpan through the active TracerProvider's processor chain.
+ *
+ * Returns true on success, false if no processor is available.
+ */
+export declare function injectSpan(span: ReadableSpan): boolean;

package/dist/utils/spanFactory.js

@@ -0,0 +1,148 @@
+/**
+ * Shared utilities for constructing and injecting ReadableSpan objects.
+ *
+ * Used by the `Respan` unified entry point (e.g. `logBatchResults`) and
+ * instrumentation plugins to emit spans into the OTEL pipeline without
+ * going through a live tracer context.
+ */
+import { trace, SpanKind, SpanStatusCode } from "@opentelemetry/api";
+import { hrTime, hrTimeDuration } from "@opentelemetry/core";
+import { RESPAN_SPAN_ATTRIBUTES_MAP, RespanSpanAttributes } from "@respan/respan-sdk";
+import { RESPAN_PACKAGE_NAME } from "../constants/index.js";
+import { getPropagatedAttributes } from "./context.js";
+// ── ID helpers ──────────────────────────────────────────────────────────────
+function hashStringToHexId(s, length) {
+    let hash = 0;
+    for (let i = 0; i < s.length; i++) {
+        hash = ((hash << 5) - hash + s.charCodeAt(i)) | 0;
+    }
+    const hex = Math.abs(hash).toString(16).padStart(8, "0");
+    return (hex + hex + hex + hex).slice(0, length);
+}
+function generateHexId(length) {
+    return Array.from({ length }, () => Math.floor(Math.random() * 16).toString(16)).join("");
+}
+export function ensureTraceId(id) {
+    if (!id)
+        return generateHexId(32);
+    if (/^[0-9a-f]{32}$/i.test(id))
+        return id.toLowerCase();
+    return hashStringToHexId(id, 32);
+}
+export function ensureSpanId(id) {
+    if (!id)
+        return generateHexId(16);
+    if (/^[0-9a-f]{16}$/i.test(id))
+        return id.toLowerCase();
+    return hashStringToHexId(id, 16);
+}
+// ── Timestamp helpers ───────────────────────────────────────────────────────
+export function parseISOToHrTime(iso) {
+    if (!iso)
+        return null;
+    try {
+        const ms = new Date(iso).getTime();
+        const secs = Math.floor(ms / 1000);
+        const nanos = (ms % 1000) * 1_000_000;
+        return [secs, nanos];
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Construct a ReadableSpan-compatible object with explicit IDs and attributes.
+ */
+export function buildReadableSpan(opts) {
+    const startTime = opts.startTimeHr ??
+        parseISOToHrTime(opts.startTimeIso) ??
+        hrTime();
+    const endTime = opts.endTimeHr ??
+        parseISOToHrTime(opts.endTimeIso) ??
+        hrTime();
+    const traceId = ensureTraceId(opts.traceId);
+    const spanId = ensureSpanId(opts.spanId);
+    const parentSpanId = opts.parentId
+        ? ensureSpanId(opts.parentId)
+        : undefined;
+    // Merge propagated attributes (customer_identifier, thread_id, etc.)
+    // Matches Python's merge_propagated=True default in build_readable_span()
+    const attrs = { ...opts.attributes };
+    if (opts.mergePropagated !== false) {
+        const propagated = getPropagatedAttributes();
+        if (propagated) {
+            for (const [key, value] of Object.entries(propagated)) {
+                if (value === undefined || value === null)
+                    continue;
+                const attrKey = RESPAN_SPAN_ATTRIBUTES_MAP[key];
+                if (!attrKey)
+                    continue;
+                // Only set if not already present (caller attrs take precedence)
+                if (attrs[attrKey] !== undefined)
+                    continue;
+                if (key === "metadata" && typeof value === "object") {
+                    for (const [mk, mv] of Object.entries(value)) {
+                        const fullKey = `${RespanSpanAttributes.RESPAN_METADATA}.${mk}`;
+                        if (attrs[fullKey] === undefined) {
+                            attrs[fullKey] = typeof mv === "string" ? mv : JSON.stringify(mv);
+                        }
+                    }
+                }
+                else if (key === "prompt" && typeof value === "object") {
+                    attrs[attrKey] = JSON.stringify(value);
+                }
+                else {
+                    attrs[attrKey] = value;
+                }
+            }
+        }
+    }
+    const status = opts.errorMessage
+        ? { code: SpanStatusCode.ERROR, message: opts.errorMessage }
+        : opts.statusCode && opts.statusCode >= 400
+            ? { code: SpanStatusCode.ERROR, message: `HTTP ${opts.statusCode}` }
+            : { code: SpanStatusCode.OK, message: "" };
+    return {
+        name: opts.name,
+        kind: SpanKind.INTERNAL,
+        spanContext: () => ({
+            traceId,
+            spanId,
+            traceFlags: 1,
+            isRemote: false,
+        }),
+        parentSpanId,
+        startTime,
+        endTime,
+        duration: hrTimeDuration(startTime, endTime),
+        status,
+        attributes: attrs,
+        links: [],
+        events: [],
+        resource: { attributes: {} },
+        instrumentationLibrary: {
+            name: RESPAN_PACKAGE_NAME,
+            version: "1.0.0",
+        },
+        ended: true,
+        droppedAttributesCount: 0,
+        droppedEventsCount: 0,
+        droppedLinksCount: 0,
+    };
+}
+// ── Inject into OTEL pipeline ───────────────────────────────────────────────
+/**
+ * Push a ReadableSpan through the active TracerProvider's processor chain.
+ *
+ * Returns true on success, false if no processor is available.
+ */
+export function injectSpan(span) {
+    const tp = trace.getTracerProvider();
+    const processor = tp?.activeSpanProcessor ?? tp?._delegate?.activeSpanProcessor;
+    if (processor && typeof processor.onEnd === "function") {
+        processor.onEnd(span);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=spanFactory.js.map

package/dist/utils/spanFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spanFactory.js","sourceRoot":"","sources":["../../src/utils/spanFactory.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@respan/tracing",
   "type": "module",
-  "version": "1.0.45",
-  "description": "TypeScript support for Respan SDK",
+  "version": "1.1.0",
+  "description": "OpenTelemetry-based tracing SDK for LLM applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [