@mastra/mcp-docs-server 1.1.17-alpha.1 → 1.1.17-alpha.13

package/.docs/reference/logging/pino-logger.md

@@ -30,6 +30,64 @@ export const mastra = new Mastra({
 
 **formatters** (`pino.LoggerOptions['formatters']`): Custom Pino formatters for log serialization.
 
+**redact** (`pino.LoggerOptions['redact']`): Paths or options for redacting sensitive fields from log output (Pino \`redact\`).
+
+**prettyPrint** (`boolean`): When false, disables \`pino-pretty\` and writes raw JSON lines (useful for log aggregators). (Default: `true`)
+
+**mixin** (`pino.MixinFn`): Pino mixin function merged into every log object (for example request-scoped \`traceId\` or other shared metadata).
+
+**customLevels** (`Record<string, number>`): Custom log levels and numeric values, forwarded to Pino. Standard severity is still logged via \`debug\`, \`info\`, \`warn\`, and \`error\`; extra levels follow Pino’s custom-level behavior.
+
+## Log enrichment with `mixin`
+
+Use `mixin` when you want the same structured fields on every line (for correlation with the rest of your services):
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { PinoLogger } from '@mastra/loggers'
+
+function getTraceContext() {
+  return { traceId: 'abc-123' }
+}
+
+export const mastra = new Mastra({
+  logger: new PinoLogger({
+    name: 'Mastra',
+    level: 'info',
+    mixin() {
+      return getTraceContext()
+    },
+  }),
+})
+```
+
+## Custom levels
+
+`customLevels` is passed through to Pino. `PinoLogger` only exposes `debug`, `info`, `warn`, and `error`; for any extra level name (for example `audit`), subclass and forward to the underlying Pino instance:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { PinoLogger } from '@mastra/loggers'
+
+type AuditLevel = 'audit'
+
+class MastraPinoWithAudit extends PinoLogger<AuditLevel> {
+  audit(message: string, meta: Record<string, unknown> = {}) {
+    this.logger.audit(meta, message)
+  }
+}
+
+const logger = new MastraPinoWithAudit({
+  name: 'Mastra',
+  level: 'info',
+  customLevels: { audit: 35 },
+})
+
+export const mastra = new Mastra({ logger })
+```
+
+Numeric values follow Pino’s ordering (built-in levels use 10–60). A level of `35` sits between `info` (30) and `warn` (40), so with `level: 'info'` both `info` and `audit` lines are emitted.
+
 ## File transport (structured logs)
 
 Writes structured logs to a file using the `FileTransport`. The logger accepts a plain message as the first argument and structured metadata as the second argument. These are internally converted to a `BaseLogMessage` and persisted to the configured file path.

package/.docs/reference/memory/observational-memory.md

@@ -38,7 +38,7 @@ OM performs thresholding with fast local token estimation. Text uses `tokenx`, a
 
 **shareTokenBudget** (`boolean`): Share the token budget between messages and observations. When enabled, the total budget is \`observation.messageTokens + reflection.observationTokens\`. Messages can use more space when observations are small, and vice versa. This maximizes context usage through flexible allocation. \`shareTokenBudget\` is not yet compatible with async buffering. You must set \`observation: { bufferTokens: false }\` when using this option (this is a temporary limitation). (Default: `false`)
 
-**retrieval** (`boolean`): \*\*Experimental.\*\* Enable retrieval-mode observation groups as durable pointers to raw message history. Retrieval mode is only active when \`scope\` is \`'thread'\`. If you set \`retrieval: true\` with \`scope: 'resource'\`, OM keeps resource-scoped memory behavior but skips retrieval-mode context and does not register the \`recall\` tool. (Default: `false`)
+**retrieval** (`boolean | { vector?: boolean; scope?: 'thread' | 'resource' }`): \*\*Experimental.\*\* Enable retrieval-mode observation groups as durable pointers to raw message history. \`true\` enables cross-thread browsing by default. \`{ vector: true }\` also enables semantic search using Memory's vector store and embedder. \`{ scope: 'thread' }\` restricts the recall tool to the current thread only. Default scope is \`'resource'\`. (Default: `false`)
 
 **observation** (`ObservationalMemoryObservationConfig`): Configuration for the observation step. Controls when the Observer agent runs and how it behaves.
 
@@ -578,21 +578,31 @@ The standalone `ObservationalMemory` class accepts all the same options as the `
 
 ## Recall tool
 
-When `retrieval: true` is set with `scope: 'thread'`, OM registers a `recall` tool that the agent can call to page through the raw messages behind an observation group's `_range`. The tool is automatically added to the agent's tool list — no manual registration is needed.
+When `retrieval` is set (any truthy value), a `recall` tool is registered so the agent can page through raw messages behind observation group ranges. By default (scope `'resource'`), the tool supports listing threads (`mode: "threads"`), browsing other threads (`threadId`), and cross-thread search. With `retrieval: { vector: true }`, semantic search is available (`mode: "search"`). Set `scope: 'thread'` to restrict the tool to the current thread only. The tool is automatically added to the agent's tool list — no manual registration is needed.
 
 ### Parameters
 
-**cursor** (`string`): A message ID to anchor the recall query. Extract the start or end ID from an observation group range (e.g. from \`\_range: \\\`startId:endId\\\`\_\`, use either \`startId\` or \`endId\`). If a range string is passed directly, the tool returns a hint explaining how to extract the correct ID.
+**mode** (`'messages' | 'threads' | 'search'`): What to retrieve. \`"messages"\` (default) pages through message history. \`"threads"\` lists all threads for the current user. \`"search"\` finds messages by semantic similarity across all threads (requires vector store and embedder). (Default: `'messages'`)
 
-**page** (`number`): Pagination offset from the cursor. Positive values page forward (messages after the cursor), negative values page backward (messages before the cursor). \`0\` is treated as \`1\`. (Default: `1`)
+**query** (`string`): Search query for \`mode: "search"\`. Finds messages semantically similar to this text across all threads for the current user.
 
-**limit** (`number`): Maximum number of messages per page. (Default: `20`)
+**cursor** (`string`): A message ID to anchor the recall query. Required for \`mode: "messages"\` when browsing the current thread. Extract the start or end ID from an observation group range (e.g. from \`\_range: \\\`startId:endId\\\`\_\`, use either \`startId\` or \`endId\`). If a range string is passed directly, the tool returns a hint explaining how to extract the correct ID. Can be omitted when \`threadId\` is provided to start reading from the beginning of that thread.
+
+**threadId** (`string`): Browse a different thread by its ID. Use \`mode: "threads"\` first to discover thread IDs. When provided without a \`cursor\`, reading starts from the beginning of the thread.
+
+**page** (`number`): Pagination offset. For messages: positive values page forward from cursor, negative values page backward. For threads: page number (0-indexed). \`0\` is treated as \`1\` for messages. (Default: `1`)
+
+**limit** (`number`): Maximum number of items to return per page. (Default: `20`)
 
 **detail** (`'low' | 'high'`): Controls how much content is shown per message part. \`'low'\` shows truncated text and tool names with positional indices (\`\[p0]\`, \`\[p1]\`). \`'high'\` shows full content including tool arguments and results, clamped to one part per call with continuation hints. (Default: `'low'`)
 
 **partIndex** (`number`): Fetch a single message part at full detail by its positional index. Use this when a low-detail recall shows an interesting part at \`\[p1]\` — call again with \`partIndex: 1\` to see the full content without loading every part.
 
-### Returns
+**before** (`string`): For \`mode: "threads"\` only. Filter to threads created before this date. Accepts ISO 8601 format (e.g. \`"2026-03-15"\`, \`"2026-03-10T00:00:00Z"\`).
+
+**after** (`string`): For \`mode: "threads"\` only. Filter to threads created after this date. Accepts ISO 8601 format (e.g. \`"2026-03-01"\`, \`"2026-03-10T00:00:00Z"\`).
+
+### Returns (messages mode)
 
 **messages** (`string`): Formatted message content. Format depends on the \`detail\` level.
 
@@ -612,6 +622,22 @@ When `retrieval: true` is set with `scope: 'thread'`, OM registers a `recall` to
 
 **tokenOffset** (`number`): Approximate number of tokens that were trimmed when \`truncated\` is true.
 
+### Returns (threads mode)
+
+**threads** (`string`): Formatted thread listing. Each thread shows its title, ID, and dates. The current thread is marked with \`← current\`.
+
+**count** (`number`): Number of threads returned.
+
+**page** (`number`): The page number returned.
+
+**hasMore** (`boolean`): Whether more threads exist on the next page.
+
+### Returns (search mode)
+
+**results** (`string`): Formatted search results grouped by thread. Each result shows the thread title, thread ID, relevance score, message preview, and a cursor ID for browsing into that thread.
+
+**count** (`number`): Number of matching messages found.
+
 ### ModelByInputTokens
 
 `ModelByInputTokens` selects a model based on the input token count. It chooses the model for the smallest threshold that covers the actual input size.
@@ -632,8 +658,8 @@ import { ModelByInputTokens } from '@mastra/memory'
 const selector = new ModelByInputTokens({
   upTo: {
     10_000: 'google/gemini-2.5-flash', // Fast for small inputs
-    40_000: 'openai/gpt-4o', // Stronger for medium inputs
-    1_000_000: 'openai/gpt-4.5', // Most capable for large inputs
+    40_000: 'openai/gpt-5.4-mini', // Stronger for medium inputs
+    1_000_000: 'openai/gpt-5.4', // Most capable for large inputs
   },
 })
 ```

package/.docs/reference/observability/tracing/interfaces.md

@@ -268,7 +268,7 @@ Model Generation attributes.
 
 ```typescript
 interface ModelGenerationAttributes {
-  /** Model name (e.g., 'gpt-4', 'claude-3') */
+  /** Model name (e.g., 'gpt-5.4', 'claude-opus-4-6') */
   model?: string
 
   /** Model provider (e.g., 'openai', 'anthropic') */

package/.docs/reference/processors/message-history-processor.md

@@ -45,7 +45,7 @@ const storage = new PostgresStorage({
 export const agent = new Agent({
   name: 'memory-agent',
   instructions: 'You are a helpful assistant with conversation memory',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [
     new MessageHistory({
       storage,

package/.docs/reference/processors/processor-interface.md

@@ -202,9 +202,9 @@ The method can return any combination of these properties:
 When multiple processors implement `processInputStep`, they run in order and changes chain through:
 
 ```text
-Processor 1: receives { model: 'gpt-4o' } → returns { model: 'gpt-4o-mini' }
-Processor 2: receives { model: 'gpt-4o-mini' } → returns { toolChoice: 'none' }
-Final: model = 'gpt-4o-mini', toolChoice = 'none'
+Processor 1: receives { model: 'gpt-5.4' } → returns { model: 'gpt-5.4-mini' }
+Processor 2: receives { model: 'gpt-5.4-mini' } → returns { toolChoice: 'none' }
+Final: model = 'gpt-5.4-mini', toolChoice = 'none'
 ```
 
 #### System message isolation

package/.docs/reference/processors/semantic-recall-processor.md

@@ -82,7 +82,7 @@ const semanticRecall = new SemanticRecall({
 export const agent = new Agent({
   name: 'semantic-memory-agent',
   instructions: 'You are a helpful assistant with semantic memory recall',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [semanticRecall, new MessageHistory({ storage, lastMessages: 50 })],
   outputProcessors: [semanticRecall, new MessageHistory({ storage })],
 })

package/.docs/reference/processors/skill-search-processor.md

@@ -0,0 +1,93 @@
+# SkillSearchProcessor
+
+The `SkillSearchProcessor` is an **input processor** that enables on-demand skill discovery and loading. Instead of injecting all skill metadata into the system prompt upfront (like `SkillsProcessor`), it gives the agent two meta-tools (`search_skills` and `load_skill`) that let it find and load skills on demand. This reduces context token usage when workspaces have many skills.
+
+## Usage example
+
+```typescript
+import { SkillSearchProcessor } from '@mastra/core/processors'
+
+const skillSearch = new SkillSearchProcessor({
+  workspace,
+  search: {
+    topK: 5,
+    minScore: 0.1,
+  },
+})
+```
+
+## Constructor parameters
+
+**options** (`SkillSearchProcessorOptions`): Configuration options for the skill search processor
+
+**options.workspace** (`Workspace`): Workspace instance containing skills. Skills are accessed via workspace.skills.
+
+**options.search** (`{ topK?: number; minScore?: number }`): Configuration for the search behavior.
+
+**options.search.topK** (`number`): Maximum number of skills to return in search results.
+
+**options.search.minScore** (`number`): Minimum relevance score for including a skill in search results.
+
+**options.ttl** (`number`): Time-to-live for thread state in milliseconds. After this duration of inactivity, thread state will be cleaned up. Set to 0 to disable cleanup.
+
+## Returns
+
+**id** (`string`): Processor identifier set to 'skill-search'
+
+**name** (`string`): Processor display name set to 'Skill Search Processor'
+
+**processInputStep** (`(args: ProcessInputStepArgs) => Promise<ProcessInputStepResult>`): Processes each step to inject search/load meta-tools and any previously loaded skill instructions as system messages.
+
+## Extended usage example
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { SkillSearchProcessor } from '@mastra/core/processors'
+import { Workspace, LocalFilesystem } from '@mastra/core/workspace'
+
+const workspace = new Workspace({
+  filesystem: new LocalFilesystem({ basePath: './project' }),
+  skills: ['/skills'],
+  bm25: true,
+})
+
+const skillSearch = new SkillSearchProcessor({
+  workspace,
+  search: {
+    topK: 5,
+    minScore: 0.1,
+  },
+})
+
+const agent = new Agent({
+  name: 'skill-agent',
+  instructions:
+    'You are a helpful assistant. Use search_skills to find relevant skills, then load_skill to load their instructions.',
+  model: 'openai/gpt-4o',
+  workspace,
+  inputProcessors: [skillSearch],
+})
+```
+
+The agent workflow is:
+
+1. Agent receives a user message
+2. Agent calls `search_skills` with keywords (e.g., "api design")
+3. Agent reviews results and calls `load_skill` with the skill name
+4. The skill's instructions appear as system messages on the next turn
+5. Agent follows the loaded skill's instructions
+
+## Compared to SkillsProcessor
+
+|                | SkillsProcessor            | SkillSearchProcessor               |
+| -------------- | -------------------------- | ---------------------------------- |
+| Scaling        | Injects all skills upfront | On-demand discovery                |
+| Context usage  | Grows with skill count     | Constant (only loaded skills)      |
+| Agent workflow | Skills always visible      | Agent searches and loads as needed |
+| Best for       | Few skills (< 10)          | Many skills (10+)                  |
+
+## Related
+
+- [ToolSearchProcessor](https://mastra.ai/reference/processors/tool-search-processor)
+- [Processors](https://mastra.ai/docs/agents/processors)
+- [Workspace Skills](https://mastra.ai/docs/workspace/overview)

package/.docs/reference/processors/tool-call-filter.md

@@ -39,7 +39,7 @@ import { ToolCallFilter } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'filtered-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   tools: {
     searchDatabase,
     sendEmail,
@@ -64,7 +64,7 @@ import { ToolCallFilter } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'no-tools-context-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   tools: {
     searchDatabase,
     sendEmail,

package/.docs/reference/processors/working-memory-processor.md

@@ -67,7 +67,7 @@ const storage = new PostgresStorage({
 export const agent = new Agent({
   name: 'personalized-agent',
   instructions: 'You are a helpful assistant that remembers user preferences',
-  model: 'openai:gpt-4o',
+  model: 'openai/gpt-5.4',
   inputProcessors: [
     new WorkingMemory({
       storage,

package/.docs/reference/streaming/agents/stream.md

@@ -327,7 +327,7 @@ await agent.stream('message for agent', {
 
 ## OpenAI WebSocket transport
 
-Opt into OpenAI Responses WebSocket streaming via `providerOptions.openai.transport`. This only applies to streaming calls and is currently supported for direct OpenAI models (for example, `openai/gpt-4o`). If WebSocket streaming is unavailable, Mastra falls back to HTTP streaming. By default, Mastra closes the WebSocket when the stream finishes.
+Opt into OpenAI Responses WebSocket streaming via `providerOptions.openai.transport`. This only applies to streaming calls and is currently supported for direct OpenAI models (for example, `openai/gpt-5.4`). If WebSocket streaming is unavailable, Mastra falls back to HTTP streaming. By default, Mastra closes the WebSocket when the stream finishes.
 
 ```ts
 const stream = await agent.stream('Hello', {

package/.docs/reference/tools/mcp-client.md

@@ -901,7 +901,7 @@ const mcpClient = new MCPClient({
 const agent = new Agent({
   name: 'My Agent',
   instructions: 'You are a helpful assistant.',
-  model: openai('gpt-4o'),
+  model: openai('gpt-5.4'),
   tools: await mcpClient.listTools(),
 })
 

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @mastra/mcp-docs-server
 
+## 1.1.17-alpha.12
+
+### Patch Changes
+
+- Updated dependencies [[`e333b77`](https://github.com/mastra-ai/mastra/commit/e333b77e2d76ba57ccec1818e08cebc1993469ff), [`60a224d`](https://github.com/mastra-ai/mastra/commit/60a224dd497240e83698cfa5bfd02e3d1d854844), [`949b7bf`](https://github.com/mastra-ai/mastra/commit/949b7bfd4e40f2b2cba7fef5eb3f108a02cfe938), [`d084b66`](https://github.com/mastra-ai/mastra/commit/d084b6692396057e83c086b954c1857d20b58a14), [`79c699a`](https://github.com/mastra-ai/mastra/commit/79c699acf3cd8a77e11c55530431f48eb48456e9), [`62757b6`](https://github.com/mastra-ai/mastra/commit/62757b6db6e8bb86569d23ad0b514178f57053f8), [`3d70b0b`](https://github.com/mastra-ai/mastra/commit/3d70b0b3524d817173ad870768f259c06d61bd23), [`3b45a13`](https://github.com/mastra-ai/mastra/commit/3b45a138d09d040779c0aba1edbbfc1b57442d23), [`8127d96`](https://github.com/mastra-ai/mastra/commit/8127d96280492e335d49b244501088dfdd59a8f1)]:
+  - @mastra/core@1.18.0-alpha.3
+
+## 1.1.17-alpha.10
+
+### Patch Changes
+
+- Updated dependencies [[`f16d92c`](https://github.com/mastra-ai/mastra/commit/f16d92c677a119a135cebcf7e2b9f51ada7a9df4)]:
+  - @mastra/core@1.18.0-alpha.2
+
+## 1.1.17-alpha.8
+
+### Patch Changes
+
+- Updated dependencies [[`dc9fc19`](https://github.com/mastra-ai/mastra/commit/dc9fc19da4437f6b508cc355f346a8856746a76b), [`260fe12`](https://github.com/mastra-ai/mastra/commit/260fe1295fe7354e39d6def2775e0797a7a277f0)]:
+  - @mastra/core@1.18.0-alpha.1
+
+## 1.1.17-alpha.6
+
+### Patch Changes
+
+- Updated dependencies [[`dc514a8`](https://github.com/mastra-ai/mastra/commit/dc514a83dba5f719172dddfd2c7b858e4943d067), [`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778)]:
+  - @mastra/core@1.18.0-alpha.0
+
+## 1.1.17-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`404fea1`](https://github.com/mastra-ai/mastra/commit/404fea13042181f0b0c73a101392ac87c79ceae2), [`ebf5047`](https://github.com/mastra-ai/mastra/commit/ebf5047e825c38a1a356f10b214c1d4260dfcd8d), [`675f15b`](https://github.com/mastra-ai/mastra/commit/675f15b7eaeea649158d228ea635be40480c584d), [`b174c63`](https://github.com/mastra-ai/mastra/commit/b174c63a093108d4e53b9bc89a078d9f66202b3f), [`eef7cb2`](https://github.com/mastra-ai/mastra/commit/eef7cb2abe7ef15951e2fdf792a5095c6c643333), [`86e3263`](https://github.com/mastra-ai/mastra/commit/86e326363edd12be5a5b25ccce4a39f66f7c9f50), [`e8a5b0b`](https://github.com/mastra-ai/mastra/commit/e8a5b0b9bc94d12dee4150095512ca27a288d778)]:
+  - @mastra/core@1.17.0-alpha.2
+
+## 1.1.17-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`7302e5c`](https://github.com/mastra-ai/mastra/commit/7302e5ce0f52d769d3d63fb0faa8a7d4089cda6d)]:
+  - @mastra/core@1.16.1-alpha.1
+
 ## 1.1.17-alpha.0
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.17-alpha.1",
+  "version": "1.1.17-alpha.13",
   "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.16.1-alpha.0",
+    "@mastra/core": "1.18.0-alpha.3",
     "@mastra/mcp": "^1.3.1"
   },
   "devDependencies": {
@@ -46,9 +46,9 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
-    "@mastra/core": "1.16.1-alpha.0",
+    "@internal/types-builder": "0.0.49",
     "@internal/lint": "0.0.74",
-    "@internal/types-builder": "0.0.49"
+    "@mastra/core": "1.18.0-alpha.3"
   },
   "homepage": "https://mastra.ai",
   "repository": {

package/.docs/reference/core/getStoredAgentById.md

@@ -1,87 +0,0 @@
-# Mastra.getStoredAgentById()
-
-The `.getStoredAgentById()` method retrieves an agent configuration from storage by its ID and creates an executable `Agent` instance. Stored agents allow you to persist agent configurations in a database and dynamically load them at runtime.
-
-## Usage example
-
-```typescript
-// Get an Agent instance from storage
-const agent = await mastra.getStoredAgentById('my-stored-agent')
-
-if (agent) {
-  const response = await agent.generate('Hello')
-  console.log(response.text)
-}
-```
-
-```typescript
-// Get the raw storage data instead of an Agent instance
-const storedConfig = await mastra.getStoredAgentById('my-stored-agent', { raw: true })
-
-if (storedConfig) {
-  console.log(storedConfig.instructions)
-  console.log(storedConfig.createdAt)
-}
-```
-
-## Parameters
-
-**id** (`string`): The unique identifier of the stored agent to retrieve.
-
-**options** (`{ raw?: boolean }`): Optional configuration object.
-
-**options.raw** (`boolean`): When \`true\`, returns the raw \`StorageAgentType\` object from storage instead of creating an \`Agent\` instance. Useful for inspecting stored configuration or metadata.
-
-## Returns
-
-**result** (`Agent | StorageAgentType | null`): Returns an \`Agent\` instance by default, or \`StorageAgentType\` when \`raw: true\`. Returns \`null\` if no agent with the given ID exists.
-
-## Primitive resolution
-
-When creating an `Agent` instance from stored configuration, the method resolves references to registered primitives:
-
-- **Tools**: Resolved from `tools` registered in Mastra config
-- **Workflows**: Resolved from `workflows` registered in Mastra config
-- **Subagents**: Resolved from `agents` registered in Mastra config
-- **Memory**: Resolved from `memory` registered in Mastra config
-- **Scorers**: Resolved from `scorers` registered in Mastra config, including sampling configuration
-
-If a referenced primitive isn't found in the registry, a warning is logged but the agent is still created.
-
-## `StorageAgentType`
-
-When using `raw: true`, the returned object has the following structure:
-
-**id** (`string`): Unique identifier for the agent.
-
-**name** (`string`): Display name of the agent.
-
-**description** (`string`): Optional description of the agent.
-
-**instructions** (`string`): System instructions for the agent.
-
-**model** (`Record<string, unknown>`): Model configuration with provider and name.
-
-**tools** (`Record<string, unknown>`): Tool references to resolve from registry.
-
-**workflows** (`Record<string, unknown>`): Workflow references to resolve from registry.
-
-**agents** (`Record<string, unknown>`): Subagent references to resolve from registry.
-
-**memory** (`Record<string, unknown>`): Memory reference to resolve from registry.
-
-**scorers** (`Record<string, unknown>`): Scorer references with optional sampling config.
-
-**defaultOptions** (`Record<string, unknown>`): Default options passed to agent execution.
-
-**metadata** (`Record<string, unknown>`): Custom metadata stored with the agent.
-
-**createdAt** (`Date`): Timestamp when the agent was created.
-
-**updatedAt** (`Date`): Timestamp when the agent was last updated.
-
-## Related
-
-- [Mastra.listStoredAgents()](https://mastra.ai/reference/core/listStoredAgents)
-- [Storage overview](https://mastra.ai/reference/storage/overview)
-- [Agents overview](https://mastra.ai/docs/agents/overview)

package/.docs/reference/core/listStoredAgents.md

@@ -1,91 +0,0 @@
-# Mastra.listStoredAgents()
-
-The `.listStoredAgents()` method retrieves a paginated list of agent configurations from storage. By default, it returns executable `Agent` instances, but can also return raw storage data.
-
-## Usage example
-
-```typescript
-// Get Agent instances from storage
-const { agents, total, hasMore } = await mastra.listStoredAgents()
-
-for (const agent of agents) {
-  console.log(agent.id, agent.name)
-  // Each agent is ready to use
-  // const response = await agent.generate("Hello");
-}
-```
-
-```typescript
-// Get paginated results with raw storage data
-const result = await mastra.listStoredAgents({
-  page: 0,
-  perPage: 10,
-  raw: true,
-})
-
-console.log(`Showing ${result.agents.length} of ${result.total} agents`)
-console.log(`Has more: ${result.hasMore}`)
-
-for (const config of result.agents) {
-  console.log(config.id, config.name, config.createdAt)
-}
-```
-
-## Parameters
-
-**args** (`object`): Optional configuration object for pagination and output format.
-
-**args.page** (`number`): Zero-indexed page number for pagination.
-
-**args.perPage** (`number | false`): Number of items per page. Set to \`false\` to fetch all records without pagination.
-
-**args.raw** (`boolean`): When \`true\`, returns raw \`StorageAgentType\` objects instead of \`Agent\` instances.
-
-## Returns
-
-**agents** (`Agent[] | StorageAgentType[]`): Array of \`Agent\` instances by default, or \`StorageAgentType\` objects when \`raw: true\`.
-
-**total** (`number`): Total number of stored agents across all pages.
-
-**page** (`number`): Current page number (zero-indexed).
-
-**perPage** (`number | false`): Number of items per page, or \`false\` if fetching all.
-
-**hasMore** (`boolean`): Whether there are more pages available.
-
-## Primitive resolution
-
-When creating `Agent` instances (default behavior), each stored agent's configuration is resolved against registered primitives:
-
-- **Tools**: Resolved from `tools` registered in Mastra config
-- **Workflows**: Resolved from `workflows` registered in Mastra config
-- **Subagents**: Resolved from `agents` registered in Mastra config
-- **Memory**: Resolved from `memory` registered in Mastra config
-- **Scorers**: Resolved from `scorers` registered in Mastra config
-
-If a referenced primitive isn't found, a warning is logged but the agent is still created.
-
-## Example: Iterating through all stored agents
-
-```typescript
-async function getAllStoredAgents(mastra: Mastra) {
-  const allAgents: Agent[] = []
-  let page = 0
-  let hasMore = true
-
-  while (hasMore) {
-    const result = await mastra.listStoredAgents({ page, perPage: 50 })
-    allAgents.push(...result.agents)
-    hasMore = result.hasMore
-    page++
-  }
-
-  return allAgents
-}
-```
-
-## Related
-
-- [Mastra.getStoredAgentById()](https://mastra.ai/reference/core/getStoredAgentById)
-- [Storage overview](https://mastra.ai/reference/storage/overview)
-- [Agents overview](https://mastra.ai/docs/agents/overview)