@mastra/client-js 1.0.0-beta.14 → 1.0.0-beta.16

package/dist/index.js

@@ -1061,6 +1061,41 @@ async function processDataStream({
     }
   }
 }
+function isComplexValue(value) {
+  if (value === null || value === void 0) return false;
+  if (value instanceof Date) return false;
+  return typeof value === "object";
+}
+function serializeQueryValue(value) {
+  if (value instanceof Date) {
+    return value.toISOString();
+  }
+  if (isComplexValue(value)) {
+    return JSON.stringify(value, (_key, val) => {
+      if (val instanceof Date) {
+        return val.toISOString();
+      }
+      return val;
+    });
+  }
+  return String(value);
+}
+function toQueryParams(params, flattenKeys = []) {
+  const searchParams = new URLSearchParams();
+  const keysToFlatten = flattenKeys;
+  function addParams(obj) {
+    for (const [key, value] of Object.entries(obj)) {
+      if (value === void 0 || value === null) continue;
+      if (keysToFlatten.includes(key) && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date)) {
+        addParams(value);
+      } else {
+        searchParams.set(key, serializeQueryValue(value));
+      }
+    }
+  }
+  addParams(params);
+  return searchParams.toString();
+}
 function parseClientRequestContext(requestContext) {
   if (requestContext) {
     if (requestContext instanceof RequestContext) {
@@ -2424,7 +2459,8 @@ var Agent = class extends BaseResource {
    */
   resetModel() {
     return this.request(`/api/agents/${this.agentId}/model/reset`, {
-      method: "POST"
+      method: "POST",
+      body: {}
     });
   }
   /**
@@ -2687,12 +2723,79 @@ var Run = class extends BaseResource {
   /**
    * Cancels a specific workflow run by its ID
    * @returns Promise containing a success message
+   * @deprecated Use `cancel()` instead
    */
   cancelRun() {
     return this.request(`/api/workflows/${this.workflowId}/runs/${this.runId}/cancel`, {
       method: "POST"
     });
   }
+  /**
+   * Cancels a workflow run.
+   *
+   * This method aborts any running steps and updates the workflow status to 'canceled' .
+   * It works for both actively running workflows and suspended/waiting workflows.
+   *
+   * ## How cancellation works
+   *
+   * When called, the workflow will:
+   * 1. **Trigger the abort signal** - Uses the standard Web API AbortSignal to notify running steps
+   * 2. **Prevent subsequent steps** - No further steps will be executed
+   *
+   * ## Abort signal behavior
+   *
+   * Steps that check the `abortSignal` parameter can respond to cancellation:
+   * - Steps can listen to the 'abort' event: `abortSignal.addEventListener('abort', callback)`
+   * - Steps can check if already aborted: `if (abortSignal.aborted) { ... }`
+   * - Useful for canceling timeouts, network requests, or long-running operations
+   *
+   * **Note:** Steps must actively check the abort signal to be canceled mid-execution.
+   * Steps that don't check the signal will run to completion, but subsequent steps won't execute.
+   *
+   * @returns Promise that resolves with `{ message: 'Workflow run canceled' }` when cancellation succeeds
+   * @throws {HTTPException} 400 - If workflow ID or run ID is missing
+   * @throws {HTTPException} 404 - If workflow or workflow run is not found
+   *
+   * @example
+   * ```typescript
+   * const run = await workflow.createRun({ runId: 'run-123' });
+   * await run.cancel();
+   * // Returns: { message: 'Workflow run canceled' }
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // Example of a step that responds to cancellation
+   * const step = createStep({
+   *   id: 'long-running-step',
+   *   execute: async ({ inputData, abortSignal, abort }) => {
+   *     const timeout = new Promise((resolve) => {
+   *       const timer = setTimeout(() => resolve('done'), 10000);
+   *
+   *       // Clean up if canceled
+   *       abortSignal.addEventListener('abort', () => {
+   *         clearTimeout(timer);
+   *         resolve('canceled');
+   *       });
+   *     });
+   *
+   *     const result = await timeout;
+   *
+   *     // Check if aborted after async operation
+   *     if (abortSignal.aborted) {
+   *       return abort(); // Stop execution
+   *     }
+   *
+   *     return { result };
+   *   }
+   * });
+   * ```
+   */
+  cancel() {
+    return this.request(`/api/workflows/${this.workflowId}/runs/${this.runId}/cancel`, {
+      method: "POST"
+    });
+  }
   /**
    * Starts a workflow run synchronously without waiting for the workflow to complete
    * @param params - Object containing the inputData, initialState and requestContext
@@ -2706,7 +2809,8 @@ var Run = class extends BaseResource {
         inputData: params?.inputData,
         initialState: params?.initialState,
         requestContext,
-        tracingOptions: params.tracingOptions
+        tracingOptions: params.tracingOptions,
+        perStep: params.perStep
       }
     });
   }
@@ -2719,6 +2823,7 @@ var Run = class extends BaseResource {
     step,
     resumeData,
     tracingOptions,
+    perStep,
     ...rest
   }) {
     const requestContext = parseClientRequestContext(rest.requestContext);
@@ -2728,7 +2833,8 @@ var Run = class extends BaseResource {
         step,
         resumeData,
         requestContext,
-        tracingOptions
+        tracingOptions,
+        perStep
       }
     });
   }
@@ -2748,7 +2854,8 @@ var Run = class extends BaseResource {
         initialState: params.initialState,
         requestContext,
         tracingOptions: params.tracingOptions,
-        resourceId: params.resourceId
+        resourceId: params.resourceId,
+        perStep: params.perStep
       }
     }).then(deserializeWorkflowError);
   }
@@ -2770,7 +2877,8 @@ var Run = class extends BaseResource {
           initialState: params.initialState,
           requestContext,
           tracingOptions: params.tracingOptions,
-          resourceId: params.resourceId
+          resourceId: params.resourceId,
+          perStep: params.perStep
         },
         stream: true
       }
@@ -2824,7 +2932,8 @@ var Run = class extends BaseResource {
           requestContext,
           closeOnSuspend: params.closeOnSuspend,
           tracingOptions: params.tracingOptions,
-          resourceId: params.resourceId
+          resourceId: params.resourceId,
+          perStep: params.perStep
         },
         stream: true
       }
@@ -2872,7 +2981,8 @@ var Run = class extends BaseResource {
         step: params.step,
         resumeData: params.resumeData,
         requestContext,
-        tracingOptions: params.tracingOptions
+        tracingOptions: params.tracingOptions,
+        perStep: params.perStep
       }
     }).then(deserializeWorkflowError);
   }
@@ -2893,7 +3003,8 @@ var Run = class extends BaseResource {
           step: params.step,
           resumeData: params.resumeData,
           requestContext,
-          tracingOptions: params.tracingOptions
+          tracingOptions: params.tracingOptions,
+          perStep: params.perStep
         },
         stream: true
       }
@@ -3672,9 +3783,12 @@ var Observability = class extends BaseResource {
     return this.request(`/api/observability/traces/${traceId}`);
   }
   /**
-   * Retrieves paginated list of traces with optional filtering
-   * @param params - Parameters for pagination and filtering
+   * Retrieves paginated list of traces with optional filtering.
+   * This is the legacy API preserved for backward compatibility.
+   *
+   * @param params - Parameters for pagination and filtering (legacy format)
    * @returns Promise containing paginated traces and pagination info
+   * @deprecated Use {@link listTraces} instead for new features like ordering and more filters.
    */
   getTraces(params) {
     const { pagination, filters } = params;
@@ -3707,25 +3821,34 @@ var Observability = class extends BaseResource {
     const queryString = searchParams.toString();
     return this.request(`/api/observability/traces${queryString ? `?${queryString}` : ""}`);
   }
+  /**
+   * Retrieves paginated list of traces with optional filtering and sorting.
+   * This is the new API with improved filtering options.
+   *
+   * @param params - Parameters for pagination, filtering, and ordering
+   * @returns Promise containing paginated traces and pagination info
+   */
+  listTraces(params = {}) {
+    const queryString = toQueryParams(params, ["filters", "pagination", "orderBy"]);
+    return this.request(`/api/observability/traces${queryString ? `?${queryString}` : ""}`);
+  }
   /**
    * Retrieves scores by trace ID and span ID
    * @param params - Parameters containing trace ID, span ID, and pagination options
    * @returns Promise containing scores and pagination info
    */
   listScoresBySpan(params) {
-    const { traceId, spanId, page, perPage } = params;
-    const searchParams = new URLSearchParams();
-    if (page !== void 0) {
-      searchParams.set("page", String(page));
-    }
-    if (perPage !== void 0) {
-      searchParams.set("perPage", String(perPage));
-    }
-    const queryString = searchParams.toString();
+    const { traceId, spanId, ...pagination } = params;
+    const queryString = toQueryParams(pagination);
     return this.request(
       `/api/observability/traces/${encodeURIComponent(traceId)}/${encodeURIComponent(spanId)}/scores${queryString ? `?${queryString}` : ""}`
     );
   }
+  /**
+   * Scores one or more traces using a specified scorer.
+   * @param params - Scorer name and targets to score
+   * @returns Promise containing the scoring status
+   */
   score(params) {
     return this.request(`/api/observability/traces/score`, {
       method: "POST",
@@ -4275,9 +4398,27 @@ var MastraClient = class extends BaseResource {
   getTrace(traceId) {
     return this.observability.getTrace(traceId);
   }
+  /**
+   * Retrieves paginated list of traces with optional filtering.
+   * This is the legacy API preserved for backward compatibility.
+   *
+   * @param params - Parameters for pagination and filtering (legacy format)
+   * @returns Promise containing paginated traces and pagination info
+   * @deprecated Use {@link listTraces} instead for new features like ordering and more filters.
+   */
   getTraces(params) {
     return this.observability.getTraces(params);
   }
+  /**
+   * Retrieves paginated list of traces with optional filtering and sorting.
+   * This is the new API with improved filtering options.
+   *
+   * @param params - Parameters for pagination, filtering, and ordering
+   * @returns Promise containing paginated traces and pagination info
+   */
+  listTraces(params = {}) {
+    return this.observability.listTraces(params);
+  }
   listScoresBySpan(params) {
     return this.observability.listScoresBySpan(params);
   }
@@ -4330,6 +4471,16 @@ var MastraClient = class extends BaseResource {
   getStoredAgent(storedAgentId) {
     return new StoredAgent(this.options, storedAgentId);
   }
+  // ============================================================================
+  // System
+  // ============================================================================
+  /**
+   * Retrieves installed Mastra packages and their versions
+   * @returns Promise containing the list of installed Mastra packages
+   */
+  getSystemPackages() {
+    return this.request("/api/system/packages");
+  }
 };
 
 // src/tools.ts