@mastra/langfuse 0.0.0-stream-vnext-usage-20250908171242 → 0.0.0-testing-cloud-studios-20260114234039

package/dist/tracing.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Langfuse Exporter for Mastra Observability
+ *
+ * This exporter sends observability data to Langfuse.
+ * Root spans start traces in Langfuse.
+ * MODEL_GENERATION spans become Langfuse generations, all others become spans.
+ */
+import type { TracingEvent, UsageStats } from '@mastra/core/observability';
+import { BaseExporter } from '@mastra/observability';
+import type { BaseExporterConfig } from '@mastra/observability';
+export interface LangfuseExporterConfig extends BaseExporterConfig {
+    /** 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;
+}
+/**
+ * Token usage format compatible with Langfuse.
+ */
+export interface LangfuseUsageMetrics {
+    input?: number;
+    output?: number;
+    total?: number;
+    reasoning?: number;
+    cache_read_input_tokens?: number;
+    cache_write_input_tokens?: number;
+}
+/**
+ * Formats UsageStats to Langfuse's expected format.
+ */
+export declare function formatUsageMetrics(usage?: UsageStats): LangfuseUsageMetrics;
+export declare class LangfuseExporter extends BaseExporter {
+    name: string;
+    private client;
+    private realtime;
+    private traceMap;
+    constructor(config?: LangfuseExporterConfig);
+    protected _exportTracingEvent(event: TracingEvent): Promise<void>;
+    private handleSpanStarted;
+    private handleSpanUpdateOrEnd;
+    private handleEventSpan;
+    private initTrace;
+    private getTraceData;
+    private getLangfuseParent;
+    private buildTracePayload;
+    /**
+     * Look up the Langfuse prompt from the closest parent span that has one.
+     * This enables prompt inheritance for MODEL_GENERATION spans when the prompt
+     * is set on a parent span (e.g., AGENT_RUN) rather than directly on the generation.
+     */
+    private findParentLangfusePrompt;
+    private buildSpanPayload;
+    addScoreToTrace({ traceId, spanId, score, reason, scorerName, metadata, }: {
+        traceId: string;
+        spanId?: string;
+        score: number;
+        reason?: string;
+        scorerName: string;
+        metadata?: Record<string, any>;
+    }): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAA8C,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAGvH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAIhE,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAoBD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,oBAAoB,CAkC3E;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,IAAI,SAAc;IAClB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAgC;gBAEpC,MAAM,GAAE,sBAA2B;cAsC/B,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YAwBzD,iBAAiB;YAkCjB,qBAAqB;YAmDrB,eAAe;IAkC7B,OAAO,CAAC,SAAS;IAwCjB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,iBAAiB;IAuBzB;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,gBAAgB;IAkGlB,eAAe,CAAC,EACpB,OAAO,EACP,MAAM,EACN,KAAK,EACL,MAAM,EACN,UAAU,EACV,QAAQ,GACT,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBX,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mastra/langfuse",
-  "version": "0.0.0-stream-vnext-usage-20250908171242",
-  "description": "Langfuse observability provider for Mastra - includes AI tracing and future observability features",
+  "version": "0.0.0-testing-cloud-studios-20260114234039",
+  "description": "Langfuse observability provider for Mastra - includes tracing and future observability features",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,21 +24,23 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "langfuse": "^3.38.4"
+    "langfuse": "^3.38.6",
+    "@mastra/observability": "0.0.0-testing-cloud-studios-20260114234039"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.52.8",
-    "@types/node": "^20.19.0",
-    "eslint": "^9.30.1",
+    "@types/node": "22.13.17",
+    "@vitest/coverage-v8": "4.0.12",
+    "@vitest/ui": "4.0.12",
+    "eslint": "^9.37.0",
     "tsup": "^8.5.0",
-    "typescript": "^5.8.3",
-    "vitest": "^3.2.4",
-    "@internal/types-builder": "0.0.0-stream-vnext-usage-20250908171242",
-    "@internal/lint": "0.0.0-stream-vnext-usage-20250908171242",
-    "@mastra/core": "0.0.0-stream-vnext-usage-20250908171242"
+    "typescript": "^5.9.3",
+    "vitest": "4.0.16",
+    "@internal/lint": "0.0.0-testing-cloud-studios-20260114234039",
+    "@internal/types-builder": "0.0.0-testing-cloud-studios-20260114234039",
+    "@mastra/core": "0.0.0-testing-cloud-studios-20260114234039"
   },
   "peerDependencies": {
-    "@mastra/core": "0.0.0-stream-vnext-usage-20250908171242"
+    "@mastra/core": "0.0.0-testing-cloud-studios-20260114234039"
   },
   "homepage": "https://mastra.ai",
   "repository": {
@@ -49,6 +51,9 @@
   "bugs": {
     "url": "https://github.com/mastra-ai/mastra/issues"
   },
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "build": "tsup --silent --config tsup.config.ts",
     "build:watch": "pnpm build --watch",

package/dist/ai-tracing.d.ts

@@ -1,41 +0,0 @@
-/**
- * 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;
-    /** Logger level for diagnostic messages (default: 'warn') */
-    logLevel?: 'debug' | 'info' | 'warn' | 'error';
-    /** Additional options to pass to the Langfuse client */
-    options?: any;
-}
-export declare class LangfuseExporter implements AITracingExporter {
-    name: string;
-    private client;
-    private realtime;
-    private traceMap;
-    private logger;
-    constructor(config: LangfuseExporterConfig);
-    exportEvent(event: AITracingEvent): Promise<void>;
-    private handleSpanStarted;
-    private handleSpanUpdateOrEnd;
-    private handleEventSpan;
-    private initTrace;
-    private getTraceData;
-    private getLangfuseParent;
-    private buildTracePayload;
-    private buildSpanPayload;
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=ai-tracing.d.ts.map

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

@@ -1 +0,0 @@
-{"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;AAMrH,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,wDAAwD;IACxD,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAUD,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,IAAI,SAAc;IAClB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,sBAAsB;IAsBpC,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YA6BzC,iBAAiB;YAwBjB,qBAAqB;YAgCrB,eAAe;IA6B7B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,gBAAgB;IAmDlB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMhC"}