@cyanheads/mcp-ts-core 0.11.5 → 0.12.0

package/dist/mcp-server/tasks/core/taskTypes.d.ts

@@ -1,18 +0,0 @@
-/**
- * @fileoverview Re-exports task-related types from the MCP SDK experimental module.
- * These types are used for implementing task-based tools that support long-running
- * async operations with the "call-now, fetch-later" pattern.
- *
- * @experimental These APIs are experimental and may change without notice.
- * @module src/mcp-server/tasks/core/taskTypes
- */
-export type { CancelTaskRequest, CancelTaskResult, CreateTaskOptions, CreateTaskRequestHandlerExtra, CreateTaskResult, ErrorMessage, GetTaskPayloadRequest, GetTaskRequest, GetTaskResult, ListTasksRequest, ListTasksResult, QueuedMessage, RelatedTaskMetadata, ResponseMessage, ResultMessage, Task, TaskCreatedMessage, TaskCreationParams, TaskMessageQueue, TaskRequestHandlerExtra, TaskStatusMessage, TaskStatusNotification, TaskStatusNotificationParams, TaskStore, TaskToolExecution, ToolTaskHandler, } from '@modelcontextprotocol/sdk/experimental/tasks';
-export { InMemoryTaskMessageQueue, InMemoryTaskStore, isTerminal, takeResult, toArrayAsync, } from '@modelcontextprotocol/sdk/experimental/tasks';
-/**
- * TTL applied to a task when `TASK_STORE_DEFAULT_TTL_MS` is unset.
- *
- * Shared so task creation and the bookkeeping that must expire alongside it
- * (ownership rows, message queues) cannot drift onto different lifetimes.
- */
-export declare const DEFAULT_AUTO_TASK_TTL_MS = 120000;
-//# sourceMappingURL=taskTypes.d.ts.map

package/dist/mcp-server/tasks/core/taskTypes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"taskTypes.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tasks/core/taskTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,6BAA6B,EAC7B,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,IAAI,EACJ,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,4BAA4B,EAC5B,SAAS,EACT,iBAAiB,EACjB,eAAe,GAChB,MAAM,8CAA8C,CAAC;AAItD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,8CAA8C,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,SAAU,CAAC"}

package/dist/mcp-server/tasks/core/taskTypes.js

@@ -1,20 +0,0 @@
-/**
- * @fileoverview Re-exports task-related types from the MCP SDK experimental module.
- * These types are used for implementing task-based tools that support long-running
- * async operations with the "call-now, fetch-later" pattern.
- *
- * @experimental These APIs are experimental and may change without notice.
- * @module src/mcp-server/tasks/core/taskTypes
- */
-// In-memory implementations (reference implementations)
-// Utility functions
-// Helper functions for processing task responses
-export { InMemoryTaskMessageQueue, InMemoryTaskStore, isTerminal, takeResult, toArrayAsync, } from '@modelcontextprotocol/sdk/experimental/tasks';
-/**
- * TTL applied to a task when `TASK_STORE_DEFAULT_TTL_MS` is unset.
- *
- * Shared so task creation and the bookkeeping that must expire alongside it
- * (ownership rows, message queues) cannot drift onto different lifetimes.
- */
-export const DEFAULT_AUTO_TASK_TTL_MS = 120_000;
-//# sourceMappingURL=taskTypes.js.map

package/dist/mcp-server/tasks/core/taskTypes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"taskTypes.js","sourceRoot":"","sources":["../../../../src/mcp-server/tasks/core/taskTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkCH,wDAAwD;AACxD,oBAAoB;AACpB,iDAAiD;AACjD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,YAAY,GACb,MAAM,8CAA8C,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC"}

package/dist/mcp-server/tasks/utils/taskToolDefinition.d.ts

@@ -1,101 +0,0 @@
-/**
- * @fileoverview Defines the structure for task-based tool definitions.
- * Task tools support long-running async operations with the MCP Tasks API,
- * enabling "call-now, fetch-later" execution patterns.
- *
- * @experimental These APIs are experimental and may change without notice.
- * @module src/mcp-server/tasks/utils/taskToolDefinition
- */
-import type { ZodObject, ZodRawShape } from 'zod';
-import type { TaskToolExecution, ToolTaskHandler } from '../../../mcp-server/tasks/core/taskTypes.js';
-import type { ToolAnnotations } from '../../../mcp-server/tools/utils/toolDefinition.js';
-/**
- * Represents a task-based tool definition for long-running async operations.
- *
- * Unlike regular tools that execute synchronously and return immediately,
- * task tools create durable task handles that clients can poll for status
- * and retrieve results after completion.
- *
- * Task tools are registered via `server.experimental.tasks.registerToolTask()`
- * and must implement three handlers:
- * - `createTask`: Called when the tool is invoked, creates the task and starts work
- * - `getTask`: Called to poll task status (tasks/get)
- * - `getTaskResult`: Called to retrieve results (tasks/result)
- *
- * @example
- * ```typescript
- * const myTaskTool: TaskToolDefinition<typeof InputSchema, typeof OutputSchema> = {
- *   name: 'long_running_analysis',
- *   description: 'Performs a long-running analysis operation',
- *   input: z.object({ data: z.string() }),
- *   output: z.object({ result: z.string() }),
- *   execution: { taskSupport: 'required' },
- *   taskHandlers: {
- *     createTask: async (args, extra) => {
- *       const task = await extra.taskStore.createTask({ ttl: 300000 }, ...);
- *       startBackgroundWork(task.taskId, args);
- *       return { task };
- *     },
- *     getTask: async (_args, extra) => {
- *       return await extra.taskStore.getTask(extra.taskId);
- *     },
- *     getTaskResult: async (_args, extra) => {
- *       return await extra.taskStore.getTaskResult(extra.taskId);
- *     }
- *   }
- * };
- * ```
- *
- * @experimental
- */
-export interface TaskToolDefinition<TInputSchema extends ZodObject<ZodRawShape>, TOutputSchema extends ZodObject<ZodRawShape>> {
-    /** Protocol-level metadata (e.g., MCP Apps extension `_meta.ui`). */
-    _meta?: Record<string, unknown>;
-    /**
-     * Optional metadata providing hints about the tool's behavior.
-     */
-    annotations?: ToolAnnotations;
-    /**
-     * A clear, concise description of what the tool does.
-     * This is sent to the LLM to help it decide when to use the tool.
-     */
-    description: string;
-    /**
-     * Task execution configuration.
-     *
-     * - `taskSupport: 'required'` - Tool MUST be invoked as a task
-     * - `taskSupport: 'optional'` - Tool can be invoked normally or as a task
-     *
-     * Note: `taskSupport: 'forbidden'` is not valid for task tools;
-     * use a regular ToolDefinition instead.
-     */
-    execution: TaskToolExecution;
-    /** Zod schema for input validation. All fields need `.describe()`. */
-    input: TInputSchema;
-    /** Programmatic unique name (snake_case). */
-    name: string;
-    /** Zod schema for output validation. */
-    output?: TOutputSchema;
-    /**
-     * The task handlers implementing the task lifecycle.
-     *
-     * These handlers are called by the SDK at different points:
-     * - `createTask`: When the tool is first invoked (tools/call with task param)
-     * - `getTask`: When polling for status (tasks/get)
-     * - `getTaskResult`: When retrieving results (tasks/result)
-     */
-    taskHandlers: ToolTaskHandler<TInputSchema>;
-    /**
-     * An optional, human-readable title for the tool.
-     * If not provided, derived from `name` or `annotations.title`.
-     */
-    title?: string;
-}
-/**
- * Type guard to check if a tool definition is a task tool.
- *
- * @param def - The tool definition to check
- * @returns True if the definition has taskHandlers (is a TaskToolDefinition)
- */
-export declare function isTaskToolDefinition(def: unknown): def is TaskToolDefinition<ZodObject<ZodRawShape>, ZodObject<ZodRawShape>>;
-//# sourceMappingURL=taskToolDefinition.d.ts.map

package/dist/mcp-server/tasks/utils/taskToolDefinition.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"taskToolDefinition.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tasks/utils/taskToolDefinition.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC/F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,kBAAkB,CACjC,YAAY,SAAS,SAAS,CAAC,WAAW,CAAC,EAC3C,aAAa,SAAS,SAAS,CAAC,WAAW,CAAC;IAE5C,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,SAAS,EAAE,iBAAiB,CAAC;IAE7B,sEAAsE;IACtE,KAAK,EAAE,YAAY,CAAC;IAEpB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IAEb,wCAAwC;IACxC,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB;;;;;;;OAOG;IACH,YAAY,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAE5C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,kBAAkB,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,CAQ3E"}

package/dist/mcp-server/tasks/utils/taskToolDefinition.js

@@ -1,14 +0,0 @@
-/**
- * Type guard to check if a tool definition is a task tool.
- *
- * @param def - The tool definition to check
- * @returns True if the definition has taskHandlers (is a TaskToolDefinition)
- */
-export function isTaskToolDefinition(def) {
-    return (def !== null &&
-        typeof def === 'object' &&
-        'taskHandlers' in def &&
-        def.taskHandlers !== null &&
-        typeof def.taskHandlers === 'object');
-}
-//# sourceMappingURL=taskToolDefinition.js.map

package/dist/mcp-server/tasks/utils/taskToolDefinition.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"taskToolDefinition.js","sourceRoot":"","sources":["../../../../src/mcp-server/tasks/utils/taskToolDefinition.ts"],"names":[],"mappings":"AA0GA;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAY;IAEZ,OAAO,CACL,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,KAAK,QAAQ;QACvB,cAAc,IAAI,GAAG;QACrB,GAAG,CAAC,YAAY,KAAK,IAAI;QACzB,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,CACrC,CAAC;AACJ,CAAC"}