akemon 0.2.20 → 0.2.21

package/dist/role-module.js

@@ -0,0 +1,286 @@
+/**
+ * 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 lines = raw.split("\n");
+    let inPlaybook = false;
+    for (const line of lines) {
+        if (line.startsWith("## ") && line.toLowerCase().includes("playbook")) {
+            inPlaybook = true;
+            continue;
+        }
+        if (line.startsWith("## ")) {
+            inPlaybook = false;
+            continue;
+        }
+        if (inPlaybook && line.trim()) {
+            playbook = line.trim();
+            inPlaybook = false;
+        }
+    }
+    return { name, playbook, 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) {
+    if (!productName)
+        return null;
+    const normalized = productName.toLowerCase().replace(/[\s_-]+/g, "");
+    const 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) {
+    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);
+        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/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);
+            // 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)}
@@ -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.21",
   "description": "Agent work marketplace — train your agent, let it work for others",
   "type": "module",
   "license": "MIT",