@mastra/mcp-docs-server 1.2.5-alpha.3 → 1.2.5-alpha.6

package/.docs/models/providers/digitalocean.md

@@ -2,7 +2,7 @@
 
 # ![DigitalOcean logo](https://models.dev/logos/digitalocean.svg)DigitalOcean
 
-Access 75 DigitalOcean models through Mastra's model router. Authentication is handled automatically using the `DIGITALOCEAN_ACCESS_TOKEN` environment variable.
+Access 77 DigitalOcean models through Mastra's model router. Authentication is handled automatically using the `DIGITALOCEAN_ACCESS_TOKEN` environment variable.
 
 Learn more in the [DigitalOcean documentation](https://docs.digitalocean.com/products/gradient-ai-platform/details/models/).
 
@@ -65,6 +65,8 @@ for await (const chunk of stream) {
 | `digitalocean/fal-ai/stable-audio-25/text-to-audio`  | —       |       |           |       |       |       | —          | —           |
 | `digitalocean/gemma-4-31B-it`                        | 256K    |       |           |       |       |       | $0.18      | $0.50       |
 | `digitalocean/glm-5`                                 | 203K    |       |           |       |       |       | $1         | $3          |
+| `digitalocean/glm-5.1`                               | 200K    |       |           |       |       |       | $0.97      | $4          |
+| `digitalocean/glm-5.2`                               | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `digitalocean/gte-large-en-v1.5`                     | 8K      |       |           |       |       |       | $0.09      | —           |
 | `digitalocean/kimi-k2.5`                             | 262K    |       |           |       |       |       | $0.50      | $3          |
 | `digitalocean/kimi-k2.6`                             | 262K    |       |           |       |       |       | $0.95      | $4          |

package/.docs/models/providers/longcat.md

@@ -0,0 +1,73 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![LongCat logo](https://models.dev/logos/longcat.svg)LongCat
+
+Access 1 LongCat model through Mastra's model router. Authentication is handled automatically using the `LONGCAT_API_KEY` environment variable.
+
+Learn more in the [LongCat documentation](https://longcat.chat/platform/docs/).
+
+```bash
+LONGCAT_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "longcat/LongCat-2.0"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [LongCat documentation](https://longcat.chat/platform/docs/) for details.
+
+## Models
+
+| Model                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `longcat/LongCat-2.0` | 1.0M    |       |           |       |       |       | $0.75      | $3          |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.longcat.chat/openai",
+    id: "longcat/LongCat-2.0",
+    apiKey: process.env.LONGCAT_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "longcat/LongCat-2.0"
+      : "longcat/LongCat-2.0";
+  }
+});
+```

package/.docs/models/providers/mistral.md

@@ -46,7 +46,7 @@ for await (const chunk of stream) {
 | `mistral/mistral-medium-2505`     | 131K    |       |           |       |       |       | $0.40      | $2          |
 | `mistral/mistral-medium-2508`     | 262K    |       |           |       |       |       | $0.40      | $2          |
 | `mistral/mistral-medium-2604`     | 262K    |       |           |       |       |       | $2         | $8          |
-| `mistral/mistral-medium-latest`   | 262K    |       |           |       |       |       | $0.40      | $2          |
+| `mistral/mistral-medium-latest`   | 262K    |       |           |       |       |       | $2         | $8          |
 | `mistral/mistral-nemo`            | 128K    |       |           |       |       |       | $0.15      | $0.15       |
 | `mistral/mistral-small-2506`      | 128K    |       |           |       |       |       | $0.10      | $0.30       |
 | `mistral/mistral-small-2603`      | 256K    |       |           |       |       |       | $0.15      | $0.60       |

package/.docs/models/providers/nvidia.md

@@ -2,7 +2,7 @@
 
 # ![Nvidia logo](https://models.dev/logos/nvidia.svg)Nvidia
 
-Access 83 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
+Access 84 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
 
 Learn more in the [Nvidia documentation](https://docs.api.nvidia.com/nim/).
 
@@ -119,6 +119,7 @@ for await (const chunk of stream) {
 | `nvidia/stepfun-ai/step-3.5-flash`                     | 256K    |       |           |       |       |       | —          | —           |
 | `nvidia/stepfun-ai/step-3.7-flash`                     | 256K    |       |           |       |       |       | —          | —           |
 | `nvidia/upstage/solar-10_7b-instruct`                  | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/z-ai/glm-5.2`                                  | 1.0M    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -148,7 +149,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "nvidia/upstage/solar-10_7b-instruct"
+      ? "nvidia/z-ai/glm-5.2"
       : "nvidia/abacusai/dracarys-llama-3_1-70b-instruct";
   }
 });

package/.docs/models/providers/stackit.md

@@ -36,14 +36,14 @@ for await (const chunk of stream) {
 
 | Model                                                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `stackit/cortecs/Llama-3.3-70B-Instruct-FP8-Dynamic` | 128K    |       |           |       |       |       | $0.49      | $0.71       |
-| `stackit/google/gemma-3-27b-it`                      | 37K     |       |           |       |       |       | $0.49      | $0.71       |
+| `stackit/cortecs/Llama-3.3-70B-Instruct-FP8-Dynamic` | 128K    |       |           |       |       |       | $0.53      | $0.76       |
+| `stackit/google/gemma-3-27b-it`                      | 37K     |       |           |       |       |       | $0.53      | $0.76       |
 | `stackit/intfloat/e5-mistral-7b-instruct`            | 4K      |       |           |       |       |       | $0.02      | $0.02       |
-| `stackit/neuralmagic/Meta-Llama-3.1-8B-Instruct-FP8` | 128K    |       |           |       |       |       | $0.16      | $0.27       |
-| `stackit/neuralmagic/Mistral-Nemo-Instruct-2407-FP8` | 128K    |       |           |       |       |       | $0.49      | $0.71       |
-| `stackit/openai/gpt-oss-120b`                        | 131K    |       |           |       |       |       | $0.49      | $0.71       |
+| `stackit/openai/gpt-oss-120b`                        | 131K    |       |           |       |       |       | $0.53      | $0.76       |
+| `stackit/openai/gpt-oss-20b`                         | 131K    |       |           |       |       |       | $0.18      | $0.29       |
 | `stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8`       | 218K    |       |           |       |       |       | $2         | $2          |
 | `stackit/Qwen/Qwen3-VL-Embedding-8B`                 | 32K     |       |           |       |       |       | $0.09      | $0.09       |
+| `stackit/Qwen/Qwen3.6-27B`                           | 262K    |       |           |       |       |       | $0.53      | $0.76       |
 
 ## Advanced configuration
 
@@ -73,7 +73,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "stackit/openai/gpt-oss-120b"
+      ? "stackit/openai/gpt-oss-20b"
       : "stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8";
   }
 });

package/.docs/models/providers.md

@@ -66,6 +66,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [LLM Gateway](https://mastra.ai/models/providers/llmgateway)
 - [LLMTR](https://mastra.ai/models/providers/llmtr)
 - [LMStudio](https://mastra.ai/models/providers/lmstudio)
+- [LongCat](https://mastra.ai/models/providers/longcat)
 - [LucidQuery](https://mastra.ai/models/providers/lucidquery)
 - [Meganova](https://mastra.ai/models/providers/meganova)
 - [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax)

package/.docs/reference/client-js/observability.md

@@ -2,7 +2,7 @@
 
 # Observability API
 
-The Observability API provides methods to retrieve traces, monitor your application's performance, and score traces for evaluation. This helps you understand how your AI agents and workflows are performing.
+The Observability API provides methods to retrieve traces, monitor application performance, score traces for evaluation, and record feedback linked to traces and spans.
 
 ## Getting a specific trace
 
@@ -68,7 +68,94 @@ const scores = await mastraClient.listScoresBySpan({
 })
 ```
 
+## Feedback
+
+Feedback methods create, list, and query human-in-the-loop signals such as ratings, thumbs, comments, and corrections. See the [feedback guide](https://mastra.ai/docs/observability/feedback) for examples and the [feedback reference](https://mastra.ai/reference/observability/feedback) for full schemas.
+
+### Creating feedback
+
+Create a feedback record linked to a trace or span:
+
+```typescript
+const response = await mastraClient.createFeedback({
+  feedback: {
+    traceId: 'trace-123',
+    spanId: 'span-456',
+    feedbackSource: 'user',
+    feedbackType: 'rating',
+    value: 1,
+    comment: 'Helpful answer.',
+  },
+})
+```
+
+### Listing feedback
+
+Retrieve paginated feedback records with optional filters:
+
+```typescript
+const feedback = await mastraClient.listFeedback({
+  filters: {
+    feedbackType: 'rating',
+    feedbackSource: 'studio',
+  },
+  pagination: { page: 0, perPage: 20 },
+  orderBy: { field: 'timestamp', direction: 'DESC' },
+})
+```
+
+### Aggregating feedback
+
+Aggregate numeric feedback values, such as ratings or thumbs encoded as `1` and `-1`:
+
+```typescript
+const averageRating = await mastraClient.getFeedbackAggregate({
+  feedbackType: 'rating',
+  aggregation: 'avg',
+  comparePeriod: 'previous_day',
+})
+```
+
+### Grouping feedback
+
+Group numeric feedback by observability dimensions:
+
+```typescript
+const ratingsByAgent = await mastraClient.getFeedbackBreakdown({
+  feedbackType: 'rating',
+  groupBy: ['entityName'],
+  aggregation: 'avg',
+})
+```
+
+### Querying feedback over time
+
+Bucket numeric feedback by interval:
+
+```typescript
+const ratingsOverTime = await mastraClient.getFeedbackTimeSeries({
+  feedbackType: 'rating',
+  interval: '1h',
+  aggregation: 'avg',
+  groupBy: ['feedbackSource'],
+})
+```
+
+### Querying feedback percentiles
+
+Return percentile series for numeric feedback values:
+
+```typescript
+const ratingPercentiles = await mastraClient.getFeedbackPercentiles({
+  feedbackType: 'rating',
+  percentiles: [0.5, 0.95],
+  interval: '1d',
+})
+```
+
 ## Related
 
+- [Feedback guide](https://mastra.ai/docs/observability/feedback): Learn how to create, list, and query feedback
+- [Feedback reference](https://mastra.ai/reference/observability/feedback): Review feedback schemas and HTTP routes
 - [Agents API](https://mastra.ai/reference/client-js/agents): Learn about agent interactions that generate traces
 - [Workflows API](https://mastra.ai/reference/client-js/workflows): Understand workflow execution monitoring

package/.docs/reference/index.md

@@ -185,6 +185,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [.getThreadById()](https://mastra.ai/reference/memory/getThreadById)
 - [.listThreads()](https://mastra.ai/reference/memory/listThreads)
 - [.recall()](https://mastra.ai/reference/memory/recall)
+- [Feedback](https://mastra.ai/reference/observability/feedback)
 - [PinoLogger](https://mastra.ai/reference/logging/pino-logger)
 - [Automatic Metrics](https://mastra.ai/reference/observability/metrics/automatic-metrics)
 - [Configuration](https://mastra.ai/reference/observability/tracing/configuration)

package/.docs/reference/observability/feedback.md

@@ -0,0 +1,391 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# Feedback
+
+**Added in:** `@mastra/core@1.18.0`
+
+Feedback APIs store and query human-in-the-loop observability signals such as ratings, thumbs, comments, and corrections. Use the [feedback guide](https://mastra.ai/docs/observability/feedback) for usage patterns.
+
+## Usage example
+
+The following example records a rating for a persisted trace through the observability entrypoint. `addFeedback()` is optional on the entrypoint, so check that the active observability implementation supports it before calling it.
+
+```typescript
+if (!mastra.observability.addFeedback) {
+  throw new Error('Feedback is not supported by the active observability implementation')
+}
+
+await mastra.observability.addFeedback({
+  traceId: 'trace-123',
+  spanId: 'span-456',
+  feedback: {
+    feedbackSource: 'user',
+    feedbackType: 'rating',
+    value: 1,
+    comment: 'Helpful answer.',
+  },
+})
+```
+
+## Create feedback
+
+### `addFeedback(args)`
+
+Adds feedback to a persisted trace or span through the observability entrypoint.
+
+```typescript
+await mastra.observability.addFeedback?.({
+  traceId: 'trace-123',
+  spanId: 'span-456',
+  feedback: {
+    feedbackSource: 'user',
+    feedbackType: 'rating',
+    value: 1,
+    comment: 'Helpful answer.',
+  },
+})
+```
+
+**traceId** (`string`): Trace that anchors the feedback target.
+
+**spanId** (`string`): Span that anchors the feedback target.
+
+**correlationContext** (`CorrelationContext`): Live span or trace context to emit from without rehydrating the target from storage.
+
+**feedback** (`FeedbackInput`): Feedback payload to add.
+
+### `createFeedback(args)`
+
+Creates one feedback record through the observability storage domain. Storage-level calls write directly to the store, so include `timestamp`.
+
+```typescript
+await observability.createFeedback({
+  feedback: {
+    feedbackId: 'feedback-1',
+    timestamp: new Date(),
+    traceId: 'trace-123',
+    spanId: 'span-456',
+    feedbackSource: 'user',
+    feedbackType: 'rating',
+    value: 1,
+    comment: 'Helpful answer.',
+  },
+})
+```
+
+The HTTP and client SDK create route accepts `CreateFeedbackBody`, sets `timestamp` server-side, and generates `feedbackId` when omitted:
+
+```typescript
+await mastraClient.createFeedback({
+  feedback: {
+    traceId: 'trace-123',
+    spanId: 'span-456',
+    feedbackSource: 'user',
+    feedbackType: 'rating',
+    value: 1,
+  },
+})
+```
+
+### `batchCreateFeedback(args)`
+
+Creates multiple feedback records through the observability storage domain. This method isn't exposed by the HTTP routes or `@mastra/client-js`.
+
+```typescript
+await observability.batchCreateFeedback({
+  feedbacks: [
+    {
+      feedbackId: 'feedback-1',
+      timestamp: new Date(),
+      traceId: 'trace-123',
+      feedbackSource: 'user',
+      feedbackType: 'rating',
+      value: 1,
+    },
+    {
+      feedbackId: 'feedback-2',
+      timestamp: new Date(),
+      traceId: 'trace-123',
+      feedbackSource: 'qa',
+      feedbackType: 'comment',
+      value: 'Needs a citation before shipping.',
+    },
+  ],
+})
+```
+
+## List feedback
+
+### `listFeedback(args?)`
+
+Returns feedback records in page mode or delta mode.
+
+```typescript
+const response = await mastraClient.listFeedback({
+  filters: {
+    feedbackType: 'rating',
+    feedbackSource: 'studio',
+  },
+  pagination: { page: 0, perPage: 20 },
+  orderBy: { field: 'timestamp', direction: 'DESC' },
+})
+```
+
+**mode** (`'page' | 'delta'`): List mode. Defaults to 'page'.
+
+**filters** (`FeedbackFilter`): Filters for the feedback records.
+
+**pagination** (`{ page?: number; perPage?: number }`): Page-mode pagination. page is zero-indexed.
+
+**orderBy** (`{ field?: 'timestamp'; direction?: 'ASC' | 'DESC' }`): Page-mode sort configuration.
+
+**after** (`string`): Delta cursor for incremental polling. Only valid in delta mode.
+
+**limit** (`number`): Maximum number of updates to return in delta mode.
+
+## OLAP queries
+
+OLAP feedback queries operate on numeric `value` fields.
+
+### `getFeedbackAggregate(args)`
+
+Returns one aggregate feedback value.
+
+```typescript
+const response = await mastraClient.getFeedbackAggregate({
+  feedbackType: 'rating',
+  feedbackSource: 'user',
+  aggregation: 'avg',
+  comparePeriod: 'previous_day',
+})
+```
+
+**feedbackType** (`string`): Feedback type to aggregate.
+
+**feedbackSource** (`string`): Feedback source to aggregate.
+
+**aggregation** (`'sum' | 'avg' | 'min' | 'max' | 'count' | 'count_distinct' | 'last'`): Aggregation to apply.
+
+**filters** (`FeedbackFilter`): Additional filters.
+
+**comparePeriod** (`'previous_period' | 'previous_day' | 'previous_week'`): Optional period-over-period comparison.
+
+### `getFeedbackBreakdown(args)`
+
+Returns feedback values grouped by dimensions.
+
+```typescript
+const response = await mastraClient.getFeedbackBreakdown({
+  feedbackType: 'rating',
+  groupBy: ['entityName'],
+  aggregation: 'avg',
+})
+```
+
+### `getFeedbackTimeSeries(args)`
+
+Returns feedback values bucketed by interval.
+
+```typescript
+const response = await mastraClient.getFeedbackTimeSeries({
+  feedbackType: 'rating',
+  interval: '1h',
+  aggregation: 'avg',
+  groupBy: ['feedbackSource'],
+})
+```
+
+### `getFeedbackPercentiles(args)`
+
+Returns percentile values bucketed by interval.
+
+```typescript
+const response = await mastraClient.getFeedbackPercentiles({
+  feedbackType: 'rating',
+  percentiles: [0.5, 0.95],
+  interval: '1d',
+})
+```
+
+## Types
+
+### `FeedbackRecord`
+
+**feedbackId** (`string | null`): Unique ID for this feedback event. The server route generates one when omitted.
+
+**timestamp** (`Date`): Time when the feedback was recorded.
+
+**traceId** (`string | null`): Trace that anchors the feedback target when available.
+
+**spanId** (`string | null`): Span that anchors the feedback target when available.
+
+**feedbackSource** (`string | null`): Optional source metadata, such as 'user', 'qa', 'studio', or 'system'.
+
+**source** (`string | null`): Deprecated alias for feedbackSource.
+
+**feedbackType** (`string`): Type of feedback, such as 'rating', 'thumbs', 'comment', or 'correction'.
+
+**value** (`number | string`): Feedback value. Numeric values support aggregate, breakdown, time series, and percentile queries.
+
+**comment** (`string | null`): Additional comment or context for the feedback.
+
+**feedbackUserId** (`string | null`): User who provided the feedback.
+
+**sourceId** (`string | null`): ID of the source record this feedback is linked to, such as an experiment result ID.
+
+**metadata** (`Record<string, unknown> | null`): User-defined metadata for the feedback record.
+
+### Shared context fields
+
+Feedback records can include shared observability context fields for filtering, grouping, and correlation with traces, logs, metrics, and scores.
+
+**entityType** (`EntityType | null`): Entity type that produced the signal.
+
+**entityId** (`string | null`): ID of the entity that produced the signal.
+
+**entityName** (`string | null`): Name of the entity that produced the signal.
+
+**parentEntityType** (`EntityType | null`): Entity type of the parent entity.
+
+**parentEntityId** (`string | null`): ID of the parent entity.
+
+**parentEntityName** (`string | null`): Name of the parent entity.
+
+**rootEntityType** (`EntityType | null`): Entity type of the root entity.
+
+**rootEntityId** (`string | null`): ID of the root entity.
+
+**rootEntityName** (`string | null`): Name of the root entity.
+
+**userId** (`string | null`): Human end user who triggered execution.
+
+**organizationId** (`string | null`): Multi-tenant organization or account.
+
+**resourceId** (`string | null`): Broader resource context.
+
+**runId** (`string | null`): Execution run identifier.
+
+**sessionId** (`string | null`): Session identifier for grouping traces.
+
+**threadId** (`string | null`): Conversation thread identifier.
+
+**requestId** (`string | null`): HTTP request ID for correlation.
+
+**environment** (`string | null`): Deployment environment.
+
+**serviceName** (`string | null`): Name of the service.
+
+**scope** (`Record<string, unknown> | null`): Package, app version, or deployment metadata.
+
+**entityVersionId** (`string | null`): Version ID of the entity that produced the signal.
+
+**parentEntityVersionId** (`string | null`): Version ID of the parent entity.
+
+**rootEntityVersionId** (`string | null`): Version ID of the root entity.
+
+**experimentId** (`string | null`): Experiment or eval run identifier.
+
+**executionSource** (`string | null`): Source of execution, such as local, cloud, or CI.
+
+**tags** (`string[] | null`): Labels for filtering.
+
+### `FeedbackInput`
+
+Use `FeedbackInput` with `mastra.observability.addFeedback()`, `recordedTrace.addFeedback()`, and `recordedSpan.addFeedback()`.
+
+**feedbackSource** (`string`): Optional source metadata for the feedback.
+
+**source** (`string`): Deprecated alias for feedbackSource.
+
+**feedbackType** (`string`): Type of feedback to record.
+
+**value** (`number | string`): Feedback value to record.
+
+**comment** (`string`): Additional comment or context.
+
+**feedbackUserId** (`string`): User who provided the feedback.
+
+**userId** (`string`): Deprecated alias for feedbackUserId.
+
+**metadata** (`Record<string, unknown>`): Additional feedback-specific metadata.
+
+**experimentId** (`string`): Experiment or eval run identifier.
+
+**sourceId** (`string`): ID of the source record this feedback is linked to.
+
+### `FeedbackFilter`
+
+Use `FeedbackFilter` in `listFeedback()` and OLAP query `filters`.
+
+**timestamp** (`{ start?: Date; end?: Date; startExclusive?: boolean; endExclusive?: boolean }`): Filter by timestamp range.
+
+**traceId** (`string`): Filter by trace ID.
+
+**spanId** (`string`): Filter by span ID.
+
+**feedbackType** (`string | string[]`): Filter by one or more feedback types.
+
+**feedbackSource** (`string`): Filter by feedback source.
+
+**source** (`string`): Deprecated alias for feedbackSource.
+
+**feedbackUserId** (`string`): Filter by the user who provided the feedback.
+
+**entityType** (`EntityType`): Filter by entity type.
+
+**entityName** (`string`): Filter by entity name.
+
+**entityVersionId** (`string`): Filter by entity version ID.
+
+**parentEntityType** (`EntityType`): Filter by parent entity type.
+
+**parentEntityName** (`string`): Filter by parent entity name.
+
+**parentEntityVersionId** (`string`): Filter by parent entity version ID.
+
+**rootEntityType** (`EntityType`): Filter by root entity type.
+
+**rootEntityName** (`string`): Filter by root entity name.
+
+**rootEntityVersionId** (`string`): Filter by root entity version ID.
+
+**userId** (`string`): Filter by human end-user ID.
+
+**organizationId** (`string`): Filter by organization ID.
+
+**resourceId** (`string`): Filter by resource ID.
+
+**runId** (`string`): Filter by run ID.
+
+**sessionId** (`string`): Filter by session ID.
+
+**threadId** (`string`): Filter by thread ID.
+
+**requestId** (`string`): Filter by request ID.
+
+**serviceName** (`string`): Filter by service name.
+
+**environment** (`string`): Filter by environment.
+
+**executionSource** (`string`): Filter by execution source.
+
+**experimentId** (`string`): Filter by experiment or eval run identifier.
+
+**tags** (`string[]`): Filter by tags. Matching records must have all specified tags.
+
+## HTTP routes
+
+| Method | Path                                      | Purpose                      | Permission           |
+| ------ | ----------------------------------------- | ---------------------------- | -------------------- |
+| `GET`  | `/api/observability/feedback`             | List feedback records        | None derived         |
+| `POST` | `/api/observability/feedback`             | Create a feedback record     | None derived         |
+| `POST` | `/api/observability/feedback/aggregate`   | Return one aggregate value   | `observability:read` |
+| `POST` | `/api/observability/feedback/breakdown`   | Group feedback by dimensions | `observability:read` |
+| `POST` | `/api/observability/feedback/timeseries`  | Bucket feedback by interval  | `observability:read` |
+| `POST` | `/api/observability/feedback/percentiles` | Return percentile series     | `observability:read` |
+
+## Related
+
+- [Feedback guide](https://mastra.ai/docs/observability/feedback)
+- [Client SDK observability reference](https://mastra.ai/reference/client-js/observability)
+- [Observability configuration](https://mastra.ai/reference/observability/tracing/configuration)

package/.docs/reference/workflows/workflow.md

@@ -125,6 +125,8 @@ export const testWorkflow = createWorkflow({
 
 **options.shouldPersistSnapshot** (`(params: { stepResults: Record<string, StepResult<any, any, any, any>>; workflowStatus: WorkflowRunStatus }) => boolean`): Optional flag to determine whether to persist the workflow snapshot
 
+**options.pruneSnapshot** (`(params: { snapshot: WorkflowRunState; workflowStatus: WorkflowRunStatus }) => WorkflowRunState`): Optional hook to transform the workflow snapshot immediately before it is persisted. Must return JSON-serializable data and preserve everything the workflow needs to resume (suspended step suspendPayloads, suspendedPaths, executionPath, etc.). Used internally by agent runs to keep snapshots minimal; user workflows persist full snapshots by default.
+
 **options.onFinish** (`(result: WorkflowFinishCallbackResult) => void | Promise<void>`): Callback invoked when workflow completes with any status (success, failed, suspended, tripwire). Receives the workflow result including status, output, error, and step results. Errors thrown in this callback are caught and logged, not propagated.
 
 **options.onFinish.status** (`WorkflowRunStatus`): The workflow status: 'success', 'failed', 'suspended', or 'tripwire'