feat: integrate Mastra AI framework with Siren agent toolkit (#22)

* feat: integrate Mastra AI framework with Siren agent toolkit

* chore: remove debug console log in message sending flow

* feat: move @mastra/core to optional peer dependency and add mastra export path

Author: kirankv21

typescript/README.md

@@ -42,6 +42,7 @@ Refer to our [examples directory](./examples) for detailed integration guides:
 | **OpenAI** | [View Example](./examples/openai/) | Complete OpenAI Assistant integration |
 | **LangChain** | [View Example](./examples/langchain/) | Agent with LangChain tools |
 | **Vercel AI SDK** | [View Example](./examples/ai-sdk/) | Next.js and Vercel AI SDK integration |
+| **Mastra** | [View Example](./examples/mastra/) | Mastra integration |
 
 ## 📋 Requirements
 

typescript/examples/mastra/.env.template

@@ -0,0 +1,2 @@
+OPENAI_API_KEY=your_openai_api_key_here
+SIREN_API_KEY=your_siren_api_key_here

typescript/examples/mastra/README.md

@@ -0,0 +1,18 @@
+# Mastra integration with siren-agent-toolkit
+    
+This example shows how to use the siren-agent-toolkit with [Mastra](https://mastra.ai/).
+
+## Setup
+
+Copy the given `.env.template` and fill in the values.
+
+```
+cp .env.template .env
+```
+
+## Usage
+
+```
+npm install
+npm start
+```

typescript/examples/mastra/index.ts

@@ -0,0 +1,61 @@
+import { openai } from '@ai-sdk/openai';
+import { Agent } from '@mastra/core/agent'
+import { SirenAgentToolkit } from '@trysiren/agent-toolkit/mastra';
+import 'dotenv/config';
+
+const sirenToolkit = new SirenAgentToolkit({
+  apiKey: process.env.SIREN_API_KEY!,
+  configuration: {
+    actions: {
+      messaging: {
+        create: true,
+        read: true,
+      },
+      templates: {
+        read: true,
+        create: true,
+        update: true,
+        delete: true,
+      },
+      users: {
+        create: true,
+        update: true,
+        delete: true,
+        read: true,
+      },
+      workflows: {
+        trigger: true,
+        schedule: true,
+      },
+    },
+  },
+});
+
+async function main() {
+
+  const sirenAgent = new Agent({
+    name: 'Siren Agent',
+    instructions: 'You are a helpful assistant that can send notifications and manage templates using Siren.',
+    model: openai('gpt-4o'),
+    tools: {
+      ...sirenToolkit.getTools(),
+    }
+  })
+
+  const result = await sirenAgent.generate([
+    {
+      role: 'system',
+      content: 'You are a helpful assistant that can send notifications and manage templates using Siren',
+    },
+    {
+      role: 'user',
+      content: 'Send a welcome message to user@example.com via EMAIL saying "Welcome to our platform!". ',
+    },
+  ], { maxRetries: 0 });
+
+  console.log('Result:', result.text);
+  console.log('Tool calls:', result.toolCalls);
+  console.log('Tool results:', result.toolResults);
+}
+
+main().catch(console.error);

typescript/examples/mastra/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "siren-mastra-example",
+  "version": "1.0.0",
+  "description": "Siren Agent Toolkit Mastra example",
+  "type": "module",
+  "scripts": {
+    "start": "tsx index.ts",
+    "dev": "tsx --watch index.ts"
+  },
+  "dependencies": {
+    "@mastra/core": "^0.10.15",
+    "@trysiren/agent-toolkit": "^0.1.4",
+    "dotenv": "^16.4.5",
+    "ai": "^4.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}