@mastra/agent-builder 0.0.1-alpha.1 → 0.0.1-alpha.2

package/dist/index.d.cts

@@ -1,4 +0,0 @@
-export { AgentBuilder } from './_tsup-dts-rollup.cjs';
-export { mergeTemplateBySlug } from './_tsup-dts-rollup.cjs';
-export { agentBuilderTemplateWorkflow } from './_tsup-dts-rollup.cjs';
-export { AgentBuilderDefaults_alias_1 as AgentBuilderDefaults } from './_tsup-dts-rollup.cjs';

package/eslint.config.js

@@ -1,11 +0,0 @@
-import { createConfig } from '@internal/lint/eslint';
-
-const config = await createConfig();
-
-/** @type {import("eslint").Linter.Config[]} */
-export default [
-  ...config,
-  {
-    ...(await import('typescript-eslint')).configs.disableTypeChecked,
-  },
-];

package/integration-tests/CHANGELOG.md

@@ -1,9 +0,0 @@
-# @mastra/agent-builder-integration-tests
-
-## 0.1.1-alpha.0
-
-### Patch Changes
-
-- 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), [`48b9e55`](https://github.com/mastra-ai/mastra/commit/48b9e553a39528dcc20fbbeb798c3b1a1961468e), [`3412597`](https://github.com/mastra-ai/mastra/commit/3412597a6644c0b6bf3236d6e319ed1450c5bae8)]:
-  - @mastra/core@0.15.3-alpha.3
-  - @mastra/agent-builder@0.0.1-alpha.1

package/integration-tests/README.md

@@ -1,154 +0,0 @@
-# Agent Builder Integration Tests
-
-This directory contains comprehensive integration tests for the Mastra Agent Builder, specifically testing the template merging workflow functionality.
-
-## Test Files
-
-### 1. `merge-template.test.ts`
-
-Tests the AgentBuilder with natural language prompts to merge templates using the `mergeTemplate` tool.
-
-### 2. `template-workflow.test.ts` (Comprehensive Integration Test)
-
-Full end-to-end test that:
-
-- Sets up a real Mastra project from the minimal fixture
-- Runs the complete template merge workflow
-- Installs dependencies
-- Starts a Mastra server
-- Validates that both original and new agents/workflows function correctly
-- Tests git history and branch management
-
-### 3. `template-workflow-mock.test.ts` (Unit Tests)
-
-Lightweight tests with mocked dependencies that validate:
-
-- Template API fetching
-- Workflow configuration
-- Input validation
-- Project structure validation
-
-## Running Tests
-
-### Prerequisites
-
-- Node.js and pnpm installed
-- For integration tests: `OPENAI_API_KEY` environment variable set
-- Git configured with user.name and user.email
-
-### Commands
-
-```bash
-# Run all tests
-pnpm test
-
-# Run only the mocked unit tests (no API key required)
-pnpm test:mock
-
-# Run the full integration template test (requires OPENAI_API_KEY)
-pnpm test:template
-
-# Run the agent builder prompt tests
-pnpm test:agent
-
-# Run a specific test file
-pnpm vitest run ./src/template-workflow.test.ts
-```
-
-### Environment Variables
-
-```bash
-# Required for integration tests
-export OPENAI_API_KEY="your-openai-api-key"
-
-# Optional: Use a different OpenAI model
-export OPENAI_MODEL="gpt-4o-mini"
-```
-
-## Test Scenarios
-
-### Template Workflow Integration Test
-
-This comprehensive test validates the complete template integration process:
-
-1. **Setup Phase**:
-   - Creates a temporary directory
-   - Copies the minimal Mastra project fixture
-   - Initializes git repository
-   - Installs dependencies with pnpm
-
-2. **Template Merge Phase**:
-   - Fetches template metadata from Mastra API
-   - Runs the merge workflow to integrate `csv-to-questions` template
-   - Validates file creation and git history
-
-3. **Server Validation Phase**:
-   - Starts a Mastra development server
-   - Tests original agents (weather) still work
-   - Tests new agents (csvQuestionAgent) are functional
-   - Validates workflow registration
-
-4. **Conflict Handling**:
-   - Tests duplicate template merging
-   - Validates graceful conflict resolution
-
-### Expected Template Files
-
-After merging the `csv-to-questions` template, these files should be created:
-
-- `src/mastra/agents/csvQuestionAgent.ts`
-- `src/mastra/tools/csvTool.ts`
-- `src/mastra/workflows/csvToQuestionsWorkflow.ts`
-
-### Git History Validation
-
-The test validates that proper git commits are created:
-
-- `feat(template): add agent csvQuestionAgent (csv-to-questions@<sha>)`
-- `feat(template): add tool csvTool (csv-to-questions@<sha>)`
-- `feat(template): add workflow csvToQuestionsWorkflow (csv-to-questions@<sha>)`
-- `feat(template): update package.json for csv-to-questions`
-
-## Debugging
-
-### Common Issues
-
-1. **OpenAI API Key**: Ensure `OPENAI_API_KEY` is set for integration tests
-2. **Port Conflicts**: Tests use dynamic port allocation to avoid conflicts
-3. **Git Configuration**: Ensure git user.name and user.email are configured
-4. **Dependencies**: Run `pnpm install` in the test project before running tests
-
-### Verbose Output
-
-```bash
-# Run with verbose output for debugging
-pnpm vitest run ./src/template-workflow.test.ts --reporter=verbose
-
-# Run a single test case
-pnpm vitest run ./src/template-workflow.test.ts -t "should merge csv-to-questions template"
-```
-
-### Test Timeouts
-
-- Mock tests: 5 seconds (default)
-- Integration tests: 3 minutes for workflow, 2 minutes for server tests
-- Server startup timeout: 30 seconds
-
-## CI/CD Considerations
-
-For CI/CD environments:
-
-1. Use `test:mock` for fast unit tests without external dependencies
-2. Use `test:integration` only when OpenAI API key is available
-3. Consider using test containers for isolated environments
-4. Mock external API calls for reliable CI execution
-
-## Contributing
-
-When adding new tests:
-
-1. Follow the existing pattern of setup/teardown
-2. Use descriptive test names
-3. Include proper cleanup in `afterAll` hooks
-4. Add appropriate timeouts for long-running operations
-5. Validate both success and error scenarios

package/integration-tests/docker-compose.yml

@@ -1,39 +0,0 @@
-services:
-  postgres:
-    image: ankane/pgvector:v0.5.1
-    ports:
-      - '5435:5432'
-    environment:
-      POSTGRES_USER: postgres
-      POSTGRES_PASSWORD: password
-      POSTGRES_DB: mastra
-    volumes:
-      - pg_data:/var/lib/postgresql/data
-    healthcheck:
-      test: ['CMD-SHELL', 'pg_isready -U postgres']
-      interval: 5s
-      timeout: 5s
-      retries: 5
-  redis:
-    image: redis:7-alpine
-    ports:
-      - '6371:6379'
-    command: redis-server --requirepass redis_password
-    healthcheck:
-      test: ['CMD', 'redis-cli', 'ping']
-      interval: 5s
-      timeout: 5s
-      retries: 5
-  serverless-redis-http:
-    image: hiett/serverless-redis-http:latest
-    ports:
-      - '8080:80'
-    environment:
-      SRH_MODE: env
-      SRH_TOKEN: test_token
-      SRH_CONNECTION_STRING: 'redis://:redis_password@redis:6379'
-    depends_on:
-      redis:
-        condition: service_healthy
-volumes:
-  pg_data:

package/integration-tests/package.json

@@ -1,38 +0,0 @@
-{
-  "name": "@mastra/agent-builder-integration-tests",
-  "private": true,
-  "version": "0.1.1-alpha.0",
-  "scripts": {
-    "test": "vitest run",
-    "test:agent": "vitest run ./src/agent-template-behavior.test.ts",
-    "test:template": "vitest run ./src/template-integration.test.ts",
-    "dev": "mastra dev"
-  },
-  "dependencies": {
-    "@ai-sdk/google": "^1.2.19",
-    "@ai-sdk/openai": "^1.3.0",
-    "@ai-sdk/react": "^1.2.1",
-    "@mastra/agent-builder": "workspace:*",
-    "dotenv": "^16.4.7",
-    "json-schema": "^0.4.0",
-    "zod": "^3.24.3"
-  },
-  "devDependencies": {
-    "@faker-js/faker": "^9.6.0",
-    "@mastra/core": "workspace:*",
-    "@testing-library/react": "^16.2.0",
-    "@types/json-schema": "^7.0.15",
-    "@types/node": "^20.17.27",
-    "ai": "^4.2.2",
-    "jsdom": "^26.0.0",
-    "mastra": "workspace:*",
-    "next": "^15.2.4",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
-    "typescript": "^5.8.2",
-    "vitest": "^3.2.4"
-  },
-  "peerDependencies": {
-    "@mastra/core": ">=0.15.2-0 <0.16.0-0"
-  }
-}

package/integration-tests/src/agent-template-behavior.test.ts

@@ -1,103 +0,0 @@
-import { execSync } from 'node:child_process';
-import { mkdtempSync, mkdirSync, rmSync, cpSync, existsSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { RuntimeContext } from '@mastra/core/runtime-context';
-import { describe, it, expect, beforeAll, afterAll } from 'vitest';
-import { AgentBuilder } from '../../src/index';
-
-// Import openai dynamically to handle cases where it might not be available
-const openai = (() => {
-  try {
-    return require('@ai-sdk/openai').openai;
-  } catch {
-    return null;
-  }
-})();
-
-function exec(cmd: string, cwd?: string) {
-  return execSync(cmd, { stdio: 'pipe', cwd }).toString();
-}
-
-function initGitRepo(repoDir: string) {
-  exec('git init -q', repoDir);
-  exec('git config user.email "test@example.com"', repoDir);
-  exec('git config user.name "Test User"', repoDir);
-}
-
-function commitAll(repoDir: string, message: string) {
-  exec('git add .', repoDir);
-  exec(`git commit -m "${message}" -q`, repoDir);
-}
-
-describe('agent-builder merge template via agent prompt (real template)', () => {
-  const integrationProjectsDir = resolve(__dirname, '../integration-projects');
-  mkdirSync(integrationProjectsDir, { recursive: true });
-  const tempRoot = mkdtempSync(join(integrationProjectsDir, 'agent-builder-it-'));
-  const fixtureProjectPath = resolve(__dirname, 'fixtures/minimal-mastra-project');
-  const targetRepo = join(tempRoot, 'project-under-test');
-  const realTemplateGit = 'https://github.com/mastra-ai/template-pdf-questions';
-
-  const runtimeContext = new RuntimeContext();
-  runtimeContext.set('targetPath', targetRepo);
-
-  beforeAll(() => {
-    // Copy the fixture mastra project into temp directory
-    mkdirSync(targetRepo, { recursive: true });
-    cpSync(fixtureProjectPath, targetRepo, { recursive: true });
-
-    // Initialize git in target
-    initGitRepo(targetRepo);
-    commitAll(targetRepo, 'chore: initial mastra project');
-  });
-
-  afterAll(() => {
-    try {
-      rmSync(tempRoot, { recursive: true, force: true });
-    } catch {}
-  });
-
-  it('uses AgentBuilder with natural language to merge pdf-questions template', async () => {
-    // Skip test if no OPENAI_API_KEY available or openai not available
-    if (!process.env.OPENAI_API_KEY || !openai) {
-      console.log('Skipping test: OPENAI_API_KEY not set or @ai-sdk/openai not available');
-      return;
-    }
-
-    // Create AgentBuilder with real OpenAI model
-    const agent = new AgentBuilder({
-      instructions:
-        'You are an expert at merging Mastra templates into projects. Always use the merge-template tool for template operations.',
-      model: openai('gpt-4o-mini'),
-      projectPath: targetRepo,
-    });
-
-    const prompt = `I want to merge the PDF Questions template into this Mastra project. 
-
-Template repository: ${realTemplateGit}`;
-
-    // Call the agent with natural language
-    const response = await agent.generate(prompt, {
-      maxSteps: 5,
-      runtimeContext,
-    });
-
-    // Verify files were actually created in the target project
-    const expectedFiles = ['src/mastra/agents', 'src/mastra/tools', 'src/mastra/workflows'];
-
-    for (const expectedPath of expectedFiles) {
-      const fullPath = join(targetRepo, expectedPath);
-      expect(existsSync(fullPath)).toBe(true);
-    }
-
-    // Verify git branch was created
-    const branches = exec('git branch', targetRepo);
-    expect(branches).toContain('feat/install-template-template-pdf-questions');
-
-    // Verify package.json was updated with template scripts
-    const packageJsonPath = join(targetRepo, 'package.json');
-    expect(existsSync(packageJsonPath)).toBe(true);
-
-    // Verify response contains confirmation
-    expect(response.text.toLowerCase()).toMatch(/merge|template|success|applied|complete/);
-  }, 600000); // Longer timeout for full merge operation
-});

package/integration-tests/src/fixtures/minimal-mastra-project/env.example

@@ -1,6 +0,0 @@
-# AI Provider Keys
-OPENAI_API_KEY=your_openai_api_key_here
-ANTHROPIC_API_KEY=your_anthropic_api_key_here
-
-# Database
-DATABASE_URL=file:./mastra.db

package/integration-tests/src/fixtures/minimal-mastra-project/package.json

@@ -1,17 +0,0 @@
-{
-  "name": "minimal-mastra-fixture",
-  "version": "0.1.0",
-  "type": "module",
-  "scripts": {
-    "dev": "mastra dev",
-    "build": "mastra build"
-  },
-  "dependencies": {
-    "@mastra/core": "latest",
-    "@mastra/mcp": "latest",
-    "zod": "^3.25.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.0.0"
-  }
-}

package/integration-tests/src/fixtures/minimal-mastra-project/src/mastra/agents/weather.ts

@@ -1,34 +0,0 @@
-import { openai } from '@ai-sdk/openai';
-import { createTool } from '@mastra/core';
-import { Agent } from '@mastra/core/agent';
-import { MCPClient } from '@mastra/mcp';
-import { z } from 'zod';
-import { weatherTool } from '../tools/weather';
-
-const client = new MCPClient({
-  id: 'weather-server',
-  servers: {
-    weather: {
-      url: new URL(`http://localhost:4199/api/mcp/myMcpServer/mcp`),
-    },
-  },
-});
-
-export const weatherAgent = new Agent({
-  name: 'test',
-  instructions:
-    'You are a weather agent. When asked about weather in any city, use the get_weather tool with the city name as the postal code. When asked for clipboard contents you also get that.',
-  model: openai('gpt-4o'),
-  tools: async () => {
-    const tools = await client.getTools();
-    return {
-      get_weather: weatherTool,
-      clipboard: createTool({
-        id: 'clipboard',
-        description: 'Returns the contents of the users clipboard',
-        inputSchema: z.object({}),
-      }),
-      ...tools,
-    };
-  },
-});

package/integration-tests/src/fixtures/minimal-mastra-project/src/mastra/index.ts

@@ -1,15 +0,0 @@
-import { Mastra } from '@mastra/core';
-import { weatherAgent } from './agents/weather';
-import { myMcpServer } from './mcp';
-
-export const mastra = new Mastra({
-  agents: {
-    weatherAgent,
-  },
-  mcpServers: {
-    myMcpServer,
-  },
-  server: {
-    port: 4199,
-  },
-});

package/integration-tests/src/fixtures/minimal-mastra-project/src/mastra/mcp/index.ts

@@ -1,46 +0,0 @@
-import { createTool } from '@mastra/core/tools';
-import { MCPServer } from '@mastra/mcp';
-import { z } from 'zod';
-
-export const myMcpServer = new MCPServer({
-  name: 'My Calculation & Data MCP Server',
-  version: '1.0.0',
-  tools: {
-    calculator: createTool({
-      id: 'calculator',
-      description: 'Performs basic arithmetic operations (add, subtract).',
-      inputSchema: z.object({
-        num1: z.number().describe('The first number.'),
-        num2: z.number().describe('The second number.'),
-        operation: z.enum(['add', 'subtract']).describe('The operation to perform.'),
-      }),
-      execute: async ({ context }) => {
-        const { num1, num2, operation } = context;
-        if (operation === 'add') {
-          return num1 + num2;
-        }
-        if (operation === 'subtract') {
-          return num1 - num2;
-        }
-        throw new Error('Invalid operation');
-      },
-    }),
-    fetchWeather: createTool({
-      id: 'fetchWeather',
-      description: 'Fetches a (simulated) weather forecast for a given city.',
-      inputSchema: z.object({
-        city: z.string().describe('The city to get weather for, e.g., London, Paris.'),
-      }),
-      execute: async ({ context }) => {
-        const { city } = context;
-        const temperatures = {
-          london: '15°C',
-          paris: '18°C',
-          tokyo: '22°C',
-        };
-        const temp = temperatures[city.toLowerCase() as keyof typeof temperatures] || '20°C';
-        return `The weather in ${city} is ${temp} and sunny.`;
-      },
-    }),
-  },
-});

package/integration-tests/src/fixtures/minimal-mastra-project/src/mastra/tools/weather.ts

@@ -1,14 +0,0 @@
-import { createTool } from '@mastra/core/tools';
-import { z } from 'zod';
-
-export const weatherTool = createTool({
-  id: 'get_weather',
-  description: 'Get the weather for a given location',
-  inputSchema: z.object({
-    postalCode: z.string().describe('The location to get the weather for'),
-  }),
-  execute: async ({ context }) => {
-    const { postalCode } = context;
-    return `The weather in ${postalCode} is sunny. It is currently 70 degrees and feels like 65 degrees.`;
-  },
-});

package/integration-tests/src/fixtures/minimal-mastra-project/tsconfig.json

@@ -1,17 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "baseUrl": ".",
-    "paths": {
-      "@/*": ["./src/*"]
-    }
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules"]
-}