trigger.dev 4.0.0 → 4.0.2

package/dist/esm/mcp/tools/runs.js

@@ -0,0 +1,160 @@
+import { toolsMetadata } from "../config.js";
+import { formatRun, formatRunList, formatRunShape, formatRunTrace } from "../formatters.js";
+import { CommonRunsInput, GetRunDetailsInput, ListRunsInput } from "../schemas.js";
+import { respondWithError, toolHandler } from "../utils.js";
+export const getRunDetailsTool = {
+    name: toolsMetadata.get_run_details.name,
+    title: toolsMetadata.get_run_details.title,
+    description: toolsMetadata.get_run_details.description,
+    inputSchema: GetRunDetailsInput.shape,
+    handler: toolHandler(GetRunDetailsInput.shape, async (input, { ctx }) => {
+        ctx.logger?.log("calling get_run_details", { input });
+        if (ctx.options.devOnly && input.environment !== "dev") {
+            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment. Remove the --dev-only flag to access other environments.`);
+        }
+        const projectRef = await ctx.getProjectRef({
+            projectRef: input.projectRef,
+            cwd: input.configPath,
+        });
+        const apiClient = await ctx.getApiClient({
+            projectRef,
+            environment: input.environment,
+            scopes: [`read:runs:${input.runId}`],
+            branch: input.branch,
+        });
+        const [runResult, traceResult] = await Promise.all([
+            apiClient.retrieveRun(input.runId),
+            apiClient.retrieveRunTrace(input.runId),
+        ]);
+        const formattedRun = formatRun(runResult);
+        const formattedTrace = formatRunTrace(traceResult.trace, input.maxTraceLines);
+        const runUrl = await ctx.getDashboardUrl(`/projects/v3/${projectRef}/runs/${runResult.id}`);
+        const content = [
+            "## Run Details",
+            formattedRun,
+            "",
+            "## Run Trace",
+            formattedTrace,
+            "",
+            `[View in dashboard](${runUrl})`,
+        ];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: content.join("\n"),
+                },
+            ],
+        };
+    }),
+};
+export const waitForRunToCompleteTool = {
+    name: toolsMetadata.wait_for_run_to_complete.name,
+    title: toolsMetadata.wait_for_run_to_complete.title,
+    description: toolsMetadata.wait_for_run_to_complete.description,
+    inputSchema: CommonRunsInput.shape,
+    handler: toolHandler(CommonRunsInput.shape, async (input, { ctx, signal }) => {
+        ctx.logger?.log("calling wait_for_run_to_complete", { input });
+        if (ctx.options.devOnly && input.environment !== "dev") {
+            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment. Remove the --dev-only flag to access other environments.`);
+        }
+        const projectRef = await ctx.getProjectRef({
+            projectRef: input.projectRef,
+            cwd: input.configPath,
+        });
+        const apiClient = await ctx.getApiClient({
+            projectRef,
+            environment: input.environment,
+            scopes: [`read:runs:${input.runId}`],
+            branch: input.branch,
+        });
+        const runSubscription = apiClient.subscribeToRun(input.runId, { signal });
+        const readableStream = runSubscription.getReader();
+        let run = null;
+        while (true) {
+            const { done, value } = await readableStream.read();
+            if (done) {
+                break;
+            }
+            run = value;
+            if (value.isCompleted) {
+                break;
+            }
+        }
+        if (!run) {
+            return respondWithError("Run not found");
+        }
+        return {
+            content: [{ type: "text", text: formatRunShape(run) }],
+        };
+    }),
+};
+export const cancelRunTool = {
+    name: toolsMetadata.cancel_run.name,
+    title: toolsMetadata.cancel_run.title,
+    description: toolsMetadata.cancel_run.description,
+    inputSchema: CommonRunsInput.shape,
+    handler: toolHandler(CommonRunsInput.shape, async (input, { ctx }) => {
+        ctx.logger?.log("calling cancel_run", { input });
+        if (ctx.options.devOnly && input.environment !== "dev") {
+            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment. Remove the --dev-only flag to access other environments.`);
+        }
+        const projectRef = await ctx.getProjectRef({
+            projectRef: input.projectRef,
+            cwd: input.configPath,
+        });
+        const apiClient = await ctx.getApiClient({
+            projectRef,
+            environment: input.environment,
+            scopes: [`write:runs:${input.runId}`, `read:runs:${input.runId}`],
+            branch: input.branch,
+        });
+        await apiClient.cancelRun(input.runId);
+        const retrieveResult = await apiClient.retrieveRun(input.runId);
+        const runUrl = await ctx.getDashboardUrl(`/projects/v3/${projectRef}/runs/${retrieveResult.id}`);
+        return {
+            content: [{ type: "text", text: JSON.stringify({ ...retrieveResult, runUrl }, null, 2) }],
+        };
+    }),
+};
+export const listRunsTool = {
+    name: toolsMetadata.list_runs.name,
+    title: toolsMetadata.list_runs.title,
+    description: toolsMetadata.list_runs.description,
+    inputSchema: ListRunsInput.shape,
+    handler: toolHandler(ListRunsInput.shape, async (input, { ctx }) => {
+        ctx.logger?.log("calling list_runs", { input });
+        if (ctx.options.devOnly && input.environment !== "dev") {
+            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment. Remove the --dev-only flag to access other environments.`);
+        }
+        const projectRef = await ctx.getProjectRef({
+            projectRef: input.projectRef,
+            cwd: input.configPath,
+        });
+        const apiClient = await ctx.getApiClient({
+            projectRef,
+            environment: input.environment,
+            scopes: ["read:runs"],
+            branch: input.branch,
+        });
+        const $from = typeof input.from === "string" ? new Date(input.from) : undefined;
+        const $to = typeof input.to === "string" ? new Date(input.to) : undefined;
+        const result = await apiClient.listRuns({
+            after: input.cursor,
+            limit: input.limit,
+            status: input.status,
+            taskIdentifier: input.taskIdentifier,
+            version: input.version,
+            tag: input.tag,
+            from: $from,
+            to: $to,
+            period: input.period,
+            machine: input.machine,
+        });
+        const formattedRuns = formatRunList(result);
+        return {
+            content: [{ type: "text", text: formattedRuns }],
+        };
+    }),
+};
+//# sourceMappingURL=runs.js.map

package/dist/esm/mcp/tools/runs.js.map

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

package/dist/esm/mcp/tools/tasks.d.ts

@@ -0,0 +1,200 @@
+import { ToolMeta } from "../types.js";
+export declare const getCurrentWorker: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        projectRef: import("zod").ZodOptional<import("zod").ZodString>;
+        configPath: import("zod").ZodOptional<import("zod").ZodString>;
+        environment: import("zod").ZodDefault<import("zod").ZodEnum<["dev", "staging", "prod", "preview"]>>;
+        branch: import("zod").ZodOptional<import("zod").ZodString>;
+    };
+    handler: (input: unknown, extra: ToolMeta) => Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            description?: string | undefined;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        isError?: boolean | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+    }>;
+};
+export declare const triggerTaskTool: {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        projectRef: import("zod").ZodOptional<import("zod").ZodString>;
+        configPath: import("zod").ZodOptional<import("zod").ZodString>;
+        environment: import("zod").ZodDefault<import("zod").ZodEnum<["dev", "staging", "prod", "preview"]>>;
+        branch: import("zod").ZodOptional<import("zod").ZodString>;
+    } & {
+        taskId: import("zod").ZodString;
+        payload: import("zod").ZodAny;
+        options: import("zod").ZodOptional<import("zod").ZodObject<{
+            queue: import("zod").ZodOptional<import("zod").ZodObject<{
+                name: import("zod").ZodString;
+            }, "strip", import("zod").ZodTypeAny, {
+                name: string;
+            }, {
+                name: string;
+            }>>;
+            delay: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodDate]>>;
+            idempotencyKey: import("zod").ZodOptional<import("zod").ZodString>;
+            machine: import("zod").ZodOptional<import("zod").ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
+            maxAttempts: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxDuration: import("zod").ZodOptional<import("zod").ZodNumber>;
+            tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+            ttl: import("zod").ZodDefault<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodNumber]>>;
+        }, "strip", import("zod").ZodTypeAny, {
+            ttl: string | number;
+            tags?: string[] | undefined;
+            idempotencyKey?: string | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            queue?: {
+                name: string;
+            } | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            delay?: string | Date | undefined;
+        }, {
+            tags?: string[] | undefined;
+            idempotencyKey?: string | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            queue?: {
+                name: string;
+            } | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            delay?: string | Date | undefined;
+            ttl?: string | number | undefined;
+        }>>;
+    };
+    handler: (input: unknown, extra: ToolMeta) => Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            type: "text";
+            text: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            description?: string | undefined;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        isError?: boolean | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+    }>;
+};

package/dist/esm/mcp/tools/tasks.js

@@ -0,0 +1,117 @@
+import { toolsMetadata } from "../config.js";
+import { CommonProjectsInput, TriggerTaskInput } from "../schemas.js";
+import { respondWithError, toolHandler } from "../utils.js";
+export const getCurrentWorker = {
+    name: toolsMetadata.get_current_worker.name,
+    title: toolsMetadata.get_current_worker.title,
+    description: toolsMetadata.get_current_worker.description,
+    inputSchema: CommonProjectsInput.shape,
+    handler: toolHandler(CommonProjectsInput.shape, async (input, { ctx }) => {
+        ctx.logger?.log("calling get_current_worker", { input });
+        if (ctx.options.devOnly && input.environment !== "dev") {
+            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment. Remove the --dev-only flag to access other environments.`);
+        }
+        const projectRef = await ctx.getProjectRef({
+            projectRef: input.projectRef,
+            cwd: input.configPath,
+        });
+        const cliApiClient = await ctx.getCliApiClient(input.branch);
+        const workerResult = await cliApiClient.getWorkerByTag(projectRef, input.environment, "current");
+        if (!workerResult.success) {
+            return respondWithError(workerResult.error);
+        }
+        const { worker, urls } = workerResult.data;
+        const contents = [
+            `Current worker for ${input.environment} is ${worker.version} using ${worker.sdkVersion} of the SDK.`,
+        ];
+        if (worker.tasks.length > 0) {
+            contents.push(`The worker has ${worker.tasks.length} tasks registered:`);
+            for (const task of worker.tasks) {
+                if (task.payloadSchema) {
+                    contents.push(`- ${task.slug} in ${task.filePath} (payload schema: ${JSON.stringify(task.payloadSchema)})`);
+                }
+                else {
+                    contents.push(`- ${task.slug} in ${task.filePath}`);
+                }
+            }
+        }
+        else {
+            contents.push(`The worker has no tasks registered.`);
+        }
+        contents.push(`\n`);
+        contents.push(`URLs:`);
+        contents.push(`- Runs: ${urls.runs}`);
+        contents.push(`\n`);
+        contents.push(`You can use the list_runs tool with the version ${worker.version} to get the list of runs for this worker.`);
+        if (typeof worker.sdkVersion === "string" &&
+            typeof worker.cliVersion === "string" &&
+            worker.sdkVersion !== worker.cliVersion) {
+            contents.push(`WARNING: The SDK version (${worker.sdkVersion}) is different from the CLI version (${worker.cliVersion}). This might cause issues with the task execution. Make sure to pin the CLI and the SDK versions to ${worker.sdkVersion}.`);
+        }
+        return {
+            content: [{ type: "text", text: contents.join("\n") }],
+        };
+    }),
+};
+export const triggerTaskTool = {
+    name: toolsMetadata.trigger_task.name,
+    title: toolsMetadata.trigger_task.title,
+    description: toolsMetadata.trigger_task.description,
+    inputSchema: TriggerTaskInput.shape,
+    handler: toolHandler(TriggerTaskInput.shape, async (input, { ctx }) => {
+        ctx.logger?.log("calling trigger_task", { input });
+        if (ctx.options.devOnly && input.environment !== "dev") {
+            return respondWithError(`This MCP server is only available for the dev environment. You tried to access the ${input.environment} environment. Remove the --dev-only flag to access other environments.`);
+        }
+        const projectRef = await ctx.getProjectRef({
+            projectRef: input.projectRef,
+            cwd: input.configPath,
+        });
+        const apiClient = await ctx.getApiClient({
+            projectRef,
+            environment: input.environment,
+            scopes: ["write:tasks"],
+            branch: input.branch,
+        });
+        ctx.logger?.log("triggering task", { input });
+        let payload = input.payload;
+        if (typeof payload === "string") {
+            try {
+                payload = JSON.parse(payload);
+            }
+            catch {
+                ctx.logger?.log("payload is not a valid JSON string, using as is", { payload });
+            }
+        }
+        const result = await apiClient.triggerTask(input.taskId, {
+            payload,
+            options: input.options,
+        });
+        const taskRunUrl = await ctx.getDashboardUrl(`/projects/v3/${projectRef}/runs/${result.id}`);
+        const contents = [
+            `Task ${input.taskId} triggered and run with ID created: ${result.id}.`,
+            `View the run in the dashboard: ${taskRunUrl}`,
+            `Use the ${toolsMetadata.wait_for_run_to_complete.name} tool to wait for the run to complete and the ${toolsMetadata.get_run_details.name} tool to get the details of the run.`,
+        ];
+        if (input.environment === "dev") {
+            const cliApiClient = await ctx.getCliApiClient(input.branch);
+            const devStatus = await cliApiClient.getDevStatus(projectRef);
+            const isConnected = devStatus.success ? devStatus.data.isConnected : false;
+            const connectionMessage = isConnected
+                ? undefined
+                : "The dev CLI is not connected to this project, because it is not currently running. Make sure to run the dev command to execute triggered tasks.";
+            if (connectionMessage) {
+                contents.push(connectionMessage);
+            }
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: contents.join("\n"),
+                },
+            ],
+        };
+    }),
+};
+//# sourceMappingURL=tasks.js.map

package/dist/esm/mcp/tools/tasks.js.map

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

package/dist/esm/mcp/tools.d.ts

@@ -0,0 +1,2 @@
+import { McpContext } from "./context.js";
+export declare function registerTools(context: McpContext): void;

package/dist/esm/mcp/tools.js

@@ -0,0 +1,40 @@
+import { deployTool, listDeploysTool } from "./tools/deploys.js";
+import { searchDocsTool } from "./tools/docs.js";
+import { createProjectInOrgTool, initializeProjectTool, listOrgsTool, listProjectsTool, } from "./tools/orgs.js";
+import { listPreviewBranchesTool } from "./tools/previewBranches.js";
+import { cancelRunTool, getRunDetailsTool, listRunsTool, waitForRunToCompleteTool, } from "./tools/runs.js";
+import { getCurrentWorker, triggerTaskTool } from "./tools/tasks.js";
+import { respondWithError } from "./utils.js";
+export function registerTools(context) {
+    const tools = [
+        searchDocsTool,
+        listOrgsTool,
+        listProjectsTool,
+        createProjectInOrgTool,
+        initializeProjectTool,
+        getCurrentWorker,
+        triggerTaskTool,
+        listRunsTool,
+        getRunDetailsTool,
+        waitForRunToCompleteTool,
+        cancelRunTool,
+        deployTool,
+        listDeploysTool,
+        listPreviewBranchesTool,
+    ];
+    for (const tool of tools) {
+        context.server.registerTool(tool.name, {
+            annotations: { title: tool.title },
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        }, async (input, extra) => {
+            try {
+                return tool.handler(input, { ...extra, ctx: context });
+            }
+            catch (error) {
+                return respondWithError(error);
+            }
+        });
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/esm/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/mcp/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,UAAU,aAAa,CAAC,OAAmB;IAC/C,MAAM,KAAK,GAAG;QACZ,cAAc;QACd,YAAY;QACZ,gBAAgB;QAChB,sBAAsB;QACtB,qBAAqB;QACrB,gBAAgB;QAChB,eAAe;QACf,YAAY;QACZ,iBAAiB;QACjB,wBAAwB;QACxB,aAAa;QACb,UAAU;QACV,eAAe;QACf,uBAAuB;KACxB,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,YAAY,CACzB,IAAI,CAAC,IAAI,EACT;YACE,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;YAClC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACrB,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YACzD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/esm/mcp/types.d.ts

@@ -0,0 +1,6 @@
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { ServerNotification, ServerRequest } from "@modelcontextprotocol/sdk/types.js";
+import { McpContext } from "./context.js";
+export type ToolMeta = RequestHandlerExtra<ServerRequest, ServerNotification> & {
+    ctx: McpContext;
+};

package/dist/esm/mcp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mcp/types.ts"],"names":[],"mappings":""}

package/dist/esm/mcp/utils.d.ts

@@ -0,0 +1,89 @@
+import type { CallToolResult, ServerNotification } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { ToolMeta } from "./types.js";
+export declare function respondWithError(error: unknown): CallToolResult;
+export type ToolHandlerMeta = ToolMeta & {
+    createProgressTracker: (total: number) => ProgressTracker;
+};
+export declare function toolHandler<TInputShape extends z.ZodRawShape>(shape: TInputShape, handler: (input: z.output<z.ZodObject<TInputShape>>, meta: ToolHandlerMeta) => Promise<CallToolResult>): (input: unknown, extra: ToolMeta) => Promise<{
+    [x: string]: unknown;
+    content: ({
+        [x: string]: unknown;
+        type: "text";
+        text: string;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        [x: string]: unknown;
+        type: "image";
+        data: string;
+        mimeType: string;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        [x: string]: unknown;
+        type: "audio";
+        data: string;
+        mimeType: string;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | {
+        [x: string]: unknown;
+        type: "resource_link";
+        name: string;
+        uri: string;
+        description?: string | undefined;
+        title?: string | undefined;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        mimeType?: string | undefined;
+    } | {
+        [x: string]: unknown;
+        type: "resource";
+        resource: {
+            [x: string]: unknown;
+            text: string;
+            uri: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            uri: string;
+            blob: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+        };
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    })[];
+    isError?: boolean | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    structuredContent?: {
+        [x: string]: unknown;
+    } | undefined;
+}>;
+declare class ProgressTracker {
+    #private;
+    private progress;
+    private progressToken;
+    private total;
+    private message;
+    private sendNotification;
+    constructor(total: number, sendNotification: (notification: ServerNotification) => Promise<void>, progressToken?: string | number);
+    updateProgress(progress: number, message?: string): Promise<void>;
+    incrementProgress(increment: number, message?: string): Promise<void>;
+    complete(message?: string): Promise<void>;
+    getProgress(): number;
+}
+export {};