@mastra/agent-builder 1.1.16-alpha.1 → 1.1.16-alpha.3

package/README.md

@@ -1,8 +1,6 @@
 # @mastra/agent-builder
 
-This package is currently experimental and only meant to be used internally to Mastra at the moment, the APIs are subject to change in this period.
-
-A specialized AI agent for building production-ready Mastra applications, agents, tools, and workflows from natural language requirements.
+`@mastra/agent-builder` is a specialized agent that turns natural-language requirements into Mastra applications, agents, tools, and workflows. This experimental package requires a Mastra Enterprise license for production use, and its APIs may change without notice.
 
 ## Installation
 
@@ -10,83 +8,38 @@ A specialized AI agent for building production-ready Mastra applications, agents
 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
+## Usage
 
-- **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
+Set a supported model and the path to a Mastra project.
 
 ```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',
+  model: 'openai/gpt-5.6-sol',
+  summaryModel: 'openai/gpt-5.6-sol',
+  projectPath: process.cwd(),
 });
 
-// Generate an agent from natural language
-const result = await builder.generate({ ... })
+const result = await builder.generate('Create a weather agent with a typed forecast tool.');
+console.log(result.text);
 ```
 
-## Configuration
-
-The AgentBuilder requires a configuration object with:
+## Documentation
 
-- `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
+`AgentBuilder` extends Mastra's `Agent` with defaults intended for code generation. It can inspect an existing project, summarize available tools, write generated files to disk, and keep long builder sessions within the model's token limits.
 
-## Advanced Usage
+The constructor accepts the primary `model`, an optional `summaryModel`, and the target `projectPath`. It configures memory and builder-oriented processors internally, then applies deterministic generation defaults for multi-step code changes.
 
-### Custom Project Management
-
-```typescript
-// Install packages
-const result = await builder.generate('Install @mastra/workflows package with latest version');
-
-// Validate generated code
-const validation = await builder.generate('Validate the TypeScript types and linting for src/agents/my-agent.ts');
-```
-
-### Server Management
-
-```typescript
-// Start development server
-const serverResult = await builder.generate('Start the development server on port 4200');
-
-// Test API endpoints
-const testResult = await builder.generate('Test the /health endpoint at http://localhost:4200');
-```
+This package is intended for the Mastra Agent Builder product rather than as a stable general-purpose public API. Production use of the Agent Builder experience is subject to the [Mastra Enterprise License](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
 
-## Memory and Processing
+- [Agent Builder documentation](https://agent-builder.mastra.ai/)
+- [`AgentBuilderOptions` reference](https://agent-builder.mastra.ai/reference/agent-builder-options)
 
-The AgentBuilder includes specialized memory processors:
+## Changelog
 
-- **ToolSummaryProcessor**: Caches and summarizes tool call results
-- **WriteToDiskProcessor**: Saves conversation history for debugging
-- **TokenLimiter**: Manages context window size
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/packages/agent-builder/CHANGELOG.md) for version history and release notes.
 
-## Best Practices
+## Support
 
-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
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/agent-builder",
-  "version": "1.1.16-alpha.1",
+  "version": "1.1.16-alpha.3",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -34,8 +34,8 @@
     "@ai-sdk/xai-v5": "npm:@ai-sdk/xai@2.0.82",
     "ignore": "^7.0.5",
     "semver": "^7.7.4",
-    "@mastra/memory": "1.28.2-alpha.1",
-    "@mastra/schema-compat": "1.3.8-alpha.0"
+    "@mastra/memory": "1.28.2-alpha.3",
+    "@mastra/schema-compat": "1.3.8-alpha.1"
   },
   "devDependencies": {
     "@types/node": "22.20.1",
@@ -52,7 +52,7 @@
     "@internal/ai-sdk-v5": "0.0.76",
     "@internal/lint": "0.0.129",
     "@internal/types-builder": "0.0.104",
-    "@mastra/core": "1.64.0-alpha.2"
+    "@mastra/core": "1.64.0-alpha.8"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.4.1-0 <2.0.0-0",