@inkeep/create-agents 0.21.0 → 0.22.0

package/dist/__tests__/utils.test.js

@@ -49,7 +49,7 @@ describe('createAgents - Template and Project ID Logic', () => {
         vi.mocked(fs.remove).mockResolvedValue(undefined);
         // Mock templates
         vi.mocked(getAvailableTemplates).mockResolvedValue([
-            'weather-project',
+            'event-planner',
             'chatbot',
             'data-analysis',
         ]);
@@ -72,7 +72,7 @@ describe('createAgents - Template and Project ID Logic', () => {
         processChdirSpy.mockRestore();
     });
     describe('Default behavior (no template or customProjectId)', () => {
-        it('should use weather-project as default template and project ID', async () => {
+        it('should use event-planner as default template and project ID', async () => {
             await createAgents({
                 dirName: 'test-dir',
                 openAiKey: 'test-openai-key',
@@ -81,18 +81,18 @@ describe('createAgents - Template and Project ID Logic', () => {
             // Should clone base template and weather-project template
             expect(cloneTemplate).toHaveBeenCalledTimes(2);
             expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/create-agents-template', expect.any(String));
-            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents-cookbook/template-projects/weather-project', 'src/weather-project', expect.arrayContaining([
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents-cookbook/template-projects/event-planner', 'src/projects/event-planner', expect.arrayContaining([
                 expect.objectContaining({
                     filePath: 'index.ts',
                     replacements: expect.objectContaining({
-                        models: expect.any(Object)
-                    })
-                })
+                        models: expect.any(Object),
+                    }),
+                }),
             ]));
             // Should not call getAvailableTemplates since no template validation needed
             expect(getAvailableTemplates).not.toHaveBeenCalled();
         });
-        it('should create project with weather-project as project ID', async () => {
+        it('should create project with event-planner as project ID', async () => {
             await createAgents({
                 dirName: 'test-dir',
                 openAiKey: 'test-openai-key',
@@ -117,13 +117,13 @@ describe('createAgents - Template and Project ID Logic', () => {
             // Should clone base template and the specified template
             expect(cloneTemplate).toHaveBeenCalledTimes(2);
             expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/create-agents-template', expect.any(String));
-            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents-cookbook/template-projects/chatbot', 'src/chatbot', expect.arrayContaining([
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents-cookbook/template-projects/chatbot', 'src/projects/chatbot', expect.arrayContaining([
                 expect.objectContaining({
                     filePath: 'index.ts',
                     replacements: expect.objectContaining({
-                        models: expect.any(Object)
-                    })
-                })
+                        models: expect.any(Object),
+                    }),
+                }),
             ]));
             // Check that .env file is created
             expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('ENVIRONMENT=development'));
@@ -131,7 +131,7 @@ describe('createAgents - Template and Project ID Logic', () => {
             expect(fs.writeFile).toHaveBeenCalledWith('src/inkeep.config.ts', expect.stringContaining('tenantId: "default"'));
         });
         it('should exit with error when template does not exist', async () => {
-            vi.mocked(getAvailableTemplates).mockResolvedValue(['weather-project', 'chatbot']);
+            vi.mocked(getAvailableTemplates).mockResolvedValue(['event-planner', 'chatbot']);
             await expect(createAgents({
                 dirName: 'test-dir',
                 template: 'non-existent-template',
@@ -142,7 +142,7 @@ describe('createAgents - Template and Project ID Logic', () => {
         });
         it('should show available templates when invalid template is provided', async () => {
             vi.mocked(getAvailableTemplates).mockResolvedValue([
-                'weather-project',
+                'event-planner',
                 'chatbot',
                 'data-analysis',
             ]);
@@ -152,7 +152,7 @@ describe('createAgents - Template and Project ID Logic', () => {
                 openAiKey: 'test-openai-key',
             })).rejects.toThrow('process.exit called');
             const cancelCall = vi.mocked(p.cancel).mock.calls[0][0];
-            expect(cancelCall).toContain('weather-project');
+            expect(cancelCall).toContain('event-planner');
             expect(cancelCall).toContain('chatbot');
             expect(cancelCall).toContain('data-analysis');
         });
@@ -171,13 +171,13 @@ describe('createAgents - Template and Project ID Logic', () => {
             // Should NOT validate templates
             expect(getAvailableTemplates).not.toHaveBeenCalled();
             // Should create empty project directory
-            expect(fs.ensureDir).toHaveBeenCalledWith('src/my-custom-project');
+            expect(fs.ensureDir).toHaveBeenCalledWith('src/projects/my-custom-project');
             // Check that .env file is created
             expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('ENVIRONMENT=development'));
             // Check that inkeep.config.ts is created in src directory
             expect(fs.writeFile).toHaveBeenCalledWith('src/inkeep.config.ts', expect.stringContaining('tenantId: "default"'));
             // Check that custom project index.ts is created
-            expect(fs.writeFile).toHaveBeenCalledWith('src/my-custom-project/index.ts', expect.stringContaining('id: "my-custom-project"'));
+            expect(fs.writeFile).toHaveBeenCalledWith('src/projects/my-custom-project/index.ts', expect.stringContaining('id: "my-custom-project"'));
         });
         it('should prioritize custom project ID over template if both are provided', async () => {
             await createAgents({
@@ -191,13 +191,13 @@ describe('createAgents - Template and Project ID Logic', () => {
             expect(cloneTemplate).toHaveBeenCalledTimes(1);
             expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/create-agents-template', expect.any(String));
             expect(getAvailableTemplates).not.toHaveBeenCalled();
-            expect(fs.ensureDir).toHaveBeenCalledWith('src/my-custom-project');
+            expect(fs.ensureDir).toHaveBeenCalledWith('src/projects/my-custom-project');
             // Check that .env file is created
             expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('ENVIRONMENT=development'));
             // Check that inkeep.config.ts is created in src directory
             expect(fs.writeFile).toHaveBeenCalledWith('src/inkeep.config.ts', expect.stringContaining('tenantId: "default"'));
             // Check that custom project index.ts is created
-            expect(fs.writeFile).toHaveBeenCalledWith('src/my-custom-project/index.ts', expect.stringContaining('id: "my-custom-project"'));
+            expect(fs.writeFile).toHaveBeenCalledWith('src/projects/my-custom-project/index.ts', expect.stringContaining('id: "my-custom-project"'));
         });
     });
     describe('Edge cases and validation', () => {
@@ -213,13 +213,13 @@ describe('createAgents - Template and Project ID Logic', () => {
                 anthropicKey: 'test-key',
             });
             expect(cloneTemplate).toHaveBeenCalledTimes(2);
-            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents-cookbook/template-projects/my-complex-template', 'src/my-complex-template', expect.arrayContaining([
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents-cookbook/template-projects/my-complex-template', 'src/projects/my-complex-template', expect.arrayContaining([
                 expect.objectContaining({
                     filePath: 'index.ts',
                     replacements: expect.objectContaining({
-                        models: expect.any(Object)
-                    })
-                })
+                        models: expect.any(Object),
+                    }),
+                }),
             ]));
         });
         it('should handle custom project IDs with special characters', async () => {
@@ -229,13 +229,13 @@ describe('createAgents - Template and Project ID Logic', () => {
                 openAiKey: 'test-key',
                 anthropicKey: 'test-key',
             });
-            expect(fs.ensureDir).toHaveBeenCalledWith('src/my_project-123');
+            expect(fs.ensureDir).toHaveBeenCalledWith('src/projects/my_project-123');
             // Check that .env file is created
             expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('ENVIRONMENT=development'));
             // Check that inkeep.config.ts is created in src directory
             expect(fs.writeFile).toHaveBeenCalledWith('src/inkeep.config.ts', expect.stringContaining('tenantId: "default"'));
             // Check that custom project index.ts is created
-            expect(fs.writeFile).toHaveBeenCalledWith('src/my_project-123/index.ts', expect.stringContaining('id: "my_project-123"'));
+            expect(fs.writeFile).toHaveBeenCalledWith('src/projects/my_project-123/index.ts', expect.stringContaining('id: "my_project-123"'));
         });
         it('should create correct folder structure for all scenarios', async () => {
             // Test default
@@ -267,7 +267,7 @@ describe('createAgents - Template and Project ID Logic', () => {
                 anthropicKey: 'key',
             });
             expect(fs.ensureDir).toHaveBeenCalledWith('src');
-            expect(fs.ensureDir).toHaveBeenCalledWith('src/custom');
+            expect(fs.ensureDir).toHaveBeenCalledWith('src/projects/custom');
         });
     });
 });
@@ -277,10 +277,6 @@ function setupDefaultMocks() {
     vi.mocked(fs.pathExists).mockResolvedValue(false);
     vi.mocked(fs.ensureDir).mockResolvedValue(undefined);
     vi.mocked(fs.writeFile).mockResolvedValue(undefined);
-    vi.mocked(getAvailableTemplates).mockResolvedValue([
-        'weather-project',
-        'chatbot',
-        'data-analysis',
-    ]);
+    vi.mocked(getAvailableTemplates).mockResolvedValue(['event-planner', 'chatbot', 'data-analysis']);
     vi.mocked(cloneTemplate).mockResolvedValue(undefined);
 }

package/dist/templates.d.ts

@@ -5,6 +5,7 @@ export interface ContentReplacement {
     replacements: Record<string, any>;
 }
 export declare function cloneTemplate(templatePath: string, targetPath: string, replacements?: ContentReplacement[]): Promise<void>;
+export declare function cloneTemplateLocal(templatePath: string, targetPath: string, replacements: ContentReplacement[]): Promise<void>;
 /**
  * Replace content in cloned template files
  */

package/dist/templates.js

@@ -17,6 +17,22 @@ export async function cloneTemplate(templatePath, targetPath, replacements) {
         process.exit(1);
     }
 }
+export async function cloneTemplateLocal(templatePath, targetPath, replacements) {
+    await fs.mkdir(targetPath, { recursive: true });
+    try {
+        await fs.copy(templatePath, targetPath, {
+            overwrite: true,
+            errorOnExist: false,
+        });
+        if (replacements && replacements.length > 0) {
+            await replaceContentInFiles(targetPath, replacements);
+        }
+    }
+    catch (error) {
+        console.error(`Failed to clone template from ${templatePath}:`, error);
+        process.exit(1);
+    }
+}
 /**
  * Replace content in cloned template files
  */

package/dist/utils.js

@@ -2,9 +2,9 @@ import { exec } from 'node:child_process';
 import path from 'node:path';
 import { promisify } from 'node:util';
 import * as p from '@clack/prompts';
+import { ANTHROPIC_MODELS, GOOGLE_MODELS, OPENAI_MODELS } from '@inkeep/agents-core';
 import fs from 'fs-extra';
 import color from 'picocolors';
-import { ANTHROPIC_MODELS, OPENAI_MODELS, GOOGLE_MODELS } from '@inkeep/agents-core';
 import { cloneTemplate, getAvailableTemplates } from './templates.js';
 const execAsync = promisify(exec);
 export const defaultGoogleModelConfigurations = {
@@ -47,14 +47,11 @@ export const createAgents = async (args = {}) => {
     const runApiPort = '3003';
     let projectId;
     let templateName;
-    // Determine project ID and template based on user input
     if (customProjectId) {
-        // User provided custom project ID - use it as-is, no template needed
         projectId = customProjectId;
-        templateName = ''; // No template will be cloned
+        templateName = '';
     }
     else if (template) {
-        // User provided template - validate it exists and use template name as project ID
         const availableTemplates = await getAvailableTemplates();
         if (!availableTemplates.includes(template)) {
             p.cancel(`${color.red('✗')} Template "${template}" not found\n\n` +
@@ -66,12 +63,10 @@ export const createAgents = async (args = {}) => {
         templateName = template;
     }
     else {
-        // No template or custom project ID provided - use defaults
-        projectId = 'weather-project';
-        templateName = 'weather-project';
+        projectId = 'event-planner';
+        templateName = 'event-planner';
     }
     p.intro(color.inverse(' Create Agents Directory '));
-    // Prompt for directory name if not provided
     if (!dirName) {
         const dirResponse = await p.text({
             message: 'What do you want to name your agents directory?',
@@ -90,8 +85,6 @@ export const createAgents = async (args = {}) => {
         }
         dirName = dirResponse;
     }
-    // Project ID is already determined above based on template/customProjectId logic
-    // If keys aren't provided via CLI args, prompt for provider selection and keys
     if (!anthropicKey && !openAiKey && !googleKey) {
         const providerChoice = await p.select({
             message: 'Which AI provider would you like to use?',
@@ -105,7 +98,6 @@ export const createAgents = async (args = {}) => {
             p.cancel('Operation cancelled');
             process.exit(0);
         }
-        // Prompt for keys based on selection
         if (providerChoice === 'anthropic') {
             const anthropicKeyResponse = await p.text({
                 message: 'Enter your Anthropic API key:',
@@ -168,7 +160,6 @@ export const createAgents = async (args = {}) => {
     else if (googleKey) {
         defaultModelSettings = defaultGoogleModelConfigurations;
     }
-    // Ensure models are always configured - fail if none were set
     if (Object.keys(defaultModelSettings).length === 0) {
         p.cancel('Cannot continue without a model configuration for project. Please provide an API key for at least one AI provider.');
         process.exit(1);
@@ -181,7 +172,6 @@ export const createAgents = async (args = {}) => {
             ? `https://github.com/inkeep/agents-cookbook/template-projects/${templateName}`
             : null;
         const directoryPath = path.resolve(process.cwd(), dirName);
-        // Check if directory already exists
         if (await fs.pathExists(directoryPath)) {
             s.stop();
             const overwrite = await p.confirm({
@@ -194,10 +184,8 @@ export const createAgents = async (args = {}) => {
             s.start('Cleaning existing directory...');
             await fs.emptyDir(directoryPath);
         }
-        // Clone the template repository
         s.message('Building template...');
         await cloneTemplate(agentsTemplateRepo, directoryPath);
-        // Change to the project directory
         process.chdir(directoryPath);
         const config = {
             dirName,
@@ -211,17 +199,13 @@ export const createAgents = async (args = {}) => {
             modelSettings: defaultModelSettings,
             customProject: !!customProjectId,
         };
-        // Create workspace structure for project-specific files
         s.message('Setting up project structure...');
         await createWorkspaceStructure();
-        // Create environment files
         s.message('Setting up environment files...');
         await createEnvironmentFiles(config);
-        // Create project template folder (only if template is specified)
         if (projectTemplateRepo) {
             s.message('Creating project template folder...');
-            const templateTargetPath = `src/${projectId}`;
-            // Prepare content replacements for model settings
+            const templateTargetPath = `src/projects/${projectId}`;
             const contentReplacements = [
                 {
                     filePath: 'index.ts',
@@ -234,23 +218,18 @@ export const createAgents = async (args = {}) => {
         }
         else {
             s.message('Creating empty project folder...');
-            await fs.ensureDir(`src/${projectId}`);
+            await fs.ensureDir(`src/projects/${projectId}`);
         }
-        // create or overwrite inkeep.config.ts
         s.message('Creating inkeep.config.ts...');
         await createInkeepConfig(config);
-        // Install dependencies
         s.message('Installing dependencies (this may take a while)...');
         await installDependencies();
-        // Setup database
         s.message('Setting up database...');
         await setupDatabase();
-        // Setup project in database
         s.message('Pushing project...');
         await setupProjectInDatabase(config);
         s.message('Project setup complete!');
         s.stop();
-        // Success message with next steps
         p.note(`${color.green('✓')} Project created at: ${color.cyan(directoryPath)}\n\n` +
             `${color.yellow('Ready to go!')}\n\n` +
             `${color.green('✓')} Project created in file system\n` +
@@ -265,7 +244,7 @@ export const createAgents = async (args = {}) => {
             `  • Manage UI: Available with management API\n` +
             `\n${color.yellow('Configuration:')}\n` +
             `  • Edit .env for environment variables\n` +
-            `  • Edit files in src/${projectId}/ for agent definitions\n` +
+            `  • Edit files in src/projects/${projectId}/ for agent definitions\n` +
             `  • Use 'inkeep push' to deploy agents to the platform\n` +
             `  • Use 'inkeep chat' to test your agents locally\n`, 'Ready to go!');
     }
@@ -276,11 +255,9 @@ export const createAgents = async (args = {}) => {
     }
 };
 async function createWorkspaceStructure() {
-    // Create the workspace directory structure
     await fs.ensureDir(`src`);
 }
 async function createEnvironmentFiles(config) {
-    // Root .env file
     const envContent = `# Environment
 ENVIRONMENT=development
 
@@ -330,48 +307,36 @@ export const myProject = project({
   agent: () => [],
   models: ${JSON.stringify(config.modelSettings, null, 2)},
 });`;
-        await fs.writeFile(`src/${config.projectId}/index.ts`, customIndexContent);
+        await fs.writeFile(`src/projects/${config.projectId}/index.ts`, customIndexContent);
     }
 }
 async function installDependencies() {
     await execAsync('pnpm install');
 }
 async function setupProjectInDatabase(config) {
-    // Start development servers in background
     const { spawn } = await import('node:child_process');
     const devProcess = spawn('pnpm', ['dev:apis'], {
         stdio: ['pipe', 'pipe', 'pipe'],
-        detached: true, // Detach so we can kill the process group
+        detached: true,
         cwd: process.cwd(),
     });
-    // Give servers time to start
     await new Promise((resolve) => setTimeout(resolve, 5000));
-    // Run inkeep push
     try {
-        // Suppress all output
-        await execAsync(`pnpm inkeep push --project src/${config.projectId} --config src/inkeep.config.ts`);
+        await execAsync(`pnpm inkeep push --project src/projects/${config.projectId} --config src/inkeep.config.ts`);
     }
     catch (_error) {
-        //Continue despite error - user can setup project manually
     }
     finally {
-        // Kill the dev servers and their child processes
         if (devProcess.pid) {
             try {
-                // Kill the entire process group
                 process.kill(-devProcess.pid, 'SIGTERM');
-                // Wait a moment for graceful shutdown
                 await new Promise((resolve) => setTimeout(resolve, 1000));
-                // Force kill if still running
                 try {
                     process.kill(-devProcess.pid, 'SIGKILL');
                 }
-                catch {
-                    // Process already terminated
-                }
+                catch { }
             }
             catch (_error) {
-                // Process might already be dead, that's fine
                 console.log('Note: Dev servers may still be running in background');
             }
         }
@@ -379,7 +344,6 @@ async function setupProjectInDatabase(config) {
 }
 async function setupDatabase() {
     try {
-        // Run drizzle-kit migrate to apply migrations to database
         await execAsync('pnpm db:migrate');
         await new Promise((resolve) => setTimeout(resolve, 1000));
     }
@@ -387,7 +351,6 @@ async function setupDatabase() {
         throw new Error(`Failed to setup database: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
 }
-// Export the command function for the CLI
 export async function createCommand(dirName, options) {
     await createAgents({
         dirName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/create-agents",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Create an Inkeep Agent Framework project",
   "type": "module",
   "bin": {
@@ -34,7 +34,7 @@
     "fs-extra": "^11.0.0",
     "picocolors": "^1.0.0",
     "drizzle-kit": "^0.31.5",
-    "@inkeep/agents-core": "0.21.0"
+    "@inkeep/agents-core": "0.22.0"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",