create-bk-agent 0.18.0 → 0.19.0

package/dist/src/add/index.js

@@ -6,6 +6,7 @@ const server_1 = require("./modules/server");
 const specialist_1 = require("./modules/specialist");
 const tools_1 = require("./modules/tools");
 const mcp_client_1 = require("./modules/mcp-client");
+const plugin_1 = require("./modules/plugin");
 const HELP = `
 Usage: npx create-bk-agent add <module> [options]
 
@@ -23,11 +24,16 @@ Modules:
   mcp-client <url>      Add a remote MCP server to the engine
     --name <s>            Name for the mcpServers entry (default: last URL segment)
 
+  plugin <name>         Install a backendkit agent as a stdio MCP plugin
+                        Available: docker, k8s
+
 Examples:
   npx create-bk-agent add server --port 4000
   npx create-bk-agent add specialist data-analyst
   npx create-bk-agent add tools github
   npx create-bk-agent add mcp-client http://localhost:3001/mcp --name billing
+  npx create-bk-agent add plugin docker
+  npx create-bk-agent add plugin k8s
 `;
 function runAdd(args, cwd) {
     const [module, ...rest] = args;
@@ -59,6 +65,9 @@ function runAdd(args, cwd) {
         case 'mcp-client':
             (0, mcp_client_1.addMcpClient)(info, rest);
             break;
+        case 'plugin':
+            (0, plugin_1.addPlugin)(info, rest);
+            break;
         default:
             console.error(`\n✗  Unknown module: "${module}"\n`);
             console.log(HELP);

package/dist/src/add/modules/plugin.js

@@ -0,0 +1,91 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addPlugin = addPlugin;
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+const patcher_1 = require("../patcher");
+const PLUGINS = {
+    docker: {
+        npm: '@backendkit-labs/docker-agent',
+        tools: ['docker_execute', 'docker_deploy', 'docker_status'],
+        envHint: 'Requires: OPENAI_API_KEY (or LLM_API_KEY) and Docker daemon running.',
+    },
+    k8s: {
+        npm: '@backendkit-labs/k8s-agent',
+        tools: ['k8s_execute', 'k8s_deploy', 'k8s_status'],
+        envHint: 'Requires: OPENAI_API_KEY (or LLM_API_KEY) and kubectl configured.',
+    },
+};
+function addPlugin(info, args) {
+    const pluginName = args[0];
+    if (!pluginName) {
+        console.log('\nUsage: npx create-bk-agent add plugin <name>\n');
+        console.log('Available plugins:');
+        for (const [name, def] of Object.entries(PLUGINS)) {
+            console.log(`  ${name.padEnd(10)} ${def.npm}`);
+        }
+        console.log('');
+        process.exit(0);
+    }
+    const plugin = PLUGINS[pluginName];
+    if (!plugin) {
+        console.error(`\n✗  Unknown plugin: "${pluginName}"`);
+        console.error(`   Available: ${Object.keys(PLUGINS).join(', ')}\n`);
+        process.exit(1);
+    }
+    if (!fs.existsSync(info.engineFile)) {
+        console.error('\n✗  src/engine.ts not found.\n');
+        process.exit(1);
+    }
+    console.log(`\n  Installing ${plugin.npm}...`);
+    const added = (0, patcher_1.addPackageDependency)(info.pkgFile, plugin.npm, 'latest');
+    if (added) {
+        (0, child_process_1.execSync)('npm install', { cwd: info.cwd, stdio: 'inherit' });
+    }
+    console.log(`  Patching src/engine.ts...`);
+    const ok = (0, patcher_1.addMcpStdioEntry)(info.engineFile, pluginName, plugin.npm);
+    if (!ok) {
+        console.error('\n✗  Could not locate AgentEngine constructor in src/engine.ts.\n');
+        process.exit(1);
+    }
+    console.log(`\n  ✅ Plugin "${pluginName}" added.\n`);
+    console.log(`     MCP tools exposed:`);
+    for (const tool of plugin.tools)
+        console.log(`       ${tool}`);
+    if (plugin.envHint)
+        console.log(`\n     ${plugin.envHint}`);
+    console.log('');
+}

package/dist/src/add/patcher.js

@@ -39,6 +39,7 @@ exports.insertBeforePattern = insertBeforePattern;
 exports.addPackageScript = addPackageScript;
 exports.addPackageDependency = addPackageDependency;
 exports.addMcpServerEntry = addMcpServerEntry;
+exports.addMcpStdioEntry = addMcpStdioEntry;
 const fs = __importStar(require("fs"));
 // ── Import block ──────────────────────────────────────────────────────────────
 /** Adds `importLine` after the last import statement. No-op if already present. */
@@ -166,3 +167,43 @@ function addMcpServerEntry(file, name, url) {
     fs.writeFileSync(file, lines.join('\n'));
     return true;
 }
+/**
+ * Adds a stdio MCP entry `{ name, transport: 'stdio', command, args }` to AgentEngine.
+ * If mcpServers already exists, appends. Returns true on success.
+ */
+function addMcpStdioEntry(file, name, npmPackage) {
+    const content = fs.readFileSync(file, 'utf-8');
+    const entry = `        { name: '${name}', transport: 'stdio' as const, command: 'npx', args: ['-y', '${npmPackage}'] },`;
+    if (content.includes(`'${npmPackage}'`))
+        return true; // already registered
+    if (content.includes('mcpServers:')) {
+        const updated = content.replace(/(mcpServers:\s*\[)/, `$1\n${entry}`);
+        if (updated === content)
+            return false;
+        fs.writeFileSync(file, updated);
+        return true;
+    }
+    const lines = content.split('\n');
+    let depth = 0;
+    let engineStart = -1;
+    let closeIdx = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes('new AgentEngine({')) {
+            engineStart = i;
+            depth = 0;
+        }
+        if (engineStart !== -1) {
+            depth += (lines[i].match(/\{/g) ?? []).length;
+            depth -= (lines[i].match(/\}/g) ?? []).length;
+            if (depth === 0 && i > engineStart) {
+                closeIdx = i;
+                break;
+            }
+        }
+    }
+    if (closeIdx === -1)
+        return false;
+    lines.splice(closeIdx, 0, `        mcpServers: [\n${entry}\n        ],`);
+    fs.writeFileSync(file, lines.join('\n'));
+    return true;
+}

package/package.json

@@ -1,33 +1,33 @@
-{
-  "name": "create-bk-agent",
-  "version": "0.18.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.19.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": "git+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"
+  }
+}