@mastra/client-js 1.0.0-beta.13 → 1.0.0-beta.15

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: {}
     });
   }
   /**
@@ -2706,7 +2742,8 @@ var Run = class extends BaseResource {
         inputData: params?.inputData,
         initialState: params?.initialState,
         requestContext,
-        tracingOptions: params.tracingOptions
+        tracingOptions: params.tracingOptions,
+        perStep: params.perStep
       }
     });
   }
@@ -2719,6 +2756,7 @@ var Run = class extends BaseResource {
     step,
     resumeData,
     tracingOptions,
+    perStep,
     ...rest
   }) {
     const requestContext = parseClientRequestContext(rest.requestContext);
@@ -2728,7 +2766,8 @@ var Run = class extends BaseResource {
         step,
         resumeData,
         requestContext,
-        tracingOptions
+        tracingOptions,
+        perStep
       }
     });
   }
@@ -2748,7 +2787,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 +2810,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 +2865,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 +2914,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 +2936,8 @@ var Run = class extends BaseResource {
           step: params.step,
           resumeData: params.resumeData,
           requestContext,
-          tracingOptions: params.tracingOptions
+          tracingOptions: params.tracingOptions,
+          perStep: params.perStep
         },
         stream: true
       }
@@ -3077,13 +3121,26 @@ var Workflow = class extends BaseResource {
   /**
    * Retrieves the execution result for a specific workflow run by its ID
    * @param runId - The ID of the workflow run to retrieve the execution result for
-   * @param requestContext - Optional request context to pass as query parameter
+   * @param options - Optional configuration
+   * @param options.requestContext - Optional request context to pass as query parameter
+   * @param options.fields - Optional array of fields to return (e.g., ['status', 'result']). Available fields: status, result, error, payload, steps, activeStepsPath, serializedStepGraph. Omitting this returns all fields.
+   * @param options.withNestedWorkflows - Whether to include nested workflow data in steps. Defaults to true. Set to false for better performance when you don't need nested workflow details.
    * @returns Promise containing the workflow run execution result
    */
-  runExecutionResult(runId, requestContext) {
-    return this.request(
-      `/api/workflows/${this.workflowId}/runs/${runId}/execution-result${requestContextQueryString(requestContext)}`
-    );
+  runExecutionResult(runId, options) {
+    const searchParams = new URLSearchParams();
+    if (options?.fields && options.fields.length > 0) {
+      searchParams.set("fields", options.fields.join(","));
+    }
+    if (options?.withNestedWorkflows !== void 0) {
+      searchParams.set("withNestedWorkflows", String(options.withNestedWorkflows));
+    }
+    const requestContextParam = base64RequestContext(parseClientRequestContext(options?.requestContext));
+    if (requestContextParam) {
+      searchParams.set("requestContext", requestContextParam);
+    }
+    const queryString = searchParams.size > 0 ? `?${searchParams.toString()}` : "";
+    return this.request(`/api/workflows/${this.workflowId}/runs/${runId}/execution-result${queryString}`);
   }
   /**
    * Creates a new workflow run
@@ -3659,9 +3716,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;
@@ -3694,25 +3754,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",
@@ -4262,9 +4331,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);
   }
@@ -4317,6 +4404,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