create-bk-agent 0.17.1 → 0.17.2

package/package.json

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

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

@@ -1,5 +1,7 @@
 import 'dotenv/config';
-import { createAutonomousAgent } from '@backendkit-labs/agent-core';
+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 ──────────────────────────────────────────────────────────
@@ -23,6 +25,18 @@ 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
@@ -32,6 +46,7 @@ const agent = createAutonomousAgent({
     agents:          [monitorAgent],
     defaultAgent:    'monitor',
     goal:            'TODO: describe the agent goal',
+    memorySystem:    memory,
 
     triggers: [
         // Run every day at 9:00 AM
@@ -45,7 +60,7 @@ const agent = createAutonomousAgent({
         {
             type:   'webhook',
             path:   '/events',
-            // secret: process.env.WEBHOOK_SECRET,  // uncomment to validate signatures
+            // secret: process.env.WEBHOOK_SECRET,
         },
 
         // TODO: add more triggers as needed
@@ -61,6 +76,7 @@ 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/multi-agent/src/engine.ts

@@ -1,9 +1,12 @@
+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';
@@ -12,6 +15,24 @@ 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();
 
@@ -19,6 +40,8 @@ export function createEngine(transport: CallbackTransport): AgentEngine {
     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();
@@ -36,7 +59,7 @@ export function createEngine(transport: CallbackTransport): AgentEngine {
     }));
 
     return new AgentEngine({
-        model:           { provider: 'default', id: config.llmModel },
+        model:            { provider: 'default', id: config.llmModel },
         agents,
         tools,
         providers,
@@ -45,5 +68,10 @@ export function createEngine(transport: CallbackTransport): AgentEngine {
         transport,
         maxIterations:    30,
         iterationMode:    'auto',
+        // Conversation history — persists between runs
+        historyPath:      HISTORY,
+        maxContextMessages: 100,
+        // Long-term memory — injects relevant context each turn
+        memorySystem:     memory,
     });
 }

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

@@ -1,15 +1,33 @@
+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();
 
@@ -17,6 +35,7 @@ export function createEngine(transport: CallbackTransport): AgentEngine {
     tools
         .register(exampleAction)
         .register(exampleQuery);
+    for (const t of memory.getTools()) tools.register(t);
     // TODO: register more tools
 
     const agents = new AgentRegistry();
@@ -31,7 +50,7 @@ export function createEngine(transport: CallbackTransport): AgentEngine {
     }));
 
     return new AgentEngine({
-        model:           { provider: 'default', id: config.llmModel },
+        model:            { provider: 'default', id: config.llmModel },
         agents,
         tools,
         providers,
@@ -40,5 +59,8 @@ export function createEngine(transport: CallbackTransport): AgentEngine {
         transport,
         maxIterations:    20,
         iterationMode:    'auto',
+        historyPath:      HISTORY,
+        maxContextMessages: 100,
+        memorySystem:     memory,
     });
 }