@webhooks-cc/mcp 1.23.0 → 2.0.0

package/dist/tools-Bg9zP80n.d.mts

@@ -0,0 +1,276 @@
+import { z } from 'zod';
+import { WebhooksCC, Request, PayloadSchemaFormat, TunnelShareList } from '@webhooks-cc/sdk';
+
+/**
+ * Every tool's group and behaviour hints, in one place. registerTools()
+ * reads it for each tool it registers: the group decides whether a server
+ * loads the tool (see TOOL_GROUPS), and the hints become the tool's MCP
+ * annotations, so a client can tell reads from changes and changes from
+ * deletions without guessing from the name. A test fails when a registered
+ * tool has no entry here, or an entry names no tool.
+ */
+/**
+ * The groups past the core. "core" is what every server loads unless told
+ * otherwise; the rest load on request (WHK_MCP_TOOLS, ?tools= on the hosted
+ * server, or enable_tools on a local one) or for clients that load tools on
+ * demand themselves.
+ */
+declare const TOOL_GROUPS: {
+    readonly core: "Endpoints, captured requests and emails, sending test webhooks, signatures, forwarding destinations, deliveries, previews of your local app and their logs, usage and approvals";
+    readonly forwarding: "The rest of forwarding: preview what a destination would send, the endpoint's forwarding settings and signing secret, test deliveries";
+    readonly layouts: "Email layouts and named fields: try layouts and fields on a captured email, add ready-made layouts, and AI setup";
+    readonly extras: "Bulk endpoint changes, favourites, request counts and payload schemas";
+    readonly teams: "Teams: members, invites, sharing endpoints with a team, and pricing team changes";
+    readonly account: "The account: billing, API keys, connected agents, public share links to requests, and the display name";
+    readonly domains: "Custom inbound email domains: add, verify, route and remove them";
+    readonly sheets: "Google Sheets destinations: Google accounts, spreadsheets and their tabs";
+    readonly names: "Preview names: reserve, release and password-protect them";
+};
+type ToolGroup = keyof typeof TOOL_GROUPS;
+declare const TOOL_GROUP_NAMES: ToolGroup[];
+/** What a tool does, as MCP's tool annotations describe it. */
+interface Behaviour {
+    /** Changes nothing anywhere. */
+    readOnly?: true;
+    /** Removes or gives up something that is not simply put back. */
+    destructive?: true;
+    /** Calling it again with the same arguments changes nothing more. */
+    idempotent?: true;
+    /** Reaches past webhooks.cc: a URL you name, an email inbox, Google, Anthropic. */
+    openWorld?: true;
+}
+interface CatalogEntry extends Behaviour {
+    group: ToolGroup;
+}
+declare const TOOL_CATALOG: Record<string, CatalogEntry>;
+/** The tool that loads more groups on a local server; always loaded there. */
+declare const ENABLE_TOOLS = "enable_tools";
+/** MCP tool annotations for a catalogued tool. */
+declare function toolAnnotations(name: string): {
+    title: string;
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+};
+/**
+ * Which groups a server loads, from a setting such as "all", "core,teams" or
+ * "core+teams". Unknown names are reported so the caller can say so; an
+ * empty setting is the default. "core" is always loaded.
+ */
+declare function parseToolGroups(setting: string | null | undefined): {
+    groups: Set<ToolGroup>;
+    unknown: string[];
+} | null;
+declare function clientLoadsEverything(clientName: string | undefined): boolean;
+/** The groups for a server: the setting when there is one, else by client. */
+declare function defaultToolGroups(clientName: string | undefined): Set<ToolGroup>;
+
+declare const createEndpointShape: {
+    name: z.ZodOptional<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    expiresIn: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    mockResponse: z.ZodOptional<z.ZodObject<{
+        status: z.ZodNumber;
+        body: z.ZodDefault<z.ZodString>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        delay: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    responseRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        logic: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            and: "and";
+            or: "or";
+        }>>>;
+        conditions: z.ZodArray<z.ZodObject<{
+            field: z.ZodEnum<{
+                body: "body";
+                method: "method";
+                path: "path";
+                header: "header";
+                query: "query";
+                body_contains: "body_contains";
+                body_path: "body_path";
+                content_type: "content_type";
+                size: "size";
+                kind: "kind";
+                email: "email";
+                email_field: "email_field";
+                spam_score: "spam_score";
+                email_auth: "email_auth";
+                signature: "signature";
+            }>;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                contains: "contains";
+                not_contains: "not_contains";
+                starts_with: "starts_with";
+                ends_with: "ends_with";
+                matches: "matches";
+                regex: "regex";
+                exists: "exists";
+                not_exists: "not_exists";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+            }>;
+            value: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        response: z.ZodLazy<z.ZodObject<{
+            status: z.ZodNumber;
+            body: z.ZodDefault<z.ZodString>;
+            headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            delay: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    notificationUrl: z.ZodOptional<z.ZodString>;
+    site: z.ZodOptional<z.ZodEnum<{
+        webhooks: "webhooks";
+        mailhooks: "mailhooks";
+        both: "both";
+    }>>;
+    signingProvider: z.ZodOptional<z.ZodString>;
+    signingSecret: z.ZodOptional<z.ZodString>;
+    signingHeader: z.ZodOptional<z.ZodString>;
+};
+declare const listEndpointsShape: {
+    team: z.ZodOptional<z.ZodString>;
+};
+declare const getEndpointShape: {
+    slug: z.ZodString;
+};
+declare const deleteEndpointShape: {
+    slug: z.ZodString;
+};
+declare const listRequestsShape: {
+    endpointSlug: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    since: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        http: "http";
+    }>>;
+};
+declare const getRequestShape: {
+    requestId: z.ZodString;
+};
+declare const waitForRequestShape: {
+    endpointSlug: z.ZodString;
+    timeout: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    pollInterval: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+};
+declare const payloadSchemaShape: {
+    endpointSlug: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<{
+        typescript: "typescript";
+        zod: "zod";
+        pydantic: "pydantic";
+        "json-schema": "json-schema";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+    event: z.ZodOptional<z.ZodString>;
+    method: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    requestIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type PayloadSchemaArgs = {
+    format: PayloadSchemaFormat;
+    name?: string;
+    event?: string;
+    method?: string;
+    path?: string;
+};
+/**
+ * generate_payload_schema for the full and the sandbox tools: filter the
+ * requests, learn one schema from their bodies, and say what it was built
+ * from, warning when several events were mixed.
+ */
+declare function payloadSchemaResult(requests: Request[], args: PayloadSchemaArgs): ToolResult;
+type TextContent = {
+    type: "text";
+    text: string;
+};
+type ToolResult = {
+    content: TextContent[];
+    isError?: boolean;
+};
+declare function textContent(text: string): ToolResult;
+declare function jsonContent(value: unknown): ToolResult;
+/** Wrap a tool handler with error handling that returns structured MCP errors. */
+declare function withErrorHandling<T>(handler: (args: T) => Promise<ToolResult>): (args: T) => Promise<ToolResult>;
+/** Register all webhook tools on an MCP server instance. */
+/**
+ * What registerTools needs from a server: the stdio server's McpServer has
+ * it, and the hosted server at webhooks.cc/mcp adapts its own to it, so both
+ * serve the same tools.
+ */
+interface ToolServer {
+    tool<Shape extends z.ZodRawShape>(name: string, description: string, shape: Shape, handler: (args: z.infer<z.ZodObject<Shape>>) => Promise<ToolResult>, 
+    /** MCP tool annotations (catalog.ts), set by registerTools for every tool. */
+    annotations?: ToolAnnotationsHint): RegisteredToolHandle;
+}
+/** MCP tool annotations as registerTools passes them on. */
+type ToolAnnotationsHint = ReturnType<typeof toolAnnotations>;
+/** A registered tool, removable when the tool set is swapped. */
+interface RegisteredToolHandle {
+    remove(): void;
+}
+interface RegisterToolsOptions {
+    /**
+     * The hosted server (webhooks.cc/mcp): leave out the tools that send to a
+     * URL the caller names, which would run from webhooks.cc's network and
+     * could never reach the caller's machine anyway, refuse targetUrl on the
+     * others, and cap waits below the proxy's timeout.
+     */
+    remote?: boolean;
+    /**
+     * The tool groups to register (catalog.ts). Default: every group, as before
+     * groups existed; the servers choose (WHK_MCP_TOOLS, ?tools=, the client).
+     */
+    groups?: ReadonlySet<ToolGroup>;
+    /** Register only the tools that change nothing (readOnlyHint). */
+    readOnly?: boolean;
+}
+/**
+ * Tools that only make sense next to the caller: they post to a URL of the
+ * caller's choosing, or (share_port) run the whk CLI on the caller's machine.
+ */
+declare const LOCAL_ONLY_TOOLS: Set<string>;
+/** Longest wait on the hosted server; Cloudflare ends a request after 100 seconds. */
+declare const REMOTE_MAX_WAIT_MS = 50000;
+/** Shortest poll interval on the hosted server: each poll is an API request. */
+declare const REMOTE_MIN_POLL_MS = 1000;
+/**
+ * What an agent can do about the account's sharing limits, from a share
+ * list: the next step when slots or data run out, so it never has to send
+ * the person to the dashboard. `remote` for the hosted server, which has no
+ * share_port.
+ */
+declare function shareHints(list: TunnelShareList, remote?: boolean): string[];
+/**
+ * A server hint in this server's words: the whk commands it names become
+ * the tools that do the same, so an agent does not reach for a CLI. On the
+ * hosted server (`remote`) `whk share` stays a command for the person's
+ * computer, since that server has no share_port.
+ */
+declare function toolWords(hint: string, remote?: boolean): string;
+/**
+ * A share list with hints for an agent, for list_shares and share_port: the
+ * server's own (in tool words) and this server's, without repeats, so
+ * nothing the server says (a suspension, a pause) is lost.
+ */
+declare function withShareHints(list: TunnelShareList, remote?: boolean): Record<string, unknown>;
+/**
+ * Registers the webhooks.cc tools for an account client. Returns their
+ * handles, so a caller can swap the tool set later.
+ */
+declare function registerTools(target: ToolServer, client: WebhooksCC, options?: RegisterToolsOptions): RegisteredToolHandle[];
+
+export { waitForRequestShape as A, withErrorHandling as B, withShareHints as C, ENABLE_TOOLS as E, LOCAL_ONLY_TOOLS as L, REMOTE_MAX_WAIT_MS as b, TOOL_CATALOG as d, TOOL_GROUPS as e, TOOL_GROUP_NAMES as f, clientLoadsEverything as h, defaultToolGroups as i, REMOTE_MIN_POLL_MS as j, createEndpointShape as l, deleteEndpointShape as m, getEndpointShape as n, getRequestShape as o, parseToolGroups as p, jsonContent as q, registerTools as r, listEndpointsShape as s, toolAnnotations as t, listRequestsShape as u, payloadSchemaResult as v, payloadSchemaShape as w, shareHints as x, textContent as y, toolWords as z };
+export type { RegisteredToolHandle as R, ToolGroup as T, ToolServer as a, RegisterToolsOptions as c, ToolAnnotationsHint as g, ToolResult as k };

package/dist/tools-Bg9zP80n.d.ts

@@ -0,0 +1,276 @@
+import { z } from 'zod';
+import { WebhooksCC, Request, PayloadSchemaFormat, TunnelShareList } from '@webhooks-cc/sdk';
+
+/**
+ * Every tool's group and behaviour hints, in one place. registerTools()
+ * reads it for each tool it registers: the group decides whether a server
+ * loads the tool (see TOOL_GROUPS), and the hints become the tool's MCP
+ * annotations, so a client can tell reads from changes and changes from
+ * deletions without guessing from the name. A test fails when a registered
+ * tool has no entry here, or an entry names no tool.
+ */
+/**
+ * The groups past the core. "core" is what every server loads unless told
+ * otherwise; the rest load on request (WHK_MCP_TOOLS, ?tools= on the hosted
+ * server, or enable_tools on a local one) or for clients that load tools on
+ * demand themselves.
+ */
+declare const TOOL_GROUPS: {
+    readonly core: "Endpoints, captured requests and emails, sending test webhooks, signatures, forwarding destinations, deliveries, previews of your local app and their logs, usage and approvals";
+    readonly forwarding: "The rest of forwarding: preview what a destination would send, the endpoint's forwarding settings and signing secret, test deliveries";
+    readonly layouts: "Email layouts and named fields: try layouts and fields on a captured email, add ready-made layouts, and AI setup";
+    readonly extras: "Bulk endpoint changes, favourites, request counts and payload schemas";
+    readonly teams: "Teams: members, invites, sharing endpoints with a team, and pricing team changes";
+    readonly account: "The account: billing, API keys, connected agents, public share links to requests, and the display name";
+    readonly domains: "Custom inbound email domains: add, verify, route and remove them";
+    readonly sheets: "Google Sheets destinations: Google accounts, spreadsheets and their tabs";
+    readonly names: "Preview names: reserve, release and password-protect them";
+};
+type ToolGroup = keyof typeof TOOL_GROUPS;
+declare const TOOL_GROUP_NAMES: ToolGroup[];
+/** What a tool does, as MCP's tool annotations describe it. */
+interface Behaviour {
+    /** Changes nothing anywhere. */
+    readOnly?: true;
+    /** Removes or gives up something that is not simply put back. */
+    destructive?: true;
+    /** Calling it again with the same arguments changes nothing more. */
+    idempotent?: true;
+    /** Reaches past webhooks.cc: a URL you name, an email inbox, Google, Anthropic. */
+    openWorld?: true;
+}
+interface CatalogEntry extends Behaviour {
+    group: ToolGroup;
+}
+declare const TOOL_CATALOG: Record<string, CatalogEntry>;
+/** The tool that loads more groups on a local server; always loaded there. */
+declare const ENABLE_TOOLS = "enable_tools";
+/** MCP tool annotations for a catalogued tool. */
+declare function toolAnnotations(name: string): {
+    title: string;
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+};
+/**
+ * Which groups a server loads, from a setting such as "all", "core,teams" or
+ * "core+teams". Unknown names are reported so the caller can say so; an
+ * empty setting is the default. "core" is always loaded.
+ */
+declare function parseToolGroups(setting: string | null | undefined): {
+    groups: Set<ToolGroup>;
+    unknown: string[];
+} | null;
+declare function clientLoadsEverything(clientName: string | undefined): boolean;
+/** The groups for a server: the setting when there is one, else by client. */
+declare function defaultToolGroups(clientName: string | undefined): Set<ToolGroup>;
+
+declare const createEndpointShape: {
+    name: z.ZodOptional<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    expiresIn: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    mockResponse: z.ZodOptional<z.ZodObject<{
+        status: z.ZodNumber;
+        body: z.ZodDefault<z.ZodString>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        delay: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    responseRules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        logic: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            and: "and";
+            or: "or";
+        }>>>;
+        conditions: z.ZodArray<z.ZodObject<{
+            field: z.ZodEnum<{
+                body: "body";
+                method: "method";
+                path: "path";
+                header: "header";
+                query: "query";
+                body_contains: "body_contains";
+                body_path: "body_path";
+                content_type: "content_type";
+                size: "size";
+                kind: "kind";
+                email: "email";
+                email_field: "email_field";
+                spam_score: "spam_score";
+                email_auth: "email_auth";
+                signature: "signature";
+            }>;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                contains: "contains";
+                not_contains: "not_contains";
+                starts_with: "starts_with";
+                ends_with: "ends_with";
+                matches: "matches";
+                regex: "regex";
+                exists: "exists";
+                not_exists: "not_exists";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+            }>;
+            value: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        response: z.ZodLazy<z.ZodObject<{
+            status: z.ZodNumber;
+            body: z.ZodDefault<z.ZodString>;
+            headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            delay: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    notificationUrl: z.ZodOptional<z.ZodString>;
+    site: z.ZodOptional<z.ZodEnum<{
+        webhooks: "webhooks";
+        mailhooks: "mailhooks";
+        both: "both";
+    }>>;
+    signingProvider: z.ZodOptional<z.ZodString>;
+    signingSecret: z.ZodOptional<z.ZodString>;
+    signingHeader: z.ZodOptional<z.ZodString>;
+};
+declare const listEndpointsShape: {
+    team: z.ZodOptional<z.ZodString>;
+};
+declare const getEndpointShape: {
+    slug: z.ZodString;
+};
+declare const deleteEndpointShape: {
+    slug: z.ZodString;
+};
+declare const listRequestsShape: {
+    endpointSlug: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    since: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        email: "email";
+        http: "http";
+    }>>;
+};
+declare const getRequestShape: {
+    requestId: z.ZodString;
+};
+declare const waitForRequestShape: {
+    endpointSlug: z.ZodString;
+    timeout: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    pollInterval: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+};
+declare const payloadSchemaShape: {
+    endpointSlug: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<{
+        typescript: "typescript";
+        zod: "zod";
+        pydantic: "pydantic";
+        "json-schema": "json-schema";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+    event: z.ZodOptional<z.ZodString>;
+    method: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    requestIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+type PayloadSchemaArgs = {
+    format: PayloadSchemaFormat;
+    name?: string;
+    event?: string;
+    method?: string;
+    path?: string;
+};
+/**
+ * generate_payload_schema for the full and the sandbox tools: filter the
+ * requests, learn one schema from their bodies, and say what it was built
+ * from, warning when several events were mixed.
+ */
+declare function payloadSchemaResult(requests: Request[], args: PayloadSchemaArgs): ToolResult;
+type TextContent = {
+    type: "text";
+    text: string;
+};
+type ToolResult = {
+    content: TextContent[];
+    isError?: boolean;
+};
+declare function textContent(text: string): ToolResult;
+declare function jsonContent(value: unknown): ToolResult;
+/** Wrap a tool handler with error handling that returns structured MCP errors. */
+declare function withErrorHandling<T>(handler: (args: T) => Promise<ToolResult>): (args: T) => Promise<ToolResult>;
+/** Register all webhook tools on an MCP server instance. */
+/**
+ * What registerTools needs from a server: the stdio server's McpServer has
+ * it, and the hosted server at webhooks.cc/mcp adapts its own to it, so both
+ * serve the same tools.
+ */
+interface ToolServer {
+    tool<Shape extends z.ZodRawShape>(name: string, description: string, shape: Shape, handler: (args: z.infer<z.ZodObject<Shape>>) => Promise<ToolResult>, 
+    /** MCP tool annotations (catalog.ts), set by registerTools for every tool. */
+    annotations?: ToolAnnotationsHint): RegisteredToolHandle;
+}
+/** MCP tool annotations as registerTools passes them on. */
+type ToolAnnotationsHint = ReturnType<typeof toolAnnotations>;
+/** A registered tool, removable when the tool set is swapped. */
+interface RegisteredToolHandle {
+    remove(): void;
+}
+interface RegisterToolsOptions {
+    /**
+     * The hosted server (webhooks.cc/mcp): leave out the tools that send to a
+     * URL the caller names, which would run from webhooks.cc's network and
+     * could never reach the caller's machine anyway, refuse targetUrl on the
+     * others, and cap waits below the proxy's timeout.
+     */
+    remote?: boolean;
+    /**
+     * The tool groups to register (catalog.ts). Default: every group, as before
+     * groups existed; the servers choose (WHK_MCP_TOOLS, ?tools=, the client).
+     */
+    groups?: ReadonlySet<ToolGroup>;
+    /** Register only the tools that change nothing (readOnlyHint). */
+    readOnly?: boolean;
+}
+/**
+ * Tools that only make sense next to the caller: they post to a URL of the
+ * caller's choosing, or (share_port) run the whk CLI on the caller's machine.
+ */
+declare const LOCAL_ONLY_TOOLS: Set<string>;
+/** Longest wait on the hosted server; Cloudflare ends a request after 100 seconds. */
+declare const REMOTE_MAX_WAIT_MS = 50000;
+/** Shortest poll interval on the hosted server: each poll is an API request. */
+declare const REMOTE_MIN_POLL_MS = 1000;
+/**
+ * What an agent can do about the account's sharing limits, from a share
+ * list: the next step when slots or data run out, so it never has to send
+ * the person to the dashboard. `remote` for the hosted server, which has no
+ * share_port.
+ */
+declare function shareHints(list: TunnelShareList, remote?: boolean): string[];
+/**
+ * A server hint in this server's words: the whk commands it names become
+ * the tools that do the same, so an agent does not reach for a CLI. On the
+ * hosted server (`remote`) `whk share` stays a command for the person's
+ * computer, since that server has no share_port.
+ */
+declare function toolWords(hint: string, remote?: boolean): string;
+/**
+ * A share list with hints for an agent, for list_shares and share_port: the
+ * server's own (in tool words) and this server's, without repeats, so
+ * nothing the server says (a suspension, a pause) is lost.
+ */
+declare function withShareHints(list: TunnelShareList, remote?: boolean): Record<string, unknown>;
+/**
+ * Registers the webhooks.cc tools for an account client. Returns their
+ * handles, so a caller can swap the tool set later.
+ */
+declare function registerTools(target: ToolServer, client: WebhooksCC, options?: RegisterToolsOptions): RegisteredToolHandle[];
+
+export { waitForRequestShape as A, withErrorHandling as B, withShareHints as C, ENABLE_TOOLS as E, LOCAL_ONLY_TOOLS as L, REMOTE_MAX_WAIT_MS as b, TOOL_CATALOG as d, TOOL_GROUPS as e, TOOL_GROUP_NAMES as f, clientLoadsEverything as h, defaultToolGroups as i, REMOTE_MIN_POLL_MS as j, createEndpointShape as l, deleteEndpointShape as m, getEndpointShape as n, getRequestShape as o, parseToolGroups as p, jsonContent as q, registerTools as r, listEndpointsShape as s, toolAnnotations as t, listRequestsShape as u, payloadSchemaResult as v, payloadSchemaShape as w, shareHints as x, textContent as y, toolWords as z };
+export type { RegisteredToolHandle as R, ToolGroup as T, ToolServer as a, RegisterToolsOptions as c, ToolAnnotationsHint as g, ToolResult as k };