create-bk-agent 0.23.4 → 0.23.6

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

@@ -1,43 +1,43 @@
-import 'dotenv/config';
-import { createBaseEngine } from '@backendkit-labs/agent-core';
-import type { AgentProfile, LLMProvider } from '@backendkit-labs/agent-core';
-
-// ── Provider ──────────────────────────────────────────────────────────────────
-// TODO: replace with the actual provider for your chosen LLM
-// e.g. AnthropicProvider from @backendkit-labs/agent-coding
-// or implement LLMProvider interface directly
-
-const myProvider: LLMProvider = {
-    chat: async (_messages, _tools, callbacks) => {
-        // TODO: call your LLM API here
-        callbacks.onDone({ role: 'assistant', content: 'Hello from my agent!' });
-    },
-};
-
-// ── Agent ─────────────────────────────────────────────────────────────────────
-
-const myAgent: AgentProfile = {
-    id: 'my-agent',
-    name: 'My Agent',
-    icon: '🤖',
-    description: 'TODO: describe your agent',
-    allowedTools: [],
-    delegatesTo: [],
-    systemPrompt: 'TODO: write your system prompt here.',
-};
-
-// ── Engine ────────────────────────────────────────────────────────────────────
-
-const engine = createBaseEngine({
-    providers:       { default: myProvider },
-    defaultProvider: 'default',
-    agents:          [myAgent],
-    defaultAgent:    'my-agent',
-});
-
-// ── Run ───────────────────────────────────────────────────────────────────────
-
-void (async () => {
-    const input = process.argv[2] ?? 'Hello';
-    await engine.run(input);
-})();
+import 'dotenv/config';
+import { createBaseEngine } from '@backendkit-labs/agent-core';
+import type { AgentProfile, LLMProvider } from '@backendkit-labs/agent-core';
+
+// ── Provider ──────────────────────────────────────────────────────────────────
+// TODO: replace with the actual provider for your chosen LLM
+// e.g. AnthropicProvider from @backendkit-labs/agent-coding
+// or implement LLMProvider interface directly
+
+const myProvider: LLMProvider = {
+    chat: async (_messages, _tools, callbacks) => {
+        // TODO: call your LLM API here
+        callbacks.onDone({ role: 'assistant', content: 'Hello from my agent!' });
+    },
+};
+
+// ── Agent ─────────────────────────────────────────────────────────────────────
+
+const myAgent: AgentProfile = {
+    id: 'my-agent',
+    name: 'My Agent',
+    icon: '🤖',
+    description: 'TODO: describe your agent',
+    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: 'TODO: write your system prompt here.',
+};
+
+// ── Engine ────────────────────────────────────────────────────────────────────
+
+const engine = createBaseEngine({
+    providers:       { default: myProvider },
+    defaultProvider: 'default',
+    agents:          [myAgent],
+    defaultAgent:    'my-agent',
+});
+
+// ── Run ───────────────────────────────────────────────────────────────────────
+
+void (async () => {
+    const input = process.argv[2] ?? 'Hello';
+    await engine.run(input);
+})();

package/templates/base/multi-agent/package.json

@@ -12,9 +12,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@backendkit-labs/agent-core": "^0.36.0",
+    "@backendkit-labs/agent-core": "^0.38.0",
+    "@backendkit-labs/agent-providers": "^0.3.3",
     "dotenv": "^16.0.0",
-    "openai": "^4.0.0",
     "zod": "^4.6.6"
   },
   "devDependencies": {

package/templates/base/multi-agent/src/engine.ts

@@ -1,78 +1,78 @@
-import * as os from 'os';
-import * as path from 'path';
-import {
-    AgentEngine,
-    AgentRegistry,
-    ToolRegistry,
-    ProviderRegistry,
-    CallbackTransport,
-    createMemorySystem,
-} from '@backendkit-labs/agent-core';
-import { OpenAICompatibleProvider } from './providers/openai-compatible';
-import { loadConfig } from './config';
-import { ORCHESTRATOR_PROFILE } from './agents/orchestrator';
-import { SPECIALIST_A_PROFILE } from './agents/specialist-a';
-import { SPECIALIST_B_PROFILE } from './agents/specialist-b';
-import { exampleAction, exampleQuery } from './tools/example-tools';
-
-// ── Persistent storage paths ──────────────────────────────────────────────────
-// All state lives in ~/.my-agent/ so it survives restarts.
-
-const APP_DIR    = path.join(os.homedir(), '.my-agent');
-const HISTORY    = path.join(APP_DIR, 'history.json');
-const MEM_DIR    = path.join(APP_DIR, 'memory');
-
-// ── Memory system ─────────────────────────────────────────────────────────────
-// Three-tier: episodic (past experiences) + semantic (knowledge) + procedural (patterns).
-// buildContextBlock() auto-injects relevant memories into each agent turn.
-
-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: 500 },
-});
-
-export function createEngine(transport: CallbackTransport): AgentEngine {
-    const config = loadConfig();
-
-    const tools = new ToolRegistry();
-    tools
-        .register(exampleAction)
-        .register(exampleQuery);
-    // Register memory tools so agents can explicitly save/recall memories
-    for (const t of memory.getTools()) tools.register(t);
-    // TODO: register more tools
-
-    const agents = new AgentRegistry();
-    agents
-        .register(ORCHESTRATOR_PROFILE)
-        .register(SPECIALIST_A_PROFILE)
-        .register(SPECIALIST_B_PROFILE);
-    // TODO: register more specialists
-
-    const providers = new ProviderRegistry();
-    providers.register('default', new OpenAICompatibleProvider({
-        apiKey:  config.llmApiKey,
-        baseUrl: config.llmBaseUrl,
-        model:   config.llmModel,
-    }));
-
-    return new AgentEngine({
-        model:            { provider: 'default', id: config.llmModel },
-        agents,
-        tools,
-        providers,
-        defaultProvider:  'default',
-        defaultAgentId:   'orchestrator',
-        transport,
-        maxIterations:    30,
-        iterationMode:    'auto',
-        // Conversation history — persists between runs
-        historyPath:      HISTORY,
-        maxContextMessages: 100,
-        // Long-term memory — injects relevant context each turn
-        memorySystem:     memory,
-        additionalRoots:  [APP_DIR],
-    });
-}
+import * as os from 'os';
+import * as path from 'path';
+import {
+    AgentEngine,
+    AgentRegistry,
+    ToolRegistry,
+    ProviderRegistry,
+    CallbackTransport,
+    createMemorySystem,
+} from '@backendkit-labs/agent-core';
+import { OpenAICompatibleProvider } from '@backendkit-labs/agent-providers';
+import { loadConfig } from './config';
+import { ORCHESTRATOR_PROFILE } from './agents/orchestrator';
+import { SPECIALIST_A_PROFILE } from './agents/specialist-a';
+import { SPECIALIST_B_PROFILE } from './agents/specialist-b';
+import { exampleAction, exampleQuery } from './tools/example-tools';
+
+// ── Persistent storage paths ──────────────────────────────────────────────────
+// All state lives in ~/.my-agent/ so it survives restarts.
+
+const APP_DIR    = path.join(os.homedir(), '.my-agent');
+const HISTORY    = path.join(APP_DIR, 'history.json');
+const MEM_DIR    = path.join(APP_DIR, 'memory');
+
+// ── Memory system ─────────────────────────────────────────────────────────────
+// Three-tier: episodic (past experiences) + semantic (knowledge) + procedural (patterns).
+// buildContextBlock() auto-injects relevant memories into each agent turn.
+
+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: 500 },
+});
+
+export function createEngine(transport: CallbackTransport): AgentEngine {
+    const config = loadConfig();
+
+    const tools = new ToolRegistry();
+    tools
+        .register(exampleAction)
+        .register(exampleQuery);
+    // Register memory tools so agents can explicitly save/recall memories
+    for (const t of memory.getTools()) tools.register(t);
+    // TODO: register more tools
+
+    const agents = new AgentRegistry();
+    agents
+        .register(ORCHESTRATOR_PROFILE)
+        .register(SPECIALIST_A_PROFILE)
+        .register(SPECIALIST_B_PROFILE);
+    // TODO: register more specialists
+
+    const providers = new ProviderRegistry();
+    providers.register('default', new OpenAICompatibleProvider({
+        apiKey:  config.llmApiKey,
+        baseUrl: config.llmBaseUrl,
+        model:   config.llmModel,
+    }));
+
+    return new AgentEngine({
+        model:            { provider: 'default', id: config.llmModel },
+        agents,
+        tools,
+        providers,
+        defaultProvider:  'default',
+        defaultAgentId:   'orchestrator',
+        transport,
+        maxIterations:    30,
+        iterationMode:    'auto',
+        // Conversation history — persists between runs
+        historyPath:      HISTORY,
+        maxContextMessages: 100,
+        // Long-term memory — injects relevant context each turn
+        memorySystem:     memory,
+        additionalRoots:  [APP_DIR],
+    });
+}

package/templates/base/single/package.json

@@ -12,9 +12,9 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@backendkit-labs/agent-core": "^0.36.0",
+    "@backendkit-labs/agent-core": "^0.38.0",
+    "@backendkit-labs/agent-providers": "^0.3.3",
     "dotenv": "^16.0.0",
-    "openai": "^4.0.0",
     "zod": "^4.6.6"
   },
   "devDependencies": {

package/templates/base/single/src/engine.ts

@@ -1,67 +1,67 @@
-import * as os from 'os';
-import * as path from 'path';
-import {
-    AgentEngine,
-    AgentRegistry,
-    ToolRegistry,
-    ProviderRegistry,
-    CallbackTransport,
-    createMemorySystem,
-} from '@backendkit-labs/agent-core';
-import { OpenAICompatibleProvider } from './providers/openai-compatible';
-import { loadConfig } from './config';
-import { MY_AGENT_PROFILE } from './agents/my-agent';
-import { exampleAction, exampleQuery } from './tools/example-tools';
-
-// ── Persistent storage paths ──────────────────────────────────────────────────
-
-const APP_DIR = path.join(os.homedir(), '.my-agent');
-const HISTORY = path.join(APP_DIR, 'history.json');
-const MEM_DIR = path.join(APP_DIR, 'memory');
-
-// ── Memory system ─────────────────────────────────────────────────────────────
-
-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: 500 },
-});
-
-export function createEngine(transport: CallbackTransport): AgentEngine {
-    const config = loadConfig();
-
-    const tools = new ToolRegistry();
-    tools
-        .register(exampleAction)
-        .register(exampleQuery);
-    for (const t of memory.getTools()) tools.register(t);
-    // TODO: register more tools
-
-    const agents = new AgentRegistry();
-    agents.register(MY_AGENT_PROFILE);
-    // TODO: register more specialists
-
-    const providers = new ProviderRegistry();
-    providers.register('default', new OpenAICompatibleProvider({
-        apiKey:  config.llmApiKey,
-        baseUrl: config.llmBaseUrl,
-        model:   config.llmModel,
-    }));
-
-    return new AgentEngine({
-        model:            { provider: 'default', id: config.llmModel },
-        agents,
-        tools,
-        providers,
-        defaultProvider:  'default',
-        defaultAgentId:   'my-agent',
-        transport,
-        maxIterations:    20,
-        iterationMode:    'auto',
-        historyPath:      HISTORY,
-        maxContextMessages: 100,
-        memorySystem:     memory,
-        additionalRoots:  [APP_DIR],
-    });
-}
+import * as os from 'os';
+import * as path from 'path';
+import {
+    AgentEngine,
+    AgentRegistry,
+    ToolRegistry,
+    ProviderRegistry,
+    CallbackTransport,
+    createMemorySystem,
+} from '@backendkit-labs/agent-core';
+import { OpenAICompatibleProvider } from '@backendkit-labs/agent-providers';
+import { loadConfig } from './config';
+import { MY_AGENT_PROFILE } from './agents/my-agent';
+import { exampleAction, exampleQuery } from './tools/example-tools';
+
+// ── Persistent storage paths ──────────────────────────────────────────────────
+
+const APP_DIR = path.join(os.homedir(), '.my-agent');
+const HISTORY = path.join(APP_DIR, 'history.json');
+const MEM_DIR = path.join(APP_DIR, 'memory');
+
+// ── Memory system ─────────────────────────────────────────────────────────────
+
+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: 500 },
+});
+
+export function createEngine(transport: CallbackTransport): AgentEngine {
+    const config = loadConfig();
+
+    const tools = new ToolRegistry();
+    tools
+        .register(exampleAction)
+        .register(exampleQuery);
+    for (const t of memory.getTools()) tools.register(t);
+    // TODO: register more tools
+
+    const agents = new AgentRegistry();
+    agents.register(MY_AGENT_PROFILE);
+    // TODO: register more specialists
+
+    const providers = new ProviderRegistry();
+    providers.register('default', new OpenAICompatibleProvider({
+        apiKey:  config.llmApiKey,
+        baseUrl: config.llmBaseUrl,
+        model:   config.llmModel,
+    }));
+
+    return new AgentEngine({
+        model:            { provider: 'default', id: config.llmModel },
+        agents,
+        tools,
+        providers,
+        defaultProvider:  'default',
+        defaultAgentId:   'my-agent',
+        transport,
+        maxIterations:    20,
+        iterationMode:    'auto',
+        historyPath:      HISTORY,
+        maxContextMessages: 100,
+        memorySystem:     memory,
+        additionalRoots:  [APP_DIR],
+    });
+}

package/templates/autonomous/.env.example

@@ -1,8 +0,0 @@
-ANTHROPIC_API_KEY=sk-ant-...
-# OPENAI_API_KEY=sk-...
-
-LLM_PROVIDER=anthropic
-LLM_MODEL=claude-sonnet-4-6
-
-WEBHOOK_PORT=3000
-# WEBHOOK_SECRET=your-secret   # for GitHub/Slack webhook validation

package/templates/autonomous/package.json

@@ -1,25 +0,0 @@
-{
-  "name": "my-autonomous-agent",
-  "version": "0.1.0",
-  "private": true,
-  "description": "Autonomous agent — activates on cron, webhooks, or custom events",
-  "main": "dist/index.js",
-  "scripts": {
-    "dev": "ts-node src/index.ts",
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@backendkit-labs/agent-core": "^0.36.0",
-    "dotenv": "^16.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "ts-node": "^10.9.0",
-    "typescript": "^5.4.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  }
-}

package/templates/autonomous/src/index.ts

@@ -1,64 +0,0 @@
-import 'dotenv/config';
-import { createAutonomousAgent } 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); }
-
-// ── Autonomous agent ──────────────────────────────────────────────────────────
-
-const agent = createAutonomousAgent({
-    providers:       { [provider]: { apiKey } },
-    defaultProvider: provider,
-    agents:          [monitorAgent],
-    defaultAgent:    'monitor',
-    goal:            'TODO: describe the agent goal',
-
-    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,  // uncomment to validate signatures
-        },
-
-        // TODO: add more triggers as needed
-        // { type: 'event', topic: 'my.custom.event' },
-    ],
-
-    webhookPort: parseInt(process.env.WEBHOOK_PORT ?? '3000'),
-});
-
-// ── Start ─────────────────────────────────────────────────────────────────────
-
-await agent.start();
-console.log('Autonomous agent started.');
-console.log('Webhook listening on port', process.env.WEBHOOK_PORT ?? 3000);
-
-process.on('SIGTERM', async () => { await agent.stop(); process.exit(0); });
-process.on('SIGINT',  async () => { await agent.stop(); process.exit(0); });

package/templates/autonomous/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "commonjs",
-    "moduleResolution": "node16",
-    "lib": ["ES2022"],
-    "types": ["node"],
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "skipLibCheck": true,
-    "esModuleInterop": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

package/templates/base/multi-agent/src/providers/openai-compatible.ts

@@ -1,104 +0,0 @@
-import OpenAI from 'openai';
-import type { LLMProvider, LLMMessage, LLMStreamCallbacks, ToolDefinition } from '@backendkit-labs/agent-core';
-
-export interface OpenAICompatibleProviderOptions {
-    apiKey: string;
-    baseUrl: string;
-    model: string;
-    maxRetries?: number;
-}
-
-function isRetryable(err: unknown): boolean {
-    if (err && typeof err === 'object' && 'status' in err) {
-        const s = (err as { status: number }).status;
-        return s === 429 || s >= 500;
-    }
-    return false;
-}
-
-const sleep = (ms: number) => new Promise<void>(r => setTimeout(r, ms));
-
-export class OpenAICompatibleProvider implements LLMProvider {
-    private readonly client: OpenAI;
-    private readonly model: string;
-    private readonly maxRetries: number;
-
-    constructor(opts: OpenAICompatibleProviderOptions) {
-        this.client     = new OpenAI({ apiKey: opts.apiKey, baseURL: opts.baseUrl, maxRetries: 0 });
-        this.model      = opts.model;
-        this.maxRetries = opts.maxRetries ?? 3;
-    }
-
-    async chat(messages: LLMMessage[], tools: ToolDefinition[], callbacks: LLMStreamCallbacks): Promise<void> {
-        const oaiTools = tools.map(t => ({
-            type: 'function' as const,
-            function: { name: t.name, description: t.description, parameters: t.parameters },
-        })) as OpenAI.Chat.ChatCompletionTool[];
-
-        let attempt = 0;
-        let emitted = false;
-
-        while (attempt < this.maxRetries) {
-            attempt++;
-            try {
-                await this.stream(messages, oaiTools, {
-                    ...callbacks,
-                    onChunk: (d) => { emitted = true; callbacks.onChunk?.(d); },
-                });
-                return;
-            } catch (err) {
-                if (emitted || !isRetryable(err) || attempt >= this.maxRetries) {
-                    callbacks.onError(err instanceof Error ? err : new Error(String(err)));
-                    return;
-                }
-                await sleep(Math.min(1000 * 2 ** attempt, 16_000));
-            }
-        }
-    }
-
-    private async stream(
-        messages: LLMMessage[],
-        oaiTools: OpenAI.Chat.ChatCompletionTool[],
-        callbacks: LLMStreamCallbacks,
-    ): Promise<void> {
-        const stream = await this.client.chat.completions.create({
-            model: this.model,
-            messages: messages as OpenAI.Chat.ChatCompletionMessageParam[],
-            tools:       oaiTools.length ? oaiTools : undefined,
-            tool_choice: oaiTools.length ? 'auto'   : undefined,
-            stream: true,
-            stream_options: { include_usage: true },
-        });
-
-        let content = '';
-        const toolBuffers = new Map<number, { id: string; name: string; args: string }>();
-
-        for await (const chunk of stream) {
-            if (chunk.usage) callbacks.onMetrics?.(chunk.usage.prompt_tokens, chunk.usage.completion_tokens);
-            const delta = chunk.choices[0]?.delta;
-            if (!delta) continue;
-            if (delta.content) { content += delta.content; callbacks.onChunk?.(delta.content); }
-            if (delta.tool_calls) {
-                for (const tc of delta.tool_calls) {
-                    if (!toolBuffers.has(tc.index)) toolBuffers.set(tc.index, { id: '', name: '', args: '' });
-                    const buf = toolBuffers.get(tc.index)!;
-                    if (tc.id) buf.id = tc.id;
-                    if (tc.function?.name)      buf.name += tc.function.name;
-                    if (tc.function?.arguments) buf.args += tc.function.arguments;
-                }
-            }
-        }
-
-        const toolCalls = [...toolBuffers.entries()]
-            .sort(([a], [b]) => a - b)
-            .map(([, b]) => ({ id: b.id, type: 'function' as const, function: { name: b.name, arguments: b.args } }));
-
-        for (const tc of toolCalls) callbacks.onToolCall?.(tc.function.name, tc.function.arguments, tc.id);
-
-        callbacks.onDone({
-            role: 'assistant',
-            content: content || null,
-            tool_calls: toolCalls.length ? toolCalls : undefined,
-        });
-    }
-}