@inkeep/create-agents 0.29.11 → 0.30.0

package/dist/__tests__/e2e/quickstart.test.js

@@ -3,7 +3,6 @@ import { execa } from 'execa';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import { cleanupDir, createTempDir, linkLocalPackages, runCommand, runCreateAgentsCLI, verifyDirectoryStructure, verifyFile, waitForServerReady, } from './utils';
 const manageApiUrl = 'http://localhost:3002';
-const runApiUrl = 'http://localhost:3003';
 describe('create-agents quickstart e2e', () => {
     let testDir;
     let projectDir;
@@ -18,6 +17,9 @@ describe('create-agents quickstart e2e', () => {
         await cleanupDir(testDir);
     });
     it('should work e2e', async () => {
+        const monorepoRoot = path.join(__dirname, '../../../../../');
+        const createAgentsPrefix = path.join(monorepoRoot, 'create-agents-template');
+        const projectTemplatesPrefix = path.join(monorepoRoot, 'agents-cookbook/template-projects');
         // Run the CLI with all options (non-interactive mode)
         console.log('Running CLI with options:');
         console.log(`Working directory: ${testDir}`);
@@ -26,6 +28,10 @@ describe('create-agents quickstart e2e', () => {
             '--openai-key',
             'test-openai-key',
             '--disable-git', // Skip git init for faster tests
+            '--local-agents-prefix',
+            createAgentsPrefix,
+            '--local-templates-prefix',
+            projectTemplatesPrefix,
         ], testDir);
         // Verify the CLI completed successfully
         expect(result.exitCode).toBe(0);
@@ -114,7 +120,6 @@ describe('create-agents quickstart e2e', () => {
             expect(data.data.tenantId).toBe('default');
             expect(data.data.id).toBe(projectId);
             // Link to local monorepo packages
-            const monorepoRoot = path.join(__dirname, '../../../../../'); // Go up to repo root
             await linkLocalPackages(projectDir, monorepoRoot);
             const pushResultLocal = await runCommand('pnpm', [
                 'inkeep',

package/dist/__tests__/utils.test.js

@@ -1,7 +1,7 @@
 import * as p from '@clack/prompts';
 import fs from 'fs-extra';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { cloneTemplate, getAvailableTemplates } from '../templates';
+import { cloneTemplate, cloneTemplateLocal, getAvailableTemplates } from '../templates';
 import { createAgents } from '../utils';
 // Mock all dependencies
 vi.mock('fs-extra');
@@ -55,6 +55,7 @@ describe('createAgents - Template and Project ID Logic', () => {
             'data-analysis',
         ]);
         vi.mocked(cloneTemplate).mockResolvedValue(undefined);
+        vi.mocked(cloneTemplateLocal).mockResolvedValue(undefined);
         // Mock util.promisify to return a mock exec function
         const mockExecAsync = vi.fn().mockResolvedValue({ stdout: '', stderr: '' });
         const util = require('node:util');
@@ -79,10 +80,10 @@ describe('createAgents - Template and Project ID Logic', () => {
                 openAiKey: 'test-openai-key',
                 anthropicKey: 'test-anthropic-key',
             });
-            // Should clone base template and weather-project template
+            // Should clone base template and activities-planner 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/activities-planner', 'src/projects/activities-planner', expect.arrayContaining([
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents/create-agents-template', expect.any(String), undefined);
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents/agents-cookbook/template-projects/activities-planner', 'src/projects/activities-planner', expect.arrayContaining([
                 expect.objectContaining({
                     filePath: 'index.ts',
                     replacements: expect.objectContaining({
@@ -117,8 +118,8 @@ describe('createAgents - Template and Project ID Logic', () => {
             expect(getAvailableTemplates).toHaveBeenCalled();
             // 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/projects/chatbot', expect.arrayContaining([
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents/create-agents-template', expect.any(String), undefined);
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents/agents-cookbook/template-projects/chatbot', 'src/projects/chatbot', expect.arrayContaining([
                 expect.objectContaining({
                     filePath: 'index.ts',
                     replacements: expect.objectContaining({
@@ -168,7 +169,7 @@ describe('createAgents - Template and Project ID Logic', () => {
             });
             // Should clone base template but NOT project template
             expect(cloneTemplate).toHaveBeenCalledTimes(1);
-            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/create-agents-template', expect.any(String));
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents/create-agents-template', expect.any(String), undefined);
             // Should NOT validate templates
             expect(getAvailableTemplates).not.toHaveBeenCalled();
             // Should create empty project directory
@@ -190,7 +191,7 @@ describe('createAgents - Template and Project ID Logic', () => {
             });
             // Should only clone base template, not project template
             expect(cloneTemplate).toHaveBeenCalledTimes(1);
-            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/create-agents-template', expect.any(String));
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents/create-agents-template', expect.any(String), undefined);
             expect(getAvailableTemplates).not.toHaveBeenCalled();
             expect(fs.ensureDir).toHaveBeenCalledWith('src/projects/my-custom-project');
             // Check that .env file is created
@@ -214,7 +215,7 @@ 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/projects/my-complex-template', expect.arrayContaining([
+            expect(cloneTemplate).toHaveBeenCalledWith('https://github.com/inkeep/agents/agents-cookbook/template-projects/my-complex-template', 'src/projects/my-complex-template', expect.arrayContaining([
                 expect.objectContaining({
                     filePath: 'index.ts',
                     replacements: expect.objectContaining({
@@ -328,4 +329,5 @@ function setupDefaultMocks() {
     vi.mocked(fs.writeFile).mockResolvedValue(undefined);
     vi.mocked(getAvailableTemplates).mockResolvedValue(['event-planner', 'chatbot', 'data-analysis']);
     vi.mocked(cloneTemplate).mockResolvedValue(undefined);
+    vi.mocked(cloneTemplateLocal).mockResolvedValue(undefined);
 }

package/dist/index.js

@@ -11,6 +11,8 @@ program
     .option('--anthropic-key <anthropic-key>', 'Anthropic API key')
     .option('--custom-project-id <custom-project-id>', 'Custom project id for experienced users who want an empty project directory')
     .option('--disable-git', 'Disable git initialization')
+    .option('--local-agents-prefix <local-agents-prefix>', 'Local prefix for create-agents-template')
+    .option('--local-templates-prefix <local-templates-prefix>', 'Local prefix for project templates')
     .parse();
 async function main() {
     const options = program.opts();
@@ -23,6 +25,8 @@ async function main() {
             customProjectId: options.customProjectId,
             template: options.template,
             disableGit: options.disableGit,
+            localAgentsPrefix: options.localAgentsPrefix,
+            localTemplatesPrefix: options.localTemplatesPrefix,
         });
     }
     catch (error) {

package/dist/templates.d.ts

@@ -5,7 +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>;
+export declare function cloneTemplateLocal(templatePath: string, targetPath: string, replacements?: ContentReplacement[]): Promise<void>;
 /**
  * Replace content in cloned template files
  */
@@ -14,4 +14,4 @@ export declare function replaceContentInFiles(targetPath: string, replacements:
  * Replace object properties in TypeScript code content
  */
 export declare function replaceObjectProperties(content: string, replacements: Record<string, any>): Promise<string>;
-export declare function getAvailableTemplates(): Promise<string[]>;
+export declare function getAvailableTemplates(localPrefix?: string): Promise<string[]>;

package/dist/templates.js

@@ -253,9 +253,16 @@ function injectPropertyIntoObject(content, propertyPath, replacement) {
     console.warn(`Could not inject property "${propertyPath}" - no suitable object found in content`);
     return content;
 }
-export async function getAvailableTemplates() {
-    // Fetch the list of templates from your repo
-    const response = await fetch('https://api.github.com/repos/inkeep/agents-cookbook/contents/template-projects');
-    const contents = await response.json();
-    return contents.filter((item) => item.type === 'dir').map((item) => item.name);
+export async function getAvailableTemplates(localPrefix) {
+    if (localPrefix && localPrefix.length > 0) {
+        const fullTemplatePath = path.join(localPrefix, 'template-projects');
+        const response = await fs.readdir(fullTemplatePath);
+        return response.filter((item) => fs.stat(path.join(fullTemplatePath, item)).then((stat) => stat.isDirectory()));
+    }
+    else {
+        // Fetch the list of templates from your repo
+        const response = await fetch(`https://api.github.com/repos/inkeep/agents/contents/agents-cookbook/template-projects`);
+        const contents = await response.json();
+        return contents.filter((item) => item.type === 'dir').map((item) => item.name);
+    }
 }

package/dist/utils.d.ts

@@ -40,5 +40,7 @@ export declare const createAgents: (args?: {
     template?: string;
     customProjectId?: string;
     disableGit?: boolean;
+    localAgentsPrefix?: string;
+    localTemplatesPrefix?: string;
 }) => Promise<void>;
 export declare function createCommand(dirName?: string, options?: any): Promise<void>;

package/dist/utils.js

@@ -6,7 +6,7 @@ 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 { cloneTemplate, getAvailableTemplates } from './templates.js';
+import { cloneTemplate, cloneTemplateLocal, getAvailableTemplates, } from './templates.js';
 // Shared validation utility
 const DIRECTORY_VALIDATION = {
     pattern: /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/,
@@ -28,6 +28,8 @@ const DIRECTORY_VALIDATION = {
         return undefined;
     },
 };
+const agentsTemplateRepo = 'https://github.com/inkeep/agents/create-agents-template';
+const projectTemplateRepo = 'https://github.com/inkeep/agents/agents-cookbook/template-projects';
 const execAsync = promisify(exec);
 const manageApiPort = '3002';
 const runApiPort = '3003';
@@ -65,7 +67,7 @@ export const defaultAnthropicModelConfigurations = {
     },
 };
 export const createAgents = async (args = {}) => {
-    let { dirName, openAiKey, anthropicKey, googleKey, template, customProjectId, disableGit } = args;
+    let { dirName, openAiKey, anthropicKey, googleKey, template, customProjectId, disableGit, localAgentsPrefix, localTemplatesPrefix, } = args;
     const tenantId = 'default';
     let projectId;
     let templateName;
@@ -74,7 +76,7 @@ export const createAgents = async (args = {}) => {
         templateName = '';
     }
     else if (template) {
-        const availableTemplates = await getAvailableTemplates();
+        const availableTemplates = await getAvailableTemplates(localTemplatesPrefix);
         if (!availableTemplates.includes(template)) {
             p.cancel(`${color.red('✗')} Template "${template}" not found\n\n` +
                 `${color.yellow('Available templates:')}\n` +
@@ -188,10 +190,6 @@ export const createAgents = async (args = {}) => {
     const s = p.spinner();
     s.start('Creating directory structure...');
     try {
-        const agentsTemplateRepo = 'https://github.com/inkeep/create-agents-template';
-        const projectTemplateRepo = templateName
-            ? `https://github.com/inkeep/agents-cookbook/template-projects/${templateName}`
-            : null;
         const directoryPath = path.resolve(process.cwd(), dirName);
         if (await fs.pathExists(directoryPath)) {
             s.stop();
@@ -206,7 +204,10 @@ export const createAgents = async (args = {}) => {
             await fs.emptyDir(directoryPath);
         }
         s.message('Building template...');
-        await cloneTemplate(agentsTemplateRepo, directoryPath);
+        await cloneTemplateHelper({
+            targetPath: directoryPath,
+            localPrefix: localAgentsPrefix,
+        });
         process.chdir(directoryPath);
         const config = {
             dirName,
@@ -223,7 +224,7 @@ export const createAgents = async (args = {}) => {
         await createWorkspaceStructure();
         s.message('Setting up environment files...');
         await createEnvironmentFiles(config);
-        if (projectTemplateRepo) {
+        if (templateName && templateName.length > 0) {
             s.message('Creating project template folder...');
             const templateTargetPath = `src/projects/${projectId}`;
             const contentReplacements = [
@@ -234,7 +235,12 @@ export const createAgents = async (args = {}) => {
                     },
                 },
             ];
-            await cloneTemplate(projectTemplateRepo, templateTargetPath, contentReplacements);
+            await cloneTemplateHelper({
+                templateName,
+                targetPath: templateTargetPath,
+                localPrefix: localTemplatesPrefix,
+                replacements: contentReplacements,
+            });
         }
         else {
             s.message('Creating empty project folder...');
@@ -505,6 +511,27 @@ async function setupDatabase() {
         throw new Error(`Failed to setup database: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
 }
+async function cloneTemplateHelper(options) {
+    const { targetPath, templateName, localPrefix, replacements } = options;
+    // If local prefix is provided, use it to clone the template. This is useful for local development and testing.
+    if (localPrefix && localPrefix.length > 0) {
+        if (templateName) {
+            const fullTemplatePath = path.join(localPrefix, templateName);
+            await cloneTemplateLocal(fullTemplatePath, targetPath, replacements);
+        }
+        else {
+            await cloneTemplateLocal(localPrefix, targetPath, replacements);
+        }
+    }
+    else {
+        if (templateName) {
+            await cloneTemplate(`${projectTemplateRepo}/${templateName}`, targetPath, replacements);
+        }
+        else {
+            await cloneTemplate(agentsTemplateRepo, targetPath, replacements);
+        }
+    }
+}
 export async function createCommand(dirName, options) {
     await createAgents({
         dirName,

package/package.json

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