@mastra/mcp-docs-server 1.1.22-alpha.9 → 1.1.23-alpha.0

package/.docs/reference/observability/tracing/exporters/langfuse.md

@@ -16,7 +16,8 @@ interface LangfuseExporterConfig extends BaseExporterConfig {
   secretKey?: string
   baseUrl?: string
   realtime?: boolean
-  options?: any
+  environment?: string
+  release?: string
 }
 ```
 
@@ -25,23 +26,17 @@ Extends `BaseExporterConfig`, which includes:
 - `logger?: IMastraLogger` - Logger instance
 - `logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'` - Log level (default: INFO)
 
-## Methods
+## Properties
 
-### `exportTracingEvent`
+### `client`
 
 ```typescript
-async exportTracingEvent(event: TracingEvent): Promise<void>
+get client(): LangfuseClient | undefined
 ```
 
-Exports a tracing event to Langfuse.
-
-### export
-
-```typescript
-async export(spans: ReadOnlySpan[]): Promise<void>
-```
+The `LangfuseClient` instance for advanced Langfuse features. Returns `undefined` when the exporter is disabled (missing credentials). Use this for prompt management, evaluations, datasets, and direct API access.
 
-Batch exports spans to Langfuse.
+## Methods
 
 ### flush
 
@@ -49,7 +44,7 @@ Batch exports spans to Langfuse.
 async flush(): Promise<void>
 ```
 
-Force flushes any buffered spans to Langfuse without shutting down the exporter. Useful in serverless environments where you need to ensure spans are exported before the runtime terminates.
+Force flushes any buffered spans and scores to Langfuse without shutting down. Useful in serverless environments where you need to ensure data is exported before the runtime terminates.
 
 ### shutdown
 
@@ -57,7 +52,7 @@ Force flushes any buffered spans to Langfuse without shutting down the exporter.
 async shutdown(): Promise<void>
 ```
 
-Flushes pending data and shuts down the client.
+Flushes pending data and shuts down both the span processor and the client.
 
 ## Usage
 
@@ -85,10 +80,11 @@ const exporter = new LangfuseExporter({
 
 ## Span mapping
 
-- Root spans → Langfuse traces
-- `MODEL_GENERATION` spans → Langfuse generations
+Mastra spans are converted to OTel format and sent to Langfuse via `LangfuseSpanProcessor`. Langfuse automatically maps spans based on their `gen_ai.*` attributes:
+
+- Spans with a `model` attribute → Langfuse generations
 - All other spans → Langfuse spans
-- Event spans → Langfuse events
+- Parent-child relationships are preserved via OTel trace/span IDs
 
 ## Prompt linking
 
@@ -96,22 +92,21 @@ Link LLM generations to [Langfuse Prompt Management](https://langfuse.com/docs/p
 
 ```typescript
 import { buildTracingOptions } from '@mastra/observability'
-import { withLangfusePrompt } from '@mastra/langfuse'
-import { Langfuse } from 'langfuse'
+import { LangfuseExporter, withLangfusePrompt } from '@mastra/langfuse'
 
-const langfuse = new Langfuse({
-  publicKey: process.env.LANGFUSE_PUBLIC_KEY!,
-  secretKey: process.env.LANGFUSE_SECRET_KEY!,
-})
+const exporter = new LangfuseExporter()
 
-const prompt = await langfuse.getPrompt('customer-support')
+// Fetch prompt via the Langfuse client
+const prompt = await exporter.client.prompt.get('customer-support', { type: 'text' })
 
 const agent = new Agent({
   name: 'support-agent',
-  instructions: prompt.prompt,
+  instructions: prompt.compile(),
   model: 'openai/gpt-5.4',
   defaultGenerateOptions: {
-    tracingOptions: buildTracingOptions(withLangfusePrompt(prompt)),
+    tracingOptions: buildTracingOptions(
+      withLangfusePrompt({ name: prompt.name, version: prompt.version }),
+    ),
   },
 })
 ```
@@ -123,12 +118,8 @@ const agent = new Agent({
 Adds Langfuse prompt metadata to tracing options.
 
 ```typescript
-// With Langfuse SDK prompt object
-withLangfusePrompt(prompt)
-
-// With manual fields
+// Link by name and version (required for Langfuse v5)
 withLangfusePrompt({ name: 'my-prompt', version: 1 })
-withLangfusePrompt({ id: 'prompt-uuid' })
 ```
 
-When `metadata.langfuse.prompt` is set on a `MODEL_GENERATION` span (with either `id` alone, or `name` + `version`), the exporter automatically links the generation to the prompt in Langfuse.
+The prompt metadata is passed through as span attributes and Langfuse links the generation to the corresponding prompt.

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @mastra/mcp-docs-server
 
+## 1.1.22
+
+### Patch Changes
+
+- Updated dependencies [[`f32b9e1`](https://github.com/mastra-ai/mastra/commit/f32b9e115a3c754d1c8cfa3f4256fba87b09cfb7), [`7d6f521`](https://github.com/mastra-ai/mastra/commit/7d6f52164d0cca099f0b07cb2bba334360f1c8ab), [`a50d220`](https://github.com/mastra-ai/mastra/commit/a50d220b01ecbc5644d489a3d446c3bd4ab30245), [`665477b`](https://github.com/mastra-ai/mastra/commit/665477bc104fd52cfef8e7610d7664781a70c220), [`4cc2755`](https://github.com/mastra-ai/mastra/commit/4cc2755a7194cb08720ff2ab4dffb4b4a5103dfd), [`ac7baf6`](https://github.com/mastra-ai/mastra/commit/ac7baf66ef1db15e03975ef4ebb02724f015a391), [`ed425d7`](https://github.com/mastra-ai/mastra/commit/ed425d78e7c66cbda8209fee910856f98c6c6b82), [`1371703`](https://github.com/mastra-ai/mastra/commit/1371703835080450ef3f9aea58059a95d0da2e5a), [`0df8321`](https://github.com/mastra-ai/mastra/commit/0df832196eeb2450ab77ce887e8553abdd44c5a6), [`98f8a8b`](https://github.com/mastra-ai/mastra/commit/98f8a8bdf5761b9982f3ad3acbe7f1cc3efa71f3), [`ba6f7e9`](https://github.com/mastra-ai/mastra/commit/ba6f7e9086d8281393f2acae60fda61de3bff1f9), [`7eb2596`](https://github.com/mastra-ai/mastra/commit/7eb25960d607e07468c9a10c5437abd2deaf1e9a), [`1805ddc`](https://github.com/mastra-ai/mastra/commit/1805ddc9c9b3b14b63749735a13c05a45af43a80), [`fff91cf`](https://github.com/mastra-ai/mastra/commit/fff91cf914de0e731578aacebffdeebef82f0440), [`61109b3`](https://github.com/mastra-ai/mastra/commit/61109b34feb0e38d54bee4b8ca83eb7345b1d557), [`33f1ead`](https://github.com/mastra-ai/mastra/commit/33f1eadfa19c86953f593478e5fa371093b33779)]:
+  - @mastra/core@1.23.0
+
+## 1.1.22-alpha.13
+
+### Patch Changes
+
+- Updated dependencies [[`a50d220`](https://github.com/mastra-ai/mastra/commit/a50d220b01ecbc5644d489a3d446c3bd4ab30245)]:
+  - @mastra/core@1.23.0-alpha.9
+
+## 1.1.22-alpha.12
+
+### Patch Changes
+
+- Updated dependencies [[`ac7baf6`](https://github.com/mastra-ai/mastra/commit/ac7baf66ef1db15e03975ef4ebb02724f015a391), [`0df8321`](https://github.com/mastra-ai/mastra/commit/0df832196eeb2450ab77ce887e8553abdd44c5a6), [`61109b3`](https://github.com/mastra-ai/mastra/commit/61109b34feb0e38d54bee4b8ca83eb7345b1d557), [`33f1ead`](https://github.com/mastra-ai/mastra/commit/33f1eadfa19c86953f593478e5fa371093b33779)]:
+  - @mastra/core@1.23.0-alpha.8
+
+## 1.1.22-alpha.10
+
+### Patch Changes
+
+- Updated dependencies [[`665477b`](https://github.com/mastra-ai/mastra/commit/665477bc104fd52cfef8e7610d7664781a70c220), [`4cc2755`](https://github.com/mastra-ai/mastra/commit/4cc2755a7194cb08720ff2ab4dffb4b4a5103dfd)]:
+  - @mastra/core@1.23.0-alpha.7
+
 ## 1.1.22-alpha.8
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.22-alpha.9",
+  "version": "1.1.23-alpha.0",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "1.23.0-alpha.6",
+    "@mastra/core": "1.23.0",
     "@mastra/mcp": "^1.4.1"
   },
   "devDependencies": {
@@ -46,9 +46,9 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
-    "@internal/lint": "0.0.79",
-    "@mastra/core": "1.23.0-alpha.6",
-    "@internal/types-builder": "0.0.54"
+    "@internal/lint": "0.0.80",
+    "@internal/types-builder": "0.0.55",
+    "@mastra/core": "1.23.0"
   },
   "homepage": "https://mastra.ai",
   "repository": {