@toolforest/toolforest-plugin 0.3.2

package/README.md

@@ -0,0 +1,68 @@
+# @toolforest/openclaw-plugin
+
+OpenClaw plugin that connects your [Toolforest](https://www.toolforest.io) toolkits as native agent tools. Supports 250+ tools across GitHub, Google Sheets, Slack, and more.
+
+## Install
+
+```bash
+openclaw plugins install @toolforest/openclaw-plugin
+openclaw gateway restart
+```
+
+## Configuration
+
+Set your Toolforest API key (get one at [app.toolforest.io](https://app.toolforest.io)):
+
+```bash
+openclaw config set plugins.entries.toolforest.config.apiKey tfo_your_key_here
+openclaw gateway restart
+```
+
+Or set the `TOOLFOREST_API_KEY` environment variable.
+
+### Options
+
+| Key | Description | Default |
+|-----|-------------|---------|
+| `apiKey` | Toolforest API key (`tfo_...`) | `TOOLFOREST_API_KEY` env var |
+| `remoteUrl` | Override the MCP endpoint URL | `https://mcp.toolforest.io/mcp` |
+
+## How it works
+
+1. Connects to the Toolforest MCP server using your API key
+2. Discovers all connected toolkits and their tools
+3. Registers each tool as a native OpenClaw agent tool (prefixed with `toolforest_`)
+4. Injects prompt guidance so the agent knows which toolkits are available
+5. Refreshes the toolkit list in the background every 5 minutes
+
+## Features
+
+- **Native tool registration** — Toolforest tools appear as first-class OpenClaw tools
+- **Dynamic prompt guidance** — agent sees which toolkits are connected, updated every 5 minutes
+- **Error state guidance** — if connection fails, the agent guides the user through setup
+- **Fallback skill** — `/toolforest-mcp` skill provides curl-based MCP access when native tools are unavailable
+- **Client-side validation** — validates tool arguments locally before sending to the server
+
+## Fallback skill
+
+If the native tools aren't working, use the built-in fallback skill:
+
+```
+/toolforest-mcp
+```
+
+This gives the agent curl-based instructions to call the Toolforest MCP server directly.
+
+## Requirements
+
+- OpenClaw >= 2026.3.0
+- Node.js >= 20
+- A Toolforest account with at least one connected toolkit
+
+## Existing sessions
+
+After installing or updating the plugin, restart any existing OpenClaw sessions. The plugin will only be available in sessions started after the gateway restart.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @toolforest/openclaw-plugin
+ *
+ * OpenClaw plugin that connects to the Toolforest MCP server and registers
+ * all connected tools as native agent tools. Follows the same pattern as
+ * openclaw/src/agents/pi-bundle-mcp-tools.ts for MCP-to-AgentTool bridging.
+ */
+declare const pluginDefinition: {
+    id: string;
+    name: string;
+    description: string;
+    register(api: PluginApi): Promise<void>;
+};
+interface PluginApi {
+    pluginConfig?: unknown;
+    logger: {
+        info(msg: string): void;
+        warn(msg: string): void;
+        error(msg: string): void;
+        debug(msg: string): void;
+    };
+    registerTool(tool: never, opts?: {
+        name?: string;
+    }): void;
+    on?(event: string, handler: (...args: unknown[]) => unknown): void;
+}
+export default pluginDefinition;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,QAAA,MAAM,gBAAgB;;;;kBAMA,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;CA6E9C,CAAC;AAGF,UAAU,SAAS;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE;QACN,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;IACF,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACpE;AAED,eAAe,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,85 @@
+/**
+ * @toolforest/openclaw-plugin
+ *
+ * OpenClaw plugin that connects to the Toolforest MCP server and registers
+ * all connected tools as native agent tools. Follows the same pattern as
+ * openclaw/src/agents/pi-bundle-mcp-tools.ts for MCP-to-AgentTool bridging.
+ */
+import { ToolforestClient } from "./src/client.js";
+import { resolveConfig } from "./src/config.js";
+import { buildBlock } from "./src/prompt.js";
+import { bridgeAllTools } from "./src/tool-bridge.js";
+import { ToolkitCache } from "./src/toolkit-cache.js";
+const pluginDefinition = {
+    id: "toolforest",
+    name: "Toolforest",
+    description: "Connect all your Toolforest toolkits as native OpenClaw agent tools.",
+    async register(api) {
+        const cfg = resolveConfig(api.pluginConfig);
+        // Mutable state read by the hook on every agent turn
+        let promptState = {
+            status: "error",
+            message: "Not configured",
+        };
+        let cache = null;
+        let toolCount = 0;
+        // Register hook FIRST — before any async work.
+        // This ensures the agent always gets prompt guidance, even on error.
+        if (typeof api.on === "function") {
+            api.on("before_prompt_build", () => {
+                if (cache) {
+                    return {
+                        prependContext: buildBlock({
+                            status: "ready",
+                            toolkits: cache.getToolkits(),
+                            toolCount,
+                        }),
+                    };
+                }
+                return { prependContext: buildBlock(promptState) };
+            });
+        }
+        if (!cfg.apiKey) {
+            promptState = {
+                status: "error",
+                message: "No API key configured. Set plugins.entries.toolforest.config.apiKey " +
+                    "or TOOLFOREST_API_KEY env var.",
+            };
+            api.logger.warn("toolforest: " + promptState.message);
+            return;
+        }
+        const client = new ToolforestClient();
+        try {
+            await client.connect(cfg.remoteUrl, cfg.apiKey);
+            api.logger.info(`toolforest: Connected to ${cfg.remoteUrl}`);
+        }
+        catch (err) {
+            promptState = {
+                status: "error",
+                message: `Failed to connect to ${cfg.remoteUrl}: ${err instanceof Error ? err.message : String(err)}`,
+            };
+            api.logger.warn("toolforest: " + promptState.message);
+            return;
+        }
+        try {
+            const { toolkits, tools } = await client.discoverTools();
+            const bridged = bridgeAllTools(tools, client);
+            toolCount = bridged.length;
+            for (const tool of bridged) {
+                api.registerTool(tool, { name: tool.name });
+            }
+            cache = new ToolkitCache(client, api.logger);
+            cache.seed(toolkits);
+            api.logger.info(`toolforest: Registered ${toolCount} tools from ${toolkits.length} toolkits`);
+        }
+        catch (err) {
+            promptState = {
+                status: "error",
+                message: `Failed to discover tools: ${err instanceof Error ? err.message : String(err)}`,
+            };
+            api.logger.warn("toolforest: " + promptState.message);
+        }
+    },
+};
+export default pluginDefinition;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/src/client.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Toolforest MCP client — connects to the remote Toolforest MCP server,
+ * discovers all connected tools, and forwards execution requests.
+ */
+import type { ToolforestToolDescriptor, ToolforestToolkit, ToolExecutionResult } from "./types.js";
+export declare class ToolforestClient {
+    private client;
+    private transport;
+    /** Cached tool schemas for client-side validation. */
+    private schemaCache;
+    connect(url: string, apiKey: string): Promise<void>;
+    /**
+     * Discover all connected tools by calling the router meta-tools.
+     * 1. list_tools() → get connected toolkit names
+     * 2. list_tools(toolkit=X) for each → get tool descriptors with schemas
+     */
+    discoverTools(): Promise<{
+        toolkits: ToolforestToolkit[];
+        tools: ToolforestToolDescriptor[];
+    }>;
+    /**
+     * Execute a tool on the remote server via the execute_tool meta-tool.
+     * Validates args locally first if schema is cached.
+     */
+    executeTool(toolName: string, args: Record<string, unknown>): Promise<ToolExecutionResult>;
+    /**
+     * Lightweight fetch of connected toolkit metadata only (no tool schemas).
+     * Used by the cache for background refresh.
+     */
+    listToolkits(): Promise<ToolforestToolkit[]>;
+    disconnect(): Promise<void>;
+    private parseJsonResponse;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAGpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAA8C;IAE/D,sDAAsD;IACtD,OAAO,CAAC,WAAW,CAA8C;IAE3D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAezD;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC;QAC7B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAC9B,KAAK,EAAE,wBAAwB,EAAE,CAAC;KACnC,CAAC;IAqCF;;;OAGG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IA0B/B;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAM5C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,OAAO,CAAC,iBAAiB;CAU1B"}

package/dist/src/client.js

@@ -0,0 +1,120 @@
+/**
+ * Toolforest MCP client — connects to the remote Toolforest MCP server,
+ * discovers all connected tools, and forwards execution requests.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { validateArgs } from "./validate.js";
+export class ToolforestClient {
+    client = null;
+    transport = null;
+    /** Cached tool schemas for client-side validation. */
+    schemaCache = new Map();
+    async connect(url, apiKey) {
+        this.transport = new StreamableHTTPClientTransport(new URL(url), {
+            requestInit: {
+                headers: { Authorization: `Bearer ${apiKey}` },
+            },
+        });
+        this.client = new Client({ name: "@toolforest/openclaw-plugin", version: "0.1.0" }, { capabilities: {} });
+        await this.client.connect(this.transport);
+    }
+    /**
+     * Discover all connected tools by calling the router meta-tools.
+     * 1. list_tools() → get connected toolkit names
+     * 2. list_tools(toolkit=X) for each → get tool descriptors with schemas
+     */
+    async discoverTools() {
+        if (!this.client)
+            throw new Error("Not connected");
+        // Step 1: Get connected toolkits
+        const toolkitResult = await this.client.callTool({
+            name: "list_tools",
+            arguments: {},
+        });
+        const toolkits = this.parseJsonResponse(toolkitResult) ?? [];
+        // Step 2: Get tools for each toolkit (parallel)
+        const allTools = [];
+        const results = await Promise.allSettled(toolkits.map(async (toolkit) => {
+            const result = await this.client.callTool({
+                name: "list_tools",
+                arguments: { toolkit: toolkit.name },
+            });
+            return this.parseJsonResponse(result) ?? [];
+        }));
+        for (const result of results) {
+            if (result.status === "fulfilled") {
+                for (const tool of result.value) {
+                    allTools.push(tool);
+                    // Cache schema for validation
+                    if (tool.schema) {
+                        this.schemaCache.set(tool.name, tool.schema);
+                    }
+                }
+            }
+        }
+        return { toolkits, tools: allTools };
+    }
+    /**
+     * Execute a tool on the remote server via the execute_tool meta-tool.
+     * Validates args locally first if schema is cached.
+     */
+    async executeTool(toolName, args) {
+        if (!this.client)
+            throw new Error("Not connected");
+        // Client-side validation
+        const schema = this.schemaCache.get(toolName);
+        if (schema) {
+            const error = validateArgs(args, schema);
+            if (error) {
+                return {
+                    content: [{ type: "text", text: `Validation error: ${error}` }],
+                    isError: true,
+                };
+            }
+        }
+        const result = await this.client.callTool({
+            name: "execute_tool",
+            arguments: { tool_name: toolName, args },
+        });
+        return {
+            content: (result.content ?? []),
+            isError: result.isError,
+        };
+    }
+    /**
+     * Lightweight fetch of connected toolkit metadata only (no tool schemas).
+     * Used by the cache for background refresh.
+     */
+    async listToolkits() {
+        if (!this.client)
+            throw new Error("Not connected");
+        const result = await this.client.callTool({ name: "list_tools", arguments: {} });
+        return this.parseJsonResponse(result) ?? [];
+    }
+    async disconnect() {
+        if (this.client) {
+            try {
+                await this.client.close();
+            }
+            catch {
+                // Ignore close errors
+            }
+            this.client = null;
+        }
+        this.transport = null;
+    }
+    parseJsonResponse(result) {
+        const content = result.content;
+        const textBlock = content?.find((c) => c.type === "text" && c.text);
+        if (!textBlock?.text)
+            return null;
+        try {
+            return JSON.parse(textBlock.text);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAMnG,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,OAAO,gBAAgB;IACnB,MAAM,GAAkB,IAAI,CAAC;IAC7B,SAAS,GAAyC,IAAI,CAAC;IAE/D,sDAAsD;IAC9C,WAAW,GAAG,IAAI,GAAG,EAAmC,CAAC;IAEjE,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,MAAc;QACvC,IAAI,CAAC,SAAS,GAAG,IAAI,6BAA6B,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE;YAC/D,WAAW,EAAE;gBACX,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;aAC/C;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CACtB,EAAE,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,OAAO,EAAE,EACzD,EAAE,YAAY,EAAE,EAAE,EAAE,CACrB,CAAC;QAEF,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa;QAIjB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QAEnD,iCAAiC;QACjC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC/C,IAAI,EAAE,YAAY;YAClB,SAAS,EAAE,EAAE;SACd,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAsB,aAAa,CAAC,IAAI,EAAE,CAAC;QAElF,gDAAgD;QAChD,MAAM,QAAQ,GAA+B,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAO,CAAC,QAAQ,CAAC;gBACzC,IAAI,EAAE,YAAY;gBAClB,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;aACrC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,iBAAiB,CAA6B,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1E,CAAC,CAAC,CACH,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAChC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACpB,8BAA8B;oBAC9B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;wBAChB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC/C,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,QAAgB,EAChB,IAA6B;QAE7B,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QAEnD,yBAAyB;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,KAAK,EAAE,EAAE,CAAC;oBAC/D,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACxC,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;SACzC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAmC;YACjE,OAAO,EAAE,MAAM,CAAC,OAA8B;SAC/C,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC,iBAAiB,CAAsB,MAAM,CAAC,IAAI,EAAE,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;YACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAEO,iBAAiB,CAAI,MAA+C;QAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,OAA6D,CAAC;QACrF,MAAM,SAAS,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,CAAC,SAAS,EAAE,IAAI;YAAE,OAAO,IAAI,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAM,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/src/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resolve Toolforest plugin configuration from plugin config, env vars, and defaults.
+ */
+import type { ToolforestPluginConfig } from "./types.js";
+/**
+ * Resolve the Toolforest connection config.
+ * Priority: pluginConfig > env vars > defaults.
+ */
+export declare function resolveConfig(pluginConfig: Record<string, unknown> | undefined): ToolforestPluginConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAIzD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAChD,sBAAsB,CAcxB"}

package/dist/src/config.js

@@ -0,0 +1,19 @@
+/**
+ * Resolve Toolforest plugin configuration from plugin config, env vars, and defaults.
+ */
+const DEFAULT_URL = "https://mcp.toolforest.io/mcp";
+/**
+ * Resolve the Toolforest connection config.
+ * Priority: pluginConfig > env vars > defaults.
+ */
+export function resolveConfig(pluginConfig) {
+    const cfg = pluginConfig ?? {};
+    const apiKey = cfg.apiKey ??
+        process.env.TOOLFOREST_API_KEY ??
+        "";
+    const remoteUrl = cfg.remoteUrl ??
+        process.env.TOOLFOREST_URL ??
+        DEFAULT_URL;
+    return { apiKey, remoteUrl };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,GAAG,+BAA+B,CAAC;AAEpD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAiD;IAEjD,MAAM,GAAG,GAAG,YAAY,IAAI,EAAE,CAAC;IAE/B,MAAM,MAAM,GACT,GAAG,CAAC,MAA6B;QAClC,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAC9B,EAAE,CAAC;IAEL,MAAM,SAAS,GACZ,GAAG,CAAC,SAAgC;QACrC,OAAO,CAAC,GAAG,CAAC,cAAc;QAC1B,WAAW,CAAC;IAEd,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC"}

package/dist/src/prompt.d.ts

@@ -0,0 +1,7 @@
+import type { PromptState } from "./types.js";
+/**
+ * Build the <toolforest> prompt block based on current plugin state.
+ * Injected via the before_prompt_build hook on every agent turn.
+ */
+export declare function buildBlock(state: PromptState): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/src/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAiCrD"}

package/dist/src/prompt.js

@@ -0,0 +1,37 @@
+/**
+ * Build the <toolforest> prompt block based on current plugin state.
+ * Injected via the before_prompt_build hook on every agent turn.
+ */
+export function buildBlock(state) {
+    if (state.status === "error") {
+        return `<toolforest>
+Toolforest failed to connect.${state.message ? ` Error: ${state.message}` : ""}
+
+Tell the user:
+"Toolforest isn't connected. To fix:
+1. Get your API key from www.toolforest.io
+2. Run: openclaw config set plugins.entries.toolforest.config.apiKey \\"your_key\\"
+3. Run: openclaw gateway restart"
+
+Do NOT fabricate tool names.
+</toolforest>`;
+    }
+    const toolkitLines = state.toolkits
+        .map((t) => `  - ${t.name}: ${t.description ?? "(no description)"}`)
+        .join("\n");
+    return `<toolforest>
+You have ${state.toolCount} Toolforest tools available, prefixed with "toolforest_".
+
+Connected toolkits:
+${toolkitLines}
+
+Rules:
+- Use Toolforest tools for tasks involving the connected services above.
+- Call tools directly by name — no discovery step needed.
+- Do NOT fabricate tool names not listed above.
+- Do NOT use pretrained knowledge about Toolforest APIs.
+- If a tool returns an auth error, direct the user to www.toolforest.io to reconnect.
+- Your API key is at plugins.entries.toolforest.config.apiKey in openclaw.json if needed.
+</toolforest>`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/src/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/prompt.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO;+BACoB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;;;cAShE,CAAC;IACb,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,IAAI,kBAAkB,EAAE,CAAC;SACnE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;WACE,KAAK,CAAC,SAAS;;;EAGxB,YAAY;;;;;;;;;cASA,CAAC;AACf,CAAC"}

package/dist/src/tool-bridge.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Bridge Toolforest tool descriptors into OpenClaw AnyAgentTool format.
+ *
+ * Follows the pattern from openclaw/src/agents/pi-bundle-mcp-tools.ts:
+ * - parameters: raw JSON Schema (TypeBox compiles to JSON Schema at runtime)
+ * - execute: forward to remote server, return { content, details }
+ */
+import type { ToolforestClient } from "./client.js";
+import type { ToolforestToolDescriptor } from "./types.js";
+/** The AnyAgentTool shape OpenClaw expects (from pi-agent-core). */
+export interface BridgedTool {
+    name: string;
+    label: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text?: string;
+            [key: string]: unknown;
+        }>;
+        details?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Convert a Toolforest tool descriptor into an OpenClaw-compatible tool object.
+ */
+export declare function bridgeTool(descriptor: ToolforestToolDescriptor, client: ToolforestClient): BridgedTool;
+/**
+ * Bridge all Toolforest tool descriptors into OpenClaw tools.
+ */
+export declare function bridgeAllTools(descriptors: ToolforestToolDescriptor[], client: ToolforestClient): BridgedTool[];
+//# sourceMappingURL=tool-bridge.d.ts.map

package/dist/src/tool-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bridge.d.ts","sourceRoot":"","sources":["../../src/tool-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,CACP,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC;QACX,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC;QACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,CAAC;CACJ;AA6BD;;GAEG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,wBAAwB,EACpC,MAAM,EAAE,gBAAgB,GACvB,WAAW,CAmBb;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,wBAAwB,EAAE,EACvC,MAAM,EAAE,gBAAgB,GACvB,WAAW,EAAE,CAEf"}

package/dist/src/tool-bridge.js

@@ -0,0 +1,59 @@
+/**
+ * Bridge Toolforest tool descriptors into OpenClaw AnyAgentTool format.
+ *
+ * Follows the pattern from openclaw/src/agents/pi-bundle-mcp-tools.ts:
+ * - parameters: raw JSON Schema (TypeBox compiles to JSON Schema at runtime)
+ * - execute: forward to remote server, return { content, details }
+ */
+/**
+ * Normalize a Toolforest tool name for OpenClaw.
+ * "github-list_repos" → "toolforest_github_list_repos"
+ */
+function normalizeName(toolforestName) {
+    return `toolforest_${toolforestName.replace(/-/g, "_")}`;
+}
+/**
+ * Generate a human-readable label from toolkit and tool names.
+ * "github-list_repos" → "GitHub: List Repos"
+ */
+function generateLabel(toolforestName) {
+    const parts = toolforestName.split("-");
+    const toolkit = parts[0]
+        .split("_")
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+    const action = (parts.slice(1).join("-") || parts[0])
+        .split("_")
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(" ");
+    return `${toolkit}: ${action}`;
+}
+/**
+ * Convert a Toolforest tool descriptor into an OpenClaw-compatible tool object.
+ */
+export function bridgeTool(descriptor, client) {
+    const originalName = descriptor.name;
+    return {
+        name: normalizeName(originalName),
+        label: generateLabel(originalName),
+        description: descriptor.summary || `Toolforest tool: ${originalName}`,
+        parameters: descriptor.schema,
+        execute: async (_toolCallId, params) => {
+            const result = await client.executeTool(originalName, params);
+            return {
+                content: result.content,
+                details: {
+                    toolforestTool: originalName,
+                    ...(result.isError ? { status: "error" } : {}),
+                },
+            };
+        },
+    };
+}
+/**
+ * Bridge all Toolforest tool descriptors into OpenClaw tools.
+ */
+export function bridgeAllTools(descriptors, client) {
+    return descriptors.map((d) => bridgeTool(d, client));
+}
+//# sourceMappingURL=tool-bridge.js.map

package/dist/src/tool-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bridge.js","sourceRoot":"","sources":["../../src/tool-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH;;;GAGG;AACH,SAAS,aAAa,CAAC,cAAsB;IAC3C,OAAO,cAAc,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,cAAsB;IAC3C,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,GAAG,OAAO,KAAK,MAAM,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,UAAoC,EACpC,MAAwB;IAExB,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC;IAErC,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,YAAY,CAAC;QACjC,KAAK,EAAE,aAAa,CAAC,YAAY,CAAC;QAClC,WAAW,EAAE,UAAU,CAAC,OAAO,IAAI,oBAAoB,YAAY,EAAE;QACrE,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAA+B,EAAE,EAAE;YACtE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC9D,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE;oBACP,cAAc,EAAE,YAAY;oBAC5B,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/C;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAuC,EACvC,MAAwB;IAExB,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/src/toolkit-cache.d.ts

@@ -0,0 +1,19 @@
+import type { ToolforestClient } from "./client.js";
+import type { Logger, ToolforestToolkit } from "./types.js";
+export declare class ToolkitCache {
+    private client;
+    private logger;
+    private cachedToolkits;
+    private cachedAt;
+    private fetchPromise;
+    constructor(client: ToolforestClient, logger: Logger);
+    /** Seed with initial data from startup discovery. */
+    seed(toolkits: ToolforestToolkit[]): void;
+    /**
+     * Return current cached toolkits. If stale, triggers a background refresh
+     * (current turn uses stale data, next turn gets fresh data).
+     */
+    getToolkits(): ToolforestToolkit[];
+    private refreshInBackground;
+}
+//# sourceMappingURL=toolkit-cache.d.ts.map

package/dist/src/toolkit-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit-cache.d.ts","sourceRoot":"","sources":["../../src/toolkit-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAI5D,qBAAa,YAAY;IAMrB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAA8B;gBAGxC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM;IAGxB,qDAAqD;IACrD,IAAI,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAKzC;;;OAGG;IACH,WAAW,IAAI,iBAAiB,EAAE;IAOlC,OAAO,CAAC,mBAAmB;CAwB5B"}

package/dist/src/toolkit-cache.js

@@ -0,0 +1,48 @@
+const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+export class ToolkitCache {
+    client;
+    logger;
+    cachedToolkits = [];
+    cachedAt = 0;
+    fetchPromise = null;
+    constructor(client, logger) {
+        this.client = client;
+        this.logger = logger;
+    }
+    /** Seed with initial data from startup discovery. */
+    seed(toolkits) {
+        this.cachedToolkits = toolkits;
+        this.cachedAt = Date.now();
+    }
+    /**
+     * Return current cached toolkits. If stale, triggers a background refresh
+     * (current turn uses stale data, next turn gets fresh data).
+     */
+    getToolkits() {
+        if (Date.now() - this.cachedAt > CACHE_TTL_MS) {
+            this.refreshInBackground();
+        }
+        return this.cachedToolkits;
+    }
+    refreshInBackground() {
+        // In-flight deduplication: only one fetch at a time
+        if (this.fetchPromise)
+            return;
+        this.fetchPromise = this.client
+            .listToolkits()
+            .then((toolkits) => {
+            this.cachedToolkits = toolkits;
+            this.cachedAt = Date.now();
+            this.logger.debug(`toolforest: Refreshed toolkit cache (${toolkits.length} toolkits)`);
+        })
+            .catch((err) => {
+            // Stale data persists — don't hammer on errors
+            this.cachedAt = Date.now();
+            this.logger.warn(`toolforest: Background toolkit refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+        })
+            .finally(() => {
+            this.fetchPromise = null;
+        });
+    }
+}
+//# sourceMappingURL=toolkit-cache.js.map

package/dist/src/toolkit-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolkit-cache.js","sourceRoot":"","sources":["../../src/toolkit-cache.ts"],"names":[],"mappings":"AAGA,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAEhD,MAAM,OAAO,YAAY;IAMb;IACA;IANF,cAAc,GAAwB,EAAE,CAAC;IACzC,QAAQ,GAAG,CAAC,CAAC;IACb,YAAY,GAAyB,IAAI,CAAC;IAElD,YACU,MAAwB,EACxB,MAAc;QADd,WAAM,GAAN,MAAM,CAAkB;QACxB,WAAM,GAAN,MAAM,CAAQ;IACrB,CAAC;IAEJ,qDAAqD;IACrD,IAAI,CAAC,QAA6B;QAChC,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,GAAG,YAAY,EAAE,CAAC;YAC9C,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEO,mBAAmB;QACzB,oDAAoD;QACpD,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAE9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM;aAC5B,YAAY,EAAE;aACd,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACjB,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;YAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,wCAAwC,QAAQ,CAAC,MAAM,YAAY,CACpE,CAAC;QACJ,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,+CAA+C;YAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,kDAAkD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrG,CAAC;QACJ,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC;CACF"}

package/dist/src/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Shared type definitions for the Toolforest OpenClaw plugin.
+ */
+/** Tool descriptor returned by Toolforest list_tools(toolkit=X). */
+export interface ToolforestToolDescriptor {
+    name: string;
+    summary: string;
+    kind: string;
+    schema: Record<string, unknown>;
+}
+/** Toolkit descriptor returned by Toolforest list_tools() (no args). */
+export interface ToolforestToolkit {
+    name: string;
+    description: string;
+}
+/** Resolved plugin configuration. */
+export interface ToolforestPluginConfig {
+    apiKey: string;
+    remoteUrl: string;
+}
+/** Result from executing a tool via the MCP server. */
+export interface ToolExecutionResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    isError?: boolean;
+}
+/** Logger interface (subset of PluginApi.logger). */
+export interface Logger {
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    debug(msg: string): void;
+}
+/** Prompt state for the before_prompt_build hook. */
+export type PromptState = {
+    status: "error";
+    message: string;
+} | {
+    status: "ready";
+    toolkits: ToolforestToolkit[];
+    toolCount: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oEAAoE;AACpE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qCAAqC;AACrC,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uDAAuD;AACvD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qDAAqD;AACrD,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qDAAqD;AACrD,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/src/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared type definitions for the Toolforest OpenClaw plugin.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/validate.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Lightweight JSON Schema validator for tool arguments.
+ *
+ * Catches common mistakes (missing required fields, wrong types, unknown params)
+ * before making the network round-trip. The remote server does full jsonschema
+ * validation as a second layer.
+ *
+ * Inlined from @toolforest/mcp-router to avoid cross-package dependency.
+ */
+/**
+ * Validate args against a JSON Schema. Returns null if valid, or an error message.
+ */
+export declare function validateArgs(args: Record<string, unknown>, schema: Record<string, unknown>): string | null;
+//# sourceMappingURL=validate.d.ts.map

package/dist/src/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,GAAG,IAAI,CAuCf"}

package/dist/src/validate.js

@@ -0,0 +1,85 @@
+/**
+ * Lightweight JSON Schema validator for tool arguments.
+ *
+ * Catches common mistakes (missing required fields, wrong types, unknown params)
+ * before making the network round-trip. The remote server does full jsonschema
+ * validation as a second layer.
+ *
+ * Inlined from @toolforest/mcp-router to avoid cross-package dependency.
+ */
+/**
+ * Validate args against a JSON Schema. Returns null if valid, or an error message.
+ */
+export function validateArgs(args, schema) {
+    const properties = schema.properties;
+    const required = schema.required;
+    // Check required fields
+    if (required) {
+        for (const field of required) {
+            if (!(field in args) || args[field] === undefined) {
+                return `Missing required parameter: '${field}'`;
+            }
+        }
+    }
+    // Check types and constraints of provided fields
+    if (properties) {
+        for (const [key, value] of Object.entries(args)) {
+            const propSchema = properties[key];
+            if (!propSchema) {
+                if (schema.additionalProperties === false) {
+                    return `Unknown parameter: '${key}'`;
+                }
+                continue;
+            }
+            const expectedType = propSchema.type;
+            if (expectedType && value !== null) {
+                const typeErr = checkType(value, expectedType);
+                if (typeErr)
+                    return `Parameter '${key}': ${typeErr}`;
+            }
+            // Enum constraint
+            const enumValues = propSchema.enum;
+            if (enumValues && !enumValues.includes(value)) {
+                return `Parameter '${key}': must be one of: ${enumValues.map(String).join(', ')}`;
+            }
+        }
+    }
+    return null;
+}
+function checkType(value, expectedType) {
+    const types = Array.isArray(expectedType) ? expectedType : [expectedType];
+    for (const t of types) {
+        switch (t) {
+            case 'string':
+                if (typeof value === 'string')
+                    return null;
+                break;
+            case 'number':
+            case 'integer':
+                if (typeof value === 'number')
+                    return null;
+                break;
+            case 'boolean':
+                if (typeof value === 'boolean')
+                    return null;
+                break;
+            case 'array':
+                if (Array.isArray(value))
+                    return null;
+                break;
+            case 'object':
+                if (typeof value === 'object' && value !== null && !Array.isArray(value))
+                    return null;
+                break;
+            case 'null':
+                if (value === null)
+                    return null;
+                break;
+            default:
+                return null; // Unknown type keyword — pass through
+        }
+    }
+    const got = Array.isArray(value) ? 'array' : typeof value;
+    return `expected ${types.join(' | ')}, got ${got}`;
+}
+//# sourceMappingURL=validate.js.map

package/dist/src/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/validate.ts"],"names":[],"mappings":"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"}

package/openclaw.plugin.json

@@ -0,0 +1,33 @@
+{
+  "id": "toolforest",
+  "name": "Toolforest",
+  "description": "Connect all your Toolforest toolkits as native OpenClaw agent tools. Supports 250+ tools across GitHub, Google Sheets, Slack, and more.",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "Toolforest API key (tfo_...)"
+      },
+      "remoteUrl": {
+        "type": "string",
+        "description": "Override the Toolforest MCP endpoint URL"
+      }
+    }
+  },
+  "skills": ["./skills/toolforest-mcp"],
+  "uiHints": {
+    "apiKey": {
+      "label": "Toolforest API Key",
+      "help": "Your Toolforest API key (starts with tfo_). Get one at app.toolforest.io. Fallback: TOOLFOREST_API_KEY env var.",
+      "sensitive": true,
+      "placeholder": "tfo_..."
+    },
+    "remoteUrl": {
+      "label": "Remote URL",
+      "help": "Override the default Toolforest MCP endpoint URL. Leave blank to use the standard URL for your environment.",
+      "advanced": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@toolforest/toolforest-plugin",
+  "version": "0.3.2",
+  "description": "OpenClaw plugin for Toolforest — registers all connected tools as native agent tools",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "skills",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.1"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.0"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "toolforest",
+    "mcp",
+    "ai-tools"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Toolforest-io/toolforest_testing.git",
+    "directory": "packages/openclaw-plugin"
+  }
+}

package/skills/toolforest-mcp/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: toolforest-mcp
+description: Use the Toolforest MCP server directly to call connected toolkit tools when the plugin tools are unavailable or not working.
+metadata:
+  { "openclaw": { "emoji": "🌲", "homepage": "https://www.toolforest.io", "requires": { "bins": ["curl"] } } }
+---
+
+# Toolforest MCP Fallback
+
+## API Key
+
+First check the openclaw config:
+```bash
+grep -A5 '"toolforest"' ~/.openclaw/openclaw.json
+```
+Key is at `plugins.entries.toolforest.config.apiKey`. If missing, direct user to **www.toolforest.io**.
+
+## MCP Server
+
+```
+https://mcp.toolforest.io/mcp
+Authorization: Bearer <apiKey>
+```
+
+## Discover toolkits
+```bash
+curl -s -X POST https://mcp.toolforest.io/mcp \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_KEY" \
+  -d '{"jsonrpc":"2.0","id":"1","method":"tools/call","params":{"name":"list_tools","arguments":{}}}'
+```
+
+## Execute a tool
+```bash
+curl -s -X POST https://mcp.toolforest.io/mcp \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_KEY" \
+  -d '{
+    "jsonrpc": "2.0", "id": "1", "method": "tools/call",
+    "params": { "name": "execute_tool", "arguments": { "tool_name": "TOOL_NAME", "args": {} } }
+  }'
+```
+
+Responses may be SSE (`data: {...}`) or plain JSON — handle both.