@webhooks-cc/mcp 1.23.0 → 2.0.0

package/dist/tools.d.mts

@@ -1,200 +1,3 @@
-import { z } from 'zod';
-import { WebhooksCC, Request, PayloadSchemaFormat, TunnelShareList } from '@webhooks-cc/sdk';
-
-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>): RegisteredToolHandle;
-}
-/** 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;
-}
-/**
- * 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 { LOCAL_ONLY_TOOLS, REMOTE_MAX_WAIT_MS, REMOTE_MIN_POLL_MS, createEndpointShape, deleteEndpointShape, getEndpointShape, getRequestShape, jsonContent, listEndpointsShape, listRequestsShape, payloadSchemaResult, payloadSchemaShape, registerTools, shareHints, textContent, toolWords, waitForRequestShape, withErrorHandling, withShareHints };
-export type { RegisterToolsOptions, RegisteredToolHandle, ToolResult, ToolServer };
+import 'zod';
+import '@webhooks-cc/sdk';
+export { L as LOCAL_ONLY_TOOLS, b as REMOTE_MAX_WAIT_MS, j as REMOTE_MIN_POLL_MS, c as RegisterToolsOptions, R as RegisteredToolHandle, d as TOOL_CATALOG, e as TOOL_GROUPS, f as TOOL_GROUP_NAMES, g as ToolAnnotationsHint, T as ToolGroup, k as ToolResult, a as ToolServer, h as clientLoadsEverything, l as createEndpointShape, i as defaultToolGroups, m as deleteEndpointShape, n as getEndpointShape, o as getRequestShape, q as jsonContent, s as listEndpointsShape, u as listRequestsShape, p as parseToolGroups, v as payloadSchemaResult, w as payloadSchemaShape, r as registerTools, x as shareHints, y as textContent, t as toolAnnotations, z as toolWords, A as waitForRequestShape, B as withErrorHandling, C as withShareHints } from './tools-Bg9zP80n.mjs';

package/dist/tools.d.ts

@@ -1,200 +1,3 @@
-import { z } from 'zod';
-import { WebhooksCC, Request, PayloadSchemaFormat, TunnelShareList } from '@webhooks-cc/sdk';
-
-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>): RegisteredToolHandle;
-}
-/** 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;
-}
-/**
- * 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 { LOCAL_ONLY_TOOLS, REMOTE_MAX_WAIT_MS, REMOTE_MIN_POLL_MS, createEndpointShape, deleteEndpointShape, getEndpointShape, getRequestShape, jsonContent, listEndpointsShape, listRequestsShape, payloadSchemaResult, payloadSchemaShape, registerTools, shareHints, textContent, toolWords, waitForRequestShape, withErrorHandling, withShareHints };
-export type { RegisterToolsOptions, RegisteredToolHandle, ToolResult, ToolServer };
+import 'zod';
+import '@webhooks-cc/sdk';
+export { L as LOCAL_ONLY_TOOLS, b as REMOTE_MAX_WAIT_MS, j as REMOTE_MIN_POLL_MS, c as RegisterToolsOptions, R as RegisteredToolHandle, d as TOOL_CATALOG, e as TOOL_GROUPS, f as TOOL_GROUP_NAMES, g as ToolAnnotationsHint, T as ToolGroup, k as ToolResult, a as ToolServer, h as clientLoadsEverything, l as createEndpointShape, i as defaultToolGroups, m as deleteEndpointShape, n as getEndpointShape, o as getRequestShape, q as jsonContent, s as listEndpointsShape, u as listRequestsShape, p as parseToolGroups, v as payloadSchemaResult, w as payloadSchemaShape, r as registerTools, x as shareHints, y as textContent, t as toolAnnotations, z as toolWords, A as waitForRequestShape, B as withErrorHandling, C as withShareHints } from './tools-Bg9zP80n.js';