@mastra/mcp 2.6.0 → 2.7.0

package/dist/server/tasks/handlers.d.ts

@@ -0,0 +1,33 @@
+import { RequestContext } from '@mastra/core/request-context';
+import type { Server, ServerContext } from '@modelcontextprotocol/server';
+import type { MCPDetailedTask } from '../../shared/tasks/index.js';
+import type { MCPTaskStore, MCPTaskTrace } from './store.js';
+/** How a `tasks/*` request is traced. */
+export interface TaskRequestTracing {
+    /** Run without a span: polls are frequent and change nothing. */
+    untraced?: boolean;
+    /** The task's trace, which the request's span joins; `undefined` traces the request on its own. */
+    parentOf?: (requestContext: RequestContext) => Promise<MCPTaskTrace | undefined>;
+    /** Recorded on the request's span. Never the task id, which is a bearer token. */
+    metadata?: Record<string, unknown>;
+}
+export interface TaskHandlerDeps {
+    store: MCPTaskStore;
+    /** Resolves the request's context and runs `fn` under the request's span. Defaults to an empty context, untraced. */
+    trace?: <T>(server: Server, method: string, params: Record<string, unknown>, ctx: ServerContext, fn: (requestContext: RequestContext) => Promise<T>, tracing?: TaskRequestTracing) => Promise<T>;
+    /** The authenticated caller of a request, as tasks are bound to it at creation. */
+    principal: (ctx: ServerContext, requestContext: RequestContext) => string | Promise<string>;
+    /** Further narrows which callers may read, answer or cancel a task they created. */
+    authorize?: (context: {
+        principal: string;
+        task: MCPDetailedTask;
+        requestContext: RequestContext;
+    }) => boolean | Promise<boolean>;
+}
+/**
+ * Registers `tasks/get`, `tasks/update` and `tasks/cancel` on one protocol instance. They are
+ * registered with explicit schemas, which the SDK requires to serve the Tasks extension's methods on
+ * the 2026-07-28 revision.
+ */
+export declare function registerTaskHandlers(server: Server, deps: TaskHandlerDeps): void;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/server/tasks/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../../src/server/tasks/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAW1E,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mGAAmG;IACnG,QAAQ,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACjF,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,qHAAqH;IACrH,KAAK,CAAC,EAAE,CAAC,CAAC,EACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,aAAa,EAClB,EAAE,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,EAClD,OAAO,CAAC,EAAE,kBAAkB,KACzB,OAAO,CAAC,CAAC,CAAC,CAAC;IAChB,mFAAmF;IACnF,SAAS,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,oFAAoF;IACpF,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,eAAe,CAAC;QACtB,cAAc,EAAE,cAAc,CAAC;KAChC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAkFhF"}

package/dist/server/tasks/in-memory-store.d.ts

@@ -0,0 +1,71 @@
+import type { CallToolResult } from '@modelcontextprotocol/server';
+import type { MCPDetailedTask, MCPTask, MCPTaskError, MCPTaskInputRequests, MCPTaskInputResponses } from '../../shared/tasks/index.js';
+import type { MCPTaskAccess, MCPTaskAdminOutcome, MCPTaskCreateParams, MCPTaskListOptions, MCPTaskListPage, MCPTaskRunOptions, MCPTaskStore, MCPTaskStoreAdmin, MCPTaskTrace, MCPTaskWork } from './store.js';
+/**
+ * Writes the state of one in-memory task. The code executing the task holds it.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPTaskHandle {
+    readonly taskId: string;
+    /** Aborts when the task is cancelled or expires. */
+    readonly signal: AbortSignal;
+    /** Sets the status message shown while the task works. */
+    status(message: string): void;
+    /**
+     * Moves the task to `input_required` and resolves with the client's answers once every key is
+     * answered. Keys must be unique over the task's lifetime. Rejects if the task is cancelled or expires.
+     */
+    requireInput(requests: MCPTaskInputRequests): Promise<MCPTaskInputResponses>;
+    complete(result: CallToolResult): void;
+    fail(error: MCPTaskError): void;
+}
+/** @experimental SEP-2663 extension; API may change. */
+export interface InMemoryMCPTaskStoreOptions {
+    /** How long an expired task still answers `failed` before it is forgotten. Default 60 seconds. */
+    expiredRetentionMs?: number;
+    /** Clock, for tests. Default `Date.now`. */
+    now?: () => number;
+    /**
+     * Called with a task's context when it is cancelled or expires before finishing, even while no
+     * attempt runs (e.g. while it waits for input). Stops whatever the task stands for outside the
+     * store, such as a suspended workflow run. Not awaited: the cancel answers and expiry goes on
+     * without waiting for it. Errors are ignored; report them from the hook.
+     */
+    onCancel?: (context: Record<string, unknown>) => void | Promise<void>;
+}
+/**
+ * Default {@link MCPTaskStore}: tasks live in this process. A task created here can only be read on
+ * the same instance and does not survive a restart, so use it for single-instance servers.
+ *
+ * When a task's TTL elapses its work is aborted and it turns `failed`; it is forgotten after
+ * `expiredRetentionMs`. Finished tasks stay in memory until then, so `limits.retainedPerPrincipal`
+ * and `limits.retainedTotal` bound how many tasks it holds; a task with a `null` TTL counts until
+ * the store closes.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export declare class InMemoryMCPTaskStore implements MCPTaskStore, MCPTaskStoreAdmin {
+    #private;
+    constructor(options?: InMemoryMCPTaskStoreOptions);
+    create(params: MCPTaskCreateParams, { clientLabel }?: {
+        clientLabel?: string;
+    }): Promise<MCPTask>;
+    get(taskId: string, access: MCPTaskAccess): Promise<MCPDetailedTask | undefined>;
+    update(taskId: string, inputResponses: MCPTaskInputResponses, access: MCPTaskAccess): Promise<boolean>;
+    cancel(taskId: string, access: MCPTaskAccess): Promise<boolean>;
+    list(options?: MCPTaskListOptions): Promise<MCPTaskListPage>;
+    updateByKey(taskKey: string, inputResponses: MCPTaskInputResponses): Promise<MCPTaskAdminOutcome>;
+    cancelByKey(taskKey: string): Promise<MCPTaskAdminOutcome>;
+    traceOf(taskId: string, access: MCPTaskAccess): Promise<MCPTaskTrace | undefined>;
+    /** Whether this store holds the task, for any caller. */
+    has(taskId: string): boolean;
+    /** The context recorded at creation. */
+    context(taskId: string): Record<string, unknown> | undefined;
+    run(taskId: string, work: MCPTaskWork, options?: MCPTaskRunOptions): void;
+    /** The writer for a task this store holds. Writes after the task is terminal are ignored. */
+    handle(taskId: string): MCPTaskHandle;
+    /** Cancels all running work, invalidates every handle and forgets every task. */
+    close(): void;
+}
+//# sourceMappingURL=in-memory-store.d.ts.map

package/dist/server/tasks/in-memory-store.d.ts.map

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

package/dist/server/tasks/index.d.ts

@@ -0,0 +1,9 @@
+export { isMCPTaskStoreAdmin, principalKeyOf, taskKeyOf } from './store.js';
+export type { MCPTaskAccess, MCPTaskAdminOutcome, MCPTaskListing, MCPTaskListOptions, MCPTaskListPage, MCPTaskStoreAdmin, MCPTaskAttempt, MCPTaskAttemptTrace, MCPTaskTrace, MCPTaskAttemptOutcome, MCPTaskCreateParams, MCPTaskLimits, MCPTaskRunOptions, MCPTaskStore, MCPTaskWork, } from './store.js';
+export { MCPTaskLimitError } from './store.js';
+export { InMemoryMCPTaskStore } from './in-memory-store.js';
+export type { InMemoryMCPTaskStoreOptions, MCPTaskHandle } from './in-memory-store.js';
+export type { MCPServerTaskAuthorizeContext, MCPServerTaskMode, MCPServerTasksOptions, MCPServerToolTaskConfig, MCPServerWorkflowTaskConfig, } from './config.js';
+export { isWorkflowTaskContext } from './workflow-runs.js';
+export type { WorkflowTaskContext } from './workflow-runs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/tasks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/tasks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzE,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACpF,YAAY,EACV,6BAA6B,EAC7B,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/server/tasks/inspector.d.ts

@@ -0,0 +1,13 @@
+import type { MCPServerTaskSurfaceInfo, MCPServerTasksInfo, MCPServerTasksInspector } from '@mastra/core/mcp';
+import type { MCPToolType } from '@mastra/core/tools';
+import type { ResolvedTasksConfig } from './config.js';
+import type { MCPTaskStoreAdmin } from './store.js';
+/** The tools served as tasks, as Studio shows them. */
+export declare function listTaskSurfaces(tasks: ResolvedTasksConfig, tools: Array<[name: string, toolType: MCPToolType | undefined]>): MCPServerTaskSurfaceInfo[];
+export declare function tasksInfo(tasks: ResolvedTasksConfig, tools: Array<[name: string, toolType: MCPToolType | undefined]>): MCPServerTasksInfo;
+/**
+ * Studio's view of the task store. Cancel and answer go through the store's `cancelByKey` and
+ * `updateByKey`, the same code as `tasks/cancel` and `tasks/update`.
+ */
+export declare function createTasksInspector(admin: () => Promise<MCPTaskStoreAdmin | undefined>): MCPServerTasksInspector;
+//# sourceMappingURL=inspector.d.ts.map

package/dist/server/tasks/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../../src/server/tasks/inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjE,uDAAuD;AACvD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC,GAC9D,wBAAwB,EAAE,CAe5B;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC,GAC9D,kBAAkB,CAOpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,GAAG,uBAAuB,CAsBjH"}

package/dist/server/tasks/store.d.ts

@@ -0,0 +1,260 @@
+import type { CallToolResult } from '@modelcontextprotocol/server';
+import type { MCPDetailedTask, MCPTask, MCPTaskInputRequests, MCPTaskInputResponses, MCPTaskStatus } from '../../shared/tasks/index.js';
+export { taskKeyOf } from '../../shared/tasks/index.js';
+/** How a principal is stored and shown. Principals can carry user and subject ids, so only their hash is kept. */
+export declare function principalKeyOf(principal: string): string;
+/**
+ * What {@link MCPTaskStore.create} durably records.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPTaskCreateParams {
+    /** Retention from creation in ms; `null` keeps the task until the store is cleared. */
+    ttlMs: number | null;
+    /** Fixed poll interval to suggest. Omit to let the store suggest one that grows with the task's age. */
+    pollIntervalMs?: number;
+    /** The authenticated caller that created the task. Only the same principal can read, answer or cancel it. */
+    principal: string;
+    /** Store-defined data the server's execution needs to find the work again, e.g. a workflow run id. */
+    context?: Record<string, unknown>;
+    /** The span of the request that created the task. Kept with the task so every attempt joins its trace. */
+    trace?: MCPTaskTrace;
+    /**
+     * Most open (`working` or `input_required`) tasks allowed for this principal and for the whole
+     * store, counting the one being created, plus the optional retained-task bounds. Over any of them,
+     * `create` rejects with {@link MCPTaskLimitError} and records nothing. Omitted: no limit.
+     */
+    limits?: MCPTaskLimits;
+}
+/** @experimental SEP-2663 extension; API may change. */
+export interface MCPTaskLimits {
+    perPrincipal: number;
+    total: number;
+    /**
+     * Most tasks the store may hold for this principal and in total, open or finished but not yet
+     * forgotten, counting the one being created. A store that keeps finished results outside process
+     * memory may ignore these.
+     */
+    retainedPerPrincipal?: number;
+    retainedTotal?: number;
+}
+/**
+ * Thrown by {@link MCPTaskStore.create} when the task would go over one of its `limits`.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export declare class MCPTaskLimitError extends Error {
+    readonly scope: 'principal' | 'total';
+    readonly limit: number;
+    /** `'open'` for the open-task limits, `'retained'` for the retained ones. */
+    readonly kind: 'open' | 'retained';
+    constructor(scope: 'principal' | 'total', limit: number, 
+    /** `'open'` for the open-task limits, `'retained'` for the retained ones. */
+    kind?: 'open' | 'retained');
+}
+/**
+ * Where a task's trace starts: the span of the `tools/call` that created it.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPTaskTrace {
+    traceId: string;
+    spanId: string;
+}
+/**
+ * The caller presented on a `tasks/*` request.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPTaskAccess {
+    principal: string;
+}
+/**
+ * Where `MCPServer` keeps MCP tasks. The `tasks/*` handlers call `get`, `update` and `cancel`;
+ * `MCPServer` creates a task and hands its work to `run`. Where the work runs (in-process, on a
+ * background-task worker) is up to the store.
+ *
+ * - `create` must not resolve before an immediate `get(taskId)` would succeed, including on another
+ *   instance when the store is shared (SEP-2663 durable creation).
+ * - `create` enforces `limits` by rejecting with {@link MCPTaskLimitError}. A store that ignores
+ *   `limits` caps nothing.
+ * - `get`, `update` and `cancel` resolve `undefined`/`false` for an unknown, expired or
+ *   foreign-principal task. The server answers all three cases with the same `-32602`.
+ * - `update` ignores unknown and already-answered input keys.
+ * - `cancel` is cooperative: it acknowledges, and the task may still complete or fail. It is a no-op
+ *   on terminal tasks.
+ * - There is deliberately no `list`: task ids are bearer tokens and must not be enumerable.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPTaskStore {
+    create(params: MCPTaskCreateParams): Promise<MCPTask>;
+    get(taskId: string, access: MCPTaskAccess): Promise<MCPDetailedTask | undefined>;
+    update(taskId: string, inputResponses: MCPTaskInputResponses, access: MCPTaskAccess): Promise<boolean>;
+    cancel(taskId: string, access: MCPTaskAccess): Promise<boolean>;
+    /**
+     * Drives `work` for a task this store created: runs it now, runs it again with `resume` once every
+     * open input key is answered, and records each outcome. A rejected attempt marks the task `failed`
+     * (-32603). Outcomes that arrive after the task is terminal are ignored.
+     *
+     * `work` must be a pure function of the `context` given to `create`, so a store that outlives the
+     * process can rebuild and dispatch it again. With `options.initialAttempt`, that attempt stands in
+     * for the first call to `work`; every later attempt still goes through `work`.
+     */
+    run(taskId: string, work: MCPTaskWork, options?: MCPTaskRunOptions): void;
+    /**
+     * The trace given to `create`, for a caller that may `get` the task; `undefined` otherwise.
+     * Lets `tasks/update` and `tasks/cancel` join the task's trace. Optional: without it they are
+     * traced on their own.
+     */
+    traceOf?(taskId: string, access: MCPTaskAccess): Promise<MCPTaskTrace | undefined>;
+}
+/** @experimental SEP-2663 extension; API may change. */
+export interface MCPTaskRunOptions {
+    /**
+     * A first attempt already running in this process, e.g. an `'auto'` tool that outlived its sync
+     * window. The store awaits `outcome` as attempt 1 instead of calling `work`, and calls `abort`
+     * if the task is cancelled or expires meanwhile.
+     *
+     * It is process-local and never persisted: it may hold request-local state, so a durable store
+     * treats it as process-affine and never dispatches it elsewhere.
+     */
+    initialAttempt?: {
+        outcome: Promise<MCPTaskAttemptOutcome>;
+        abort: (reason?: unknown) => void;
+    };
+}
+/**
+ * One run of a task's work. The first attempt has no `resume`; after an `input_required` outcome
+ * the next attempt receives the client's answers.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPTaskAttempt {
+    /** Aborts when the task is cancelled or expires. */
+    signal: AbortSignal;
+    /**
+     * The task's trace and which attempt this is, for the attempt's span. A store that omits it runs
+     * the attempt untraced.
+     */
+    trace?: MCPTaskAttemptTrace;
+    resume?: {
+        /** The answers to every key the previous attempt asked for. */
+        inputResponses: MCPTaskInputResponses;
+        /** What the previous attempt handed back with its input requests. */
+        suspendPayload: unknown;
+    };
+}
+/**
+ * How one attempt ended. Errors raised by the work itself belong in a `completed` result with
+ * `isError: true`; only a rejected attempt makes the task `failed`.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export type MCPTaskAttemptOutcome = {
+    status: 'completed';
+    result: CallToolResult;
+} | {
+    status: 'input_required';
+    /** Keys must be unique over the task's lifetime; a reused key fails the task. */
+    inputRequests: MCPTaskInputRequests;
+    suspendPayload?: unknown;
+};
+/** @experimental SEP-2663 extension; API may change. */
+export interface MCPTaskAttemptTrace extends MCPTaskTrace {
+    /** The task's key, `taskKeyOf(taskId)`: safe to record, unlike the id. */
+    taskKey: string;
+    /** 1 for the first run; counts every retry and resume. */
+    attempt: number;
+    /** Run again with the answers to an `input_required` outcome. */
+    resumed: boolean;
+    /** Run again because an earlier attempt was lost with its process. */
+    recovered: boolean;
+}
+/** @experimental SEP-2663 extension; API may change. */
+export type MCPTaskWork = (attempt: MCPTaskAttempt) => Promise<MCPTaskAttemptOutcome>;
+/**
+ * A task as an {@link MCPTaskStoreAdmin} lists it. Carries the task key, never the task id.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPTaskListing {
+    taskKey: string;
+    /** The principal that created the task, hashed with {@link principalKeyOf}. */
+    principalKey: string;
+    /** Who sent the task, readable for operators (see `clientLabelOf`); never a credential. */
+    clientLabel?: string;
+    /** The `context` given to `create`. */
+    context?: Record<string, unknown>;
+    status: MCPTaskStatus;
+    statusMessage?: string;
+    createdAt: string;
+    lastUpdatedAt: string;
+    ttlMs: number | null;
+    /** Open input requests, while `input_required`. */
+    inputRequests?: MCPTaskInputRequests;
+    result?: Record<string, unknown>;
+    /** A JSON-RPC error object. */
+    error?: Record<string, unknown>;
+}
+/**
+ * Filters for {@link MCPTaskStoreAdmin.list}. Every filter narrows the result.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPTaskListOptions {
+    /** At most this many tasks. Default 50. */
+    limit?: number;
+    /** `nextCursor` of the previous page. */
+    cursor?: string;
+    status?: MCPTaskStatus;
+    /** The tool, workflow or agent name the task runs (`context.toolName`). */
+    surface?: string;
+    principalKey?: string;
+    taskKey?: string;
+}
+/** @experimental SEP-2663 extension; API may change. */
+export interface MCPTaskListPage {
+    listings: MCPTaskListing[];
+    nextCursor?: string;
+}
+/**
+ * Pages lists by creation time. The cursor holds the last listed creation time and the keys
+ * already listed at that time, so tasks created in the same millisecond are neither lost nor repeated.
+ */
+interface TaskListCursor {
+    before: string;
+    seen: string[];
+}
+export declare function decodeTaskListCursor(cursor: string | undefined): TaskListCursor | undefined;
+/** Whether a task comes after the cursor in newest-first order. */
+export declare function isPastTaskListCursor(listing: MCPTaskListing, cursor: TaskListCursor | undefined): boolean;
+/** The cursor for the page after `listings`, newest first. */
+export declare function nextTaskListCursor(listings: MCPTaskListing[], previous: TaskListCursor | undefined): string | undefined;
+/** Whether a listing matches the filters a store could not apply while reading. */
+export declare function matchesTaskListOptions(listing: MCPTaskListing, options: MCPTaskListOptions): boolean;
+/**
+ * What an admin action on a task did: `not_found` for an unknown or expired task, `ignored` when the
+ * task was found but nothing changed (already finished, or not waiting for those inputs).
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export type MCPTaskAdminOutcome = 'done' | 'ignored' | 'not_found';
+/**
+ * Optional admin view of an {@link MCPTaskStore}, for Studio. It is not part of the protocol, and
+ * works on task keys ({@link taskKeyOf}) rather than task ids, across all principals. `updateByKey`
+ * and `cancelByKey` must run the same code as `update` and `cancel`.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPTaskStoreAdmin {
+    /** Most recently created first. `nextCursor` is set when more tasks match. */
+    list(options?: MCPTaskListOptions): Promise<MCPTaskListPage>;
+    updateByKey(taskKey: string, inputResponses: MCPTaskInputResponses): Promise<MCPTaskAdminOutcome>;
+    cancelByKey(taskKey: string): Promise<MCPTaskAdminOutcome>;
+}
+/** @experimental SEP-2663 extension; API may change. */
+export declare function isMCPTaskStoreAdmin(store: MCPTaskStore): store is MCPTaskStore & MCPTaskStoreAdmin;
+/** Projects a detailed task onto a listing. */
+export declare function toListing(taskKey: string, principalKey: string, context: Record<string, unknown> | undefined, task: MCPDetailedTask, clientLabel?: string): MCPTaskListing;
+//# sourceMappingURL=store.d.ts.map

package/dist/server/tasks/store.d.ts.map

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

package/dist/server/tasks/workflow-runs.d.ts

@@ -0,0 +1,63 @@
+import type { StepWithComponent, Workflow, WorkflowRunStatus } from '@mastra/core/workflows';
+/**
+ * What a workflow task records at creation, as `MCPTaskCreateParams.context`. The task follows the
+ * run `runId`, which the server started exactly once when it created the task; nothing here can
+ * start it again. A custom `tasks.store` that cancels or expires a task cancels its run with
+ * `mastra.getWorkflow(workflowKey).createRun({ runId })` then `run.cancel()`.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface WorkflowTaskContext extends Record<string, unknown> {
+    toolName: string;
+    kind: 'workflow';
+    workflowKey: string;
+    runId: string;
+    /** The caller's request context, minus the bearer token. */
+    requestContext: Record<string, unknown>;
+}
+/**
+ * Whether a task's context is a workflow task's.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export declare function isWorkflowTaskContext(context: Record<string, unknown> | undefined): context is WorkflowTaskContext;
+/**
+ * A run as both `run.start()`/`run.resume()` (a `WorkflowResult`) and `getWorkflowRunById` (a
+ * `WorkflowState`) describe it, so a live run and a re-attached one answer the same.
+ */
+export interface WorkflowRunView {
+    status: WorkflowRunStatus;
+    input?: unknown;
+    steps?: Record<string, unknown>;
+    result?: unknown;
+    error?: unknown;
+}
+export declare function isFinalRunStatus(status: WorkflowRunStatus): boolean;
+/** The text a finished run answers with: the same fields the synchronous `run_` tool returns. */
+export declare function runSummary(view: WorkflowRunView): Record<string, unknown>;
+export declare function runErrorMessage(view: WorkflowRunView): string;
+export interface SuspendedStep {
+    /** The path `run.resume({ step })` takes: the step id, then nested steps inside nested workflows. */
+    path: string[];
+    step?: StepWithComponent;
+    /** The payload the step suspended with, without the engine's bookkeeping. */
+    payload: unknown;
+    /** When the step suspended; tells this suspension from a later one of the same step. */
+    suspendedAt?: number;
+}
+/**
+ * The first step the run is suspended on. A run with several (parallel branches) is resumed one at
+ * a time: after each resume it suspends again on the next.
+ */
+export declare function firstSuspendedStep(workflow: Workflow, view: WorkflowRunView): SuspendedStep | undefined;
+/**
+ * Whether `answered` (recorded when the task asked) is still the run's current suspension. Another
+ * resume, from Studio or the API, moves the run on; a step that suspends again gets a new `suspendedAt`.
+ */
+export declare function isStillSuspended(view: WorkflowRunView, answered: AnsweredSuspension): boolean;
+/** What a workflow task keeps of the suspension it asked about, to resume exactly that one. */
+export interface AnsweredSuspension {
+    step: string[];
+    suspendedAt?: number;
+}
+//# sourceMappingURL=workflow-runs.d.ts.map

package/dist/server/tasks/workflow-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-runs.d.ts","sourceRoot":"","sources":["../../../src/server/tasks/workflow-runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE7F;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAoB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,IAAI,mBAAmB,CAElH;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAEnE;AAED,iGAAiG;AACjG,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAK7D;AAED,MAAM,WAAW,aAAa;IAC5B,qGAAqG;IACrG,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,aAAa,GAAG,SAAS,CAavG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAI7F;AAED,+FAA+F;AAC/F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/shared/tasks/capability.d.ts

@@ -0,0 +1,18 @@
+import { TASKS_EXTENSION_ID } from './constants.js';
+/**
+ * Whether a capabilities object declares the Tasks extension. A non-object entry counts as absent,
+ * and the legacy 2025-11-25 top-level `capabilities.tasks` key is ignored: it is not wire-compatible.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export declare function hasTasksCapability(capabilities: {
+    extensions?: Record<string, unknown>;
+} | undefined | null): boolean;
+/**
+ * The `extensions` entry a peer advertises to declare the Tasks extension. SEP-2663 defines no
+ * settings, so the value is an empty object.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export declare function tasksCapabilityEntry(): Record<typeof TASKS_EXTENSION_ID, Record<string, never>>;
+//# sourceMappingURL=capability.d.ts.map

package/dist/shared/tasks/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../../src/shared/tasks/capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAGrH;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,OAAO,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAE/F"}

package/dist/shared/tasks/constants.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Wire constants for the MCP Tasks extension (SEP-2663, protocol revision 2026-07-28).
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+/** Extension identifier used as the key under `capabilities.extensions`. */
+export declare const TASKS_EXTENSION_ID = "io.modelcontextprotocol/tasks";
+export declare const TASKS_METHODS: {
+    readonly get: 'tasks/get';
+    readonly update: 'tasks/update';
+    readonly cancel: 'tasks/cancel';
+};
+/** `resultType` of a `tools/call` result that is a task handle instead of a `CallToolResult`. */
+export declare const TASK_RESULT_TYPE = "task";
+export declare const TASK_STATUSES: readonly ['working', 'input_required', 'completed', 'failed', 'cancelled'];
+export type MCPTaskStatus = (typeof TASK_STATUSES)[number];
+/** `completed`, `failed` and `cancelled` are terminal: the task never changes again. */
+export declare function isTerminalTaskStatus(status: MCPTaskStatus): boolean;
+export declare const TASKS_ERROR_CODES: {
+    /** Unknown, expired or foreign task id. Also used for a principal mismatch, so existence is not revealed. */
+    readonly InvalidParams: -32602;
+    readonly InternalError: -32603;
+    /** The request needs a task but the client did not declare `io.modelcontextprotocol/tasks`. */
+    readonly MissingRequiredClientCapability: -32021;
+};
+/** How long a server keeps a task by default: 24 hours. */
+export declare const DEFAULT_TASK_TTL_MS = 86400000;
+/** Suggested poll interval while a task is young. */
+export declare const DEFAULT_TASK_INITIAL_POLL_INTERVAL_MS = 2000;
+/** Suggested poll interval once a task is older than {@link DEFAULT_TASK_INITIAL_POLL_WINDOW_MS}. */
+export declare const DEFAULT_TASK_POLL_INTERVAL_MS = 5000;
+/** How long a task counts as young for polling purposes. */
+export declare const DEFAULT_TASK_INITIAL_POLL_WINDOW_MS = 60000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/shared/tasks/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/shared/tasks/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,kCAAkC,CAAC;AAElE,eAAO,MAAM,aAAa;aACxB,GAAG,EAAE,WAAW;aAChB,MAAM,EAAE,cAAc;aACtB,MAAM,EAAE,cAAc;CACd,CAAC;AAEX,iGAAiG;AACjG,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,eAAO,MAAM,aAAa,YAAI,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAExG,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAI3D,wFAAwF;AACxF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEnE;AAED,eAAO,MAAM,iBAAiB;IAC5B,6GAA6G;aAC7G,aAAa,EAAE,CAAC,KAAK;aACrB,aAAa,EAAE,CAAC,KAAK;IACrB,+FAA+F;aAC/F,+BAA+B,EAAE,CAAC,KAAK;CAC/B,CAAC;AAEX,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,WAAa,CAAC;AAE9C,qDAAqD;AACrD,eAAO,MAAM,qCAAqC,OAAQ,CAAC;AAE3D,qGAAqG;AACrG,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAEnD,4DAA4D;AAC5D,eAAO,MAAM,mCAAmC,QAAS,CAAC"}

package/dist/shared/tasks/index.d.ts

@@ -0,0 +1,6 @@
+export * from './constants.js';
+export * from './schemas.js';
+export * from './capability.js';
+export * from './task-id.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/tasks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/tasks/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,mBAAmB,SAAS,CAAC"}