@mastra/agent-builder 0.0.0-experimental-agent-builder-20250815195917

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# @mastra/agent-builder
+
+## 0.0.0-experimental-agent-builder-20250815195917
+
+### Patch Changes
+
+- Updated dependencies [8e59433]
+- Updated dependencies [49281f5]
+- Updated dependencies [6faaee5]
+- Updated dependencies [4232b14]
+- Updated dependencies [6720c51]
+- Updated dependencies [2256977]
+- Updated dependencies [c597dc5]
+- Updated dependencies [a722c0b]
+- Updated dependencies [c30bca8]
+- Updated dependencies [7444737]
+- Updated dependencies [83d180b]
+- Updated dependencies [3b5fec7]
+  - @mastra/core@0.0.0-experimental-agent-builder-20250815195917
+  - @mastra/mcp@0.0.0-experimental-agent-builder-20250815195917
+  - @mastra/memory@0.0.0-experimental-agent-builder-20250815195917

package/LICENSE.md

@@ -0,0 +1,15 @@
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,109 @@
+# @mastra/agent-builder
+
+A specialized AI agent for building production-ready Mastra applications, agents, tools, and workflows from natural language requirements.
+
+## Installation
+
+```bash
+npm install @mastra/agent-builder
+```
+
+## Overview
+
+`@mastra/agent-builder` is a meta-agent that helps developers create Mastra applications by:
+
+- **Agent Generation**: Create specialized AI agents from natural language descriptions
+- **Tool Creation**: Generate custom tools with proper schemas and validation
+- **Workflow Building**: Design and implement complex multi-step workflows
+- **Project Management**: Handle dependencies, configuration, and project structure
+- **Code Validation**: Ensure generated code follows best practices and passes linting
+
+## Key Features
+
+- **Mastra Expert Knowledge**: Deep understanding of Mastra patterns and conventions
+- **Production-Ready Code**: Generates complete, working implementations
+- **Project Context Aware**: Understands existing codebase structure and integrates seamlessly
+- **Quality Assurance**: Built-in validation and testing capabilities
+- **MCP Integration**: Leverages Model Context Protocol for enhanced tooling
+
+## Quick Start
+
+```typescript
+import { AgentBuilder } from '@mastra/agent-builder';
+import { openai } from '@ai-sdk/openai';
+
+const builder = new AgentBuilder({
+  model: openai('gpt-4'),
+  summaryModel: openai('gpt-4'),
+  projectPath: '/path/to/your/project',
+});
+
+// Generate an agent from natural language
+const result = await builder.generateAgent(
+  'Create a weather agent that can get current weather and suggest activities',
+);
+```
+
+## Configuration
+
+The AgentBuilder requires a configuration object with:
+
+- `model`: The primary language model for code generation
+- `summaryModel`: A model for summarizing tool calls and results
+- `projectPath`: Path to your Mastra project
+- `instructions`: Optional additional instructions
+- `tools`: Optional additional tools to include
+
+## Advanced Usage
+
+### Custom Project Management
+
+```typescript
+// Install packages
+await builder.tools.manageProject({
+  action: 'install',
+  packages: [{ name: '@mastra/workflows', version: 'latest' }],
+});
+
+// Validate generated code
+await builder.tools.validateCode({
+  validationType: ['types', 'lint'],
+  files: ['src/agents/my-agent.ts'],
+});
+```
+
+### Server Management
+
+```typescript
+// Start development server
+await builder.tools.manageServer({
+  action: 'start',
+  port: 4200,
+});
+
+// Test API endpoints
+await builder.tools.httpRequest({
+  method: 'GET',
+  url: '/health',
+  baseUrl: 'http://localhost:4200',
+});
+```
+
+## Memory and Processing
+
+The AgentBuilder includes specialized memory processors:
+
+- **ToolSummaryProcessor**: Caches and summarizes tool call results
+- **WriteToDiskProcessor**: Saves conversation history for debugging
+- **TokenLimiter**: Manages context window size
+
+## Best Practices
+
+1. **Provide Clear Requirements**: The more specific your requirements, the better the generated code
+2. **Use Project Context**: Let the agent explore your existing codebase structure
+3. **Validate Output**: Always run the validation tools after code generation
+4. **Iterative Development**: Start with simple agents and add complexity incrementally
+
+## License
+
+Apache-2.0