@mastra/client-js 1.22.0-alpha.3 → 1.22.0-alpha.5

package/dist/resources/stored-agent.d.ts

@@ -1,5 +1,5 @@
 import type { RequestContext } from '@mastra/core/request-context';
-import type { ClientOptions, StoredAgentResponse, UpdateStoredAgentParams, DeleteStoredAgentResponse, AgentVersionResponse, ListAgentVersionsParams, ListAgentVersionsResponse, CreateAgentVersionParams, ActivateAgentVersionResponse, CompareVersionsResponse, DeleteAgentVersionResponse, FavoriteToggleResponse } from '../types.js';
+import type { ClientOptions, StoredAgentResponse, UpdateStoredAgentParams, DeleteStoredAgentResponse, AgentVersionResponse, ListAgentVersionsParams, ListAgentVersionsResponse, CreateAgentVersionParams, ActivateAgentVersionResponse, CompareVersionsResponse, DeleteAgentVersionResponse, FavoriteToggleResponse, ExportStoredAgentParams, ExportStoredAgentResponse } from '../types.js';
 import { BaseResource } from './base.js';
 /**
  * Resource for interacting with a specific stored agent
@@ -23,6 +23,10 @@ export declare class StoredAgent extends BaseResource {
      * @returns Promise containing the updated stored agent
      */
     update(params: UpdateStoredAgentParams, requestContext?: RequestContext | Record<string, any>): Promise<StoredAgentResponse>;
+    /**
+     * Exports deterministic JSON for this agent without mutating storage.
+     */
+    export(params: ExportStoredAgentParams): Promise<ExportStoredAgentResponse>;
     /**
      * Deletes the stored agent
      * @param requestContext - Optional request context to pass as query parameter

package/dist/resources/stored-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stored-agent.d.ts","sourceRoot":"","sources":["../../src/resources/stored-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAGzC,OAAO,CAAC,aAAa;gBADrB,OAAO,EAAE,aAAa,EACd,aAAa,EAAE,MAAM;IAK/B;;;;;OAKG;IACH,OAAO,CACL,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,UAAU,CAAA;KAAE,GACxD,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;OAKG;IACH,MAAM,CACJ,MAAM,EAAE,uBAAuB,EAC/B,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACpD,OAAO,CAAC,mBAAmB,CAAC;IAU/B;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAajG;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAShG;;;;;OAKG;IACH,UAAU,CAAC,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAalG;;;;;OAKG;IACH,YAAY,CACV,MAAM,CAAC,EAAE,uBAAuB,EAChC,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACpD,OAAO,CAAC,yBAAyB,CAAC;IAoBrC;;;;;OAKG;IACH,aAAa,CACX,MAAM,CAAC,EAAE,wBAAwB,EACjC,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACpD,OAAO,CAAC,oBAAoB,CAAC;IAUhC;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAMnH;;;;;OAKG;IACH,eAAe,CACb,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACpD,OAAO,CAAC,4BAA4B,CAAC;IASxC;;;;;OAKG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACpD,OAAO,CAAC,oBAAoB,CAAC;IAShC;;;;;OAKG;IACH,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACpD,OAAO,CAAC,0BAA0B,CAAC;IAStC;;;;;;OAMG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACpD,OAAO,CAAC,uBAAuB,CAAC;CAUpC"}
+{"version":3,"file":"stored-agent.d.ts","sourceRoot":"","sources":["../../src/resources/stored-agent.ts"],"names":[],"mappings":"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"}

package/dist/resources/tool-provider.d.ts

@@ -1,27 +1,80 @@
-import type { ClientOptions, ListToolProviderToolkitsResponse, ListToolProviderToolsParams, ListToolProviderToolsResponse, GetToolProviderToolSchemaResponse } from '../types.js';
+import type { AuthorizeToolProviderParams, AuthorizeToolProviderResponse, ClientOptions, DisconnectToolProviderConnectionParams, DisconnectToolProviderConnectionResponse, GetToolProviderConnectionUsageParams, GetToolProviderConnectionUsageResponse, GetToolProviderToolSchemaResponse, ListToolProviderConnectionFieldsParams, ListToolProviderConnectionFieldsResponse, ListToolProviderConnectionsParams, ListToolProviderConnectionsResponse, ListToolProviderToolkitsResponse, ListToolProviderToolsParams, ListToolProviderToolsResponse, ToolProviderAuthStatusResponse, ToolProviderConnectionStatusParams, ToolProviderConnectionStatusResponse, ToolProviderHealthResponse, UpdateToolProviderConnectionParams, UpdateToolProviderConnectionResponse } from '../types.js';
 import { BaseResource } from './base.js';
 /**
- * Resource for interacting with a specific tool provider
+ * Resource for interacting with a specific tool provider.
+ *
+ * Exposes the catalog (toolkits + tools), the OAuth surface (authorize +
+ * auth-status + connection-status), the lifecycle surface (connections list /
+ * disconnect / usage / fields), and a provider-level health check.
  */
 export declare class ToolProvider extends BaseResource {
     private providerId;
     constructor(options: ClientOptions, providerId: string);
     /**
-     * Lists available toolkits from this provider
-     * @returns Promise containing list of toolkits
+     * Lists available toolkits from this provider.
      */
     listToolkits(): Promise<ListToolProviderToolkitsResponse>;
     /**
-     * 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?: ListToolProviderToolsParams): Promise<ListToolProviderToolsResponse>;
     /**
-     * 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: string): Promise<GetToolProviderToolSchemaResponse>;
+    /**
+     * Starts an OAuth flow for a (toolkit, connectionId) pair. Returns a
+     * redirect URL and an opaque auth handle to poll with `getAuthStatus`.
+     */
+    authorize(params: AuthorizeToolProviderParams): Promise<AuthorizeToolProviderResponse>;
+    /**
+     * Polls the OAuth flow status for an outstanding authorize call.
+     */
+    getAuthStatus(authId: string): Promise<ToolProviderAuthStatusResponse>;
+    /**
+     * Batch-checks whether a set of (connectionId, toolkit) tuples are
+     * currently connected.
+     */
+    getConnectionStatus(params: ToolProviderConnectionStatusParams): Promise<ToolProviderConnectionStatusResponse>;
+    /**
+     * 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: ListToolProviderConnectionsParams): Promise<ListToolProviderConnectionsResponse>;
+    /**
+     * 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: ListToolProviderConnectionFieldsParams): Promise<ListToolProviderConnectionFieldsResponse>;
+    /**
+     * 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: string, params?: DisconnectToolProviderConnectionParams): Promise<DisconnectToolProviderConnectionResponse>;
+    /**
+     * Updates the persisted display label on a connection row. Pass `label: null`
+     * (or an empty string) to clear the existing label. Only the connection owner
+     * or an admin may rename, unless the row is `scope: 'shared'`.
+     */
+    updateConnection(connectionId: string, params: UpdateToolProviderConnectionParams): Promise<UpdateToolProviderConnectionResponse>;
+    /**
+     * Lists the agents that currently pin a given connection. Used by the
+     * picker to warn the user before disconnecting a shared account.
+     */
+    getConnectionUsage(connectionId: string, params?: GetToolProviderConnectionUsageParams): Promise<GetToolProviderConnectionUsageResponse>;
+    /**
+     * Returns provider-level health (config, reachability, etc.).
+     */
+    getHealth(): Promise<ToolProviderHealthResponse>;
 }
 //# sourceMappingURL=tool-provider.d.ts.map

package/dist/resources/tool-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-provider.d.ts","sourceRoot":"","sources":["../../src/resources/tool-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gCAAgC,EAChC,2BAA2B,EAC3B,6BAA6B,EAC7B,iCAAiC,EAClC,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAG1C,OAAO,CAAC,UAAU;gBADlB,OAAO,EAAE,aAAa,EACd,UAAU,EAAE,MAAM;IAK5B;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,gCAAgC,CAAC;IAIzD;;;;OAIG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAsBvF;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iCAAiC,CAAC;CAK5E"}
+{"version":3,"file":"tool-provider.d.ts","sourceRoot":"","sources":["../../src/resources/tool-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,6BAA6B,EAC7B,aAAa,EACb,sCAAsC,EACtC,wCAAwC,EACxC,oCAAoC,EACpC,sCAAsC,EACtC,iCAAiC,EACjC,sCAAsC,EACtC,wCAAwC,EACxC,iCAAiC,EACjC,mCAAmC,EACnC,gCAAgC,EAChC,2BAA2B,EAC3B,6BAA6B,EAC7B,8BAA8B,EAC9B,kCAAkC,EAClC,oCAAoC,EACpC,0BAA0B,EAC1B,kCAAkC,EAClC,oCAAoC,EACrC,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAG1C,OAAO,CAAC,UAAU;gBADlB,OAAO,EAAE,aAAa,EACd,UAAU,EAAE,MAAM;IAK5B;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,gCAAgC,CAAC;IAIzD;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAsBvF;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iCAAiC,CAAC;IAM3E;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAOtF;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,8BAA8B,CAAC;IAMtE;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,kCAAkC,GAAG,OAAO,CAAC,oCAAoC,CAAC;IAO9G;;;;;;;;;OASG;IACH,eAAe,CAAC,MAAM,EAAE,iCAAiC,GAAG,OAAO,CAAC,mCAAmC,CAAC;IAoBxG;;;;OAIG;IACH,oBAAoB,CAClB,MAAM,EAAE,sCAAsC,GAC7C,OAAO,CAAC,wCAAwC,CAAC;IAQpD;;;;;;OAMG;IACH,oBAAoB,CAClB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,sCAAsC,GAC9C,OAAO,CAAC,wCAAwC,CAAC;IAmBpD;;;;OAIG;IACH,gBAAgB,CACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,kCAAkC,GACzC,OAAO,CAAC,oCAAoC,CAAC;IAUhD;;;OAGG;IACH,kBAAkB,CAChB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,oCAAoC,GAC5C,OAAO,CAAC,sCAAsC,CAAC;IAalD;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,0BAA0B,CAAC;CAGjD"}