@mastra/deployer 0.3.3-alpha.1 → 0.3.4-alpha.0

package/dist/_tsup-dts-rollup.d.cts

@@ -269,6 +269,40 @@ provider: string;
 modelId: string;
 }, ContentfulStatusCode, "json">>;
 
+export declare function getAgentCardByIdHandler(c: Context): Promise<Response & TypedResponse<    {
+name: string;
+description?: string | null | undefined;
+url: string;
+provider?: {
+organization: string;
+url?: string | null | undefined;
+} | null | undefined;
+version: string;
+documentationUrl?: string | null | undefined;
+capabilities: {
+streaming?: boolean | undefined;
+pushNotifications?: boolean | undefined;
+stateTransitionHistory?: boolean | undefined;
+};
+authentication?: {
+schemes: string[];
+credentials?: string | null | undefined;
+} | null | undefined;
+defaultInputModes?: string[] | undefined;
+defaultOutputModes?: string[] | undefined;
+skills: {
+id: string;
+name: string;
+description?: string | null | undefined;
+tags?: string[] | null | undefined;
+examples?: string[] | null | undefined;
+inputModes?: string[] | null | undefined;
+outputModes?: string[] | null | undefined;
+}[];
+}, ContentfulStatusCode, "json">>;
+
+export declare function getAgentExecutionHandler(c: Context): Promise<Response>;
+
 export declare function getAgentsHandler(c: Context): Promise<Response & TypedResponse<any, ContentfulStatusCode, "json">>;
 
 declare function getDeployer(entryFile: string, outputDir: string): Promise<MastraDeployer | undefined>;

package/dist/_tsup-dts-rollup.d.ts

@@ -269,6 +269,40 @@ provider: string;
 modelId: string;
 }, ContentfulStatusCode, "json">>;
 
+export declare function getAgentCardByIdHandler(c: Context): Promise<Response & TypedResponse<    {
+name: string;
+description?: string | null | undefined;
+url: string;
+provider?: {
+organization: string;
+url?: string | null | undefined;
+} | null | undefined;
+version: string;
+documentationUrl?: string | null | undefined;
+capabilities: {
+streaming?: boolean | undefined;
+pushNotifications?: boolean | undefined;
+stateTransitionHistory?: boolean | undefined;
+};
+authentication?: {
+schemes: string[];
+credentials?: string | null | undefined;
+} | null | undefined;
+defaultInputModes?: string[] | undefined;
+defaultOutputModes?: string[] | undefined;
+skills: {
+id: string;
+name: string;
+description?: string | null | undefined;
+tags?: string[] | null | undefined;
+examples?: string[] | null | undefined;
+inputModes?: string[] | null | undefined;
+outputModes?: string[] | null | undefined;
+}[];
+}, ContentfulStatusCode, "json">>;
+
+export declare function getAgentExecutionHandler(c: Context): Promise<Response>;
+
 export declare function getAgentsHandler(c: Context): Promise<Response & TypedResponse<any, ContentfulStatusCode, "json">>;
 
 declare function getDeployer(entryFile: string, outputDir: string): Promise<MastraDeployer | undefined>;

package/dist/server/index.cjs

@@ -18,6 +18,8 @@ var cors = require('hono/cors');
 var logger = require('hono/logger');
 var timeout = require('hono/timeout');
 var httpException = require('hono/http-exception');
+var a2a = require('@mastra/server/handlers/a2a');
+var streaming = require('hono/streaming');
 var agents = require('@mastra/server/handlers/agents');
 var logs = require('@mastra/server/handlers/logs');
 var memory = require('@mastra/server/handlers/memory');
@@ -28,7 +30,6 @@ var telemetry = require('@mastra/server/handlers/telemetry');
 var tools = require('@mastra/server/handlers/tools');
 var vector = require('@mastra/server/handlers/vector');
 var vNextWorkflows = require('@mastra/server/handlers/vNextWorkflows');
-var streaming = require('hono/streaming');
 var voice = require('@mastra/server/handlers/voice');
 var workflows = require('@mastra/server/handlers/workflows');
 
@@ -159,27 +160,48 @@ Object.setPrototypeOf(requestPrototype, Request.prototype);
 var newRequest = (incoming, defaultHostname) => {
   const req = Object.create(requestPrototype);
   req[incomingKey] = incoming;
+  const incomingUrl = incoming.url || "";
+  if (incomingUrl[0] !== "/" && // short-circuit for performance. most requests are relative URL.
+  (incomingUrl.startsWith("http://") || incomingUrl.startsWith("https://"))) {
+    if (incoming instanceof http2.Http2ServerRequest) {
+      throw new RequestError("Absolute URL for :path is not allowed in HTTP/2");
+    }
+    try {
+      const url2 = new URL(incomingUrl);
+      req[urlKey] = url2.href;
+    } catch (e2) {
+      throw new RequestError("Invalid absolute URL", { cause: e2 });
+    }
+    return req;
+  }
   const host = (incoming instanceof http2.Http2ServerRequest ? incoming.authority : incoming.headers.host) || defaultHostname;
   if (!host) {
     throw new RequestError("Missing host header");
   }
-  const url = new URL(
-    `${incoming instanceof http2.Http2ServerRequest || incoming.socket && incoming.socket.encrypted ? "https" : "http"}://${host}${incoming.url}`
-  );
+  let scheme;
+  if (incoming instanceof http2.Http2ServerRequest) {
+    scheme = incoming.scheme;
+    if (!(scheme === "http" || scheme === "https")) {
+      throw new RequestError("Unsupported scheme");
+    }
+  } else {
+    scheme = incoming.socket && incoming.socket.encrypted ? "https" : "http";
+  }
+  const url = new URL(`${scheme}://${host}${incomingUrl}`);
   if (url.hostname.length !== host.length && url.hostname !== host.replace(/:\d+$/, "")) {
     throw new RequestError("Invalid host header");
   }
   req[urlKey] = url.href;
   return req;
 };
-function writeFromReadableStream(stream3, writable) {
-  if (stream3.locked) {
+function writeFromReadableStream(stream4, writable) {
+  if (stream4.locked) {
     throw new TypeError("ReadableStream is locked.");
   } else if (writable.destroyed) {
-    stream3.cancel();
+    stream4.cancel();
     return;
   }
-  const reader = stream3.getReader();
+  const reader = stream4.getReader();
   writable.on("close", cancel);
   writable.on("error", cancel);
   reader.read().then(flow, cancel);
@@ -377,7 +399,7 @@ var responseViaResponseObject = async (res, outgoing, options = {}) => {
   const resHeaderRecord = buildOutgoingHttpHeaders(res.headers);
   const internalBody = getInternalBody(res);
   if (internalBody) {
-    const { length, source, stream: stream3 } = internalBody;
+    const { length, source, stream: stream4 } = internalBody;
     if (source instanceof Uint8Array && source.byteLength !== length) ; else {
       if (length) {
         resHeaderRecord["content-length"] = length;
@@ -388,7 +410,7 @@ var responseViaResponseObject = async (res, outgoing, options = {}) => {
       } else if (source instanceof Blob) {
         outgoing.end(new Uint8Array(await source.arrayBuffer()));
       } else {
-        await writeFromReadableStream(stream3, outgoing);
+        await writeFromReadableStream(stream4, outgoing);
       }
       return;
     }
@@ -461,7 +483,7 @@ var getRequestListener = (fetchCallback, options = {}) => {
       }
     }
     try {
-      return responseViaResponseObject(res, outgoing, options);
+      return await responseViaResponseObject(res, outgoing, options);
     } catch (e2) {
       return handleResponseError(e2, outgoing);
     }
@@ -492,18 +514,18 @@ var ENCODINGS = {
   gzip: ".gz"
 };
 var ENCODINGS_ORDERED_KEYS = Object.keys(ENCODINGS);
-var createStreamBody = (stream3) => {
+var createStreamBody = (stream4) => {
   const body = new ReadableStream({
     start(controller) {
-      stream3.on("data", (chunk) => {
+      stream4.on("data", (chunk) => {
         controller.enqueue(chunk);
       });
-      stream3.on("end", () => {
+      stream4.on("end", () => {
         controller.close();
       });
     },
     cancel() {
-      stream3.destroy();
+      stream4.destroy();
     }
   });
   return body;
@@ -599,10 +621,10 @@ var serveStatic = (options = { root: "" }) => {
       end = size - 1;
     }
     const chunksize = end - start + 1;
-    const stream3 = fs.createReadStream(path, { start, end });
+    const stream4 = fs.createReadStream(path, { start, end });
     c2.header("Content-Length", chunksize.toString());
     c2.header("Content-Range", `bytes ${start}-${end}/${stats.size}`);
-    return c2.body(createStreamBody(stream3), 206);
+    return c2.body(createStreamBody(stream4), 206);
   };
 };
 var RENDER_TYPE = {
@@ -723,7 +745,7 @@ var middleware = (options) => async (c2) => {
   );
 };
 
-// ../../node_modules/.pnpm/hono-openapi@0.4.6_hono@4.7.4_openapi-types@12.1.3_zod@3.24.3/node_modules/hono-openapi/utils.js
+// ../../node_modules/.pnpm/hono-openapi@0.4.6_hono@4.7.7_openapi-types@12.1.3_zod@3.24.4/node_modules/hono-openapi/utils.js
 var e = Symbol("openapi");
 var s2 = ["GET", "PUT", "POST", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"];
 var n = (e2) => e2.charAt(0).toUpperCase() + e2.slice(1);
@@ -849,6 +871,59 @@ async function x(e2, t2, s3 = {}) {
   }
   return { docs: o2, components: n2 };
 }
+async function getAgentCardByIdHandler(c2) {
+  const mastra = c2.get("mastra");
+  const agentId = c2.req.param("agentId");
+  const runtimeContext = c2.get("runtimeContext");
+  const result = await a2a.getAgentCardByIdHandler({
+    mastra,
+    agentId,
+    runtimeContext
+  });
+  return c2.json(result);
+}
+async function getAgentExecutionHandler(c2) {
+  const mastra = c2.get("mastra");
+  const agentId = c2.req.param("agentId");
+  const runtimeContext = c2.get("runtimeContext");
+  const logger2 = mastra.getLogger();
+  const body = await c2.req.json();
+  if (!["tasks/send", "tasks/sendSubscribe", "tasks/get", "tasks/cancel"].includes(body.method)) {
+    return c2.json({ error: { message: `Unsupported method: ${body.method}`, code: "invalid_method" } }, 400);
+  }
+  const result = await a2a.getAgentExecutionHandler({
+    mastra,
+    agentId,
+    runtimeContext,
+    requestId: crypto.randomUUID(),
+    method: body.method,
+    params: body.params,
+    logger: logger2
+  });
+  if (body.method === "tasks/sendSubscribe") {
+    return streaming.stream(
+      c2,
+      async (stream4) => {
+        try {
+          stream4.onAbort(() => {
+            if (!result.locked) {
+              return result.cancel();
+            }
+          });
+          for await (const chunk of result) {
+            await stream4.write(JSON.stringify(chunk) + "");
+          }
+        } catch (err) {
+          logger2.error("Error in tasks/sendSubscribe stream: " + err?.message);
+        }
+      },
+      async (err) => {
+        logger2.error("Error in tasks/sendSubscribe stream: " + err?.message);
+      }
+    );
+  }
+  return c2.json(result);
+}
 function handleError(error, defaultMessage) {
   const apiError = error;
   throw new httpException.HTTPException(apiError.status || 500, {
@@ -969,7 +1044,7 @@ async function setAgentInstructionsHandler(c2) {
 // src/server/handlers/client.ts
 var clients = /* @__PURE__ */ new Set();
 function handleClientsRefresh(c2) {
-  const stream3 = new ReadableStream({
+  const stream4 = new ReadableStream({
     start(controller) {
       clients.add(controller);
       controller.enqueue("data: connected\n\n");
@@ -978,7 +1053,7 @@ function handleClientsRefresh(c2) {
       });
     }
   });
-  return new Response(stream3, {
+  return new Response(stream4, {
     headers: {
       "Content-Type": "text/event-stream",
       "Cache-Control": "no-cache",
@@ -1398,13 +1473,14 @@ function executeToolHandler(tools$1) {
       const runtimeContext = c2.get("runtimeContext");
       const toolId = decodeURIComponent(c2.req.param("toolId"));
       const runId = c2.req.query("runId");
-      const { data } = await c2.req.json();
+      const { data, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
       const result = await tools.executeToolHandler(tools$1)({
         mastra,
         toolId,
         data,
         runtimeContext,
-        runId
+        runId,
+        runtimeContextFromRequest
       });
       return c2.json(result);
     } catch (error) {
@@ -1418,13 +1494,14 @@ async function executeAgentToolHandler(c2) {
     const runtimeContext = c2.get("runtimeContext");
     const agentId = c2.req.param("agentId");
     const toolId = c2.req.param("toolId");
-    const { data } = await c2.req.json();
+    const { data, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
     const result = await tools.executeAgentToolHandler({
       mastra,
       agentId,
       toolId,
       data,
-      runtimeContext
+      runtimeContext,
+      runtimeContextFromRequest
     });
     return c2.json(result);
   } catch (error) {
@@ -1572,11 +1649,13 @@ async function startAsyncVNextWorkflowHandler(c2) {
   try {
     const mastra = c2.get("mastra");
     const workflowId = c2.req.param("workflowId");
-    const { inputData, runtimeContext } = await c2.req.json();
+    const runtimeContext = c2.get("runtimeContext");
+    const { inputData, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
     const runId = c2.req.query("runId");
     const result = await vNextWorkflows.startAsyncVNextWorkflowHandler({
       mastra,
       runtimeContext,
+      runtimeContextFromRequest,
       workflowId,
       runId,
       inputData
@@ -1590,11 +1669,13 @@ async function startVNextWorkflowRunHandler(c2) {
   try {
     const mastra = c2.get("mastra");
     const workflowId = c2.req.param("workflowId");
-    const { inputData, runtimeContext } = await c2.req.json();
+    const runtimeContext = c2.get("runtimeContext");
+    const { inputData, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
     const runId = c2.req.query("runId");
     await vNextWorkflows.startVNextWorkflowRunHandler({
       mastra,
       runtimeContext,
+      runtimeContextFromRequest,
       workflowId,
       runId,
       inputData
@@ -1615,20 +1696,20 @@ function watchVNextWorkflowHandler(c2) {
     }
     return streaming.stream(
       c2,
-      async (stream3) => {
+      async (stream4) => {
         try {
           const result = await vNextWorkflows.watchVNextWorkflowHandler({
             mastra,
             workflowId,
             runId
           });
-          stream3.onAbort(() => {
+          stream4.onAbort(() => {
             if (!result.locked) {
               return result.cancel();
             }
           });
           for await (const chunk of result) {
-            await stream3.write(chunk.toString() + "");
+            await stream4.write(chunk.toString() + "");
           }
         } catch (err) {
           console.log(err);
@@ -1647,13 +1728,15 @@ async function resumeAsyncVNextWorkflowHandler(c2) {
     const mastra = c2.get("mastra");
     const workflowId = c2.req.param("workflowId");
     const runId = c2.req.query("runId");
-    const { step, resumeData, runtimeContext } = await c2.req.json();
+    const runtimeContext = c2.get("runtimeContext");
+    const { step, resumeData, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
     if (!runId) {
       throw new httpException.HTTPException(400, { message: "runId required to resume workflow" });
     }
     const result = await vNextWorkflows.resumeAsyncVNextWorkflowHandler({
       mastra,
       runtimeContext,
+      runtimeContextFromRequest,
       workflowId,
       runId,
       body: { step, resumeData }
@@ -1850,20 +1933,20 @@ function watchWorkflowHandler(c2) {
     }
     return streaming.stream(
       c2,
-      async (stream3) => {
+      async (stream4) => {
         try {
           const result = await workflows.watchWorkflowHandler({
             mastra,
             workflowId,
             runId
           });
-          stream3.onAbort(() => {
+          stream4.onAbort(() => {
             if (!result.locked) {
               return result.cancel();
             }
           });
           for await (const chunk of result) {
-            await stream3.write(chunk.toString() + "");
+            await stream4.write(chunk.toString() + "");
           }
         } catch (err) {
           console.log(err);
@@ -2093,7 +2176,18 @@ async function createHonoServer(mastra, options = {}) {
   app.onError(errorHandler);
   app.use("*", function setContext(c2, next) {
     const runtimeContext$1 = new runtimeContext.RuntimeContext();
-    c2.set("runtimeContext", runtimeContext$1);
+    const proxyRuntimeContext = new Proxy(runtimeContext$1, {
+      get(target, prop) {
+        if (prop === "get") {
+          return function(key) {
+            const value = target.get(key);
+            return value ?? `<${key}>`;
+          };
+        }
+        return Reflect.get(target, prop);
+      }
+    });
+    c2.set("runtimeContext", proxyRuntimeContext);
     c2.set("mastra", mastra);
     c2.set("tools", tools);
     c2.set("playground", options.playground === true);
@@ -2167,6 +2261,142 @@ async function createHonoServer(mastra, options = {}) {
   if (server?.build?.apiReqLogs) {
     app.use(logger.logger());
   }
+  app.get(
+    "/.well-known/:agentId/agent.json",
+    h({
+      description: "Get agent configuration",
+      tags: ["agents"],
+      parameters: [
+        {
+          name: "agentId",
+          in: "path",
+          required: true,
+          schema: { type: "string" }
+        }
+      ],
+      responses: {
+        200: {
+          description: "Agent configuration"
+        }
+      }
+    }),
+    getAgentCardByIdHandler
+  );
+  app.post(
+    "/a2a/:agentId",
+    h({
+      description: "Execute agent via A2A protocol",
+      tags: ["agents"],
+      parameters: [
+        {
+          name: "agentId",
+          in: "path",
+          required: true,
+          schema: { type: "string" }
+        }
+      ],
+      requestBody: {
+        required: true,
+        content: {
+          "application/json": {
+            schema: {
+              type: "object",
+              properties: {
+                method: {
+                  type: "string",
+                  enum: ["tasks/send", "tasks/sendSubscribe", "tasks/get", "tasks/cancel"],
+                  description: "The A2A protocol method to execute"
+                },
+                params: {
+                  type: "object",
+                  oneOf: [
+                    {
+                      // TaskSendParams
+                      type: "object",
+                      properties: {
+                        id: {
+                          type: "string",
+                          description: "Unique identifier for the task being initiated or continued"
+                        },
+                        sessionId: {
+                          type: "string",
+                          description: "Optional identifier for the session this task belongs to"
+                        },
+                        message: {
+                          type: "object",
+                          description: "The message content to send to the agent for processing"
+                        },
+                        pushNotification: {
+                          type: "object",
+                          nullable: true,
+                          description: "Optional pushNotification information for receiving notifications about this task"
+                        },
+                        historyLength: {
+                          type: "integer",
+                          nullable: true,
+                          description: "Optional parameter to specify how much message history to include in the response"
+                        },
+                        metadata: {
+                          type: "object",
+                          nullable: true,
+                          description: "Optional metadata associated with sending this message"
+                        }
+                      },
+                      required: ["id", "message"]
+                    },
+                    {
+                      // TaskQueryParams
+                      type: "object",
+                      properties: {
+                        id: { type: "string", description: "The unique identifier of the task" },
+                        historyLength: {
+                          type: "integer",
+                          nullable: true,
+                          description: "Optional history length to retrieve for the task"
+                        },
+                        metadata: {
+                          type: "object",
+                          nullable: true,
+                          description: "Optional metadata to include with the operation"
+                        }
+                      },
+                      required: ["id"]
+                    },
+                    {
+                      // TaskIdParams
+                      type: "object",
+                      properties: {
+                        id: { type: "string", description: "The unique identifier of the task" },
+                        metadata: {
+                          type: "object",
+                          nullable: true,
+                          description: "Optional metadata to include with the operation"
+                        }
+                      },
+                      required: ["id"]
+                    }
+                  ]
+                }
+              },
+              required: ["method", "params"]
+            }
+          }
+        }
+      },
+      responses: {
+        200: {
+          description: "A2A response"
+        },
+        400: {
+          description: "Missing or invalid request parameters"
+        },
+        404: {
+          description: "Agent not found"
+        }
+      }
+    }),
+    getAgentExecutionHandler
+  );
   app.get(
     "/api",
     h({
@@ -3007,7 +3237,8 @@ async function createHonoServer(mastra, options = {}) {
             schema: {
               type: "object",
               properties: {
-                data: { type: "object" }
+                data: { type: "object" },
+                runtimeContext: { type: "object" }
               },
               required: ["data"]
             }
@@ -3394,7 +3625,10 @@ async function createHonoServer(mastra, options = {}) {
                   oneOf: [{ type: "string" }, { type: "array", items: { type: "string" } }]
                 },
                 resumeData: { type: "object" },
-                runtimeContext: { type: "object" }
+                runtimeContext: {
+                  type: "object",
+                  description: "Runtime context for the workflow execution"
+                }
               },
               required: ["step"]
             }
@@ -3435,7 +3669,10 @@ async function createHonoServer(mastra, options = {}) {
                   oneOf: [{ type: "string" }, { type: "array", items: { type: "string" } }]
                 },
                 resumeData: { type: "object" },
-                runtimeContext: { type: "object" }
+                runtimeContext: {
+                  type: "object",
+                  description: "Runtime context for the workflow execution"
+                }
               },
               required: ["step"]
             }
@@ -3501,7 +3738,10 @@ async function createHonoServer(mastra, options = {}) {
               type: "object",
               properties: {
                 inputData: { type: "object" },
-                runtimeContext: { type: "object" }
+                runtimeContext: {
+                  type: "object",
+                  description: "Runtime context for the workflow execution"
+                }
               }
             }
           }
@@ -3545,7 +3785,10 @@ async function createHonoServer(mastra, options = {}) {
               type: "object",
               properties: {
                 inputData: { type: "object" },
-                runtimeContext: { type: "object" }
+                runtimeContext: {
+                  type: "object",
+                  description: "Runtime context for the workflow execution"
+                }
               }
             }
           }
@@ -4072,7 +4315,8 @@ async function createHonoServer(mastra, options = {}) {
             schema: {
               type: "object",
               properties: {
-                data: { type: "object" }
+                data: { type: "object" },
+                runtimeContext: { type: "object" }
               },
               required: ["data"]
             }
@@ -4365,7 +4609,7 @@ async function createNodeServer(mastra, options = {}) {
       const host = serverOptions?.host ?? "localhost";
       logger2.info(` Mastra API running on port http://${host}:${port}/api`);
       if (options?.isDev) {
-        logger2.info(`\uFFFD Open API documentation available at http://${host}:${port}/openapi.json`);
+        logger2.info(`\u{1F517} Open API documentation available at http://${host}:${port}/openapi.json`);
       }
       if (options?.isDev) {
         logger2.info(`\u{1F9EA} Swagger UI available at http://${host}:${port}/swagger-ui`);

package/dist/server/index.js

@@ -16,6 +16,8 @@ import { cors } from 'hono/cors';
 import { logger } from 'hono/logger';
 import { timeout } from 'hono/timeout';
 import { HTTPException } from 'hono/http-exception';
+import { getAgentCardByIdHandler as getAgentCardByIdHandler$1, getAgentExecutionHandler as getAgentExecutionHandler$1 } from '@mastra/server/handlers/a2a';
+import { stream } from 'hono/streaming';
 import { getAgentsHandler as getAgentsHandler$1, getAgentByIdHandler as getAgentByIdHandler$1, getEvalsByAgentIdHandler as getEvalsByAgentIdHandler$1, getLiveEvalsByAgentIdHandler as getLiveEvalsByAgentIdHandler$1, generateHandler as generateHandler$2, streamGenerateHandler as streamGenerateHandler$2 } from '@mastra/server/handlers/agents';
 import { getLogsHandler as getLogsHandler$1, getLogTransports as getLogTransports$1, getLogsByRunIdHandler as getLogsByRunIdHandler$1 } from '@mastra/server/handlers/logs';
 import { getMemoryStatusHandler as getMemoryStatusHandler$1, getThreadsHandler as getThreadsHandler$1, getThreadByIdHandler as getThreadByIdHandler$1, getMessagesHandler as getMessagesHandler$1, createThreadHandler as createThreadHandler$1, updateThreadHandler as updateThreadHandler$1, deleteThreadHandler as deleteThreadHandler$1, saveMessagesHandler as saveMessagesHandler$1 } from '@mastra/server/handlers/memory';
@@ -26,7 +28,6 @@ import { getTelemetryHandler as getTelemetryHandler$1, storeTelemetryHandler as
 import { executeAgentToolHandler as executeAgentToolHandler$1, getToolsHandler as getToolsHandler$1, getToolByIdHandler as getToolByIdHandler$1, executeToolHandler as executeToolHandler$1 } from '@mastra/server/handlers/tools';
 import { upsertVectors as upsertVectors$1, createIndex as createIndex$1, queryVectors as queryVectors$1, listIndexes as listIndexes$1, describeIndex as describeIndex$1, deleteIndex as deleteIndex$1 } from '@mastra/server/handlers/vector';
 import { getVNextWorkflowsHandler as getVNextWorkflowsHandler$1, getVNextWorkflowByIdHandler as getVNextWorkflowByIdHandler$1, getVNextWorkflowRunsHandler as getVNextWorkflowRunsHandler$1, resumeVNextWorkflowHandler as resumeVNextWorkflowHandler$1, resumeAsyncVNextWorkflowHandler as resumeAsyncVNextWorkflowHandler$1, createVNextWorkflowRunHandler as createVNextWorkflowRunHandler$1, startAsyncVNextWorkflowHandler as startAsyncVNextWorkflowHandler$1, startVNextWorkflowRunHandler as startVNextWorkflowRunHandler$1, watchVNextWorkflowHandler as watchVNextWorkflowHandler$1 } from '@mastra/server/handlers/vNextWorkflows';
-import { stream } from 'hono/streaming';
 import { getSpeakersHandler as getSpeakersHandler$1, generateSpeechHandler, transcribeSpeechHandler } from '@mastra/server/handlers/voice';
 import { getWorkflowsHandler as getWorkflowsHandler$1, getWorkflowByIdHandler as getWorkflowByIdHandler$1, getWorkflowRunsHandler as getWorkflowRunsHandler$1, resumeWorkflowHandler as resumeWorkflowHandler$1, resumeAsyncWorkflowHandler as resumeAsyncWorkflowHandler$1, createRunHandler as createRunHandler$1, startAsyncWorkflowHandler as startAsyncWorkflowHandler$1, startWorkflowRunHandler as startWorkflowRunHandler$1, watchWorkflowHandler as watchWorkflowHandler$1 } from '@mastra/server/handlers/workflows';
 
@@ -153,27 +154,48 @@ Object.setPrototypeOf(requestPrototype, Request.prototype);
 var newRequest = (incoming, defaultHostname) => {
   const req = Object.create(requestPrototype);
   req[incomingKey] = incoming;
+  const incomingUrl = incoming.url || "";
+  if (incomingUrl[0] !== "/" && // short-circuit for performance. most requests are relative URL.
+  (incomingUrl.startsWith("http://") || incomingUrl.startsWith("https://"))) {
+    if (incoming instanceof Http2ServerRequest) {
+      throw new RequestError("Absolute URL for :path is not allowed in HTTP/2");
+    }
+    try {
+      const url2 = new URL(incomingUrl);
+      req[urlKey] = url2.href;
+    } catch (e2) {
+      throw new RequestError("Invalid absolute URL", { cause: e2 });
+    }
+    return req;
+  }
   const host = (incoming instanceof Http2ServerRequest ? incoming.authority : incoming.headers.host) || defaultHostname;
   if (!host) {
     throw new RequestError("Missing host header");
   }
-  const url = new URL(
-    `${incoming instanceof Http2ServerRequest || incoming.socket && incoming.socket.encrypted ? "https" : "http"}://${host}${incoming.url}`
-  );
+  let scheme;
+  if (incoming instanceof Http2ServerRequest) {
+    scheme = incoming.scheme;
+    if (!(scheme === "http" || scheme === "https")) {
+      throw new RequestError("Unsupported scheme");
+    }
+  } else {
+    scheme = incoming.socket && incoming.socket.encrypted ? "https" : "http";
+  }
+  const url = new URL(`${scheme}://${host}${incomingUrl}`);
   if (url.hostname.length !== host.length && url.hostname !== host.replace(/:\d+$/, "")) {
     throw new RequestError("Invalid host header");
   }
   req[urlKey] = url.href;
   return req;
 };
-function writeFromReadableStream(stream3, writable) {
-  if (stream3.locked) {
+function writeFromReadableStream(stream4, writable) {
+  if (stream4.locked) {
     throw new TypeError("ReadableStream is locked.");
   } else if (writable.destroyed) {
-    stream3.cancel();
+    stream4.cancel();
     return;
   }
-  const reader = stream3.getReader();
+  const reader = stream4.getReader();
   writable.on("close", cancel);
   writable.on("error", cancel);
   reader.read().then(flow, cancel);
@@ -371,7 +393,7 @@ var responseViaResponseObject = async (res, outgoing, options = {}) => {
   const resHeaderRecord = buildOutgoingHttpHeaders(res.headers);
   const internalBody = getInternalBody(res);
   if (internalBody) {
-    const { length, source, stream: stream3 } = internalBody;
+    const { length, source, stream: stream4 } = internalBody;
     if (source instanceof Uint8Array && source.byteLength !== length) ; else {
       if (length) {
         resHeaderRecord["content-length"] = length;
@@ -382,7 +404,7 @@ var responseViaResponseObject = async (res, outgoing, options = {}) => {
       } else if (source instanceof Blob) {
         outgoing.end(new Uint8Array(await source.arrayBuffer()));
       } else {
-        await writeFromReadableStream(stream3, outgoing);
+        await writeFromReadableStream(stream4, outgoing);
       }
       return;
     }
@@ -455,7 +477,7 @@ var getRequestListener = (fetchCallback, options = {}) => {
       }
     }
     try {
-      return responseViaResponseObject(res, outgoing, options);
+      return await responseViaResponseObject(res, outgoing, options);
     } catch (e2) {
       return handleResponseError(e2, outgoing);
     }
@@ -486,18 +508,18 @@ var ENCODINGS = {
   gzip: ".gz"
 };
 var ENCODINGS_ORDERED_KEYS = Object.keys(ENCODINGS);
-var createStreamBody = (stream3) => {
+var createStreamBody = (stream4) => {
   const body = new ReadableStream({
     start(controller) {
-      stream3.on("data", (chunk) => {
+      stream4.on("data", (chunk) => {
         controller.enqueue(chunk);
       });
-      stream3.on("end", () => {
+      stream4.on("end", () => {
         controller.close();
       });
     },
     cancel() {
-      stream3.destroy();
+      stream4.destroy();
     }
   });
   return body;
@@ -593,10 +615,10 @@ var serveStatic = (options = { root: "" }) => {
       end = size - 1;
     }
     const chunksize = end - start + 1;
-    const stream3 = createReadStream(path, { start, end });
+    const stream4 = createReadStream(path, { start, end });
     c2.header("Content-Length", chunksize.toString());
     c2.header("Content-Range", `bytes ${start}-${end}/${stats.size}`);
-    return c2.body(createStreamBody(stream3), 206);
+    return c2.body(createStreamBody(stream4), 206);
   };
 };
 var RENDER_TYPE = {
@@ -717,7 +739,7 @@ var middleware = (options) => async (c2) => {
   );
 };
 
-// ../../node_modules/.pnpm/hono-openapi@0.4.6_hono@4.7.4_openapi-types@12.1.3_zod@3.24.3/node_modules/hono-openapi/utils.js
+// ../../node_modules/.pnpm/hono-openapi@0.4.6_hono@4.7.7_openapi-types@12.1.3_zod@3.24.4/node_modules/hono-openapi/utils.js
 var e = Symbol("openapi");
 var s2 = ["GET", "PUT", "POST", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"];
 var n = (e2) => e2.charAt(0).toUpperCase() + e2.slice(1);
@@ -843,6 +865,59 @@ async function x(e2, t2, s3 = {}) {
   }
   return { docs: o2, components: n2 };
 }
+async function getAgentCardByIdHandler(c2) {
+  const mastra = c2.get("mastra");
+  const agentId = c2.req.param("agentId");
+  const runtimeContext = c2.get("runtimeContext");
+  const result = await getAgentCardByIdHandler$1({
+    mastra,
+    agentId,
+    runtimeContext
+  });
+  return c2.json(result);
+}
+async function getAgentExecutionHandler(c2) {
+  const mastra = c2.get("mastra");
+  const agentId = c2.req.param("agentId");
+  const runtimeContext = c2.get("runtimeContext");
+  const logger2 = mastra.getLogger();
+  const body = await c2.req.json();
+  if (!["tasks/send", "tasks/sendSubscribe", "tasks/get", "tasks/cancel"].includes(body.method)) {
+    return c2.json({ error: { message: `Unsupported method: ${body.method}`, code: "invalid_method" } }, 400);
+  }
+  const result = await getAgentExecutionHandler$1({
+    mastra,
+    agentId,
+    runtimeContext,
+    requestId: randomUUID(),
+    method: body.method,
+    params: body.params,
+    logger: logger2
+  });
+  if (body.method === "tasks/sendSubscribe") {
+    return stream(
+      c2,
+      async (stream4) => {
+        try {
+          stream4.onAbort(() => {
+            if (!result.locked) {
+              return result.cancel();
+            }
+          });
+          for await (const chunk of result) {
+            await stream4.write(JSON.stringify(chunk) + "");
+          }
+        } catch (err) {
+          logger2.error("Error in tasks/sendSubscribe stream: " + err?.message);
+        }
+      },
+      async (err) => {
+        logger2.error("Error in tasks/sendSubscribe stream: " + err?.message);
+      }
+    );
+  }
+  return c2.json(result);
+}
 function handleError(error, defaultMessage) {
   const apiError = error;
   throw new HTTPException(apiError.status || 500, {
@@ -963,7 +1038,7 @@ async function setAgentInstructionsHandler(c2) {
 // src/server/handlers/client.ts
 var clients = /* @__PURE__ */ new Set();
 function handleClientsRefresh(c2) {
-  const stream3 = new ReadableStream({
+  const stream4 = new ReadableStream({
     start(controller) {
       clients.add(controller);
       controller.enqueue("data: connected\n\n");
@@ -972,7 +1047,7 @@ function handleClientsRefresh(c2) {
       });
     }
   });
-  return new Response(stream3, {
+  return new Response(stream4, {
     headers: {
       "Content-Type": "text/event-stream",
       "Cache-Control": "no-cache",
@@ -1392,13 +1467,14 @@ function executeToolHandler(tools) {
       const runtimeContext = c2.get("runtimeContext");
       const toolId = decodeURIComponent(c2.req.param("toolId"));
       const runId = c2.req.query("runId");
-      const { data } = await c2.req.json();
+      const { data, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
       const result = await executeToolHandler$1(tools)({
         mastra,
         toolId,
         data,
         runtimeContext,
-        runId
+        runId,
+        runtimeContextFromRequest
       });
       return c2.json(result);
     } catch (error) {
@@ -1412,13 +1488,14 @@ async function executeAgentToolHandler(c2) {
     const runtimeContext = c2.get("runtimeContext");
     const agentId = c2.req.param("agentId");
     const toolId = c2.req.param("toolId");
-    const { data } = await c2.req.json();
+    const { data, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
     const result = await executeAgentToolHandler$1({
       mastra,
       agentId,
       toolId,
       data,
-      runtimeContext
+      runtimeContext,
+      runtimeContextFromRequest
     });
     return c2.json(result);
   } catch (error) {
@@ -1566,11 +1643,13 @@ async function startAsyncVNextWorkflowHandler(c2) {
   try {
     const mastra = c2.get("mastra");
     const workflowId = c2.req.param("workflowId");
-    const { inputData, runtimeContext } = await c2.req.json();
+    const runtimeContext = c2.get("runtimeContext");
+    const { inputData, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
     const runId = c2.req.query("runId");
     const result = await startAsyncVNextWorkflowHandler$1({
       mastra,
       runtimeContext,
+      runtimeContextFromRequest,
       workflowId,
       runId,
       inputData
@@ -1584,11 +1663,13 @@ async function startVNextWorkflowRunHandler(c2) {
   try {
     const mastra = c2.get("mastra");
     const workflowId = c2.req.param("workflowId");
-    const { inputData, runtimeContext } = await c2.req.json();
+    const runtimeContext = c2.get("runtimeContext");
+    const { inputData, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
     const runId = c2.req.query("runId");
     await startVNextWorkflowRunHandler$1({
       mastra,
       runtimeContext,
+      runtimeContextFromRequest,
       workflowId,
       runId,
       inputData
@@ -1609,20 +1690,20 @@ function watchVNextWorkflowHandler(c2) {
     }
     return stream(
       c2,
-      async (stream3) => {
+      async (stream4) => {
         try {
           const result = await watchVNextWorkflowHandler$1({
             mastra,
             workflowId,
             runId
           });
-          stream3.onAbort(() => {
+          stream4.onAbort(() => {
             if (!result.locked) {
               return result.cancel();
             }
           });
           for await (const chunk of result) {
-            await stream3.write(chunk.toString() + "");
+            await stream4.write(chunk.toString() + "");
           }
         } catch (err) {
           console.log(err);
@@ -1641,13 +1722,15 @@ async function resumeAsyncVNextWorkflowHandler(c2) {
     const mastra = c2.get("mastra");
     const workflowId = c2.req.param("workflowId");
     const runId = c2.req.query("runId");
-    const { step, resumeData, runtimeContext } = await c2.req.json();
+    const runtimeContext = c2.get("runtimeContext");
+    const { step, resumeData, runtimeContext: runtimeContextFromRequest } = await c2.req.json();
     if (!runId) {
       throw new HTTPException(400, { message: "runId required to resume workflow" });
     }
     const result = await resumeAsyncVNextWorkflowHandler$1({
       mastra,
       runtimeContext,
+      runtimeContextFromRequest,
       workflowId,
       runId,
       body: { step, resumeData }
@@ -1844,20 +1927,20 @@ function watchWorkflowHandler(c2) {
     }
     return stream(
       c2,
-      async (stream3) => {
+      async (stream4) => {
         try {
           const result = await watchWorkflowHandler$1({
             mastra,
             workflowId,
             runId
           });
-          stream3.onAbort(() => {
+          stream4.onAbort(() => {
             if (!result.locked) {
               return result.cancel();
             }
           });
           for await (const chunk of result) {
-            await stream3.write(chunk.toString() + "");
+            await stream4.write(chunk.toString() + "");
           }
         } catch (err) {
           console.log(err);
@@ -2087,7 +2170,18 @@ async function createHonoServer(mastra, options = {}) {
   app.onError(errorHandler);
   app.use("*", function setContext(c2, next) {
     const runtimeContext = new RuntimeContext();
-    c2.set("runtimeContext", runtimeContext);
+    const proxyRuntimeContext = new Proxy(runtimeContext, {
+      get(target, prop) {
+        if (prop === "get") {
+          return function(key) {
+            const value = target.get(key);
+            return value ?? `<${key}>`;
+          };
+        }
+        return Reflect.get(target, prop);
+      }
+    });
+    c2.set("runtimeContext", proxyRuntimeContext);
     c2.set("mastra", mastra);
     c2.set("tools", tools);
     c2.set("playground", options.playground === true);
@@ -2161,6 +2255,142 @@ async function createHonoServer(mastra, options = {}) {
   if (server?.build?.apiReqLogs) {
     app.use(logger());
   }
+  app.get(
+    "/.well-known/:agentId/agent.json",
+    h({
+      description: "Get agent configuration",
+      tags: ["agents"],
+      parameters: [
+        {
+          name: "agentId",
+          in: "path",
+          required: true,
+          schema: { type: "string" }
+        }
+      ],
+      responses: {
+        200: {
+          description: "Agent configuration"
+        }
+      }
+    }),
+    getAgentCardByIdHandler
+  );
+  app.post(
+    "/a2a/:agentId",
+    h({
+      description: "Execute agent via A2A protocol",
+      tags: ["agents"],
+      parameters: [
+        {
+          name: "agentId",
+          in: "path",
+          required: true,
+          schema: { type: "string" }
+        }
+      ],
+      requestBody: {
+        required: true,
+        content: {
+          "application/json": {
+            schema: {
+              type: "object",
+              properties: {
+                method: {
+                  type: "string",
+                  enum: ["tasks/send", "tasks/sendSubscribe", "tasks/get", "tasks/cancel"],
+                  description: "The A2A protocol method to execute"
+                },
+                params: {
+                  type: "object",
+                  oneOf: [
+                    {
+                      // TaskSendParams
+                      type: "object",
+                      properties: {
+                        id: {
+                          type: "string",
+                          description: "Unique identifier for the task being initiated or continued"
+                        },
+                        sessionId: {
+                          type: "string",
+                          description: "Optional identifier for the session this task belongs to"
+                        },
+                        message: {
+                          type: "object",
+                          description: "The message content to send to the agent for processing"
+                        },
+                        pushNotification: {
+                          type: "object",
+                          nullable: true,
+                          description: "Optional pushNotification information for receiving notifications about this task"
+                        },
+                        historyLength: {
+                          type: "integer",
+                          nullable: true,
+                          description: "Optional parameter to specify how much message history to include in the response"
+                        },
+                        metadata: {
+                          type: "object",
+                          nullable: true,
+                          description: "Optional metadata associated with sending this message"
+                        }
+                      },
+                      required: ["id", "message"]
+                    },
+                    {
+                      // TaskQueryParams
+                      type: "object",
+                      properties: {
+                        id: { type: "string", description: "The unique identifier of the task" },
+                        historyLength: {
+                          type: "integer",
+                          nullable: true,
+                          description: "Optional history length to retrieve for the task"
+                        },
+                        metadata: {
+                          type: "object",
+                          nullable: true,
+                          description: "Optional metadata to include with the operation"
+                        }
+                      },
+                      required: ["id"]
+                    },
+                    {
+                      // TaskIdParams
+                      type: "object",
+                      properties: {
+                        id: { type: "string", description: "The unique identifier of the task" },
+                        metadata: {
+                          type: "object",
+                          nullable: true,
+                          description: "Optional metadata to include with the operation"
+                        }
+                      },
+                      required: ["id"]
+                    }
+                  ]
+                }
+              },
+              required: ["method", "params"]
+            }
+          }
+        }
+      },
+      responses: {
+        200: {
+          description: "A2A response"
+        },
+        400: {
+          description: "Missing or invalid request parameters"
+        },
+        404: {
+          description: "Agent not found"
+        }
+      }
+    }),
+    getAgentExecutionHandler
+  );
   app.get(
     "/api",
     h({
@@ -3001,7 +3231,8 @@ async function createHonoServer(mastra, options = {}) {
             schema: {
               type: "object",
               properties: {
-                data: { type: "object" }
+                data: { type: "object" },
+                runtimeContext: { type: "object" }
               },
               required: ["data"]
             }
@@ -3388,7 +3619,10 @@ async function createHonoServer(mastra, options = {}) {
                   oneOf: [{ type: "string" }, { type: "array", items: { type: "string" } }]
                 },
                 resumeData: { type: "object" },
-                runtimeContext: { type: "object" }
+                runtimeContext: {
+                  type: "object",
+                  description: "Runtime context for the workflow execution"
+                }
               },
               required: ["step"]
             }
@@ -3429,7 +3663,10 @@ async function createHonoServer(mastra, options = {}) {
                   oneOf: [{ type: "string" }, { type: "array", items: { type: "string" } }]
                 },
                 resumeData: { type: "object" },
-                runtimeContext: { type: "object" }
+                runtimeContext: {
+                  type: "object",
+                  description: "Runtime context for the workflow execution"
+                }
               },
               required: ["step"]
             }
@@ -3495,7 +3732,10 @@ async function createHonoServer(mastra, options = {}) {
               type: "object",
               properties: {
                 inputData: { type: "object" },
-                runtimeContext: { type: "object" }
+                runtimeContext: {
+                  type: "object",
+                  description: "Runtime context for the workflow execution"
+                }
               }
             }
           }
@@ -3539,7 +3779,10 @@ async function createHonoServer(mastra, options = {}) {
               type: "object",
               properties: {
                 inputData: { type: "object" },
-                runtimeContext: { type: "object" }
+                runtimeContext: {
+                  type: "object",
+                  description: "Runtime context for the workflow execution"
+                }
               }
             }
           }
@@ -4066,7 +4309,8 @@ async function createHonoServer(mastra, options = {}) {
             schema: {
               type: "object",
               properties: {
-                data: { type: "object" }
+                data: { type: "object" },
+                runtimeContext: { type: "object" }
               },
               required: ["data"]
             }
@@ -4359,7 +4603,7 @@ async function createNodeServer(mastra, options = {}) {
       const host = serverOptions?.host ?? "localhost";
       logger2.info(` Mastra API running on port http://${host}:${port}/api`);
       if (options?.isDev) {
-        logger2.info(`\uFFFD Open API documentation available at http://${host}:${port}/openapi.json`);
+        logger2.info(`\u{1F517} Open API documentation available at http://${host}:${port}/openapi.json`);
       }
       if (options?.isDev) {
         logger2.info(`\u{1F9EA} Swagger UI available at http://${host}:${port}/swagger-ui`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/deployer",
-  "version": "0.3.3-alpha.1",
+  "version": "0.3.4-alpha.0",
   "description": "",
   "type": "module",
   "files": [
@@ -107,8 +107,8 @@
     "rollup-plugin-node-externals": "^8.0.0",
     "typescript-paths": "^1.5.1",
     "zod": "^3.24.3",
-    "@mastra/core": "^0.9.3-alpha.1",
-    "@mastra/server": "^2.0.3-alpha.1"
+    "@mastra/core": "^0.9.4-alpha.0",
+    "@mastra/server": "^2.0.4-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.13.8",
@@ -128,7 +128,7 @@
     "typescript": "^5.8.2",
     "vitest": "^2.1.9",
     "zod-to-json-schema": "^3.24.5",
-    "@internal/lint": "0.0.3"
+    "@internal/lint": "0.0.4"
   },
   "scripts": {
     "build": "tsup src/index.ts src/build/index.ts src/server/index.ts src/build/bundler.ts src/build/analyze.ts src/bundler/index.ts src/services/index.ts src/validator/loader.ts src/validator/custom-resolver.ts --format esm,cjs --clean --experimental-dts --treeshake=smallest --splitting --publicDir",