@inkeep/create-agents 0.0.0-dev-20260224090320 → 0.0.0-dev-20260224144914

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

@@ -62,13 +62,15 @@ describe('create-agents quickstart e2e', () => {
         ]);
         console.log('Directory structure verified');
         // Verify .env file has required variables
+        // After createEnvironmentFiles(), .env is a copy of .env.example with CLI-prompted
+        // values injected. Secrets (JWT keys, signing secret, etc.) remain as placeholders
+        // until setup-dev runs generateSecrets().
         console.log('Verifying .env file...');
         await verifyFile(path.join(projectDir, '.env'), [
             /ENVIRONMENT=development/,
             /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+/,
+            /INKEEP_AGENTS_API_URL=http:\/\/localhost:3002/,
         ]);
         console.log('.env file verified');
         // Verify inkeep.config.ts was created
@@ -167,7 +169,7 @@ describe('create-agents quickstart e2e', () => {
             try {
                 const signupRes = await fetch(`${manageApiUrl}/api/auth/sign-up/email`, {
                     method: 'POST',
-                    headers: { 'Content-Type': 'application/json', Origin: manageApiUrl },
+                    headers: { 'Content-Type': 'application/json', Origin: dashboardApiUrl },
                     body: JSON.stringify({
                         email: 'admin@example.com',
                         password: 'adminADMIN!@12',
@@ -211,7 +213,7 @@ describe('create-agents quickstart e2e', () => {
             try {
                 const loginTestRes = await fetch(`${manageApiUrl}/api/auth/sign-in/email`, {
                     method: 'POST',
-                    headers: { 'Content-Type': 'application/json', Origin: manageApiUrl },
+                    headers: { 'Content-Type': 'application/json', Origin: dashboardApiUrl },
                     body: JSON.stringify({
                         email: 'admin@example.com',
                         password: 'adminADMIN!@12',

package/dist/__tests__/e2e/utils.js

@@ -222,11 +222,15 @@ export async function waitForServerReady(url, timeout) {
 }
 export async function startDashboardServer(projectDir, env = {}) {
     const manageUiPkgJson = path.join(projectDir, 'node_modules/@inkeep/agents-manage-ui/package.json');
-    const manageUiRoot = path.dirname(manageUiPkgJson);
+    // Resolve symlinks so linked packages (link:) point to the actual monorepo directory
+    const manageUiRoot = await fs.realpath(path.dirname(manageUiPkgJson));
     const standaloneDir = path.join(manageUiRoot, '.next/standalone/agents-manage-ui');
     const serverEntry = path.join(standaloneDir, 'server.js');
     if (!(await fs.pathExists(serverEntry))) {
-        throw new Error(`Dashboard standalone server not found at ${serverEntry}`);
+        const originalPath = path.dirname(manageUiPkgJson);
+        throw new Error(`Dashboard standalone server not found at ${serverEntry}` +
+            (originalPath !== manageUiRoot ? ` (symlink resolved from ${originalPath})` : '') +
+            `. Ensure the package is built with 'output: standalone' (run turbo build).`);
     }
     const child = fork(serverEntry, [], {
         cwd: standaloneDir,

package/dist/__tests__/utils.test.js

@@ -29,6 +29,34 @@ const mockSpinner = {
     stop: vi.fn().mockReturnThis(),
     message: vi.fn().mockReturnThis(),
 };
+const mockEnvExample = [
+    'ENVIRONMENT=development',
+    'NODE_ENV=development',
+    'LOG_LEVEL=info',
+    '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://localhost:3002',
+    'PUBLIC_INKEEP_AGENTS_API_URL=http://localhost:3002',
+    'TENANT_ID=default',
+    'ANTHROPIC_API_KEY=',
+    'OPENAI_API_KEY=',
+    'GOOGLE_GENERATIVE_AI_API_KEY=',
+    'AZURE_API_KEY=',
+    'DEFAULT_PROJECT_ID=',
+    'NANGO_SECRET_KEY=',
+    'NANGO_SERVER_URL=http://localhost:3050',
+    'SIGNOZ_URL=http://localhost:3080',
+    'OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://localhost:14318/v1/traces',
+    'INKEEP_AGENTS_MANAGE_UI_USERNAME=admin@example.com',
+    'INKEEP_AGENTS_MANAGE_UI_PASSWORD=adminADMIN!@12',
+    'BETTER_AUTH_SECRET=your-secret-key-change-in-production',
+    'SPICEDB_ENDPOINT=localhost:50051',
+    'SPICEDB_PRESHARED_KEY=dev-secret-key',
+    'INKEEP_AGENTS_MANAGE_API_BYPASS_SECRET=test-bypass-secret-for-ci',
+    '# INKEEP_AGENTS_JWT_SIGNING_SECRET=',
+    '# INKEEP_AGENTS_TEMP_JWT_PRIVATE_KEY=',
+    '# INKEEP_AGENTS_TEMP_JWT_PUBLIC_KEY=',
+].join('\n');
 describe('createAgents - Template and Project ID Logic', () => {
     let processExitSpy;
     let processChdirSpy;
@@ -64,6 +92,7 @@ describe('createAgents - Template and Project ID Logic', () => {
         vi.mocked(fs.writeFile).mockResolvedValue(undefined);
         vi.mocked(fs.writeJson).mockResolvedValue(undefined);
         vi.mocked(fs.readJson).mockResolvedValue({});
+        vi.mocked(fs.readFile).mockResolvedValue(mockEnvExample);
         vi.mocked(fs.mkdir).mockResolvedValue(undefined);
         vi.mocked(fs.remove).mockResolvedValue(undefined);
         // Mock templates
@@ -331,6 +360,49 @@ describe('createAgents - Template and Project ID Logic', () => {
             ]));
         });
     });
+    describe('Environment file generation', () => {
+        it('should contain INKEEP_AGENTS_MANAGE_API_BYPASS_SECRET from .env.example', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                openAiKey: 'test-openai-key',
+                anthropicKey: 'test-anthropic-key',
+            });
+            expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('INKEEP_AGENTS_MANAGE_API_BYPASS_SECRET=test-bypass-secret-for-ci'));
+        });
+        it('should inject CLI-prompted API keys into the .env', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                openAiKey: 'sk-openai-123',
+                anthropicKey: 'sk-ant-456',
+                googleKey: 'google-789',
+                azureKey: 'azure-abc',
+            });
+            expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('ANTHROPIC_API_KEY=sk-ant-456'));
+            expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('OPENAI_API_KEY=sk-openai-123'));
+            expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('GOOGLE_GENERATIVE_AI_API_KEY=google-789'));
+            expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('AZURE_API_KEY=azure-abc'));
+        });
+        it('should use localhost URLs (not 127.0.0.1)', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                openAiKey: 'test-key',
+                anthropicKey: 'test-key',
+            });
+            expect(fs.writeFile).toHaveBeenCalledWith('.env', expect.stringContaining('PUBLIC_INKEEP_AGENTS_API_URL=http://localhost:3002'));
+        });
+        it('should not generate any secrets inline', async () => {
+            await createAgents({
+                dirName: 'test-dir',
+                openAiKey: 'test-key',
+                anthropicKey: 'test-key',
+            });
+            const envWriteCall = vi.mocked(fs.writeFile).mock.calls.find((call) => call[0] === '.env');
+            const envContent = envWriteCall?.[1];
+            expect(envContent).toContain('BETTER_AUTH_SECRET=your-secret-key-change-in-production');
+            expect(envContent).toContain('INKEEP_AGENTS_MANAGE_UI_PASSWORD=adminADMIN!@12');
+            expect(envContent).toContain('# INKEEP_AGENTS_JWT_SIGNING_SECRET=');
+        });
+    });
     describe('Security - Password input for API keys', () => {
         it('should use password input instead of text input for API keys', async () => {
             // Mock the select to return 'anthropic' to trigger the API key prompt
@@ -388,9 +460,9 @@ function setupDefaultMocks() {
     vi.mocked(fs.writeFile).mockResolvedValue(undefined);
     vi.mocked(fs.writeJson).mockResolvedValue(undefined);
     vi.mocked(fs.readJson).mockResolvedValue({});
+    vi.mocked(fs.readFile).mockResolvedValue(mockEnvExample);
     vi.mocked(getAvailableTemplates).mockResolvedValue(['event-planner', 'chatbot', 'data-analysis']);
     vi.mocked(cloneTemplate).mockResolvedValue(undefined);
     vi.mocked(cloneTemplateLocal).mockResolvedValue(undefined);
-    // Reset mockExecAsync for tests that clear mocks
     mockExecAsync.mockResolvedValue({ stdout: '', stderr: '' });
 }

package/dist/utils.js

@@ -1,5 +1,4 @@
 import { exec } from 'node:child_process';
-import crypto from 'node:crypto';
 import os from 'node:os';
 import path from 'node:path';
 import { promisify } from 'node:util';
@@ -397,8 +396,8 @@ export const createAgents = async (args = {}) => {
             `   pnpm setup-dev\n` +
             `   pnpm dev\n\n` +
             `${color.yellow('2. Explore:')}\n` +
-            `   • Dashboard:  http://127.0.0.1:3000\n` +
-            `   • Agents API: http://127.0.0.1:3002\n\n` +
+            `   • Dashboard:  http://localhost:3000\n` +
+            `   • Agents API: http://localhost:3002\n\n` +
             `${color.yellow('3. Customize:')}\n` +
             `   • Edit your agents in src/projects/\n` +
             `   • Use 'inkeep push' to apply`, 'Next steps 🚀');
@@ -413,80 +412,29 @@ async function createWorkspaceStructure() {
     await fs.ensureDir(`src`);
 }
 async function createEnvironmentFiles(config) {
-    // Convert to forward slashes for cross-platform SQLite URI compatibility
-    const jwtSigningSecret = crypto.randomBytes(32).toString('hex');
-    const betterAuthSecret = crypto.randomBytes(32).toString('hex');
-    const manageUiPassword = crypto.randomBytes(6).toString('base64url');
-    // Generate RSA key pair for temporary JWT tokens
-    let tempJwtPrivateKey = '';
-    let tempJwtPublicKey = '';
+    let envExampleContent;
     try {
-        const { generateKeyPairSync } = await import('node:crypto');
-        const { privateKey, publicKey } = generateKeyPairSync('rsa', {
-            modulusLength: 2048,
-            publicKeyEncoding: { type: 'spki', format: 'pem' },
-            privateKeyEncoding: { type: 'pkcs8', format: 'pem' },
-        });
-        tempJwtPrivateKey = Buffer.from(privateKey).toString('base64');
-        tempJwtPublicKey = Buffer.from(publicKey).toString('base64');
+        envExampleContent = await fs.readFile('.env.example', 'utf-8');
     }
     catch {
-        console.warn('Warning: Failed to generate JWT keys. Playground may not work.');
-        console.warn('You can manually generate keys later with: pnpm run generate-jwt-keys');
+        throw new Error('Could not read .env.example from the template. The template may be corrupted — try running the command again.');
     }
-    const envContent = `# Environment
-ENVIRONMENT=development
-
-# 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'}
-OPENAI_API_KEY=${config.openAiKey || 'your-openai-key-here'}
-GOOGLE_GENERATIVE_AI_API_KEY=${config.googleKey || 'your-google-key-here'}
-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_API_URL="http://127.0.0.1:3002"
-
-# Public URLs (client-side, browser accessible)
-PUBLIC_INKEEP_AGENTS_API_URL="http://127.0.0.1:3002"
-
-# SigNoz Configuration
-SIGNOZ_URL=your-signoz-url-here
-SIGNOZ_API_KEY=your-signoz-api-key-here
-
-# OTEL Configuration
-OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://ingest.us.signoz.cloud:443/v1/traces
-OTEL_EXPORTER_OTLP_TRACES_HEADERS="signoz-ingestion-key=<your-ingestion-key>"
-
-# Nango Configuration
-NANGO_SECRET_KEY=
-
-# JWT Signing Secret
-INKEEP_AGENTS_JWT_SIGNING_SECRET=${jwtSigningSecret}
-
-# Temporary JWT Keys for Playground
-INKEEP_AGENTS_TEMP_JWT_PRIVATE_KEY=${tempJwtPrivateKey}
-INKEEP_AGENTS_TEMP_JWT_PUBLIC_KEY=${tempJwtPublicKey}
-
-# initial project information
-DEFAULT_PROJECT_ID=${config.projectId}
-
-# Auth Configuration
-INKEEP_AGENTS_MANAGE_UI_USERNAME=admin@example.com
-INKEEP_AGENTS_MANAGE_UI_PASSWORD=${manageUiPassword}
-BETTER_AUTH_SECRET=${betterAuthSecret}
-SPICEDB_ENDPOINT=localhost:50051
-SPICEDB_PRESHARED_KEY=dev-secret-key
-
-`;
-    await fs.writeFile('.env', envContent);
+    const lines = envExampleContent.split('\n');
+    const injections = {
+        ANTHROPIC_API_KEY: config.anthropicKey || '',
+        OPENAI_API_KEY: config.openAiKey || '',
+        GOOGLE_GENERATIVE_AI_API_KEY: config.googleKey || '',
+        AZURE_API_KEY: config.azureKey || '',
+        DEFAULT_PROJECT_ID: config.projectId,
+    };
+    for (let i = 0; i < lines.length; i++) {
+        for (const [varName, value] of Object.entries(injections)) {
+            if (lines[i].startsWith(`${varName}=`)) {
+                lines[i] = `${varName}=${value}`;
+            }
+        }
+    }
+    await fs.writeFile('.env', lines.join('\n'));
 }
 async function createInkeepConfig(config) {
     const inkeepConfig = `import { defineConfig } from '@inkeep/agents-cli/config';
@@ -494,8 +442,7 @@ async function createInkeepConfig(config) {
 const config = defineConfig({
   tenantId: "${config.tenantId}",
   agentsApi: {
-    // Using 127.0.0.1 instead of localhost to avoid IPv6/IPv4 resolution issues
-    url: 'http://127.0.0.1:3002',
+    url: 'http://localhost:3002',
   },
 });
     

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/create-agents",
-  "version": "0.0.0-dev-20260224090320",
+  "version": "0.0.0-dev-20260224144914",
   "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.0.0-dev-20260224090320"
+    "@inkeep/agents-core": "0.0.0-dev-20260224144914"
   },
   "devDependencies": {
     "@types/degit": "^2.8.6",
@@ -67,8 +67,8 @@
     "test": "vitest --run src/__tests__ --exclude src/__tests__/e2e/** --passWithNoTests",
     "test:watch": "vitest src/__tests__ --exclude src/__tests__/e2e/**",
     "test:unit": "vitest --run src/__tests__ --exclude src/__tests__/e2e/**",
-    "test:e2e": "vitest --run src/__tests__/e2e",
-    "test:e2e:watch": "vitest src/__tests__/e2e",
+    "test:e2e": "turbo run build --filter=@inkeep/create-agents --filter=@inkeep/agents-api --filter=@inkeep/agents-cli --filter=@inkeep/agents-manage-ui && vitest --run src/__tests__/e2e",
+    "test:e2e:watch": "turbo run build --filter=@inkeep/create-agents --filter=@inkeep/agents-api --filter=@inkeep/agents-cli --filter=@inkeep/agents-manage-ui && vitest src/__tests__/e2e",
     "test:all": "vitest --run --passWithNoTests",
     "typecheck": "tsc --noEmit"
   }