create-bk-agent 0.20.1 → 0.21.0

package/README.md

@@ -1,5 +1,7 @@
 # create-bk-agent
 
+**Status: stable** — works and is maintained; will not be expanded during the pilot phase.
+
 Scaffold a new [BackendKit agent](https://github.com/BackendKit-labs/backendkit-agent-framework) project in seconds — or add capabilities to an existing one.
 
 ## Create a project

package/dist/src/index.js

@@ -65,6 +65,7 @@ function describeChoices(choices) {
         'mcp-stdio': 'MCP Server (stdio)',
         hybrid: 'REPL + MCP Server',
         library: 'Library',
+        web: 'Web Server (chat + kanban)',
     };
     const archLabel = arch[choices.architecture] ?? choices.architecture;
     if (!choices.deployMode)
@@ -83,6 +84,17 @@ function buildNextSteps(choices) {
         return ['Implement your LLM provider in src/index.ts', 'npm run dev'];
     // Enterprise — local LLM + RAG
     if (arch === 'enterprise') {
+        if (mode === 'web') {
+            return [
+                'Make sure Ollama is running:  ollama serve',
+                'Pull model:                   ollama pull llama3.2',
+                'Review vault path in .env (VAULT_PATH)',
+                'npm run dev              # indexes vault + starts server on :4001',
+                '# Chat:    http://localhost:4001/',
+                '# Kanban:  http://localhost:4001/#kanban',
+                '# Monitor: ws://localhost:4001/monitor',
+            ];
+        }
         return [
             'Make sure Ollama is running:  ollama serve',
             'Pull required models:         ollama pull llama3.2 && ollama pull nomic-embed-text',

package/dist/src/prompts.js

@@ -45,7 +45,7 @@ const SKILL_PACK_CHOICES = [
     { title: p('Go', 24) + 'go test, golangci-lint', value: 'go' },
     { title: p('Docker / K8s', 24) + 'docker, kubectl, helm', value: 'docker' },
 ];
-const DEPLOY_MODE_CHOICES = [
+const DEPLOY_MODE_CHOICES_BASE = [
     {
         title: p('Terminal REPL', 28) + 'Humans type requests, agent responds in the terminal',
         value: 'repl',
@@ -68,6 +68,15 @@ const DEPLOY_MODE_CHOICES = [
         value: 'library',
     },
 ];
+const WEB_DEPLOY_CHOICE = {
+    title: p('Web server', 28) + 'WebSocket chat + kanban monitor UI on port 4001',
+    value: 'web',
+    description: 'Serves @backendkit-labs/agent-web with all 6 enterprise departments',
+};
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const deployChoices = (_prev, v) => v.architecture === 'enterprise'
+    ? [...DEPLOY_MODE_CHOICES_BASE, WEB_DEPLOY_CHOICE]
+    : DEPLOY_MODE_CHOICES_BASE;
 const PROVIDER_CHOICES = [
     { title: p('Anthropic (Claude)', 32) + 'claude-sonnet-4-6 recommended', value: 'anthropic' },
     { title: p('OpenAI', 32) + 'gpt-4o recommended', value: 'openai' },
@@ -115,7 +124,7 @@ async function askQuestions(defaultName) {
             type: whenDeploy,
             name: 'deployMode',
             message: 'How will this agent be used?',
-            choices: DEPLOY_MODE_CHOICES,
+            choices: deployChoices,
             initial: 0,
         },
         // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/dist/src/scaffold.js

@@ -77,6 +77,11 @@ const DEPLOY_SCRIPTS = {
         delete s['server'];
     },
     // hybrid: keep both dev (REPL) and server (MCP) — no changes
+    web: (s) => {
+        s['dev'] = 'ts-node src/server.ts';
+        s['start'] = 'node dist/server.js';
+        delete s['server'];
+    },
     library: (s) => {
         delete s['dev'];
         delete s['server'];
@@ -84,6 +89,7 @@ const DEPLOY_SCRIPTS = {
     },
 };
 const MCP_DEPLOY_MODES = ['mcp-http', 'mcp-stdio', 'hybrid'];
+const WEB_DEPLOY_MODES = ['web'];
 function patchPackageJson(dir, projectName, deployMode) {
     const pkgPath = path.join(dir, 'package.json');
     if (!fs.existsSync(pkgPath))
@@ -98,6 +104,10 @@ function patchPackageJson(dir, projectName, deployMode) {
         pkg.dependencies ??= {};
         pkg.dependencies['@backendkit-labs/mcp-server'] ??= '^0.15.0';
     }
+    if (deployMode && WEB_DEPLOY_MODES.includes(deployMode)) {
+        pkg.dependencies ??= {};
+        pkg.dependencies['@backendkit-labs/agent-web'] ??= '^0.1.0';
+    }
     fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
 }
 // ── Write .env stub ───────────────────────────────────────────────────────────
@@ -165,10 +175,10 @@ function scaffold(choices, targetDir) {
     // 2. Deploy layer — overlaid on top of base (layered architectures only)
     if (isLayered && choices.deployMode && choices.deployMode !== 'library') {
         const deployDir = path.join(DEPLOY_DIR, choices.deployMode);
-        if (!fs.existsSync(deployDir)) {
-            throw new Error(`Deploy template not found: ${choices.deployMode} (in ${deployDir})`);
+        if (fs.existsSync(deployDir)) {
+            copyDir(deployDir, targetDir);
         }
-        copyDir(deployDir, targetDir);
+        // No directory = base template already covers this mode
     }
     // 3. Skill packs — appended to engine.ts
     for (const pack of choices.skillPacks) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-bk-agent",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "description": "Create a new BackendKit agent project",
   "main": "dist/src/index.js",
   "bin": {