@cyanheads/mcp-ts-core 0.11.4 → 0.12.0

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

@@ -1,91 +0,0 @@
-import type { config as configType } from '../../../config/index.js';
-import type { StorageService } from '../../../storage/core/StorageService.js';
-import type { RequestContext } from '../../../utils/internal/requestContext.js';
-import { type TaskMessageQueue, type TaskStore } 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 declare class TaskManager {
-    private readonly taskStore;
-    private readonly inMemoryTaskStore;
-    private readonly messageQueue;
-    private readonly storeType;
-    private isShuttingDown;
-    constructor(config: typeof configType, storageService: StorageService);
-    /**
-     * 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(): 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(): TaskMessageQueue;
-    /**
-     * Returns the store type currently in use.
-     *
-     * @returns 'in-memory' or 'storage'
-     */
-    getStoreType(): 'in-memory' | 'storage';
-    /**
-     * 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?: RequestContext): void;
-    /**
-     * 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(): number | null;
-    /**
-     * Checks if the TaskManager is shutting down.
-     *
-     * @returns True if cleanup has been initiated
-     */
-    isCleaningUp(): boolean;
-}
-//# sourceMappingURL=taskManager.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"taskManager.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tasks/core/taskManager.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAOzE,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAiFxB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,cAAc,CAAS;IAE/B,YAAY,MAAM,EAAE,OAAO,UAAU,EAAE,cAAc,EAAE,cAAc,EA4CpE;IAED;;;;;;;;;;OAUG;IACI,YAAY,IAAI,SAAS,CAE/B;IAED;;;;;;;;;OASG;IACI,eAAe,IAAI,gBAAgB,CAEzC;IAED;;;;OAIG;IACI,YAAY,IAAI,WAAW,GAAG,SAAS,CAE7C;IAED;;;;;;;;;;OAUG;IACI,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAqB7C;IAED;;;;;OAKG;IACI,YAAY,IAAI,MAAM,GAAG,IAAI,CAMnC;IAED;;;;OAIG;IACI,YAAY,IAAI,OAAO,CAE7B;CACF"}

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

@@ -1,210 +0,0 @@
-import { logger } from '../../../utils/internal/logger.js';
-import { idGenerator } from '../../../utils/security/idGenerator.js';
-import { ATTR_MCP_TASK_STATUS, ATTR_MCP_TASK_STORE_TYPE } from '../../../utils/telemetry/attributes.js';
-import { createCounter, createObservableGauge } from '../../../utils/telemetry/metrics.js';
-import { EvictingTaskMessageQueue } from './evictingTaskMessageQueue.js';
-import { SessionAwareTaskStore } from './sessionAwareTaskStore.js';
-import { StorageBackedTaskStore } from './storageBackedTaskStore.js';
-import { DEFAULT_AUTO_TASK_TTL_MS, InMemoryTaskMessageQueue, InMemoryTaskStore, } from './taskTypes.js';
-// ---------------------------------------------------------------------------
-// Task lifecycle metrics
-// ---------------------------------------------------------------------------
-let taskCreatedCounter;
-let taskStatusCounter;
-function getTaskMetrics() {
-    taskCreatedCounter ??= createCounter('mcp.tasks.created', 'Total tasks created', '{tasks}');
-    taskStatusCounter ??= createCounter('mcp.tasks.status_changes', 'Total task status transitions', '{transitions}');
-    return { taskCreatedCounter, taskStatusCounter };
-}
-/**
- * Wraps a TaskStore to record lifecycle metrics on create, status update,
- * and result storage. Delegates all actual logic to the inner store.
- */
-class InstrumentedTaskStore {
-    inner;
-    storeTypeLabel;
-    constructor(inner, storeTypeLabel) {
-        this.inner = inner;
-        this.storeTypeLabel = storeTypeLabel;
-    }
-    async createTask(taskParams, requestId, request, sessionId) {
-        const task = await this.inner.createTask(taskParams, requestId, request, sessionId);
-        getTaskMetrics().taskCreatedCounter.add(1, {
-            [ATTR_MCP_TASK_STORE_TYPE]: this.storeTypeLabel,
-        });
-        return task;
-    }
-    async storeTaskResult(taskId, status, result, sessionId) {
-        await this.inner.storeTaskResult(taskId, status, result, sessionId);
-        getTaskMetrics().taskStatusCounter.add(1, {
-            [ATTR_MCP_TASK_STATUS]: status,
-            [ATTR_MCP_TASK_STORE_TYPE]: this.storeTypeLabel,
-        });
-    }
-    async updateTaskStatus(taskId, status, statusMessage, sessionId) {
-        await this.inner.updateTaskStatus(taskId, status, statusMessage, sessionId);
-        getTaskMetrics().taskStatusCounter.add(1, {
-            [ATTR_MCP_TASK_STATUS]: status,
-            [ATTR_MCP_TASK_STORE_TYPE]: this.storeTypeLabel,
-        });
-    }
-    getTask(taskId, sessionId) {
-        return this.inner.getTask(taskId, sessionId);
-    }
-    getTaskResult(taskId, sessionId) {
-        return this.inner.getTaskResult(taskId, sessionId);
-    }
-    listTasks(cursor, sessionId) {
-        return this.inner.listTasks(cursor, sessionId);
-    }
-}
-/**
- * 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;
-        // The SDK's queue only ever deletes on `dequeueAll`, so a task the client
-        // abandons strands its queue for the life of the process. Wrapping it
-        // bounds queue lifetime by the same TTL the task store applies.
-        this.messageQueue = new EvictingTaskMessageQueue(new InMemoryTaskMessageQueue(), config.tasks.defaultTtlMs ?? DEFAULT_AUTO_TASK_TTL_MS);
-        let baseStore;
-        if (this.storeType === 'storage') {
-            baseStore = 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.
-            baseStore = new SessionAwareTaskStore(this.inMemoryTaskStore);
-        }
-        // Wrap with lifecycle metrics (outermost layer)
-        this.taskStore = new InstrumentedTaskStore(baseStore, this.storeType);
-        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 }),
-        });
-        // Wire task count to OTel observable gauge
-        if (this.inMemoryTaskStore) {
-            const store = this.inMemoryTaskStore;
-            createObservableGauge('mcp.tasks.active', 'Number of active tasks in the in-memory store', () => store.getAllTasks().length, '{tasks}');
-        }
-    }
-    /**
-     * 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

@@ -1 +0,0 @@
-{"version":3,"file":"taskManager.js","sourceRoot":"","sources":["../../../../src/mcp-server/tasks/core/taskManager.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAEL,wBAAwB,EACxB,wBAAwB,EACxB,iBAAiB,GAIlB,MAAM,gBAAgB,CAAC;AAExB,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,IAAI,kBAAgE,CAAC;AACrE,IAAI,iBAA+D,CAAC;AAEpE,SAAS,cAAc;IACrB,kBAAkB,KAAK,aAAa,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,SAAS,CAAC,CAAC;IAC5F,iBAAiB,KAAK,aAAa,CACjC,0BAA0B,EAC1B,+BAA+B,EAC/B,eAAe,CAChB,CAAC;IACF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,qBAAqB;IAEN,KAAK;IACL,cAAc;IAFjC,YACmB,KAAgB,EAChB,cAAsB;qBADtB,KAAK;8BACL,cAAc;IAC9B,CAAC;IAEJ,KAAK,CAAC,UAAU,CACd,UAA6B,EAC7B,SAAoB,EACpB,OAAgB,EAChB,SAAkB;QAElB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACpF,cAAc,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE;YACzC,CAAC,wBAAwB,CAAC,EAAE,IAAI,CAAC,cAAc;SAChD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,MAAc,EACd,MAA8B,EAC9B,MAAc,EACd,SAAkB;QAElB,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QACpE,cAAc,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE;YACxC,CAAC,oBAAoB,CAAC,EAAE,MAAM;YAC9B,CAAC,wBAAwB,CAAC,EAAE,IAAI,CAAC,cAAc;SAChD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,MAAc,EACd,MAAsB,EACtB,aAAsB,EACtB,SAAkB;QAElB,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QAC5E,cAAc,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE;YACxC,CAAC,oBAAoB,CAAC,EAAE,MAAM;YAC9B,CAAC,wBAAwB,CAAC,EAAE,IAAI,CAAC,cAAc;SAChD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,SAAkB;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,aAAa,CAAC,MAAc,EAAE,SAAkB;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,CAAC,MAAe,EAAE,SAAkB;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,WAAW;IACL,SAAS,CAAY;IACrB,iBAAiB,GAA6B,IAAI,CAAC;IACnD,YAAY,CAAmB;IAC/B,SAAS,CAA0B;IAC5C,cAAc,GAAG,KAAK,CAAC;IAE/B,YAAY,MAAyB,EAAE,cAA8B;QACnE,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QACxC,0EAA0E;QAC1E,sEAAsE;QACtE,gEAAgE;QAChE,IAAI,CAAC,YAAY,GAAG,IAAI,wBAAwB,CAC9C,IAAI,wBAAwB,EAAE,EAC9B,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,wBAAwB,CACtD,CAAC;QAEF,IAAI,SAAoB,CAAC;QACzB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,SAAS,GAAG,IAAI,sBAAsB,CAAC,cAAc,EAAE;gBACrD,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;gBAC/B,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI;aAC9C,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACjD,wEAAwE;YACxE,0EAA0E;YAC1E,SAAS,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChE,CAAC;QAED,gDAAgD;QAChD,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAqB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAEtE,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,SAAS,aAAa,EAAE;YACvE,SAAS,EAAE,yBAAyB;YACpC,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;YACtC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;SACzE,CAAC,CAAC;QAEH,2CAA2C;QAC3C,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC;YACrC,qBAAqB,CACnB,kBAAkB,EAClB,+CAA+C,EAC/C,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,EAChC,SAAS,CACV,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;;;;;;OASG;IACI,eAAe;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;;;;;;;;;OAUG;IACI,OAAO,CAAC,OAAwB;QACrC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAE3B,MAAM,UAAU,GAAG,OAAO,IAAI;YAC5B,SAAS,EAAE,qBAAqB;YAChC,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;YACtC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE,UAAU,CAAC,CAAC;QAEhE,4CAA4C;QAC5C,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACI,YAAY;QACjB,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC;QACrD,CAAC;QACD,wEAAwE;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}

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"}