dexto 1.1.9 → 1.1.11

package/README.md

@@ -94,18 +94,20 @@ Dexto comes with pre-built agent recipes for common use cases. Install and use t
 dexto list-agents
 
 # Install specific agents
-dexto install nano-banana-agent podcast-agent
+dexto install nano-banana-agent podcast-agent sora-video-agent
 
 # Use an agent
 dexto --agent nano-banana-agent "create a futuristic cityscape with flying cars"
 dexto --agent podcast-agent "generate a podcast intro with two hosts discussing AI"
+dexto --agent sora-video-agent "create a video of a sunset over mountains"
 ```
 
 **Available Agents:**
 - **Nano Banana Agent** – Advanced image generation and editing using Google's Nano Banana (Gemini 2.5 Flash Image)
 - **Podcast Agent** – Advanced podcast generation using Google Gemini TTS for multi-speaker audio content
+- **Sora Video Agent** – AI video generation using OpenAI's Sora with custom settings, remixing, and reference support
 - **Database Agent** – Demo agent for SQL queries and database operations
-- **Image Editor Agent** – Image editing and manipulation  
+- **Image Editor Agent** – Image editing and manipulation
 - **Music Agent** – Music creation and audio processing
 - **PDF Agent** – Document analysis and conversation
 - **Product Researcher** – Product naming and branding research

package/dist/agents/agent-registry.json

@@ -2,6 +2,8 @@
   "version": "1.0.0",
   "agents": {
     "database-agent": {
+      "id": "database-agent",
+      "name": "Database Agent",
       "description": "AI agent for database operations and SQL queries",
       "author": "Truffle AI",
       "tags": ["database", "sql", "data", "queries"],
@@ -9,6 +11,8 @@
       "main": "database-agent.yml"
     },
     "github-agent": {
+      "id": "github-agent",
+      "name": "GitHub Agent",
       "description": "GitHub operations agent for analyzing pull requests, issues, repos and more",
       "author": "Truffle AI",
       "tags": ["github", "repositories", "collaboration", "devops", "mcp"],
@@ -16,6 +20,8 @@
       "main": "github-agent.yml"
     },
     "talk2pdf-agent": {
+      "id": "talk2pdf-agent",
+      "name": "Talk2PDF Agent",
       "description": "PDF document analysis and conversation",
       "author": "Truffle AI",
       "tags": ["pdf", "documents", "analysis", "conversation"],
@@ -23,6 +29,8 @@
       "main": "talk2pdf-agent.yml"
     },
     "image-editor-agent": {
+      "id": "image-editor-agent",
+      "name": "Image Editor Agent",
       "description": "AI agent for image editing and manipulation",
       "author": "Truffle AI",
       "tags": ["images", "editing", "graphics", "visual"],
@@ -30,6 +38,8 @@
       "main": "image-editor-agent.yml"
     },
     "music-agent": {
+      "id": "music-agent",
+      "name": "Music Agent",
       "description": "AI agent for music creation and audio processing",
       "author": "Truffle AI",
       "tags": ["music", "audio", "creation", "sound"],
@@ -37,6 +47,8 @@
       "main": "music-agent.yml"
     },
     "product-researcher": {
+      "id": "product-researcher",
+      "name": "Product Researcher",
       "description": "AI agent for product name research and branding",
       "author": "Truffle AI",
       "tags": ["product", "research", "branding", "naming"],
@@ -44,6 +56,8 @@
       "main": "product-name-researcher.yml"
     },
     "triage-agent": {
+      "id": "triage-agent",
+      "name": "Triage Agent",
       "description": "Customer support triage system",
       "author": "Truffle AI",
       "tags": ["support", "triage", "routing", "multi-agent"],
@@ -51,6 +65,8 @@
       "main": "triage-agent.yml"
     },
     "nano-banana-agent": {
+      "id": "nano-banana-agent",
+      "name": "Nano Banana Agent",
       "description": "AI agent for advanced image generation and editing using Google's Nano Banana (Gemini 2.5 Flash Image)",
       "author": "Truffle AI",
       "tags": ["images", "generation", "editing", "ai", "nano-banana", "gemini"],
@@ -58,15 +74,28 @@
       "main": "nano-banana-agent.yml"
     },
     "podcast-agent": {
+      "id": "podcast-agent",
+      "name": "Podcast Agent",
       "description": "Advanced podcast generation agent using Google Gemini TTS for multi-speaker audio content",
       "author": "Truffle AI",
       "tags": ["podcast", "audio", "tts", "speech", "multi-speaker", "gemini"],
       "source": "podcast-agent/",
       "main": "podcast-agent.yml"
     },
+    "sora-video-agent": {
+      "id": "sora-video-agent",
+      "name": "Sora Video Agent",
+      "description": "AI agent for video generation using OpenAI's Sora technology with comprehensive video creation and management capabilities",
+      "author": "Truffle AI",
+      "tags": ["video", "generation", "sora", "openai", "ai", "media", "creation"],
+      "source": "sora-video-agent/",
+      "main": "sora-video-agent.yml"
+    },
     "default-agent": {
+      "id": "default-agent",
+      "name": "Default",
       "description": "Default Dexto agent with filesystem and playwright tools",
-      "author": "Truffle AI", 
+      "author": "Truffle AI",
       "tags": ["default", "filesystem", "playwright"],
       "source": "default-agent.yml"
     }

package/dist/agents/database-agent/database-agent.yml

@@ -26,6 +26,9 @@ mcpServers:
     timeout: 30000
     connectionMode: lenient
 
+# Optional greeting shown at chat start (UI can consume this)
+greeting: "🗄️ Hi! I'm your Database Agent. What would you like to explore?"
+
 # System prompt that defines the agent's database interaction capabilities
 systemPrompt:
   contributors:

package/dist/agents/default-agent.yml

@@ -14,13 +14,6 @@ mcpServers:
       - -y
       - "@playwright/mcp@latest"
 
-  # hf:
-  #   type: stdio
-  #   command: npx
-  #   args:
-  #     - -y
-  #     - "@llmindset/mcp-hfspace"
-
 # System prompt configuration - defines the agent's behavior and instructions
 systemPrompt:
   contributors:
@@ -37,28 +30,125 @@ systemPrompt:
       priority: 10
       source: dateTime
       enabled: true
+    - id: memories
+      type: memory
+      priority: 40
+      enabled: true
+      options:
+        includeTimestamps: false
+        includeTags: true
+        limit: 10
+        pinnedOnly: false
 
 # Optional greeting shown at chat start (UI can consume this)
 greeting: "Hi! I’m Dexto — how can I help today?"
 
-# # describes the llm configuration
+# LLM configuration - describes the language model to use
 llm:
   provider: openai
   model: gpt-5-mini
   apiKey: $OPENAI_API_KEY
 
-# Storage configuration - uses a two-tier architecture: cache (fast, ephemeral) and database (persistent, reliable)
-# Memory cache with file-based database (good for development with persistence)
 storage:
   cache:
     type: in-memory
   database:
     type: sqlite
-    # path: ./data/dexto.db
+    # path: ./data/dexto.db  # Optional: customize database location
+  blob:
+    type: local  # 'local', 's3', 'gcs', 'azure' (s3, gcs, azure coming in future Phases)
+    maxBlobSize: 52428800     # 50MB per blob
+    maxTotalSize: 1073741824  # 1GB total storage
+    cleanupAfterDays: 30      # Auto-cleanup blobs older than 30 days
+    # storePath: ~/.dexto/blobs (defaults to context-aware path for local backend)
+
+toolConfirmation:
+  mode: event-based
+  timeout: 120000          # Time to wait for approval (ms)
+  allowedToolsStorage: memory  # 'memory' or 'storage' for persisting allowed tools
+
+# Internal tools - built-in Dexto capabilities
+internalTools:
+  - ask_user  # Allows the agent to ask you questions and collect structured input
+
+# Internal resources configuration - manages file system access and blob storage
+# NOTE: Blob storage capacity and backend settings are in the 'storage.blob' section above
+internalResources:
+  enabled: true
+  resources:
+    # Filesystem resource - provides read access to local files for the agent
+    - type: filesystem
+      paths: ["."]                 # Directories to expose
+      maxFiles: 50               # Maximum number of files to index
+      maxDepth: 3                # Maximum directory depth to traverse
+      includeHidden: false         # Include hidden files/directories
+      includeExtensions: [".txt", ".md", ".json", ".yaml", ".yml", ".js", ".ts", ".py", ".html", ".css"]
+
+    # Blob resource - enables large file upload/storage (settings in storage.blob section above)
+    - type: blob
+
+# Plugin system - built-in plugins for content policy and response sanitization
+# plugins:
+#   # ContentPolicy - validates and sanitizes input before sending to LLM
+#   contentPolicy:
+#     priority: 10              # Lower priority = runs first
+#     blocking: true            # Blocks execution if validation fails
+#     maxInputChars: 50000      # Maximum input length (characters)
+#     redactEmails: true        # Redact email addresses from input
+#     redactApiKeys: true       # Redact potential API keys from input
+#     enabled: true             # Enable this plugin
+
+#   # ResponseSanitizer - sanitizes LLM responses before returning to user
+#   responseSanitizer:
+#     priority: 900             # Higher priority = runs near the end
+#     blocking: false           # Non-blocking (logs warnings but doesn't stop)
+#     redactEmails: true        # Redact email addresses from responses
+#     redactApiKeys: true       # Redact potential API keys from responses
+#     maxResponseLength: 100000 # Maximum response length (characters)
+#     enabled: true             # Enable this plugin
+
+#   # Custom plugins can be added here (see documentation)
+#   # custom:
+#   #   - name: tenant-auth
+#   #     module: "${{dexto.agent_dir}}/plugins/tenant-auth.ts"
+#   #     enabled: true
+#   #     blocking: true
+#   #     priority: 100
+#   #     config:
+#   #       enforceQuota: true
+
+# Starter prompts - predefined prompts that appear as clickable buttons in the WebUI
+# TODO: (355) Have to update docs for this starterPrompts and internalResources section and blob section
+# https://github.com/truffle-ai/dexto/pull/355#discussion_r2412886278
+starterPrompts:
+  - id: quick-start
+    title: "📚 Quick Start Guide"
+    description: "Learn the basics and see what you can do"
+    prompt: "I'd like to get started quickly. Can you show me a few examples of what you can do and help me understand how to work with you?"
+    category: learning
+    priority: 9
+  - id: tool-demo
+    title: "⚡ Tool Demonstration"
+    description: "See the tools in action with practical examples"
+    prompt: "I'd like to see your tools in action. Can you pick one of your most interesting tools and demonstrate it with a practical example? Show me what it can do and how it works."
+    category: tools
+    priority: 5
+  - id: snake-game
+    title: "🐍 Create Snake Game"
+    description: "Build a fun interactive game with HTML, CSS, and JavaScript"
+    prompt: "Create a snake game in a new directory with HTML, CSS, and JavaScript, then open it in the browser for me to play."
+    category: coding
+    priority: 4
+  - id: connect-tools
+    title: "🔧 Connect New Tools"
+    description: "Browse and add MCP servers to extend capabilities"
+    prompt: "I want to connect new tools to expand my capabilities. Can you help me understand what MCP servers are available and how to add them?"
+    category: tools
+    priority: 3
 
 ## To use Google Gemini, replace the LLM section with Google Gemini configuration below
 ## Similar for anthropic/groq/etc.
 # llm:
 #   provider: google
-#   model: gemini-2.0-flash
+#   model: gemini-2.5-pro
 #   apiKey: $GOOGLE_GENERATIVE_AI_API_KEY

package/dist/agents/github-agent/github-agent.yml

@@ -17,6 +17,9 @@ mcpServers:
     # env:
     #   GITHUB_OAUTH_SCOPES: 'repo read:user'
 
+# Optional greeting shown at chat start (UI can consume this)
+greeting: "🐙 Hello! I'm your GitHub Agent. How can I help with your repositories?"
+
 systemPrompt:
   contributors:
     - id: primary

package/dist/agents/image-editor-agent/image-editor-agent.yml

@@ -1,6 +1,9 @@
 # Dexto Agent Configuration for Python Image Editor MCP Server
 # Generated on 2025-07-18T19:30:00.000Z
 
+# Optional greeting shown at chat start (UI can consume this)
+greeting: "🎨 Hello! I'm your Image Editor. What image shall we create or edit today?"
+
 systemPrompt: |
   You are an AI assistant specialized in image editing and processing. You have access to a comprehensive set of tools for manipulating images including:
   

package/dist/agents/music-agent/music-agent.yml

@@ -1,5 +1,8 @@
 # Dexto Agent Configuration for Music Creation and Editing MCP Server
 
+# Optional greeting shown at chat start (UI can consume this)
+greeting: "🎵 Hi! I'm your Music Agent. Let's make some beautiful sounds together!"
+
 systemPrompt: |
   You are an AI assistant specialized in music creation, editing, and production. You have access to a comprehensive set of tools for working with audio and music including:
   

package/dist/agents/nano-banana-agent/nano-banana-agent.yml

@@ -1,6 +1,9 @@
 # Dexto Agent Configuration for Nano Banana (Gemini 2.5 Flash Image) MCP Server
 # Generated on 2025-01-27T00:00:00.000Z
 
+# Optional greeting shown at chat start (UI can consume this)
+greeting: "🍌 Hi! I'm your Nano Banana Agent. Let's create something amazing together!"
+
 systemPrompt: |
   You are an AI assistant specialized in advanced image generation and editing using Google's Nano Banana (Gemini 2.5 Flash Image) model. You have access to cutting-edge AI tools for:
 

package/dist/agents/podcast-agent/podcast-agent.yml

@@ -21,6 +21,9 @@ mcpServers:
       - "@modelcontextprotocol/server-filesystem"
       - .
 
+# Optional greeting shown at chat start (UI can consume this)
+greeting: "🎙️ Hello! I'm your Podcast Agent. Let's create some amazing audio together!"
+
 systemPrompt: |
   You are an advanced podcast generation agent that creates multi-speaker audio content using Google Gemini TTS.
 

package/dist/agents/product-name-researcher/product-name-researcher.yml

@@ -24,6 +24,9 @@ mcpServers:
     args:
       - "@truffle-ai/product-name-scout-mcp"
 
+# Optional greeting shown at chat start (UI can consume this)
+greeting: "🔍 Hi! I'm your Product Name Researcher. What name shall we explore today?"
+
 systemPrompt:
   contributors:
     - id: primary

package/dist/agents/talk2pdf-agent/talk2pdf-agent.yml

@@ -10,6 +10,9 @@ mcpServers:
     timeout: 30000
     connectionMode: strict 
 
+# Optional greeting shown at chat start (UI can consume this)
+greeting: "📄 Hi! I'm your PDF Agent. Share a document and let's explore it together!"
+
 systemPrompt:
   contributors:
     - id: primary

package/dist/agents/triage-demo/triage-agent.yml

@@ -1,6 +1,9 @@
 # Customer Support Triage Agent Configuration
 # Main coordination agent that routes requests to specialized support agents
 
+# Optional greeting shown at chat start (UI can consume this)
+greeting: "🎯 Hello! I'm your Support Triage Agent. How can I help you today?"
+
 systemPrompt:
   contributors:
     - id: base-prompt

package/dist/api/mcp/tool-aggregation-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-aggregation-handler.d.ts","sourceRoot":"","sources":["../../../src/api/mcp/tool-aggregation-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAsB,KAAK,sBAAsB,EAAwB,MAAM,aAAa,CAAC;AAEpG;;;GAGG;AACH,wBAAsB,kCAAkC,CACpD,aAAa,EAAE,sBAAsB,EACrC,YAAY,EAAE,SAAS,EACvB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GACjB,OAAO,CAAC,SAAS,CAAC,CAmHpB"}
+{"version":3,"file":"tool-aggregation-handler.d.ts","sourceRoot":"","sources":["../../../src/api/mcp/tool-aggregation-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAsB,KAAK,sBAAsB,EAAwB,MAAM,aAAa,CAAC;AAGpG;;;GAGG;AACH,wBAAsB,kCAAkC,CACpD,aAAa,EAAE,sBAAsB,EACrC,YAAY,EAAE,SAAS,EACvB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,OAAO,GACjB,OAAO,CAAC,SAAS,CAAC,CAgGpB"}

package/dist/api/mcp/tool-aggregation-handler.js

@@ -1,5 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { MCPManager, logger, jsonSchemaToZodShape } from '@dexto/core';
+import { z } from 'zod';
 /**
  * Initializes MCP server for tool aggregation mode.
  * Instead of exposing an AI agent, this directly exposes all tools from connected MCP servers.
@@ -18,54 +19,42 @@ export async function initializeMcpToolAggregationServer(serverConfigs, mcpTrans
             prompts: {},
         },
     });
-    // Get all tools from connected servers and register them
-    // TODO: Temporary hacky solution to get the tools from the connected servers, directly using the MCP Client to preserve types
-    // TODO: We should use the MCPManager or MCPClient instead of directly interacting with the raw client to get the tools, but we lose type information and it becomes any type which is hard to work with
-    const mcpClientsMap = mcpManager.getClients();
+    const toolDefinitions = await mcpManager.getAllTools();
     let toolCount = 0;
-    for (const [clientName, client] of mcpClientsMap.entries()) {
-        // Get the actual MCP Client
-        const connectedClient = await client.getConnectedClient();
-        // Get the tools from the MCP client
-        const mcpTools = await connectedClient.listTools({});
-        logger.debug(`MCP client name: ${clientName}`);
-        logger.debug(`MCP client tools: ${JSON.stringify(mcpTools, null, 2)}`);
-        // TODO: Handle tool name/server name/prompt name collisions properly
-        for (const tool of mcpTools.tools) {
-            toolCount++;
-            logger.debug(`Registering tool: ${tool.name}`);
-            // Convert JSON Schema to Zod raw shape
-            const zodShape = jsonSchemaToZodShape(tool.inputSchema);
-            // Log the tool schema to debug the issue (safely handle Zod schema circular references)
-            logger.debug(`Tool ${tool.name} original inputSchema: ${JSON.stringify(tool.inputSchema, null, 2)}`);
-            mcpServer.tool(tool.name, tool.description || `Tool: ${tool.name}`, zodShape, async (args) => {
-                logger.info(`Tool aggregation: executing ${tool.name} with args: ${JSON.stringify(args)}`);
-                try {
-                    const result = await mcpManager.executeTool(tool.name, args);
-                    logger.info(`Tool aggregation: ${tool.name} completed successfully`);
-                    return result;
-                }
-                catch (error) {
-                    logger.error(`Tool aggregation: ${tool.name} failed: ${error}`);
-                    throw error;
-                }
-            });
-        }
+    for (const [toolName, toolDef] of Object.entries(toolDefinitions)) {
+        toolCount++;
+        const jsonSchema = toolDef.parameters ?? { type: 'object', properties: {} };
+        const paramsShape = jsonSchemaToZodShape(jsonSchema);
+        const _paramsSchema = z.object(paramsShape);
+        logger.debug(`Registering tool '${toolName}' with schema: ${JSON.stringify(jsonSchema)}`);
+        mcpServer.tool(toolName, toolDef.description || `Tool: ${toolName}`, paramsShape, async (args) => {
+            logger.info(`Tool aggregation: executing ${toolName}`);
+            try {
+                const result = await mcpManager.executeTool(toolName, args);
+                logger.info(`Tool aggregation: ${toolName} completed successfully`);
+                return result;
+            }
+            catch (error) {
+                logger.error(`Tool aggregation: ${toolName} failed: ${error}`);
+                throw error;
+            }
+        });
     }
     logger.info(`Registered ${toolCount} tools from connected MCP servers`);
     // Register resources if available
     try {
         const allResources = await mcpManager.listAllResources();
         logger.info(`Registering ${allResources.length} resources from connected MCP servers`);
-        // TODO: Properly handle resource name collisions by prefixing with client name
-        let resourceIndex = 0;
-        for (const resourceUri of allResources) {
-            mcpServer.resource(`resource_${resourceIndex}_${resourceUri.replace(/[^a-zA-Z0-9]/g, '_')}`, resourceUri, async (uri) => {
-                logger.info(`Resource aggregation: reading ${uri.href}`);
-                return await mcpManager.readResource(uri.href);
+        // Collision handling verified:
+        // - Tools/Prompts: Names come from mcpManager which handles collisions at source
+        // - Resources: Index prefix ensures uniqueness even if multiple clients have same key
+        allResources.forEach((resource, index) => {
+            const safeId = resource.key.replace(/[^a-zA-Z0-9]/g, '_');
+            mcpServer.resource(`resource_${index}_${safeId}`, resource.key, async () => {
+                logger.info(`Resource aggregation: reading ${resource.key}`);
+                return await mcpManager.readResource(resource.key);
             });
-            resourceIndex++;
-        }
+        });
     }
     catch (error) {
         logger.debug(`Skipping resource aggregation: ${error}`);
@@ -76,8 +65,11 @@ export async function initializeMcpToolAggregationServer(serverConfigs, mcpTrans
         logger.info(`Registering ${allPrompts.length} prompts from connected MCP servers`);
         for (const promptName of allPrompts) {
             mcpServer.prompt(promptName, `Prompt: ${promptName}`, async (extra) => {
-                logger.info(`Prompt aggregation: getting ${promptName} with args: ${JSON.stringify(extra)}`);
-                return await mcpManager.getPrompt(promptName, {});
+                logger.info(`Prompt aggregation: resolving ${promptName}`);
+                const promptArgs = extra && 'arguments' in extra
+                    ? extra.arguments
+                    : undefined;
+                return await mcpManager.getPrompt(promptName, promptArgs);
             });
         }
     }

package/dist/api/memory/memory-handler.d.ts

@@ -0,0 +1,15 @@
+import { Router } from 'express';
+import type { DextoAgent } from '@dexto/core';
+/**
+ * Setup memory API routes
+ * Provides CRUD operations for user memories
+ *
+ * Routes:
+ * - POST /api/memory - Create a new memory
+ * - GET /api/memory - List all memories (with optional filters)
+ * - GET /api/memory/:id - Get a specific memory
+ * - PUT /api/memory/:id - Update a memory
+ * - DELETE /api/memory/:id - Delete a memory
+ */
+export declare function setupMemoryRoutes(agent: DextoAgent): Router;
+//# sourceMappingURL=memory-handler.d.ts.map

package/dist/api/memory/memory-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-handler.d.ts","sourceRoot":"","sources":["../../../src/api/memory/memory-handler.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,MAAM,EAAkD,MAAM,SAAS,CAAC;AAE1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA8B9C;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAqF3D"}

package/dist/api/memory/memory-handler.js

@@ -0,0 +1,129 @@
+import express, { Router } from 'express';
+import { z } from 'zod';
+import { CreateMemoryInputSchema, UpdateMemoryInputSchema } from '@dexto/core';
+// Schema for memory ID parameter
+const MemoryIdParamsSchema = z.object({
+    id: z.string().min(1, 'Memory ID is required'),
+});
+// Schema for list query parameters (from query string)
+const ListMemoriesQuerySchema = z.object({
+    tags: z
+        .string()
+        .optional()
+        .transform((val) => (val ? val.split(',').map((t) => t.trim()) : undefined)),
+    source: z.enum(['user', 'system']).optional(),
+    pinned: z
+        .string()
+        .optional()
+        .transform((val) => (val === 'true' ? true : val === 'false' ? false : undefined)),
+    limit: z
+        .string()
+        .optional()
+        .transform((val) => (val ? parseInt(val, 10) : undefined)),
+    offset: z
+        .string()
+        .optional()
+        .transform((val) => (val ? parseInt(val, 10) : undefined)),
+});
+/**
+ * Setup memory API routes
+ * Provides CRUD operations for user memories
+ *
+ * Routes:
+ * - POST /api/memory - Create a new memory
+ * - GET /api/memory - List all memories (with optional filters)
+ * - GET /api/memory/:id - Get a specific memory
+ * - PUT /api/memory/:id - Update a memory
+ * - DELETE /api/memory/:id - Delete a memory
+ */
+export function setupMemoryRoutes(agent) {
+    const router = Router();
+    // Create a new memory
+    router.post('/', express.json(), async (req, res, next) => {
+        try {
+            const input = CreateMemoryInputSchema.parse(req.body);
+            const memory = await agent.memoryManager.create(input);
+            return res.status(201).json({ ok: true, memory });
+        }
+        catch (error) {
+            return next(error);
+        }
+    });
+    // List all memories with optional filtering
+    router.get('/', async (req, res, next) => {
+        try {
+            const queryOptions = ListMemoriesQuerySchema.parse(req.query);
+            // Build options object, removing undefined values
+            const options = {};
+            if (queryOptions.tags !== undefined)
+                options.tags = queryOptions.tags;
+            if (queryOptions.source !== undefined)
+                options.source = queryOptions.source;
+            if (queryOptions.pinned !== undefined)
+                options.pinned = queryOptions.pinned;
+            if (queryOptions.limit !== undefined)
+                options.limit = queryOptions.limit;
+            if (queryOptions.offset !== undefined)
+                options.offset = queryOptions.offset;
+            const memories = await agent.memoryManager.list(options);
+            return res.status(200).json({ ok: true, memories, count: memories.length });
+        }
+        catch (error) {
+            return next(error);
+        }
+    });
+    // Get memory count (with optional filtering)
+    // NOTE: Must be declared before /:id route to avoid route shadowing
+    router.get('/count', async (req, res, next) => {
+        try {
+            const queryOptions = ListMemoriesQuerySchema.parse(req.query);
+            const options = {};
+            if (queryOptions.tags !== undefined)
+                options.tags = queryOptions.tags;
+            if (queryOptions.source !== undefined)
+                options.source = queryOptions.source;
+            if (queryOptions.pinned !== undefined)
+                options.pinned = queryOptions.pinned;
+            const count = await agent.memoryManager.count(options);
+            return res.status(200).json({ ok: true, count });
+        }
+        catch (error) {
+            return next(error);
+        }
+    });
+    // Get a specific memory by ID
+    router.get('/:id', async (req, res, next) => {
+        try {
+            const { id } = MemoryIdParamsSchema.parse(req.params);
+            const memory = await agent.memoryManager.get(id);
+            return res.status(200).json({ ok: true, memory });
+        }
+        catch (error) {
+            return next(error);
+        }
+    });
+    // Update a memory
+    router.put('/:id', express.json(), async (req, res, next) => {
+        try {
+            const { id } = MemoryIdParamsSchema.parse(req.params);
+            const updates = UpdateMemoryInputSchema.parse(req.body);
+            const memory = await agent.memoryManager.update(id, updates);
+            return res.status(200).json({ ok: true, memory });
+        }
+        catch (error) {
+            return next(error);
+        }
+    });
+    // Delete a memory
+    router.delete('/:id', async (req, res, next) => {
+        try {
+            const { id } = MemoryIdParamsSchema.parse(req.params);
+            await agent.memoryManager.delete(id);
+            return res.status(200).json({ ok: true, message: 'Memory deleted successfully' });
+        }
+        catch (error) {
+            return next(error);
+        }
+    });
+    return router;
+}

package/dist/api/server.d.ts

@@ -5,14 +5,14 @@ import { WebSocketEventSubscriber } from './websocket-subscriber.js';
 import { WebhookEventSubscriber } from './webhook-subscriber.js';
 import { type AgentCard } from '@dexto/core';
 import { DextoAgent } from '@dexto/core';
-export declare function initializeApi(agent: DextoAgent, agentCardOverride?: Partial<AgentCard>, listenPort?: number, agentName?: string): Promise<{
+export declare function initializeApi(agent: DextoAgent, agentCardOverride?: Partial<AgentCard>, listenPort?: number, agentId?: string): Promise<{
     app: Express;
     server: http.Server;
     wss: WebSocketServer;
     webSubscriber: WebSocketEventSubscriber;
     webhookSubscriber: WebhookEventSubscriber;
 }>;
-export declare function startApiServer(agent: DextoAgent, port?: number, agentCardOverride?: Partial<AgentCard>, agentName?: string): Promise<{
+export declare function startApiServer(agent: DextoAgent, port?: number, agentCardOverride?: Partial<AgentCard>, agentId?: string): Promise<{
     server: http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
     wss: WebSocketServer;
     webSubscriber: WebSocketEventSubscriber;

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/api/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAErC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ1E,OAAO,EAAmB,UAAU,EAAE,MAAM,aAAa,CAAC;AAqH1D,wBAAsB,aAAa,CAC/B,KAAK,EAAE,UAAU,EACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;IACP,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,GAAG,EAAE,eAAe,CAAC;IACrB,aAAa,EAAE,wBAAwB,CAAC;IACxC,iBAAiB,EAAE,sBAAsB,CAAC;CAC7C,CAAC,CAiwCD;AAED,wBAAsB,cAAc,CAChC,KAAK,EAAE,UAAU,EACjB,IAAI,SAAO,EACX,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,SAAS,CAAC,EAAE,MAAM;;;;;GA6BrB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/api/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,SAAS,CAAC;AACjD,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAErC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAkD,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAS7F,OAAO,EAA0B,UAAU,EAAY,MAAM,aAAa,CAAC;AA8D3E,wBAAsB,aAAa,CAC/B,KAAK,EAAE,UAAU,EACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IACP,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,GAAG,EAAE,eAAe,CAAC;IACrB,aAAa,EAAE,wBAAwB,CAAC;IACxC,iBAAiB,EAAE,sBAAsB,CAAC;CAC7C,CAAC,CA2nED;AAED,wBAAsB,cAAc,CAChC,KAAK,EAAE,UAAU,EACjB,IAAI,SAAO,EACX,iBAAiB,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,EACtC,OAAO,CAAC,EAAE,MAAM;;;;;GA6BnB"}