@mastra/client-js 1.51.0-alpha.9 → 1.51.1-alpha.0

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.51.0-alpha.9"
+  version: "1.51.1-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.51.0-alpha.9",
+  "version": "1.51.1-alpha.0",
   "package": "@mastra/client-js",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-harness-schedules.md

@@ -196,6 +196,33 @@ Every hook context includes `agentId` (the agent the schedule fired for) alongsi
 
 Hook exceptions are caught and logged. They never re-route the worker or trigger another hook.
 
+## Recurring prompts in Mastra Code
+
+Mastra Code offers the `/schedules` command, which attaches a recurring prompt to the current conversation thread. Unlike `mastra.schedules`, these schedules live only in the Mastra Code process that created them: nothing is written to storage, and each fire is sent to the thread with `agent.sendSignal()` directly.
+
+Run `/schedules` to open a menu with **Create schedule** and one row per schedule on the current thread. Creating a schedule walks through these steps:
+
+1. Choose what each fire sends: a **Prompt**, a **Prompt file** that's re-read on every fire, or a **Script** that runs on every fire.
+2. Enter the prompt text or the file path. Paths resolve from the project root. For a script, you can add a prompt that's sent after the script output.
+3. Pick a cadence from `1m` to `1d`, or type one such as `20m` or `3h`. Minute steps must divide an hour and hour steps must divide a day.
+4. Confirm.
+
+Scripts run from the project root with a 60-second timeout, and their stdout, stderr, and exit code become the prompt. The extra prompt is never passed to the script.
+
+Selecting an existing schedule offers **Run now**, **Pause** or **Resume**, and **Delete**. **Run now** fires the schedule once without changing its cadence, works on paused schedules, and is skipped while a fire of the same schedule is still running.
+
+Each fire arrives on the thread as a `user`-type signal and shows in the transcript as a `schedule` entry with the schedule's id, cadence, source, and script exit status. If the thread is busy, the running agent receives the prompt as its next input, the same way a message you type mid-run does. If the thread is idle, it wakes and runs. Schedules fire on any thread in the process, not only the one focused in the terminal. After `/new`, a new schedule binds to the new thread.
+
+Things to know:
+
+- **Session scoped.** Schedules exist only in the Mastra Code process that created them and stop when it exits. Other Mastra Code processes sharing the same database never see or fire them.
+- **Clock boundaries.** `5m` fires at :00, :05, :10 and so on, not five minutes after creation, and `1d` fires at local midnight. Hour and day cadences follow wall-clock time across daylight saving changes, like cron. A fire missed while the machine slept, or one whose timer runs more than a minute late, is skipped, and the schedule resumes at the next boundary.
+- **Overlapping fires are skipped.** If a script is still running when the next boundary arrives, that fire doesn't run.
+
+### Agent schedule tools
+
+Turning on **Experimental schedule tools** in `/settings` (restart required) gives the agent tools that manage the same schedules: `schedule_create`, `schedule_list`, `schedule_update` (pause or delete), `schedule_resume`, and `schedule_run`. The tools only see and change schedules on the thread of the run that calls them. Because a schedule can run a script on every fire, `schedule_create`, `schedule_resume`, and `schedule_run` need the same approval as running a shell command unless YOLO mode is on. Schedules the agent creates are marked `created by agent` in the transcript.
+
 ## Related
 
 - [`mastra.schedules`](https://mastra.ai/reference/schedules/overview): API reference for creating and managing schedules.

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.
+`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.
 
 Prefer it whenever you are rendering many traces at once, and fetch the full record only when a row is opened:
 

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

@@ -96,12 +96,12 @@ type InputShared_Auxiliary_223 = {
     op: 'not';
     arg: InputShared_Auxiliary_223;
 };
-type InputShared_Auxiliary_251 = {
+type InputShared_Auxiliary_254 = {
     op: 'and' | 'or';
-    args: InputShared_Auxiliary_251[];
+    args: InputShared_Auxiliary_254[];
 } | {
     op: 'not';
-    arg: InputShared_Auxiliary_251;
+    arg: InputShared_Auxiliary_254;
 } | {
     traces: {
         some: InputShared_Auxiliary_204;
@@ -109,7 +109,7 @@ type InputShared_Auxiliary_251 = {
         none: InputShared_Auxiliary_204;
     };
 };
-type InputShared_Auxiliary_667 = {
+type InputShared_Auxiliary_670 = {
     op: 'eq' | 'ne' | 'lt' | 'lte' | 'gt' | 'gte';
     left: {
         path: string;
@@ -141,24 +141,24 @@ type InputShared_Auxiliary_667 = {
     };
 } | {
     op: 'and' | 'or';
-    args: InputShared_Auxiliary_667[];
+    args: InputShared_Auxiliary_670[];
 } | {
     op: 'not';
-    arg: InputShared_Auxiliary_667;
+    arg: InputShared_Auxiliary_670;
 };
-type InputShared_Auxiliary_741 = {
+type InputShared_Auxiliary_744 = {
     id?: string | undefined;
     name: string;
     type: 'file' | 'folder';
     content?: string | undefined;
-    children?: InputShared_Auxiliary_741[] | undefined;
+    children?: InputShared_Auxiliary_744[] | undefined;
 };
-type Shared_Auxiliary_750 = {
+type Shared_Auxiliary_752 = {
     id?: string | undefined;
     name: string;
     type: 'file' | 'folder';
     content?: string | undefined;
-    children?: Shared_Auxiliary_750[] | undefined;
+    children?: Shared_Auxiliary_752[] | undefined;
 };
 type InputShared_Type_0 = {
     thread: string | {
@@ -1280,7 +1280,7 @@ type InputShared_Type_86 = {
         [key: string]: unknown;
     } | undefined;
     steps: InputShared_Type_81[];
-    predicates: InputShared_Auxiliary_667[];
+    predicates: InputShared_Auxiliary_670[];
 };
 type InputShared_Type_87 = {
     type: 'loop';
@@ -1291,7 +1291,7 @@ type InputShared_Type_87 = {
     } | undefined;
     step: InputShared_Type_81;
     loopType: 'dowhile' | 'dountil';
-    predicate: InputShared_Auxiliary_667;
+    predicate: InputShared_Auxiliary_670;
 };
 type InputShared_Type_88 = InputShared_Type_78 | InputShared_Type_79 | InputShared_Type_80 | {
     type: 'workflow';
@@ -2501,6 +2501,8 @@ type Shared_Type_60 = {
     entityType?: (Shared_Type_58 | null) | undefined;
     entityId?: (string | null) | undefined;
     entityName?: (string | null) | undefined;
+    threadId?: ((string | null) | undefined) | null;
+    resourceId?: ((string | null) | undefined) | null;
     metadata?: ({
         [key: string]: unknown;
     } | null) | undefined;
@@ -3075,7 +3077,7 @@ type Shared_Type_81 = {
     /** List of asset file paths */
     assets?: string[] | undefined;
     /** Full file tree structure for the skill */
-    files?: Shared_Auxiliary_750[] | undefined;
+    files?: Shared_Auxiliary_752[] | undefined;
     /** Additional metadata for the skill */
     metadata?: {
         [key: string]: unknown;
@@ -5933,7 +5935,7 @@ export type GetProcessors_Response = {
         id: string;
         name?: string | undefined;
         description?: string | undefined;
-        phases: ('input' | 'inputStep' | 'outputStream' | 'outputResult' | 'outputStep' | 'toolResult')[];
+        phases: ('input' | 'inputStep' | 'outputStream' | 'outputResult' | 'outputStep' | 'toolResult' | 'llmRequest')[];
         agentIds: string[];
         configurations: {
             agentId: string;
@@ -5969,7 +5971,7 @@ export type GetProcessorsProcessorId_Response = {
     id: string;
     name?: string | undefined;
     description?: string | undefined;
-    phases: ('input' | 'inputStep' | 'outputStream' | 'outputResult' | 'outputStep' | 'toolResult')[];
+    phases: ('input' | 'inputStep' | 'outputStream' | 'outputResult' | 'outputStep' | 'toolResult' | 'llmRequest')[];
     configurations: {
         agentId: string;
         agentName: string;
@@ -5998,7 +6000,7 @@ export interface GetProcessorsProcessorId_RouteContract {
 }
 export type PostProcessorsProcessorIdExecute_PathParams = GetProcessorsProcessorId_PathParams;
 export type PostProcessorsProcessorIdExecute_Body = {
-    phase: 'input' | 'inputStep' | 'outputStream' | 'outputResult' | 'outputStep' | 'toolResult';
+    phase: 'input' | 'inputStep' | 'outputStream' | 'outputResult' | 'outputStep' | 'toolResult' | 'llmRequest';
     messages: {
         id: string;
         role: 'user' | 'assistant' | 'system' | 'tool' | 'signal';
@@ -7852,6 +7854,53 @@ export interface PostObservabilityTracesQuery_RouteContract {
     response: PostObservabilityTracesQuery_Response;
     responseType: 'json';
 }
+export type PostObservabilityTracesAggregate_Body = {
+    timeRange: {
+        from: string;
+        to: string;
+    };
+    where?: InputShared_Auxiliary_204 | undefined;
+    groupBy?: string[];
+    interval?: ('1m' | '5m' | '15m' | '1h' | '1d') | undefined;
+    measures: (('count' | 'duration.avg' | 'duration.min' | 'duration.max' | 'duration.p50' | 'duration.p90' | 'duration.p95' | 'duration.p99' | 'errorCount' | 'errorRate') | `countDistinct.${string}`)[];
+    having?: InputShared_Auxiliary_223 | undefined;
+    orderBy?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    limit?: number;
+};
+export type PostObservabilityTracesAggregate_Response = {
+    rows: {
+        dimensions?: {
+            [key: string]: string | null;
+        } | undefined;
+        bucket?: string | undefined;
+        measures: {
+            [K in ('count' | 'duration.avg' | 'duration.min' | 'duration.max' | 'duration.p50' | 'duration.p90' | 'duration.p95' | 'duration.p99' | 'errorCount' | 'errorRate') | `countDistinct.${string}`]?: number;
+        };
+    }[];
+    truncated: boolean;
+};
+export type PostObservabilityTracesAggregate_Request = Simplify<(never extends never ? {} : {
+    params: never;
+}) & (never extends never ? {} : {} extends never ? {
+    query?: never;
+} : {
+    query: never;
+}) & (PostObservabilityTracesAggregate_Body extends never ? {} : {} extends PostObservabilityTracesAggregate_Body ? {
+    body?: PostObservabilityTracesAggregate_Body;
+} : {
+    body: PostObservabilityTracesAggregate_Body;
+})>;
+export interface PostObservabilityTracesAggregate_RouteContract {
+    pathParams: never;
+    queryParams: never;
+    body: PostObservabilityTracesAggregate_Body;
+    request: PostObservabilityTracesAggregate_Request;
+    response: PostObservabilityTracesAggregate_Response;
+    responseType: 'json';
+}
 export type PostObservabilityThreadsQuery_Body = {
     traces: {
         timeRange: {
@@ -7860,7 +7909,7 @@ export type PostObservabilityThreadsQuery_Body = {
         };
         where?: InputShared_Auxiliary_204 | undefined;
     };
-    where?: InputShared_Auxiliary_251 | undefined;
+    where?: InputShared_Auxiliary_254 | undefined;
     page?: {
         limit?: number;
         after?: (string | null) | undefined;
@@ -14152,7 +14201,7 @@ export type PostStoredSkills_Body = {
     /** List of asset file paths */
     assets?: string[] | undefined;
     /** Full file tree structure for the skill */
-    files?: InputShared_Auxiliary_741[] | undefined;
+    files?: InputShared_Auxiliary_744[] | undefined;
     /** Additional metadata for the skill */
     metadata?: {
         [key: string]: unknown;
@@ -14202,7 +14251,7 @@ export type PatchStoredSkillsStoredSkillId_Body = {
     /** List of asset file paths */
     assets?: (string[] | undefined) | undefined;
     /** Full file tree structure for the skill */
-    files?: (InputShared_Auxiliary_741[] | undefined) | undefined;
+    files?: (InputShared_Auxiliary_744[] | undefined) | undefined;
     /** Additional metadata for the skill */
     metadata?: ({
         [key: string]: unknown;
@@ -18552,6 +18601,7 @@ export interface RouteTypes {
     'POST /observability/traces/score': PostObservabilityTracesScore_RouteContract;
     'GET /observability/traces/:traceId/:spanId/scores': GetObservabilityTracesTraceIdSpanIdScores_RouteContract;
     'POST /observability/traces/query': PostObservabilityTracesQuery_RouteContract;
+    'POST /observability/traces/aggregate': PostObservabilityTracesAggregate_RouteContract;
     'POST /observability/threads/query': PostObservabilityThreadsQuery_RouteContract;
     'POST /observability/traces/query/fields': PostObservabilityTracesQueryFields_RouteContract;
     'POST /observability/traces/query/values': PostObservabilityTracesQueryValues_RouteContract;
@@ -19509,6 +19559,9 @@ export interface Client {
     '/observability/traces/:traceId/trajectory': {
         GET: GetObservabilityTracesTraceIdTrajectory_RouteContract;
     };
+    '/observability/traces/aggregate': {
+        POST: PostObservabilityTracesAggregate_RouteContract;
+    };
     '/observability/traces/delete': {
         POST: PostObservabilityTracesDelete_RouteContract;
     };