@mastra/langfuse 1.0.0-beta.8 → 1.0.0

package/dist/tracing.d.ts

@@ -5,10 +5,11 @@
  * 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 {
+import type { AnyExportedSpan, SpanErrorInfo } from '@mastra/core/observability';
+import { TrackingExporter } from '@mastra/observability';
+import type { TrackingExporterConfig, TraceData } from '@mastra/observability';
+import type { LangfuseTraceClient, LangfuseSpanClient, LangfuseGenerationClient, LangfuseEventClient } from 'langfuse';
+export interface LangfuseExporterConfig extends TrackingExporterConfig {
     /** Langfuse API key */
     publicKey?: string;
     /** Langfuse secret key */
@@ -20,41 +21,62 @@ export interface LangfuseExporterConfig extends BaseExporterConfig {
     /** Additional options to pass to the Langfuse client */
     options?: any;
 }
+type LangfusePromptData = {
+    name?: string;
+    version?: number;
+    id?: string;
+};
 /**
- * Token usage format compatible with Langfuse.
+ * With Langfuse, data from the root span is stored in both the Root and the
+ * first span.
  */
-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 {
+type LangfuseRoot = LangfuseTraceClient;
+type LangfuseSpan = LangfuseSpanClient | LangfuseGenerationClient;
+type LangfuseEvent = LangfuseEventClient;
+type LangfuseMetadata = {
+    prompt?: LangfusePromptData;
+};
+type LangfuseTraceData = TraceData<LangfuseRoot, LangfuseSpan, LangfuseEvent, LangfuseMetadata>;
+export declare class LangfuseExporter extends TrackingExporter<LangfuseRoot, LangfuseSpan, LangfuseEvent, LangfuseMetadata, LangfuseExporterConfig> {
+    #private;
     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;
+    constructor(config?: LangfuseExporterConfig);
+    protected _postExportTracingEvent(): Promise<void>;
+    protected _buildRoot(args: {
+        span: AnyExportedSpan;
+        traceData: LangfuseTraceData;
+    }): Promise<LangfuseTraceClient | undefined>;
+    protected _buildEvent(args: {
+        span: AnyExportedSpan;
+        traceData: LangfuseTraceData;
+    }): Promise<LangfuseEvent | undefined>;
+    protected _buildSpan(args: {
+        span: AnyExportedSpan;
+        traceData: LangfuseTraceData;
+    }): Promise<LangfuseSpan | undefined>;
+    protected _updateSpan(args: {
+        span: AnyExportedSpan;
+        traceData: LangfuseTraceData;
+    }): Promise<void>;
+    protected _finishSpan(args: {
+        span: AnyExportedSpan;
+        traceData: LangfuseTraceData;
+    }): Promise<void>;
+    protected _abortSpan(args: {
+        span: LangfuseSpan;
+        reason: SpanErrorInfo;
+    }): Promise<void>;
     private buildTracePayload;
     /**
-     * Look up the Langfuse prompt from the closest parent span that has one.
+     * Look up the Langfuse prompt from the closest 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.
+     * This enables prompt linking when:
+     * - A workflow calls multiple agents, each with different prompts
+     * - Nested agents have different prompts
+     * - The prompt is set on AGENT_RUN but MODEL_GENERATION inherits it
      */
-    private findParentLangfusePrompt;
+    private findLangfusePrompt;
     private buildSpanPayload;
     addScoreToTrace({ traceId, spanId, score, reason, scorerName, metadata, }: {
         traceId: string;
@@ -64,6 +86,11 @@ export declare class LangfuseExporter extends BaseExporter {
         scorerName: string;
         metadata?: Record<string, any>;
     }): Promise<void>;
-    shutdown(): Promise<void>;
+    /**
+     * Force flush any buffered data to Langfuse without shutting down.
+     */
+    protected _flush(): Promise<void>;
+    _postShutdown(): Promise<void>;
 }
+export {};
 //# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

@@ -1 +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,EAAE,sBAAsB;cAsB1B,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"}
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/langfuse",
-  "version": "1.0.0-beta.8",
+  "version": "1.0.0",
   "description": "Langfuse observability provider for Mastra - includes tracing and future observability features",
   "type": "module",
   "main": "dist/index.js",
@@ -25,7 +25,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "langfuse": "^3.38.6",
-    "@mastra/observability": "1.0.0-beta.8"
+    "@mastra/observability": "1.0.0"
   },
   "devDependencies": {
     "@types/node": "22.13.17",
@@ -33,11 +33,12 @@
     "@vitest/ui": "4.0.12",
     "eslint": "^9.37.0",
     "tsup": "^8.5.0",
-    "typescript": "^5.8.3",
-    "vitest": "4.0.12",
-    "@internal/lint": "0.0.53",
-    "@mastra/core": "1.0.0-beta.16",
-    "@internal/types-builder": "0.0.28"
+    "typescript": "^5.9.3",
+    "vitest": "4.0.16",
+    "@internal/types-builder": "0.0.29",
+    "@internal/lint": "0.0.54",
+    "@observability/test-utils": "0.0.1",
+    "@mastra/core": "1.0.0"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"