@mastra/mcp 2.6.0-alpha.3 → 2.7.0-alpha.0

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

@@ -0,0 +1,187 @@
+/**
+ * Zod schemas for the MCP Tasks extension (SEP-2663) wire format.
+ *
+ * Objects are loose so fields added by later revisions pass through. `resultType` is required on
+ * the raw `tools/call` task handle, as the 2026-07-28 revision requires it there.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+import { z } from 'zod/v4';
+export declare const TaskStatusSchema: z.ZodEnum<{
+    cancelled: "cancelled";
+    completed: "completed";
+    failed: "failed";
+    input_required: "input_required";
+    working: "working";
+}>;
+/** An embedded elicitation, sampling or roots request (`{ method, params }`). */
+export declare const TaskInputRequestSchema: z.ZodObject<{
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** Keyed by identifiers that are unique over the task's lifetime. */
+export declare const TaskInputRequestsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>>;
+/** The bare result object answering the input request with the same key. */
+export declare const TaskInputResponsesSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+export declare const TaskSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+        input_required: "input_required";
+        working: "working";
+    }>;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export declare const DetailedTaskSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"working">;
+}, z.core.$loose>, z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"input_required">;
+    inputRequests: z.ZodRecord<z.ZodString, z.ZodObject<{
+        method: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>, z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"completed">;
+    result: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$loose>, z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"failed">;
+    error: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$loose>, z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"cancelled">;
+}, z.core.$loose>], "status">;
+/** What a server returns from `tools/call` instead of a `CallToolResult` when it creates a task. */
+export declare const CreateTaskResultSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+        input_required: "input_required";
+        working: "working";
+    }>;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    resultType: z.ZodLiteral<"task">;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const GetTaskRequestParamsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const CancelTaskRequestParamsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/**
+ * `tasks/update` params as sent on the wire. `inputResponses` is a reserved retry field on the
+ * 2026-07-28 revision: a receiving SDK moves it to `ctx.mcpReq.inputResponses` before the handler
+ * runs, so a server validates the remaining params with {@link UpdateTaskHandlerParamsSchema}.
+ */
+export declare const UpdateTaskRequestParamsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    inputResponses: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const UpdateTaskHandlerParamsSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/** `tasks/get` result: the full task. */
+export declare const GetTaskResultSchema: z.ZodIntersection<z.ZodObject<{
+    resultType: z.ZodOptional<z.ZodLiteral<"complete">>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"working">;
+}, z.core.$loose>, z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"input_required">;
+    inputRequests: z.ZodRecord<z.ZodString, z.ZodObject<{
+        method: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>, z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"completed">;
+    result: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$loose>, z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"failed">;
+    error: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$loose>, z.ZodObject<{
+    taskId: z.ZodString;
+    statusMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    ttlMs: z.ZodNullable<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodLiteral<"cancelled">;
+}, z.core.$loose>], "status">>;
+/** `tasks/update` and `tasks/cancel` only acknowledge. */
+export declare const TaskAckResultSchema: z.ZodObject<{
+    resultType: z.ZodOptional<z.ZodLiteral<"complete">>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/shared/tasks/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAM3B,eAAO,MAAM,gBAAgB;;;;;;EAAwB,CAAC;AAEtD,iFAAiF;AACjF,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,uBAAuB;;;kBAA+C,CAAC;AAEpF,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,kEAAyC,CAAC;AAY/E,eAAO,MAAM,UAAU;;;;;;;;;;;;;;iBAA2B,CAAC;AAEnD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAQ7B,CAAC;AAEH,oGAAoG;AACpG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;iBAIjC,CAAC;AAIH,eAAO,MAAM,0BAA0B;;;iBAAqB,CAAC;AAC7D,eAAO,MAAM,6BAA6B;;;iBAAqB,CAAC;AAChE;;;;GAIG;AACH,eAAO,MAAM,6BAA6B;;;;iBAA0E,CAAC;AACrH,eAAO,MAAM,6BAA6B;;;iBAAqB,CAAC;AAKhE,yCAAyC;AACzC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAAyE,CAAC;AAE1G,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB;;;iBAAqC,CAAC"}

package/dist/shared/tasks/task-id.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A new task id: 192 random bits, base64url. Task ids work as bearer tokens, so they must not be
+ * guessable or derived from anything else (such as a workflow run id).
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export declare function createTaskId(): string;
+/**
+ * A stable key for a task that is safe to store and show: the SHA-256 of the task id, base64url.
+ * Client and server compute the same key, so traces on both sides can be matched without
+ * recording the task id itself.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export declare function taskKeyOf(taskId: string): string;
+/**
+ * The poll interval a server suggests for a task created at `createdAt`: frequent while the task is
+ * young, then slower.
+ *
+ * @experimental SEP-2663 extension; API may change.
+ */
+export declare function suggestedPollIntervalMs(createdAt: number, now: number, options?: {
+    initialMs?: number;
+    steadyMs?: number;
+    initialWindowMs?: number;
+}): number;
+//# sourceMappingURL=task-id.d.ts.map

package/dist/shared/tasks/task-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-id.d.ts","sourceRoot":"","sources":["../../../src/shared/tasks/task-id.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,GAChF,MAAM,CAKR"}

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

@@ -0,0 +1,21 @@
+import type { z } from 'zod/v4';
+import type { CreateTaskResultSchema, DetailedTaskSchema, TaskInputRequestSchema, TaskInputRequestsSchema, TaskInputResponsesSchema, TaskSchema } from './schemas.js';
+/** @experimental SEP-2663 extension; API may change. */
+export type MCPTask = z.infer<typeof TaskSchema>;
+/** A task with its `inputRequests`, `result` or `error` inlined, as `tasks/get` returns it. @experimental */
+export type MCPDetailedTask = z.infer<typeof DetailedTaskSchema>;
+/** @experimental SEP-2663 extension; API may change. */
+export type MCPCreateTaskResult = z.infer<typeof CreateTaskResultSchema>;
+/** @experimental SEP-2663 extension; API may change. */
+export type MCPTaskInputRequest = z.infer<typeof TaskInputRequestSchema>;
+/** @experimental SEP-2663 extension; API may change. */
+export type MCPTaskInputRequests = z.infer<typeof TaskInputRequestsSchema>;
+/** @experimental SEP-2663 extension; API may change. */
+export type MCPTaskInputResponses = z.infer<typeof TaskInputResponsesSchema>;
+/** A JSON-RPC error object carried by a `failed` task. @experimental */
+export interface MCPTaskError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/tasks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,UAAU,EACX,MAAM,WAAW,CAAC;AAEnB,wDAAwD;AACxD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACjD,6GAA6G;AAC7G,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACjE,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACzE,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACzE,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAC3E,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC7E,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp",
-  "version": "2.6.0-alpha.3",
+  "version": "2.7.0-alpha.0",
   "description": "",
   "type": "module",
   "main": "dist/index.js",
@@ -43,7 +43,7 @@
     "zod": "^4.2.0"
   },
   "devDependencies": {
-    "@ai-sdk/openai-v5": "npm:@ai-sdk/openai@2.0.135",
+    "@ai-sdk/openai-v5": "npm:@ai-sdk/openai@2.0.137",
     "@copilotkit/aimock": "^1.46.0",
     "@mendable/firecrawl-js": "^1.29.3",
     "@modelcontextprotocol/conformance": "0.2.0-alpha.12",
@@ -57,14 +57,15 @@
     "vitest": "4.1.12",
     "zod": "^4.6.7",
     "zod-to-json-schema": "^3.25.2",
-    "@internal/ai-sdk-v5": "0.0.92",
-    "@internal/lint": "0.0.145",
-    "@internal/llm-recorder": "0.0.81",
-    "@internal/test-utils": "0.0.81",
-    "@mastra/observability": "1.22.0-alpha.3",
-    "@internal/types-builder": "0.0.120",
-    "@mastra/core": "1.80.0-alpha.7",
-    "@mastra/schema-compat": "1.3.17-alpha.0"
+    "@internal/lint": "0.0.146",
+    "@internal/ai-sdk-v5": "0.0.93",
+    "@internal/llm-recorder": "0.0.82",
+    "@internal/test-utils": "0.0.82",
+    "@internal/types-builder": "0.0.121",
+    "@mastra/core": "1.81.0-alpha.2",
+    "@mastra/libsql": "1.28.0-alpha.0",
+    "@mastra/observability": "1.23.0-alpha.1",
+    "@mastra/schema-compat": "1.3.17"
   },
   "homepage": "https://mastra.ai",
   "repository": {