@mastra/mcp-docs-server 1.3.0-alpha.5 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/.docs/docs/observability/feedback.md +1 -1
  2. package/.docs/integrations/databases/clickhouse.md +14 -1
  3. package/.docs/models/gateways/openrouter.md +2 -1
  4. package/.docs/models/index.md +1 -1
  5. package/.docs/models/providers/cortecs.md +5 -5
  6. package/.docs/models/providers/edenai.md +1 -1
  7. package/.docs/models/providers/kilo.md +7 -6
  8. package/.docs/models/providers/nano-gpt.md +1 -1
  9. package/.docs/reference/observability/feedback.md +1 -1
  10. package/.docs/reference/observability/tracing/interfaces.md +1 -1
  11. package/package.json +6 -6
package/.docs/docs/observability/feedback.md CHANGED
@@ -130,7 +130,7 @@ await observability!.deleteFeedback({
130
130
  })
131
131
  ```
132
132
 
133
- Deleted records also disappear from feedback analytics. ClickHouse uses a lightweight delete to hide rows without guaranteeing immediate physical removal, so open-source deployments must configure an [observability retention period](https://mastra.ai/reference/storage/retention) to physically purge them. Configure retention for every observability signal to expire deletion requests after the signal rows they protect. If any signal is unbounded, deletion requests also remain unbounded to prevent deleted data from being reintroduced. On ClickHouse, delete APIs leave the separate delta cursor table untouched. Its rows contain identifiers rather than feedback payloads and expire within two days.
133
+ Deleted records also disappear from feedback analytics. ClickHouse uses a lightweight delete to hide rows without guaranteeing immediate physical removal, so open-source deployments must configure an [observability retention period](https://mastra.ai/reference/storage/retention) to physically purge them. Each request is marked applied once its delete succeeds; if the delete fails, the request stays unapplied, doesn't block updates to the still-visible feedback, and you retry by calling the delete API again. Open-source deployments have no background reconciler. Configure retention for every observability signal to expire deletion requests after the signal rows they protect. If any signal is unbounded, deletion requests also remain unbounded to prevent deleted data from being reintroduced. On ClickHouse, delete APIs leave the separate delta cursor table untouched. Its rows contain identifiers rather than feedback payloads and expire within two days.
134
134
 
135
135
  ## Query feedback analytics
136
136
 
package/.docs/integrations/databases/clickhouse.md CHANGED
@@ -93,6 +93,10 @@ Lightweight deletion is a hide-only operation that marks rows with ClickHouse's
93
93
 
94
94
  When all five observability signals have finite retention, Mastra also applies a TTL to deletion requests so they outlive the signal rows they protect. If any signal is unbounded, deletion requests remain unbounded. See [storage retention](https://mastra.ai/reference/storage/retention) for how the deletion-request TTL is calculated.
95
95
 
96
+ Feedback review-status updates require `ALTER UPDATE` permission on `mastra_feedback_events` and, when delta polling is enabled, `INSERT` permission on `mastra_feedback_events_delta`. These updates wait for the ClickHouse mutation to finish on the server that receives the write, so latency depends on that server's mutation queue. Other replicas apply the mutation through the replication log, so a reader on a lagging replica can briefly see the previous status, and an inactive replica doesn't block the update. They modify the existing feedback row and preserve deletion masks: a concurrent review update cannot recreate deleted feedback. Successful updates remain available through delta polling. If a newer version of the same feedback event is ingested while a review update is in flight, the update is re-applied to that newer version; after repeated conflicts it fails with a conflict error (HTTP 409) and the caller retries.
97
+
98
+ The status mutation and the delta insert are separate operations. If the delta insert fails, the API returns an error even though the status may have changed, and continued delta polling doesn't recover that notification: later polls from the same cursor never return it, and starting delta mode without a cursor subscribes at the current head. To recover, retry the review update after resolving the error, or reread the feedback with a regular list query.
99
+
96
100
  ### Observability with the legacy domain
97
101
 
98
102
  `ObservabilityStorageClickhouse` is the original observability adapter and remains supported for projects that haven't migrated to the vNext schema. The configuration shape is the same as the vNext class.
@@ -368,7 +372,16 @@ const observability = new ObservabilityStorageClickhouseVNext({
368
372
  await observability.init()
369
373
  ```
370
374
 
371
- In CI/CD pipelines, set `disableInit: true` on `ClickhouseStore` and run `init()` from a deployment step that uses elevated credentials. Runtime application credentials can then be limited to read and insert.
375
+ In CI/CD pipelines, set `disableInit: true` on `ClickhouseStore` and run `init()` from a deployment step that uses elevated credentials. Runtime application credentials still need more than read and insert:
376
+
377
+ - `SELECT` and `INSERT` on the Mastra tables.
378
+ - `ALTER DELETE` on the observability tables you delete from. On ClickHouse 26.6 and earlier, lightweight deletes also require `ALTER UPDATE` on those tables; ClickHouse 26.7 removed that requirement.
379
+ - For feedback review updates, `ALTER UPDATE(reviewStatus)` on `mastra_feedback_events` and `INSERT` on `mastra_feedback_events_delta`.
380
+
381
+ ```sql
382
+ GRANT ALTER UPDATE(reviewStatus) ON <database>.mastra_feedback_events TO <runtime_user>;
383
+ GRANT INSERT ON <database>.mastra_feedback_events_delta TO <runtime_user>;
384
+ ```
372
385
 
373
386
  ## Observability
374
387
 
package/.docs/models/gateways/openrouter.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
6
6
 
7
- OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 384 models through Mastra's model router.
7
+ OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 385 models through Mastra's model router.
8
8
 
9
9
  Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
10
10
 
@@ -115,6 +115,7 @@ ANTHROPIC_API_KEY=ant-...
115
115
  | `deepseek/deepseek-v4-pro-0813` |
116
116
  | `deepseek/deepseek-v4.1-flash` |
117
117
  | `dots-studio/dots-3-note-preview:free` |
118
+ | `fireworks/ember-1` |
118
119
  | `google/gemini-2.5-flash` |
119
120
  | `google/gemini-2.5-flash-image` |
120
121
  | `google/gemini-2.5-flash-lite` |
package/.docs/models/index.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # Model Providers
6
6
 
7
- Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 7614 models from 210 providers through a single API.
7
+ Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 7616 models from 210 providers through a single API.
8
8
 
9
9
  ## Features
10
10
 
package/.docs/models/providers/cortecs.md CHANGED
@@ -53,7 +53,7 @@ for await (const chunk of stream) {
53
53
  | `cortecs/codestral-2508` | 256K | | | | | | $0.37 | $1 |
54
54
  | `cortecs/deepseek-r1-0528` | 164K | | | | | | $0.65 | $3 |
55
55
  | `cortecs/deepseek-v3.2` | 164K | | | | | | $0.30 | $0.49 |
56
- | `cortecs/deepseek-v4-flash-0731` | 1.0M | | | | | | $0.06 | $0.17 |
56
+ | `cortecs/deepseek-v4-flash-0731` | 1.0M | | | | | | $0.09 | $0.17 |
57
57
  | `cortecs/deepseek-v4-pro` | 1.0M | | | | | | $2 | $3 |
58
58
  | `cortecs/deepseek-v4-pro-0813` | 1.0M | | | | | | $2 | $4 |
59
59
  | `cortecs/deepseek-v4.1-flash` | 1.0M | | | | | | $0.50 | $1 |
@@ -73,8 +73,8 @@ for await (const chunk of stream) {
73
73
  | `cortecs/glm-5` | 203K | | | | | | $0.99 | $3 |
74
74
  | `cortecs/glm-5-turbo` | 203K | | | | | | $1 | $4 |
75
75
  | `cortecs/glm-5.1` | 203K | | | | | | $1 | $4 |
76
- | `cortecs/glm-5.2` | 1.0M | | | | | | $1 | $3 |
77
- | `cortecs/glm-5.3` | 1.0M | | | | | | $1 | $4 |
76
+ | `cortecs/glm-5.2` | 1.0M | | | | | | $0.90 | $3 |
77
+ | `cortecs/glm-5.3` | 1.0M | | | | | | $0.87 | $3 |
78
78
  | `cortecs/glm-5.3-flash` | 1.0M | | | | | | $0.10 | $0.35 |
79
79
  | `cortecs/glm-5v-turbo` | 203K | | | | | | $1 | $4 |
80
80
  | `cortecs/gpt-4.1` | 1.0M | | | | | | $2 | $9 |
@@ -97,8 +97,8 @@ for await (const chunk of stream) {
97
97
  | `cortecs/gpt-oss-safeguard-120b` | 128K | | | | | | $0.18 | $0.70 |
98
98
  | `cortecs/hermes-4-405b` | 128K | | | | | | $1.00 | $3 |
99
99
  | `cortecs/kimi-k2.5` | 262K | | | | | | $0.49 | $3 |
100
- | `cortecs/kimi-k2.6` | 262K | | | | | | $0.52 | $3 |
101
- | `cortecs/kimi-k2.7-code` | 262K | | | | | | $0.71 | $3 |
100
+ | `cortecs/kimi-k2.6` | 262K | | | | | | $0.47 | $3 |
101
+ | `cortecs/kimi-k2.7-code` | 262K | | | | | | $0.66 | $3 |
102
102
  | `cortecs/kimi-k3` | 1.0M | | | | | | $3 | $15 |
103
103
  | `cortecs/llama-3.1-8b-instruct` | 128K | | | | | | $0.17 | $0.17 |
104
104
  | `cortecs/llama-3.3-70b-instruct` | 131K | | | | | | $0.72 | $0.72 |
package/.docs/models/providers/edenai.md CHANGED
@@ -72,7 +72,7 @@ for await (const chunk of stream) {
72
72
  | `edenai/anthropic/claude-opus-4-8` | 1.0M | | | | | | $5 | $25 |
73
73
  | `edenai/anthropic/claude-opus-5` | 1.0M | | | | | | $5 | $25 |
74
74
  | `edenai/anthropic/claude-opus-5-5` | 1.0M | | | | | | $4 | $20 |
75
- | `edenai/anthropic/claude-opus-latest` | 1.0M | | | | | | $5 | $25 |
75
+ | `edenai/anthropic/claude-opus-latest` | 1.0M | | | | | | $4 | $20 |
76
76
  | `edenai/anthropic/claude-sonnet-4-6` | 1.0M | | | | | | $3 | $15 |
77
77
  | `edenai/anthropic/claude-sonnet-5` | 1.0M | | | | | | $2 | $10 |
78
78
  | `edenai/anthropic/claude-sonnet-latest` | 1.0M | | | | | | $2 | $10 |
package/.docs/models/providers/kilo.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![Kilo Gateway logo](https://models.dev/logos/kilo.svg)Kilo Gateway
6
6
 
7
- Access 391 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
7
+ Access 392 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
8
8
 
9
9
  Learn more in the [Kilo Gateway documentation](https://kilo.ai).
10
10
 
@@ -42,9 +42,9 @@ for await (const chunk of stream) {
42
42
  | `kilo/~anthropic/claude-haiku-latest` | 200K | | | | | | $1 | $5 |
43
43
  | `kilo/~anthropic/claude-opus-latest` | 1.0M | | | | | | $4 | $20 |
44
44
  | `kilo/~anthropic/claude-sonnet-latest` | 1.0M | | | | | | $2 | $10 |
45
- | `kilo/~deepseek/deepseek-flash-latest` | 1.0M | | | | | | $0.05 | $0.25 |
45
+ | `kilo/~deepseek/deepseek-flash-latest` | 1.0M | | | | | | $0.04 | $1 |
46
46
  | `kilo/~deepseek/deepseek-pro-latest` | 1.0M | | | | | | $0.39 | $3 |
47
- | `kilo/~deepseek/deepseek-v4-flash-latest` | 1.0M | | | | | | $0.04 | $0.55 |
47
+ | `kilo/~deepseek/deepseek-v4-flash-latest` | 1.0M | | | | | | $0.03 | $0.32 |
48
48
  | `kilo/~google/gemini-flash-latest` | 1.0M | | | | | | $0.75 | $4 |
49
49
  | `kilo/~google/gemini-pro-latest` | 1.0M | | | | | | $2 | $12 |
50
50
  | `kilo/~moonshotai/kimi-latest` | 1.0M | | | | | | $1 | $11 |
@@ -115,6 +115,7 @@ for await (const chunk of stream) {
115
115
  | `kilo/deepseek/deepseek-v4-pro-0813` | 1.0M | | | | | | $1 | $4 |
116
116
  | `kilo/deepseek/deepseek-v4.1-flash` | 1.0M | | | | | | $0.30 | $1 |
117
117
  | `kilo/dots-studio/dots-3-note-preview:free` | 512K | | | | | | — | — |
118
+ | `kilo/fireworks/ember-1` | 1.0M | | | | | | $3 | $15 |
118
119
  | `kilo/google/gemini-2.5-flash` | 1.0M | | | | | | $0.30 | $3 |
119
120
  | `kilo/google/gemini-2.5-flash-image` | 33K | | | | | | $0.15 | $1 |
120
121
  | `kilo/google/gemini-2.5-flash-lite` | 1.0M | | | | | | $0.10 | $0.40 |
@@ -210,7 +211,7 @@ for await (const chunk of stream) {
210
211
  | `kilo/moonshotai/kimi-k2-thinking` | 262K | | | | | | $0.60 | $3 |
211
212
  | `kilo/moonshotai/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
212
213
  | `kilo/moonshotai/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
213
- | `kilo/moonshotai/kimi-k2.7-code` | 262K | | | | | | $0.71 | $3 |
214
+ | `kilo/moonshotai/kimi-k2.7-code` | 262K | | | | | | $0.66 | $3 |
214
215
  | `kilo/moonshotai/kimi-k3` | 1.0M | | | | | | $3 | $15 |
215
216
  | `kilo/morph/morph-v3-fast` | 82K | | | | | | $0.80 | $1 |
216
217
  | `kilo/morph/morph-v3-large` | 262K | | | | | | $0.90 | $2 |
@@ -318,7 +319,7 @@ for await (const chunk of stream) {
318
319
  | `kilo/qwen/qwen3-235b-a22b-2507` | 262K | | | | | | $0.15 | $0.60 |
319
320
  | `kilo/qwen/qwen3-235b-a22b-thinking-2507` | 131K | | | | | | $0.23 | $2 |
320
321
  | `kilo/qwen/qwen3-30b-a3b` | 41K | | | | | | $0.13 | $0.52 |
321
- | `kilo/qwen/qwen3-30b-a3b-instruct-2507` | 128K | | | | | | $0.13 | $0.52 |
322
+ | `kilo/qwen/qwen3-30b-a3b-instruct-2507` | 262K | | | | | | $0.13 | $0.52 |
322
323
  | `kilo/qwen/qwen3-30b-a3b-thinking-2507` | 82K | | | | | | $0.20 | $2 |
323
324
  | `kilo/qwen/qwen3-32b` | 41K | | | | | | $0.08 | $0.28 |
324
325
  | `kilo/qwen/qwen3-8b` | 131K | | | | | | $0.12 | $0.46 |
@@ -383,7 +384,7 @@ for await (const chunk of stream) {
383
384
  | `kilo/stepfun/step-3.7-flash:free` | 262K | | | | | | — | — |
384
385
  | `kilo/tencent/hunyuan-a13b-instruct` | 131K | | | | | | $0.14 | $0.57 |
385
386
  | `kilo/tencent/hy-mt2-1.8b` | 8K | | | | | | $0.04 | $0.18 |
386
- | `kilo/tencent/hy-mt2-30b-a3b` | 8K | | | | | | $0.07 | $0.28 |
387
+ | `kilo/tencent/hy-mt2-30b-a3b` | 8K | | | | | | $0.07 | $0.29 |
387
388
  | `kilo/tencent/hy-mt2-7b` | 8K | | | | | | $0.07 | $0.29 |
388
389
  | `kilo/tencent/hy3` | 262K | | | | | | $0.13 | $0.53 |
389
390
  | `kilo/tencent/hy3-preview` | 262K | | | | | | $0.18 | $0.60 |
package/.docs/models/providers/nano-gpt.md CHANGED
@@ -266,6 +266,7 @@ for await (const chunk of stream) {
266
266
  | `nano-gpt/inference-net/schematron-v2-turbo` | 128K | | | | | | $0.03 | $0.15 |
267
267
  | `nano-gpt/inflatebot/MN-12B-Mag-Mell-R1` | 16K | | | | | | $0.49 | $0.49 |
268
268
  | `nano-gpt/kimi-k2-instruct-fast` | 131K | | | | | | $0.40 | $2 |
269
+ | `nano-gpt/kitani/clover-1-150b` | 200K | | | | | | $0.15 | $0.80 |
269
270
  | `nano-gpt/LatitudeGames/Wayfarer-Large-70B-Llama-3.3` | 33K | | | | | | $0.70 | $0.70 |
270
271
  | `nano-gpt/lightonai/LightOnOCR-2-1B` | 33K | | | | | | $0.18 | $0.35 |
271
272
  | `nano-gpt/liquid/lfm-2.5-2.6b` | 128K | | | | | | $0.10 | $0.20 |
@@ -339,7 +340,6 @@ for await (const chunk of stream) {
339
340
  | `nano-gpt/moonshotai/kimi-k3` | 1.0M | | | | | | $2 | $10 |
340
341
  | `nano-gpt/moonshotai/kimi-latest` | 1.0M | | | | | | $2 | $10 |
341
342
  | `nano-gpt/nano-gpt-help` | 6K | | | | | | — | — |
342
- | `nano-gpt/nano/lumen-stealth` | 200K | | | | | | $0.05 | — |
343
343
  | `nano-gpt/nanogpt/coding-router` | 1.0M | | | | | | $1 | $2 |
344
344
  | `nano-gpt/nanogpt/coding-router:high` | 1.0M | | | | | | $1 | $2 |
345
345
  | `nano-gpt/nanogpt/coding-router:low` | 1.0M | | | | | | $0.14 | $0.28 |
package/.docs/reference/observability/feedback.md CHANGED
@@ -138,7 +138,7 @@ await mastraClient.deleteFeedback({
138
138
 
139
139
  Returns `Promise<{ success: boolean }>` from `mastraClient.deleteFeedback()` and the HTTP route. The storage domain method returns `Promise<void>`. Requests with more than 1,000 ids return `400`, and a server running `@mastra/core` older than `1.66.0` returns `501`. ClickHouse vNext, PostgreSQL vNext, DuckDB, and the in-memory store implement deletion. Every other adapter, including LibSQL and MongoDB, throws `OBSERVABILITY_STORAGE_DELETE_FEEDBACK_NOT_IMPLEMENTED`.
140
140
 
141
- On ClickHouse, deletion uses lightweight deletes on the main feedback events table to remove rows from reads, including OLAP queries, without guaranteeing immediate physical removal, so open-source deployments must configure an [observability retention period](https://mastra.ai/reference/storage/retention) to physically purge them. ClickHouse applies a TTL to deletion requests only when all five signals have finite retention. See [ClickHouse native TTL](https://mastra.ai/reference/storage/retention). Delete APIs leave the separate delta cursor table untouched. Its rows contain identifiers rather than feedback payloads and expire within two days.
141
+ On ClickHouse, deletion uses lightweight deletes on the main feedback events table to remove rows from reads, including OLAP queries, without guaranteeing immediate physical removal, so open-source deployments must configure an [observability retention period](https://mastra.ai/reference/storage/retention) to physically purge them. Each request is marked applied once its delete succeeds; if the delete fails, the request stays unapplied, doesn't block `updateFeedbackReviewStatus()` on the still-visible feedback, and you retry by calling `deleteFeedback()` again. Open-source deployments have no background reconciler. ClickHouse applies a TTL to deletion requests only when all five signals have finite retention. See [ClickHouse native TTL](https://mastra.ai/reference/storage/retention). Delete APIs leave the separate delta cursor table untouched. Its rows contain identifiers rather than feedback payloads and expire within two days.
142
142
 
143
143
  ### `deleteScores(args)`
144
144
 
package/.docs/reference/observability/tracing/interfaces.md CHANGED
@@ -49,7 +49,7 @@ interface BatchDeleteTracesArgs {
49
49
 
50
50
  When `organizationId` or `resourceId` is provided, only records matching the scope are deleted. ClickHouse vNext, PostgreSQL vNext, DuckDB, and the in-memory store support scoped deletion. Other storage adapters throw `OBSERVABILITY_STORAGE_BATCH_DELETE_TRACES_SCOPE_NOT_SUPPORTED` rather than applying an unscoped delete.
51
51
 
52
- For ClickHouse vNext, the method records the deletion predicate and waits for the lightweight delete masks to be applied before it resolves. Lightweight deletion is hide-only through ClickHouse's `_row_exists` mask. Physical removal depends on merges and the retention TTLs you configure. See [ClickHouse trace deletion and retention](https://mastra.ai/integrations/databases/clickhouse) and [ClickHouse native TTL](https://mastra.ai/reference/storage/retention).
52
+ For ClickHouse vNext, the method records the deletion predicate and waits for the lightweight delete masks to be applied before it resolves. Lightweight deletion is hide-only through ClickHouse's `_row_exists` mask. Physical removal depends on merges and the retention TTLs you configure. Each request is marked applied once every delete succeeds; if a delete fails, the request stays unapplied and you retry by calling `batchDeleteTraces()` again. Mastra OSS has no background reconciler. See [ClickHouse trace deletion and retention](https://mastra.ai/integrations/databases/clickhouse) and [ClickHouse native TTL](https://mastra.ai/reference/storage/retention).
53
53
 
54
54
  ### `SpanTypeMap`
55
55
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.3.0-alpha.5",
3
+ "version": "1.3.0",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -26,8 +26,8 @@
26
26
  "@mastra/mcp-legacy": "npm:@mastra/mcp@^1.18.0",
27
27
  "local-pkg": "^1.1.2",
28
28
  "zod": "^4.6.4",
29
- "@mastra/core": "1.70.0-alpha.3",
30
- "@mastra/mcp": "^2.1.0-alpha.0"
29
+ "@mastra/core": "1.70.0",
30
+ "@mastra/mcp": "^2.1.0"
31
31
  },
32
32
  "devDependencies": {
33
33
  "@hono/node-server": "^2.0.0",
@@ -43,9 +43,9 @@
43
43
  "tsx": "^4.23.1",
44
44
  "typescript": "^7.0.2",
45
45
  "vitest": "4.1.11",
46
- "@internal/lint": "0.0.135",
47
- "@internal/types-builder": "0.0.110",
48
- "@mastra/core": "1.70.0-alpha.3"
46
+ "@internal/lint": "0.0.136",
47
+ "@internal/types-builder": "0.0.111",
48
+ "@mastra/core": "1.70.0"
49
49
  },
50
50
  "homepage": "https://mastra.ai",
51
51
  "repository": {