@novorb/mcp-core 2.1.1 → 3.0.0

package/dist/task-store.js

@@ -0,0 +1,459 @@
+/**
+ * @novorb/mcp-core - Task stores (server side of MCP Tasks)
+ *
+ * The task wire types and the `TaskStore` contract mirror the open SDK PR
+ * modelcontextprotocol/typescript-sdk#2782 (`@modelcontextprotocol/server/ext/tasks`: `TaskStore`,
+ * `CreateTaskParams`, `TaskAccess`, `InMemoryTaskStore` with its writer `TaskHandle`) field for field,
+ * so a consumer can move to the SDK module when it ships. What mcp-core adds lives on
+ * `ManagedTaskStore`, a superset the PR does not define: `list` (the 2025-11-25 `tasks/list`), `watch`
+ * (status notifications and the blocking 2025 `tasks/result`), `updateContext` and `close`.
+ *
+ * - `InMemoryTaskStore`: records in a Map, TTL purge on a timer (the PR's reference store).
+ * - `FileTaskStore`: one JSON file per task under the data store (`tasks/<id>.json`, atomic writes), so
+ *   tasks survive a restart and several processes on one host share them; cancellation written by
+ *   another process reaches the running work through a status poll. `createTaskStore` falls back to
+ *   memory when DATA_STORAGE=false.
+ *
+ * Isolation: a task created by an authenticated request carries the caller's `clientId` as
+ * `principal`; every read or write from another principal behaves exactly like an unknown task (no
+ * existence leak). A task created without a principal (stdio) is visible to every caller of the store.
+ */
+import { randomUUID } from 'node:crypto';
+import { readdir } from 'node:fs/promises';
+import { decodeCursor, encodeCursor } from './pagination.js';
+/** The MCP Tasks extension identifier (2026-07-28). */
+export const TASKS_EXTENSION_ID = 'io.modelcontextprotocol/tasks';
+/** All task statuses, in lifecycle order (terminal states last). */
+export const TASK_STATUSES = ['working', 'input_required', 'completed', 'failed', 'cancelled'];
+const TERMINAL = new Set(['completed', 'failed', 'cancelled']);
+/** Whether `status` is terminal (completed, failed, cancelled). */
+export function isTerminalStatus(status) {
+    return TERMINAL.has(status);
+}
+function validateParams(params) {
+    if (params.ttlMs !== null && (!Number.isSafeInteger(params.ttlMs) || params.ttlMs < 0)) {
+        throw new RangeError(`ttlMs must be a non-negative integer or null, got ${params.ttlMs}`);
+    }
+    if (params.pollIntervalMs !== undefined &&
+        (!Number.isSafeInteger(params.pollIntervalMs) || params.pollIntervalMs < 0)) {
+        throw new RangeError(`pollIntervalMs must be a non-negative integer, got ${params.pollIntervalMs}`);
+    }
+}
+function clearInput(record) {
+    record.inputRequests = undefined;
+    record.inputResponses = undefined;
+    record.inputRound = undefined;
+}
+function snapshot(record) {
+    return {
+        taskId: record.taskId,
+        status: record.status,
+        ...(record.statusMessage !== undefined ? { statusMessage: record.statusMessage } : {}),
+        createdAt: new Date(record.createdAt).toISOString(),
+        lastUpdatedAt: new Date(record.lastUpdatedAt).toISOString(),
+        ttlMs: record.ttlMs,
+        ...(record.pollIntervalMs !== undefined ? { pollIntervalMs: record.pollIntervalMs } : {}),
+    };
+}
+function detailed(record) {
+    const base = snapshot(record);
+    switch (record.status) {
+        case 'working':
+            return { ...base, status: 'working' };
+        case 'input_required': {
+            const inputRequests = {};
+            for (const [key, request] of Object.entries(record.inputRequests ?? {})) {
+                if (!(key in (record.inputResponses ?? {})))
+                    inputRequests[key] = request;
+            }
+            return { ...base, status: 'input_required', inputRequests };
+        }
+        case 'completed':
+            return { ...base, status: 'completed', result: (record.result ?? { content: [] }) };
+        case 'failed':
+            return { ...base, status: 'failed', error: record.error ?? { code: -32603, message: 'Task failed' } };
+        case 'cancelled':
+            return { ...base, status: 'cancelled' };
+    }
+}
+function visible(record, access) {
+    return record !== undefined && (record.principal === undefined || record.principal === access?.principal);
+}
+function isListCursor(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        !Array.isArray(data) &&
+        typeof data.o === 'number' &&
+        Number.isInteger(data.o) &&
+        data.o >= 0);
+}
+function pageOf(records, options = {}) {
+    const limit = Math.max(1, Math.min(options.limit ?? 100, 1000));
+    const offset = options.cursor ? decodeCursor(options.cursor, { validate: isListCursor }).o : 0;
+    const sorted = [...records].sort((a, b) => b.createdAt - a.createdAt || a.taskId.localeCompare(b.taskId));
+    const slice = sorted.slice(offset, offset + limit).map(snapshot);
+    const end = offset + limit;
+    return { tasks: slice, ...(end < sorted.length ? { nextCursor: encodeCursor({ o: end }) } : {}) };
+}
+/** Shared bookkeeping for both stores: listeners, abort controllers, input waiters. */
+class BaseTaskStore {
+    createTaskId;
+    now;
+    aborts = new Map();
+    listeners = new Map();
+    waiters = new Map();
+    constructor(options = {}) {
+        this.createTaskId = options.createTaskId ?? (() => randomUUID());
+        this.now = options.now ?? (() => Date.now());
+    }
+    abortController(taskId) {
+        let controller = this.aborts.get(taskId);
+        if (!controller) {
+            controller = new AbortController();
+            this.aborts.set(taskId, controller);
+        }
+        return controller;
+    }
+    emit(record) {
+        const set = this.listeners.get(record.taskId);
+        if (!set)
+            return;
+        const task = detailed(record);
+        for (const listener of [...set]) {
+            try {
+                listener(task);
+            }
+            catch {
+                // A failing observer never affects the task.
+            }
+        }
+    }
+    async save(record) {
+        record.lastUpdatedAt = this.now();
+        await this.write(record);
+        this.emit(record);
+    }
+    expired(record) {
+        return record.ttlMs !== null && record.createdAt + record.ttlMs <= this.now();
+    }
+    async live(taskId) {
+        const record = await this.read(taskId);
+        if (!record)
+            return undefined;
+        if (this.expired(record)) {
+            await this.purge(taskId);
+            return undefined;
+        }
+        return record;
+    }
+    /**
+     * Hand a completed round of answers to this process's waiting `requireInput`. The answers may have
+     * been written by another process sharing the store (the file store calls this from its poll).
+     */
+    settleInput(record) {
+        const waiter = this.waiters.get(record.taskId);
+        if (!waiter || record.status !== 'working' || record.inputRound !== waiter.round || !record.inputResponses) {
+            return;
+        }
+        this.waiters.delete(record.taskId);
+        waiter.resolve(record.inputResponses);
+    }
+    async purge(taskId) {
+        this.aborts.get(taskId)?.abort();
+        this.aborts.delete(taskId);
+        this.waiters.delete(taskId);
+        await this.forget(taskId);
+    }
+    async create(params) {
+        validateParams(params);
+        const now = this.now();
+        const record = {
+            taskId: this.createTaskId(),
+            ...(params.principal !== undefined ? { principal: params.principal } : {}),
+            ...(params.context !== undefined ? { context: params.context } : {}),
+            status: 'working',
+            createdAt: now,
+            lastUpdatedAt: now,
+            ttlMs: params.ttlMs,
+            ...(params.pollIntervalMs !== undefined ? { pollIntervalMs: params.pollIntervalMs } : {}),
+        };
+        await this.write(record);
+        this.abortController(record.taskId);
+        this.scheduled(record);
+        return snapshot(record);
+    }
+    /** Hook: the in-memory store arms its TTL timer here. */
+    scheduled(_record) { }
+    async get(taskId, access) {
+        const record = await this.live(taskId);
+        return visible(record, access) ? detailed(record) : undefined;
+    }
+    async update(taskId, inputResponses, access) {
+        const record = await this.live(taskId);
+        if (!visible(record, access))
+            return false;
+        if (record.status !== 'input_required' || !record.inputRequests)
+            return true;
+        const responses = { ...(record.inputResponses ?? {}) };
+        for (const [key, response] of Object.entries(inputResponses)) {
+            // Unknown keys are ignored; the first answer to a key wins.
+            if (key in record.inputRequests && !(key in responses))
+                responses[key] = response;
+        }
+        record.inputResponses = responses;
+        const complete = Object.keys(record.inputRequests).every((key) => key in responses);
+        if (complete) {
+            record.status = 'working';
+            record.inputRequests = undefined;
+        }
+        await this.save(record);
+        if (complete)
+            this.settleInput(record);
+        return true;
+    }
+    async cancel(taskId, access) {
+        const record = await this.live(taskId);
+        if (!visible(record, access))
+            return false;
+        if (isTerminalStatus(record.status))
+            return true;
+        record.status = 'cancelled';
+        clearInput(record);
+        await this.save(record);
+        this.aborts.get(taskId)?.abort();
+        this.waiters.delete(taskId);
+        return true;
+    }
+    async list(access, options) {
+        const records = [];
+        for (const record of await this.all()) {
+            if (this.expired(record))
+                await this.purge(record.taskId);
+            else if (visible(record, access))
+                records.push(record);
+        }
+        return pageOf(records, options);
+    }
+    async context(taskId) {
+        return (await this.live(taskId))?.context;
+    }
+    async updateContext(taskId, patch) {
+        const record = await this.live(taskId);
+        if (!record)
+            return false;
+        record.context = { ...record.context, ...patch };
+        await this.save(record);
+        return true;
+    }
+    watch(taskId, listener) {
+        let set = this.listeners.get(taskId);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(taskId, set);
+        }
+        set.add(listener);
+        return () => {
+            set.delete(listener);
+            if (set.size === 0)
+                this.listeners.delete(taskId);
+        };
+    }
+    handle(taskId) {
+        const signal = this.abortController(taskId).signal;
+        const running = async () => {
+            const record = await this.live(taskId);
+            if (!record || isTerminalStatus(record.status))
+                return undefined;
+            return record;
+        };
+        return {
+            taskId,
+            signal,
+            status: async (message) => {
+                const record = await running();
+                if (!record)
+                    return;
+                record.statusMessage = message;
+                await this.save(record);
+            },
+            requireInput: async (requests) => {
+                const record = await running();
+                if (!record)
+                    throw new Error(`Task "${taskId}" is no longer running`);
+                const round = randomUUID();
+                record.status = 'input_required';
+                record.inputRequests = requests;
+                record.inputResponses = {};
+                record.inputRound = round;
+                const answered = new Promise((resolve, reject) => {
+                    this.waiters.set(taskId, { round, resolve });
+                    signal.addEventListener('abort', () => reject(new Error(`Task "${taskId}" was cancelled`)), { once: true });
+                });
+                await this.save(record);
+                return answered;
+            },
+            complete: async (result) => {
+                const record = await running();
+                if (!record)
+                    return;
+                record.status = 'completed';
+                record.result = result;
+                clearInput(record);
+                await this.save(record);
+            },
+            fail: async (error) => {
+                const record = await running();
+                if (!record)
+                    return;
+                record.status = 'failed';
+                record.error = error;
+                clearInput(record);
+                await this.save(record);
+            },
+        };
+    }
+}
+/** The in-process reference store (PR #2782 `InMemoryTaskStore`, plus the `ManagedTaskStore` extras). */
+export class InMemoryTaskStore extends BaseTaskStore {
+    tasks = new Map();
+    timers = new Map();
+    async read(taskId) {
+        return this.tasks.get(taskId);
+    }
+    async write(record) {
+        this.tasks.set(record.taskId, record);
+    }
+    async all() {
+        return [...this.tasks.values()];
+    }
+    async forget(taskId) {
+        const timer = this.timers.get(taskId);
+        if (timer)
+            clearTimeout(timer);
+        this.timers.delete(taskId);
+        this.tasks.delete(taskId);
+    }
+    scheduled(record) {
+        if (record.ttlMs === null)
+            return;
+        const timer = setTimeout(() => void this.purge(record.taskId), record.ttlMs);
+        timer.unref?.();
+        this.timers.set(record.taskId, timer);
+    }
+    close() {
+        for (const timer of this.timers.values())
+            clearTimeout(timer);
+        this.timers.clear();
+        for (const controller of this.aborts.values())
+            controller.abort();
+        this.aborts.clear();
+        this.tasks.clear();
+        this.listeners.clear();
+    }
+}
+const TASK_DIR = 'tasks';
+/** A store of JSON files under the data store (`<DATA_PATH>/tasks/<taskId>.json`). */
+export class FileTaskStore extends BaseTaskStore {
+    data;
+    pollers = new Map();
+    sweeper;
+    cancelPollMs;
+    constructor(data, options = {}) {
+        super(options);
+        this.data = data;
+        if (!data.enabled)
+            throw new Error('FileTaskStore needs an enabled data store (DATA_STORAGE=true)');
+        this.cancelPollMs = options.cancelPollMs ?? 1000;
+        this.sweeper = setInterval(() => void this.list().catch(() => undefined), options.sweepMs ?? 60_000);
+        this.sweeper.unref?.();
+    }
+    file(taskId) {
+        if (!/^[A-Za-z0-9_-]{1,128}$/.test(taskId))
+            throw new Error('invalid task id');
+        return `${TASK_DIR}/${taskId}.json`;
+    }
+    async read(taskId) {
+        let file;
+        try {
+            file = this.file(taskId);
+        }
+        catch {
+            return undefined;
+        }
+        const raw = await this.data.readFile(file);
+        if (!raw)
+            return undefined;
+        try {
+            return JSON.parse(raw.toString('utf8'));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async write(record) {
+        await this.data.writeFile(this.file(record.taskId), JSON.stringify(record));
+    }
+    async all() {
+        let names;
+        try {
+            names = await readdir(this.data.resolveInside(TASK_DIR));
+        }
+        catch {
+            return [];
+        }
+        const records = [];
+        for (const name of names) {
+            if (!name.endsWith('.json'))
+                continue;
+            const record = await this.read(name.slice(0, -'.json'.length));
+            if (record)
+                records.push(record);
+        }
+        return records;
+    }
+    async forget(taskId) {
+        this.stopPolling(taskId);
+        await this.data.remove(this.file(taskId));
+    }
+    stopPolling(taskId) {
+        const poller = this.pollers.get(taskId);
+        if (poller)
+            clearInterval(poller);
+        this.pollers.delete(taskId);
+    }
+    handle(taskId) {
+        const handle = super.handle(taskId);
+        // Another process may cancel or answer input through the shared files: poll while the work runs.
+        if (!this.pollers.has(taskId)) {
+            const poller = setInterval(() => {
+                void this.read(taskId).then((record) => {
+                    if (!record || record.status === 'cancelled' || this.expired(record)) {
+                        this.aborts.get(taskId)?.abort();
+                    }
+                    if (record)
+                        this.settleInput(record);
+                    if (!record || isTerminalStatus(record.status))
+                        this.stopPolling(taskId);
+                });
+            }, this.cancelPollMs);
+            poller.unref?.();
+            this.pollers.set(taskId, poller);
+        }
+        return handle;
+    }
+    close() {
+        clearInterval(this.sweeper);
+        for (const poller of this.pollers.values())
+            clearInterval(poller);
+        this.pollers.clear();
+        for (const controller of this.aborts.values())
+            controller.abort();
+        this.aborts.clear();
+        this.listeners.clear();
+    }
+}
+/** A file store when the data store is enabled, otherwise the in-memory store. */
+export function createTaskStore(data, options = {}) {
+    return data?.enabled ? new FileTaskStore(data, options) : new InMemoryTaskStore(options);
+}
+//# sourceMappingURL=task-store.js.map

package/dist/task-store.js.map

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

package/dist/task-tools.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @novorb/mcp-core - Task tools (long-running tools on MCP Tasks, both protocol eras)
+ *
+ * A task tool answers a task handle instead of blocking: the client polls (or, on 2025-11-25, waits
+ * on `tasks/result`) and can cancel. The work runs in this process behind a `ManagedTaskStore`; the
+ * SDK 2.3.1 ships the wire types only, so mcp-core serves the methods itself, per era, with the
+ * shapes of the spec and of SDK PR #2782:
+ *
+ * | | 2025-11-25 (legacy) | 2026-07-28 (modern, `io.modelcontextprotocol/tasks` extension) |
+ * |---|---|---|
+ * | capability | `tasks: { list, cancel, requests: { tools: { call } } }` | `extensions: { 'io.modelcontextprotocol/tasks': {} }` |
+ * | start | `tools/call` with `params.task: { ttl? }` -> `{ task, content }` | `tools/call` from a client declaring the extension -> `{ resultType: 'task', ...task }` |
+ * | poll | `tasks/get` -> Task (`ttl`, `pollInterval`) | `tasks/get` -> DetailedTask (result / error / inputRequests inlined) |
+ * | result | `tasks/result` (blocks until terminal) | inlined in `tasks/get` |
+ * | list | `tasks/list` | none (not in the extension) |
+ * | cancel | `tasks/cancel` -> Task (terminal = -32602) | `tasks/cancel` -> ack (idempotent) |
+ * | input | not supported (no `tasks/result` side channel) | `tasks/update` answers `input_required` |
+ * | status | `notifications/tasks/status` (stdio: the connection is long-lived) | polling only (the extension has no notifications yet) |
+ *
+ * A client without task support (no `params.task`, no declared extension) gets the tool run
+ * synchronously: the same `run` with progress notifications, unless `taskSupport: 'required'`.
+ * Tasks are bound to the creating caller's `clientId`.
+ *
+ *   registerTaskTools(server, [
+ *     defineTaskTool({
+ *       name: 'export_report', description: 'Export a report', inputSchema: z.object({ report: z.string() }),
+ *       annotations: TOOL_ANNOTATIONS.mutableWriteOpenWorld,
+ *       run: async ({ report }, task) => {
+ *         for (let i = 1; i <= 10; i++) { task.signal.throwIfAborted(); await step(); await task.progress(i, 10); }
+ *         return toolResult({ report, rows: 42 });
+ *       },
+ *     }),
+ *   ], { store, request: req, env });
+ */
+import { type AuthInfo, type InputRequests, type InputResponses, type ServerContext, type StandardSchemaWithJSON } from '@modelcontextprotocol/server';
+import type { McpServer } from './server.js';
+import { type ManagedTaskStore, type Task } from './task-store.js';
+import { type RegisterToolsOptions, registerTools, type ToolArgs, type ToolDefinition, type ToolOutcome } from './tools.js';
+import type { RequestContext } from './transport.js';
+import { type Logger } from './utils/logger.js';
+/** What a task tool's `run` receives (both modes). */
+export interface TaskContext {
+    /** `task`: running behind a task handle; `sync`: the client has no task support. */
+    mode: 'task' | 'sync';
+    /** The task id (task mode only). */
+    taskId?: string;
+    /** Aborted on `tasks/cancel` (task mode) or the request's cancellation (sync mode). */
+    signal: AbortSignal;
+    authInfo?: AuthInfo;
+    logger: Logger;
+    /** Report progress: the task's `statusMessage` (task mode) or a progress notification (sync mode). */
+    progress(current: number, total?: number, message?: string): Promise<void>;
+    /** Set the task's `statusMessage` (task mode; a progress message in sync mode). */
+    status(message: string): Promise<void>;
+    /**
+     * Ask the client for input mid-task (2026-07-28 `input_required` + `tasks/update`). Rejects in sync
+     * mode and on 2025-era tasks (use `ToolContext.elicit` in a plain tool there).
+     */
+    requireInput(requests: InputRequests): Promise<InputResponses>;
+}
+export interface TaskToolDefinition<I extends StandardSchemaWithJSON = StandardSchemaWithJSON> extends Omit<ToolDefinition<I>, 'handler' | 'outputSchema' | 'paginated'> {
+    /** `optional` (default): sync for clients without task support; `required`: refuse them. */
+    taskSupport?: 'optional' | 'required';
+    /** Retention of a task from creation, ms (default 1 hour; a 2025 client's `ttl` may lower it). */
+    ttlMs?: number;
+    /** Suggested polling interval, ms (default 1000). */
+    pollIntervalMs?: number;
+    run: (args: ToolArgs<I>, task: TaskContext) => Promise<ToolOutcome>;
+}
+export type AnyTaskToolDefinition = Omit<TaskToolDefinition, 'run'> & {
+    run: (args: never, task: TaskContext) => Promise<ToolOutcome>;
+};
+/** Identity helper that types `run` from the tool's own input schema. */
+export declare function defineTaskTool<I extends StandardSchemaWithJSON>(definition: TaskToolDefinition<I>): AnyTaskToolDefinition;
+/** The 2025-11-25 wire shape of a task (`ttl`, `pollInterval`). */
+export interface LegacyTask {
+    taskId: string;
+    status: Task['status'];
+    ttl: number | null;
+    createdAt: string;
+    lastUpdatedAt: string;
+    pollInterval?: number;
+    statusMessage?: string;
+}
+/** Map a task onto the 2025-11-25 wire shape. */
+export declare function toLegacyTask(task: Task): LegacyTask;
+/** Whether a 2026-07-28 request declared the tasks extension in its envelope capabilities. */
+export declare function declaresTasksExtension(sdk: ServerContext): boolean;
+export interface EnableTasksOptions {
+    /** The request era this instance serves (the factory's `req.era`). */
+    era: 'legacy' | 'modern';
+    /** How often a blocking 2025 `tasks/result` re-reads the store (ms, default 1000). */
+    resultPollMs?: number;
+}
+/**
+ * Serve the task methods for this instance's era and advertise the matching capability (call before
+ * the instance is connected; `registerTaskTools` does it). Idempotent.
+ */
+export declare function enableTasks(server: McpServer, store: ManagedTaskStore, options: EnableTasksOptions): void;
+export interface RegisterTaskToolsOptions extends Omit<RegisterToolsOptions, 'limits' | 'onOversize'> {
+    /** Where tasks live (shared state from `setup`: one store for every request of the process). */
+    store: ManagedTaskStore;
+    /** The factory's request context (selects the era's methods and capability). */
+    request: Pick<RequestContext, 'era'>;
+    /** Max serialized bytes of a stored task result (default MCP_MAX_RESULT_BYTES). */
+    maxResultBytes?: number;
+    /** How often a blocking 2025 `tasks/result` re-reads the store (ms). */
+    resultPollMs?: number;
+}
+/**
+ * Register task tools on `server` (through `registerTools`, so logging, masking, degraded mode and
+ * the enabled/prefix/surface options are the same) and enable the era's task methods.
+ */
+export declare function registerTaskTools(server: McpServer, defs: readonly AnyTaskToolDefinition[], opts: RegisterTaskToolsOptions): ReturnType<typeof registerTools>;
+//# sourceMappingURL=task-tools.d.ts.map

package/dist/task-tools.d.ts.map

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