@mastra/editor 0.3.0 → 0.4.0

package/dist/arcade.js

@@ -0,0 +1,266 @@
+// src/providers/arcade.ts
+import { Arcade } from "@arcadeai/arcadejs";
+import { toZodToolSet, executeOrAuthorizeZodTool } from "@arcadeai/arcadejs/lib/index";
+var KNOWN_TOOLKITS = [
+  { slug: "AirtableApi", name: "Airtable API", category: "productivity" },
+  { slug: "ArcadeEngineApi", name: "Arcade Engine API", category: "development" },
+  { slug: "Asana", name: "Asana", category: "productivity" },
+  { slug: "AsanaApi", name: "Asana API", category: "productivity" },
+  { slug: "AshbyApi", name: "Ashby API", category: "productivity" },
+  { slug: "Attio", name: "Attio", category: "sales" },
+  { slug: "BoxApi", name: "Box API", category: "productivity" },
+  { slug: "Brightdata", name: "Bright Data", category: "development" },
+  { slug: "CalendlyApi", name: "Calendly API", category: "productivity" },
+  { slug: "Clickup", name: "ClickUp", category: "productivity" },
+  { slug: "ClickupApi", name: "ClickUp API", category: "productivity" },
+  { slug: "Confluence", name: "Confluence", category: "productivity" },
+  { slug: "CursorAgentsApi", name: "Cursor Agents API", category: "development" },
+  { slug: "CustomerioApi", name: "Customer.io API", category: "customer-support" },
+  { slug: "CustomerioPipelinesApi", name: "Customer.io Pipelines API", category: "customer-support" },
+  { slug: "CustomerioTrackApi", name: "Customer.io Track API", category: "customer-support" },
+  { slug: "DatadogApi", name: "Datadog API", category: "development" },
+  { slug: "Dropbox", name: "Dropbox", category: "productivity" },
+  { slug: "E2b", name: "E2B", category: "development" },
+  { slug: "ExaApi", name: "Exa API", category: "search" },
+  { slug: "Figma", name: "Figma", category: "productivity" },
+  { slug: "FigmaApi", name: "Figma API", category: "productivity" },
+  { slug: "Firecrawl", name: "Firecrawl", category: "development" },
+  { slug: "FreshserviceApi", name: "Freshservice API", category: "customer-support" },
+  { slug: "Github", name: "GitHub", category: "development" },
+  { slug: "GithubApi", name: "GitHub API", category: "development" },
+  { slug: "Gmail", name: "Gmail", category: "productivity" },
+  { slug: "Google", name: "Google", category: "search" },
+  { slug: "GoogleCalendar", name: "Google Calendar", category: "productivity" },
+  { slug: "GoogleContacts", name: "Google Contacts", category: "productivity" },
+  { slug: "GoogleDocs", name: "Google Docs", category: "productivity" },
+  { slug: "GoogleDrive", name: "Google Drive", category: "productivity" },
+  { slug: "GoogleFinance", name: "Google Finance", category: "search" },
+  { slug: "GoogleFlights", name: "Google Flights", category: "search" },
+  { slug: "GoogleHotels", name: "Google Hotels", category: "search" },
+  { slug: "GoogleJobs", name: "Google Jobs", category: "search" },
+  { slug: "GoogleMaps", name: "Google Maps", category: "search" },
+  { slug: "GoogleNews", name: "Google News", category: "search" },
+  { slug: "GoogleSearch", name: "Google Search", category: "search" },
+  { slug: "GoogleSheets", name: "Google Sheets", category: "productivity" },
+  { slug: "GoogleShopping", name: "Google Shopping", category: "search" },
+  { slug: "GoogleSlides", name: "Google Slides", category: "productivity" },
+  { slug: "Hubspot", name: "HubSpot", category: "sales" },
+  { slug: "HubspotAutomationApi", name: "HubSpot Automation API", category: "sales" },
+  { slug: "HubspotCmsApi", name: "HubSpot CMS API", category: "sales" },
+  { slug: "HubspotConversationsApi", name: "HubSpot Conversations API", category: "sales" },
+  { slug: "HubspotCrmApi", name: "HubSpot CRM API", category: "sales" },
+  { slug: "HubspotEventsApi", name: "HubSpot Events API", category: "sales" },
+  { slug: "HubspotMarketingApi", name: "HubSpot Marketing API", category: "sales" },
+  { slug: "HubspotMeetingsApi", name: "HubSpot Meetings API", category: "sales" },
+  { slug: "HubspotUsersApi", name: "HubSpot Users API", category: "sales" },
+  { slug: "Imgflip", name: "Imgflip", category: "entertainment" },
+  { slug: "IntercomApi", name: "Intercom API", category: "customer-support" },
+  { slug: "Jira", name: "Jira", category: "productivity" },
+  { slug: "Linear", name: "Linear", category: "productivity" },
+  { slug: "Linkedin", name: "LinkedIn", category: "social" },
+  { slug: "LumaApi", name: "Luma API", category: "productivity" },
+  { slug: "MailchimpMarketingApi", name: "Mailchimp API", category: "productivity" },
+  { slug: "Math", name: "Math", category: "utility" },
+  { slug: "Microsoft", name: "Microsoft", category: "productivity" },
+  { slug: "MicrosoftOnedrive", name: "Microsoft OneDrive", category: "productivity" },
+  { slug: "MicrosoftTeams", name: "Microsoft Teams", category: "social" },
+  { slug: "MicrosoftWord", name: "Microsoft Word", category: "productivity" },
+  { slug: "MiroApi", name: "Miro API", category: "productivity" },
+  { slug: "NotionToolkit", name: "Notion", category: "productivity" },
+  { slug: "OutlookCalendar", name: "Outlook Calendar", category: "productivity" },
+  { slug: "OutlookMail", name: "Outlook Mail", category: "productivity" },
+  { slug: "Pagerduty", name: "PagerDuty", category: "development" },
+  { slug: "PagerdutyApi", name: "PagerDuty API", category: "development" },
+  { slug: "PosthogApi", name: "PostHog API", category: "development" },
+  { slug: "Pylon", name: "Pylon", category: "customer-support" },
+  { slug: "PylonApi", name: "Pylon API", category: "customer-support" },
+  { slug: "Reddit", name: "Reddit", category: "social" },
+  { slug: "Salesforce", name: "Salesforce", category: "sales" },
+  { slug: "Sharepoint", name: "Microsoft SharePoint", category: "productivity" },
+  { slug: "Slack", name: "Slack", category: "social" },
+  { slug: "SlackApi", name: "Slack API", category: "social" },
+  { slug: "Spotify", name: "Spotify", category: "entertainment" },
+  { slug: "SquareupApi", name: "SquareUp API", category: "productivity" },
+  { slug: "Stripe", name: "Stripe", category: "payments" },
+  { slug: "StripeApi", name: "Stripe API", category: "payments" },
+  { slug: "TicktickApi", name: "TickTick API", category: "productivity" },
+  { slug: "TrelloApi", name: "Trello API", category: "productivity" },
+  { slug: "Twilio", name: "Twilio", category: "social" },
+  { slug: "VercelApi", name: "Vercel API", category: "development" },
+  { slug: "Walmart", name: "Walmart", category: "search" },
+  { slug: "WeaviateApi", name: "Weaviate API", category: "development" },
+  { slug: "X", name: "X", category: "social" },
+  { slug: "XeroApi", name: "Xero API", category: "productivity" },
+  { slug: "Youtube", name: "Youtube", category: "search" },
+  { slug: "Zendesk", name: "Zendesk", category: "customer-support" },
+  { slug: "ZohoBooksApi", name: "Zoho Books API", category: "payments" },
+  { slug: "Zoom", name: "Zoom", category: "social" }
+];
+var ArcadeToolProvider = class {
+  constructor(config) {
+    this.info = {
+      id: "arcade",
+      name: "Arcade AI",
+      description: "Access 7,000+ tools from 130+ app integrations via Arcade AI"
+    };
+    this.client = null;
+    this.config = config;
+    this.toolkitCache = /* @__PURE__ */ new Map();
+    for (const tk of KNOWN_TOOLKITS) {
+      this.toolkitCache.set(tk.slug, {
+        slug: tk.slug,
+        name: tk.name,
+        description: tk.description ?? `Arcade AI ${tk.name} tools`,
+        icon: tk.category
+      });
+    }
+  }
+  /**
+   * Get or create an Arcade client.
+   */
+  getClient() {
+    if (!this.client) {
+      this.client = new Arcade({
+        apiKey: this.config.apiKey,
+        ...this.config.baseURL ? { baseURL: this.config.baseURL } : {}
+      });
+    }
+    return this.client;
+  }
+  /**
+   * Absorb toolkit metadata from a tool listing into the cache.
+   * Returns true if any new toolkit was discovered.
+   */
+  absorbToolkits(items) {
+    let discovered = false;
+    for (const tool of items) {
+      const tk = tool.toolkit;
+      if (tk?.name && !this.toolkitCache.has(tk.name)) {
+        this.toolkitCache.set(tk.name, {
+          slug: tk.name,
+          name: tk.name,
+          description: tk.description ?? `Arcade AI ${tk.name} tools`
+        });
+        discovered = true;
+      }
+    }
+    return discovered;
+  }
+  /**
+   * List toolkits.
+   *
+   * Returns the pre-seeded catalog merged with any toolkits discovered at
+   * runtime via `listTools()` or `resolveTools()` calls.
+   */
+  async listToolkits() {
+    const data = [...this.toolkitCache.values()].sort((a, b) => a.name.localeCompare(b.name));
+    return { data };
+  }
+  /**
+   * List available tools with optional toolkit and pagination filters.
+   * Uses `tools.list({ toolkit, limit, offset })`.
+   */
+  async listTools(options) {
+    const client = this.getClient();
+    const limit = options?.perPage ?? 50;
+    const page = options?.page ?? 1;
+    const offset = (page - 1) * limit;
+    const query = { limit, offset };
+    if (options?.toolkit) query.toolkit = options.toolkit;
+    const result = await client.tools.list(query);
+    const items = result.items ?? [];
+    this.absorbToolkits(items);
+    let filtered = items;
+    if (options?.search) {
+      const searchLower = options.search.toLowerCase();
+      filtered = items.filter(
+        (t) => t.name?.toLowerCase().includes(searchLower) || t.description?.toLowerCase().includes(searchLower) || t.qualified_name?.toLowerCase().includes(searchLower)
+      );
+    }
+    const data = filtered.map((tool) => ({
+      slug: tool.qualified_name ?? `${tool.toolkit?.name}.${tool.name}`,
+      name: tool.name,
+      description: tool.description,
+      toolkit: tool.toolkit?.name
+    }));
+    return {
+      data,
+      pagination: {
+        page,
+        perPage: limit,
+        total: result.total_count,
+        hasMore: offset + items.length < (result.total_count ?? 0)
+      }
+    };
+  }
+  /**
+   * Get the JSON schema for a specific tool by its qualified name (e.g., `Github.GetRepository`).
+   */
+  async getToolSchema(toolSlug) {
+    try {
+      const client = this.getClient();
+      const tool = await client.tools.get(toolSlug);
+      if (!tool) return null;
+      const properties = {};
+      const required = [];
+      for (const param of tool.input?.parameters ?? []) {
+        properties[param.name] = {
+          ...param.value_schema ?? {},
+          description: param.description
+        };
+        if (param.required) required.push(param.name);
+      }
+      return {
+        type: "object",
+        properties,
+        ...required.length > 0 ? { required } : {}
+      };
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Resolve executable tools in Mastra's ToolAction format.
+   *
+   * Uses `toZodToolSet` from `@arcadeai/arcadejs/lib` to create ZodTool objects
+   * with Zod schemas and execute functions, then wraps them as ToolAction objects.
+   */
+  async resolveTools(toolSlugs, toolConfigs, options) {
+    if (toolSlugs.length === 0) return {};
+    const client = this.getClient();
+    const userId = options?.userId ?? "default";
+    const toolDefs = await Promise.all(toolSlugs.map((slug) => client.tools.get(slug).catch(() => null)));
+    const validDefs = toolDefs.filter((d) => d !== null);
+    if (validDefs.length === 0) return {};
+    this.absorbToolkits(validDefs);
+    const zodToolSet = toZodToolSet({
+      tools: validDefs,
+      client,
+      userId,
+      executeFactory: executeOrAuthorizeZodTool
+    });
+    const result = {};
+    const normalizedToQualified = /* @__PURE__ */ new Map();
+    for (const d of validDefs) {
+      const qn = d.qualified_name ?? `${d.toolkit?.name}.${d.name}`;
+      normalizedToQualified.set(qn.replace(/\./g, "_"), qn);
+    }
+    for (const [key, zodTool] of Object.entries(zodToolSet)) {
+      const qualifiedName = normalizedToQualified.get(key) ?? key;
+      const descOverride = toolConfigs?.[qualifiedName]?.description ?? toolConfigs?.[key]?.description;
+      result[qualifiedName] = {
+        id: qualifiedName,
+        description: descOverride ?? zodTool.description ?? "",
+        inputSchema: zodTool.parameters,
+        outputSchema: zodTool.output,
+        execute: async (input) => {
+          return zodTool.execute(input);
+        }
+      };
+    }
+    return result;
+  }
+};
+export {
+  ArcadeToolProvider
+};

package/dist/composio.cjs

@@ -0,0 +1,143 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/composio.ts
+var composio_exports = {};
+__export(composio_exports, {
+  ComposioToolProvider: () => ComposioToolProvider
+});
+module.exports = __toCommonJS(composio_exports);
+
+// src/providers/composio.ts
+var import_core = require("@composio/core");
+var import_mastra = require("@composio/mastra");
+var ComposioToolProvider = class {
+  constructor(config) {
+    this.info = {
+      id: "composio",
+      name: "Composio",
+      description: "Access 10,000+ tools from 150+ apps via Composio"
+    };
+    this.rawClient = null;
+    this.mastraClient = null;
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Get or create a raw Composio client (no provider — for discovery only).
+   */
+  getRawClient() {
+    if (!this.rawClient) {
+      this.rawClient = new import_core.Composio({ apiKey: this.apiKey });
+    }
+    return this.rawClient;
+  }
+  /**
+   * Get or create a Composio client with MastraProvider (for runtime tools).
+   */
+  getMastraClient() {
+    if (!this.mastraClient) {
+      this.mastraClient = new import_core.Composio({
+        apiKey: this.apiKey,
+        provider: new import_mastra.MastraProvider()
+      });
+    }
+    return this.mastraClient;
+  }
+  /**
+   * List available toolkits via `composio.toolkits.get({})`.
+   * Returns: `ToolKitListResponse` — an array of `{ slug, name, meta: { description, logo, ... } }`.
+   */
+  async listToolkits() {
+    const composio = this.getRawClient();
+    const toolkits = await composio.toolkits.get({});
+    const data = toolkits.map((tk) => ({
+      slug: tk.slug,
+      name: tk.name,
+      description: tk.meta?.description,
+      icon: tk.meta?.logo
+    }));
+    return { data };
+  }
+  /**
+   * List available tools via `composio.tools.getRawComposioTools()`.
+   * No userId required — returns raw tool definitions for UI browsing.
+   */
+  async listTools(options) {
+    const composio = this.getRawClient();
+    const limit = options?.perPage;
+    const query = options?.toolkit ? { toolkits: [options.toolkit], limit, search: options?.search } : options?.search ? { search: options.search, limit } : { toolkits: [], limit };
+    const rawTools = await composio.tools.getRawComposioTools(query);
+    const data = rawTools.map((tool) => ({
+      slug: tool.slug,
+      name: tool.name ?? tool.slug,
+      description: tool.description,
+      toolkit: tool.toolkit?.slug
+    }));
+    return {
+      data,
+      pagination: {
+        page: options?.page ?? 1,
+        perPage: limit,
+        hasMore: limit !== void 0 && rawTools.length >= limit
+      }
+    };
+  }
+  /**
+   * Get JSON schema for a specific tool via `composio.tools.getRawComposioToolBySlug()`.
+   */
+  async getToolSchema(toolSlug) {
+    try {
+      const composio = this.getRawClient();
+      const tool = await composio.tools.getRawComposioToolBySlug(toolSlug);
+      if (!tool) return null;
+      return tool.inputParameters ?? {};
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Resolve executable tools in Mastra format via `composio.tools.get(userId, { tools: [...] })`.
+   *
+   * Uses MastraProvider so returned tools are `ReturnType<typeof createTool>` — compatible
+   * with Mastra's `ToolAction` interface.
+   */
+  async resolveTools(toolSlugs, toolConfigs, options) {
+    if (toolSlugs.length === 0) return {};
+    const userId = options?.userId ?? "default";
+    const composio = this.getMastraClient();
+    const mastraTools = await composio.tools.get(userId, { tools: toolSlugs });
+    const result = {};
+    const entries = Object.entries(mastraTools ?? {});
+    for (const [key, tool] of entries) {
+      if (!tool) continue;
+      const slug = tool.id ?? key;
+      const descOverride = toolConfigs?.[slug]?.description;
+      if (descOverride) {
+        result[slug] = { ...tool, description: descOverride };
+      } else {
+        result[slug] = tool;
+      }
+    }
+    return result;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ComposioToolProvider
+});

package/dist/composio.d.cts

@@ -0,0 +1,59 @@
+import { ToolProvider, ToolProviderInfo, ToolProviderListResult, ToolProviderToolkit, ListToolProviderToolsOptions, ToolProviderToolInfo, ResolveToolProviderToolsOptions } from '@mastra/core/tool-provider';
+import { ToolAction } from '@mastra/core/tools';
+import { StorageToolConfig } from '@mastra/core/storage';
+
+interface ComposioToolProviderConfig {
+    /** Composio API key */
+    apiKey: string;
+}
+/**
+ * Composio tool provider adapter.
+ *
+ * Uses `@composio/core` + `@composio/mastra` SDKs for both tool discovery
+ * and runtime resolution. Both packages are optional peer dependencies and
+ * tree-shaken if this provider class isn't imported.
+ *
+ * Discovery methods (`listToolkits`, `listTools`, `getToolSchema`) use the
+ * raw Composio client (no userId required).
+ *
+ * Runtime method (`resolveTools`) uses the MastraProvider so returned tools are
+ * already in Mastra's `createTool()` format.
+ */
+declare class ComposioToolProvider implements ToolProvider {
+    readonly info: ToolProviderInfo;
+    private apiKey;
+    private rawClient;
+    private mastraClient;
+    constructor(config: ComposioToolProviderConfig);
+    /**
+     * Get or create a raw Composio client (no provider — for discovery only).
+     */
+    private getRawClient;
+    /**
+     * Get or create a Composio client with MastraProvider (for runtime tools).
+     */
+    private getMastraClient;
+    /**
+     * List available toolkits via `composio.toolkits.get({})`.
+     * Returns: `ToolKitListResponse` — an array of `{ slug, name, meta: { description, logo, ... } }`.
+     */
+    listToolkits(): Promise<ToolProviderListResult<ToolProviderToolkit>>;
+    /**
+     * List available tools via `composio.tools.getRawComposioTools()`.
+     * No userId required — returns raw tool definitions for UI browsing.
+     */
+    listTools(options?: ListToolProviderToolsOptions): Promise<ToolProviderListResult<ToolProviderToolInfo>>;
+    /**
+     * Get JSON schema for a specific tool via `composio.tools.getRawComposioToolBySlug()`.
+     */
+    getToolSchema(toolSlug: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Resolve executable tools in Mastra format via `composio.tools.get(userId, { tools: [...] })`.
+     *
+     * Uses MastraProvider so returned tools are `ReturnType<typeof createTool>` — compatible
+     * with Mastra's `ToolAction` interface.
+     */
+    resolveTools(toolSlugs: string[], toolConfigs?: Record<string, StorageToolConfig>, options?: ResolveToolProviderToolsOptions): Promise<Record<string, ToolAction<unknown, unknown>>>;
+}
+
+export { ComposioToolProvider, type ComposioToolProviderConfig };

package/dist/composio.d.ts

@@ -0,0 +1,59 @@
+import { ToolProvider, ToolProviderInfo, ToolProviderListResult, ToolProviderToolkit, ListToolProviderToolsOptions, ToolProviderToolInfo, ResolveToolProviderToolsOptions } from '@mastra/core/tool-provider';
+import { ToolAction } from '@mastra/core/tools';
+import { StorageToolConfig } from '@mastra/core/storage';
+
+interface ComposioToolProviderConfig {
+    /** Composio API key */
+    apiKey: string;
+}
+/**
+ * Composio tool provider adapter.
+ *
+ * Uses `@composio/core` + `@composio/mastra` SDKs for both tool discovery
+ * and runtime resolution. Both packages are optional peer dependencies and
+ * tree-shaken if this provider class isn't imported.
+ *
+ * Discovery methods (`listToolkits`, `listTools`, `getToolSchema`) use the
+ * raw Composio client (no userId required).
+ *
+ * Runtime method (`resolveTools`) uses the MastraProvider so returned tools are
+ * already in Mastra's `createTool()` format.
+ */
+declare class ComposioToolProvider implements ToolProvider {
+    readonly info: ToolProviderInfo;
+    private apiKey;
+    private rawClient;
+    private mastraClient;
+    constructor(config: ComposioToolProviderConfig);
+    /**
+     * Get or create a raw Composio client (no provider — for discovery only).
+     */
+    private getRawClient;
+    /**
+     * Get or create a Composio client with MastraProvider (for runtime tools).
+     */
+    private getMastraClient;
+    /**
+     * List available toolkits via `composio.toolkits.get({})`.
+     * Returns: `ToolKitListResponse` — an array of `{ slug, name, meta: { description, logo, ... } }`.
+     */
+    listToolkits(): Promise<ToolProviderListResult<ToolProviderToolkit>>;
+    /**
+     * List available tools via `composio.tools.getRawComposioTools()`.
+     * No userId required — returns raw tool definitions for UI browsing.
+     */
+    listTools(options?: ListToolProviderToolsOptions): Promise<ToolProviderListResult<ToolProviderToolInfo>>;
+    /**
+     * Get JSON schema for a specific tool via `composio.tools.getRawComposioToolBySlug()`.
+     */
+    getToolSchema(toolSlug: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Resolve executable tools in Mastra format via `composio.tools.get(userId, { tools: [...] })`.
+     *
+     * Uses MastraProvider so returned tools are `ReturnType<typeof createTool>` — compatible
+     * with Mastra's `ToolAction` interface.
+     */
+    resolveTools(toolSlugs: string[], toolConfigs?: Record<string, StorageToolConfig>, options?: ResolveToolProviderToolsOptions): Promise<Record<string, ToolAction<unknown, unknown>>>;
+}
+
+export { ComposioToolProvider, type ComposioToolProviderConfig };

package/dist/composio.js

@@ -0,0 +1,116 @@
+// src/providers/composio.ts
+import { Composio } from "@composio/core";
+import { MastraProvider } from "@composio/mastra";
+var ComposioToolProvider = class {
+  constructor(config) {
+    this.info = {
+      id: "composio",
+      name: "Composio",
+      description: "Access 10,000+ tools from 150+ apps via Composio"
+    };
+    this.rawClient = null;
+    this.mastraClient = null;
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Get or create a raw Composio client (no provider — for discovery only).
+   */
+  getRawClient() {
+    if (!this.rawClient) {
+      this.rawClient = new Composio({ apiKey: this.apiKey });
+    }
+    return this.rawClient;
+  }
+  /**
+   * Get or create a Composio client with MastraProvider (for runtime tools).
+   */
+  getMastraClient() {
+    if (!this.mastraClient) {
+      this.mastraClient = new Composio({
+        apiKey: this.apiKey,
+        provider: new MastraProvider()
+      });
+    }
+    return this.mastraClient;
+  }
+  /**
+   * List available toolkits via `composio.toolkits.get({})`.
+   * Returns: `ToolKitListResponse` — an array of `{ slug, name, meta: { description, logo, ... } }`.
+   */
+  async listToolkits() {
+    const composio = this.getRawClient();
+    const toolkits = await composio.toolkits.get({});
+    const data = toolkits.map((tk) => ({
+      slug: tk.slug,
+      name: tk.name,
+      description: tk.meta?.description,
+      icon: tk.meta?.logo
+    }));
+    return { data };
+  }
+  /**
+   * List available tools via `composio.tools.getRawComposioTools()`.
+   * No userId required — returns raw tool definitions for UI browsing.
+   */
+  async listTools(options) {
+    const composio = this.getRawClient();
+    const limit = options?.perPage;
+    const query = options?.toolkit ? { toolkits: [options.toolkit], limit, search: options?.search } : options?.search ? { search: options.search, limit } : { toolkits: [], limit };
+    const rawTools = await composio.tools.getRawComposioTools(query);
+    const data = rawTools.map((tool) => ({
+      slug: tool.slug,
+      name: tool.name ?? tool.slug,
+      description: tool.description,
+      toolkit: tool.toolkit?.slug
+    }));
+    return {
+      data,
+      pagination: {
+        page: options?.page ?? 1,
+        perPage: limit,
+        hasMore: limit !== void 0 && rawTools.length >= limit
+      }
+    };
+  }
+  /**
+   * Get JSON schema for a specific tool via `composio.tools.getRawComposioToolBySlug()`.
+   */
+  async getToolSchema(toolSlug) {
+    try {
+      const composio = this.getRawClient();
+      const tool = await composio.tools.getRawComposioToolBySlug(toolSlug);
+      if (!tool) return null;
+      return tool.inputParameters ?? {};
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Resolve executable tools in Mastra format via `composio.tools.get(userId, { tools: [...] })`.
+   *
+   * Uses MastraProvider so returned tools are `ReturnType<typeof createTool>` — compatible
+   * with Mastra's `ToolAction` interface.
+   */
+  async resolveTools(toolSlugs, toolConfigs, options) {
+    if (toolSlugs.length === 0) return {};
+    const userId = options?.userId ?? "default";
+    const composio = this.getMastraClient();
+    const mastraTools = await composio.tools.get(userId, { tools: toolSlugs });
+    const result = {};
+    const entries = Object.entries(mastraTools ?? {});
+    for (const [key, tool] of entries) {
+      if (!tool) continue;
+      const slug = tool.id ?? key;
+      const descOverride = toolConfigs?.[slug]?.description;
+      if (descOverride) {
+        result[slug] = { ...tool, description: descOverride };
+      } else {
+        result[slug] = tool;
+      }
+    }
+    return result;
+  }
+};
+export {
+  ComposioToolProvider
+};