mastra 0.1.57-unstable.37 → 0.1.57-unstable.56

package/dist/templates/express-server.js

@@ -1,8 +1,23 @@
 import express from 'express';
 import expressJSDocSwagger from 'express-jsdoc-swagger';
-import { join } from 'path';
+import _path, { join } from 'path';
 import serverless from 'serverless-http';
+import { stringify } from 'superjson';
+import { fileURLToPath as _fileURLToPath } from 'url';
+import zodToJsonSchema from 'zod-to-json-schema';
+const ___filename = _fileURLToPath(import.meta.url);
+const ___dirname = _path.dirname(___filename);
 const { mastra } = await import(join(process.cwd(), 'mastra.mjs'));
+const mastraToolsPaths = process.env.MASTRA_TOOLS_PATH;
+const toolImports = mastraToolsPaths
+    ? await Promise.all(mastraToolsPaths.split(',').map(toolPath => import(toolPath)))
+    : [];
+const tools = toolImports.reduce((acc, toolModule) => {
+    Object.entries(toolModule).forEach(([key, tool]) => {
+        acc[key] = tool;
+    });
+    return acc;
+}, {});
 const app = express();
 app.use(express.json());
 // Swagger configuration
@@ -24,7 +39,7 @@ const options = {
             description: 'Local server',
         },
     ],
-    baseDir: __dirname,
+    baseDir: ___dirname,
     filesPattern: './**/*.mjs',
     exposeSwaggerUI: false,
     exposeApiDocs: true,
@@ -45,40 +60,76 @@ const validateBody = async (body) => {
     return { ok: true };
 };
 /**
- * GET /
- * @summary Health check endpoint
- * @tags System
- * @return {string} 200 - Health check response
+ * GET /api/agents/{agentId}
+ * @summary Get agent by ID
+ * @tags Agent
+ * @param {string} agentId.path.required - Agent identifier
+ * @return {object} 200 - Agent response
+ * @return {Error} 500 - Server error
  */
-app.get('/', (_req, res) => {
-    res.send('Hello World!');
+app.get('/api/agents/:agentId', async (req, res) => {
+    try {
+        const agentId = req.params.agentId;
+        const agent = mastra.getAgent(agentId);
+        const serializedAgentTools = Object.entries(agent?.tools || {}).reduce((acc, [key, tool]) => {
+            const _tool = tool;
+            acc[key] = {
+                ..._tool,
+                inputSchema: _tool.inputSchema ? stringify(zodToJsonSchema(_tool.inputSchema)) : undefined,
+                outputSchema: _tool.outputSchema ? stringify(zodToJsonSchema(_tool.outputSchema)) : undefined,
+            };
+            return acc;
+        }, {});
+        res.json({
+            ...agent,
+            tools: serializedAgentTools,
+        });
+    }
+    catch (error) {
+        const apiError = error;
+        console.error('Error getting agent', apiError);
+        res.status(apiError.status || 500).json({ error: apiError.message || 'Error getting agent' });
+        return;
+    }
 });
-// Serve static files from the Vite build first
-app.use('/assets', express.static(join(__dirname, 'agent-chat/assets'), {
-    setHeaders: (res, path) => {
-        // Set correct MIME types
-        if (path.endsWith('.js')) {
-            res.set('Content-Type', 'application/javascript');
-        }
-        else if (path.endsWith('.css')) {
-            res.set('Content-Type', 'text/css');
-        }
-    },
-}));
-// Serve other static files
-app.use(express.static(join(__dirname, 'agent-chat')));
 /**
- * GET /agent/{agentId}
- * @summary Serve agent chat interface
+ * GET /api/agents
+ * @summary Get all agents
  * @tags Agent
- * @param {string} agentId.path.required - Agent identifier
- * @return {html} 200 - Agent chat interface
+ * @return {object} 200 - Agent response
+ * @return {Error} 500 - Server error
  */
-app.get('/agent/:agentId', (_req, res) => {
-    res.sendFile(join(__dirname, 'agent-chat/index.html'));
+app.get('/api/agents', async (_req, res) => {
+    try {
+        const agents = mastra.getAgents();
+        const serializedAgents = Object.entries(agents).reduce((acc, [_id, _agent]) => {
+            const agent = _agent;
+            const serializedAgentTools = Object.entries(agent?.tools || {}).reduce((acc, [key, tool]) => {
+                const _tool = tool;
+                acc[key] = {
+                    ..._tool,
+                    inputSchema: _tool.inputSchema ? stringify(zodToJsonSchema(_tool.inputSchema)) : undefined,
+                    outputSchema: _tool.outputSchema ? stringify(zodToJsonSchema(_tool.outputSchema)) : undefined,
+                };
+                return acc;
+            }, {});
+            acc[_id] = {
+                ...agent,
+                tools: serializedAgentTools,
+            };
+            return acc;
+        }, {});
+        res.json(serializedAgents);
+    }
+    catch (error) {
+        const apiError = error;
+        console.error('Error getting agents', apiError);
+        res.status(apiError.status || 500).json({ error: apiError.message || 'Error getting agents' });
+        return;
+    }
 });
 /**
- * POST /agent/{agentId}/text
+ * POST /api/agents/{agentId}/text
  * @summary Send text messages to agent
  * @tags Agent
  * @param {string} agentId.path.required - Agent identifier
@@ -87,7 +138,7 @@ app.get('/agent/:agentId', (_req, res) => {
  * @return {Error} 400 - Validation error
  * @return {Error} 500 - Server error
  */
-app.post('/agent/:agentId/text', async (req, res) => {
+app.post('/api/agents/:agentId/text', async (req, res) => {
     try {
         const agentId = req.params.agentId;
         const agent = mastra.getAgent(agentId);
@@ -103,7 +154,7 @@ app.post('/agent/:agentId/text', async (req, res) => {
             res.status(400).json({ error: { messages: 'Messages should be an array' } });
             return;
         }
-        const result = await agent.text({ messages });
+        const result = await agent.generate(messages);
         res.json(result);
     }
     catch (error) {
@@ -114,7 +165,7 @@ app.post('/agent/:agentId/text', async (req, res) => {
     }
 });
 /**
- * POST /agent/{agentId}/stream
+ * POST /api/agents/{agentId}/stream
  * @summary Stream messages to agent
  * @tags Agent
  * @param {string} agentId.path.required - Agent identifier
@@ -123,7 +174,7 @@ app.post('/agent/:agentId/text', async (req, res) => {
  * @return {Error} 400 - Validation error
  * @return {Error} 500 - Server error
  */
-app.post('/agent/:agentId/stream', async (req, res) => {
+app.post('/api/agents/:agentId/stream', async (req, res) => {
     try {
         const agentId = req.params.agentId;
         const agent = mastra.getAgent(agentId);
@@ -139,8 +190,8 @@ app.post('/agent/:agentId/stream', async (req, res) => {
             res.status(400).json({ error: { messages: 'Messages should be an array' } });
             return;
         }
-        const streamResult = await agent.stream({
-            messages,
+        const streamResult = await agent.generate(messages, {
+            stream: true,
         });
         streamResult.pipeDataStreamToResponse(res);
     }
@@ -152,24 +203,24 @@ app.post('/agent/:agentId/stream', async (req, res) => {
     }
 });
 /**
- * POST /agent/{agentId}/text-object
+ * POST /api/agents/{agentId}/text-object
  * @summary Get structured output from agent
  * @tags Agent
  * @param {string} agentId.path.required - Agent identifier
- * @param {TextObjectRequest} request.body.required - Request with messages and structured output spec
+ * @param {TextObjectRequest} request.body.required - Request with messages and schema spec
  * @return {object} 200 - Structured output response
  * @return {Error} 400 - Validation error
  * @return {Error} 500 - Server error
  */
-app.post('/agent/:agentId/text-object', async (req, res) => {
+app.post('/api/agents/:agentId/text-object', async (req, res) => {
     try {
         const agentId = req.params.agentId;
         const agent = mastra.getAgent(agentId);
         const messages = req.body.messages;
-        const structuredOutput = req.body.structuredOutput;
+        const schema = req.body.schema;
         const { ok, errorResponse } = await validateBody({
             messages,
-            structuredOutput,
+            schema,
         });
         if (!ok) {
             res.status(400).json({ error: errorResponse });
@@ -179,7 +230,7 @@ app.post('/agent/:agentId/text-object', async (req, res) => {
             res.status(400).json({ error: { messages: 'Messages should be an array' } });
             return;
         }
-        const result = await agent.textObject({ messages, structuredOutput });
+        const result = await agent.generate(messages, { schema });
         res.json(result);
     }
     catch (error) {
@@ -192,24 +243,24 @@ app.post('/agent/:agentId/text-object', async (req, res) => {
     }
 });
 /**
- * POST /agent/{agentId}/stream-object
+ * POST /api/agents/{agentId}/stream-object
  * @summary Stream structured output from agent
  * @tags Agent
  * @param {string} agentId.path.required - Agent identifier
- * @param {TextObjectRequest} request.body.required - Request with messages and structured output spec
+ * @param {TextObjectRequest} request.body.required - Request with messages and schema spec
  * @return {stream} 200 - Structured output stream
  * @return {Error} 400 - Validation error
  * @return {Error} 500 - Server error
  */
-app.post('/agent/:agentId/stream-object', async (req, res) => {
+app.post('/api/agents/:agentId/stream-object', async (req, res) => {
     try {
         const agentId = req.params.agentId;
         const agent = mastra.getAgent(agentId);
         const messages = req.body.messages;
-        const structuredOutput = req.body.structuredOutput;
+        const schema = req.body.schema;
         const { ok, errorResponse } = await validateBody({
             messages,
-            structuredOutput,
+            schema,
         });
         if (!ok) {
             res.status(400).json({ error: errorResponse });
@@ -219,10 +270,7 @@ app.post('/agent/:agentId/stream-object', async (req, res) => {
             res.status(400).json({ error: { messages: 'Messages should be an array' } });
             return;
         }
-        const streamResult = await agent.streamObject({
-            messages,
-            structuredOutput,
-        });
+        const streamResult = await agent.generate(messages, { schema, stream: true });
         streamResult.pipeTextStreamToResponse(res);
     }
     catch (error) {
@@ -235,7 +283,97 @@ app.post('/agent/:agentId/stream-object', async (req, res) => {
     }
 });
 /**
- * POST /workflows/{workflowId}/execute
+ * POST /api/agents/{agentId}/tools/{toolId}/execute
+ * @summary Execute an Agent tool
+ * @tags Agent
+ * @param {string} agentId.path.required - Agent identifier
+ * @param {string} toolId.path.required - Tool identifier
+ * @param {object} request.body.required - Tool input data
+ * @return {object} 200 - Tool execution result
+ * @return {Error} 500 - Server error
+ */
+app.post('/api/agents/:agentId/tools/:toolId/execute', async (req, res) => {
+    try {
+        const agentId = req.params.agentId;
+        const toolId = req.params.toolId;
+        const agent = mastra.getAgent(agentId);
+        const tool = Object.values(agent?.tools || {}).find((tool) => tool.id === toolId);
+        const result = await tool.execute({
+            context: {
+                ...req.body,
+            },
+            mastra,
+            runId: agentId,
+        });
+        res.json(result);
+    }
+    catch (error) {
+        const apiError = error;
+        console.error('Error executing tool', apiError);
+        res.status(apiError.status || 500).json({ error: apiError.message || 'Error executing tool' });
+        return;
+    }
+});
+/**
+ * GET /api/workflows
+ * @summary Get all workflows
+ * @tags Workflow
+ * @return {object} 200 - Workflows response
+ * @return {Error} 500 - Server error
+ */
+app.get('/api/workflows', async (_req, res) => {
+    try {
+        const workflows = mastra.getWorkflows();
+        res.json(workflows);
+    }
+    catch (error) {
+        const apiError = error;
+        console.error('Error getting workflows', apiError);
+        res.status(apiError.status || 500).json({ error: apiError.message || 'Error getting workflows' });
+        return;
+    }
+});
+/**
+ * GET /api/workflows/{workflowId}
+ * @summary Get a workflow
+ * @tags Workflow
+ * @param {string} workflowId.path.required - Workflow identifier
+ * @return {object} 200 - Workflow response
+ * @return {Error} 500 - Server error
+ */
+app.get('/api/workflows/:workflowId', async (req, res) => {
+    try {
+        const workflowId = req.params.workflowId;
+        const workflow = mastra.getWorkflow(workflowId);
+        const triggerSchema = workflow.triggerSchema;
+        const stepGraph = workflow.stepGraph;
+        const stepSubscriberGraph = workflow.stepSubscriberGraph;
+        const serializedSteps = Object.entries(workflow.steps).reduce((acc, [key, step]) => {
+            const _step = step;
+            acc[key] = {
+                ..._step,
+                inputSchema: _step.inputSchema ? stringify(zodToJsonSchema(_step.inputSchema)) : undefined,
+                outputSchema: _step.outputSchema ? stringify(zodToJsonSchema(_step.outputSchema)) : undefined,
+            };
+            return acc;
+        }, {});
+        res.json({
+            ...workflow,
+            triggerSchema: triggerSchema ? stringify(zodToJsonSchema(triggerSchema)) : undefined,
+            steps: serializedSteps,
+            stepGraph,
+            stepSubscriberGraph,
+        });
+    }
+    catch (error) {
+        const apiError = error;
+        console.error('Error getting workflow', apiError);
+        res.status(apiError.status || 500).json({ error: apiError.message || 'Error getting workflow' });
+        return;
+    }
+});
+/**
+ * POST /api/workflows/{workflowId}/execute
  * @summary Execute a workflow
  * @tags Workflow
  * @param {string} workflowId.path.required - Workflow identifier
@@ -243,10 +381,10 @@ app.post('/agent/:agentId/stream-object', async (req, res) => {
  * @return {object} 200 - Workflow execution result
  * @return {Error} 500 - Server error
  */
-app.post('/workflows/:workflowId/execute', async (req, res) => {
+app.post('/api/workflows/:workflowId/execute', async (req, res) => {
     try {
         const workflowId = req.params.workflowId;
-        const workflow = mastra.workflows.get(workflowId);
+        const workflow = mastra.getWorkflow(workflowId);
         const result = await workflow.execute(req.body);
         res.json(result);
     }
@@ -258,7 +396,7 @@ app.post('/workflows/:workflowId/execute', async (req, res) => {
     }
 });
 /**
- * GET /memory/threads/get-by-resourceid/{resourceid}
+ * GET /api/memory/threads/get-by-resourceid/{resourceid}
  * @summary Get threads by resource ID
  * @tags Memory
  * @param {string} resourceid.path.required - Resource identifier
@@ -266,7 +404,7 @@ app.post('/workflows/:workflowId/execute', async (req, res) => {
  * @return {Error} 400 - Memory not initialized
  * @return {Error} 500 - Server error
  */
-app.get('/memory/threads/get-by-resourceid/:resourceid', async (req, res) => {
+app.get('/api/memory/threads/get-by-resourceid/:resourceid', async (req, res) => {
     try {
         const resourceid = req.params.resourceid;
         const memory = mastra.memory;
@@ -285,7 +423,7 @@ app.get('/memory/threads/get-by-resourceid/:resourceid', async (req, res) => {
     }
 });
 /**
- * GET /memory/threads/{threadId}
+ * GET /api/memory/threads/{threadId}
  * @summary Get thread by ID
  * @tags Memory
  * @param {string} threadId.path.required - Thread identifier
@@ -294,7 +432,7 @@ app.get('/memory/threads/get-by-resourceid/:resourceid', async (req, res) => {
  * @return {Error} 404 - Thread not found
  * @return {Error} 500 - Server error
  */
-app.get('/memory/threads/:threadId', async (req, res) => {
+app.get('/api/memory/threads/:threadId', async (req, res) => {
     try {
         const threadId = req.params.threadId;
         const memory = mastra.memory;
@@ -317,7 +455,7 @@ app.get('/memory/threads/:threadId', async (req, res) => {
     }
 });
 /**
- * POST /memory/threads
+ * POST /api/memory/threads
  * @summary Create a new thread
  * @tags Memory
  * @param {Thread} request.body.required - Thread details
@@ -325,7 +463,7 @@ app.get('/memory/threads/:threadId', async (req, res) => {
  * @return {Error} 400 - Memory not initialized or validation error
  * @return {Error} 500 - Server error
  */
-app.post('/memory/threads', async (req, res) => {
+app.post('/api/memory/threads', async (req, res) => {
     try {
         const memory = mastra.memory;
         const { title, metadata, resourceid, threadId } = req.body;
@@ -349,7 +487,7 @@ app.post('/memory/threads', async (req, res) => {
     }
 });
 /**
- * PATCH /memory/threads/{threadId}
+ * PATCH /api/memory/threads/{threadId}
  * @summary Update thread details
  * @tags Memory
  * @param {string} threadId.path.required - Thread identifier
@@ -362,7 +500,7 @@ app.post('/memory/threads', async (req, res) => {
  * @return {Error} 404 - Thread not found
  * @return {Error} 500 - Server error
  */
-app.patch('/memory/threads/:threadId', async (req, res) => {
+app.patch('/api/memory/threads/:threadId', async (req, res) => {
     try {
         const threadId = req.params.threadId;
         const memory = mastra.memory;
@@ -396,7 +534,7 @@ app.patch('/memory/threads/:threadId', async (req, res) => {
     }
 });
 /**
- * DELETE /memory/threads/{threadId}
+ * DELETE /api/memory/threads/{threadId}
  * @summary Delete a thread
  * @tags Memory
  * @param {string} threadId.path.required - Thread identifier
@@ -405,7 +543,7 @@ app.patch('/memory/threads/:threadId', async (req, res) => {
  * @return {Error} 404 - Thread not found
  * @return {Error} 500 - Server error
  */
-app.delete('/memory/threads/:threadId', async (req, res) => {
+app.delete('/api/memory/threads/:threadId', async (req, res) => {
     try {
         const threadId = req.params.threadId;
         const memory = mastra.memory;
@@ -429,7 +567,7 @@ app.delete('/memory/threads/:threadId', async (req, res) => {
     }
 });
 /**
- * GET /memory/threads/{threadId}/messages
+ * GET /api/memory/threads/{threadId}/messages
  * @summary Get messages from a thread
  * @tags Memory
  * @param {string} threadId.path.required - Thread identifier
@@ -438,7 +576,7 @@ app.delete('/memory/threads/:threadId', async (req, res) => {
  * @return {Error} 404 - Thread not found
  * @return {Error} 500 - Server error
  */
-app.get('/memory/threads/:threadId/messages', async (req, res) => {
+app.get('/api/memory/threads/:threadId/messages', async (req, res) => {
     try {
         const threadId = req.params.threadId;
         const memory = mastra.memory;
@@ -462,7 +600,7 @@ app.get('/memory/threads/:threadId/messages', async (req, res) => {
     }
 });
 /**
- * GET /memory/threads/{threadId}/context-window
+ * GET /api/memory/threads/{threadId}/context-window
  * @summary Get context window for a thread
  * @tags Memory
  * @param {string} threadId.path.required - Thread identifier
@@ -474,7 +612,7 @@ app.get('/memory/threads/:threadId/messages', async (req, res) => {
  * @return {Error} 404 - Thread not found
  * @return {Error} 500 - Server error
  */
-app.get('/memory/threads/:threadId/context-window', async (req, res) => {
+app.get('/api/memory/threads/:threadId/context-window', async (req, res) => {
     try {
         const threadId = req.params.threadId;
         const { startDate, endDate, format } = req.query;
@@ -499,7 +637,7 @@ app.get('/memory/threads/:threadId/context-window', async (req, res) => {
     }
 });
 /**
- * POST /memory/save-messages
+ * POST /api/memory/save-messages
  * @summary Save messages to memory
  * @tags Memory
  * @param {Message[]} request.body.required - Array of messages to save
@@ -507,7 +645,7 @@ app.get('/memory/threads/:threadId/context-window', async (req, res) => {
  * @return {Error} 400 - Memory not initialized or validation error
  * @return {Error} 500 - Server error
  */
-app.post('/memory/save-messages', async (req, res) => {
+app.post('/api/memory/save-messages', async (req, res) => {
     try {
         const memory = mastra.memory;
         const messages = req.body;
@@ -542,7 +680,7 @@ app.post('/memory/save-messages', async (req, res) => {
     }
 });
 /**
- * POST /memory/threads/{threadId}/tool-result
+ * POST /api/memory/threads/{threadId}/tool-result
  * @summary Get tool execution result
  * @tags Memory
  * @param {string} threadId.path.required - Thread identifier
@@ -554,7 +692,7 @@ app.post('/memory/save-messages', async (req, res) => {
  * @return {Error} 404 - Thread not found
  * @return {Error} 500 - Server error
  */
-app.post('/memory/threads/:threadId/tool-result', async (req, res) => {
+app.post('/api/memory/threads/:threadId/tool-result', async (req, res) => {
     try {
         const threadId = req.params.threadId;
         const memory = mastra.memory;
@@ -584,7 +722,7 @@ app.post('/memory/threads/:threadId/tool-result', async (req, res) => {
     }
 });
 /**
- * POST /memory/validate-tool-call-args
+ * POST /api/memory/validate-tool-call-args
  * @summary Validate tool call arguments
  * @tags Memory
  * @param {object} request.body.required - Validation request
@@ -593,7 +731,7 @@ app.post('/memory/threads/:threadId/tool-result', async (req, res) => {
  * @return {Error} 400 - Memory not initialized or validation error
  * @return {Error} 500 - Server error
  */
-app.post('/memory/validate-tool-call-args', async (req, res) => {
+app.post('/api/memory/validate-tool-call-args', async (req, res) => {
     try {
         const memory = mastra.memory;
         const { hashedArgs } = req.body;
@@ -617,7 +755,7 @@ app.post('/memory/validate-tool-call-args', async (req, res) => {
     }
 });
 /**
- * POST /syncs/{syncId}/execute
+ * POST /api/syncs/{syncId}/execute
  * @summary Execute a sync operation
  * @tags Sync
  * @param {string} syncId.path.required - Sync identifier
@@ -628,7 +766,7 @@ app.post('/memory/validate-tool-call-args', async (req, res) => {
  * @return {Error} 400 - Validation error
  * @return {Error} 500 - Server error
  */
-app.post('/syncs/:syncId/execute', async (req, res) => {
+app.post('/api/syncs/:syncId/execute', async (req, res) => {
     try {
         const syncId = req.params.syncId;
         const { runId, params } = req.body;
@@ -647,8 +785,151 @@ app.post('/syncs/:syncId/execute', async (req, res) => {
         return;
     }
 });
+/**
+ * GET /api/logs
+ * @summary Get logs
+ * @tags Logs
+ * @return {string[]} 200 - Array of logs
+ * @return {Error} 500 - Server error
+ */
+app.get('/api/logs', async (_req, res) => {
+    try {
+        const logs = await mastra.getLogs();
+        res.json(logs);
+    }
+    catch (error) {
+        const apiError = error;
+        console.error('Error getting logs', apiError);
+        res.status(apiError.status || 500).json({ error: apiError.message || 'Error getting logs' });
+        return;
+    }
+});
+/**
+ * GET /api/logs/{runId}
+ * @summary Get logs
+ * @tags Logs
+ * @return {string[]} 200 - Array of logs
+ * @return {Error} 500 - Server error
+ */
+app.get('/api/logs/:runId', async (req, res) => {
+    try {
+        const runId = req.params.runId;
+        const logs = await mastra.getLogsByRunId(runId);
+        res.json(logs);
+    }
+    catch (error) {
+        const apiError = error;
+        console.error('Error getting logs', apiError);
+        res.status(apiError.status || 500).json({ error: apiError.message || 'Error getting logs' });
+        return;
+    }
+});
+/**
+ * GET /api/tools
+ * @summary Get tools
+ * @tags Tools
+ * @return {object} 200 - Tools with schemas
+ * @return {Error} 404 - Tools not found
+ */
+app.get('/api/tools', async (_req, res) => {
+    if (tools) {
+        const serializedTools = Object.entries(tools).reduce((acc, [id, _tool]) => {
+            const tool = _tool;
+            acc[id] = {
+                ...tool,
+                inputSchema: tool.inputSchema ? stringify(zodToJsonSchema(tool.inputSchema)) : undefined,
+                outputSchema: tool.outputSchema ? stringify(zodToJsonSchema(tool.outputSchema)) : undefined,
+            };
+            return acc;
+        }, {});
+        res.json(serializedTools);
+    }
+    else {
+        res.status(200).json({});
+    }
+});
+/**
+ * GET /api/tools/{toolId}
+ * @summary Get tool
+ * @tags Tools
+ * @param {string} toolId.path.required - Tool identifier
+ * @return {object} 200 - Tool with schemas
+ * @return {Error} 404 - Tool not found
+ */
+app.get('/api/tools/:toolId', async (req, res) => {
+    const toolId = req.params.toolId;
+    const tool = Object.values(tools || {}).find((tool) => tool.id === toolId);
+    if (tool) {
+        const serializedTool = {
+            ...tool,
+            inputSchema: tool.inputSchema ? stringify(zodToJsonSchema(tool.inputSchema)) : undefined,
+            outputSchema: tool.outputSchema ? stringify(zodToJsonSchema(tool.outputSchema)) : undefined,
+        };
+        res.json(serializedTool);
+    }
+    else {
+        res.status(404).json({ error: 'Tool not found' });
+    }
+});
+/**
+ * POST /api/tools/{toolId}/execute
+ * @summary Execute a tool
+ * @tags Tools
+ * @param {string} toolId.path.required - Tool identifier
+ * @return {object} 200 - Tool execution result
+ * @return {Error} 404 - Tool not found
+ */
+app.post('/api/tools/:toolId/execute', async (req, res) => {
+    try {
+        const toolId = req.params.toolId;
+        const tool = Object.values(tools || {}).find((tool) => tool.id === toolId);
+        if (!tool) {
+            res.status(404).json({ error: 'Tool not found' });
+            return;
+        }
+        const { input } = req.body;
+        const result = await tool.execute({
+            context: {
+                ...input,
+            },
+            mastra,
+            runId: mastra.runId,
+        });
+        res.json(result);
+    }
+    catch (error) {
+        const apiError = error;
+        console.error('Error executing tool', apiError);
+        res.status(apiError.status || 500).json({ error: apiError.message || 'Error executing tool' });
+        return;
+    }
+});
+// serve static files for playground
+app.use('/assets', express.static(join(__dirname, 'playground/assets'), {
+    setHeaders: (res, path) => {
+        // Set correct MIME types
+        if (path.endsWith('.js')) {
+            res.set('Content-Type', 'application/javascript');
+        }
+        else if (path.endsWith('.css')) {
+            res.set('Content-Type', 'text/css');
+        }
+    },
+}));
+// Serve other static files
+app.use(express.static(join(__dirname, 'playground')));
+/**
+ * GET /playground
+ * @summary Serve playground
+ * @tags System
+ * @return  {html} 200 - Playground
+ */
+app.get('*', (_req, res) => {
+    res.sendFile(join(__dirname, 'playground/index.html'));
+});
 export const handler = serverless(app);
 app.listen(process.env.PORT || 4111, () => {
     console.log(`🦄Server running on port ${process.env.PORT || 4111}`);
     console.log(`📚 Open API documentation available at http://localhost:${process.env.PORT || 4111}/openapi.json`);
 });
+export default handler;