@mastra/client-js 1.21.2-alpha.2 → 1.22.0-alpha.4

package/dist/index.cjs

@@ -3185,6 +3185,35 @@ var Run = class extends BaseResource {
       }
     }).then(deserializeWorkflowError);
   }
+  /**
+   * Resumes a suspended workflow step without waiting for the workflow to complete (fire-and-forget)
+   * and returns immediately with the runId. The workflow continues executing in the background.
+   *
+   * Use this when you want to dispatch a resume and return immediately (e.g. an HTTP handler that
+   * never needs the resolved result inline). For Inngest-backed workflows this also avoids the
+   * `getRunOutput()` polling race that `resumeAsync()` can hit.
+   *
+   * TODO(v2): in Mastra v2 this fire-and-forget behavior should become the behavior of
+   * `resumeAsync()` (to mirror `start`/`resume` fire-and-forget semantics), and this method
+   * should be removed. Kept as a separate method in v1 to avoid a breaking contract change.
+   *
+   * @param params - Object containing the step, resumeData and requestContext
+   * @returns Promise containing the runId of the resumed workflow run
+   */
+  resumeNoWait(params) {
+    const requestContext = parseClientRequestContext(params.requestContext);
+    return this.request(`/workflows/${this.workflowId}/resume-no-wait?runId=${this.runId}`, {
+      method: "POST",
+      body: {
+        step: params.step,
+        resumeData: params.resumeData,
+        requestContext,
+        tracingOptions: params.tracingOptions,
+        perStep: params.perStep,
+        forEachIndex: params.forEachIndex
+      }
+    });
+  }
   /**
    * Resumes a suspended workflow step that uses stream asynchronously and returns a promise that resolves when the workflow is complete
    * @param params - Object containing the step, resumeData and requestContext
@@ -5214,16 +5243,13 @@ var ToolProvider = class extends BaseResource {
   }
   providerId;
   /**
-   * Lists available toolkits from this provider
-   * @returns Promise containing list of toolkits
+   * Lists available toolkits from this provider.
    */
   listToolkits() {
     return this.request(`/tool-providers/${encodeURIComponent(this.providerId)}/toolkits`);
   }
   /**
-   * Lists available tools from this provider, with optional filtering
-   * @param params - Optional filtering and pagination parameters
-   * @returns Promise containing list of tools
+   * Lists available tools from this provider, with optional filtering.
    */
   listTools(params) {
     const searchParams = new URLSearchParams();
@@ -5245,15 +5271,125 @@ var ToolProvider = class extends BaseResource {
     );
   }
   /**
-   * Gets the input schema for a specific tool
-   * @param toolSlug - The slug of the tool
-   * @returns Promise containing the tool's JSON schema
+   * Gets the input schema for a specific tool.
    */
   getToolSchema(toolSlug) {
     return this.request(
       `/tool-providers/${encodeURIComponent(this.providerId)}/tools/${encodeURIComponent(toolSlug)}/schema`
     );
   }
+  /**
+   * Starts an OAuth flow for a (toolkit, connectionId) pair. Returns a
+   * redirect URL and an opaque auth handle to poll with `getAuthStatus`.
+   */
+  authorize(params) {
+    return this.request(`/tool-providers/${encodeURIComponent(this.providerId)}/authorize`, {
+      method: "POST",
+      body: params
+    });
+  }
+  /**
+   * Polls the OAuth flow status for an outstanding authorize call.
+   */
+  getAuthStatus(authId) {
+    return this.request(
+      `/tool-providers/${encodeURIComponent(this.providerId)}/auth-status/${encodeURIComponent(authId)}`
+    );
+  }
+  /**
+   * Batch-checks whether a set of (connectionId, toolkit) tuples are
+   * currently connected.
+   */
+  getConnectionStatus(params) {
+    return this.request(`/tool-providers/${encodeURIComponent(this.providerId)}/connection-status`, {
+      method: "POST",
+      body: params
+    });
+  }
+  /**
+   * Lists existing provider connections, scoped to a toolkit.
+   *
+   * Default: the connection owner is resolved server-side from the request's
+   * auth context. Admin callers (with `tool-providers:admin` permission) may
+   * pass `authorId` to target a specific author, or omit it to receive
+   * connections across all authors known to `tool_provider_connections` for
+   * this provider/toolkit. Pagination is page-based via `page` (1-indexed)
+   * and `perPage` (default 50, max 200).
+   */
+  listConnections(params) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("toolkit", params.toolkit);
+    if (params.authorId) {
+      searchParams.set("authorId", params.authorId);
+    }
+    if (params.page !== void 0 && params.page !== null) {
+      searchParams.set("page", String(params.page));
+    }
+    if (params.perPage !== void 0 && params.perPage !== null) {
+      searchParams.set("perPage", String(params.perPage));
+    }
+    if (params.scope) {
+      searchParams.set("scope", params.scope);
+    }
+    return this.request(
+      `/tool-providers/${encodeURIComponent(this.providerId)}/connections?${searchParams.toString()}`
+    );
+  }
+  /**
+   * Lists provider-specific fields the picker should collect before
+   * initiating a new connection (e.g. Confluence subdomain). Most toolkits
+   * return an empty array.
+   */
+  listConnectionFields(params) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("toolkit", params.toolkit);
+    return this.request(
+      `/tool-providers/${encodeURIComponent(this.providerId)}/connection-fields?${searchParams.toString()}`
+    );
+  }
+  /**
+   * Disconnects (revokes + deletes) a persisted connection.
+   *
+   * Without `force: true` the server refuses if any agent still pins the
+   * connection. With `force: true` the provider-side revoke is best-effort
+   * (errors are tolerated) and the local row is always removed.
+   */
+  disconnectConnection(connectionId, params) {
+    const searchParams = new URLSearchParams();
+    if (params?.toolkit) {
+      searchParams.set("toolkit", params.toolkit);
+    }
+    if (params?.force) {
+      searchParams.set("force", "true");
+    }
+    const queryString = searchParams.toString();
+    return this.request(
+      `/tool-providers/${encodeURIComponent(this.providerId)}/connections/${encodeURIComponent(connectionId)}${queryString ? `?${queryString}` : ""}`,
+      {
+        method: "DELETE"
+      }
+    );
+  }
+  /**
+   * Lists the agents that currently pin a given connection. Used by the
+   * picker to warn the user before disconnecting a shared account.
+   */
+  getConnectionUsage(connectionId, params) {
+    const searchParams = new URLSearchParams();
+    if (params?.toolkit) {
+      searchParams.set("toolkit", params.toolkit);
+    }
+    const queryString = searchParams.toString();
+    return this.request(
+      `/tool-providers/${encodeURIComponent(this.providerId)}/connections/${encodeURIComponent(connectionId)}/usage${queryString ? `?${queryString}` : ""}`
+    );
+  }
+  /**
+   * Returns provider-level health (config, reachability, etc.).
+   */
+  getHealth() {
+    return this.request(`/tool-providers/${encodeURIComponent(this.providerId)}/health`);
+  }
 };
 
 // src/resources/processor-provider.ts