@mastra/agent-builder 0.0.0-consolidate-changesets-20250904042643

package/CHANGELOG.md

@@ -0,0 +1,137 @@
+# @mastra/agent-builder
+
+## 0.0.0-consolidate-changesets-20250904042643
+
+### Patch Changes
+
+- de3cbc6: Update the `package.json` file to include additional fields like `repository`, `homepage` or `files`.
+- a32248b: dependencies updates:
+  - Updated dependency [`zod@^3.25.76` ↗︎](https://www.npmjs.com/package/zod/v/3.25.76) (from `^3.25.67`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`zod-to-json-schema@^3.24.6` ↗︎](https://www.npmjs.com/package/zod-to-json-schema/v/3.24.6) (from `^3.24.5`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`rollup@~4.49.0` ↗︎](https://www.npmjs.com/package/rollup/v/4.49.0) (from `~4.47.1`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`rollup@~4.50.0` ↗︎](https://www.npmjs.com/package/rollup/v/4.50.0) (from `~4.49.0`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`redis@^5.8.2` ↗︎](https://www.npmjs.com/package/redis/v/5.8.2) (from `^5.8.0`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`@libsql/client@^0.15.14` ↗︎](https://www.npmjs.com/package/@libsql/client/v/0.15.14) (from `^0.15.12`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`zod@^3.25.76` ↗︎](https://www.npmjs.com/package/zod/v/3.25.76) (from `^3.25.67`, in `dependencies`)
+  - Updated dependency [`zod-to-json-schema@^3.24.6` ↗︎](https://www.npmjs.com/package/zod-to-json-schema/v/3.24.6) (from `^3.24.5`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`zod@^4.1.5` ↗︎](https://www.npmjs.com/package/zod/v/4.1.5) (from `^4.0.15`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`@assistant-ui/react@^0.10.44` ↗︎](https://www.npmjs.com/package/@assistant-ui/react/v/0.10.44) (from `^0.7.91`, in `dependencies`)
+  - Updated dependency [`@assistant-ui/react-markdown@^0.10.9` ↗︎](https://www.npmjs.com/package/@assistant-ui/react-markdown/v/0.10.9) (from `^0.7.21`, in `dependencies`)
+  - Updated dependency [`@assistant-ui/react-syntax-highlighter@^0.10.10` ↗︎](https://www.npmjs.com/package/@assistant-ui/react-syntax-highlighter/v/0.10.10) (from `^0.7.10`, in `dependencies`)
+  - Added dependency [`@assistant-ui/react-ui@^0.1.8` ↗︎](https://www.npmjs.com/package/@assistant-ui/react-ui/v/0.1.8) (to `dependencies`)
+    dependencies updates:
+  - Updated dependency [`@xyflow/react@^12.8.4` ↗︎](https://www.npmjs.com/package/@xyflow/react/v/12.8.4) (from `^12.8.2`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`@assistant-ui/react@^0.10.45` ↗︎](https://www.npmjs.com/package/@assistant-ui/react/v/0.10.45) (from `^0.10.44`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`@qdrant/js-client-rest@^1.15.1` ↗︎](https://www.npmjs.com/package/@qdrant/js-client-rest/v/1.15.1) (from `^1.15.0`, in `dependencies`)
+    dependencies updates:
+  - Updated dependency [`zod@^3.25.76` ↗︎](https://www.npmjs.com/package/zod/v/3.25.76) (from `^3.25.67`, in `dependencies`)
+  - Updated dependency [`zod-to-json-schema@^3.24.6` ↗︎](https://www.npmjs.com/package/zod-to-json-schema/v/3.24.6) (from `^3.23.5`, in `dependencies`)
+- b8e1a83: Fix package.json
+- 671a392: Fix core imports inside agent-builder
+- 48b9e55: Add Agent Builder package with template installation workflow
+
+  Introduces a new package for programmatically building and managing Mastra agents with intelligent template merging capabilities. Features include automated dependency resolution, file conflict handling, and validation fixes.
+
+- Updated dependencies [85ef90b]
+- Updated dependencies [aedbbfa]
+- Updated dependencies [ff89505]
+- Updated dependencies [637f323]
+- Updated dependencies [de3cbc6]
+- Updated dependencies [c19bcf7]
+- Updated dependencies [a5632dd]
+- Updated dependencies [4474d04]
+- Updated dependencies [183dc95]
+- Updated dependencies [f5e7282]
+- Updated dependencies [a32248b]
+- Updated dependencies [a1111e2]
+- Updated dependencies [b42a961]
+- Updated dependencies [61debef]
+- Updated dependencies [9beaeff]
+- Updated dependencies [00c74e7]
+- Updated dependencies [f0dfcac]
+- Updated dependencies [fef7375]
+- Updated dependencies [e3d8fea]
+- Updated dependencies [45e4d39]
+- Updated dependencies [9eee594]
+- Updated dependencies [822c2e8]
+- Updated dependencies [979912c]
+- Updated dependencies [4106a58]
+- Updated dependencies [ad78bfc]
+- Updated dependencies [0302f50]
+- Updated dependencies [74db265]
+- Updated dependencies [8387952]
+- Updated dependencies [7f3b8da]
+- Updated dependencies [905352b]
+- Updated dependencies [599d04c]
+- Updated dependencies [56041d0]
+- Updated dependencies [5eca5d2]
+- Updated dependencies [f2cda47]
+- Updated dependencies [5de1555]
+- Updated dependencies [cfd377a]
+- Updated dependencies [1ed5a3e]
+  - @mastra/core@0.0.0-consolidate-changesets-20250904042643
+  - @mastra/memory@0.0.0-consolidate-changesets-20250904042643
+
+## 0.0.1-alpha.5
+
+### Patch Changes
+
+- Updated dependencies [[`f0dfcac`](https://github.com/mastra-ai/mastra/commit/f0dfcac4458bdf789b975e2d63e984f5d1e7c4d3), [`7149d8d`](https://github.com/mastra-ai/mastra/commit/7149d8d4bdc1edf0008e0ca9b7925eb0b8b60dbe)]:
+  - @mastra/memory@0.14.3-alpha.4
+  - @mastra/core@0.15.3-alpha.7
+
+## 0.0.1-alpha.4
+
+### Patch Changes
+
+- [#7363](https://github.com/mastra-ai/mastra/pull/7363) [`671a392`](https://github.com/mastra-ai/mastra/commit/671a39248d90f7723d3fae93818e8077f7504ec3) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix core imports inside agent-builder
+
+- Updated dependencies [[`c19bcf7`](https://github.com/mastra-ai/mastra/commit/c19bcf7b43542b02157b5e17303e519933a153ab), [`a5632dd`](https://github.com/mastra-ai/mastra/commit/a5632dd316a6246666662705404bda570b070af1), [`b42a961`](https://github.com/mastra-ai/mastra/commit/b42a961a5aefd19d6e938a7705fc0ecc90e8f756), [`45e4d39`](https://github.com/mastra-ai/mastra/commit/45e4d391a2a09fc70c48e4d60f505586ada1ba0e), [`0302f50`](https://github.com/mastra-ai/mastra/commit/0302f50861a53c66ff28801fc371b37c5f97e41e), [`74db265`](https://github.com/mastra-ai/mastra/commit/74db265b96aa01a72ffd91dcae0bc3b346cca0f2), [`7f3b8da`](https://github.com/mastra-ai/mastra/commit/7f3b8da6dd21c35d3672e44b4f5dd3502b8f8f92), [`905352b`](https://github.com/mastra-ai/mastra/commit/905352bcda134552400eb252bca1cb05a7975c14), [`f2cda47`](https://github.com/mastra-ai/mastra/commit/f2cda47ae911038c5d5489f54c36517d6f15bdcc), [`cfd377a`](https://github.com/mastra-ai/mastra/commit/cfd377a3a33a9c88b644f6540feed9cd9832db47)]:
+  - @mastra/core@0.15.3-alpha.6
+  - @mastra/memory@0.14.3-alpha.3
+
+## 0.0.1-alpha.3
+
+### Patch Changes
+
+- [#7343](https://github.com/mastra-ai/mastra/pull/7343) [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e) Thanks [@LekoArts](https://github.com/LekoArts)! - Update the `package.json` file to include additional fields like `repository`, `homepage` or `files`.
+
+- Updated dependencies [[`85ef90b`](https://github.com/mastra-ai/mastra/commit/85ef90bb2cd4ae4df855c7ac175f7d392c55c1bf), [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e)]:
+  - @mastra/core@0.15.3-alpha.5
+  - @mastra/memory@0.14.3-alpha.2
+
+## 0.0.1-alpha.2
+
+### Patch Changes
+
+- [#5816](https://github.com/mastra-ai/mastra/pull/5816) [`ab48c97`](https://github.com/mastra-ai/mastra/commit/ab48c979098ea571faf998a55d3a00e7acd7a715) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
+  - Updated dependency [`zod@^3.25.76` ↗︎](https://www.npmjs.com/package/zod/v/3.25.76) (from `^3.25.67`, in `dependencies`)
+
+- [#7330](https://github.com/mastra-ai/mastra/pull/7330) [`b8e1a83`](https://github.com/mastra-ai/mastra/commit/b8e1a8381b356f51bf7c3d525943095cc3c912cc) Thanks [@wardpeet](https://github.com/wardpeet)! - Fix package.json
+
+- [#7136](https://github.com/mastra-ai/mastra/pull/7136) [`48f0742`](https://github.com/mastra-ai/mastra/commit/48f0742662414610dc9a7a99d45902d059ee123d) Thanks [@NikAiyer](https://github.com/NikAiyer)! - add deployer, server and clientjs handlers for agent builder template
+
+- Updated dependencies [[`ab48c97`](https://github.com/mastra-ai/mastra/commit/ab48c979098ea571faf998a55d3a00e7acd7a715), [`ab48c97`](https://github.com/mastra-ai/mastra/commit/ab48c979098ea571faf998a55d3a00e7acd7a715), [`ff89505`](https://github.com/mastra-ai/mastra/commit/ff895057c8c7e91a5535faef46c5e5391085ddfa), [`183dc95`](https://github.com/mastra-ai/mastra/commit/183dc95596f391b977bd1a2c050b8498dac74891), [`a1111e2`](https://github.com/mastra-ai/mastra/commit/a1111e24e705488adfe5e0a6f20c53bddf26cb22), [`61debef`](https://github.com/mastra-ai/mastra/commit/61debefd80ad3a7ed5737e19df6a23d40091689a), [`9beaeff`](https://github.com/mastra-ai/mastra/commit/9beaeffa4a97b1d5fd01a7f8af8708b16067f67c), [`9eee594`](https://github.com/mastra-ai/mastra/commit/9eee594e35e0ca2a650fcc33fa82009a142b9ed0), [`979912c`](https://github.com/mastra-ai/mastra/commit/979912cfd180aad53287cda08af771df26454e2c), [`7dcf4c0`](https://github.com/mastra-ai/mastra/commit/7dcf4c04f44d9345b1f8bc5d41eae3f11ac61611), [`ad78bfc`](https://github.com/mastra-ai/mastra/commit/ad78bfc4ea6a1fff140432bf4f638e01af7af668), [`0ce418a`](https://github.com/mastra-ai/mastra/commit/0ce418a1ccaa5e125d4483a9651b635046152569), [`8387952`](https://github.com/mastra-ai/mastra/commit/838795227b4edf758c84a2adf6f7fba206c27719), [`5eca5d2`](https://github.com/mastra-ai/mastra/commit/5eca5d2655788863ea0442a46c9ef5d3c6dbe0a8)]:
+  - @mastra/core@0.15.3-alpha.4
+  - @mastra/memory@0.14.3-alpha.1
+
+## 0.0.1-alpha.1
+
+### Patch Changes
+
+- [#7135](https://github.com/mastra-ai/mastra/pull/7135) [`48b9e55`](https://github.com/mastra-ai/mastra/commit/48b9e553a39528dcc20fbbeb798c3b1a1961468e) Thanks [@NikAiyer](https://github.com/NikAiyer)! - Add Agent Builder package with template installation workflow
+
+  Introduces a new package for programmatically building and managing Mastra agents with intelligent template merging capabilities. Features include automated dependency resolution, file conflict handling, and validation fixes.
+
+- Updated dependencies [[`aedbbfa`](https://github.com/mastra-ai/mastra/commit/aedbbfa064124ddde039111f12629daebfea7e48), [`f643c65`](https://github.com/mastra-ai/mastra/commit/f643c651bdaf57c2343cf9dbfc499010495701fb), [`fef7375`](https://github.com/mastra-ai/mastra/commit/fef737534574f41b432a7361a285f776c3bac42b), [`e3d8fea`](https://github.com/mastra-ai/mastra/commit/e3d8feaacfb8b5c5c03c13604cc06ea2873d45fe), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
+  - @mastra/core@0.15.3-alpha.3

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,96 @@
+# @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
+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');
+```
+
+## 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