@mastra/mcp-docs-server 0.13.22-alpha.1 → 0.13.22-alpha.2

package/.docs/organized/changelogs/%40mastra%2Fclient-js.md

@@ -1,5 +1,12 @@
 # @mastra/client-js
 
+## 0.12.4-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251)]:
+  - @mastra/core@0.16.4-alpha.2
+
 ## 0.12.4-alpha.1
 
 ### Patch Changes
@@ -292,11 +299,4 @@
 
 ### Patch Changes
 
-- Updated dependencies [[`637f323`](https://github.com/mastra-ai/mastra/commit/637f32371d79a8f78c52c0d53411af0915fcec67), [`29de0e1`](https://github.com/mastra-ai/mastra/commit/29de0e1b0a7173317ae7d1ab0c0993167c659f2b), [`6ac697e`](https://github.com/mastra-ai/mastra/commit/6ac697edcc2435482c247cba615277ec4765dcc4)]:
-  - @mastra/core@0.15.3-alpha.1
-
-## 0.11.3-alpha.0
-
-### Patch Changes
-
-... 2507 more lines hidden. See full changelog in package directory.
+... 2514 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fcore.md

@@ -1,5 +1,13 @@
 # @mastra/core
 
+## 0.16.4-alpha.2
+
+### Patch Changes
+
+- Postgresql Storage Query Index Performance: Adds index operations and automatic indexing for Postgresql ([#7757](https://github.com/mastra-ai/mastra/pull/7757))
+
+- Fixes assistant message ids when using toUIMessageStream, preserves the original messageId rather than creating a new id for this message. ([#7783](https://github.com/mastra-ai/mastra/pull/7783))
+
 ## 0.16.4-alpha.1
 
 ### Patch Changes
@@ -290,13 +298,5 @@
 - 6f5eb7a: Throw if an empty or whitespace-only threadId is passed when getting messages
 - a9e50ee: Allow both workflow stream message formats for now
 - 5397eb4: Add public URL support when adding files in Multi Modal
-- c9f4e4a: Pass tracing context to scorer run
-- 0acbc80: Add InferUITools and related type helpers for AI SDK compatibility
-
-  Adds new type utility functions to help with type inference when using Mastra tools with the AI SDK's UI components:
-  - `InferUITools` - Infers input/output types for a collection of tools
-  - `InferUITool` - Infers input/output types for a single tool
-
-  These type helpers allow developers to easily integrate Mastra tools with AI SDK UI components like `useChat` by providing proper type inference for tool inputs and outputs.
 
-... 3290 more lines hidden. See full changelog in package directory.
+... 3298 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md

@@ -1,5 +1,13 @@
 # @mastra/deployer-cloud
 
+## 0.16.4-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251)]:
+  - @mastra/core@0.16.4-alpha.2
+  - @mastra/deployer@0.16.4-alpha.2
+
 ## 0.16.4-alpha.1
 
 ### Patch Changes
@@ -290,13 +298,5 @@
 
 ### Patch Changes
 
-- Updated dependencies [[`822c2e8`](https://github.com/mastra-ai/mastra/commit/822c2e88a3ecbffb7c680e6227976006ccefe6a8)]:
-  - @mastra/core@0.15.3-alpha.2
-  - @mastra/deployer@0.15.3-alpha.2
-
-## 0.15.3-alpha.1
-
-### Patch Changes
-
 
-... 70 more lines hidden. See full changelog in package directory.
+... 78 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fdeployer.md

@@ -1,5 +1,13 @@
 # @mastra/deployer
 
+## 0.16.4-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251)]:
+  - @mastra/core@0.16.4-alpha.2
+  - @mastra/server@0.16.4-alpha.2
+
 ## 0.16.4-alpha.1
 
 ### Patch Changes
@@ -290,13 +298,5 @@
 
 ## 0.15.3-alpha.9
 
-### Patch Changes
-
-- Updated dependencies [[`599d04c`](https://github.com/mastra-ai/mastra/commit/599d04cebe92c1d536fee3190434941b8c91548e)]:
-  - @mastra/core@0.15.3-alpha.9
-  - @mastra/server@0.15.3-alpha.9
-
-## 0.15.3-alpha.8
-
 
-... 4062 more lines hidden. See full changelog in package directory.
+... 4070 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 0.13.22-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251)]:
+  - @mastra/core@0.16.4-alpha.2
+
 ## 0.13.22-alpha.1
 
 ### Patch Changes
@@ -291,12 +298,5 @@
   - @mastra/mcp@0.11.2
   - @mastra/core@0.15.2
 
-## 0.13.15
-
-### Patch Changes
-
-- Updated dependencies [[`95b2aa9`](https://github.com/mastra-ai/mastra/commit/95b2aa908230919e67efcac0d69005a2d5745298)]:
-  - @mastra/mcp@0.11.1
-  - @mastra/core@0.15.1
 
-... 1740 more lines hidden. See full changelog in package directory.
+... 1747 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fpg.md

@@ -1,5 +1,14 @@
 # @mastra/pg
 
+## 0.15.3-alpha.1
+
+### Patch Changes
+
+- Postgresql Storage Query Index Performance: Adds index operations and automatic indexing for Postgresql ([#7757](https://github.com/mastra-ai/mastra/pull/7757))
+
+- Updated dependencies [[`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251)]:
+  - @mastra/core@0.16.4-alpha.2
+
 ## 0.15.3-alpha.0
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 - Updated dependencies [63449d0]
 - Updated dependencies [121a3f8]
 - Updated dependencies [ec510e7]
-  - @mastra/core@0.13.2
-
-## 0.14.0-alpha.0
-
-### Minor Changes
-
-- 79d34ce: improve cloudflare workers compatibility
-
-### Patch Changes
 
-... 2310 more lines hidden. See full changelog in package directory.
+... 2319 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,12 @@
 # @mastra/server
 
+## 0.16.4-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251)]:
+  - @mastra/core@0.16.4-alpha.2
+
 ## 0.16.4-alpha.1
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 ### Patch Changes
 
 - Updated dependencies [[`637f323`](https://github.com/mastra-ai/mastra/commit/637f32371d79a8f78c52c0d53411af0915fcec67), [`29de0e1`](https://github.com/mastra-ai/mastra/commit/29de0e1b0a7173317ae7d1ab0c0993167c659f2b), [`6ac697e`](https://github.com/mastra-ai/mastra/commit/6ac697edcc2435482c247cba615277ec4765dcc4)]:
-  - @mastra/core@0.15.3-alpha.1
-
-## 0.15.3-alpha.0
-
-### Patch Changes
-
-- [#7109](https://github.com/mastra-ai/mastra/pull/7109) [`5de1555`](https://github.com/mastra-ai/mastra/commit/5de15554d3d6695211945a36928f6657e76cddc9) Thanks [@epinzur](https://github.com/epinzur)! - Fixed tracingContext on tool executions in AI tracing
 
-... 3316 more lines hidden. See full changelog in package directory.
+... 3323 more lines hidden. See full changelog in package directory.

package/.docs/raw/reference/storage/postgresql.mdx

@@ -112,3 +112,194 @@ This enables direct queries and custom transaction management. When using these
 
 This approach is intended for advanced scenarios where low-level access is required.
 
+## Index Management
+
+PostgreSQL storage provides comprehensive index management capabilities to optimize query performance.
+
+### Automatic Performance Indexes
+
+PostgreSQL storage automatically creates composite indexes during initialization for common query patterns:
+
+- `mastra_threads_resourceid_createdat_idx`: (resourceId, createdAt DESC)
+- `mastra_messages_thread_id_createdat_idx`: (thread_id, createdAt DESC)  
+- `mastra_traces_name_starttime_idx`: (name, startTime DESC)
+- `mastra_evals_agent_name_created_at_idx`: (agent_name, created_at DESC)
+
+These indexes significantly improve performance for filtered queries with sorting.
+
+### Creating Custom Indexes
+
+Create additional indexes to optimize specific query patterns:
+
+```typescript copy
+// Basic index for common queries
+await storage.createIndex({
+  name: 'idx_threads_resource',
+  table: 'mastra_threads',
+  columns: ['resourceId']
+});
+
+// Composite index with sort order for filtering + sorting
+await storage.createIndex({
+  name: 'idx_messages_composite',
+  table: 'mastra_messages',
+  columns: ['thread_id', 'createdAt DESC']
+});
+
+// GIN index for JSONB columns (fast JSON queries)
+await storage.createIndex({
+  name: 'idx_traces_attributes',
+  table: 'mastra_traces',
+  columns: ['attributes'],
+  method: 'gin'
+});
+```
+
+For more advanced use cases, you can also use:
+- `unique: true` for unique constraints
+- `where: 'condition'` for partial indexes
+- `method: 'brin'` for time-series data
+- `storage: { fillfactor: 90 }` for update-heavy tables
+- `concurrent: true` for non-blocking creation (default)
+
+### Index Options
+
+<PropertiesTable
+  content={[
+    {
+      name: "name",
+      type: "string",
+      description: "Unique name for the index",
+      isOptional: false,
+    },
+    {
+      name: "table",
+      type: "string",
+      description: "Table name (e.g., 'mastra_threads')",
+      isOptional: false,
+    },
+    {
+      name: "columns",
+      type: "string[]",
+      description: "Array of column names with optional sort order (e.g., ['id', 'createdAt DESC'])",
+      isOptional: false,
+    },
+    {
+      name: "unique",
+      type: "boolean",
+      description: "Creates a unique constraint index",
+      isOptional: true,
+    },
+    {
+      name: "concurrent",
+      type: "boolean",
+      description: "Creates index without locking table (default: true)",
+      isOptional: true,
+    },
+    {
+      name: "where",
+      type: "string",
+      description: "Partial index condition (PostgreSQL specific)",
+      isOptional: true,
+    },
+    {
+      name: "method",
+      type: "'btree' | 'hash' | 'gin' | 'gist' | 'spgist' | 'brin'",
+      description: "Index method (default: 'btree')",
+      isOptional: true,
+    },
+    {
+      name: "opclass",
+      type: "string",
+      description: "Operator class for GIN/GIST indexes",
+      isOptional: true,
+    },
+    {
+      name: "storage",
+      type: "Record<string, any>",
+      description: "Storage parameters (e.g., { fillfactor: 90 })",
+      isOptional: true,
+    },
+    {
+      name: "tablespace",
+      type: "string",
+      description: "Tablespace name for index placement",
+      isOptional: true,
+    }
+  ]}
+/>
+
+### Managing Indexes
+
+List and monitor existing indexes:
+
+```typescript copy
+// List all indexes
+const allIndexes = await storage.listIndexes();
+console.log(allIndexes);
+// [
+//   {
+//     name: 'mastra_threads_pkey',
+//     table: 'mastra_threads',
+//     columns: ['id'],
+//     unique: true,
+//     size: '16 KB',
+//     definition: 'CREATE UNIQUE INDEX...'
+//   },
+//   ...
+// ]
+
+// List indexes for specific table
+const threadIndexes = await storage.listIndexes('mastra_threads');
+
+// Get detailed statistics for an index
+const stats = await storage.describeIndex('idx_threads_resource');
+console.log(stats);
+// {
+//   name: 'idx_threads_resource',
+//   table: 'mastra_threads',
+//   columns: ['resourceId', 'createdAt'],
+//   unique: false,
+//   size: '128 KB',
+//   definition: 'CREATE INDEX idx_threads_resource...',
+//   method: 'btree',
+//   scans: 1542,           // Number of index scans
+//   tuples_read: 45230,    // Tuples read via index
+//   tuples_fetched: 12050  // Tuples fetched via index
+// }
+
+// Drop an index
+await storage.dropIndex('idx_threads_status');
+```
+
+### Schema-Specific Indexes
+
+When using custom schemas, indexes are created with schema prefixes:
+
+```typescript copy
+const storage = new PostgresStore({
+  connectionString: process.env.DATABASE_URL,
+  schemaName: 'custom_schema'
+});
+
+// Creates index as: custom_schema_idx_threads_status
+await storage.createIndex({
+  name: 'idx_threads_status',
+  table: 'mastra_threads',
+  columns: ['status']
+});
+```
+
+### Index Types and Use Cases
+
+PostgreSQL offers different index types optimized for specific scenarios:
+
+| Index Type | Best For | Storage | Speed |
+|------------|----------|---------|-------|
+| **btree** (default) | Range queries, sorting, general purpose | Moderate | Fast |
+| **hash** | Equality comparisons only | Small | Very fast for `=` |
+| **gin** | JSONB, arrays, full-text search | Large | Fast for contains |
+| **gist** | Geometric data, full-text search | Moderate | Fast for nearest-neighbor |
+| **spgist** | Non-balanced data, text patterns | Small | Fast for specific patterns |
+| **brin** | Large tables with natural ordering | Very small | Fast for ranges |
+

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 0.13.22-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251)]:
+  - @mastra/core@0.16.4-alpha.2
+
 ## 0.13.22-alpha.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.22-alpha.1",
+  "version": "0.13.22-alpha.2",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -33,11 +33,11 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6",
-    "@mastra/core": "0.16.4-alpha.1",
+    "@mastra/core": "0.16.4-alpha.2",
     "@mastra/mcp": "^0.12.0"
   },
   "devDependencies": {
-    "@hono/node-server": "^1.19.1",
+    "@hono/node-server": "^1.19.2",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^20.19.0",
     "@types/turndown": "^5.0.5",
@@ -49,8 +49,8 @@
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.39",
-    "@mastra/core": "0.16.4-alpha.1"
+    "@mastra/core": "0.16.4-alpha.2",
+    "@internal/lint": "0.0.39"
   },
   "homepage": "https://mastra.ai",
   "repository": {