create-bk-agent 0.23.4 → 0.23.6

package/README.md

@@ -1,7 +1,5 @@
 # create-bk-agent
 
-> **Status: `stable`** — Maintained and production-ready. No new features during the pilot phase.
-
 CLI scaffolding tool for the BackendKit Labs agent framework. Generates a fully configured TypeScript agent project in seconds — choose your architecture, deployment mode, and LLM provider, and get a working project with all dependencies wired.
 
 ## Usage

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

@@ -154,7 +154,7 @@ function addNewVault(engineFile, vaultPath) {
 // ── Non-enterprise setup ──────────────────────────────────────────────────────
 function setupRagFromScratch(info, vaultPath) {
     console.log('\n📦  Installing @backendkit-labs/agent-enterprise ...');
-    const added = (0, patcher_1.addPackageDependency)(info.pkgFile, '@backendkit-labs/agent-enterprise', '^0.1.0');
+    const added = (0, patcher_1.addPackageDependency)(info.pkgFile, '@backendkit-labs/agent-enterprise', '^0.8.8');
     if (added) {
         (0, child_process_1.execSync)('npm install', { cwd: info.cwd, stdio: 'inherit' });
     }
@@ -195,26 +195,26 @@ function setupRagFromScratch(info, vaultPath) {
 }
 function printManualInstructions(vaultPath) {
     const normalized = vaultPath.replace(/\\/g, '/');
-    console.log(`
-  1. Import in engine.ts:
-     import { ObsidianRAGProvider } from '@backendkit-labs/agent-enterprise';
-
-  2. Create RAG instance:
-     const rag = new ObsidianRAGProvider({ vaultPath: '${normalized}' });
-
-  3. Register tool:
-     tools.register(rag.createTool());
+    console.log(`
+  1. Import in engine.ts:
+     import { ObsidianRAGProvider } from '@backendkit-labs/agent-enterprise';
+
+  2. Create RAG instance:
+     const rag = new ObsidianRAGProvider({ vaultPath: '${normalized}' });
+
+  3. Register tool:
+     tools.register(rag.createTool());
 `);
 }
 // ── Main export ───────────────────────────────────────────────────────────────
-const USAGE = `
-Usage: npx create-bk-agent add knowledge <folder-path>
-       npx create-bk-agent add knowledge --vault <vault-path>
-
-Examples:
-  npx create-bk-agent add knowledge ./docs
-  npx create-bk-agent add knowledge "04-Recursos/Backend"
-  npx create-bk-agent add knowledge --vault "C:/Company/HR-Vault"
+const USAGE = `
+Usage: npx create-bk-agent add knowledge <folder-path>
+       npx create-bk-agent add knowledge --vault <vault-path>
+
+Examples:
+  npx create-bk-agent add knowledge ./docs
+  npx create-bk-agent add knowledge "04-Recursos/Backend"
+  npx create-bk-agent add knowledge --vault "C:/Company/HR-Vault"
 `;
 function addKnowledge(info, args) {
     const parsed = parseArgs(args);

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

@@ -85,7 +85,7 @@ function addServer(info, args) {
     }
     fs.writeFileSync(info.serverFile, generateServerTs(info, opts));
     console.log(`\n✓  Created src/server.ts  (HTTP MCP on port ${opts.port})`);
-    const added = (0, patcher_1.addPackageDependency)(info.pkgFile, '@backendkit-labs/mcp-server', '^0.15.0');
+    const added = (0, patcher_1.addPackageDependency)(info.pkgFile, '@backendkit-labs/mcp-server', '^0.19.0');
     (0, patcher_1.addPackageDependency)(info.pkgFile, 'zod', '^4.6.6');
     (0, patcher_1.addPackageScript)(info.pkgFile, 'server', 'ts-node src/server.ts');
     if (added) {

package/dist/src/add/patcher.js

@@ -134,87 +134,125 @@ function addPackageDevDependency(pkgFile, depName, version) {
     fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + '\n');
     return true;
 }
-// ── AgentEngine options patcher ───────────────────────────────────────────────
 /**
- * Adds `mcpServers: [{ name, url }]` to the first AgentEngine constructor call.
- * If mcpServers already exists, appends a new entry to the existing array.
- * Returns true on success.
+ * `mcpServers` is an option of createBaseEngine only. AgentEngine takes an `mcpManager`, so patching
+ * `mcpServers` into `new AgentEngine({...})` produced code that does not compile (an unknown property).
  */
-function addMcpServerEntry(file, name, url) {
-    const content = fs.readFileSync(file, 'utf-8');
-    const entry = `        { name: '${name}', url: '${url}' },`;
-    if (content.includes(`url: '${url}'`))
-        return true; // already registered
-    if (content.includes('mcpServers:')) {
-        // Append into existing array — insert after 'mcpServers: ['
-        const updated = content.replace(/(mcpServers:\s*\[)/, `$1\n${entry}`);
-        if (updated === content)
-            return false;
-        fs.writeFileSync(file, updated);
-        return true;
-    }
-    // Insert new mcpServers block before the closing of AgentEngine({ ... })
-    const lines = content.split('\n');
+function findEngineCall(content) {
+    const base = content.search(/createBaseEngine\s*\(\s*\{/);
+    if (base !== -1)
+        return { kind: 'base', open: content.indexOf('{', base) };
+    const engine = content.search(/new AgentEngine\s*\(\s*\{/);
+    if (engine !== -1)
+        return { kind: 'engine', open: content.indexOf('{', engine) };
+    return null;
+}
+/** Index of the `}` that closes the object literal opened at `open`, skipping strings, templates and comments. */
+function matchingBrace(content, open) {
     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;
+    for (let i = open; i < content.length; i++) {
+        const c = content[i];
+        const next = content[i + 1];
+        if (c === '/' && next === '/') {
+            i = content.indexOf('\n', i);
+            if (i === -1)
+                return -1;
+            continue;
+        }
+        if (c === '/' && next === '*') {
+            i = content.indexOf('*/', i + 2);
+            if (i === -1)
+                return -1;
+            i++;
+            continue;
+        }
+        if (c === "'" || c === '"') {
+            for (i++; i < content.length && content[i] !== c; i++)
+                if (content[i] === '\\')
+                    i++;
+            continue;
         }
-        if (engineStart !== -1) {
-            depth += (lines[i].match(/\{/g) ?? []).length;
-            depth -= (lines[i].match(/\}/g) ?? []).length;
-            if (depth === 0 && i > engineStart) {
-                closeIdx = i;
-                break;
+        if (c === '`') {
+            for (i++; i < content.length && content[i] !== '`'; i++) {
+                if (content[i] === '\\') {
+                    i++;
+                    continue;
+                }
+                if (content[i] === '$' && content[i + 1] === '{') {
+                    const inner = matchingBrace(content, i + 1);
+                    if (inner === -1)
+                        return -1;
+                    i = inner;
+                }
             }
+            continue;
         }
+        if (c === '{')
+            depth++;
+        else if (c === '}' && --depth === 0)
+            return i;
     }
-    if (closeIdx === -1)
-        return false;
-    lines.splice(closeIdx, 0, `        mcpServers: [\n${entry}\n        ],`);
-    fs.writeFileSync(file, lines.join('\n'));
-    return true;
+    return -1;
 }
 /**
- * Adds a stdio MCP entry `{ name, transport: 'stdio', command, args }` to AgentEngine.
- * If mcpServers already exists, appends. Returns true on success.
+ * Registers one MCP server entry (an object literal source) in the project's engine:
+ * appends to an existing list, or adds the option, keeping the file valid TypeScript.
  */
-function addMcpStdioEntry(file, name, npmPackage) {
+function addMcpEntry(file, entry, alreadyThere) {
     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);
+    if (content.includes(alreadyThere))
+        return true;
+    const call = findEngineCall(content);
+    if (!call)
+        return false;
+    const line = `        ${entry},`;
+    // An existing list: add to its start.
+    const existing = call.kind === 'base' ? /mcpServers:\s*\[/ : /new MCPClientManager\(\s*\[/;
+    const m = existing.exec(content);
+    if (m) {
+        fs.writeFileSync(file, content.slice(0, m.index + m[0].length) + '\n' + line + content.slice(m.index + m[0].length));
         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)
+    // No list yet: add the option just before the closing brace of the options object.
+    const close = matchingBrace(content, call.open);
+    if (close === -1)
         return false;
-    lines.splice(closeIdx, 0, `        mcpServers: [\n${entry}\n        ],`);
-    fs.writeFileSync(file, lines.join('\n'));
+    const before = content.slice(0, close).replace(/\s+$/, '');
+    const needsComma = !/[,{]$/.test(before); // the last property may have no trailing comma
+    const option = call.kind === 'base'
+        ? `        mcpServers: [\n${line}\n        ],`
+        : `        mcpManager: new MCPClientManager([\n${line}\n        ]),`;
+    fs.writeFileSync(file, before + (needsComma ? ',' : '') + '\n' + option + '\n' + content.slice(close));
+    if (call.kind === 'engine')
+        addMcpManagerImport(file);
     return true;
 }
+/** Makes `MCPClientManager` available from agent-core: into the existing import, or as a new one. */
+function addMcpManagerImport(file) {
+    const content = fs.readFileSync(file, 'utf-8');
+    if (/\bMCPClientManager\b[^;]*from\s+['"]@backendkit-labs\/agent-core['"]/.test(content))
+        return;
+    const named = /import\s*\{([^}]*)\}\s*from\s*(['"])@backendkit-labs\/agent-core\2/.exec(content);
+    if (named) {
+        const names = named[1].replace(/\s+$/, '');
+        const sep = names.trim().endsWith(',') ? '' : ',';
+        const multiline = named[1].includes('\n');
+        const added = multiline ? `${names}${sep}\n    MCPClientManager,\n` : `${names}${sep} MCPClientManager `;
+        fs.writeFileSync(file, content.replace(named[0], `import {${added}} from ${named[2]}@backendkit-labs/agent-core${named[2]}`));
+        return;
+    }
+    addImportLine(file, "import { MCPClientManager } from '@backendkit-labs/agent-core';");
+}
+/**
+ * Adds a remote MCP server `{ name, url }` to the engine of a generated project (createBaseEngine or AgentEngine).
+ * Appends if a list exists. Returns true on success.
+ */
+function addMcpServerEntry(file, name, url) {
+    return addMcpEntry(file, `{ name: '${name}', url: '${url}' }`, `url: '${url}'`);
+}
+/**
+ * Adds a stdio MCP server `{ name, command: 'npx', args: ['-y', pkg] }`. Returns true on success.
+ */
+function addMcpStdioEntry(file, name, npmPackage) {
+    return addMcpEntry(file, `{ name: '${name}', command: 'npx', args: ['-y', '${npmPackage}'] }`, `'${npmPackage}'`);
+}

package/dist/src/scaffold.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GENERATED_DEP_RANGES = void 0;
+exports.ORCHESTRATOR_PROVIDERS = exports.GENERATED_DEP_RANGES = exports.PROVIDER_ENV = exports.PROVIDER_DEFAULTS = void 0;
 exports.scaffold = scaffold;
 exports.installDeps = installDeps;
 const fs = __importStar(require("fs"));
@@ -46,11 +46,23 @@ const DEPLOY_DIR = path.join(TEMPLATES_DIR, 'deploy');
 // The rest (coding, autonomous, minimal) are self-contained in base/.
 const LAYERED = ['multi-agent', 'single', 'enterprise'];
 // ── Provider env var hints ────────────────────────────────────────────────────
-const PROVIDER_ENV = {
-    anthropic: { varName: 'ANTHROPIC_API_KEY', placeholder: 'sk-ant-...', model: 'claude-sonnet-4-6' },
-    openai: { varName: 'OPENAI_API_KEY', placeholder: 'sk-...', model: 'gpt-4o', baseUrl: 'https://api.openai.com/v1' },
-    deepseek: { varName: 'LLM_API_KEY', placeholder: 'sk-...', model: 'deepseek-chat', baseUrl: 'https://api.deepseek.com/v1' },
-    ollama: { varName: 'OLLAMA_BASE_URL', placeholder: 'http://localhost:11434', model: 'llama3.2' },
+/**
+ * What is true of a provider whichever kind of project is generated: its default model and API endpoint.
+ * The two tables below (project .env, orchestrator.yaml) used to repeat these and could drift apart.
+ * Each keeps its own environment-variable naming, which does differ on purpose (a generated project reads
+ * `LLM_API_KEY` for DeepSeek, the orchestrator `DEEPSEEK_API_KEY`).
+ */
+exports.PROVIDER_DEFAULTS = {
+    anthropic: { model: 'claude-sonnet-4-6' },
+    openai: { model: 'gpt-4o', baseUrl: 'https://api.openai.com/v1' },
+    deepseek: { model: 'deepseek-chat', baseUrl: 'https://api.deepseek.com/v1' },
+    ollama: { model: 'llama3.2' },
+};
+exports.PROVIDER_ENV = {
+    anthropic: { varName: 'ANTHROPIC_API_KEY', placeholder: 'sk-ant-...', ...exports.PROVIDER_DEFAULTS.anthropic },
+    openai: { varName: 'OPENAI_API_KEY', placeholder: 'sk-...', ...exports.PROVIDER_DEFAULTS.openai },
+    deepseek: { varName: 'LLM_API_KEY', placeholder: 'sk-...', ...exports.PROVIDER_DEFAULTS.deepseek },
+    ollama: { varName: 'OLLAMA_BASE_URL', placeholder: 'http://localhost:11434', ...exports.PROVIDER_DEFAULTS.ollama },
 };
 // ── Copy directory (overlay-safe) ─────────────────────────────────────────────
 // dst may already exist from the base layer — files are overwritten, dirs merged.
@@ -67,7 +79,7 @@ function copyDir(src, dst) {
  * minor, so these must follow the workspace versions (guarded by a test).
  */
 exports.GENERATED_DEP_RANGES = {
-    '@backendkit-labs/mcp-server': '^0.18.0',
+    '@backendkit-labs/mcp-server': '^0.19.0',
     '@backendkit-labs/agent-web': '^0.6.0',
     '@backendkit-labs/agent-testkit': '^0.1.0',
 };
@@ -135,7 +147,7 @@ function writeEnv(dir, provider, choices) {
         fs.writeFileSync(envFile, content);
         return;
     }
-    const p = PROVIDER_ENV[provider];
+    const p = exports.PROVIDER_ENV[provider];
     const content = [
         '# Generated by create-bk-agent',
         `${p.varName}=${p.placeholder}`,
@@ -168,14 +180,15 @@ function injectSkillPack(targetDir, pack) {
     ].join('\n');
     fs.appendFileSync(engineFile, block + '\n');
 }
-const ORCHESTRATOR_PROVIDERS = {
-    deepseek: { id: 'deepseek', keyVar: 'DEEPSEEK_API_KEY', model: 'deepseek-chat', baseUrl: 'https://api.deepseek.com/v1' },
-    anthropic: { id: 'anthropic', keyVar: 'ANTHROPIC_API_KEY', model: 'claude-sonnet-4-6' },
-    openai: { id: 'openai', keyVar: 'OPENAI_API_KEY', model: 'gpt-4o', baseUrl: 'https://api.openai.com/v1' },
-    ollama: { id: 'ollama', keyVar: '', model: 'llama3.2', baseUrl: 'http://localhost:11434' },
+exports.ORCHESTRATOR_PROVIDERS = {
+    deepseek: { id: 'deepseek', keyVar: 'DEEPSEEK_API_KEY', ...exports.PROVIDER_DEFAULTS.deepseek },
+    anthropic: { id: 'anthropic', keyVar: 'ANTHROPIC_API_KEY', ...exports.PROVIDER_DEFAULTS.anthropic },
+    openai: { id: 'openai', keyVar: 'OPENAI_API_KEY', ...exports.PROVIDER_DEFAULTS.openai },
+    // orchestrator.yaml wants an explicit base_url for Ollama; a generated project reads it from OLLAMA_BASE_URL instead
+    ollama: { id: 'ollama', keyVar: '', ...exports.PROVIDER_DEFAULTS.ollama, baseUrl: 'http://localhost:11434' },
 };
 function buildProvidersBlock(provider) {
-    const p = ORCHESTRATOR_PROVIDERS[provider];
+    const p = exports.ORCHESTRATOR_PROVIDERS[provider];
     const lines = ['providers:', `  ${p.id}:`];
     if (p.keyVar)
         lines.push(`    api_key: \${${p.keyVar}}`);
@@ -197,7 +210,7 @@ function scaffoldOrchestrator(choices, targetDir) {
     const orchYaml = path.join(targetDir, 'orchestrator.yaml');
     if (fs.existsSync(orchYaml)) {
         let content = fs.readFileSync(orchYaml, 'utf-8');
-        const providerId = ORCHESTRATOR_PROVIDERS[choices.provider].id;
+        const providerId = exports.ORCHESTRATOR_PROVIDERS[choices.provider].id;
         const providersBlock = buildProvidersBlock(choices.provider);
         content = content.replace(/__PROVIDER_ID__/g, providerId);
         content = content.replace('__PROVIDERS_BLOCK__', providersBlock);
@@ -214,7 +227,7 @@ function scaffoldOrchestrator(choices, targetDir) {
     const envExample = path.join(targetDir, '.env.example');
     const envFile = path.join(targetDir, '.env');
     if (fs.existsSync(envExample) && !fs.existsSync(envFile)) {
-        const p = ORCHESTRATOR_PROVIDERS[choices.provider];
+        const p = exports.ORCHESTRATOR_PROVIDERS[choices.provider];
         const keyLine = p.keyVar
             ? `${p.keyVar}=your-api-key-here`
             : `# No API key needed for Ollama\nOLLAMA_BASE_URL=${p.baseUrl}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-bk-agent",
-  "version": "0.23.4",
+  "version": "0.23.6",
   "description": "Create a new BackendKit agent project",
   "main": "dist/src/index.js",
   "bin": {
@@ -28,7 +28,7 @@
     "test": "jest"
   },
   "peerDependencies": {
-    "@backendkit-labs/agent-core": ">=0.24.0 <0.37.0"
+    "@backendkit-labs/agent-core": ">=0.24.0 <0.40.0"
   },
   "peerDependenciesMeta": {
     "@backendkit-labs/agent-core": {

package/templates/README.md

@@ -0,0 +1,26 @@
+# Project templates
+
+Source of the projects that [`create-bk-agent`](../create-bk-agent) generates. This directory is not published on its own: `create-bk-agent` copies it into its package when it is packed (`scripts/copy-templates.js`).
+
+A generated project is one **architecture** from `base/` plus one **deploy mode** from `deploy/`:
+
+| `base/` | What it is |
+|---|---|
+| `coding` | Coding assistant: 10 agents and the file, git and command tools |
+| `multi-agent` | Orchestrator and specialists, no tools: you define the domain |
+| `single` | One agent with tools |
+| `autonomous` | Cron, webhook and event triggers |
+| `enterprise` | Local LLM and an Obsidian knowledge base (RAG) |
+| `orchestrator` | Multi-step workflows with approval gates |
+| `minimal` | The bare engine |
+
+| `deploy/` | How it runs |
+|---|---|
+| `repl` | Interactive terminal |
+| `mcp-stdio` | MCP server over stdio (for Claude Desktop, IDEs, other agents) |
+| `mcp-http` | MCP server over HTTP |
+| `hybrid` | Terminal and MCP HTTP together |
+
+`coding/AGENT.md` is the default project description the coding architecture starts with.
+
+When you change a framework version range here, keep it in step with the workspace version: the scaffolder's tests (`create-bk-agent/src/__tests__/scaffold.test.ts`) fail if a template asks for a version the repository does not have.

package/templates/base/autonomous/package.json

@@ -11,7 +11,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@backendkit-labs/agent-core": "^0.36.0",
+    "@backendkit-labs/agent-core": "^0.38.0",
     "dotenv": "^16.0.0"
   },
   "devDependencies": {

package/templates/base/autonomous/src/index.ts

@@ -1,83 +1,83 @@
-import 'dotenv/config';
-import * as os from 'os';
-import * as path from 'path';
-import { createAutonomousAgent, createMemorySystem } from '@backendkit-labs/agent-core';
-import type { AgentProfile } from '@backendkit-labs/agent-core';
-
-// ── Agent definition ──────────────────────────────────────────────────────────
-
-const monitorAgent: AgentProfile = {
-    id: 'monitor',
-    name: 'Monitor',
-    icon: '👁',
-    description: 'Monitors events and executes scheduled tasks',
-    allowedTools: [],
-    delegatesTo: [],
-    systemPrompt: `You are an autonomous monitor agent.
-// TODO: describe what this agent monitors and what actions it takes.
-When activated by a trigger, analyze the input and take appropriate action.`,
-};
-
-// ── Provider ──────────────────────────────────────────────────────────────────
-
-const provider = process.env.LLM_PROVIDER ?? 'anthropic';
-const apiKey   = process.env.ANTHROPIC_API_KEY ?? process.env.OPENAI_API_KEY ?? '';
-
-if (!apiKey) { console.error('Missing API key'); process.exit(1); }
-
-// ── Memory — persists context between trigger executions ──────────────────────
-
-const APP_DIR = path.join(os.homedir(), '.my-autonomous-agent');
-const MEM_DIR = path.join(APP_DIR, 'memory');
-
-const memory = createMemorySystem({
-    episodic:   { provider: 'json', path: path.join(MEM_DIR, 'episodes.json') },
-    semantic:   { provider: 'json', path: path.join(MEM_DIR, 'knowledge.json') },
-    procedural: { provider: 'json', path: path.join(MEM_DIR, 'patterns.json') },
-    retention:  { maxEpisodes: 200 },
-});
-
-// ── Autonomous agent ──────────────────────────────────────────────────────────
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-const agent = createAutonomousAgent({
-    providers:       { [provider]: { apiKey } } as any,
-    defaultProvider: provider,
-    agents:          [monitorAgent],
-    defaultAgent:    'monitor',
-    goal:            'TODO: describe the agent goal',
-    memorySystem:    memory,
-
-    triggers: [
-        // Run every day at 9:00 AM
-        {
-            type: 'schedule',
-            cron: '0 9 * * *',
-            task: 'Run daily check and report findings',
-        },
-
-        // Listen for webhook events (e.g. from GitHub, Slack, etc.)
-        {
-            type:   'webhook',
-            path:   '/events',
-            // secret: process.env.WEBHOOK_SECRET,
-        },
-
-        // TODO: add more triggers as needed
-        // { type: 'event', topic: 'my.custom.event' },
-    ],
-
-    webhookPort: parseInt(process.env.WEBHOOK_PORT ?? '3000'),
-});
-
-// ── Start ─────────────────────────────────────────────────────────────────────
-
-void (async () => {
-    await agent.start();
-    console.log('Autonomous agent started.');
-    console.log('Webhook listening on port', process.env.WEBHOOK_PORT ?? 3000);
-    console.log(`Memory stored in: ${APP_DIR}`);
-
-    process.on('SIGTERM', async () => { await agent.stop(); process.exit(0); });
-    process.on('SIGINT',  async () => { await agent.stop(); process.exit(0); });
-})();
+import 'dotenv/config';
+import * as os from 'os';
+import * as path from 'path';
+import { createAutonomousAgent, createMemorySystem } from '@backendkit-labs/agent-core';
+import type { AgentProfile } from '@backendkit-labs/agent-core';
+
+// ── Agent definition ──────────────────────────────────────────────────────────
+
+const monitorAgent: AgentProfile = {
+    id: 'monitor',
+    name: 'Monitor',
+    icon: '👁',
+    description: 'Monitors events and executes scheduled tasks',
+    allowedTools: [],   // the tools this agent may call, by name; empty means none (a tool that is registered but not listed here is refused)
+    delegatesTo: [],
+    systemPrompt: `You are an autonomous monitor agent.
+// TODO: describe what this agent monitors and what actions it takes.
+When activated by a trigger, analyze the input and take appropriate action.`,
+};
+
+// ── Provider ──────────────────────────────────────────────────────────────────
+
+const provider = process.env.LLM_PROVIDER ?? 'anthropic';
+const apiKey   = process.env.ANTHROPIC_API_KEY ?? process.env.OPENAI_API_KEY ?? '';
+
+if (!apiKey) { console.error('Missing API key'); process.exit(1); }
+
+// ── Memory — persists context between trigger executions ──────────────────────
+
+const APP_DIR = path.join(os.homedir(), '.my-autonomous-agent');
+const MEM_DIR = path.join(APP_DIR, 'memory');
+
+const memory = createMemorySystem({
+    episodic:   { provider: 'json', path: path.join(MEM_DIR, 'episodes.json') },
+    semantic:   { provider: 'json', path: path.join(MEM_DIR, 'knowledge.json') },
+    procedural: { provider: 'json', path: path.join(MEM_DIR, 'patterns.json') },
+    retention:  { maxEpisodes: 200 },
+});
+
+// ── Autonomous agent ──────────────────────────────────────────────────────────
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const agent = createAutonomousAgent({
+    providers:       { [provider]: { apiKey } } as any,
+    defaultProvider: provider,
+    agents:          [monitorAgent],
+    defaultAgent:    'monitor',
+    goal:            'TODO: describe the agent goal',
+    memorySystem:    memory,
+
+    triggers: [
+        // Run every day at 9:00 AM
+        {
+            type: 'schedule',
+            cron: '0 9 * * *',
+            task: 'Run daily check and report findings',
+        },
+
+        // Listen for webhook events (e.g. from GitHub, Slack, etc.)
+        {
+            type:   'webhook',
+            path:   '/events',
+            // secret: process.env.WEBHOOK_SECRET,
+        },
+
+        // TODO: add more triggers as needed
+        // { type: 'event', topic: 'my.custom.event' },
+    ],
+
+    webhookPort: parseInt(process.env.WEBHOOK_PORT ?? '3000'),
+});
+
+// ── Start ─────────────────────────────────────────────────────────────────────
+
+void (async () => {
+    await agent.start();
+    console.log('Autonomous agent started.');
+    console.log('Webhook listening on port', process.env.WEBHOOK_PORT ?? 3000);
+    console.log(`Memory stored in: ${APP_DIR}`);
+
+    process.on('SIGTERM', async () => { await agent.stop(); process.exit(0); });
+    process.on('SIGINT',  async () => { await agent.stop(); process.exit(0); });
+})();

package/templates/base/coding/package.json

@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "@backendkit-labs/agent-coding": "^0.28.0",
-    "@backendkit-labs/agent-core": "^0.36.0",
+    "@backendkit-labs/agent-core": "^0.38.0",
     "dotenv": "^16.0.0"
   },
   "devDependencies": {

package/templates/base/enterprise/package.json

@@ -12,7 +12,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@backendkit-labs/agent-core": "^0.36.0",
+    "@backendkit-labs/agent-core": "^0.38.0",
     "@backendkit-labs/agent-coding": "^0.28.0",
     "@backendkit-labs/agent-enterprise": "^0.8.0",
     "dotenv": "^16.0.0",

package/templates/base/minimal/package.json

@@ -11,7 +11,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@backendkit-labs/agent-core": "^0.36.0",
+    "@backendkit-labs/agent-core": "^0.38.0",
     "dotenv": "^16.0.0"
   },
   "devDependencies": {