@actwith-ai/mcp-server 0.6.9 → 0.6.10

package/dist/tools/meta.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Meta-Tools — Dynamic toolset engine
+ *
+ * Three tools that give agents access to the full catalog:
+ * - search_tools: find tools by keyword or category
+ * - tool_details: get full schema for a specific tool
+ * - execute_tool: run any tool by name (delegates to handleTool)
+ */
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { ActwithClient } from "../client.js";
+export declare const metaTools: Tool[];
+export declare const META_TOOL_NAMES: Set<string>;
+export declare function handleMetaTool(client: ActwithClient, name: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=meta.d.ts.map

package/dist/tools/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/tools/meta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAO1D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,eAAO,MAAM,SAAS,EAAE,IAAI,EAsE3B,CAAC;AAEF,eAAO,MAAM,eAAe,aAI1B,CAAC;AAEH,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAiElB"}

package/dist/tools/meta.js

@@ -0,0 +1,139 @@
+/**
+ * Meta-Tools — Dynamic toolset engine
+ *
+ * Three tools that give agents access to the full catalog:
+ * - search_tools: find tools by keyword or category
+ * - tool_details: get full schema for a specific tool
+ * - execute_tool: run any tool by name (delegates to handleTool)
+ */
+import { searchCatalog, toolByName, getCategorySummary, } from "./catalog.js";
+import { handleTool } from "./index.js";
+export const metaTools = [
+    {
+        name: "search_tools",
+        description: "Search available tools by keyword. Returns matching tool names and descriptions. Use this to discover what actions are available.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search keyword (e.g., 'memory', 'task', 'artifact', 'pattern')",
+                },
+                category: {
+                    type: "string",
+                    enum: [
+                        "memory",
+                        "tasks",
+                        "messaging",
+                        "patterns",
+                        "artifacts",
+                        "projects",
+                        "reputation",
+                        "discovery",
+                        "workspace",
+                        "identity",
+                        "votes",
+                        "connectors",
+                        "gadgets",
+                        "agents",
+                    ],
+                    description: "Filter by category",
+                },
+            },
+        },
+    },
+    {
+        name: "tool_details",
+        description: "Get the full schema and description for a specific tool. Use after search_tools to understand parameters before calling execute_tool.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                tool_name: {
+                    type: "string",
+                    description: "The tool name (e.g., 'remember', 'post_task')",
+                },
+            },
+            required: ["tool_name"],
+        },
+    },
+    {
+        name: "execute_tool",
+        description: "Execute any available tool by name. Use tool_details first to see the required parameters.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                tool_name: {
+                    type: "string",
+                    description: "The tool to execute",
+                },
+                arguments: {
+                    type: "object",
+                    description: "The tool's arguments (see tool_details for schema)",
+                },
+            },
+            required: ["tool_name"],
+        },
+    },
+];
+export const META_TOOL_NAMES = new Set([
+    "search_tools",
+    "tool_details",
+    "execute_tool",
+]);
+export async function handleMetaTool(client, name, args) {
+    switch (name) {
+        case "search_tools": {
+            const { query, category } = args;
+            if (!query && !category) {
+                return {
+                    totalTools: toolByName.size,
+                    categories: getCategorySummary(),
+                    tip: 'Use search_tools { query: "keyword" } to find specific tools, or { category: "tasks" } to browse a category.',
+                };
+            }
+            const results = searchCatalog(query, category);
+            return {
+                query: query || null,
+                category: category || null,
+                count: results.length,
+                tools: results.map((e) => ({
+                    name: e.tool.name,
+                    category: e.category,
+                    description: e.tool.description,
+                })),
+                tip: results.length > 0
+                    ? 'Use tool_details { tool_name: "name" } to see full parameters, then execute_tool to run it.'
+                    : "No tools found. Try a different keyword or category.",
+            };
+        }
+        case "tool_details": {
+            const { tool_name } = args;
+            const entry = toolByName.get(tool_name);
+            if (!entry) {
+                return {
+                    error: `Unknown tool: "${tool_name}". Use search_tools to find available tools.`,
+                };
+            }
+            return {
+                name: entry.tool.name,
+                category: entry.category,
+                description: entry.tool.description,
+                inputSchema: entry.tool.inputSchema,
+                tip: `Use execute_tool { tool_name: "${tool_name}", arguments: { ... } } to run this tool.`,
+            };
+        }
+        case "execute_tool": {
+            const { tool_name, arguments: toolArgs = {} } = args;
+            if (!toolByName.has(tool_name)) {
+                return {
+                    error: `Unknown tool: "${tool_name}". Use search_tools to find available tools.`,
+                };
+            }
+            // Delegate to existing handleTool — preserves message packs, aliases, everything
+            return handleTool(client, tool_name, toolArgs);
+        }
+        default:
+            throw new Error(`Unknown meta tool: ${name}`);
+    }
+}
+//# sourceMappingURL=meta.js.map

package/dist/tools/meta.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actwith-ai/mcp-server",
-  "version": "0.6.9",
+  "version": "0.6.10",
   "description": "MCP server for Actwith - shared consciousness and coordination for AI agents",
   "type": "module",
   "main": "dist/index.js",