@inkeep/create-agents 0.41.2 → 0.43.0

package/README.md

@@ -64,7 +64,7 @@ Navigate to the **Activities Planner** agent at http://localhost:3000 and ask ab
 
 ### Next steps
 
+- Set up [AI coding for Inkeep](https://docs.inkeep.com/get-started/ai-coding-setup-for-ide) with skills and MCP.
 - Learn about [inkeep push / pull](https://docs.inkeep.com/get-started/push-pull) so you can go from `SDK -> Visual Builder` and `Visual Builder -> SDK`.
 - Follow our [meeting prep agent tutorial](https://docs.inkeep.com/tutorials/agents/meeting-prep-assistant) to create an agent using the Visual Builder.
-- Follow our [fact finder agent tutorial](https://docs.inkeep.com/tutorials/agents/fact-finder) to create an agent using the TypeScript SDK.
-- Install the [Inkeep MCP](https://docs.inkeep.com/get-started/inkeep-mcp) in your IDE to enable AI coding assistants to "vibe code" your Inkeep agents.
+- Follow our [fact finder agent tutorial](https://docs.inkeep.com/tutorials/agents/fact-finder) to create an agent using the TypeScript SDK.

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

@@ -35,6 +35,7 @@ describe('create-agents quickstart e2e', () => {
             projectTemplatesPrefix,
             '--skip-inkeep-cli',
             '--skip-inkeep-mcp',
+            '--skip-install', // Skip initial install so we can link local packages first
         ], testDir);
         // Verify the CLI completed successfully
         expect(result.exitCode, `CLI failed with exit code ${result.exitCode}\nstdout: ${result.stdout}\nstderr: ${result.stderr}`).toBe(0);
@@ -45,13 +46,13 @@ describe('create-agents quickstart e2e', () => {
             'src',
             'src/inkeep.config.ts',
             `src/projects/${projectId}`,
-            'apps/manage-api',
-            'apps/run-api',
+            'apps/agents-api',
             'apps/mcp',
             'apps/manage-ui',
             '.env',
             'package.json',
-            'drizzle.config.ts',
+            'drizzle.manage.config.ts',
+            'drizzle.run.config.ts',
         ]);
         console.log('Directory structure verified');
         // Verify .env file has required variables
@@ -59,9 +60,9 @@ describe('create-agents quickstart e2e', () => {
         await verifyFile(path.join(projectDir, '.env'), [
             /ENVIRONMENT=development/,
             /OPENAI_API_KEY=test-openai-key/,
-            /DATABASE_URL=postgresql:\/\/appuser:password@localhost:5432\/inkeep_agents/,
-            /INKEEP_AGENTS_MANAGE_API_URL="http:\/\/127\.0\.0\.1:3002"/,
-            /INKEEP_AGENTS_RUN_API_URL="http:\/\/127\.0\.0\.1:3003"/,
+            /INKEEP_AGENTS_MANAGE_DATABASE_URL=postgresql:\/\/appuser:password@localhost:5432\/inkeep_agents/,
+            /INKEEP_AGENTS_RUN_DATABASE_URL=postgresql:\/\/appuser:password@localhost:5433\/inkeep_agents/,
+            /INKEEP_AGENTS_API_URL="http:\/\/127\.0\.0\.1:3002"/,
             /INKEEP_AGENTS_JWT_SIGNING_SECRET=\w+/, // Random secret should be generated
         ]);
         console.log('.env file verified');
@@ -69,13 +70,17 @@ describe('create-agents quickstart e2e', () => {
         console.log('Verifying inkeep.config.ts...');
         await verifyFile(path.join(projectDir, 'src/inkeep.config.ts'));
         console.log('inkeep.config.ts verified');
+        // Link to local monorepo packages (also runs pnpm install --no-frozen-lockfile)
+        console.log('Linking local monorepo packages...');
+        await linkLocalPackages(projectDir, monorepoRoot);
+        console.log('Local monorepo packages linked and dependencies installed');
         console.log('Setting up project in database');
         await runCommand('pnpm', ['setup-dev:cloud'], projectDir, 600000); // 10 minutes for CI (includes pnpm install, migrations, server startup, push)
         console.log('Project setup in database');
         console.log('Starting dev servers');
         // Start dev servers in background with output monitoring
         const devProcess = execa('pnpm', ['dev'], {
-            cwd: path.join(projectDir, 'apps/manage-api'),
+            cwd: path.join(projectDir, 'apps/agents-api'),
             env: {
                 ...process.env,
                 FORCE_COLOR: '0',
@@ -121,24 +126,10 @@ describe('create-agents quickstart e2e', () => {
             expect(pushResult.exitCode, `Push failed with exit code ${pushResult.exitCode}\nstdout: ${pushResult.stdout}\nstderr: ${pushResult.stderr}`).toBe(0);
             console.log('Testing API requests');
             // Test API requests
-            const response = await fetch(`${manageApiUrl}/tenants/default/projects/${projectId}`);
+            const response = await fetch(`${manageApiUrl}/manage/tenants/default/projects/${projectId}`);
             const data = await response.json();
             expect(data.data.tenantId).toBe('default');
             expect(data.data.id).toBe(projectId);
-            // Link to local monorepo packages
-            await linkLocalPackages(projectDir, monorepoRoot);
-            const pushResultLocal = await runCommand('pnpm', [
-                'inkeep',
-                'push',
-                '--project',
-                `src/projects/${projectId}`,
-                '--config',
-                'src/inkeep.config.ts',
-            ], projectDir, 30000);
-            expect(pushResultLocal.exitCode, `Push with local packages failed with exit code ${pushResultLocal.exitCode}\nstdout: ${pushResultLocal.stdout}\nstderr: ${pushResultLocal.stderr}`).toBe(0);
-            // Test that the project works with local packages
-            const responseLocal = await fetch(`${manageApiUrl}/tenants/default/projects/${projectId}`);
-            expect(responseLocal.status).toBe(200);
         }
         catch (error) {
             console.error('Test failed with error:', error);

package/dist/__tests__/e2e/utils.js

@@ -138,8 +138,7 @@ export async function verifyDirectoryStructure(baseDir, expectedPaths) {
 export async function linkLocalPackages(projectDir, monorepoRoot) {
     const packageJsonPaths = [
         path.join(projectDir, 'package.json'),
-        path.join(projectDir, 'apps/manage-api/package.json'),
-        path.join(projectDir, 'apps/run-api/package.json'),
+        path.join(projectDir, 'apps/agents-api/package.json'),
     ];
     const packageJsons = {};
     for (const packageJsonPath of packageJsonPaths) {
@@ -149,8 +148,7 @@ export async function linkLocalPackages(projectDir, monorepoRoot) {
     const inkeepPackages = {
         '@inkeep/agents-sdk': `link:${path.join(monorepoRoot, 'packages/agents-sdk')}`,
         '@inkeep/agents-core': `link:${path.join(monorepoRoot, 'packages/agents-core')}`,
-        '@inkeep/agents-manage-api': `link:${path.join(monorepoRoot, 'agents-manage-api')}`,
-        '@inkeep/agents-run-api': `link:${path.join(monorepoRoot, 'agents-run-api')}`,
+        '@inkeep/agents-api': `link:${path.join(monorepoRoot, 'agents-api')}`,
         '@inkeep/agents-cli': `link:${path.join(monorepoRoot, 'agents-cli')}`,
     };
     // Replace package versions with local links

package/dist/index.js

@@ -15,6 +15,7 @@ program
     .option('--local-templates-prefix <local-templates-prefix>', 'Local prefix for project templates')
     .option('--skip-inkeep-cli', 'Skip installing Inkeep CLI globally')
     .option('--skip-inkeep-mcp', 'Skip installing Inkeep MCP server')
+    .option('--skip-install', 'Skip installing dependencies')
     .parse();
 async function main() {
     const options = program.opts();
@@ -31,6 +32,7 @@ async function main() {
             localTemplatesPrefix: options.localTemplatesPrefix,
             skipInkeepCli: options.skipInkeepCli,
             skipInkeepMcp: options.skipInkeepMcp,
+            skipInstall: options.skipInstall,
         });
     }
     catch (error) {

package/dist/templates.js

@@ -14,6 +14,7 @@ export async function cloneTemplate(templatePath, targetPath, replacements) {
         }
     }
     catch (_error) {
+        console.error('Error cloning template:', _error);
         process.exit(1);
     }
 }

package/dist/utils.d.ts

@@ -45,6 +45,7 @@ export declare const createAgents: (args?: {
     localTemplatesPrefix?: string;
     skipInkeepCli?: boolean;
     skipInkeepMcp?: boolean;
+    skipInstall?: boolean;
 }) => Promise<void>;
 export declare function createCommand(dirName?: string, options?: any): Promise<void>;
 export declare function addInkeepMcp(): Promise<void>;

package/dist/utils.js

@@ -32,8 +32,7 @@ const DIRECTORY_VALIDATION = {
 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';
+const agentsApiPort = '3002';
 export const defaultGoogleModelConfigurations = {
     base: {
         model: GOOGLE_MODELS.GEMINI_2_5_FLASH,
@@ -68,7 +67,7 @@ export const defaultAnthropicModelConfigurations = {
     },
 };
 export const createAgents = async (args = {}) => {
-    let { dirName, openAiKey, anthropicKey, googleKey, azureKey, template, customProjectId, disableGit, localAgentsPrefix, localTemplatesPrefix, skipInkeepCli, skipInkeepMcp, } = args;
+    let { dirName, openAiKey, anthropicKey, googleKey, azureKey, template, customProjectId, disableGit, localAgentsPrefix, localTemplatesPrefix, skipInkeepCli, skipInkeepMcp, skipInstall, } = args;
     const tenantId = 'default';
     let projectId;
     let templateName;
@@ -342,8 +341,10 @@ export const createAgents = async (args = {}) => {
         }
         s.message('Creating inkeep.config.ts...');
         await createInkeepConfig(config);
-        s.message('Installing dependencies (this may take a while)...');
-        await installDependencies();
+        if (!skipInstall) {
+            s.message('Installing dependencies (this may take a while)...');
+            await installDependencies();
+        }
         if (!config.disableGit) {
             await initializeGit();
         }
@@ -383,8 +384,7 @@ export const createAgents = async (args = {}) => {
             `  pnpm setup   # Setup project in database\n` +
             `  pnpm dev     # Start development servers\n\n` +
             `${color.yellow('Available services:')}\n` +
-            `  • Manage API: http://127.0.0.1:3002\n` +
-            `  • Run API: http://127.0.0.1:3003\n` +
+            `  • Agents API: http://127.0.0.1:3002\n` +
             `  • Manage UI: Available with management API\n` +
             `\n${color.yellow('Configuration:')}\n` +
             `  • Edit .env for environment variables\n` +
@@ -424,8 +424,11 @@ async function createEnvironmentFiles(config) {
     const envContent = `# Environment
 ENVIRONMENT=development
 
-# Database
-DATABASE_URL=postgresql://appuser:password@localhost:5432/inkeep_agents
+# Database Configuration (Split Database Setup)
+# Management entities database uses DoltgreSQL on port 5432 for version control features
+INKEEP_AGENTS_MANAGE_DATABASE_URL=postgresql://appuser:password@localhost:5432/inkeep_agents
+# Runtime entities database uses PostgreSQL on port 5433 for runtime operations
+INKEEP_AGENTS_RUN_DATABASE_URL=postgresql://appuser:password@localhost:5433/inkeep_agents
 
 # AI Provider Keys  
 ANTHROPIC_API_KEY=${config.anthropicKey || 'your-anthropic-key-here'}
@@ -436,12 +439,10 @@ AZURE_API_KEY=${config.azureKey || 'your-azure-key-here'}
 # Inkeep API URLs
 # Internal URLs (server-side, Docker internal networking)
 # Using 127.0.0.1 instead of localhost to avoid IPv6/IPv4 resolution issues
-INKEEP_AGENTS_MANAGE_API_URL="http://127.0.0.1:3002"
-INKEEP_AGENTS_RUN_API_URL="http://127.0.0.1:3003"
+INKEEP_AGENTS_API_URL="http://127.0.0.1:3002"
 
 # Public URLs (client-side, browser accessible)
-PUBLIC_INKEEP_AGENTS_MANAGE_API_URL="http://127.0.0.1:3002"
-PUBLIC_INKEEP_AGENTS_RUN_API_URL="http://127.0.0.1:3003"
+PUBLIC_INKEEP_AGENTS_API_URL="http://127.0.0.1:3002"
 
 # SigNoz Configuration
 SIGNOZ_URL=your-signoz-url-here
@@ -470,6 +471,8 @@ DEFAULT_PROJECT_ID=${config.projectId}
 BETTER_AUTH_SECRET=${betterAuthSecret}
 DISABLE_AUTH=true
 
+ENABLE_AUTHZ=false
+
 `;
     await fs.writeFile('.env', envContent);
 }
@@ -478,13 +481,10 @@ async function createInkeepConfig(config) {
     
 const config = defineConfig({
   tenantId: "${config.tenantId}",
-  agentsManageApi: {
+  agentsApi: {
     // Using 127.0.0.1 instead of localhost to avoid IPv6/IPv4 resolution issues
     url: 'http://127.0.0.1:3002',
   },
-  agentsRunApi: {
-    url: 'http://127.0.0.1:3003',
-  },
 });
     
 export default config;`;
@@ -583,11 +583,8 @@ async function isPortAvailable(port) {
  */
 function displayPortConflictError(unavailablePorts) {
     let errorMessage = '';
-    if (unavailablePorts.runApi) {
-        errorMessage += `${color.red(`Run API port ${runApiPort} is already in use`)}\n`;
-    }
-    if (unavailablePorts.manageApi) {
-        errorMessage += `${color.red(`Manage API port ${manageApiPort} is already in use`)}\n`;
+    if (unavailablePorts.agentsApi) {
+        errorMessage += `${color.red(`Agents API port ${agentsApiPort} is already in use`)}\n`;
     }
     p.cancel(`\n${color.red('✗ Port conflicts detected')}\n\n` +
         `${errorMessage}\n` +
@@ -598,14 +595,10 @@ function displayPortConflictError(unavailablePorts) {
  * Check port availability and display errors if needed
  */
 async function checkPortsAvailability() {
-    const [runApiAvailable, manageApiAvailable] = await Promise.all([
-        isPortAvailable(Number(runApiPort)),
-        isPortAvailable(Number(manageApiPort)),
-    ]);
-    if (!runApiAvailable || !manageApiAvailable) {
+    const [agentsApiAvailable] = await Promise.all([isPortAvailable(Number(agentsApiPort))]);
+    if (!agentsApiAvailable) {
         displayPortConflictError({
-            runApi: !runApiAvailable,
-            manageApi: !manageApiAvailable,
+            agentsApi: !agentsApiAvailable,
         });
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/create-agents",
-  "version": "0.41.2",
+  "version": "0.43.0",
   "description": "Create an Inkeep Agent Framework project",
   "type": "module",
   "bin": {
@@ -33,7 +33,7 @@
     "degit": "^2.8.4",
     "fs-extra": "^11.0.0",
     "picocolors": "^1.0.0",
-    "@inkeep/agents-core": "0.41.2"
+    "@inkeep/agents-core": "0.43.0"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",