@cyanheads/mcp-ts-core 0.1.0-beta.12

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

@@ -0,0 +1,144 @@
+import { logger } from '../../../utils/internal/logger.js';
+import { idGenerator } from '../../../utils/security/idGenerator.js';
+import { SessionAwareTaskStore } from './sessionAwareTaskStore.js';
+import { StorageBackedTaskStore } from './storageBackedTaskStore.js';
+import { InMemoryTaskMessageQueue, InMemoryTaskStore, } from './taskTypes.js';
+/**
+ * Singleton service that manages task state and message queues for the MCP server.
+ *
+ * The TaskManager provides:
+ * - A shared TaskStore for creating, tracking, and completing tasks
+ * - A shared TaskMessageQueue for side-channel message delivery
+ * - Cleanup methods for graceful shutdown
+ *
+ * The store type is determined by configuration:
+ * - `in-memory`: Fast, suitable for development (data lost on restart)
+ * - `storage`: Persistent, uses configured StorageService backend
+ *
+ * @example
+ * ```typescript
+ * // Inject via DI
+ * constructor(@inject(TaskManagerToken) private taskManager: TaskManager) {}
+ *
+ * // Access stores
+ * const taskStore = this.taskManager.getTaskStore();
+ * const messageQueue = this.taskManager.getMessageQueue();
+ * ```
+ *
+ * @experimental
+ */
+export class TaskManager {
+    taskStore;
+    inMemoryTaskStore = null;
+    messageQueue;
+    storeType;
+    isShuttingDown = false;
+    constructor(config, storageService) {
+        this.storeType = config.tasks.storeType;
+        this.messageQueue = new InMemoryTaskMessageQueue();
+        if (this.storeType === 'storage') {
+            this.taskStore = new StorageBackedTaskStore(storageService, {
+                tenantId: config.tasks.tenantId,
+                defaultTtl: config.tasks.defaultTtlMs ?? null,
+            });
+        }
+        else {
+            this.inMemoryTaskStore = new InMemoryTaskStore();
+            // Wrap with session ownership enforcement — the SDK's InMemoryTaskStore
+            // ignores sessionId parameters, so SessionAwareTaskStore adds that layer.
+            this.taskStore = new SessionAwareTaskStore(this.inMemoryTaskStore);
+        }
+        logger.info(`TaskManager initialized with ${this.storeType} task store`, {
+            operation: 'TaskManager.constructor',
+            requestId: idGenerator.generate('req'),
+            timestamp: new Date().toISOString(),
+            storeType: this.storeType,
+            ...(this.storeType === 'storage' && { tenantId: config.tasks.tenantId }),
+        });
+    }
+    /**
+     * Returns the TaskStore instance for managing task lifecycle.
+     *
+     * The TaskStore handles:
+     * - Task creation with TTL and poll intervals
+     * - Status updates (working, input_required, completed, failed, cancelled)
+     * - Result storage and retrieval
+     * - Task listing with pagination
+     *
+     * @returns The singleton TaskStore instance
+     */
+    getTaskStore() {
+        return this.taskStore;
+    }
+    /**
+     * Returns the TaskMessageQueue instance for side-channel messaging.
+     *
+     * The message queue enables:
+     * - Queuing requests/notifications for delivery via tasks/result
+     * - FIFO ordering per task
+     * - Atomic enqueue with size limits
+     *
+     * @returns The singleton TaskMessageQueue instance
+     */
+    getMessageQueue() {
+        return this.messageQueue;
+    }
+    /**
+     * Returns the store type currently in use.
+     *
+     * @returns 'in-memory' or 'storage'
+     */
+    getStoreType() {
+        return this.storeType;
+    }
+    /**
+     * Performs cleanup of task resources.
+     *
+     * Should be called during graceful server shutdown to:
+     * - Cancel cleanup timers in the in-memory task store
+     * - Clear any pending message queues
+     *
+     * Note: Storage-backed task stores don't require cleanup as data persists.
+     *
+     * @param context - Request context for logging
+     */
+    cleanup(context) {
+        if (this.isShuttingDown) {
+            return;
+        }
+        this.isShuttingDown = true;
+        const logContext = context ?? {
+            operation: 'TaskManager.cleanup',
+            requestId: idGenerator.generate('req'),
+            timestamp: new Date().toISOString(),
+        };
+        logger.info('Cleaning up TaskManager resources...', logContext);
+        // Only InMemoryTaskStore has cleanup timers
+        if (this.inMemoryTaskStore) {
+            this.inMemoryTaskStore.cleanup();
+        }
+        logger.info('TaskManager cleanup complete', logContext);
+    }
+    /**
+     * Returns the current task count (for debugging/monitoring).
+     * Only available for in-memory store; returns `null` for storage-backed store.
+     *
+     * @returns The number of tasks currently tracked, or `null` if unavailable
+     */
+    getTaskCount() {
+        if (this.inMemoryTaskStore) {
+            return this.inMemoryTaskStore.getAllTasks().length;
+        }
+        // Storage-backed store doesn't have getAllTasks - would require listing
+        return null;
+    }
+    /**
+     * Checks if the TaskManager is shutting down.
+     *
+     * @returns True if cleanup has been initiated
+     */
+    isCleaningUp() {
+        return this.isShuttingDown;
+    }
+}
+//# sourceMappingURL=taskManager.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * @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';
+//# sourceMappingURL=taskTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,13 @@
+/**
+ * @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';
+//# sourceMappingURL=taskTypes.js.map

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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,108 @@
+/**
+ * @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',
+ *   inputSchema: z.object({ data: z.string() }),
+ *   outputSchema: 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>> {
+    /**
+     * 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;
+    /**
+     * The Zod schema for validating the tool's input parameters.
+     * All fields should have `.describe()` for LLM context.
+     */
+    inputSchema: TInputSchema;
+    /**
+     * The programmatic, unique name for the tool (e.g., 'async_analysis').
+     * Must follow MCP tool naming conventions: alphanumeric, underscores, hyphens.
+     */
+    name: string;
+    /**
+     * The Zod schema for validating the tool's successful output structure.
+     * Used for documentation and client-side type inference.
+     */
+    outputSchema?: 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

@@ -0,0 +1 @@
+{"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;;OAEG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;;;;OAQG;IACH,SAAS,EAAE,iBAAiB,CAAC;IAE7B;;;OAGG;IACH,WAAW,EAAE,YAAY,CAAC;IAC1B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC;IAE7B;;;;;;;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

@@ -0,0 +1,14 @@
+/**
+ * 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

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

package/dist/mcp-server/tools/tool-registration.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Encapsulates the registration of all tool definitions with an McpServer.
+ * Supports legacy ToolDefinition, TaskToolDefinition, and new-style NewToolDefinition.
+ * @module src/mcp-server/tools/tool-registration
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ZodObject, ZodRawShape } from 'zod';
+import { type TaskToolDefinition } from '../../mcp-server/tasks/utils/taskToolDefinition.js';
+import { type AnyNewToolDefinition } from '../../mcp-server/tools/utils/newToolDefinition.js';
+import { type HandlerFactoryServices } from '../../mcp-server/tools/utils/newToolHandlerFactory.js';
+import type { ToolDefinition } from '../../mcp-server/tools/utils/toolDefinition.js';
+/** Union of all accepted tool definition shapes. */
+export type AnyToolDef = ToolDefinition<ZodObject<ZodRawShape>, ZodObject<ZodRawShape>> | TaskToolDefinition<ZodObject<ZodRawShape>, ZodObject<ZodRawShape>> | AnyNewToolDefinition;
+export declare class ToolRegistry {
+    private toolDefs;
+    private services?;
+    constructor(toolDefs: AnyToolDef[], services?: HandlerFactoryServices | undefined);
+    /**
+     * Registers all tool definitions with the provided McpServer instance.
+     * Automatically detects new-style, legacy, and task-based tools.
+     */
+    registerAll(server: McpServer): Promise<void>;
+    private deriveTitleFromName;
+    /**
+     * Registers a new-style tool definition (with `handler`, `input`, `auth`, etc.).
+     * Requires `services` to have been passed to the constructor for Context creation.
+     */
+    private registerNewTool;
+    /**
+     * Registers a new-style tool with `task: true` via the experimental Tasks API.
+     * Auto-generates task handlers from the definition's `handler` function.
+     * The framework manages the full task lifecycle: create, background run, store result.
+     */
+    private registerAutoTaskTool;
+    /**
+     * Runs a new-style tool handler as a background task.
+     * Creates Context with `progress` and `signal`, stores result/error on completion.
+     */
+    private runAutoTaskHandler;
+    private registerTool;
+    /**
+     * Registers a task-based tool with the MCP server via the experimental Tasks API.
+     * Task tools support long-running async operations with polling for status and results.
+     *
+     * @experimental
+     */
+    private registerTaskTool;
+}
+//# sourceMappingURL=tool-registration.d.ts.map

package/dist/mcp-server/tools/tool-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registration.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/tool-registration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,yCAAyC,CAAC;AAGvF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAGlD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,+CAA+C,CAAC;AACvD,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAQjF,oDAAoD;AACpD,MAAM,MAAM,UAAU,GAClB,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,GAC9D,kBAAkB,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC,GAClE,oBAAoB,CAAC;AAEzB,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ,CAAC;gBADT,QAAQ,EAAE,UAAU,EAAE,EACtB,QAAQ,CAAC,EAAE,sBAAsB,YAAA;IAG3C;;;OAGG;IACU,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C1D,OAAO,CAAC,mBAAmB;IAI3B;;;OAGG;YACW,eAAe;IA4C7B;;;;OAIG;YACW,oBAAoB;IA6ElC;;;OAGG;YACW,kBAAkB;YAqElB,YAAY;IAiD1B;;;;;OAKG;YACW,gBAAgB;CA0C/B"}

package/dist/mcp-server/tools/tool-registration.js

@@ -0,0 +1,269 @@
+import { createContext } from '../../context.js';
+import { isTaskToolDefinition, } from '../../mcp-server/tasks/utils/taskToolDefinition.js';
+import { isNewToolDefinition, } from '../../mcp-server/tools/utils/newToolDefinition.js';
+import { createNewToolHandler, } from '../../mcp-server/tools/utils/newToolHandlerFactory.js';
+import { createMcpToolHandler } from '../../mcp-server/tools/utils/toolHandlerFactory.js';
+import { withRequiredScopes } from '../../mcp-server/transports/auth/lib/authUtils.js';
+import { JsonRpcErrorCode } from '../../types-global/errors.js';
+import { ErrorHandler } from '../../utils/internal/error-handler/errorHandler.js';
+import { logger } from '../../utils/internal/logger.js';
+import { requestContextService } from '../../utils/internal/requestContext.js';
+export class ToolRegistry {
+    toolDefs;
+    services;
+    constructor(toolDefs, services) {
+        this.toolDefs = toolDefs;
+        this.services = services;
+    }
+    /**
+     * Registers all tool definitions with the provided McpServer instance.
+     * Automatically detects new-style, legacy, and task-based tools.
+     */
+    async registerAll(server) {
+        const context = requestContextService.createRequestContext({
+            operation: 'ToolRegistry.registerAll',
+        });
+        const newTools = [];
+        const legacyTools = [];
+        const taskTools = [];
+        for (const def of this.toolDefs) {
+            if (isNewToolDefinition(def)) {
+                newTools.push(def);
+            }
+            else if (isTaskToolDefinition(def)) {
+                taskTools.push(def);
+            }
+            else {
+                legacyTools.push(def);
+            }
+        }
+        logger.info(`Registering ${newTools.length + legacyTools.length} regular tool(s) and ${taskTools.length} task tool(s)...`, context);
+        // Register new-style tools (regular and auto-task)
+        for (const toolDef of newTools) {
+            if (toolDef.task) {
+                await this.registerAutoTaskTool(server, toolDef);
+            }
+            else {
+                await this.registerNewTool(server, toolDef);
+            }
+        }
+        // Register legacy tools
+        for (const toolDef of legacyTools) {
+            await this.registerTool(server, toolDef);
+        }
+        // Register task tools via experimental API
+        for (const toolDef of taskTools) {
+            await this.registerTaskTool(server, toolDef);
+        }
+    }
+    deriveTitleFromName(name) {
+        return name.replace(/_/g, ' ').replace(/\b\w/g, (char) => char.toUpperCase());
+    }
+    /**
+     * Registers a new-style tool definition (with `handler`, `input`, `auth`, etc.).
+     * Requires `services` to have been passed to the constructor for Context creation.
+     */
+    async registerNewTool(server, tool) {
+        const registrationContext = requestContextService.createRequestContext({
+            operation: 'ToolRegistry.registerNewTool',
+            toolName: tool.name,
+        });
+        logger.debug(`Registering tool (new-style): '${tool.name}'`, registrationContext);
+        await ErrorHandler.tryCatch(() => {
+            if (!this.services) {
+                throw new Error(`Cannot register new-style tool '${tool.name}': HandlerFactoryServices not provided to ToolRegistry`);
+            }
+            const handler = createNewToolHandler(tool, this.services);
+            const title = tool.title ?? tool.annotations?.title ?? this.deriveTitleFromName(tool.name);
+            // Type assertion required: SDK's conditional types don't resolve with erased generics
+            server.registerTool(tool.name, {
+                title,
+                description: tool.description,
+                inputSchema: tool.input,
+                ...(tool.output && { outputSchema: tool.output }),
+                ...(tool.annotations && { annotations: tool.annotations }),
+                ...(tool._meta && { _meta: tool._meta }),
+            }, handler);
+            logger.notice(`Tool '${tool.name}' registered successfully.`, registrationContext);
+        }, {
+            operation: `RegisteringTool_${tool.name}`,
+            context: registrationContext,
+            errorCode: JsonRpcErrorCode.InitializationFailed,
+            critical: true,
+        });
+    }
+    /**
+     * Registers a new-style tool with `task: true` via the experimental Tasks API.
+     * Auto-generates task handlers from the definition's `handler` function.
+     * The framework manages the full task lifecycle: create, background run, store result.
+     */
+    async registerAutoTaskTool(server, tool) {
+        const registrationContext = requestContextService.createRequestContext({
+            operation: 'ToolRegistry.registerAutoTaskTool',
+            toolName: tool.name,
+        });
+        logger.debug(`Registering auto-task tool (new-style, task: true): '${tool.name}'`, registrationContext);
+        await ErrorHandler.tryCatch(() => {
+            if (!this.services) {
+                throw new Error(`Cannot register auto-task tool '${tool.name}': HandlerFactoryServices not provided to ToolRegistry`);
+            }
+            const services = this.services;
+            const title = tool.title ?? tool.annotations?.title ?? this.deriveTitleFromName(tool.name);
+            const formatter = (result) => tool.format
+                ? tool.format(result)
+                : [{ type: 'text', text: JSON.stringify(result, null, 2) }];
+            server.experimental.tasks.registerToolTask(tool.name, {
+                title,
+                description: tool.description,
+                inputSchema: tool.input,
+                ...(tool.output && { outputSchema: tool.output }),
+                ...(tool.annotations && { annotations: tool.annotations }),
+                execution: { taskSupport: 'optional' },
+            }, {
+                createTask: async (args, extra) => {
+                    const validatedInput = tool.input.parse(args);
+                    const task = await extra.taskStore.createTask({
+                        ttl: 120_000,
+                        pollInterval: 1000,
+                    });
+                    // Fire-and-forget: run handler in background
+                    void this.runAutoTaskHandler(tool, validatedInput, task.taskId, extra.taskStore, services, formatter);
+                    return { task };
+                },
+                getTask: async (_args, extra) => extra.taskStore.getTask(extra.taskId),
+                getTaskResult: async (_args, extra) => (await extra.taskStore.getTaskResult(extra.taskId)),
+            });
+            logger.notice(`Auto-task tool '${tool.name}' registered successfully (experimental).`, registrationContext);
+        }, {
+            operation: `RegisteringAutoTaskTool_${tool.name}`,
+            context: registrationContext,
+            errorCode: JsonRpcErrorCode.InitializationFailed,
+            critical: true,
+        });
+    }
+    /**
+     * Runs a new-style tool handler as a background task.
+     * Creates Context with `progress` and `signal`, stores result/error on completion.
+     */
+    async runAutoTaskHandler(tool, input, taskId, taskStore, services, formatter) {
+        const abortController = new AbortController();
+        // Poll for cancellation every 2 seconds
+        const cancelInterval = setInterval(async () => {
+            try {
+                const task = await taskStore.getTask(taskId);
+                if (task.status === 'cancelled') {
+                    abortController.abort();
+                    clearInterval(cancelInterval);
+                }
+            }
+            catch {
+                // Task may have been cleaned up — stop polling
+                clearInterval(cancelInterval);
+            }
+        }, 2000);
+        try {
+            const appContext = requestContextService.createRequestContext({
+                operation: 'AutoTaskHandler',
+                additionalContext: { toolName: tool.name, taskId },
+            });
+            // Check inline auth scopes
+            if (tool.auth && tool.auth.length > 0) {
+                withRequiredScopes(tool.auth, appContext);
+            }
+            const ctx = createContext({
+                appContext,
+                logger: services.logger,
+                storage: services.storage,
+                signal: abortController.signal,
+                taskCtx: { store: taskStore, taskId },
+            });
+            const result = await Promise.resolve(tool.handler(input, ctx));
+            clearInterval(cancelInterval);
+            await taskStore.storeTaskResult(taskId, 'completed', {
+                content: formatter(result),
+                structuredContent: result,
+            });
+        }
+        catch (error) {
+            clearInterval(cancelInterval);
+            // If cancelled, the SDK already set the terminal state — don't overwrite
+            if (abortController.signal.aborted)
+                return;
+            try {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                await taskStore.storeTaskResult(taskId, 'failed', {
+                    content: [{ type: 'text', text: `Error: ${errorMessage}` }],
+                    isError: true,
+                });
+            }
+            catch {
+                // Task may already be in terminal state
+            }
+        }
+    }
+    async registerTool(server, tool) {
+        const registrationContext = requestContextService.createRequestContext({
+            operation: 'ToolRegistry.registerTool',
+            toolName: tool.name,
+        });
+        logger.debug(`Registering tool: '${tool.name}'`, registrationContext);
+        await ErrorHandler.tryCatch(() => {
+            const handler = createMcpToolHandler({
+                toolName: tool.name,
+                inputSchema: tool.inputSchema,
+                logic: tool.logic,
+                ...(tool.responseFormatter && {
+                    responseFormatter: tool.responseFormatter,
+                }),
+            });
+            const title = tool.title ?? tool.annotations?.title ?? this.deriveTitleFromName(tool.name);
+            // Type assertion required: SDK's conditional types don't resolve with generic constraints
+            server.registerTool(tool.name, {
+                title,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+                outputSchema: tool.outputSchema,
+                ...(tool.annotations && { annotations: tool.annotations }),
+                ...(tool._meta && { _meta: tool._meta }),
+            }, handler);
+            logger.notice(`Tool '${tool.name}' registered successfully.`, registrationContext);
+        }, {
+            operation: `RegisteringTool_${tool.name}`,
+            context: registrationContext,
+            errorCode: JsonRpcErrorCode.InitializationFailed,
+            critical: true,
+        });
+    }
+    /**
+     * Registers a task-based tool with the MCP server via the experimental Tasks API.
+     * Task tools support long-running async operations with polling for status and results.
+     *
+     * @experimental
+     */
+    async registerTaskTool(server, tool) {
+        const registrationContext = requestContextService.createRequestContext({
+            operation: 'ToolRegistry.registerTaskTool',
+            toolName: tool.name,
+        });
+        logger.debug(`Registering task tool: '${tool.name}' (experimental)`, registrationContext);
+        await ErrorHandler.tryCatch(() => {
+            const title = tool.title ?? tool.annotations?.title ?? this.deriveTitleFromName(tool.name);
+            // Use the experimental Tasks API to register task-based tools
+            server.experimental.tasks.registerToolTask(tool.name, {
+                title,
+                description: tool.description,
+                inputSchema: tool.inputSchema,
+                ...(tool.outputSchema && { outputSchema: tool.outputSchema }),
+                ...(tool.annotations && { annotations: tool.annotations }),
+                execution: tool.execution,
+            }, tool.taskHandlers);
+            logger.notice(`Task tool '${tool.name}' registered successfully (experimental).`, registrationContext);
+        }, {
+            operation: `RegisteringTaskTool_${tool.name}`,
+            context: registrationContext,
+            errorCode: JsonRpcErrorCode.InitializationFailed,
+            critical: true,
+        });
+    }
+}
+//# sourceMappingURL=tool-registration.js.map

package/dist/mcp-server/tools/tool-registration.js.map

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