create-bk-agent 0.15.0 → 0.16.0

package/README.md

@@ -26,13 +26,25 @@ Installing dependencies...
 
 ## Templates
 
-| Template | Use case |
-|----------|---------|
-| `coding` | Coding assistant — edit files, run commands, search code |
-| `domain-agent` | Multi-agent system — orchestrator + domain specialists |
-| `autonomous` | Autonomous agent — cron schedules, webhooks, events |
-| `mcp-server` | MCP server — expose tools via Model Context Protocol |
-| `minimal` | Bare engine — full control over everything |
+### `coding` — complete, ready to run
+10 specialized agents (backend, frontend, QA, security, architecture…) and all
+coding tools (read/write files, run commands, git, search) are already configured.
+Add your API key, describe your project in `AGENT.md`, and it works out of the box.
+**Choose this when you want a coding assistant, not when you want to build one.**
+
+### `domain-agent` — blank multi-agent architecture
+Orchestrator + specialists pattern with no pre-built agents or tools. You define
+the agents and tools for your specific domain (Docker, AWS, databases, APIs, etc.).
+The framework handles orchestration, delegation, and parallel execution.
+**Choose this when you are building a new type of agent from scratch.**
+
+| Template | What it gives you | You provide |
+|----------|------------------|-------------|
+| `coding` | 10 agents + all coding tools | API key + `AGENT.md` |
+| `domain-agent` | Orchestration skeleton | Agents + tools for your domain |
+| `autonomous` | Trigger system (cron / webhook / event) | Agent logic |
+| `mcp-server` | MCP server boilerplate | Tools to expose |
+| `minimal` | Bare engine | Everything |
 
 ## Providers
 

package/dist/src/prompts.js

@@ -6,11 +6,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.askQuestions = askQuestions;
 const prompts_1 = __importDefault(require("prompts"));
 const TEMPLATES = [
-    { title: 'coding', value: 'coding', description: 'Coding assistant — edit files, run commands, search code' },
-    { title: 'domain-agent', value: 'domain-agent', description: 'Multi-agent — orchestrator + domain specialists (e.g. docker, AWS)' },
-    { title: 'autonomous', value: 'autonomous', description: 'Autonomous — activates on cron schedules, webhooks, events' },
-    { title: 'mcp-server', value: 'mcp-server', description: 'MCP server — expose tools via Model Context Protocol' },
-    { title: 'minimal', value: 'minimal', description: 'Minimal — bare engine, full control over everything' },
+    { title: 'coding', value: 'coding', description: '10 agents + all coding tools included. Ready to run — improve UI and extend' },
+    { title: 'domain-agent', value: 'domain-agent', description: 'Blank multi-agent architecture. You define agents and tools for your domain' },
+    { title: 'autonomous', value: 'autonomous', description: 'Event-driven agent — cron schedules, webhooks, custom events' },
+    { title: 'mcp-server', value: 'mcp-server', description: 'MCP server — expose your tools to Claude Desktop / Cursor / VS Code' },
+    { title: 'minimal', value: 'minimal', description: 'Bare engine — full control, bring your own agents and tools' },
 ];
 const PROVIDERS = [
     { title: 'Anthropic (Claude)', value: 'anthropic', description: 'claude-sonnet-4-6 recommended' },

package/package.json

@@ -1,33 +1,33 @@
-{
-  "name": "create-bk-agent",
-  "version": "0.15.0",
-  "description": "Create a new BackendKit agent project",
-  "main": "dist/src/index.js",
-  "bin": {
-    "create-bk-agent": "./dist/bin/create-bk-agent.js"
-  },
-  "files": [
-    "dist/",
-    "templates/"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/BackendKit-labs/backendkit-agent-framework.git",
-    "directory": "packages/create-bk-agent"
-  },
-  "publishConfig": { "access": "public" },
-  "engines": { "node": ">=20.0.0" },
-  "scripts": {
-    "build": "tsc",
-    "prepack": "node scripts/copy-templates.js && npm run build",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "prompts": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/prompts": "^2.4.9",
-    "typescript": "^5.4.0"
-  }
-}
+{
+  "name": "create-bk-agent",
+  "version": "0.16.0",
+  "description": "Create a new BackendKit agent project",
+  "main": "dist/src/index.js",
+  "bin": {
+    "create-bk-agent": "./dist/bin/create-bk-agent.js"
+  },
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BackendKit-labs/backendkit-agent-framework.git",
+    "directory": "packages/create-bk-agent"
+  },
+  "publishConfig": { "access": "public" },
+  "engines": { "node": ">=20.0.0" },
+  "scripts": {
+    "build": "tsc",
+    "prepack": "node scripts/copy-templates.js && npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.4.0"
+  }
+}

package/templates/coding/src/index.ts

@@ -1,48 +1,42 @@
-import 'dotenv/config';
-import * as readline from 'readline';
-import { createCodingEngine } from '@backendkit-labs/agent-coding';
-import { CallbackTransport } from '@backendkit-labs/agent-core';
-
-// ── Provider setup ────────────────────────────────────────────────────────────
-
-const provider = process.env.LLM_PROVIDER ?? 'anthropic';
-const apiKey   = process.env.ANTHROPIC_API_KEY ?? process.env.OPENAI_API_KEY ?? process.env.LLM_API_KEY ?? '';
-const model    = process.env.LLM_MODEL;
-
-if (!apiKey) {
-    console.error('Missing API key. Set ANTHROPIC_API_KEY or OPENAI_API_KEY in .env');
-    process.exit(1);
-}
-
-// ── Engine ────────────────────────────────────────────────────────────────────
-
-const transport = new CallbackTransport((event) => {
-    if (event.type === 'token')       process.stdout.write(event.content);
-    if (event.type === 'tool_call')   console.log(`\n⚙  ${event.name}`);
-    if (event.type === 'block_end')   console.log();
-    if (event.type === 'error')       console.error(`\nError: ${event.message}`);
-});
-
-const engine = createCodingEngine({
-    providers:       { [provider]: { apiKey, ...(model ? { model } : {}) } },
-    defaultProvider: provider,
-    workingDir:      process.cwd(),
-    appName:         'my-coding-agent',
-    transport,
-});
-
-// ── REPL ──────────────────────────────────────────────────────────────────────
-
-const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-
-function prompt() {
-    rl.question('\n> ', async (input) => {
-        const trimmed = input.trim();
-        if (!trimmed || trimmed === '/exit') { rl.close(); return; }
-        await engine.run(trimmed);
-        prompt();
-    });
-}
-
-console.log('Coding agent ready. Type your request or /exit to quit.\n');
-prompt();
+import 'dotenv/config';
+import * as readline from 'readline';
+import { createCodingEngine, TerminalTransport } from '@backendkit-labs/agent-coding';
+
+// ── Provider setup ────────────────────────────────────────────────────────────
+
+const provider = process.env.LLM_PROVIDER ?? 'anthropic';
+const apiKey   = process.env.ANTHROPIC_API_KEY ?? process.env.OPENAI_API_KEY ?? process.env.LLM_API_KEY ?? '';
+const model    = process.env.LLM_MODEL;
+
+if (!apiKey) {
+    console.error('Missing API key. Set ANTHROPIC_API_KEY or OPENAI_API_KEY in .env');
+    process.exit(1);
+}
+
+// ── Engine ────────────────────────────────────────────────────────────────────
+
+const transport = new TerminalTransport();
+
+const engine = createCodingEngine({
+    providers:       { [provider]: { apiKey, ...(model ? { model } : {}) } },
+    defaultProvider: provider,
+    workingDir:      process.cwd(),
+    appName:         'my-coding-agent',
+    transport,
+});
+
+// ── REPL ──────────────────────────────────────────────────────────────────────
+
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+function prompt() {
+    rl.question('\n❯ ', async (input) => {
+        const trimmed = input.trim();
+        if (!trimmed || trimmed === '/exit') { rl.close(); return; }
+        await engine.run(trimmed);
+        prompt();
+    });
+}
+
+console.log('Coding agent ready. Type your request or /exit to quit.\n');
+prompt();