@mastra/langfuse 0.0.0-vector-query-tool-provider-options-20250828222356

package/CHANGELOG.md

@@ -0,0 +1,71 @@
+# @mastra/langfuse
+
+## 0.0.0-vector-query-tool-provider-options-20250828222356
+
+### Patch Changes
+
+- Updated dependencies [[`637f323`](https://github.com/mastra-ai/mastra/commit/637f32371d79a8f78c52c0d53411af0915fcec67), [`29de0e1`](https://github.com/mastra-ai/mastra/commit/29de0e1b0a7173317ae7d1ab0c0993167c659f2b), [`00c74e7`](https://github.com/mastra-ai/mastra/commit/00c74e73b1926be0d475693bb886fb67a22ff352), [`6ac697e`](https://github.com/mastra-ai/mastra/commit/6ac697edcc2435482c247cba615277ec4765dcc4), [`af90672`](https://github.com/mastra-ai/mastra/commit/af906722d8da28688882193b1e531026f9e2e81e), [`56041d0`](https://github.com/mastra-ai/mastra/commit/56041d018863a3da6b98c512e47348647c075fb3), [`5de1555`](https://github.com/mastra-ai/mastra/commit/5de15554d3d6695211945a36928f6657e76cddc9), [`1ed5a3e`](https://github.com/mastra-ai/mastra/commit/1ed5a3e19330374c4347a4237cd2f4b9ffb60376)]:
+  - @mastra/core@0.0.0-vector-query-tool-provider-options-20250828222356
+
+## 0.0.4
+
+### Patch Changes
+
+- [`c6113ed`](https://github.com/mastra-ai/mastra/commit/c6113ed7f9df297e130d94436ceee310273d6430) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix peerdpes for @mastra/core
+
+- Updated dependencies []:
+  - @mastra/core@0.15.2
+
+## 0.0.3
+
+### Patch Changes
+
+- [`95b2aa9`](https://github.com/mastra-ai/mastra/commit/95b2aa908230919e67efcac0d69005a2d5745298) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix peerdeps @mastra/core
+
+- Updated dependencies []:
+  - @mastra/core@0.15.1
+
+## 0.0.2
+
+### Patch Changes
+
+- 03997ae: Update peerdeps
+- e1a81da: initial release of LangFuse AI Observability exporter
+- Updated dependencies [227c7e6]
+- Updated dependencies [12cae67]
+- Updated dependencies [fd3a3eb]
+- Updated dependencies [6faaee5]
+- Updated dependencies [4232b14]
+- Updated dependencies [a89de7e]
+- Updated dependencies [5a37d0c]
+- Updated dependencies [4bde0cb]
+- Updated dependencies [cf4f357]
+- Updated dependencies [ad888a2]
+- Updated dependencies [481751d]
+- Updated dependencies [2454423]
+- Updated dependencies [194e395]
+- Updated dependencies [a722c0b]
+- Updated dependencies [c30bca8]
+- Updated dependencies [3b5fec7]
+- Updated dependencies [a8f129d]
+  - @mastra/core@0.14.0
+
+## 0.0.2-alpha.1
+
+### Patch Changes
+
+- 03997ae: Update peerdeps
+  - @mastra/core@0.14.0-alpha.7
+
+## 0.0.2-alpha.0
+
+### Patch Changes
+
+- e1a81da: initial release of LangFuse AI Observability exporter
+- Updated dependencies [6faaee5]
+- Updated dependencies [4232b14]
+- Updated dependencies [a89de7e]
+- Updated dependencies [cf4f357]
+- Updated dependencies [a722c0b]
+- Updated dependencies [3b5fec7]
+  - @mastra/core@0.14.0-alpha.1

package/LICENSE.md

@@ -0,0 +1,15 @@
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,49 @@
+# @mastra/langfuse
+
+Langfuse AI Observability exporter for Mastra applications.
+
+## Installation
+
+```bash
+npm install @mastra/langfuse
+```
+
+## Usage
+
+```typescript
+import { LangfuseExporter } from '@mastra/langfuse';
+
+// Use with Mastra
+const mastra = new Mastra({
+  ...,
+  observability: {
+    instances: {
+      langfuse: {
+        serviceName: 'service',
+        exporters: [
+          new LangfuseExporter({
+            publicKey: process.env.LANGFUSE_PUBLIC_KEY,
+            secretKey: process.env.LANGFUSE_SECRET_KEY,
+            baseUrl: process.env.LANGFUSE_BASE_URL,
+            realtime: true,
+          }),
+        ],
+      },
+    },
+  },
+});
+```
+
+## Features
+
+### AI Tracing
+
+- **Automatic span mapping**: Root spans become Langfuse traces
+- **LLM generation support**: `LLM_GENERATION` spans become Langfuse generations with token usage
+- **Type-specific metadata**: Extracts relevant metadata for each span type (agents, tools, workflows)
+- **Error tracking**: Automatic error status and message tracking
+- **Hierarchical traces**: Maintains parent-child relationships
+
+## License
+
+Apache 2.0

package/dist/ai-tracing.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Langfuse Exporter for Mastra AI Tracing
+ *
+ * This exporter sends tracing data to Langfuse for AI observability.
+ * Root spans start traces in Langfuse.
+ * LLM_GENERATION spans become Langfuse generations, all others become spans.
+ */
+import type { AITracingExporter, AITracingEvent } from '@mastra/core/ai-tracing';
+export interface LangfuseExporterConfig {
+    /** Langfuse API key */
+    publicKey: string;
+    /** Langfuse secret key */
+    secretKey: string;
+    /** Langfuse host URL */
+    baseUrl: string;
+    /** Enable realtime mode - flushes after each event for immediate visibility */
+    realtime?: boolean;
+    /** Additional options to pass to the Langfuse client */
+    options?: any;
+}
+export declare class LangfuseExporter implements AITracingExporter {
+    name: string;
+    private client;
+    private realtime;
+    private traceMap;
+    constructor(config: LangfuseExporterConfig);
+    exportEvent(event: AITracingEvent): Promise<void>;
+    private handleSpanStarted;
+    private handleSpanUpdateOrEnd;
+    private buildTracePayload;
+    private buildSpanPayload;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=ai-tracing.d.ts.map

package/dist/ai-tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tracing.d.ts","sourceRoot":"","sources":["../src/ai-tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAsC,MAAM,yBAAyB,CAAC;AAKrH,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AASD,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,IAAI,SAAc;IAClB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAgC;gBAEpC,MAAM,EAAE,sBAAsB;IAUpC,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAmBzC,iBAAiB;YA0BjB,qBAAqB;IA2BnC,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,gBAAgB;IAmDlB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}

package/dist/index.cjs

@@ -0,0 +1,135 @@
+'use strict';
+
+var aiTracing = require('@mastra/core/ai-tracing');
+var langfuse = require('langfuse');
+
+// src/ai-tracing.ts
+var LangfuseExporter = class {
+  name = "langfuse";
+  client;
+  realtime;
+  traceMap = /* @__PURE__ */ new Map();
+  constructor(config) {
+    this.realtime = config.realtime ?? false;
+    this.client = new langfuse.Langfuse({
+      publicKey: config.publicKey,
+      secretKey: config.secretKey,
+      baseUrl: config.baseUrl,
+      ...config.options
+    });
+  }
+  async exportEvent(event) {
+    switch (event.type) {
+      case "span_started":
+        await this.handleSpanStarted(event.span);
+        break;
+      case "span_updated":
+        await this.handleSpanUpdateOrEnd(event.span, true);
+        break;
+      case "span_ended":
+        await this.handleSpanUpdateOrEnd(event.span, false);
+        break;
+    }
+    if (this.realtime) {
+      await this.client.flushAsync();
+    }
+  }
+  async handleSpanStarted(span) {
+    if (span.isRootSpan) {
+      const trace = this.client.trace(this.buildTracePayload(span));
+      this.traceMap.set(span.trace.id, { trace, spans: /* @__PURE__ */ new Map() });
+    }
+    const traceData = this.traceMap.get(span.trace.id);
+    if (!traceData) {
+      console.log("NO TRACE");
+      return;
+    }
+    const langfuseParent = span.parent && traceData.spans.has(span.parent.id) ? traceData.spans.get(span.parent.id) : traceData.trace;
+    const payload = this.buildSpanPayload(span, true);
+    const langfuseSpan = span.type === aiTracing.AISpanType.LLM_GENERATION ? langfuseParent.generation(payload) : langfuseParent.span(payload);
+    traceData.spans.set(span.id, langfuseSpan);
+  }
+  async handleSpanUpdateOrEnd(span, isUpdate) {
+    const traceData = this.traceMap.get(span.trace.id);
+    if (!traceData) {
+      console.log("NO TRACE");
+      return;
+    }
+    const langfuseSpan = traceData.spans.get(span.id);
+    if (!langfuseSpan) {
+      console.log("NO SPAN");
+      return;
+    }
+    if (isUpdate) {
+      langfuseSpan.update(this.buildSpanPayload(span, false));
+    } else {
+      langfuseSpan.end(this.buildSpanPayload(span, false));
+      if (span.isRootSpan) {
+        traceData.trace.update({ output: span.output });
+        this.traceMap.delete(span.trace.id);
+      }
+    }
+  }
+  buildTracePayload(span) {
+    const payload = {
+      id: span.trace.id,
+      name: span.name
+    };
+    const { userId, sessionId, ...remainingMetadata } = span.metadata ?? {};
+    if (userId) payload.userId = userId;
+    if (sessionId) payload.sessionId = sessionId;
+    if (span.input) payload.input = span.input;
+    payload.metadata = {
+      spanType: span.type,
+      ...aiTracing.sanitizeMetadata(span.attributes),
+      ...aiTracing.sanitizeMetadata(remainingMetadata)
+    };
+    return payload;
+  }
+  buildSpanPayload(span, isCreate) {
+    const payload = {};
+    if (isCreate) {
+      payload.id = span.id;
+      payload.name = span.name;
+      payload.startTime = span.startTime;
+      if (span.input !== void 0) payload.input = span.input;
+    }
+    if (span.output !== void 0) payload.output = span.output;
+    if (span.endTime !== void 0) payload.endTime = span.endTime;
+    const attributes = span.attributes ?? {};
+    const attributesToOmit = [];
+    if (span.type === aiTracing.AISpanType.LLM_GENERATION) {
+      const llmAttr = attributes;
+      if (llmAttr.model !== void 0) {
+        payload.model = llmAttr.model;
+        attributesToOmit.push("model");
+      }
+      if (llmAttr.usage !== void 0) {
+        payload.usage = llmAttr.usage;
+        attributesToOmit.push("usage");
+      }
+      if (llmAttr.parameters !== void 0) {
+        payload.modelParameters = llmAttr.parameters;
+        attributesToOmit.push("parameters");
+      }
+    }
+    payload.metadata = {
+      spanType: span.type,
+      ...aiTracing.sanitizeMetadata(aiTracing.omitKeys(attributes, attributesToOmit)),
+      ...aiTracing.sanitizeMetadata(span.metadata)
+    };
+    if (span.errorInfo) {
+      payload.level = "ERROR";
+      payload.statusMessage = span.errorInfo.message;
+    }
+    return payload;
+  }
+  async shutdown() {
+    await this.client.shutdownAsync();
+    this.traceMap.clear();
+  }
+};
+
+exports.LangfuseExporter = LangfuseExporter;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ai-tracing.ts"],"names":["Langfuse","AISpanType","sanitizeMetadata","omitKeys"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Langfuse Exporter for Mastra AI Tracing\n *\n * This exporter sends tracing data to Langfuse for AI observability.\n * Root spans start traces in Langfuse.\n * LLM_GENERATION spans become Langfuse generations, all others become spans.\n */\n\nimport type { AITracingExporter, AITracingEvent, AnyAISpan, LLMGenerationAttributes } from '@mastra/core/ai-tracing';\nimport { AISpanType, sanitizeMetadata, omitKeys } from '@mastra/core/ai-tracing';\nimport { Langfuse } from 'langfuse';\nimport type { LangfuseTraceClient, LangfuseSpanClient, LangfuseGenerationClient } from 'langfuse';\n\nexport interface LangfuseExporterConfig {\n  /** Langfuse API key */\n  publicKey: string;\n  /** Langfuse secret key */\n  secretKey: string;\n  /** Langfuse host URL */\n  baseUrl: string;\n  /** Enable realtime mode - flushes after each event for immediate visibility */\n  realtime?: boolean;\n  /** Additional options to pass to the Langfuse client */\n  options?: any;\n}\n\ntype TraceData = {\n  trace: LangfuseTraceClient; // Langfuse trace object\n  spans: Map<string, LangfuseSpanClient | LangfuseGenerationClient>; // Maps span.id to Langfuse span/generation\n};\n\ntype LangfuseSpan = LangfuseTraceClient | LangfuseSpanClient | LangfuseGenerationClient;\n\nexport class LangfuseExporter implements AITracingExporter {\n  name = 'langfuse';\n  private client: Langfuse;\n  private realtime: boolean;\n  private traceMap = new Map<string, TraceData>();\n\n  constructor(config: LangfuseExporterConfig) {\n    this.realtime = config.realtime ?? false;\n    this.client = new Langfuse({\n      publicKey: config.publicKey,\n      secretKey: config.secretKey,\n      baseUrl: config.baseUrl,\n      ...config.options,\n    });\n  }\n\n  async exportEvent(event: AITracingEvent): Promise<void> {\n    switch (event.type) {\n      case 'span_started':\n        await this.handleSpanStarted(event.span);\n        break;\n      case 'span_updated':\n        await this.handleSpanUpdateOrEnd(event.span, true);\n        break;\n      case 'span_ended':\n        await this.handleSpanUpdateOrEnd(event.span, false);\n        break;\n    }\n\n    // Flush immediately in realtime mode for instant visibility\n    if (this.realtime) {\n      await this.client.flushAsync();\n    }\n  }\n\n  private async handleSpanStarted(span: AnyAISpan): Promise<void> {\n    if (span.isRootSpan) {\n      const trace = this.client.trace(this.buildTracePayload(span));\n      this.traceMap.set(span.trace.id, { trace, spans: new Map() });\n    }\n\n    const traceData = this.traceMap.get(span.trace.id);\n    if (!traceData) {\n      console.log('NO TRACE');\n      // TODO: log warning\n      return;\n    }\n\n    const langfuseParent =\n      span.parent && traceData.spans.has(span.parent.id)\n        ? (traceData.spans.get(span.parent.id) as LangfuseSpan)\n        : traceData.trace;\n\n    const payload = this.buildSpanPayload(span, true);\n\n    const langfuseSpan =\n      span.type === AISpanType.LLM_GENERATION ? langfuseParent.generation(payload) : langfuseParent.span(payload);\n\n    traceData.spans.set(span.id, langfuseSpan);\n  }\n\n  private async handleSpanUpdateOrEnd(span: AnyAISpan, isUpdate: boolean): Promise<void> {\n    const traceData = this.traceMap.get(span.trace.id);\n    if (!traceData) {\n      console.log('NO TRACE');\n      // TODO: log warning\n      return;\n    }\n\n    const langfuseSpan = traceData.spans.get(span.id);\n    if (!langfuseSpan) {\n      console.log('NO SPAN');\n      // TODO: log warning\n      return;\n    }\n\n    if (isUpdate) {\n      langfuseSpan.update(this.buildSpanPayload(span, false));\n    } else {\n      langfuseSpan.end(this.buildSpanPayload(span, false));\n\n      if (span.isRootSpan) {\n        traceData.trace.update({ output: span.output });\n        this.traceMap.delete(span.trace.id);\n      }\n    }\n  }\n\n  private buildTracePayload(span: AnyAISpan): Record<string, any> {\n    const payload: Record<string, any> = {\n      id: span.trace.id,\n      name: span.name,\n    };\n\n    const { userId, sessionId, ...remainingMetadata } = span.metadata ?? {};\n\n    if (userId) payload.userId = userId;\n    if (sessionId) payload.sessionId = sessionId;\n    if (span.input) payload.input = span.input;\n\n    payload.metadata = {\n      spanType: span.type,\n      ...sanitizeMetadata(span.attributes),\n      ...sanitizeMetadata(remainingMetadata),\n    };\n\n    return payload;\n  }\n\n  private buildSpanPayload(span: AnyAISpan, isCreate: boolean): Record<string, any> {\n    const payload: Record<string, any> = {};\n\n    if (isCreate) {\n      payload.id = span.id;\n      payload.name = span.name;\n      payload.startTime = span.startTime;\n      if (span.input !== undefined) payload.input = span.input;\n    }\n\n    if (span.output !== undefined) payload.output = span.output;\n    if (span.endTime !== undefined) payload.endTime = span.endTime;\n\n    const attributes = (span.attributes ?? {}) as Record<string, any>;\n\n    // Strip special fields from metadata if used in top-level keys\n    const attributesToOmit: string[] = [];\n\n    if (span.type === AISpanType.LLM_GENERATION) {\n      const llmAttr = attributes as LLMGenerationAttributes;\n\n      if (llmAttr.model !== undefined) {\n        payload.model = llmAttr.model;\n        attributesToOmit.push('model');\n      }\n\n      if (llmAttr.usage !== undefined) {\n        payload.usage = llmAttr.usage;\n        attributesToOmit.push('usage');\n      }\n\n      if (llmAttr.parameters !== undefined) {\n        payload.modelParameters = llmAttr.parameters;\n        attributesToOmit.push('parameters');\n      }\n    }\n\n    payload.metadata = {\n      spanType: span.type,\n      ...sanitizeMetadata(omitKeys(attributes, attributesToOmit)),\n      ...sanitizeMetadata(span.metadata),\n    };\n\n    if (span.errorInfo) {\n      payload.level = 'ERROR';\n      payload.statusMessage = span.errorInfo.message;\n    }\n\n    return payload;\n  }\n\n  async shutdown(): Promise<void> {\n    await this.client.shutdownAsync();\n    this.traceMap.clear();\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Langfuse Observability Provider for Mastra
+ *
+ * This package provides Langfuse-specific observability features for Mastra applications.
+ * Currently includes AI tracing support with plans for additional observability features.
+ */
+export * from './ai-tracing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,133 @@
+import { AISpanType, sanitizeMetadata, omitKeys } from '@mastra/core/ai-tracing';
+import { Langfuse } from 'langfuse';
+
+// src/ai-tracing.ts
+var LangfuseExporter = class {
+  name = "langfuse";
+  client;
+  realtime;
+  traceMap = /* @__PURE__ */ new Map();
+  constructor(config) {
+    this.realtime = config.realtime ?? false;
+    this.client = new Langfuse({
+      publicKey: config.publicKey,
+      secretKey: config.secretKey,
+      baseUrl: config.baseUrl,
+      ...config.options
+    });
+  }
+  async exportEvent(event) {
+    switch (event.type) {
+      case "span_started":
+        await this.handleSpanStarted(event.span);
+        break;
+      case "span_updated":
+        await this.handleSpanUpdateOrEnd(event.span, true);
+        break;
+      case "span_ended":
+        await this.handleSpanUpdateOrEnd(event.span, false);
+        break;
+    }
+    if (this.realtime) {
+      await this.client.flushAsync();
+    }
+  }
+  async handleSpanStarted(span) {
+    if (span.isRootSpan) {
+      const trace = this.client.trace(this.buildTracePayload(span));
+      this.traceMap.set(span.trace.id, { trace, spans: /* @__PURE__ */ new Map() });
+    }
+    const traceData = this.traceMap.get(span.trace.id);
+    if (!traceData) {
+      console.log("NO TRACE");
+      return;
+    }
+    const langfuseParent = span.parent && traceData.spans.has(span.parent.id) ? traceData.spans.get(span.parent.id) : traceData.trace;
+    const payload = this.buildSpanPayload(span, true);
+    const langfuseSpan = span.type === AISpanType.LLM_GENERATION ? langfuseParent.generation(payload) : langfuseParent.span(payload);
+    traceData.spans.set(span.id, langfuseSpan);
+  }
+  async handleSpanUpdateOrEnd(span, isUpdate) {
+    const traceData = this.traceMap.get(span.trace.id);
+    if (!traceData) {
+      console.log("NO TRACE");
+      return;
+    }
+    const langfuseSpan = traceData.spans.get(span.id);
+    if (!langfuseSpan) {
+      console.log("NO SPAN");
+      return;
+    }
+    if (isUpdate) {
+      langfuseSpan.update(this.buildSpanPayload(span, false));
+    } else {
+      langfuseSpan.end(this.buildSpanPayload(span, false));
+      if (span.isRootSpan) {
+        traceData.trace.update({ output: span.output });
+        this.traceMap.delete(span.trace.id);
+      }
+    }
+  }
+  buildTracePayload(span) {
+    const payload = {
+      id: span.trace.id,
+      name: span.name
+    };
+    const { userId, sessionId, ...remainingMetadata } = span.metadata ?? {};
+    if (userId) payload.userId = userId;
+    if (sessionId) payload.sessionId = sessionId;
+    if (span.input) payload.input = span.input;
+    payload.metadata = {
+      spanType: span.type,
+      ...sanitizeMetadata(span.attributes),
+      ...sanitizeMetadata(remainingMetadata)
+    };
+    return payload;
+  }
+  buildSpanPayload(span, isCreate) {
+    const payload = {};
+    if (isCreate) {
+      payload.id = span.id;
+      payload.name = span.name;
+      payload.startTime = span.startTime;
+      if (span.input !== void 0) payload.input = span.input;
+    }
+    if (span.output !== void 0) payload.output = span.output;
+    if (span.endTime !== void 0) payload.endTime = span.endTime;
+    const attributes = span.attributes ?? {};
+    const attributesToOmit = [];
+    if (span.type === AISpanType.LLM_GENERATION) {
+      const llmAttr = attributes;
+      if (llmAttr.model !== void 0) {
+        payload.model = llmAttr.model;
+        attributesToOmit.push("model");
+      }
+      if (llmAttr.usage !== void 0) {
+        payload.usage = llmAttr.usage;
+        attributesToOmit.push("usage");
+      }
+      if (llmAttr.parameters !== void 0) {
+        payload.modelParameters = llmAttr.parameters;
+        attributesToOmit.push("parameters");
+      }
+    }
+    payload.metadata = {
+      spanType: span.type,
+      ...sanitizeMetadata(omitKeys(attributes, attributesToOmit)),
+      ...sanitizeMetadata(span.metadata)
+    };
+    if (span.errorInfo) {
+      payload.level = "ERROR";
+      payload.statusMessage = span.errorInfo.message;
+    }
+    return payload;
+  }
+  async shutdown() {
+    await this.client.shutdownAsync();
+    this.traceMap.clear();
+  }
+};
+
+export { LangfuseExporter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ai-tracing.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Langfuse Exporter for Mastra AI Tracing\n *\n * This exporter sends tracing data to Langfuse for AI observability.\n * Root spans start traces in Langfuse.\n * LLM_GENERATION spans become Langfuse generations, all others become spans.\n */\n\nimport type { AITracingExporter, AITracingEvent, AnyAISpan, LLMGenerationAttributes } from '@mastra/core/ai-tracing';\nimport { AISpanType, sanitizeMetadata, omitKeys } from '@mastra/core/ai-tracing';\nimport { Langfuse } from 'langfuse';\nimport type { LangfuseTraceClient, LangfuseSpanClient, LangfuseGenerationClient } from 'langfuse';\n\nexport interface LangfuseExporterConfig {\n  /** Langfuse API key */\n  publicKey: string;\n  /** Langfuse secret key */\n  secretKey: string;\n  /** Langfuse host URL */\n  baseUrl: string;\n  /** Enable realtime mode - flushes after each event for immediate visibility */\n  realtime?: boolean;\n  /** Additional options to pass to the Langfuse client */\n  options?: any;\n}\n\ntype TraceData = {\n  trace: LangfuseTraceClient; // Langfuse trace object\n  spans: Map<string, LangfuseSpanClient | LangfuseGenerationClient>; // Maps span.id to Langfuse span/generation\n};\n\ntype LangfuseSpan = LangfuseTraceClient | LangfuseSpanClient | LangfuseGenerationClient;\n\nexport class LangfuseExporter implements AITracingExporter {\n  name = 'langfuse';\n  private client: Langfuse;\n  private realtime: boolean;\n  private traceMap = new Map<string, TraceData>();\n\n  constructor(config: LangfuseExporterConfig) {\n    this.realtime = config.realtime ?? false;\n    this.client = new Langfuse({\n      publicKey: config.publicKey,\n      secretKey: config.secretKey,\n      baseUrl: config.baseUrl,\n      ...config.options,\n    });\n  }\n\n  async exportEvent(event: AITracingEvent): Promise<void> {\n    switch (event.type) {\n      case 'span_started':\n        await this.handleSpanStarted(event.span);\n        break;\n      case 'span_updated':\n        await this.handleSpanUpdateOrEnd(event.span, true);\n        break;\n      case 'span_ended':\n        await this.handleSpanUpdateOrEnd(event.span, false);\n        break;\n    }\n\n    // Flush immediately in realtime mode for instant visibility\n    if (this.realtime) {\n      await this.client.flushAsync();\n    }\n  }\n\n  private async handleSpanStarted(span: AnyAISpan): Promise<void> {\n    if (span.isRootSpan) {\n      const trace = this.client.trace(this.buildTracePayload(span));\n      this.traceMap.set(span.trace.id, { trace, spans: new Map() });\n    }\n\n    const traceData = this.traceMap.get(span.trace.id);\n    if (!traceData) {\n      console.log('NO TRACE');\n      // TODO: log warning\n      return;\n    }\n\n    const langfuseParent =\n      span.parent && traceData.spans.has(span.parent.id)\n        ? (traceData.spans.get(span.parent.id) as LangfuseSpan)\n        : traceData.trace;\n\n    const payload = this.buildSpanPayload(span, true);\n\n    const langfuseSpan =\n      span.type === AISpanType.LLM_GENERATION ? langfuseParent.generation(payload) : langfuseParent.span(payload);\n\n    traceData.spans.set(span.id, langfuseSpan);\n  }\n\n  private async handleSpanUpdateOrEnd(span: AnyAISpan, isUpdate: boolean): Promise<void> {\n    const traceData = this.traceMap.get(span.trace.id);\n    if (!traceData) {\n      console.log('NO TRACE');\n      // TODO: log warning\n      return;\n    }\n\n    const langfuseSpan = traceData.spans.get(span.id);\n    if (!langfuseSpan) {\n      console.log('NO SPAN');\n      // TODO: log warning\n      return;\n    }\n\n    if (isUpdate) {\n      langfuseSpan.update(this.buildSpanPayload(span, false));\n    } else {\n      langfuseSpan.end(this.buildSpanPayload(span, false));\n\n      if (span.isRootSpan) {\n        traceData.trace.update({ output: span.output });\n        this.traceMap.delete(span.trace.id);\n      }\n    }\n  }\n\n  private buildTracePayload(span: AnyAISpan): Record<string, any> {\n    const payload: Record<string, any> = {\n      id: span.trace.id,\n      name: span.name,\n    };\n\n    const { userId, sessionId, ...remainingMetadata } = span.metadata ?? {};\n\n    if (userId) payload.userId = userId;\n    if (sessionId) payload.sessionId = sessionId;\n    if (span.input) payload.input = span.input;\n\n    payload.metadata = {\n      spanType: span.type,\n      ...sanitizeMetadata(span.attributes),\n      ...sanitizeMetadata(remainingMetadata),\n    };\n\n    return payload;\n  }\n\n  private buildSpanPayload(span: AnyAISpan, isCreate: boolean): Record<string, any> {\n    const payload: Record<string, any> = {};\n\n    if (isCreate) {\n      payload.id = span.id;\n      payload.name = span.name;\n      payload.startTime = span.startTime;\n      if (span.input !== undefined) payload.input = span.input;\n    }\n\n    if (span.output !== undefined) payload.output = span.output;\n    if (span.endTime !== undefined) payload.endTime = span.endTime;\n\n    const attributes = (span.attributes ?? {}) as Record<string, any>;\n\n    // Strip special fields from metadata if used in top-level keys\n    const attributesToOmit: string[] = [];\n\n    if (span.type === AISpanType.LLM_GENERATION) {\n      const llmAttr = attributes as LLMGenerationAttributes;\n\n      if (llmAttr.model !== undefined) {\n        payload.model = llmAttr.model;\n        attributesToOmit.push('model');\n      }\n\n      if (llmAttr.usage !== undefined) {\n        payload.usage = llmAttr.usage;\n        attributesToOmit.push('usage');\n      }\n\n      if (llmAttr.parameters !== undefined) {\n        payload.modelParameters = llmAttr.parameters;\n        attributesToOmit.push('parameters');\n      }\n    }\n\n    payload.metadata = {\n      spanType: span.type,\n      ...sanitizeMetadata(omitKeys(attributes, attributesToOmit)),\n      ...sanitizeMetadata(span.metadata),\n    };\n\n    if (span.errorInfo) {\n      payload.level = 'ERROR';\n      payload.statusMessage = span.errorInfo.message;\n    }\n\n    return payload;\n  }\n\n  async shutdown(): Promise<void> {\n    await this.client.shutdownAsync();\n    this.traceMap.clear();\n  }\n}\n"]}

package/eslint.config.js

@@ -0,0 +1,6 @@
+import { createConfig } from '@internal/lint/eslint';
+
+const config = await createConfig();
+
+/** @type {import("eslint").Linter.Config[]} */
+export default config;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@mastra/langfuse",
+  "version": "0.0.0-vector-query-tool-provider-options-20250828222356",
+  "description": "Langfuse observability provider for Mastra - includes AI tracing and future observability features",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "Apache-2.0",
+  "dependencies": {
+    "langfuse": "^3.38.4"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.52.8",
+    "@types/node": "^20.19.0",
+    "eslint": "^9.30.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4",
+    "@internal/lint": "0.0.0-vector-query-tool-provider-options-20250828222356",
+    "@mastra/core": "0.0.0-vector-query-tool-provider-options-20250828222356",
+    "@internal/types-builder": "0.0.0-vector-query-tool-provider-options-20250828222356"
+  },
+  "peerDependencies": {
+    "@mastra/core": "0.0.0-vector-query-tool-provider-options-20250828222356"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "build:watch": "pnpm build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "lint": "eslint ."
+  }
+}