@customclaw/composio 0.0.1

package/dist/tools/search.d.ts

@@ -0,0 +1,50 @@
+import type { ComposioClient } from "../client.js";
+import type { ComposioConfig } from "../types.js";
+/**
+ * Tool parameters for composio_search_tools
+ */
+export declare const ComposioSearchToolSchema: import("@sinclair/typebox").TObject<{
+    query: import("@sinclair/typebox").TString;
+    toolkits: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    user_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+/**
+ * Create the composio_search_tools tool
+ */
+export declare function createComposioSearchTool(client: ComposioClient, _config: ComposioConfig): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        query: import("@sinclair/typebox").TString;
+        toolkits: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+        limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+        user_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute(_toolCallId: string, params: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details: {
+            error: string;
+        };
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details: {
+            query: string;
+            count: number;
+            tools: {
+                slug: string;
+                name: string;
+                description: string;
+                toolkit: string;
+                parameters: Record<string, unknown>;
+            }[];
+        };
+    }>;
+};

package/dist/tools/search.js

@@ -0,0 +1,71 @@
+import { Type } from "@sinclair/typebox";
+/**
+ * Tool parameters for composio_search_tools
+ */
+export const ComposioSearchToolSchema = Type.Object({
+    query: Type.String({
+        description: "Task description to find matching tools (e.g., 'send an email', 'create github issue')",
+    }),
+    toolkits: Type.Optional(Type.Array(Type.String(), {
+        description: "Limit search to specific toolkits (e.g., ['github', 'gmail'])",
+    })),
+    limit: Type.Optional(Type.Number({
+        description: "Maximum number of results to return (default: 10, max: 50)",
+    })),
+    user_id: Type.Optional(Type.String({
+        description: "User ID for session scoping (uses default if not provided)",
+    })),
+});
+/**
+ * Create the composio_search_tools tool
+ */
+export function createComposioSearchTool(client, _config) {
+    return {
+        name: "composio_search_tools",
+        label: "Composio Search Tools",
+        description: "Search for tools across 1000+ integrations (Gmail, Slack, GitHub, Notion, etc.) " +
+            "by describing what you want to accomplish. Returns matching tools with their schemas.",
+        parameters: ComposioSearchToolSchema,
+        async execute(_toolCallId, params) {
+            const query = String(params.query || "").trim();
+            if (!query) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: "query is required" }, null, 2) }],
+                    details: { error: "query is required" },
+                };
+            }
+            const toolkits = Array.isArray(params.toolkits)
+                ? params.toolkits.filter((t) => typeof t === "string")
+                : undefined;
+            const limit = Math.min(typeof params.limit === "number" && params.limit > 0 ? params.limit : 10, 50);
+            const userId = typeof params.user_id === "string" ? params.user_id : undefined;
+            try {
+                const results = await client.searchTools(query, { toolkits, limit, userId });
+                const response = {
+                    query,
+                    count: results.length,
+                    tools: results.map((tool) => ({
+                        slug: tool.slug,
+                        name: tool.name,
+                        description: tool.description,
+                        toolkit: tool.toolkit,
+                        parameters: tool.parameters,
+                    })),
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+                    details: response,
+                };
+            }
+            catch (err) {
+                const errorResponse = {
+                    error: err instanceof Error ? err.message : String(err),
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(errorResponse, null, 2) }],
+                    details: errorResponse,
+                };
+            }
+        },
+    };
+}

package/dist/tools/workbench.d.ts

@@ -0,0 +1,48 @@
+import type { ComposioClient } from "../client.js";
+import type { ComposioConfig } from "../types.js";
+/**
+ * Tool parameters for composio_workbench
+ */
+export declare const ComposioWorkbenchSchema: import("@sinclair/typebox").TObject<{
+    code: import("@sinclair/typebox").TString;
+    thought: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    current_step: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    current_step_metric: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    user_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+/**
+ * Create the composio_workbench tool
+ */
+export declare function createComposioWorkbenchTool(client: ComposioClient, _config: ComposioConfig): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        code: import("@sinclair/typebox").TString;
+        thought: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        current_step: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        current_step_metric: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        user_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute(_toolCallId: string, params: Record<string, unknown>): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details: {
+            error: string;
+        };
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        details: {
+            output: unknown;
+            success: boolean;
+        } | {
+            error: string | undefined;
+            success: boolean;
+        };
+    }>;
+};

package/dist/tools/workbench.js

@@ -0,0 +1,76 @@
+import { Type } from "@sinclair/typebox";
+/**
+ * Tool parameters for composio_workbench
+ */
+export const ComposioWorkbenchSchema = Type.Object({
+    code: Type.String({
+        description: "Python code to execute in the remote Jupyter sandbox. " +
+            "Helper functions available: run_composio_tool(slug, args), invoke_llm(query), " +
+            "upload_local_file(*paths), proxy_execute(method, endpoint, toolkit, ...), " +
+            "web_search(query), smart_file_extract(path). State persists across executions.",
+    }),
+    thought: Type.Optional(Type.String({
+        description: "Concise objective describing what the code should achieve",
+    })),
+    current_step: Type.Optional(Type.String({
+        description: "Short enum for current workflow step (e.g., FETCHING_EMAILS, GENERATING_REPLIES)",
+    })),
+    current_step_metric: Type.Optional(Type.String({
+        description: "Progress metrics for current step (e.g., '10/100 emails', '3/10 pages')",
+    })),
+    user_id: Type.Optional(Type.String({
+        description: "User ID for session scoping (uses default if not provided)",
+    })),
+});
+/**
+ * Create the composio_workbench tool
+ */
+export function createComposioWorkbenchTool(client, _config) {
+    return {
+        name: "composio_workbench",
+        label: "Composio Remote Workbench",
+        description: "Execute Python code in a remote Jupyter sandbox for processing large tool responses, " +
+            "scripting bulk operations, or running data analysis. Use when data is stored in remote files " +
+            "or when orchestrating multiple Composio tool calls. Has access to pandas, numpy, PIL, PyTorch, etc.",
+        parameters: ComposioWorkbenchSchema,
+        async execute(_toolCallId, params) {
+            const code = String(params.code || "").trim();
+            if (!code) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: "code is required" }, null, 2) }],
+                    details: { error: "code is required" },
+                };
+            }
+            const thought = typeof params.thought === "string" ? params.thought : undefined;
+            const currentStep = typeof params.current_step === "string" ? params.current_step : undefined;
+            const currentStepMetric = typeof params.current_step_metric === "string" ? params.current_step_metric : undefined;
+            const userId = typeof params.user_id === "string" ? params.user_id : undefined;
+            try {
+                const result = await client.executeWorkbench(code, {
+                    thought,
+                    currentStep,
+                    currentStepMetric,
+                    userId,
+                });
+                const response = {
+                    success: result.success,
+                    ...(result.success ? { output: result.output } : { error: result.error }),
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+                    details: response,
+                };
+            }
+            catch (err) {
+                const errorResponse = {
+                    success: false,
+                    error: err instanceof Error ? err.message : String(err),
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(errorResponse, null, 2) }],
+                    details: errorResponse,
+                };
+            }
+        },
+    };
+}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Composio Tool Router types for OpenClaw integration
+ */
+export interface ComposioConfig {
+    enabled: boolean;
+    apiKey?: string;
+    defaultUserId?: string;
+    allowedToolkits?: string[];
+    blockedToolkits?: string[];
+}
+export interface ToolSearchResult {
+    name: string;
+    slug: string;
+    description: string;
+    toolkit: string;
+    parameters: Record<string, unknown>;
+}
+export interface ToolExecutionResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+export interface MultiExecutionItem {
+    tool_slug: string;
+    arguments: Record<string, unknown>;
+}
+export interface MultiExecutionResult {
+    results: Array<{
+        tool_slug: string;
+        success: boolean;
+        data?: unknown;
+        error?: string;
+    }>;
+}
+export interface ConnectionStatus {
+    toolkit: string;
+    connected: boolean;
+    userId?: string;
+    authUrl?: string;
+}
+export interface ComposioClientOptions {
+    apiKey: string;
+    defaultUserId?: string;
+    allowedToolkits?: string[];
+    blockedToolkits?: string[];
+}

package/dist/types.js

@@ -0,0 +1,4 @@
+/**
+ * Composio Tool Router types for OpenClaw integration
+ */
+export {};

package/openclaw.plugin.json

@@ -0,0 +1,58 @@
+{
+  "id": "composio",
+  "name": "Composio Tool Router",
+  "description": "Access 1000+ third-party tools via Composio (Gmail, Slack, GitHub, Notion, etc.)",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "description": "Enable or disable the Composio plugin"
+      },
+      "apiKey": {
+        "type": "string",
+        "description": "Composio API key (or set COMPOSIO_API_KEY env var)"
+      },
+      "defaultUserId": {
+        "type": "string",
+        "description": "Default user ID for session scoping"
+      },
+      "allowedToolkits": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Restrict to specific toolkits (e.g., github, gmail)"
+      },
+      "blockedToolkits": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Block specific toolkits"
+      }
+    }
+  },
+  "uiHints": {
+    "enabled": {
+      "label": "Enable Composio",
+      "help": "Enable or disable the Composio Tool Router integration"
+    },
+    "apiKey": {
+      "label": "API Key",
+      "help": "Composio API key from platform.composio.dev/settings",
+      "sensitive": true
+    },
+    "defaultUserId": {
+      "label": "Default User ID",
+      "help": "Default user ID for session scoping (optional)"
+    },
+    "allowedToolkits": {
+      "label": "Allowed Toolkits",
+      "help": "Restrict to specific toolkits (e.g., github, gmail)",
+      "advanced": true
+    },
+    "blockedToolkits": {
+      "label": "Blocked Toolkits",
+      "help": "Block specific toolkits from being used",
+      "advanced": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@customclaw/composio",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "Composio Tool Router plugin for OpenClaw — access 1000+ third-party integrations",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "openclaw": {
+    "extensions": ["./dist/index.js"]
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "THIRD-PARTY-NOTICES"
+  ],
+  "keywords": [
+    "openclaw",
+    "composio",
+    "plugin",
+    "integrations"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@composio/core": "^0.5.5",
+    "@sinclair/typebox": "0.34.47",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.4.0"
+  }
+}