@superblocksteam/sdk-api 0.0.14 → 0.0.15-mcp.2

package/dist/integrations/mcpintegration/client.test.js

@@ -0,0 +1,432 @@
+/**
+ * Tests for McpClientImpl.
+ *
+ * Validates:
+ * - callTool() builds the MCP step request: a tools/call JSON-RPC request
+ *   with a params object, a per-call id, optional headers as Property
+ *   entries, and the label as trace metadata.
+ * - The session the plugin returns is sent back as headers on later calls
+ *   and on later tools/list pages, and never reaches API code.
+ * - callTool() returns the CallToolResult without a schema, validates
+ *   structuredContent or the first text block with one, and maps isError
+ *   results to IntegrationError.
+ * - listTools() follows nextCursor, rejects malformed entries, and gives up
+ *   on a repeated cursor or too many pages.
+ */
+import { describe, it, expect, expectTypeOf, vi } from "vitest";
+import { z } from "zod";
+import { RestApiValidationError } from "../../errors.js";
+import { IntegrationError } from "../../runtime/errors.js";
+import { McpClientImpl, McpToolUnavailableError } from "./client.js";
+const TEST_CONFIG = {
+    id: "mcpintegration-test-id",
+    name: "Test MCP",
+    pluginId: "mcpintegration",
+    configuration: {},
+};
+function createClient(...results) {
+    const executeQuery = vi.fn();
+    for (const result of results) {
+        executeQuery.mockResolvedValueOnce(result);
+    }
+    const client = new McpClientImpl(TEST_CONFIG, executeQuery);
+    return { client, executeQuery };
+}
+function textResult(text, extra = {}) {
+    return { content: [{ type: "text", text }], ...extra };
+}
+function toolsPage(names, nextCursor) {
+    return {
+        tools: names.map((name) => ({ name, inputSchema: { type: "object" } })),
+        ...(nextCursor ? { nextCursor } : {}),
+    };
+}
+const StepHeadersSchema = z
+    .object({
+    headers: z
+        .array(z.object({ key: z.string(), value: z.string() }))
+        .optional(),
+})
+    .passthrough();
+function headersOf(call) {
+    const { headers } = StepHeadersSchema.parse(call[0]);
+    return headers
+        ? Object.fromEntries(headers.map((h) => [h.key, h.value]))
+        : undefined;
+}
+function integrationError(error) {
+    if (!(error instanceof IntegrationError)) {
+        throw error;
+    }
+    return error;
+}
+describe("McpClientImpl", () => {
+    describe("callTool()", () => {
+        it("sends proxied tool arguments as cloneable data", async () => {
+            const { client, executeQuery } = createClient(textResult("ok"));
+            await client.callTool("echo", new Proxy({ message: "hi" }, {}));
+            const [request] = executeQuery.mock.calls[0];
+            expect(structuredClone(request).request.params.arguments).toEqual({
+                message: "hi",
+            });
+        });
+        it("rejects circular tool arguments with an IntegrationError", async () => {
+            const { client, executeQuery } = createClient();
+            const args = {};
+            args.self = args;
+            const error = await client
+                .callTool("echo", args)
+                .catch((e) => e);
+            expect(integrationError(error).details).toMatchObject({
+                cause: 'Tool "echo" arguments are not JSON-serializable: the arguments object contains a circular reference',
+            });
+            expect(executeQuery).not.toHaveBeenCalled();
+        });
+        it("builds a tools/call request with params, headers, and label", async () => {
+            const { client, executeQuery } = createClient(textResult("ok"), textResult("ok"));
+            await client.callTool("echo", { message: "hi" }, { label: "Echo it", headers: { "Mcp-Param-Org": "acme" } });
+            await client.callTool("echo");
+            const [firstRequest, firstBindings, firstMetadata] = executeQuery.mock.calls[0];
+            expect(firstRequest.request.method).toBe("tools/call");
+            expect(firstRequest.request.params).toEqual({
+                name: "echo",
+                arguments: { message: "hi" },
+            });
+            expect(firstRequest.headers).toEqual([
+                { key: "Mcp-Param-Org", value: "acme" },
+            ]);
+            expect(firstRequest.clientCapabilities).toBeUndefined();
+            expect(firstBindings).toBeUndefined();
+            expect(firstMetadata).toEqual({ label: "Echo it" });
+            const [secondRequest, , secondMetadata] = executeQuery.mock.calls[1];
+            expect(secondRequest.request.params).toEqual({
+                name: "echo",
+                arguments: {},
+            });
+            expect(secondRequest).not.toHaveProperty("headers");
+            expect(secondMetadata).toBeUndefined();
+            expect(secondRequest.request.id).not.toEqual(firstRequest.request.id);
+        });
+        it("types the return as T with a schema and CallToolResult without", () => {
+            // Wrapped in arrows so the overloads resolve at compile time without
+            // invoking callTool (an unawaited call would reject and leak).
+            const { client } = createClient();
+            const viaInterface = client;
+            const schema = z.object({ count: z.number() });
+            expectTypeOf(() => viaInterface.callTool("echo", {}, { schema })).returns.resolves.toEqualTypeOf();
+            expectTypeOf(() => viaInterface.callTool("echo")).returns.resolves.toEqualTypeOf();
+            expectTypeOf(() => client.callTool("echo", {}, { schema })).returns.resolves.toEqualTypeOf();
+            expectTypeOf(() => client.callTool("echo")).returns.resolves.toEqualTypeOf();
+            expectTypeOf(() => client.callTool("echo", {}, { label: "x" })).returns.resolves.toEqualTypeOf();
+        });
+        it("rejects a schema passed inside the tool arguments before sending", async () => {
+            const { client, executeQuery } = createClient();
+            await expect(client.callTool("echo", { schema: z.string() })).rejects.toBeInstanceOf(TypeError);
+            expect(executeQuery).not.toHaveBeenCalled();
+        });
+        it("returns the CallToolResult without a schema, minus the plugin's session fields", async () => {
+            const { client } = createClient(textResult('{"a":1}', {
+                structuredContent: { a: 1 },
+                _meta: { trace: "t1" },
+                resultType: "string",
+                sessionId: "s-1",
+                protocolVersion: "2025-06-18",
+            }));
+            const result = await client.callTool("echo", {});
+            expect(result).toEqual({
+                content: [{ type: "text", text: '{"a":1}' }],
+                structuredContent: { a: 1 },
+                _meta: { trace: "t1" },
+                resultType: "string",
+            });
+            expect(result).not.toHaveProperty("sessionId");
+            expect(result).not.toHaveProperty("protocolVersion");
+        });
+        it("sends the session the plugin returned back on later calls unless the caller sets one", async () => {
+            const { client, executeQuery } = createClient(textResult("one", { sessionId: "s-1", protocolVersion: "2025-06-18" }), textResult("two"), textResult("three"), textResult("four", { sessionId: "s-2" }), textResult("five"));
+            await client.callTool("a");
+            await client.callTool("b");
+            await client.callTool("c", {}, { headers: { "mcp-session-id": "mine" } });
+            await client.callTool("d");
+            await client.callTool("e");
+            expect(headersOf(executeQuery.mock.calls[0])).toBeUndefined();
+            expect(headersOf(executeQuery.mock.calls[1])).toEqual({
+                "Mcp-Session-Id": "s-1",
+                "MCP-Protocol-Version": "2025-06-18",
+            });
+            expect(headersOf(executeQuery.mock.calls[2])).toEqual({
+                "mcp-session-id": "mine",
+            });
+            expect(headersOf(executeQuery.mock.calls[4])).toEqual({
+                "Mcp-Session-Id": "s-2",
+            });
+        });
+        it("validates structuredContent over text when both are present", async () => {
+            const { client } = createClient(textResult('{"a":"text wins"}', { structuredContent: { a: "struct" } }));
+            const result = await client.callTool("echo", undefined, {
+                schema: z.object({ a: z.string() }),
+            });
+            expect(result).toEqual({ a: "struct" });
+        });
+        it("falls through to the text block when structuredContent is null", async () => {
+            const { client } = createClient(textResult('{"a":"from text"}', { structuredContent: null }));
+            const result = await client.callTool("echo", undefined, {
+                schema: z.object({ a: z.string() }),
+            });
+            expect(result).toEqual({ a: "from text" });
+        });
+        it("validates the first text block parsed as JSON when there is no structuredContent", async () => {
+            const { client } = createClient({
+                content: [
+                    { type: "image", data: "...", mimeType: "image/png" },
+                    { type: "text", text: '{"count":2}' },
+                    { type: "text", text: '{"count":"ignored"}' },
+                ],
+            });
+            const result = await client.callTool("echo", undefined, {
+                schema: z.object({ count: z.number() }),
+            });
+            expect(result).toEqual({ count: 2 });
+        });
+        it("validates non-JSON text as a plain string", async () => {
+            const { client } = createClient(textResult("hello world"));
+            const result = await client.callTool("echo", undefined, {
+                schema: z.string(),
+            });
+            expect(result).toBe("hello world");
+        });
+        it("keeps JSON-looking text as a string when the schema wants a string", async () => {
+            const { client } = createClient(textResult("12345"), textResult("12345"));
+            const asString = await client.callTool("echo", undefined, {
+                schema: z.string(),
+            });
+            const asNumber = await client.callTool("echo", undefined, {
+                schema: z.number(),
+            });
+            expect(asString).toBe("12345");
+            expect(asNumber).toBe(12345);
+        });
+        it("throws RestApiValidationError when the result does not match the schema", async () => {
+            const { client } = createClient(textResult('{"count":"two"}'));
+            await expect(client.callTool("echo", undefined, {
+                schema: z.object({ count: z.number() }),
+            })).rejects.toBeInstanceOf(RestApiValidationError);
+        });
+        it("throws IntegrationError when a schema is given but the result has nothing to validate", async () => {
+            const { client } = createClient({
+                content: [{ type: "image", data: "...", mimeType: "image/png" }],
+            });
+            const error = await client
+                .callTool("echo", undefined, { schema: z.string() })
+                .catch((e) => e);
+            expect(error).toBeInstanceOf(IntegrationError);
+            expect(integrationError(error).details).toMatchObject({
+                cause: expect.stringContaining('Tool "echo"'),
+            });
+        });
+        it("throws IntegrationError naming the tool and carrying the result when isError is set", async () => {
+            const { client } = createClient({
+                content: [
+                    { type: "text", text: "rate limited" },
+                    { type: "image", data: "...", mimeType: "image/png" },
+                    { type: "text", text: "retry later" },
+                ],
+                isError: true,
+            });
+            const error = await client
+                .callTool("echo", {}, { schema: z.string() })
+                .catch((e) => e);
+            expect(error).toBeInstanceOf(IntegrationError);
+            expect(integrationError(error).operation).toBe("callTool");
+            expect(integrationError(error).details).toMatchObject({
+                cause: {
+                    tool: "echo",
+                    message: 'Tool "echo" failed: rate limited\nretry later',
+                    result: { isError: true, content: expect.any(Array) },
+                },
+            });
+            const details = z
+                .object({
+                cause: z.object({
+                    result: z.object({ content: z.array(z.unknown()) }),
+                }),
+            })
+                .parse(integrationError(error).details);
+            expect(details.cause.result.content).toHaveLength(3);
+        });
+        it("throws IntegrationError when the response is not a CallToolResult", async () => {
+            const { client } = createClient({ tools: [] });
+            await expect(client.callTool("echo")).rejects.toBeInstanceOf(IntegrationError);
+        });
+        it("wraps executeQuery failures in IntegrationError", async () => {
+            const executeQuery = vi.fn().mockRejectedValue(new Error("boom"));
+            const client = new McpClientImpl(TEST_CONFIG, executeQuery);
+            const error = await client.callTool("echo").catch((e) => e);
+            expect(error).toBeInstanceOf(IntegrationError);
+            expect(integrationError(error).details).toMatchObject({
+                operation: "callTool",
+                cause: new Error("boom"),
+            });
+        });
+        it.each([
+            "MCP server returned error -32602 for tools/call: MCP error -32602: Tool create_issue not found",
+            "MCP server returned error -32602 for tools/call: Unknown tool: create_issue",
+            "MCP server returned error -32601 for tools/call: MCP error -32601: Unknown tool: create_issue",
+        ])("throws McpToolUnavailableError when the server rejects the tool: %s", async (message) => {
+            const executeQuery = vi.fn().mockRejectedValue(new Error(message));
+            const client = new McpClientImpl(TEST_CONFIG, executeQuery);
+            const error = await client
+                .callTool("create_issue")
+                .catch((e) => e);
+            expect(error).toBeInstanceOf(McpToolUnavailableError);
+            expect(error).toBeInstanceOf(IntegrationError);
+            expect(error).toMatchObject({
+                name: "McpToolUnavailableError",
+                message: expect.stringContaining("create_issue"),
+                toolName: "create_issue",
+                integrationName: "Test MCP",
+            });
+            expect(error).toHaveProperty("message", expect.stringContaining("Test MCP"));
+        });
+        it("throws McpToolUnavailableError when an isError result names an unknown tool", async () => {
+            const { client } = createClient(textResult("Unknown tool: create_issue", { isError: true }));
+            const error = await client
+                .callTool("create_issue")
+                .catch((e) => e);
+            expect(error).toBeInstanceOf(McpToolUnavailableError);
+            expect(integrationError(error).details).toMatchObject({
+                cause: {
+                    tool: "create_issue",
+                    message: "Unknown tool: create_issue",
+                    result: { isError: true, content: expect.any(Array) },
+                },
+            });
+        });
+        it.each([
+            "Tool execution failed: issue not found",
+            "Unknown tool: other_tool",
+            "Unknown tool: get_issue-v2",
+            "Unknown tool: get_issue.v2",
+        ])("keeps an isError result that does not name the called tool as IntegrationError: %s", async (text) => {
+            const { client } = createClient(textResult(text, { isError: true }));
+            const error = await client
+                .callTool("get_issue")
+                .catch((e) => e);
+            expect(error).toBeInstanceOf(IntegrationError);
+            expect(error).not.toBeInstanceOf(McpToolUnavailableError);
+        });
+        it.each([
+            [
+                "create_issue",
+                "MCP server returned error -32602 for tools/call: Invalid arguments for tool create_issue",
+            ],
+            [
+                "create_issue",
+                "MCP server returned error -32603 for tools/call: Unknown tool: create_issue",
+            ],
+            [
+                "search.v2",
+                "MCP server returned error -32602 for tools/call: Unknown tool: search_v2",
+            ],
+        ])("keeps other tools/call errors for %s as IntegrationError: %s", async (tool, message) => {
+            const executeQuery = vi.fn().mockRejectedValue(new Error(message));
+            const client = new McpClientImpl(TEST_CONFIG, executeQuery);
+            const error = await client.callTool(tool).catch((e) => e);
+            expect(error).toBeInstanceOf(IntegrationError);
+            expect(error).not.toBeInstanceOf(McpToolUnavailableError);
+        });
+        it("keeps a listTools failure with unknown-tool wording as IntegrationError", async () => {
+            const executeQuery = vi
+                .fn()
+                .mockRejectedValue(new Error("MCP server returned error -32602 for tools/call: Unknown tool: x"));
+            const client = new McpClientImpl(TEST_CONFIG, executeQuery);
+            const error = await client.listTools().catch((e) => e);
+            expect(error).toBeInstanceOf(IntegrationError);
+            expect(error).not.toBeInstanceOf(McpToolUnavailableError);
+        });
+    });
+    describe("listTools()", () => {
+        it("follows nextCursor, concatenates every page, and reuses the session from page 1", async () => {
+            const { client, executeQuery } = createClient({ ...toolsPage(["a"], "c1"), sessionId: "s-1" }, toolsPage(["b"], "c2"), toolsPage(["c"]));
+            const tools = await client.listTools({ headers: { "X-Org": "acme" } });
+            expect(tools.map((t) => t.name)).toEqual(["a", "b", "c"]);
+            expect(executeQuery).toHaveBeenCalledTimes(3);
+            const params = executeQuery.mock.calls.map((call) => call[0].request.params);
+            expect(params).toEqual([{}, { cursor: "c1" }, { cursor: "c2" }]);
+            for (const call of executeQuery.mock.calls) {
+                expect(call[0].request.method).toBe("tools/list");
+            }
+            expect(headersOf(executeQuery.mock.calls[0])).toEqual({
+                "X-Org": "acme",
+            });
+            expect(headersOf(executeQuery.mock.calls[1])).toEqual({
+                "Mcp-Session-Id": "s-1",
+                "X-Org": "acme",
+            });
+        });
+        it("throws IntegrationError when the server repeats a cursor", async () => {
+            const { client, executeQuery } = createClient(toolsPage([], "loop"), toolsPage([], "loop"));
+            await expect(client.listTools()).rejects.toBeInstanceOf(IntegrationError);
+            expect(executeQuery).toHaveBeenCalledTimes(2);
+        });
+        it("gives up after 50 pages of fresh cursors", async () => {
+            let page = 0;
+            const executeQuery = vi
+                .fn()
+                .mockImplementation(async () => toolsPage([`t${page}`], `c${++page}`));
+            const client = new McpClientImpl(TEST_CONFIG, executeQuery);
+            const error = await client.listTools().catch((e) => e);
+            expect(error).toBeInstanceOf(IntegrationError);
+            expect(integrationError(error).details).toMatchObject({
+                cause: expect.stringContaining("50 pages"),
+            });
+            expect(executeQuery).toHaveBeenCalledTimes(50);
+        });
+        it("treats optional fields sent as null like absent ones", async () => {
+            const { client } = createClient({
+                tools: [
+                    {
+                        name: "a",
+                        description: null,
+                        title: null,
+                        inputSchema: { type: "object", properties: null, required: null },
+                        annotations: null,
+                        _meta: null,
+                    },
+                ],
+                nextCursor: null,
+            }, {
+                content: [
+                    { type: "text", text: "ok" },
+                    { type: "image", text: null },
+                ],
+                structuredContent: null,
+                isError: null,
+                _meta: null,
+                sessionId: null,
+                protocolVersion: null,
+            });
+            const tools = await client.listTools();
+            const result = await client.callTool("a");
+            expect(tools).toEqual([{ name: "a", inputSchema: { type: "object" } }]);
+            expect(result).toEqual({
+                content: [{ type: "text", text: "ok" }, { type: "image" }],
+            });
+        });
+        it("throws IntegrationError when a tool entry is malformed", async () => {
+            const { client } = createClient({
+                tools: [{ name: "ok", inputSchema: { type: "object" } }, { name: 42 }],
+            });
+            const error = await client.listTools().catch((e) => e);
+            expect(error).toBeInstanceOf(IntegrationError);
+            expect(integrationError(error).details).toMatchObject({
+                cause: expect.stringContaining("tools.1.name"),
+            });
+        });
+        it("throws IntegrationError when the response has no tools array", async () => {
+            const { client } = createClient(textResult("not a list"));
+            await expect(client.listTools()).rejects.toBeInstanceOf(IntegrationError);
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/integrations/mcpintegration/client.test.js.map

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

package/dist/integrations/mcpintegration/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Server integration client.
+ *
+ * @module
+ */
+export type { McpClient, McpCallToolOptions, McpRequestOptions, CallToolResult, McpContentBlock, Tool, ToolAnnotations, } from "./types.js";
+export { McpClientImpl, McpToolUnavailableError } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/mcpintegration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/mcpintegration/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,IAAI,EACJ,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/integrations/mcpintegration/index.js

@@ -0,0 +1,7 @@
+/**
+ * MCP Server integration client.
+ *
+ * @module
+ */
+export { McpClientImpl, McpToolUnavailableError } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/integrations/mcpintegration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/mcpintegration/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/integrations/mcpintegration/types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * MCP Server client types.
+ *
+ * An MCP Server integration points at a remote Model Context Protocol server.
+ * The client exposes the tools surface of that server: list the tools it
+ * advertises and call one of them. Resources and prompts are not exposed yet.
+ */
+import type { z } from "zod";
+import type { BaseIntegrationClient } from "../../types.js";
+/**
+ * One block of a tool result's `content` array.
+ *
+ * MCP defines text, image, audio, resource link and embedded resource blocks.
+ * Only `type` is guaranteed; the remaining fields depend on the block type.
+ */
+export interface McpContentBlock {
+    type: string;
+    /** Present on `text` blocks. */
+    text?: string;
+    [key: string]: unknown;
+}
+/**
+ * The result of a `tools/call` request, as returned by the MCP server.
+ */
+export interface CallToolResult {
+    /** Unstructured result blocks. */
+    content: McpContentBlock[];
+    /** Structured result, present when the tool declares an output schema. */
+    structuredContent?: Record<string, unknown>;
+    /** True when the tool itself failed; `content` then carries the error text. */
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+/**
+ * Behavioral hints a server attaches to a tool. All hints are advisory.
+ */
+export interface ToolAnnotations {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * One tool advertised by the MCP server through `tools/list`.
+ */
+export interface Tool {
+    name: string;
+    title?: string;
+    description?: string;
+    /** JSON Schema describing the tool's `arguments` object. */
+    inputSchema: {
+        type: "object";
+        properties?: Record<string, unknown>;
+        required?: string[];
+        [key: string]: unknown;
+    };
+    /** JSON Schema describing `structuredContent`, when the tool declares one. */
+    outputSchema?: Record<string, unknown>;
+    annotations?: ToolAnnotations;
+    _meta?: Record<string, unknown>;
+}
+/**
+ * Options shared by every MCP request.
+ *
+ * **Security:** `label` is trace metadata and may be stored in logs; do not put
+ * secrets in it. Headers are sent to the MCP server as-is.
+ */
+export interface McpRequestOptions {
+    /** Short human-readable label shown in the Trace View for this call. */
+    label?: string;
+    /**
+     * Extra HTTP headers for this request, on top of the headers configured on
+     * the integration. Use this for per-call values such as `Mcp-Param-*`.
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * Options for {@link McpClient.callTool}. Always the third argument: a schema
+ * placed inside `args` is rejected with a `TypeError` instead of being sent to
+ * the server as tool arguments.
+ */
+export interface McpCallToolOptions<T = unknown> extends McpRequestOptions {
+    /**
+     * Zod schema for the tool result. When given, the call returns the validated
+     * value instead of the `CallToolResult`. The value validated is
+     * `structuredContent` when the server returns an object; otherwise the first
+     * `text` block. Text that is JSON is validated as the parsed value first and
+     * as the raw string second, so a string schema still accepts text such as
+     * "12345". Text that is not JSON is validated as a string.
+     */
+    schema?: z.ZodSchema<T>;
+}
+/**
+ * MCP Server client for listing and calling tools.
+ *
+ * When the server needs an MCP session (handshake-era servers), the plugin
+ * opens one on the first call and the client sends it back on every later
+ * call of the same API run, so the handshake runs once per client instance.
+ *
+ * @example
+ * ```typescript
+ * const mcp = ctx.integrations.github;
+ *
+ * // Discover the server's tools
+ * const tools = await mcp.listTools();
+ *
+ * // Call a tool and get the raw CallToolResult
+ * const raw = await mcp.callTool("search_issues", { query: "is:open" });
+ *
+ * // Call a tool and validate the result
+ * const issues = await mcp.callTool(
+ *   "search_issues",
+ *   { query: "is:open" },
+ *   { schema: z.object({ items: z.array(IssueSchema) }) },
+ * );
+ * ```
+ */
+export interface McpClient extends BaseIntegrationClient {
+    /**
+     * Call a tool and validate its result against `schema`.
+     *
+     * @param name - Tool name as advertised by `tools/list`
+     * @param args - Tool arguments; sent as `{}` when omitted
+     * @param options - Request options with a required `schema`
+     * @returns The validated result
+     * @throws IntegrationError when the server reports `isError: true`
+     * @throws RestApiValidationError when the result does not match `schema`
+     */
+    callTool<T>(name: string, args: Record<string, unknown> | undefined, options: McpCallToolOptions<T> & {
+        schema: z.ZodSchema<T>;
+    }): Promise<T>;
+    /**
+     * Call a tool and return the server's `CallToolResult`, with the plugin's
+     * session bookkeeping fields removed and a `null` `structuredContent`
+     * normalized to absent.
+     *
+     * @param name - Tool name as advertised by `tools/list`
+     * @param args - Tool arguments; sent as `{}` when omitted
+     * @param options - Request options
+     * @returns The `CallToolResult`
+     * @throws IntegrationError when the server reports `isError: true`; the
+     *   error's `details.cause` carries the tool name, the text and the result
+     */
+    callTool(name: string, args?: Record<string, unknown>, options?: McpRequestOptions): Promise<CallToolResult>;
+    /**
+     * Call a tool. Returns the validated value when `options.schema` is set,
+     * otherwise the `CallToolResult`.
+     */
+    callTool<T>(name: string, args?: Record<string, unknown>, options?: McpCallToolOptions<T>): Promise<CallToolResult | T>;
+    /**
+     * List every tool the server advertises.
+     *
+     * Follows `nextCursor` until the server stops paginating, so the returned
+     * array is the complete catalog. Gives up with an `IntegrationError` after
+     * 50 pages or when a cursor repeats.
+     *
+     * @param options - Request options
+     * @returns All tools, in server order
+     */
+    listTools(options?: McpRequestOptions): Promise<Tool[]>;
+}
+//# sourceMappingURL=types.d.ts.map