@mastra/mcp 2.6.0 → 2.7.0-alpha.0

package/dist/server/index.d.ts

@@ -2,4 +2,5 @@ export * from './server.js';
 export * from './types.js';
 export * from './oauth-middleware.js';
 export * from './events/index.js';
+export * from './tasks/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/server/request.d.ts

@@ -29,6 +29,12 @@ export declare function toRequestContext(ctx: ServerContext, mapAuthInfoToUser:
  * never share a principal. A token refreshed mid-round therefore starts over.
  */
 export declare function principalOf(ctx: ServerContext, requestContext: RequestContext): string;
+/**
+ * A readable name for the caller, for operators debugging a server: the principal, except that a
+ * token principal keeps only a short prefix of the token's hash. Never a credential, so it can be
+ * stored and shown; it is not unique enough to authorize anything.
+ */
+export declare function clientLabelOf(ctx: ServerContext, requestContext: RequestContext): string;
 export declare function hashArguments(value: unknown): string;
 /**
  * What the server signs into `requestState` when a handler suspends. It names the

package/dist/server/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/server/request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAKvD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,uBAAuB,CA0BtG;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,kBAAkB,GAAG,SAAS,CAO9E;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,aAAa,EAClB,iBAAiB,EAAE,uBAAuB,GAAG,SAAS,GACrD,OAAO,CAAC,cAAc,CAAC,CAUzB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAStF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAcD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,GAAG,gBAAgB,GAAG,aAAa,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qEAAqE;AACrE,eAAO,MAAM,SAAS,UAAU,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,sFAAsF;IACtF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC,GACnE,iBAAiB,GAAG,SAAS,CA+B/B"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/server/request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAKvD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,uBAAuB,CA0BtG;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,kBAAkB,GAAG,SAAS,CAO9E;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,aAAa,EAClB,iBAAiB,EAAE,uBAAuB,GAAG,SAAS,GACrD,OAAO,CAAC,cAAc,CAAC,CAUzB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAExF;AAyBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAcD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,YAAY,GAAG,gBAAgB,GAAG,aAAa,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qEAAqE;AACrE,eAAO,MAAM,SAAS,UAAU,CAAC;AAEjC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,sFAAsF;IACtF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC,GACnE,iBAAiB,GAAG,SAAS,CA+B/B"}

package/dist/server/server.d.ts

@@ -1,7 +1,7 @@
 import type * as http from 'node:http';
 import type { Agent, ToolsInput } from '@mastra/core/agent';
 import { MCPServerBase } from '@mastra/core/mcp';
-import type { MCPServerConfig as CoreMCPServerConfig, MCPServerEventInfo, MCPServerEventsInspector, MCPToolExecutionResultV2, ServerDetailInfo, ServerInfo } from '@mastra/core/mcp';
+import type { MCPServerConfig as CoreMCPServerConfig, MCPServerEventInfo, MCPServerEventsInspector, MCPServerTasksInfo, MCPServerTasksInspector, MCPToolExecutionResultV2, ServerDetailInfo, ServerInfo } from '@mastra/core/mcp';
 import { RequestContext } from '@mastra/core/request-context';
 import type { InternalCoreTool, MCPToolType } from '@mastra/core/tools';
 import type { Workflow } from '@mastra/core/workflows';
@@ -9,6 +9,7 @@ import type { Resource, jsonSchemaValidator } from '@modelcontextprotocol/server
 import { ServerPromptActions, ServerResourceActions, ServerToolActions } from './actions.js';
 import { ServerEventActions } from './events/actions.js';
 import type { MCPServerEventDefinition, MCPServerEventsOptions } from './events/types.js';
+import type { MCPServerTasksOptions } from './tasks/config.js';
 import type { AppResources, MCPServerCacheHints, MCPServerHTTPRequestOptions, MCPServerPrompts, MCPServerRequestStateOptions, MCPServerResources } from './types.js';
 export interface MCPServerConfig extends CoreMCPServerConfig {
     resources?: MCPServerResources;
@@ -33,6 +34,14 @@ export interface MCPServerConfig extends CoreMCPServerConfig {
      * @experimental SEP-3415 is a draft; this API may change.
      */
     eventsOptions?: MCPServerEventsOptions;
+    /**
+     * Serves `tools/call` as MCP Tasks (`io.modelcontextprotocol/tasks`) for the tools you opt in: a
+     * client that declared the extension gets a task handle and polls `tasks/get` for the result.
+     * Other clients keep getting synchronous answers.
+     *
+     * @experimental SEP-2663 extension; API may change.
+     */
+    tasks?: MCPServerTasksOptions;
     /**
      * How requests from 2025-era clients (those that open with `initialize`) are served
      * over HTTP.
@@ -113,8 +122,16 @@ export declare class MCPServer extends MCPServerBase {
     private readonly eventRegistry;
     private readonly eventsOptions;
     private eventsInspector;
+    private tasksInspector;
     private readonly webhooks?;
     private readonly legacy;
+    private readonly tasks;
+    /** Where tasks are kept: `tasks.store`, or the store picked on first use. */
+    private readonly taskStore;
+    /** Cancels for the workflow runs executing in this process, by run id, while they execute. */
+    private readonly executingRuns;
+    /** Prepared on Mastra registration so its executors exist before the manager recovers rows. */
+    private backgroundTaskStore?;
     private httpHandler?;
     private nodeHandler?;
     private stdioHandle?;
@@ -128,6 +145,8 @@ export declare class MCPServer extends MCPServerBase {
      * so a tool cannot suspend into a request no client can answer.
      */
     private assertFormRepresentable;
+    /** The input-request form for `resumeSchema`, or `undefined` when the protocol can't present it. */
+    private representableForm;
     /**
      * Input-request forms are a restricted flat-object subset of JSON Schema, so
      * the dialect declaration is left off the requested schema.
@@ -187,10 +206,92 @@ export declare class MCPServer extends MCPServerBase {
      * carry any field. A thrown error ends the whole span tree and is rethrown.
      */
     private traceRequest;
+    /**
+     * Writes a task's root span out now rather than with the exporter's next batch: the task's later
+     * spans may be recorded by another process, and if this one dies first, a trace without its root
+     * drops out of trace lists.
+     */
+    private flushTaskRoot;
     /** Answers a suspended round: one keyed form derived from the handler's `resumeSchema`. */
     private inputRequired;
+    /** The form a suspended handler asks the client to fill in. */
+    private inputRequestForm;
     private serverRequest;
     private registerToolHandlers;
+    /** Logs a tool's failure and wraps it as the error a client receives. */
+    private toolError;
+    /**
+     * `'auto'` mode: runs the tool under the request for up to `syncWindowMs`. A tool that settles in
+     * time is answered like any synchronous call; otherwise the same execution carries on as a task,
+     * no longer tied to the request's cancellation.
+     */
+    private runWithinSyncWindow;
+    /**
+     * Creates the task (durably, before answering) and hands its work to the store. `initialAttempt`
+     * builds the run of an execution that already started under the request; it stays in this
+     * process. Rejects with {@link MCPTaskLimitError}, creating nothing, at a task cap.
+     */
+    private startToolTask;
+    /** The request context a task keeps for its later attempts. */
+    private persistTaskRequestContext;
+    /** Creates a task durably. `pinned` keeps its first attempt on this worker, which already runs it. */
+    private createTask;
+    /**
+     * The work of a tool task, rebuilt from nothing but what the task's `context` records, so a store
+     * can dispatch it again after a restart. Each attempt runs the tool once; an answered suspension
+     * runs it again with `resumeData`, as everywhere else in Mastra.
+     */
+    private toolTaskWork;
+    /**
+     * Opens a span in a task's trace, as a child of the task's root (the `tools/call` that created
+     * it), from any process. Uses the resume parentage workflows and agents use: the root id becomes
+     * the span's Mastra parent, so storage keeps one tree. `tracingOptions.parentSpanId` would not:
+     * it only correlates with an external system, and storage would record another root.
+     */
+    private openTaskSpan;
+    /** Ends an attempt's span with how the attempt ended, and passes the outcome on. */
+    private endAttemptSpan;
+    /**
+     * A first run already under way (an `'auto'` tool's or workflow's, under the request, or a
+     * workflow run started under `opened`) as attempt 1 of its task: the attempt span ends with that run.
+     */
+    private tracedInitialAttempt;
+    private toTaskOutcome;
+    /** A tool that throws inside a task completes it with `isError`, as a synchronous call would answer. */
+    private toolErrorOutcome;
+    /**
+     * Starts the run behind a `run_<key>` task. `'auto'` answers synchronously when the run finishes
+     * within `syncWindowMs`; a run that suspends or outlasts the window continues as a task.
+     */
+    private startWorkflowTask;
+    /** The first attempt of a workflow task: the run this request started, in this process. */
+    private liveWorkflowAttempt;
+    /**
+     * The work of a workflow task, rebuilt from its context. It never starts the run: a first attempt
+     * dispatched again (after a restart) re-attaches to it, and an answered suspension resumes it.
+     */
+    private workflowTaskWork;
+    private resumeWorkflowRun;
+    /**
+     * Polls the run until it finishes or suspends on a step the client can answer. The only way to
+     * follow a run from any instance, whichever engine runs it.
+     */
+    private watchWorkflowRun;
+    /**
+     * What a run's state means for its task, or `undefined` while there is nothing to report: the
+     * run is still going, or waits on a step whose `resumeSchema` no input request can present (the
+     * task stays `working` until the run is resumed some other way).
+     */
+    private workflowRunOutcome;
+    /**
+     * Cancels the task's run, for a declined input or the store's onCancel (`tasks/cancel`, TTL
+     * expiry), on whichever instance that happens. A run executing in this process is cancelled here.
+     * A run executing in another process is left alone: writing `canceled` under it doesn't stop it,
+     * its next write overwrites the status, and its own cancel would then find it `canceled` and do
+     * nothing. A run that waits (suspended, pending) is cancelled in storage. A finished run is left alone.
+     */
+    private cancelWorkflowRun;
+    private workflowFor;
     /**
      * Runs one round of a tool. The tool sees the same `suspend` / `resumeData` /
      * `suspendPayload` vocabulary as under an agent or workflow; nothing else is
@@ -215,6 +316,21 @@ export declare class MCPServer extends MCPServerBase {
      */
     startHTTP({ url, httpPath, req, res, options }: MCPServerHTTPOptions): Promise<void>;
     close(): Promise<void>;
+    /** Whether the id was given (in the config, or as a Mastra registration key) rather than generated per process. */
+    private hasStableId;
+    setId(id: Parameters<MCPServerBase['setId']>[0]): void;
+    /** @internal */
+    __registerMastra(mastra: Parameters<MCPServerBase['__registerMastra']>[0]): void;
+    /**
+     * Builds the background-task store and registers an executor for every task tool, when tasks
+     * are on, no store was passed in, and Mastra has background tasks.
+     */
+    private prepareBackgroundTaskStore;
+    /**
+     * Mastra's background tasks when the storage keeps per-row expiry (so a task's TTL, not the
+     * global cleanup, decides when it is deleted); an in-memory store otherwise.
+     */
+    private selectTaskStore;
     getServerInfo(): ServerInfo;
     getServerDetail(): ServerDetailInfo;
     getToolListInfo(requestContext?: RequestContext): {
@@ -256,6 +372,20 @@ export declare class MCPServer extends MCPServerBase {
      * @experimental
      */
     getEventsInspector(): MCPServerEventsInspector | undefined;
+    /**
+     * Which tools run as MCP tasks and whether the task store can be listed, or `undefined` when
+     * no tool runs as a task. Used by Studio.
+     * @experimental
+     */
+    getTasksInfo(): MCPServerTasksInfo | undefined;
+    /**
+     * Lists, cancels and answers this server's tasks across principals, through the task store's
+     * admin view, or `undefined` when no tool runs as a task or the store can't be listed. Used by
+     * Studio; there is no protocol equivalent of the listing.
+     * @experimental
+     */
+    getTasksInspector(): MCPServerTasksInspector | undefined;
+    private taskToolTypes;
     private eventsDeps;
 }
 export { ServerPromptActions, ServerResourceActions, ServerToolActions };

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

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

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

@@ -0,0 +1,107 @@
+import type { BackgroundTask, BackgroundTaskManager } from '@mastra/core/background-tasks';
+import type { IMastraLogger } from '@mastra/core/logger';
+import type { MCPDetailedTask, MCPTask, MCPTaskInputRequests, MCPTaskInputResponses } from '../../shared/tasks/index.js';
+import type { MCPTaskAccess, MCPTaskAdminOutcome, MCPTaskCreateParams, MCPTaskListOptions, MCPTaskListPage, MCPTaskRunOptions, MCPTaskStore, MCPTaskStoreAdmin, MCPTaskTrace, MCPTaskWork } from './store.js';
+export { principalKeyOf, taskKeyOf } from './store.js';
+/** What the store needs from a task's `context`: which tool it runs. */
+export interface BackgroundToolTaskContext extends Record<string, unknown> {
+    toolName: string;
+}
+export interface BackgroundTaskMCPTaskStoreOptions {
+    manager: BackgroundTaskManager;
+    /** The MCP server's id; scopes rows, owners and static executors to this server. */
+    serverId: string;
+    /** Rebuilds a task's work from nothing but its persisted context. */
+    workFor: (context: BackgroundToolTaskContext) => MCPTaskWork;
+    /** Whether a crashed attempt of this tool runs again. */
+    recoverFor: (toolName: string) => boolean;
+    /**
+     * Called with a task's context when it is cancelled or expires before finishing, on whichever
+     * instance does so, 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 the sweep goes on without waiting for it; errors are logged.
+     */
+    onCancel?: (context: BackgroundToolTaskContext) => void | Promise<void>;
+    /** Read on every log, since Mastra sets the server's logger after registering it. */
+    logger?: () => IMastraLogger;
+}
+/** The MCP side of a task, kept in the row's `metadata`. */
+export interface BackgroundTaskEnvelope {
+    v: 1;
+    /** The caller's principal, hashed with {@link principalKeyOf}. */
+    principalKey: string;
+    /** The span of the request that created the task; every attempt's span is its child. */
+    trace?: MCPTaskTrace;
+    /** Who sent the task, readable for operators; never a credential, and never used to authorize. */
+    clientLabel?: string;
+    ttlMs: number | null;
+    pollIntervalMs?: number;
+    recover: boolean;
+    /** The open suspension's requests, and the answers given to them so far. */
+    inputRequests?: MCPTaskInputRequests;
+    inputResponses?: MCPTaskInputResponses;
+    /** Every input key this task ever asked for; keys must be unique over its lifetime. */
+    usedInputKeys: string[];
+    /**
+     * Attempts started so far, for a traced task's attempt spans. Core's reclaim of a lost attempt
+     * leaves `retryCount` alone, so the row itself can't tell a recovered run from a first one.
+     */
+    attempts?: number;
+}
+export declare const TASK_LOST_MESSAGE = "task lost: the server restarted while it was running";
+export declare const TASK_EXPIRED_MESSAGE = "Task expired before it finished";
+/**
+ * Projects a background-task row onto the MCP task it backs, as `tasks/get` answers it.
+ *
+ * A row still running past its TTL reads as `failed` before the sweep gets to it.
+ */
+export declare function projectTask(row: BackgroundTask, envelope: BackgroundTaskEnvelope, taskId: string, now: number): MCPDetailedTask;
+/**
+ * An {@link MCPTaskStore} on Mastra's background tasks: every MCP task is a background-task row in
+ * Mastra's storage, so any instance sharing that storage can read, answer and cancel it, and run it.
+ *
+ * Rows are owned by `mcp-server:<serverId>` and keyed by a hash of the task id. Each attempt runs
+ * the tool's work rebuilt from the row (`workFor`), through a static executor registered for
+ * every task tool, so a worker other than the creating one can run it.
+ */
+export declare class BackgroundTaskMCPTaskStore implements MCPTaskStore, MCPTaskStoreAdmin {
+    #private;
+    constructor(options: BackgroundTaskMCPTaskStoreOptions);
+    /** The `agentId` every row of this server carries. */
+    get owner(): string;
+    /**
+     * Registers the executor that runs `toolName`'s tasks on any worker. It must be registered on
+     * every instance before the manager recovers rows, or recovered attempts find no executor.
+     */
+    registerTool(toolName: string): void;
+    create(params: MCPTaskCreateParams, { pinToWorker, clientLabel }?: {
+        pinToWorker?: boolean;
+        clientLabel?: string;
+    }): Promise<MCPTask>;
+    run(taskId: string, work: MCPTaskWork, options?: MCPTaskRunOptions): void;
+    get(taskId: string, access: MCPTaskAccess): Promise<MCPDetailedTask | undefined>;
+    update(taskId: string, inputResponses: MCPTaskInputResponses, access: MCPTaskAccess): Promise<boolean>;
+    cancel(taskId: string, access: MCPTaskAccess): Promise<boolean>;
+    /** Lists this server's tasks across principals, most recently created first. */
+    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>;
+    /**
+     * Stops sweeping, waits for a sweep already running to stop at its next step, then unregisters
+     * this store's executors. Rows stay in storage.
+     */
+    close(): Promise<void>;
+    /**
+     * Repairs what no request would: expires rows past their TTL, resumes answered rows whose
+     * process-local resume was lost, and settles rows whose worker died while this manager was
+     * already running (the manager itself only recovers rows when it starts).
+     */
+    sweep(): Promise<void>;
+    /**
+     * Starts the periodic sweep before any task request, so this instance settles rows a dead worker
+     * left behind even if no client ever asks it about a task. Does nothing once the store is closed.
+     */
+    startSweeping(): void;
+}
+//# sourceMappingURL=background-store.d.ts.map

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

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

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

@@ -0,0 +1,226 @@
+import type { RequestContext } from '@mastra/core/request-context';
+import type { MCPToolType } from '@mastra/core/tools';
+import type { MCPDetailedTask } from '../../shared/tasks/index.js';
+import type { MCPTaskAccess, MCPTaskCreateParams, MCPTaskLimits, MCPTaskRunOptions, MCPTaskStore, MCPTaskStoreAdmin, MCPTaskWork } from './store.js';
+/**
+ * How a tool answers `tools/call` for a client that declared the Tasks extension.
+ *
+ * - `'off'`: always answers synchronously.
+ * - `'always'`: answers with a task straight away.
+ * - `'auto'`: answers synchronously when the tool finishes within `syncWindowMs`, and with a task otherwise.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export type MCPServerTaskMode = 'off' | 'auto' | 'always';
+/** @experimental SEP-2663 extension; API may change. */
+export interface MCPServerToolTaskConfig {
+    mode: MCPServerTaskMode;
+    /** For `'auto'`: how long to wait for a synchronous answer, in ms. Default 2000. */
+    syncWindowMs?: number;
+    /** Overrides `tasks.ttlMs` for this tool's tasks. */
+    ttlMs?: number | null;
+    /** Overrides `tasks.recover` for this tool's tasks. */
+    recover?: boolean;
+}
+/**
+ * How one workflow's `run_<key>` tool is served as a task. There is no `recover`: a task whose
+ * server restarted re-attaches to its workflow run, which core's workflow recovery continues.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export type MCPServerWorkflowTaskConfig = Omit<MCPServerToolTaskConfig, 'recover'>;
+/**
+ * What `tasks.authorize` receives on every `tasks/get`, `tasks/update` and `tasks/cancel`.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPServerTaskAuthorizeContext {
+    /** The caller, already matched against the principal the task was created by. */
+    principal: string;
+    task: MCPDetailedTask;
+    /** The caller's request context, including `user` when the server maps one from the request's auth info. */
+    requestContext: RequestContext;
+}
+/**
+ * Serves `tools/call` as MCP Tasks (`io.modelcontextprotocol/tasks`) for the tools you opt in.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export interface MCPServerTasksOptions {
+    /** Mode for every tool, workflow and agent not listed in `tools`, `workflows` or `agents`. Default `'off'`. */
+    default?: MCPServerTaskMode;
+    /** Per-tool mode, keyed by tool name. */
+    tools?: Record<string, MCPServerTaskMode | MCPServerToolTaskConfig>;
+    /**
+     * Per-workflow mode, keyed by the server's `workflows` key; applies to its `run_<key>` tool. A
+     * workflow task follows its workflow run: a suspended step asks the client for input, and
+     * cancelling the task cancels the run.
+     */
+    workflows?: Record<string, MCPServerTaskMode | MCPServerWorkflowTaskConfig>;
+    /** Per-agent mode, keyed by the server's `agents` key; applies to its `ask_<key>` tool. */
+    agents?: Record<string, MCPServerTaskMode | MCPServerToolTaskConfig>;
+    /**
+     * Tools that only run as tasks, by the name clients call them (`run_<workflow>` and
+     * `ask_<agent>` for workflows and agents): a client that did not declare the Tasks extension
+     * gets a -32021 error instead of a synchronous answer.
+     */
+    required?: string[];
+    /** How long a task is kept from creation, in ms; `null` keeps it until the server closes. Default 24 hours. */
+    ttlMs?: number | null;
+    /**
+     * Whether a task whose server crashed or restarted mid-attempt runs the tool or agent again from
+     * the start. Only applies to stores that outlive a process (Mastra background tasks). Only turn
+     * this on for idempotent tools: `execute` may run twice. When off, such a task fails as lost.
+     * Workflow tasks ignore it: they always re-attach to their run. Default `false`.
+     */
+    recover?: boolean;
+    /**
+     * Where tasks are kept. By default, Mastra's background tasks when the server is registered on a
+     * Mastra instance with `backgroundTasks` enabled and storage that supports task expiry, so every
+     * instance sharing that storage serves the same tasks. Otherwise an {@link InMemoryMCPTaskStore},
+     * which serves a single instance.
+     */
+    store?: MCPTaskStore;
+    /**
+     * Most open (`working` or `input_required`) tasks one client may hold. Past it, a call that
+     * would start a task answers with `isError: true` instead. Default 100, or
+     * `maxRetainedTasksPerClient` when that is lower. A custom `store` that ignores `limits` in
+     * `create` enforces no cap.
+     */
+    maxOpenTasksPerClient?: number;
+    /**
+     * Most open tasks across all clients. Default 1000, or `maxRetainedTasks` when that is lower.
+     * Enforced the same way as `maxOpenTasksPerClient`.
+     */
+    maxOpenTasks?: number;
+    /**
+     * Most tasks one client may have in the store, open or finished, until each is forgotten
+     * (`ttlMs` plus a short retention). The in-memory store keeps finished results until then, so
+     * this bounds its memory when a client runs many short tasks. Past it, a call that would start a
+     * task answers like at the open cap. Default 1000, or `maxOpenTasksPerClient` when that is
+     * higher; setting it below `maxOpenTasksPerClient` throws. Only the in-memory store enforces it.
+     */
+    maxRetainedTasksPerClient?: number;
+    /**
+     * Most tasks in the store across all clients, open or finished. Default 10000, or `maxOpenTasks`
+     * when that is higher. Enforced the same way as `maxRetainedTasksPerClient`.
+     */
+    maxRetainedTasks?: number;
+    /**
+     * Decides whether the caller may read, answer or cancel a task. Tasks are always bound to the
+     * principal that created them; this narrows access further. A refusal answers as an unknown task.
+     */
+    authorize?: (context: MCPServerTaskAuthorizeContext) => boolean | Promise<boolean>;
+}
+/** How one tool is served as a task. */
+export interface ResolvedToolTaskMode {
+    mode: MCPServerTaskMode;
+    syncWindowMs: number;
+    ttlMs: number | null;
+    recover: boolean;
+}
+export interface ResolvedTasksConfig {
+    /** Whether any tool can answer with a task; gates the capability and the `tasks/*` handlers. */
+    enabled: boolean;
+    /** The store passed in, if any. */
+    store?: MCPTaskStore;
+    limits: MCPTaskLimits;
+    required: ReadonlySet<string>;
+    authorize?: MCPServerTasksOptions['authorize'];
+    modeFor(name: string, toolType: MCPToolType | undefined): ResolvedToolTaskMode;
+}
+/** The keys a server serves, for checking `tasks` against. */
+export interface TasksConfigSurfaces {
+    tools: readonly string[];
+    workflows?: readonly string[];
+    agents?: readonly string[];
+}
+/** Validates `tasks` against the configured tools, workflows and agents. Throws on anything a server could not serve. */
+export declare function resolveTasksConfig(options: MCPServerTasksOptions | undefined, surfaces: TasksConfigSurfaces): ResolvedTasksConfig;
+/**
+ * Picks the store on first use, once the server knows whether it runs on a Mastra instance with
+ * durable background tasks. `run` follows the `create` it pairs with, so the choice is made by then.
+ */
+export declare class SelectingMCPTaskStore implements MCPTaskStore {
+    #private;
+    constructor(select: () => Promise<MCPTaskStore>);
+    /** The chosen store, choosing it if no task request has yet. */
+    resolve(): Promise<MCPTaskStore>;
+    /**
+     * Chooses again on next use, for a server registered on Mastra after it served tasks. An
+     * in-memory store chosen before keeps the tasks created on it and goes on serving them.
+     */
+    reselect(): void;
+    /** Cancels the work of the in-memory stores it chose; a background-task store is closed by the server. */
+    close(): void;
+    create(params: MCPTaskCreateParams): Promise<{
+        [x: string]: unknown;
+        taskId: string;
+        status: "cancelled" | "completed" | "failed" | "input_required" | "working";
+        statusMessage?: string | undefined;
+        createdAt: string;
+        lastUpdatedAt: string;
+        ttlMs: number | null;
+        pollIntervalMs?: number | undefined;
+    }>;
+    get(taskId: string, access: MCPTaskAccess): Promise<{
+        [x: string]: unknown;
+        taskId: string;
+        statusMessage?: string | undefined;
+        createdAt: string;
+        lastUpdatedAt: string;
+        ttlMs: number | null;
+        pollIntervalMs?: number | undefined;
+        status: "working";
+    } | {
+        [x: string]: unknown;
+        taskId: string;
+        statusMessage?: string | undefined;
+        createdAt: string;
+        lastUpdatedAt: string;
+        ttlMs: number | null;
+        pollIntervalMs?: number | undefined;
+        status: "input_required";
+        inputRequests: Record<string, {
+            [x: string]: unknown;
+            method: string;
+            params?: Record<string, unknown> | undefined;
+        }>;
+    } | {
+        [x: string]: unknown;
+        taskId: string;
+        statusMessage?: string | undefined;
+        createdAt: string;
+        lastUpdatedAt: string;
+        ttlMs: number | null;
+        pollIntervalMs?: number | undefined;
+        status: "completed";
+        result: Record<string, unknown>;
+    } | {
+        [x: string]: unknown;
+        taskId: string;
+        statusMessage?: string | undefined;
+        createdAt: string;
+        lastUpdatedAt: string;
+        ttlMs: number | null;
+        pollIntervalMs?: number | undefined;
+        status: "failed";
+        error: Record<string, unknown>;
+    } | {
+        [x: string]: unknown;
+        taskId: string;
+        statusMessage?: string | undefined;
+        createdAt: string;
+        lastUpdatedAt: string;
+        ttlMs: number | null;
+        pollIntervalMs?: number | undefined;
+        status: "cancelled";
+    } | undefined>;
+    update(taskId: string, inputResponses: Parameters<MCPTaskStore['update']>[1], access: MCPTaskAccess): Promise<boolean>;
+    cancel(taskId: string, access: MCPTaskAccess): Promise<boolean>;
+    traceOf(taskId: string, access: MCPTaskAccess): Promise<import("./store").MCPTaskTrace | undefined>;
+    run(taskId: string, work: MCPTaskWork, options?: MCPTaskRunOptions): void;
+    /** The chosen store's admin view, or `undefined` when it has none. */
+    admin(): Promise<MCPTaskStoreAdmin | undefined>;
+}
+//# sourceMappingURL=config.d.ts.map

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

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

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

@@ -0,0 +1,16 @@
+import type { CallToolResult, Transport } from '@modelcontextprotocol/server';
+import type { MCPTask } from '../../shared/tasks/index.js';
+/**
+ * A `tools/call` result standing in for a task handle. The SDK only lets a tool handler return a
+ * `CallToolResult`; {@link emitTaskResults} replaces this one with the `CreateTaskResult` on the
+ * wire. `isError` keeps the SDK from applying the tool's output schema to the placeholder.
+ */
+export declare function taskHandleResult(task: MCPTask): CallToolResult;
+/** The task a result built by {@link taskHandleResult} stands for; `undefined` for any other result. */
+export declare function taskOfHandleResult(result: unknown): MCPTask | undefined;
+/**
+ * Sends results built by {@link taskHandleResult} as `CreateTaskResult`s. Only call handlers that
+ * checked the caller declared the Tasks extension may build them.
+ */
+export declare function emitTaskResults(transport: Transport): void;
+//# sourceMappingURL=emit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../src/server/tasks/emit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKlD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,CAM9D;AAED,wGAAwG;AACxG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAGvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAc1D"}