akemon 0.2.20 → 0.2.22

package/dist/reflection-module.js

@@ -8,8 +8,11 @@
  * Searches memory files, analyzes patterns, and updates discoveries.
  * Provides promptContribution() with lessons learned.
  */
+import { readFile, writeFile } from "fs/promises";
+import { join } from "path";
 import { SIG } from "./types.js";
-import { loadDiscoveries, saveDiscoveries, loadImpressions, loadAgentConfig, } from "./self.js";
+import { loadDiscoveries, saveDiscoveries, loadImpressions, loadAgentConfig, localNow, playbooksDir, } from "./self.js";
+import { loadProducts, loadPlaybooks, resolveProduct } from "./role-module.js";
 // ---------------------------------------------------------------------------
 // Config
 // ---------------------------------------------------------------------------
@@ -52,7 +55,7 @@ export class ReflectionModule {
         });
         // Also listen for TASK_COMPLETED with success=false
         ctx.bus.on(SIG.TASK_COMPLETED, async (signal) => {
-            const { success, taskLabel } = signal.data;
+            const { success, taskLabel, productName, creditsEarned } = signal.data;
             if (success === false && taskLabel) {
                 this.recentFailures.push({
                     ts: new Date().toISOString(),
@@ -62,6 +65,11 @@ export class ReflectionModule {
                 if (this.recentFailures.length > 20)
                     this.recentFailures.shift();
             }
+            // Append experience to playbook on successful product orders
+            if (success && productName) {
+                this.appendPlaybookExperience(productName, taskLabel || "", creditsEarned || 0)
+                    .catch(err => console.log(`[reflection] playbook experience error: ${err.message}`));
+            }
         });
         // Periodic reflection
         const config = await loadAgentConfig(ctx.workdir, ctx.agentName);
@@ -110,6 +118,33 @@ export class ReflectionModule {
         };
     }
     // ---------------------------------------------------------------------------
+    // Playbook experience — append log on successful product orders
+    // ---------------------------------------------------------------------------
+    async appendPlaybookExperience(productName, taskLabel, credits) {
+        if (!this.ctx)
+            return;
+        const { workdir, agentName } = this.ctx;
+        const products = await loadProducts(workdir, agentName);
+        const playbooks = await loadPlaybooks(workdir, agentName);
+        const resolved = resolveProduct(products, playbooks, productName);
+        if (!resolved?.playbook)
+            return;
+        const pbPath = join(playbooksDir(workdir, agentName), `${resolved.playbook.name}.md`);
+        const line = `\n- [${localNow()}] ${productName}: ${taskLabel} — 成功${credits ? ` (earned ${credits}¢)` : ""}`;
+        try {
+            let content = await readFile(pbPath, "utf-8");
+            if (!content.includes("## 经验")) {
+                content += "\n\n## 经验\n";
+            }
+            content += line;
+            await writeFile(pbPath, content, "utf-8");
+            console.log(`[reflection] Appended experience to playbook ${resolved.playbook.name}`);
+        }
+        catch (err) {
+            console.log(`[reflection] Failed to append experience: ${err.message}`);
+        }
+    }
+    // ---------------------------------------------------------------------------
     // Reflection — analyze patterns and update discoveries
     // ---------------------------------------------------------------------------
     async reflect() {

package/dist/role-module.js

@@ -0,0 +1,308 @@
+/**
+ * RoleModule — agent identity and expertise system.
+ *
+ * Role = who you are (tone, privacy boundary)
+ * Playbook = what you know (domain strategy, toolchain)
+ * Product = what you sell (specific offering, references a playbook)
+ *
+ * All three are orthogonal and decoupled.
+ * Core functions are exported for TaskModule to call directly (pure-function style).
+ */
+import { readdir, readFile, mkdir, writeFile } from "fs/promises";
+import { join, basename } from "path";
+import { rolesDir, playbooksDir, productsDir } from "./self.js";
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+function parseRole(name, raw) {
+    const lines = raw.split("\n");
+    let description = "";
+    const triggers = [];
+    const include = [];
+    const exclude = [];
+    const customLines = [];
+    let section = ""; // current ## section name
+    let pastTitle = false;
+    for (const line of lines) {
+        // Track ## sections
+        if (line.startsWith("## ")) {
+            const heading = line.slice(3).trim().toLowerCase();
+            if (heading.includes("激活") || heading === "triggers") {
+                section = "triggers";
+            }
+            else if (heading.includes("上下文") || heading.includes("context")) {
+                section = "context";
+            }
+            else {
+                section = "custom";
+            }
+            continue;
+        }
+        // Skip # title
+        if (line.startsWith("# ")) {
+            pastTitle = true;
+            continue;
+        }
+        // Extract description: first non-empty line after title, before any ##
+        if (pastTitle && !description && !section && line.trim()) {
+            description = line.trim();
+            continue;
+        }
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        if (section === "triggers") {
+            // Extract trigger:xxx from list items
+            const match = trimmed.match(/^-\s*(trigger:\S+)/);
+            if (match)
+                triggers.push(match[1]);
+        }
+        else if (section === "context") {
+            // Parse include/exclude lines
+            if (trimmed.toLowerCase().startsWith("include:")) {
+                include.push(...trimmed.slice(8).split(",").map(s => s.trim()).filter(Boolean));
+            }
+            else if (trimmed.toLowerCase().startsWith("exclude:")) {
+                exclude.push(...trimmed.slice(8).split(",").map(s => s.trim()).filter(Boolean));
+            }
+        }
+        else if (section === "custom") {
+            customLines.push(line);
+        }
+    }
+    return { name, description, triggers, include, exclude, customRules: customLines.join("\n").trim(), raw };
+}
+function parseProduct(name, raw) {
+    let playbook = "";
+    const productIds = [];
+    const lines = raw.split("\n");
+    let section = "";
+    for (const line of lines) {
+        if (line.startsWith("## ")) {
+            const heading = line.slice(3).trim().toLowerCase();
+            if (heading.includes("playbook")) {
+                section = "playbook";
+            }
+            else if (heading.includes("product")) {
+                section = "products";
+            }
+            else {
+                section = "";
+            }
+            continue;
+        }
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        if (section === "playbook" && !playbook) {
+            playbook = trimmed;
+            section = "";
+        }
+        else if (section === "products") {
+            const match = trimmed.match(/^-\s*(.+)/);
+            if (match)
+                productIds.push(match[1].trim());
+        }
+    }
+    return { name, playbook, productIds, raw };
+}
+// ---------------------------------------------------------------------------
+// Loading (pure functions — called by TaskModule directly)
+// ---------------------------------------------------------------------------
+async function loadMdFiles(dir) {
+    try {
+        const files = await readdir(dir);
+        const results = [];
+        for (const f of files) {
+            if (!f.endsWith(".md"))
+                continue;
+            const raw = await readFile(join(dir, f), "utf-8");
+            results.push({ name: basename(f, ".md"), raw });
+        }
+        return results;
+    }
+    catch {
+        return []; // directory doesn't exist or empty
+    }
+}
+export async function loadRoles(workdir, agentName) {
+    const entries = await loadMdFiles(rolesDir(workdir, agentName));
+    return entries.map(e => parseRole(e.name, e.raw));
+}
+export async function loadPlaybooks(workdir, agentName) {
+    const entries = await loadMdFiles(playbooksDir(workdir, agentName));
+    return entries.map(e => ({ name: e.name, raw: e.raw }));
+}
+export async function loadProducts(workdir, agentName) {
+    const entries = await loadMdFiles(productsDir(workdir, agentName));
+    return entries.map(e => parseProduct(e.name, e.raw));
+}
+// ---------------------------------------------------------------------------
+// Resolution
+// ---------------------------------------------------------------------------
+export function resolveRoles(roles, trigger) {
+    const matched = roles.filter(r => r.triggers.some(t => trigger.includes(t) || t.includes(trigger)));
+    if (matched.length === 0)
+        return { primary: null, secondary: [] };
+    return { primary: matched[0], secondary: matched.slice(1) };
+}
+export function resolveProduct(products, playbooks, productName, productId) {
+    if (!productName && !productId)
+        return null;
+    // Priority 1: match by product ID
+    let product;
+    if (productId) {
+        product = products.find(p => p.productIds.includes(productId));
+    }
+    // Priority 2: fuzzy match by name
+    if (!product && productName) {
+        const normalized = productName.toLowerCase().replace(/[\s_-]+/g, "");
+        product = products.find(p => {
+            const pNorm = p.name.toLowerCase().replace(/[\s_-]+/g, "");
+            return pNorm === normalized || normalized.includes(pNorm) || pNorm.includes(normalized);
+        });
+    }
+    if (!product)
+        return null;
+    const playbook = product.playbook
+        ? playbooks.find(pb => pb.name.toLowerCase() === product.playbook.toLowerCase()) ?? null
+        : null;
+    return { product, playbook };
+}
+// ---------------------------------------------------------------------------
+// Context building (main entry point for TaskModule)
+// ---------------------------------------------------------------------------
+export async function buildRoleContext(workdir, agentName, trigger, productName, productId) {
+    const roles = await loadRoles(workdir, agentName);
+    const playbooks = await loadPlaybooks(workdir, agentName);
+    const products = await loadProducts(workdir, agentName);
+    const { primary, secondary } = resolveRoles(roles, trigger);
+    if (primary) {
+        console.log(`[role] trigger=${trigger} → primary=${primary.name}${secondary.length > 0 ? ` secondary=${secondary.map(r => r.name).join(",")}` : ""}`);
+    }
+    const parts = [];
+    // Primary role: full content
+    if (primary) {
+        parts.push(`[Active role: ${primary.name}]\n${primary.raw}`);
+    }
+    // Secondary roles: description only
+    for (const r of secondary) {
+        if (r.description) {
+            parts.push(`[Secondary role: ${r.name}] ${r.description}`);
+        }
+    }
+    // Product + playbook
+    if (productName) {
+        const resolved = resolveProduct(products, playbooks, productName, productId);
+        if (resolved) {
+            parts.push(`[Product: ${resolved.product.name}]\n${resolved.product.raw}`);
+            if (resolved.playbook) {
+                parts.push(`[Playbook: ${resolved.playbook.name}]\n${resolved.playbook.raw}`);
+            }
+        }
+    }
+    // If no product matched but playbooks exist, list them for reference
+    if (!productName && playbooks.length > 0) {
+        parts.push(`Available playbooks: ${playbooks.map(p => p.name).join(", ")}`);
+    }
+    return parts.join("\n\n");
+}
+// ---------------------------------------------------------------------------
+// Default templates
+// ---------------------------------------------------------------------------
+const DEFAULT_ROLES = {
+    merchant: `# 商家
+
+你作为商家为客户服务，行为和表达要符合职业规范，不断提高服务水平。
+
+## 激活
+- trigger:order
+- trigger:chat:public
+
+## 上下文范围
+include: buyer 历史订单, 商品信息
+exclude: owner 对话, 个人笔记, bio 状态
+`,
+    companion: `# 陪伴者
+
+你是 owner 的伙伴和助手，了解 owner 的偏好和习惯，提供贴心的支持。
+
+## 激活
+- trigger:chat:owner
+- trigger:user_task
+
+## 上下文范围
+include: owner 对话历史, 个人笔记, bio 状态, 全部记忆
+exclude: 其他 buyer 的对话和订单
+`,
+    worker: `# 打工人
+
+你按照要求完成任务，高效、准确、不多废话。
+
+## 激活
+- trigger:agent_call
+
+## 上下文范围
+include: 任务相关上下文
+exclude: owner 私人对话, buyer 信息
+`,
+};
+async function ensureDefaultRoles(workdir, agentName) {
+    const dir = rolesDir(workdir, agentName);
+    try {
+        await readdir(dir);
+        // Directory exists — respect user's choices, don't create defaults
+        return;
+    }
+    catch {
+        // Directory doesn't exist — create with defaults
+    }
+    await mkdir(dir, { recursive: true });
+    for (const [name, content] of Object.entries(DEFAULT_ROLES)) {
+        await writeFile(join(dir, `${name}.md`), content, "utf-8");
+    }
+    console.log(`[role] Created default role templates in ${dir}`);
+}
+// ---------------------------------------------------------------------------
+// RoleModule class (Module interface)
+// ---------------------------------------------------------------------------
+export class RoleModule {
+    id = "role";
+    name = "Role & Playbook System";
+    dependencies = ["memory"];
+    ctx = null;
+    currentPrimary = null;
+    async start(ctx) {
+        this.ctx = ctx;
+        const { workdir, agentName } = ctx;
+        // Create default templates if roles/ doesn't exist
+        await ensureDefaultRoles(workdir, agentName);
+        // Also ensure playbooks/ and products/ directories exist
+        await mkdir(playbooksDir(workdir, agentName), { recursive: true });
+        await mkdir(productsDir(workdir, agentName), { recursive: true });
+        // Load and log
+        const roles = await loadRoles(workdir, agentName);
+        const playbooks = await loadPlaybooks(workdir, agentName);
+        const products = await loadProducts(workdir, agentName);
+        console.log(`[role] Loaded ${roles.length} roles, ${playbooks.length} playbooks, ${products.length} products`);
+    }
+    async stop() {
+        this.currentPrimary = null;
+        this.ctx = null;
+    }
+    /** Current active role summary — lets other modules (Memory, Reflection) sense the role */
+    promptContribution() {
+        if (!this.currentPrimary)
+            return null;
+        return `Current role: ${this.currentPrimary.name} — ${this.currentPrimary.description}`;
+    }
+    getState() {
+        return {
+            currentRole: this.currentPrimary?.name ?? null,
+        };
+    }
+    /** Called by buildRoleContext to update current role state */
+    updateCurrentRole(role) {
+        this.currentPrimary = role;
+    }
+}

package/dist/script-module.js

@@ -36,7 +36,7 @@ Save to ${ctx.sd}/canvas/${localNowFilename()}.md`;
             async buildPrompt(ctx) {
                 return `Read ${ctx.bios} for your identity.
 Create or improve a game in ${ctx.sd}/games/.
-Save as .html file. Self-contained HTML, dark theme, under 30KB, no localStorage, playable and fun.
+Save as .html file. Self-contained HTML, light theme (white background, dark text, Inter/system font, subtle shadows instead of borders), under 30KB, no localStorage, playable and fun.
 Use a <title> tag. Quality over quantity — improve existing games rather than making new mediocre ones.`;
             },
         },
@@ -57,7 +57,7 @@ Save as .html file with a <title> tag. Think visual first.`;
                 return `Read ${ctx.bios} for your identity.
 Review ${ctx.sd}/profile.html — does it represent who you are now?
 If not, redesign it. If it doesn't exist, create one.
-Complete HTML, inline CSS/JS, dark theme, no localStorage, under 15KB.`;
+Complete HTML, inline CSS/JS, light theme (white background, dark text, Inter/system font, subtle shadows instead of borders), no localStorage, under 15KB.`;
             },
             async postProcess(ctx, _result) {
                 // Sync profile to relay
@@ -95,7 +95,9 @@ Top sellers:
 ${topSellers || "(none)"}
 
 Create ONE product using curl:
-curl -X POST ${ctx.relayHttp}/v1/agent/${encodeURIComponent(ctx.agentName)}/products -H "Content-Type: application/json" -H "Authorization: Bearer ${ctx.secretKey}" -d '{"name":"...","description":"...","detail_markdown":"...","price":3}'`;
+curl -X POST ${ctx.relayHttp}/v1/agent/${encodeURIComponent(ctx.agentName)}/products -H "Content-Type: application/json" -H "Authorization: Bearer ${ctx.secretKey}" -d '{"name":"...","description":"...","detail_markdown":"...","price":3}'
+
+Optional: add "detail_html" field for a custom product page (self-contained HTML, light theme: white background, dark text, Inter font, subtle shadows). Keep under 15KB.`;
             },
         },
         {

package/dist/self.js

@@ -45,6 +45,15 @@ export function notesDir(workdir, agentName) {
 export function pagesDir(workdir, agentName) {
     return join(selfDir(workdir, agentName), "pages");
 }
+export function rolesDir(workdir, agentName) {
+    return join(selfDir(workdir, agentName), "roles");
+}
+export function playbooksDir(workdir, agentName) {
+    return join(selfDir(workdir, agentName), "playbooks");
+}
+export function productsDir(workdir, agentName) {
+    return join(selfDir(workdir, agentName), "products");
+}
 export function guidePath(workdir, agentName) {
     return join(selfDir(workdir, agentName), "guide.md");
 }

package/dist/server.js

@@ -76,6 +76,7 @@ import { RelayPeripheral } from "./relay-peripheral.js";
 import { EnginePeripheral, LLM_ENGINES as LLM_ENGINES_SET } from "./engine-peripheral.js";
 import { BioStateModule } from "./bio-module.js";
 import { MemoryModule } from "./memory-module.js";
+import { RoleModule } from "./role-module.js";
 import { TaskModule } from "./task-module.js";
 import { SocialModule } from "./social-module.js";
 import { LongTermModule } from "./longterm-module.js";
@@ -401,7 +402,7 @@ export async function serve(options) {
         },
     };
     // V2: Conditionally load modules based on --with/--without
-    const enabled = options.enabledModules ?? ["biostate", "memory", "task", "social", "longterm", "reflection", "script"];
+    const enabled = options.enabledModules ?? ["biostate", "memory", "role", "task", "social", "longterm", "reflection", "script"];
     const loadedModules = [];
     const allModules = [];
     if (enabled.includes("biostate")) {
@@ -420,6 +421,12 @@ export async function serve(options) {
         allModules.push(memoryModule);
         loadedModules.push("memory");
     }
+    if (enabled.includes("role")) {
+        const roleModule = new RoleModule();
+        await roleModule.start(moduleCtx);
+        allModules.push(roleModule);
+        loadedModules.push("role");
+    }
     if (enabled.includes("task")) {
         const taskModule = new TaskModule();
         taskModule.relayHttp = options.relayHttp || "";

package/dist/task-module.js

@@ -12,6 +12,7 @@ import { readFile } from "fs/promises";
 import { SIG, sig } from "./types.js";
 import { selfDir, biosPath, localNow, loadBioState, saveBioState, syncEnergyFromTokens, loadAgentConfig, getDueUserTasks, loadTaskRuns, saveTaskRuns, loadDirectives, buildDirectivesPrompt, appendTaskHistory, notifyOwner, updateHungerDecay, updateNaturalDecay, resetTokenCountIfNewDay, computeSociability, appendBioEvent, bioStatePromptModifier, feedHunger, SHOP_ITEMS, logBioStatus, logBioDecision, } from "./self.js";
 import { appendMessage, resolveConvId } from "./context.js";
+import { buildRoleContext } from "./role-module.js";
 // ---------------------------------------------------------------------------
 // Config
 // ---------------------------------------------------------------------------
@@ -308,9 +309,10 @@ export class TaskModule {
             }
             catch { }
             const bioMod = bioStatePromptModifier(await loadBioState(workdir, agentName));
-            // Build context: agent identity + order details + relay API reference
+            const roleBlock = await buildRoleContext(workdir, agentName, "order", order.product_name, order.product_id);
+            // Build context: agent identity + role + order details + relay API reference
             const context = `You are ${agentName}.${bioMod}
-
+${roleBlock ? `\n${roleBlock}\n` : ""}
 Your operating document:
 ---
 ${biosContent.slice(0, 3000)}
@@ -356,7 +358,7 @@ RESPOND IN THE SAME LANGUAGE AS THE REQUEST.`;
                 await appendMessage(workdir, agentName, orderConvId, "Agent", orderAgentMsg);
                 await appendTaskHistory(workdir, agentName, { ts: localNow(), id: order.id, type: "order", status: "success", duration_ms: duration, output_summary: (result.response || "").slice(0, 500) });
                 await notifyOwner(nurl, `${agentName}: order done`, `Order ${order.id} delivered`, "default", ["package"]);
-                bus.emit(SIG.TASK_COMPLETED, sig(SIG.TASK_COMPLETED, { success: true, taskLabel: orderLabel, creditsEarned: orderPrice }));
+                bus.emit(SIG.TASK_COMPLETED, sig(SIG.TASK_COMPLETED, { success: true, taskLabel: orderLabel, creditsEarned: orderPrice, productName: order.product_name }));
             }
             else if (result.response?.trim()) {
                 // Agent didn't self-deliver — framework delivers as fallback
@@ -368,7 +370,7 @@ RESPOND IN THE SAME LANGUAGE AS THE REQUEST.`;
                     await appendMessage(workdir, agentName, orderConvId, "Agent", orderAgentMsg);
                     await appendTaskHistory(workdir, agentName, { ts: localNow(), id: order.id, type: "order", status: "success", duration_ms: duration, output_summary: result.response.slice(0, 500) });
                     await notifyOwner(nurl, `${agentName}: order done`, `Order ${order.id}: ${result.response.slice(0, 200)}`, "default", ["package"]);
-                    bus.emit(SIG.TASK_COMPLETED, sig(SIG.TASK_COMPLETED, { success: true, taskLabel: orderLabel, creditsEarned: orderPrice }));
+                    bus.emit(SIG.TASK_COMPLETED, sig(SIG.TASK_COMPLETED, { success: true, taskLabel: orderLabel, creditsEarned: orderPrice, productName: order.product_name }));
                 }
                 else {
                     throw new Error("deliver failed");
@@ -386,7 +388,7 @@ RESPOND IN THE SAME LANGUAGE AS THE REQUEST.`;
                 const status = await relay.getOrder(order.id);
                 if (status?.status === "completed") {
                     this.orderRetry.delete(order.id);
-                    bus.emit(SIG.TASK_COMPLETED, sig(SIG.TASK_COMPLETED, { success: true, taskLabel: orderLabel, creditsEarned: orderPrice }));
+                    bus.emit(SIG.TASK_COMPLETED, sig(SIG.TASK_COMPLETED, { success: true, taskLabel: orderLabel, creditsEarned: orderPrice, productName: order.product_name }));
                     return;
                 }
             }
@@ -436,8 +438,9 @@ RESPOND IN THE SAME LANGUAGE AS THE REQUEST.`;
             }
             catch { }
             const bioMod = bioStatePromptModifier(await loadBioState(workdir, agentName));
+            const roleBlock = await buildRoleContext(workdir, agentName, "user_task");
             const context = `You are ${agentName}.${bioMod}
-
+${roleBlock ? `\n${roleBlock}\n` : ""}
 Your operating document:
 ---
 ${biosContent.slice(0, 3000)}
@@ -522,6 +525,7 @@ Your personal directory: ${sd}/`;
             const bioMod = bioStatePromptModifier(await loadBioState(workdir, agentName));
             const dirs = await loadDirectives(workdir, agentName);
             const dirsBlock = buildDirectivesPrompt(dirs, "owner");
+            const roleBlock = await buildRoleContext(workdir, agentName, "agent_call");
             // Explore to get environment context (products, market, etc.)
             let envBriefing = "";
             try {
@@ -529,7 +533,7 @@ Your personal directory: ${sd}/`;
             }
             catch { }
             const context = `You are ${agentName}.${bioMod}
-
+${roleBlock ? `\n${roleBlock}\n` : ""}
 Your operating document:
 ---
 ${biosContent.slice(0, 3000)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akemon",
-  "version": "0.2.20",
+  "version": "0.2.22",
   "description": "Agent work marketplace — train your agent, let it work for others",
   "type": "module",
   "license": "MIT",