@posthog/ai 7.14.0 → 7.15.0

package/README.md

@@ -41,23 +41,29 @@ await phClient.shutdown()
 
 ## OpenTelemetry
 
-`@posthog/ai` provides a `PostHogTraceExporter` that sends OpenTelemetry traces to PostHog's OTLP ingestion endpoint. PostHog converts `gen_ai.*` spans into `$ai_generation` events server-side. This works with any LLM provider SDK that supports OpenTelemetry.
+`@posthog/ai/otel` provides two ways to send AI traces to PostHog via OpenTelemetry. Both automatically filter to AI-related spans only (`gen_ai.*`, `llm.*`, `ai.*`, `traceloop.*`) and PostHog converts them into `$ai_generation` events server-side. This works with any LLM provider SDK that supports OpenTelemetry.
 
 ```bash
-npm install @posthog/ai @opentelemetry/sdk-node @opentelemetry/exporter-trace-otlp-http
+npm install @posthog/ai @opentelemetry/sdk-node @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http
 ```
 
+### PostHogSpanProcessor (recommended)
+
+A self-contained `SpanProcessor` that handles batching and export internally. Use this when your setup accepts a span processor.
+
 ```typescript
 import { NodeSDK } from '@opentelemetry/sdk-node'
+import { PostHogSpanProcessor } from '@posthog/ai/otel'
 import { generateText } from 'ai'
 import { openai } from '@ai-sdk/openai'
-import { PostHogTraceExporter } from '@posthog/ai/otel'
 
 const sdk = new NodeSDK({
-  traceExporter: new PostHogTraceExporter({
-    apiKey: '<YOUR_PROJECT_API_KEY>',
-    host: 'https://us.i.posthog.com', // optional, defaults to https://us.i.posthog.com
-  }),
+  spanProcessors: [
+    new PostHogSpanProcessor({
+      apiKey: '<YOUR_PROJECT_API_KEY>',
+      host: 'https://us.i.posthog.com', // optional, defaults to https://us.i.posthog.com
+    }),
+  ],
 })
 sdk.start()
 
@@ -77,6 +83,23 @@ const result = await generateText({
 await sdk.shutdown()
 ```
 
+### PostHogTraceExporter
+
+A `TraceExporter` for APIs that only accept an exporter, such as Vercel's `registerOTel`.
+
+```typescript
+import { PostHogTraceExporter } from '@posthog/ai/otel'
+import { registerOTel } from '@vercel/otel'
+
+registerOTel({
+  serviceName: 'my-app',
+  traceExporter: new PostHogTraceExporter({
+    apiKey: '<YOUR_PROJECT_API_KEY>',
+    host: 'https://us.i.posthog.com', // optional, defaults to https://us.i.posthog.com
+  }),
+})
+```
+
 LLM Observability [docs](https://posthog.com/docs/ai-engineering/observability)
 
 Please see the main [PostHog docs](https://www.posthog.com/docs).

package/dist/anthropic/index.cjs

@@ -10,7 +10,7 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var AnthropicOriginal__default = /*#__PURE__*/_interopDefault(AnthropicOriginal);
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking
 

package/dist/anthropic/index.mjs

@@ -2,7 +2,7 @@ import AnthropicOriginal from '@anthropic-ai/sdk';
 import { v4 } from 'uuid';
 import { uuidv7 } from '@posthog/core';
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking
 

package/dist/gemini/index.cjs

@@ -6,7 +6,7 @@ var genai = require('@google/genai');
 var uuid = require('uuid');
 var core = require('@posthog/core');
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking
 

package/dist/gemini/index.mjs

@@ -2,7 +2,7 @@ import { GoogleGenAI } from '@google/genai';
 import { v4 } from 'uuid';
 import { uuidv7 } from '@posthog/core';
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking
 

package/dist/index.cjs

@@ -29,7 +29,7 @@ function _interopNamespace(e) {
 var uuid__namespace = /*#__PURE__*/_interopNamespace(uuid);
 var AnthropicOriginal__default = /*#__PURE__*/_interopDefault(AnthropicOriginal);
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking
 const isString = value => {

package/dist/index.mjs

@@ -5,7 +5,7 @@ import { uuidv7 } from '@posthog/core';
 import AnthropicOriginal from '@anthropic-ai/sdk';
 import { GoogleGenAI } from '@google/genai';
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking
 const isString = value => {

package/dist/langchain/index.cjs

@@ -23,7 +23,7 @@ function _interopNamespace(e) {
 
 var uuid__namespace = /*#__PURE__*/_interopNamespace(uuid);
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking
 

package/dist/langchain/index.mjs

@@ -1,7 +1,7 @@
 import * as uuid from 'uuid';
 import '@posthog/core';
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking
 

package/dist/openai/index.cjs

@@ -6,7 +6,7 @@ var openai = require('openai');
 var uuid = require('uuid');
 var core = require('@posthog/core');
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking
 

package/dist/openai/index.mjs

@@ -2,7 +2,7 @@ import { OpenAI } from 'openai';
 import { v4 } from 'uuid';
 import { uuidv7 } from '@posthog/core';
 
-var version = "7.14.0";
+var version = "7.15.0";
 
 // Type guards for safer type checking