@mastra/client-js 1.54.1-alpha.2 → 1.54.1-alpha.3

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-client-js
 description: Documentation for @mastra/client-js. Use when working with @mastra/client-js APIs, configuration, or implementation.
 metadata:
   package: "@mastra/client-js"
-  version: "1.54.1-alpha.2"
+  version: "1.54.1-alpha.3"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.54.1-alpha.2",
+  "version": "1.54.1-alpha.3",
   "package": "@mastra/client-js",
   "exports": {},
   "modules": {}

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

@@ -45,7 +45,7 @@ const completeTrace = await mastraClient.getTrace(traces.spans[0].traceId)
 
 ## Listing traces for a list view
 
-`listTracesLight()` returns the same rows as a trace list, without the `input`, `output` and `attributes` payloads. Each row carries a short `inputPreview` string instead, so a list can render a preview column without transferring the whole prompt, plus `threadId` and `resourceId` for the memory context columns.
+`listTracesLight()` returns the same rows as a trace list, without the `input`, `output` and `attributes` payloads. Each row carries short `inputPreview`, `outputPreview` and `errorPreview` strings instead (at most 100 characters, ending with `…` when cut), so a list can render preview columns without transferring the whole payload, plus `threadId` and `resourceId` for the memory context columns.
 
 Prefer it whenever you are rendering many traces at once, and fetch the full record only when a row is opened:
 
@@ -67,7 +67,7 @@ It accepts the same filtering, ordering and delta-polling arguments as `listTrac
 
 ## Querying traces
 
-`queryTraces()` finds completed logical traces using trace fields and conditions over related spans. Every query requires an ISO timestamp range of at most 31 days.
+`queryTraces()` finds completed logical traces using trace fields and conditions over related spans. Every query requires an ISO timestamp range.
 
 ```typescript
 const result = await mastraClient.queryTraces({

package/dist/docs/references/reference-observability-tracing-trace-query.md

@@ -8,7 +8,7 @@ Use `queryTraces()`, `mastra api trace query`, or `POST /api/observability/trace
 
 For example, find traces with a failed tool call or a duration above a threshold. Each result represents a trace. Use its `traceId` to [retrieve the full trace](https://mastra.ai/reference/client-js/observability).
 
-The endpoint uses the same authentication as other observability routes and requires the `observability:read` permission. The configured observability store must support trace queries. Every query requires a time range of at most 31 days.
+The endpoint uses the same authentication as other observability routes and requires the `observability:read` permission. The configured observability store must support trace queries. Every query requires a time range.
 
 For hosted traces, see [Query observability data on Mastra Platform](https://mastra.ai/docs/mastra-platform/observability) for project credentials and regional endpoints.
 
@@ -74,14 +74,19 @@ mastra api --url http://localhost:4111 trace query '{
 
 The explicit `--url` targets a local Mastra server. Without it, observability commands default to `https://observability.mastra.ai`, even when a local server is running. See [CLI target resolution](https://mastra.ai/reference/cli/mastra) for authentication and regional endpoints. The target server and configured store must support the requested query capabilities.
 
-Inspect the command and the target server's request and response schemas with:
+Inspect the command with:
 
 ```bash
 mastra api trace query --help
+```
+
+For a local Mastra server, inspect its request and response schemas with:
+
+```bash
 mastra api --url http://localhost:4111 trace query --schema
 ```
 
-`--schema` describes the request structure. Use [Fields and operators](#fields-and-operators) for the supported predicate paths and operators.
+Mastra Platform doesn't currently expose the schema endpoint used by `--schema`. Use [Request fields](#request-fields) and [Fields and operators](#fields-and-operators) to construct queries for either target. To find fields and values recorded in your project, use [field and value discovery](#discover-fields-and-values).
 
 ## Send an HTTP request
 
@@ -115,16 +120,16 @@ curl --request POST \
 
 ## Request fields
 
-| Field        | Required | Description                                                                                                                                                                     |
-| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `timeRange`  | Yes      | Trace start-time boundary. `from` is inclusive and `to` is exclusive. Both values must be ISO timestamps, `from` must be earlier than `to`, and the range can't exceed 31 days. |
-| `where`      | No       | Recursive trace predicate. Supports scalar conditions and `spans.some` or `spans.none` clauses.                                                                                 |
-| `orderBy`    | No       | One item ordering results by `startedAt` or `endedAt`, in `asc` or `desc` order. Defaults to `startedAt desc`. Not accepted in delta mode.                                      |
-| `page`       | No       | `{ limit, after }`. `limit` defaults to 100 and has a maximum of 1000. Pass the opaque `page.next` value as `after`.                                                            |
-| `pagination` | No       | Numbered pages: `{ page, perPage }`. Defaults to page 0 and 10 results. `perPage` has a maximum of 100.                                                                         |
-| `mode`       | No       | Set to `'delta'` to poll using a delta cursor instead of `page` or `pagination`.                                                                                                |
-| `after`      | No       | Delta mode only. Opaque `deltaCursor` from a numbered page or previous poll. Omit to establish the current watermark.                                                           |
-| `limit`      | No       | Delta mode only. Maximum results per batch. Defaults to 10 and has a maximum of 100.                                                                                            |
+| Field        | Required | Description                                                                                                                                     |
+| ------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `timeRange`  | Yes      | Trace start-time boundary. `from` is inclusive and `to` is exclusive. Both values must be ISO timestamps, and `from` must be earlier than `to`. |
+| `where`      | No       | Recursive trace predicate. Supports scalar conditions and `spans.some` or `spans.none` clauses.                                                 |
+| `orderBy`    | No       | One item ordering results by `startedAt` or `endedAt`, in `asc` or `desc` order. Defaults to `startedAt desc`. Not accepted in delta mode.      |
+| `page`       | No       | `{ limit, after }`. `limit` defaults to 100 and has a maximum of 1000. Pass the opaque `page.next` value as `after`.                            |
+| `pagination` | No       | Numbered pages: `{ page, perPage }`. Defaults to page 0 and 10 results. `perPage` has a maximum of 100.                                         |
+| `mode`       | No       | Set to `'delta'` to poll using a delta cursor instead of `page` or `pagination`.                                                                |
+| `after`      | No       | Delta mode only. Opaque `deltaCursor` from a numbered page or previous poll. Omit to establish the current watermark.                           |
+| `limit`      | No       | Delta mode only. Maximum results per batch. Defaults to 10 and has a maximum of 100.                                                            |
 
 Unknown fields are rejected. Requests can't select a projection, declare joins, request counts or measures, or control authorization. Request bodies are limited to 256 KiB.
 
@@ -134,7 +139,6 @@ The planner rejects a query before storage execution when it exceeds any of thes
 
 | Input                                     | Maximum           |
 | ----------------------------------------- | ----------------- |
-| Trace selection `timeRange`               | 31 days           |
 | Predicate nesting depth                   | 12 levels         |
 | Predicate nodes                           | 100               |
 | Related `spans` clauses                   | 8 total           |
@@ -594,7 +598,7 @@ Value suggestions are available for these canonical fields:
 
 Each executable top-level string `metadata.<key>` field also supports value suggestions in the `trace` scope. Identifiers, timestamps, durations, errors, and version IDs don't. The fields response still includes canonical fields with `valueSuggestions: false`. The values endpoint rejects those paths with `422 TRACE_QUERY_INVALID`.
 
-Both discovery requests require a half-open time range of at most 31 days. They use the same current-record semantics as `queryTraces()`: qualifying completed roots satisfy `from <= startedAt < to`, and related values come only from current records joined to those roots by `traceId`. Discovery doesn't accept or apply a draft `where` predicate.
+Both discovery requests require a half-open time range. They use the same current-record semantics as `queryTraces()`: qualifying completed roots satisfy `from <= startedAt < to`, and related values come only from current records joined to those roots by `traceId`. Discovery doesn't accept or apply a draft `where` predicate.
 
 `search` defaults to the empty string, is trimmed, and matches case-insensitive literal substrings. Characters such as `%` and `_` have no wildcard meaning. An empty search returns the most frequent results. `limit` defaults to 25 and has a maximum of 100. Both endpoints fetch one extra result to set their truncation flag, but don't provide a cursor. When a flag is `true`, refine `search`. It doesn't imply that a next page is available. No matches return an empty array and `false` truncation.
 

package/dist/route-types.generated.d.ts

@@ -2548,6 +2548,12 @@ type Shared_Type_61 = {
     requestContext?: ({
         [key: string]: unknown;
     } | null) | undefined;
+    /** Short text preview of the span input */
+    inputPreview?: (string | null) | undefined;
+    /** Short text preview of the span output */
+    outputPreview?: (string | null) | undefined;
+    /** Short text preview of the span error */
+    errorPreview?: (string | null) | undefined;
     /** Database record creation time */
     createdAt: Date;
     /** Database record last update time */
@@ -2581,6 +2587,8 @@ type Shared_Type_62 = {
         [key: string]: unknown;
     } | null) | undefined;
     inputPreview?: (string | null) | undefined;
+    outputPreview?: (string | null) | undefined;
+    errorPreview?: (string | null) | undefined;
     /** Database record creation time */
     createdAt: Date;
     /** Database record last update time */
@@ -2643,6 +2651,12 @@ type Shared_Type_63 = {
     requestContext?: ({
         [key: string]: unknown;
     } | null) | undefined;
+    /** Short text preview of the span input */
+    inputPreview?: (string | null) | undefined;
+    /** Short text preview of the span output */
+    outputPreview?: (string | null) | undefined;
+    /** Short text preview of the span error */
+    errorPreview?: (string | null) | undefined;
     /** Database record creation time */
     createdAt: Date;
     /** Database record last update time */
@@ -2659,6 +2673,8 @@ type Shared_Type_64 = {
         [key: string]: unknown;
     } | null;
     inputPreview: string | null;
+    outputPreview: string | null;
+    errorPreview: string | null;
     threadId: string | null;
     resourceId: string | null;
     startedAt: string;
@@ -8184,6 +8200,8 @@ export type PostObservabilitySpansQuery_Response = {
         inputTruncated: boolean;
         outputPreview: string | null;
         outputTruncated: boolean;
+        errorPreview: string | null;
+        errorTruncated: boolean;
         cost: {
             state: 'available';
             amount: number;