neatlogs 1.0.2 → 1.0.3

package/README.md

@@ -458,6 +458,33 @@ The following libraries are registered in the instrumentation registry for futur
 
 `cohere`, `groq`, `together`, `vertexai`, `google_generativeai`, `mistralai`, `ollama`, `watsonx`, `alephalpha`, `replicate`, `sagemaker`, `huggingface_hub`, `litellm`, `langgraph`, `llamaindex`, `autogen`, `haystack`, `dspy`, `chromadb`, `pinecone`, `weaviate`, `qdrant`, `milvus`, `opensearch`, `elasticsearch`, `redis`, `marqo`, `instructor`, `guardrails`, `google_adk`, `agno`, `openai_agents`, `pydantic_ai`, `smolagents`, `strands`, `pipecat`, `portkey`, `promptflow`
 
+## Framework Integrations
+
+For frameworks that don't fit the auto-instrument-on-init pattern, neatlogs ships dedicated companion packages. Install only the ones you need:
+
+| Framework | Package | Helper |
+|-----------|---------|--------|
+| Mastra (`@mastra/core`) | `@neatlogs/instrumentation-mastra` | `getMastraObservability()` — pass to `new Mastra({ observability })` |
+| Vercel AI SDK (`ai`) | `@neatlogs/instrumentation-ai-sdk` | `getAISDKWrapper()` — wraps `generateText` / `streamText` / `generateObject` / `streamObject` |
+
+```typescript
+// Vercel AI SDK
+import { init, getAISDKWrapper, shutdown } from 'neatlogs';
+import * as ai from 'ai';
+import { openai } from '@ai-sdk/openai';
+
+await init({ apiKey: process.env.NEATLOGS_API_KEY });
+const wrapAISDK = await getAISDKWrapper();
+const { generateText } = wrapAISDK(ai);
+
+const { text } = await generateText({
+  model: openai('gpt-4o-mini'),
+  prompt: 'What is TypeScript?',
+});
+
+await shutdown();
+```
+
 ## Configuration
 
 ### Environment Variables
@@ -559,6 +586,7 @@ See the [`examples/`](./examples/) directory for complete, runnable examples:
 | [`prompt-management.ts`](./examples/prompt-management.ts) | PromptTemplate + trace() for prompt versioning |
 | [`multi-agent-workflow.ts`](./examples/multi-agent-workflow.ts) | Nested spans: WORKFLOW → AGENT → TOOL |
 | [`custom-spans.ts`](./examples/custom-spans.ts) | All span kinds: WORKFLOW, CHAIN, AGENT, TOOL, RETRIEVER, EMBEDDING, GUARDRAIL |
+| [`sdk_examples/ai_sdk_basic/`](./examples/sdk_examples/ai_sdk_basic/) | Vercel AI SDK via `wrapAISDK` — generateText + streamText + tools |
 
 Run any example with:
 

package/dist/ai-sdk.cjs

@@ -0,0 +1,190 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/ai-sdk.ts
+var ai_sdk_exports = {};
+__export(ai_sdk_exports, {
+  createAITelemetry: () => createAITelemetry,
+  wrapAISDK: () => wrapAISDK
+});
+module.exports = __toCommonJS(ai_sdk_exports);
+var import_api = require("@opentelemetry/api");
+var TRACER_NAME = "neatlogs.ai-sdk";
+function createAITelemetry(opts = {}) {
+  const userMeta = opts.metadata ?? {};
+  return {
+    isEnabled: true,
+    recordInputs: true,
+    recordOutputs: true,
+    tracer: import_api.trace.getTracer(TRACER_NAME),
+    metadata: { ...userMeta, neatlogsWrapped: true }
+  };
+}
+function safeStringify(value) {
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return "";
+  }
+}
+function setInputValue(span, opts) {
+  if (opts && ("prompt" in opts || "messages" in opts)) {
+    const input = opts.messages ?? opts.prompt;
+    const stringified2 = safeStringify(input);
+    if (stringified2) {
+      span.setAttribute("input.value", stringified2);
+    }
+    return;
+  }
+  const stringified = safeStringify(opts);
+  if (stringified) {
+    span.setAttribute("input.value", stringified);
+  }
+}
+function setOutputValue(span, result) {
+  if (result && typeof result === "object") {
+    const r = result;
+    if ("text" in r && "finishReason" in r) {
+      const text = String(r.text ?? "");
+      if (text) {
+        span.setAttribute("output.value", text);
+      }
+      if (r.finishReason) {
+        span.setAttribute("gen_ai.finish_reason", String(r.finishReason));
+      }
+      return;
+    }
+  }
+  const stringified = safeStringify(result);
+  if (stringified) {
+    span.setAttribute("output.value", stringified);
+  }
+}
+var WRAPPED_FUNCTIONS = [
+  "generateText",
+  "streamText",
+  "generateObject",
+  "streamObject",
+  "embed",
+  "embedMany",
+  "rerank"
+];
+function wrapAISDK(aiModule) {
+  const wrapped = { ...aiModule };
+  for (const name of WRAPPED_FUNCTIONS) {
+    const original = aiModule[name];
+    if (typeof original !== "function") continue;
+    if (name === "streamText" || name === "streamObject") {
+      wrapped[name] = createSyncWrapper(name, original);
+    } else {
+      wrapped[name] = createAsyncWrapper(name, original);
+    }
+  }
+  return wrapped;
+}
+function rootSpanKind(name) {
+  if (name === "embed" || name === "embedMany" || name === "rerank") return "CHAIN";
+  return "WORKFLOW";
+}
+function getParentContext() {
+  const activeSpan = import_api.trace.getActiveSpan();
+  if (activeSpan) {
+    const instrScope = activeSpan.instrumentationLibrary?.name ?? "";
+    if (instrScope === "next.js") {
+      return import_api.ROOT_CONTEXT;
+    }
+  }
+  return import_api.context.active();
+}
+function createAsyncWrapper(name, original) {
+  return async function wrappedAsyncFn(opts) {
+    const tracer = import_api.trace.getTracer(TRACER_NAME);
+    return tracer.startActiveSpan(
+      `ai.${name}`,
+      { attributes: { "openinference.span.kind": rootSpanKind(name) } },
+      getParentContext(),
+      async (span) => {
+        try {
+          const isEmbedOrRerank = name === "embed" || name === "embedMany" || name === "rerank";
+          if (!isEmbedOrRerank) {
+            setInputValue(span, opts);
+          }
+          if (name === "rerank" && opts?.query) {
+            span.setAttribute("ai.rerank.query", String(opts.query));
+          }
+          const merged = mergeTelemetry(opts);
+          const result = await original(merged);
+          if (!isEmbedOrRerank) {
+            setOutputValue(span, result);
+          }
+          return result;
+        } catch (err) {
+          recordSpanError(span, err);
+          throw err;
+        } finally {
+          span.end();
+        }
+      }
+    );
+  };
+}
+function createSyncWrapper(name, original) {
+  return function wrappedSyncFn(opts) {
+    const tracer = import_api.trace.getTracer(TRACER_NAME);
+    return tracer.startActiveSpan(`ai.${name}`, { attributes: { "openinference.span.kind": rootSpanKind(name) } }, getParentContext(), (span) => {
+      try {
+        setInputValue(span, opts);
+        const merged = mergeTelemetry(opts);
+        const result = original(merged);
+        return result;
+      } catch (err) {
+        recordSpanError(span, err);
+        throw err;
+      } finally {
+        span.end();
+      }
+    });
+  };
+}
+function mergeTelemetry(opts) {
+  const baseTelemetry = createAITelemetry({
+    metadata: opts?.experimental_telemetry?.metadata
+  });
+  return {
+    ...opts,
+    experimental_telemetry: {
+      ...opts?.experimental_telemetry,
+      ...baseTelemetry
+    }
+  };
+}
+function recordSpanError(span, err) {
+  if (err instanceof Error) {
+    span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: err.message });
+    span.recordException(err);
+  } else {
+    span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: String(err) });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAITelemetry,
+  wrapAISDK
+});
+//# sourceMappingURL=ai-sdk.cjs.map

package/dist/ai-sdk.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ai-sdk.ts"],"sourcesContent":["/**\n * Vercel AI SDK wrapper — inline implementation.\n *\n * Wraps `generateText`, `streamText`, `generateObject`, `streamObject` from\n * the `ai` package with OTel parent spans + forced telemetry. Static export,\n * no dynamic imports — bundler-friendly (works with Turbopack, webpack, esbuild).\n *\n * Usage:\n *   import { wrapAISDK } from 'neatlogs';\n *   import * as ai from 'ai';\n *   const { streamText, generateText } = wrapAISDK(ai);\n */\n\nimport { trace, context as otelContext, ROOT_CONTEXT, SpanStatusCode, type Span, type Tracer } from '@opentelemetry/api';\n\nconst TRACER_NAME = 'neatlogs.ai-sdk';\n\n// -- Telemetry config --------------------------------------------------------\n\nexport interface CreateAITelemetryOptions {\n  metadata?: Record<string, unknown>;\n}\n\nexport interface AITelemetryConfig {\n  isEnabled: true;\n  recordInputs: true;\n  recordOutputs: true;\n  tracer: Tracer;\n  metadata: Record<string, unknown>;\n}\n\nexport function createAITelemetry(\n  opts: CreateAITelemetryOptions = {},\n): AITelemetryConfig {\n  const userMeta = opts.metadata ?? {};\n  return {\n    isEnabled: true,\n    recordInputs: true,\n    recordOutputs: true,\n    tracer: trace.getTracer(TRACER_NAME),\n    metadata: { ...userMeta, neatlogsWrapped: true },\n  };\n}\n\n// -- Span attributes ---------------------------------------------------------\n\nfunction safeStringify(value: unknown): string {\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return '';\n  }\n}\n\nfunction setInputValue(span: Span, opts: Record<string, unknown>): void {\n  // For generateText/streamText — only capture prompt or messages, not full model config\n  if (opts && ('prompt' in opts || 'messages' in opts)) {\n    const input = opts.messages ?? opts.prompt;\n    const stringified = safeStringify(input);\n    if (stringified) {\n      span.setAttribute('input.value', stringified);\n    }\n    return;\n  }\n  const stringified = safeStringify(opts);\n  if (stringified) {\n    span.setAttribute('input.value', stringified);\n  }\n}\n\nfunction setOutputValue(span: Span, result: unknown): void {\n  if (result && typeof result === 'object') {\n    const r = result as Record<string, unknown>;\n    // GenerateTextResult / StreamTextResult — extract meaningful fields\n    if ('text' in r && 'finishReason' in r) {\n      const text = String(r.text ?? '');\n      if (text) {\n        span.setAttribute('output.value', text);\n      }\n      if (r.finishReason) {\n        span.setAttribute('gen_ai.finish_reason', String(r.finishReason));\n      }\n      return;\n    }\n  }\n  const stringified = safeStringify(result);\n  if (stringified) {\n    span.setAttribute('output.value', stringified);\n  }\n}\n\n// -- Wrapping ----------------------------------------------------------------\n\ntype WrappedFunctionName = 'generateText' | 'streamText' | 'generateObject' | 'streamObject' | 'embed' | 'embedMany' | 'rerank';\n\nconst WRAPPED_FUNCTIONS: readonly WrappedFunctionName[] = [\n  'generateText',\n  'streamText',\n  'generateObject',\n  'streamObject',\n  'embed',\n  'embedMany',\n  'rerank',\n] as const;\n\n/**\n * Wrap the `ai` module namespace so that every `generateText` / `streamText` /\n * `generateObject` / `streamObject` call:\n *\n *   1. Opens a parent OTel span on the active TracerProvider.\n *   2. Forces `experimental_telemetry: { isEnabled: true }`, merging user metadata.\n *   3. Records input/output on the parent span and propagates errors.\n *\n * Other exports (types, helpers) pass through unchanged.\n */\nexport function wrapAISDK<T extends Record<string, unknown>>(aiModule: T): T {\n  const wrapped: Record<string, unknown> = { ...aiModule };\n\n  for (const name of WRAPPED_FUNCTIONS) {\n    const original = aiModule[name];\n    if (typeof original !== 'function') continue;\n\n    if (name === 'streamText' || name === 'streamObject') {\n      wrapped[name] = createSyncWrapper(name, original as (opts: any) => unknown);\n    } else {\n      wrapped[name] = createAsyncWrapper(name, original as (opts: any) => Promise<unknown>);\n    }\n  }\n\n  return wrapped as T;\n}\n\nfunction rootSpanKind(name: WrappedFunctionName): string {\n  if (name === 'embed' || name === 'embedMany' || name === 'rerank') return 'CHAIN';\n  return 'WORKFLOW';\n}\n\n\nfunction getParentContext() {\n  const activeSpan = trace.getActiveSpan();\n  if (activeSpan) {\n    const instrScope = (activeSpan as any).instrumentationLibrary?.name ?? '';\n    if (instrScope === 'next.js') {\n      return ROOT_CONTEXT;\n    }\n  }\n  return otelContext.active();\n}\n\nfunction createAsyncWrapper(\n  name: WrappedFunctionName,\n  original: (opts: any) => Promise<unknown>,\n): (opts: any) => Promise<unknown> {\n  return async function wrappedAsyncFn(opts: any): Promise<unknown> {\n    const tracer = trace.getTracer(TRACER_NAME);\n    return tracer.startActiveSpan(\n      `ai.${name}`,\n      { attributes: { 'openinference.span.kind': rootSpanKind(name) } },\n      getParentContext(),\n      async (span) => {\n        try {\n          const isEmbedOrRerank = name === 'embed' || name === 'embedMany' || name === 'rerank';\n          if (!isEmbedOrRerank) {\n            setInputValue(span, opts);\n          }\n          if (name === 'rerank' && opts?.query) {\n            span.setAttribute('ai.rerank.query', String(opts.query));\n          }\n          const merged = mergeTelemetry(opts);\n          const result = await original(merged);\n          if (!isEmbedOrRerank) {\n            setOutputValue(span, result);\n          }\n          return result;\n        } catch (err) {\n          recordSpanError(span, err);\n          throw err;\n        } finally {\n          span.end();\n        }\n      },\n    );\n  };\n}\n\nfunction createSyncWrapper(\n  name: WrappedFunctionName,\n  original: (opts: any) => unknown,\n): (opts: any) => unknown {\n  return function wrappedSyncFn(opts: any): unknown {\n    const tracer = trace.getTracer(TRACER_NAME);\n    return tracer.startActiveSpan(`ai.${name}`, { attributes: { 'openinference.span.kind': rootSpanKind(name) } }, getParentContext(), (span) => {\n      try {\n        setInputValue(span, opts);\n        const merged = mergeTelemetry(opts);\n        const result = original(merged);\n        return result;\n      } catch (err) {\n        recordSpanError(span, err);\n        throw err;\n      } finally {\n        span.end();\n      }\n    });\n  };\n}\n\nfunction mergeTelemetry(opts: any): any {\n  const baseTelemetry: AITelemetryConfig = createAITelemetry({\n    metadata: opts?.experimental_telemetry?.metadata,\n  });\n  return {\n    ...opts,\n    experimental_telemetry: {\n      ...opts?.experimental_telemetry,\n      ...baseTelemetry,\n    },\n  };\n}\n\n\nfunction recordSpanError(span: Span, err: unknown): void {\n  if (err instanceof Error) {\n    span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });\n    span.recordException(err);\n  } else {\n    span.setStatus({ code: SpanStatusCode.ERROR, message: String(err) });\n  }\n}\n"],"mappings":"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","names":["stringified","otelContext"]}

package/dist/ai-sdk.d.ts

@@ -0,0 +1,39 @@
+import { Tracer } from '@opentelemetry/api';
+
+/**
+ * Vercel AI SDK wrapper — inline implementation.
+ *
+ * Wraps `generateText`, `streamText`, `generateObject`, `streamObject` from
+ * the `ai` package with OTel parent spans + forced telemetry. Static export,
+ * no dynamic imports — bundler-friendly (works with Turbopack, webpack, esbuild).
+ *
+ * Usage:
+ *   import { wrapAISDK } from 'neatlogs';
+ *   import * as ai from 'ai';
+ *   const { streamText, generateText } = wrapAISDK(ai);
+ */
+
+interface CreateAITelemetryOptions {
+    metadata?: Record<string, unknown>;
+}
+interface AITelemetryConfig {
+    isEnabled: true;
+    recordInputs: true;
+    recordOutputs: true;
+    tracer: Tracer;
+    metadata: Record<string, unknown>;
+}
+declare function createAITelemetry(opts?: CreateAITelemetryOptions): AITelemetryConfig;
+/**
+ * Wrap the `ai` module namespace so that every `generateText` / `streamText` /
+ * `generateObject` / `streamObject` call:
+ *
+ *   1. Opens a parent OTel span on the active TracerProvider.
+ *   2. Forces `experimental_telemetry: { isEnabled: true }`, merging user metadata.
+ *   3. Records input/output on the parent span and propagates errors.
+ *
+ * Other exports (types, helpers) pass through unchanged.
+ */
+declare function wrapAISDK<T extends Record<string, unknown>>(aiModule: T): T;
+
+export { type AITelemetryConfig, type CreateAITelemetryOptions, createAITelemetry, wrapAISDK };

package/dist/ai-sdk.mjs

@@ -0,0 +1,164 @@
+// src/ai-sdk.ts
+import { trace, context as otelContext, ROOT_CONTEXT, SpanStatusCode } from "@opentelemetry/api";
+var TRACER_NAME = "neatlogs.ai-sdk";
+function createAITelemetry(opts = {}) {
+  const userMeta = opts.metadata ?? {};
+  return {
+    isEnabled: true,
+    recordInputs: true,
+    recordOutputs: true,
+    tracer: trace.getTracer(TRACER_NAME),
+    metadata: { ...userMeta, neatlogsWrapped: true }
+  };
+}
+function safeStringify(value) {
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return "";
+  }
+}
+function setInputValue(span, opts) {
+  if (opts && ("prompt" in opts || "messages" in opts)) {
+    const input = opts.messages ?? opts.prompt;
+    const stringified2 = safeStringify(input);
+    if (stringified2) {
+      span.setAttribute("input.value", stringified2);
+    }
+    return;
+  }
+  const stringified = safeStringify(opts);
+  if (stringified) {
+    span.setAttribute("input.value", stringified);
+  }
+}
+function setOutputValue(span, result) {
+  if (result && typeof result === "object") {
+    const r = result;
+    if ("text" in r && "finishReason" in r) {
+      const text = String(r.text ?? "");
+      if (text) {
+        span.setAttribute("output.value", text);
+      }
+      if (r.finishReason) {
+        span.setAttribute("gen_ai.finish_reason", String(r.finishReason));
+      }
+      return;
+    }
+  }
+  const stringified = safeStringify(result);
+  if (stringified) {
+    span.setAttribute("output.value", stringified);
+  }
+}
+var WRAPPED_FUNCTIONS = [
+  "generateText",
+  "streamText",
+  "generateObject",
+  "streamObject",
+  "embed",
+  "embedMany",
+  "rerank"
+];
+function wrapAISDK(aiModule) {
+  const wrapped = { ...aiModule };
+  for (const name of WRAPPED_FUNCTIONS) {
+    const original = aiModule[name];
+    if (typeof original !== "function") continue;
+    if (name === "streamText" || name === "streamObject") {
+      wrapped[name] = createSyncWrapper(name, original);
+    } else {
+      wrapped[name] = createAsyncWrapper(name, original);
+    }
+  }
+  return wrapped;
+}
+function rootSpanKind(name) {
+  if (name === "embed" || name === "embedMany" || name === "rerank") return "CHAIN";
+  return "WORKFLOW";
+}
+function getParentContext() {
+  const activeSpan = trace.getActiveSpan();
+  if (activeSpan) {
+    const instrScope = activeSpan.instrumentationLibrary?.name ?? "";
+    if (instrScope === "next.js") {
+      return ROOT_CONTEXT;
+    }
+  }
+  return otelContext.active();
+}
+function createAsyncWrapper(name, original) {
+  return async function wrappedAsyncFn(opts) {
+    const tracer = trace.getTracer(TRACER_NAME);
+    return tracer.startActiveSpan(
+      `ai.${name}`,
+      { attributes: { "openinference.span.kind": rootSpanKind(name) } },
+      getParentContext(),
+      async (span) => {
+        try {
+          const isEmbedOrRerank = name === "embed" || name === "embedMany" || name === "rerank";
+          if (!isEmbedOrRerank) {
+            setInputValue(span, opts);
+          }
+          if (name === "rerank" && opts?.query) {
+            span.setAttribute("ai.rerank.query", String(opts.query));
+          }
+          const merged = mergeTelemetry(opts);
+          const result = await original(merged);
+          if (!isEmbedOrRerank) {
+            setOutputValue(span, result);
+          }
+          return result;
+        } catch (err) {
+          recordSpanError(span, err);
+          throw err;
+        } finally {
+          span.end();
+        }
+      }
+    );
+  };
+}
+function createSyncWrapper(name, original) {
+  return function wrappedSyncFn(opts) {
+    const tracer = trace.getTracer(TRACER_NAME);
+    return tracer.startActiveSpan(`ai.${name}`, { attributes: { "openinference.span.kind": rootSpanKind(name) } }, getParentContext(), (span) => {
+      try {
+        setInputValue(span, opts);
+        const merged = mergeTelemetry(opts);
+        const result = original(merged);
+        return result;
+      } catch (err) {
+        recordSpanError(span, err);
+        throw err;
+      } finally {
+        span.end();
+      }
+    });
+  };
+}
+function mergeTelemetry(opts) {
+  const baseTelemetry = createAITelemetry({
+    metadata: opts?.experimental_telemetry?.metadata
+  });
+  return {
+    ...opts,
+    experimental_telemetry: {
+      ...opts?.experimental_telemetry,
+      ...baseTelemetry
+    }
+  };
+}
+function recordSpanError(span, err) {
+  if (err instanceof Error) {
+    span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
+    span.recordException(err);
+  } else {
+    span.setStatus({ code: SpanStatusCode.ERROR, message: String(err) });
+  }
+}
+export {
+  createAITelemetry,
+  wrapAISDK
+};
+//# sourceMappingURL=ai-sdk.mjs.map

package/dist/ai-sdk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ai-sdk.ts"],"sourcesContent":["/**\n * Vercel AI SDK wrapper — inline implementation.\n *\n * Wraps `generateText`, `streamText`, `generateObject`, `streamObject` from\n * the `ai` package with OTel parent spans + forced telemetry. Static export,\n * no dynamic imports — bundler-friendly (works with Turbopack, webpack, esbuild).\n *\n * Usage:\n *   import { wrapAISDK } from 'neatlogs';\n *   import * as ai from 'ai';\n *   const { streamText, generateText } = wrapAISDK(ai);\n */\n\nimport { trace, context as otelContext, ROOT_CONTEXT, SpanStatusCode, type Span, type Tracer } from '@opentelemetry/api';\n\nconst TRACER_NAME = 'neatlogs.ai-sdk';\n\n// -- Telemetry config --------------------------------------------------------\n\nexport interface CreateAITelemetryOptions {\n  metadata?: Record<string, unknown>;\n}\n\nexport interface AITelemetryConfig {\n  isEnabled: true;\n  recordInputs: true;\n  recordOutputs: true;\n  tracer: Tracer;\n  metadata: Record<string, unknown>;\n}\n\nexport function createAITelemetry(\n  opts: CreateAITelemetryOptions = {},\n): AITelemetryConfig {\n  const userMeta = opts.metadata ?? {};\n  return {\n    isEnabled: true,\n    recordInputs: true,\n    recordOutputs: true,\n    tracer: trace.getTracer(TRACER_NAME),\n    metadata: { ...userMeta, neatlogsWrapped: true },\n  };\n}\n\n// -- Span attributes ---------------------------------------------------------\n\nfunction safeStringify(value: unknown): string {\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return '';\n  }\n}\n\nfunction setInputValue(span: Span, opts: Record<string, unknown>): void {\n  // For generateText/streamText — only capture prompt or messages, not full model config\n  if (opts && ('prompt' in opts || 'messages' in opts)) {\n    const input = opts.messages ?? opts.prompt;\n    const stringified = safeStringify(input);\n    if (stringified) {\n      span.setAttribute('input.value', stringified);\n    }\n    return;\n  }\n  const stringified = safeStringify(opts);\n  if (stringified) {\n    span.setAttribute('input.value', stringified);\n  }\n}\n\nfunction setOutputValue(span: Span, result: unknown): void {\n  if (result && typeof result === 'object') {\n    const r = result as Record<string, unknown>;\n    // GenerateTextResult / StreamTextResult — extract meaningful fields\n    if ('text' in r && 'finishReason' in r) {\n      const text = String(r.text ?? '');\n      if (text) {\n        span.setAttribute('output.value', text);\n      }\n      if (r.finishReason) {\n        span.setAttribute('gen_ai.finish_reason', String(r.finishReason));\n      }\n      return;\n    }\n  }\n  const stringified = safeStringify(result);\n  if (stringified) {\n    span.setAttribute('output.value', stringified);\n  }\n}\n\n// -- Wrapping ----------------------------------------------------------------\n\ntype WrappedFunctionName = 'generateText' | 'streamText' | 'generateObject' | 'streamObject' | 'embed' | 'embedMany' | 'rerank';\n\nconst WRAPPED_FUNCTIONS: readonly WrappedFunctionName[] = [\n  'generateText',\n  'streamText',\n  'generateObject',\n  'streamObject',\n  'embed',\n  'embedMany',\n  'rerank',\n] as const;\n\n/**\n * Wrap the `ai` module namespace so that every `generateText` / `streamText` /\n * `generateObject` / `streamObject` call:\n *\n *   1. Opens a parent OTel span on the active TracerProvider.\n *   2. Forces `experimental_telemetry: { isEnabled: true }`, merging user metadata.\n *   3. Records input/output on the parent span and propagates errors.\n *\n * Other exports (types, helpers) pass through unchanged.\n */\nexport function wrapAISDK<T extends Record<string, unknown>>(aiModule: T): T {\n  const wrapped: Record<string, unknown> = { ...aiModule };\n\n  for (const name of WRAPPED_FUNCTIONS) {\n    const original = aiModule[name];\n    if (typeof original !== 'function') continue;\n\n    if (name === 'streamText' || name === 'streamObject') {\n      wrapped[name] = createSyncWrapper(name, original as (opts: any) => unknown);\n    } else {\n      wrapped[name] = createAsyncWrapper(name, original as (opts: any) => Promise<unknown>);\n    }\n  }\n\n  return wrapped as T;\n}\n\nfunction rootSpanKind(name: WrappedFunctionName): string {\n  if (name === 'embed' || name === 'embedMany' || name === 'rerank') return 'CHAIN';\n  return 'WORKFLOW';\n}\n\n\nfunction getParentContext() {\n  const activeSpan = trace.getActiveSpan();\n  if (activeSpan) {\n    const instrScope = (activeSpan as any).instrumentationLibrary?.name ?? '';\n    if (instrScope === 'next.js') {\n      return ROOT_CONTEXT;\n    }\n  }\n  return otelContext.active();\n}\n\nfunction createAsyncWrapper(\n  name: WrappedFunctionName,\n  original: (opts: any) => Promise<unknown>,\n): (opts: any) => Promise<unknown> {\n  return async function wrappedAsyncFn(opts: any): Promise<unknown> {\n    const tracer = trace.getTracer(TRACER_NAME);\n    return tracer.startActiveSpan(\n      `ai.${name}`,\n      { attributes: { 'openinference.span.kind': rootSpanKind(name) } },\n      getParentContext(),\n      async (span) => {\n        try {\n          const isEmbedOrRerank = name === 'embed' || name === 'embedMany' || name === 'rerank';\n          if (!isEmbedOrRerank) {\n            setInputValue(span, opts);\n          }\n          if (name === 'rerank' && opts?.query) {\n            span.setAttribute('ai.rerank.query', String(opts.query));\n          }\n          const merged = mergeTelemetry(opts);\n          const result = await original(merged);\n          if (!isEmbedOrRerank) {\n            setOutputValue(span, result);\n          }\n          return result;\n        } catch (err) {\n          recordSpanError(span, err);\n          throw err;\n        } finally {\n          span.end();\n        }\n      },\n    );\n  };\n}\n\nfunction createSyncWrapper(\n  name: WrappedFunctionName,\n  original: (opts: any) => unknown,\n): (opts: any) => unknown {\n  return function wrappedSyncFn(opts: any): unknown {\n    const tracer = trace.getTracer(TRACER_NAME);\n    return tracer.startActiveSpan(`ai.${name}`, { attributes: { 'openinference.span.kind': rootSpanKind(name) } }, getParentContext(), (span) => {\n      try {\n        setInputValue(span, opts);\n        const merged = mergeTelemetry(opts);\n        const result = original(merged);\n        return result;\n      } catch (err) {\n        recordSpanError(span, err);\n        throw err;\n      } finally {\n        span.end();\n      }\n    });\n  };\n}\n\nfunction mergeTelemetry(opts: any): any {\n  const baseTelemetry: AITelemetryConfig = createAITelemetry({\n    metadata: opts?.experimental_telemetry?.metadata,\n  });\n  return {\n    ...opts,\n    experimental_telemetry: {\n      ...opts?.experimental_telemetry,\n      ...baseTelemetry,\n    },\n  };\n}\n\n\nfunction recordSpanError(span: Span, err: unknown): void {\n  if (err instanceof Error) {\n    span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });\n    span.recordException(err);\n  } else {\n    span.setStatus({ code: SpanStatusCode.ERROR, message: String(err) });\n  }\n}\n"],"mappings":"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","names":["stringified"]}