@mastra/mcp-docs-server 0.13.25-alpha.0 → 0.13.25

package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md

@@ -1,5 +1,16 @@
 # @mastra/voice-openai
 
+## 0.11.7-alpha.0
+
+### Patch Changes
+
+- improve options handling for speak method ([#8228](https://github.com/mastra-ai/mastra/pull/8228))
+
+- Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
+
+- Updated dependencies [[`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`a7243e2`](https://github.com/mastra-ai/mastra/commit/a7243e2e58762667a6e3921e755e89d6bb0a3282), [`7fceb0a`](https://github.com/mastra-ai/mastra/commit/7fceb0a327d678e812f90f5387c5bc4f38bd039e), [`df64f9e`](https://github.com/mastra-ai/mastra/commit/df64f9ef814916fff9baedd861c988084e7c41de), [`809eea0`](https://github.com/mastra-ai/mastra/commit/809eea092fa80c3f69b9eaf078d843b57fd2a88e), [`683e5a1`](https://github.com/mastra-ai/mastra/commit/683e5a1466e48b686825b2c11f84680f296138e4), [`3679378`](https://github.com/mastra-ai/mastra/commit/3679378673350aa314741dc826f837b1984149bc), [`7775bc2`](https://github.com/mastra-ai/mastra/commit/7775bc20bb1ad1ab24797fb420e4f96c65b0d8ec), [`db1891a`](https://github.com/mastra-ai/mastra/commit/db1891a4707443720b7cd8a260dc7e1d49b3609c), [`e8f379d`](https://github.com/mastra-ai/mastra/commit/e8f379d390efa264c4e0874f9ac0cf8839b07777), [`652066b`](https://github.com/mastra-ai/mastra/commit/652066bd1efc6bb6813ba950ed1d7573e8b7d9d4), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`c2a4919`](https://github.com/mastra-ai/mastra/commit/c2a4919ba6797d8bdb1509e02287496eef69303e), [`0130986`](https://github.com/mastra-ai/mastra/commit/0130986fc62d0edcc626dd593282661dbb9af141)]:
+  - @mastra/core@0.19.0-alpha.1
+
 ## 0.11.6
 
 ### Patch Changes
@@ -288,15 +299,4 @@
 
 ## 0.10.6
 
-### Patch Changes
-
-- 063cd46: dependencies updates:
-  - Updated dependency [`openai@^5.10.1` ↗︎](https://www.npmjs.com/package/openai/v/5.10.1) (from `^4.104.0`, in `dependencies`)
-- f42c4c2: update peer deps for packages to latest core range
-- Updated dependencies [510e2c8]
-- Updated dependencies [2f72fb2]
-- Updated dependencies [27cc97a]
-- Updated dependencies [3f89307]
-- Updated dependencies [9eda7d4]
-
-... 1343 more lines hidden. See full changelog in package directory.
+... 1354 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md

@@ -1,5 +1,14 @@
 # @mastra/voice-playai
 
+## 0.11.7-alpha.0
+
+### Patch Changes
+
+- Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
+
+- Updated dependencies [[`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`a7243e2`](https://github.com/mastra-ai/mastra/commit/a7243e2e58762667a6e3921e755e89d6bb0a3282), [`7fceb0a`](https://github.com/mastra-ai/mastra/commit/7fceb0a327d678e812f90f5387c5bc4f38bd039e), [`df64f9e`](https://github.com/mastra-ai/mastra/commit/df64f9ef814916fff9baedd861c988084e7c41de), [`809eea0`](https://github.com/mastra-ai/mastra/commit/809eea092fa80c3f69b9eaf078d843b57fd2a88e), [`683e5a1`](https://github.com/mastra-ai/mastra/commit/683e5a1466e48b686825b2c11f84680f296138e4), [`3679378`](https://github.com/mastra-ai/mastra/commit/3679378673350aa314741dc826f837b1984149bc), [`7775bc2`](https://github.com/mastra-ai/mastra/commit/7775bc20bb1ad1ab24797fb420e4f96c65b0d8ec), [`db1891a`](https://github.com/mastra-ai/mastra/commit/db1891a4707443720b7cd8a260dc7e1d49b3609c), [`e8f379d`](https://github.com/mastra-ai/mastra/commit/e8f379d390efa264c4e0874f9ac0cf8839b07777), [`652066b`](https://github.com/mastra-ai/mastra/commit/652066bd1efc6bb6813ba950ed1d7573e8b7d9d4), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`c2a4919`](https://github.com/mastra-ai/mastra/commit/c2a4919ba6797d8bdb1509e02287496eef69303e), [`0130986`](https://github.com/mastra-ai/mastra/commit/0130986fc62d0edcc626dd593282661dbb9af141)]:
+  - @mastra/core@0.19.0-alpha.1
+
 ## 0.11.6
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 
 ## 0.10.6-alpha.0
 
-### Patch Changes
-
-- f42c4c2: update peer deps for packages to latest core range
-  - @mastra/core@0.12.0-alpha.5
-
-## 0.10.5
-
-### Patch Changes
-
 
-... 1283 more lines hidden. See full changelog in package directory.
+... 1292 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md

@@ -1,5 +1,14 @@
 # @mastra/voice-sarvam
 
+## 0.11.7-alpha.0
+
+### Patch Changes
+
+- Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
+
+- Updated dependencies [[`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`a7243e2`](https://github.com/mastra-ai/mastra/commit/a7243e2e58762667a6e3921e755e89d6bb0a3282), [`7fceb0a`](https://github.com/mastra-ai/mastra/commit/7fceb0a327d678e812f90f5387c5bc4f38bd039e), [`df64f9e`](https://github.com/mastra-ai/mastra/commit/df64f9ef814916fff9baedd861c988084e7c41de), [`809eea0`](https://github.com/mastra-ai/mastra/commit/809eea092fa80c3f69b9eaf078d843b57fd2a88e), [`683e5a1`](https://github.com/mastra-ai/mastra/commit/683e5a1466e48b686825b2c11f84680f296138e4), [`3679378`](https://github.com/mastra-ai/mastra/commit/3679378673350aa314741dc826f837b1984149bc), [`7775bc2`](https://github.com/mastra-ai/mastra/commit/7775bc20bb1ad1ab24797fb420e4f96c65b0d8ec), [`db1891a`](https://github.com/mastra-ai/mastra/commit/db1891a4707443720b7cd8a260dc7e1d49b3609c), [`e8f379d`](https://github.com/mastra-ai/mastra/commit/e8f379d390efa264c4e0874f9ac0cf8839b07777), [`652066b`](https://github.com/mastra-ai/mastra/commit/652066bd1efc6bb6813ba950ed1d7573e8b7d9d4), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`c2a4919`](https://github.com/mastra-ai/mastra/commit/c2a4919ba6797d8bdb1509e02287496eef69303e), [`0130986`](https://github.com/mastra-ai/mastra/commit/0130986fc62d0edcc626dd593282661dbb9af141)]:
+  - @mastra/core@0.19.0-alpha.1
+
 ## 0.11.6
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 
 ## 0.10.6-alpha.0
 
-### Patch Changes
-
-- f42c4c2: update peer deps for packages to latest core range
-  - @mastra/core@0.12.0-alpha.5
-
-## 0.10.5
-
-### Patch Changes
-
 
-... 933 more lines hidden. See full changelog in package directory.
+... 942 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md

@@ -1,5 +1,14 @@
 # @mastra/voice-speechify
 
+## 0.11.7-alpha.0
+
+### Patch Changes
+
+- Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
+
+- Updated dependencies [[`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`a7243e2`](https://github.com/mastra-ai/mastra/commit/a7243e2e58762667a6e3921e755e89d6bb0a3282), [`7fceb0a`](https://github.com/mastra-ai/mastra/commit/7fceb0a327d678e812f90f5387c5bc4f38bd039e), [`df64f9e`](https://github.com/mastra-ai/mastra/commit/df64f9ef814916fff9baedd861c988084e7c41de), [`809eea0`](https://github.com/mastra-ai/mastra/commit/809eea092fa80c3f69b9eaf078d843b57fd2a88e), [`683e5a1`](https://github.com/mastra-ai/mastra/commit/683e5a1466e48b686825b2c11f84680f296138e4), [`3679378`](https://github.com/mastra-ai/mastra/commit/3679378673350aa314741dc826f837b1984149bc), [`7775bc2`](https://github.com/mastra-ai/mastra/commit/7775bc20bb1ad1ab24797fb420e4f96c65b0d8ec), [`db1891a`](https://github.com/mastra-ai/mastra/commit/db1891a4707443720b7cd8a260dc7e1d49b3609c), [`e8f379d`](https://github.com/mastra-ai/mastra/commit/e8f379d390efa264c4e0874f9ac0cf8839b07777), [`652066b`](https://github.com/mastra-ai/mastra/commit/652066bd1efc6bb6813ba950ed1d7573e8b7d9d4), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`c2a4919`](https://github.com/mastra-ai/mastra/commit/c2a4919ba6797d8bdb1509e02287496eef69303e), [`0130986`](https://github.com/mastra-ai/mastra/commit/0130986fc62d0edcc626dd593282661dbb9af141)]:
+  - @mastra/core@0.19.0-alpha.1
+
 ## 0.11.6
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 - Updated dependencies [0b89602]
 - Updated dependencies [4d37822]
 - Updated dependencies [23a6a7c]
-- Updated dependencies [cda801d]
-- Updated dependencies [a77c823]
-- Updated dependencies [ff9c125]
-- Updated dependencies [09bca64]
-- Updated dependencies [b8efbb9]
-- Updated dependencies [71466e7]
-- Updated dependencies [0c99fbe]
-  - @mastra/core@0.12.0
-
 
-... 1298 more lines hidden. See full changelog in package directory.
+... 1307 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/create-mastra.md

@@ -1,5 +1,15 @@
 # create-mastra
 
+## 0.13.3-alpha.1
+
+### Patch Changes
+
+- Fixed an issue in playground where text-start/end parts were ignored in handleStreamChunk and tool ordering vs text wasn't retained ([#8234](https://github.com/mastra-ai/mastra/pull/8234))
+
+- Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
+
+- Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
+
 ## 0.13.3-alpha.0
 
 ### Patch Changes
@@ -288,15 +298,5 @@
 
 ## 0.10.21
 
-### Patch Changes
-
-- 77b6cfe: Use just modelId for gpt-5 check
-- 96169cc: Create handler that returns providers user has keys for in their env
-- 33da97c: Set temperature to 1 for gpt-5 model in playground
-- c6d2603: Properly set baseUrl in playground when user sets the host or port in Mastra instance.
-- 7aad750: Fix tool ui showing after message when chat is refreshed
-- ce04175: Add update agent model handler
-
-## 0.10.21-alpha.2
 
-... 1478 more lines hidden. See full changelog in package directory.
+... 1488 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,23 @@
 # mastra
 
+## 0.13.3-alpha.1
+
+### Patch Changes
+
+- Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
+
+- Fixed an issue in playground where text-start/end parts were ignored in handleStreamChunk and tool ordering vs text wasn't retained ([#8234](https://github.com/mastra-ai/mastra/pull/8234))
+
+- Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
+
+- Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
+
+- Updated dependencies [[`5089c84`](https://github.com/mastra-ai/mastra/commit/5089c84a2f535ad12e79b5aa524ad7d8ca5e2b4c), [`5f4e677`](https://github.com/mastra-ai/mastra/commit/5f4e67757bc23f2694d83af10f88cfccdc6013ff), [`5c98f03`](https://github.com/mastra-ai/mastra/commit/5c98f03ae76d9a93cd6be206b4abb7bf186b3163), [`57b75b0`](https://github.com/mastra-ai/mastra/commit/57b75b01c0c64d91c50d7384c700afda89456fe8), [`4c5e65d`](https://github.com/mastra-ai/mastra/commit/4c5e65de746fbdab23eb6072cb999f4c7aeef9f3), [`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`57b6dd5`](https://github.com/mastra-ai/mastra/commit/57b6dd50f9e6d92c0ed3e7199e6a92752025e3a1), [`a7243e2`](https://github.com/mastra-ai/mastra/commit/a7243e2e58762667a6e3921e755e89d6bb0a3282), [`504438b`](https://github.com/mastra-ai/mastra/commit/504438b961bde211071186bba63a842c4e3db879), [`7fceb0a`](https://github.com/mastra-ai/mastra/commit/7fceb0a327d678e812f90f5387c5bc4f38bd039e), [`df64f9e`](https://github.com/mastra-ai/mastra/commit/df64f9ef814916fff9baedd861c988084e7c41de), [`809eea0`](https://github.com/mastra-ai/mastra/commit/809eea092fa80c3f69b9eaf078d843b57fd2a88e), [`683e5a1`](https://github.com/mastra-ai/mastra/commit/683e5a1466e48b686825b2c11f84680f296138e4), [`3679378`](https://github.com/mastra-ai/mastra/commit/3679378673350aa314741dc826f837b1984149bc), [`7775bc2`](https://github.com/mastra-ai/mastra/commit/7775bc20bb1ad1ab24797fb420e4f96c65b0d8ec), [`db1891a`](https://github.com/mastra-ai/mastra/commit/db1891a4707443720b7cd8a260dc7e1d49b3609c), [`e8f379d`](https://github.com/mastra-ai/mastra/commit/e8f379d390efa264c4e0874f9ac0cf8839b07777), [`652066b`](https://github.com/mastra-ai/mastra/commit/652066bd1efc6bb6813ba950ed1d7573e8b7d9d4), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`c2a4919`](https://github.com/mastra-ai/mastra/commit/c2a4919ba6797d8bdb1509e02287496eef69303e), [`6f67656`](https://github.com/mastra-ai/mastra/commit/6f676562276926e2982401574d1e07157579be30), [`0130986`](https://github.com/mastra-ai/mastra/commit/0130986fc62d0edcc626dd593282661dbb9af141), [`5dc8e9a`](https://github.com/mastra-ai/mastra/commit/5dc8e9a7f8472298cd3d4e8a0cf6d265529f287d)]:
+  - @mastra/deployer@0.19.0-alpha.1
+  - @mastra/mcp@0.13.2-alpha.0
+  - @mastra/core@0.19.0-alpha.1
+  - @mastra/loggers@0.10.14-alpha.0
+
 ## 0.13.3-alpha.0
 
 ### Patch Changes
@@ -281,22 +299,4 @@
 
 ## 0.12.4-alpha.0
 
-### Patch Changes
-
-- fix minor playground stuff for observability ([#7765](https://github.com/mastra-ai/mastra/pull/7765))
-
-- Handle zod intersections in dynamic form ([#7768](https://github.com/mastra-ai/mastra/pull/7768))
-
-- Playground ui -pass runtimeContext to client SDK get methods ([#7767](https://github.com/mastra-ai/mastra/pull/7767))
-
-- Updated dependencies [[`5802bf5`](https://github.com/mastra-ai/mastra/commit/5802bf57f6182e4b67c28d7d91abed349a8d14f3), [`5bda53a`](https://github.com/mastra-ai/mastra/commit/5bda53a9747bfa7d876d754fc92c83a06e503f62), [`f26a8fd`](https://github.com/mastra-ai/mastra/commit/f26a8fd99fcb0497a5d86c28324430d7f6a5fb83), [`f0ab020`](https://github.com/mastra-ai/mastra/commit/f0ab02034532a4afb71a1ef4fe243f9a8dffde84), [`1a1fbe6`](https://github.com/mastra-ai/mastra/commit/1a1fbe66efb7d94abc373ed0dd9676adb8122454), [`36f39c0`](https://github.com/mastra-ai/mastra/commit/36f39c00dc794952dc3c11aab91c2fa8bca74b11)]:
-  - @mastra/core@0.16.4-alpha.0
-  - @mastra/deployer@0.16.4-alpha.0
-
-## 0.12.3
-
-### Patch Changes
-
-- Client SDK Agents, Mastra server - support runtimeContext with GET requests ([#7734](https://github.com/mastra-ai/mastra/pull/7734))
-
-... 5765 more lines hidden. See full changelog in package directory.
+... 5783 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/agent.md

@@ -762,7 +762,6 @@ const weatherAgent = new Agent({
   instructions: `You are a weather agent that can help you get weather information for a given city`,
   description: `An agent that can help you get weather information for a given city`,
   model: openai_v5('gpt-4o-mini'),
-  tools: { weatherInfo },
   workflows: {
     myWorkflow,
   },
@@ -774,9 +773,6 @@ export const networkAgent = new Agent({
     'A chef agent that can help you cook great meals with whatever ingredients you have available based on your location and current weather.',
   instructions: `You are a the manager of several agent, tools, and workflows. Use the best primitives based on what the user wants to accomplish your task.`,
   model: openai_v5('gpt-4o-mini'),
-  workflows: {
-    myWorkflow,
-  },
   agents: {
     weatherAgent,
   },

package/.docs/organized/code-examples/ai-elements.md

@@ -0,0 +1,47 @@
+### package.json
+```json
+{
+  "name": "ai-elements",
+  "dependencies": {
+    "@mastra/playground-ui": "file:../../packages/playground-ui",
+    "@mastra/react": "file:../../client-sdks/react",
+    "@radix-ui/react-avatar": "^1.1.10",
+    "@radix-ui/react-collapsible": "^1.1.12",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-hover-card": "^1.1.15",
+    "@radix-ui/react-progress": "^1.1.7",
+    "@radix-ui/react-scroll-area": "^1.2.10",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@radix-ui/react-use-controllable-state": "^1.2.2",
+    "ai": "^5.0.57",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "embla-carousel-react": "^8.6.0",
+    "lucide-react": "^0.544.0",
+    "nanoid": "^5.1.6",
+    "next": "15.5.4",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "react-syntax-highlighter": "^15.6.6",
+    "streamdown": "^1.3.0",
+    "tailwind-merge": "^3.3.1",
+    "tokenlens": "^1.3.1",
+    "use-stick-to-bottom": "^1.1.1"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3",
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "eslint": "^9",
+    "eslint-config-next": "15.5.4",
+    "tailwindcss": "^4",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "^5"
+  }
+}
+```

package/.docs/organized/code-examples/heads-up-game.md

@@ -7,15 +7,15 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^1.3.23",
-    "@mastra/core": "^0.16.3",
-    "@mastra/libsql": "^0.14.1",
-    "@mastra/loggers": "^0.10.11",
-    "@mastra/memory": "^0.15.1",
+    "@mastra/core": "^0.18.0",
+    "@mastra/libsql": "^0.14.3",
+    "@mastra/loggers": "^0.10.13",
+    "@mastra/memory": "^0.15.3",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "mastra": "^0.12.3",
+    "mastra": "^0.13.2",
     "typescript": "^5.9.2"
   }
 }

package/.docs/raw/auth/clerk.mdx

@@ -23,17 +23,17 @@ CLERK_JWKS_URI=https://your-clerk-domain.clerk.accounts.dev/.well-known/jwks.jso
 
 ## Installation
 
-Before you can use the `MastraAuthClerk` class you have to install the `@mastra/clerk-auth` package.
+Before you can use the `MastraAuthClerk` class you have to install the `@mastra/auth-clerk` package.
 
 ```bash copy
-npm install @mastra/clerk-auth@latest
+npm install @mastra/auth-clerk@latest
 ```
 
 ## Usage example
 
 ```typescript {2,7-11} filename="src/mastra/index.ts" showLineNumbers copy
 import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthClerk } from '@mastra/clerk-auth';
+import { MastraAuthClerk } from '@mastra/auth-clerk';
 
 export const mastra = new Mastra({
   // ..

package/.docs/raw/observability/ai-tracing/exporters/default.mdx

@@ -108,6 +108,7 @@ If you set the strategy to `'auto'`, the `DefaultExporter` automatically selects
 | Storage Provider | Preferred Strategy | Supported Strategies | Notes |
 |-----------------|-------------------|---------------------|--------|
 | **[LibSQL](/reference/storage/libsql)** | batch-with-updates | realtime, batch-with-updates, insert-only | Default storage, good for development |
+| **[PostgreSQL](/reference/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only | Recommended for production |
 
 ### Strategy Benefits
 

package/.docs/raw/observability/ai-tracing/exporters/langsmith.mdx

@@ -0,0 +1,88 @@
+---
+title: "LangSmith Exporter | AI Tracing | Observability | Mastra Docs"
+description: "Send AI traces to LangSmith for LLM observability and evaluation"
+---
+
+import { Callout } from "nextra/components";
+
+# LangSmith Exporter
+
+[LangSmith](https://smith.langchain.com/) is LangChain's platform for monitoring and evaluating LLM applications. The LangSmith exporter sends your AI traces to LangSmith, providing insights into model performance, debugging capabilities, and evaluation workflows.
+
+## When to Use LangSmith
+
+LangSmith is ideal when you need:
+- **LangChain ecosystem integration** - Native support for LangChain applications
+- **Debugging and testing** - Detailed trace visualization and replay
+- **Evaluation pipelines** - Built-in evaluation and dataset management
+- **Prompt versioning** - Track and compare prompt variations
+- **Collaboration features** - Team workspaces and shared projects
+
+## Installation
+
+```bash npm2yarn
+npm install @mastra/langsmith
+```
+
+## Configuration
+
+### Prerequisites
+
+1. **LangSmith Account**: Sign up at [smith.langchain.com](https://smith.langchain.com)
+2. **API Key**: Generate an API key in LangSmith Settings → API Keys
+3. **Environment Variables**: Set your credentials
+
+```bash filename=".env"
+LANGSMITH_API_KEY=ls-xxxxxxxxxxxx
+LANGSMITH_BASE_URL=https://api.smith.langchain.com  # Optional for self-hosted
+```
+
+### Basic Setup
+
+```typescript filename="src/mastra/index.ts"
+import { Mastra } from "@mastra/core";
+import { LangSmithExporter } from "@mastra/langsmith";
+
+export const mastra = new Mastra({
+  observability: {
+    configs: {
+      langsmith: {
+        serviceName: 'my-service',
+        exporters: [
+          new LangSmithExporter({
+            apiKey: process.env.LANGSMITH_API_KEY,
+          }),
+        ],
+      },
+    },
+  },
+});
+```
+
+## Configuration Options
+
+### Complete Configuration
+
+```typescript
+new LangSmithExporter({
+  // Required credentials
+  apiKey: process.env.LANGSMITH_API_KEY!,
+
+  // Optional settings
+  apiUrl: process.env.LANGSMITH_BASE_URL,       // Default: https://api.smith.langchain.com
+  callerOptions: {                              // HTTP client options
+    timeout: 30000,                             // Request timeout in ms
+    maxRetries: 3,                              // Retry attempts
+  },
+  logLevel: 'info',                             // Diagnostic logging: debug | info | warn | error
+
+  // LangSmith-specific options
+  hideInputs: false,                            // Hide input data in UI
+  hideOutputs: false,                           // Hide output data in UI
+})
+```
+
+## Related
+
+- [AI Tracing Overview](/docs/observability/ai-tracing/overview)
+- [LangSmith Documentation](https://docs.smith.langchain.com/)