@webhooks-cc/mcp 1.14.0 → 1.15.0

package/dist/index.d.mts

@@ -1,8 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { REMOTE_MAX_WAIT_MS, RegisterToolsOptions, RegisteredToolHandle, ToolServer, registerTools } from './tools.mjs';
 import { WebhooksCC } from '@webhooks-cc/sdk';
-
-/** Register all webhook tools on an MCP server instance. */
-declare function registerTools(server: McpServer, client: WebhooksCC): void;
+import 'zod';
 
 interface SandboxToolOptions {
     /** API base URL (default: WHK_BASE_URL or https://webhooks.cc). */
@@ -11,14 +10,21 @@ interface SandboxToolOptions {
     webhookUrl?: string;
     /** The agent's name, shown to the human as self-reported. */
     clientName?: string;
-    /** Called once a human has connected the agent, with a client for their account. */
+    /**
+     * The agent credential file (default: WHK_AGENT_FILE, else
+     * ~/.config/whk/agent.json or the platform's equivalent); false keeps the
+     * sandbox and the connection in memory, for this process only.
+     */
+    credentialsFile?: string | false;
+    /** Called whenever the tools switch to a human's account, with a client for it. */
     onConnected?: (client: WebhooksCC) => void;
 }
 /**
- * Registers the sandbox tools (create_endpoint, list_endpoints,
- * get_endpoint, delete_endpoint, list_requests, get_request,
- * wait_for_request) and connect_account, wait_for_connection and
- * about_sandbox.
+ * Registers the agent tools: the full tools when the credential file holds a
+ * live connection to a human's account, else the sandbox tools
+ * (create_endpoint, list_endpoints, get_endpoint, delete_endpoint,
+ * list_requests, get_request, wait_for_request, generate_payload_schema) with
+ * connect_account, wait_for_connection and about_sandbox.
  */
 declare function registerSandboxTools(server: McpServer, options?: SandboxToolOptions): void;
 /**
@@ -38,6 +44,12 @@ interface CreateServerOptions {
     webhookUrl?: string;
     /** Custom API base URL (default: https://webhooks.cc) */
     baseUrl?: string;
+    /**
+     * Without an API key: the agent credential file that keeps the sandbox and
+     * a human's connection across restarts (default: WHK_AGENT_FILE, else
+     * ~/.config/whk/agent.json or the platform's equivalent); false for none.
+     */
+    credentialsFile?: string | false;
 }
 /**
  * Create an MCP server with all webhooks.cc tools, prompts, and resources registered.
@@ -53,5 +65,5 @@ interface CreateServerOptions {
  */
 declare function createServer(options?: CreateServerOptions): McpServer;
 
-export { createServer, registerAgentRegistrationTools, registerPrompts, registerResources, registerSandboxTools, registerTools };
+export { createServer, registerAgentRegistrationTools, registerPrompts, registerResources, registerSandboxTools };
 export type { CreateServerOptions, SandboxToolOptions };

package/dist/index.d.ts

@@ -1,8 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export { REMOTE_MAX_WAIT_MS, RegisterToolsOptions, RegisteredToolHandle, ToolServer, registerTools } from './tools.js';
 import { WebhooksCC } from '@webhooks-cc/sdk';
-
-/** Register all webhook tools on an MCP server instance. */
-declare function registerTools(server: McpServer, client: WebhooksCC): void;
+import 'zod';
 
 interface SandboxToolOptions {
     /** API base URL (default: WHK_BASE_URL or https://webhooks.cc). */
@@ -11,14 +10,21 @@ interface SandboxToolOptions {
     webhookUrl?: string;
     /** The agent's name, shown to the human as self-reported. */
     clientName?: string;
-    /** Called once a human has connected the agent, with a client for their account. */
+    /**
+     * The agent credential file (default: WHK_AGENT_FILE, else
+     * ~/.config/whk/agent.json or the platform's equivalent); false keeps the
+     * sandbox and the connection in memory, for this process only.
+     */
+    credentialsFile?: string | false;
+    /** Called whenever the tools switch to a human's account, with a client for it. */
     onConnected?: (client: WebhooksCC) => void;
 }
 /**
- * Registers the sandbox tools (create_endpoint, list_endpoints,
- * get_endpoint, delete_endpoint, list_requests, get_request,
- * wait_for_request) and connect_account, wait_for_connection and
- * about_sandbox.
+ * Registers the agent tools: the full tools when the credential file holds a
+ * live connection to a human's account, else the sandbox tools
+ * (create_endpoint, list_endpoints, get_endpoint, delete_endpoint,
+ * list_requests, get_request, wait_for_request, generate_payload_schema) with
+ * connect_account, wait_for_connection and about_sandbox.
  */
 declare function registerSandboxTools(server: McpServer, options?: SandboxToolOptions): void;
 /**
@@ -38,6 +44,12 @@ interface CreateServerOptions {
     webhookUrl?: string;
     /** Custom API base URL (default: https://webhooks.cc) */
     baseUrl?: string;
+    /**
+     * Without an API key: the agent credential file that keeps the sandbox and
+     * a human's connection across restarts (default: WHK_AGENT_FILE, else
+     * ~/.config/whk/agent.json or the platform's equivalent); false for none.
+     */
+    credentialsFile?: string | false;
 }
 /**
  * Create an MCP server with all webhooks.cc tools, prompts, and resources registered.
@@ -53,5 +65,5 @@ interface CreateServerOptions {
  */
 declare function createServer(options?: CreateServerOptions): McpServer;
 
-export { createServer, registerAgentRegistrationTools, registerPrompts, registerResources, registerSandboxTools, registerTools };
+export { createServer, registerAgentRegistrationTools, registerPrompts, registerResources, registerSandboxTools };
 export type { CreateServerOptions, SandboxToolOptions };