@inkeep/create-agents 0.29.6 → 0.29.7

package/dist/utils.js

@@ -29,6 +29,8 @@ const DIRECTORY_VALIDATION = {
     },
 };
 const execAsync = promisify(exec);
+const manageApiPort = '3002';
+const runApiPort = '3003';
 export const defaultGoogleModelConfigurations = {
     base: {
         model: GOOGLE_MODELS.GEMINI_2_5_FLASH,
@@ -65,8 +67,6 @@ export const defaultAnthropicModelConfigurations = {
 export const createAgents = async (args = {}) => {
     let { dirName, openAiKey, anthropicKey, googleKey, template, customProjectId, disableGit } = args;
     const tenantId = 'default';
-    const manageApiPort = '3002';
-    const runApiPort = '3003';
     let projectId;
     let templateName;
     if (customProjectId) {
@@ -215,8 +215,6 @@ export const createAgents = async (args = {}) => {
             openAiKey,
             anthropicKey,
             googleKey,
-            manageApiPort: manageApiPort || '3002',
-            runApiPort: runApiPort || '3003',
             modelSettings: defaultModelSettings,
             customProject: !!customProjectId,
             disableGit: disableGit,
@@ -264,8 +262,8 @@ export const createAgents = async (args = {}) => {
             `  cd ${dirName}\n` +
             `  pnpm dev     # Start development servers\n\n` +
             `${color.yellow('Available services:')}\n` +
-            `  • Manage API: http://localhost:${manageApiPort || '3002'}\n` +
-            `  • Run API: http://localhost:${runApiPort || '3003'}\n` +
+            `  • Manage API: http://localhost:3002\n` +
+            `  • Run API: http://localhost:3003\n` +
             `  • Manage UI: Available with management API\n` +
             `\n${color.yellow('Configuration:')}\n` +
             `  • Edit .env for environment variables\n` +
@@ -353,7 +351,58 @@ async function initializeGit() {
         console.error('Error initializing git:', error instanceof Error ? error.message : 'Unknown error');
     }
 }
+/**
+ * Check if a port is available
+ */
+async function isPortAvailable(port) {
+    const net = await import('node:net');
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => {
+            resolve(false);
+        });
+        server.once('listening', () => {
+            server.close();
+            resolve(true);
+        });
+        server.listen(port);
+    });
+}
+/**
+ * Display port conflict error and exit
+ */
+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`;
+    }
+    p.cancel(`\n${color.red('✗ Port conflicts detected')}\n\n` +
+        `${errorMessage}\n` +
+        `${color.yellow('Please free up the ports and try again.')}\n`);
+    process.exit(1);
+}
+/**
+ * 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) {
+        displayPortConflictError({
+            runApi: !runApiAvailable,
+            manageApi: !manageApiAvailable,
+        });
+    }
+}
 async function setupProjectInDatabase(config) {
+    // Proactively check if ports are available BEFORE starting servers
+    await checkPortsAvailability();
+    // Start development servers in background
     const { spawn } = await import('node:child_process');
     const devProcess = spawn('pnpm', ['dev:apis'], {
         stdio: ['pipe', 'pipe', 'pipe'],
@@ -363,6 +412,31 @@ async function setupProjectInDatabase(config) {
         windowsHide: true,
     });
     await new Promise((resolve) => setTimeout(resolve, 5000));
+    // Track if port errors occur during startup (as a safety fallback)
+    const portErrors = { runApi: false, manageApi: false };
+    // Regex patterns for detecting port errors in output
+    const portErrorPatterns = {
+        runApi: new RegExp(`(EADDRINUSE.*:${runApiPort}|port ${runApiPort}.*already|Port ${runApiPort}.*already|run-api.*Error.*Port)`, 'i'),
+        manageApi: new RegExp(`(EADDRINUSE.*:${manageApiPort}|port ${manageApiPort}.*already|Port ${manageApiPort}.*already|manage-api.*Error.*Port)`, 'i'),
+    };
+    // Monitor output for port errors (fallback in case ports become unavailable between check and start)
+    const checkForPortErrors = (data) => {
+        const output = data.toString();
+        if (portErrorPatterns.runApi.test(output)) {
+            portErrors.runApi = true;
+        }
+        if (portErrorPatterns.manageApi.test(output)) {
+            portErrors.manageApi = true;
+        }
+    };
+    devProcess.stdout.on('data', checkForPortErrors);
+    // Give servers time to start
+    await new Promise((resolve) => setTimeout(resolve, 3000));
+    // Check if any port errors occurred during startup
+    if (portErrors.runApi || portErrors.manageApi) {
+        displayPortConflictError(portErrors);
+    }
+    // Run inkeep push
     try {
         await execAsync(`pnpm inkeep push --project src/projects/${config.projectId} --config src/inkeep.config.ts`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/create-agents",
-  "version": "0.29.6",
+  "version": "0.29.7",
   "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.29.6"
+    "@inkeep/agents-core": "0.29.7"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",