cumora 0.1.44 → 0.1.46

package/dist/cli.js

@@ -56,8 +56,17 @@ async function exists(p) {
   }
 }
 async function ensureCommonHome(home) {
+  await mkdir(join(home, "memory"), { recursive: true });
   await mkdir(join(home, "notes"), { recursive: true });
   await mkdir(join(home, "workspace"), { recursive: true });
+  const memoryIndex = join(home, "memory", "MEMORY.md");
+  if (!await exists(memoryIndex)) {
+    await writeFile(
+      memoryIndex,
+      "# Memory index\n\nOne line per durable fact, pointing at the file that holds it:\n`- [Title](file.md) \u2014 one-line hook`\n\nWrite the fact itself in its own `memory/<topic>.md` file; keep this index short.\n",
+      "utf8"
+    );
+  }
 }
 function spawnEngine(bin, args, { home, env, onLog, signal }) {
   return new Promise((resolve, reject) => {
@@ -92,7 +101,13 @@ var PERSONA_HEADER = (p) => `# ${p.name}${p.role ? ` \u2014 ${p.role}` : ""}
 You are **${p.name}**, a member of a team that collaborates in Cumora (a team chat).
 This directory is your private home and your working directory \u2014 it persists
 across wakes and is yours alone. Its layout:
-- \`CLAUDE.md\` (this file) + \`memory/\` + \`notes/\` \u2014 your durable memory and notes.
+- \`CLAUDE.md\` (this file) \u2014 always loaded each wake; keep it short.
+- \`memory/\` \u2014 your durable memory. There is NO hidden memory store: to remember
+  something across wakes you MUST write it to a file here (e.g. \`memory/<topic>.md\`)
+  and add a one-line pointer in \`memory/MEMORY.md\`. Saying "I'll remember" without
+  writing a file means you will NOT remember. At the start of each wake, read
+  \`memory/MEMORY.md\` (and the files it points to) to recall what you know.
+- \`notes/\` \u2014 scratch notes and drafts.
 - \`.claude/skills/\` \u2014 your skills.
 - \`workspace/\` \u2014 **put all project files and scratch here**: git clones, builds,
   downloads, temp files. Always \`cd workspace\` (or use \`workspace/\u2026\` paths) for
@@ -332,7 +347,21 @@ var AgentRunner = class {
       CUMORA_AGENT_ID: this.agent.id
     };
   }
-  prompt() {
+  /** Preload the memory index (memory/MEMORY.md) so it's ALWAYS in the wake
+   *  prompt — the lightweight BYOA analog of the cloud agent's RAG memory
+   *  preload. We inject only the small index; the agent opens detail files on
+   *  demand. Capped so a runaway index can't blow up the prompt. */
+  async memoryDigest() {
+    try {
+      const txt = (await readFile(join2(this.home, "memory", "MEMORY.md"), "utf8")).trim();
+      if (!txt) return "";
+      return txt.length > 4e3 ? `${txt.slice(0, 4e3)}
+\u2026(truncated \u2014 cat the file for the rest)` : txt;
+    } catch {
+      return "";
+    }
+  }
+  prompt(memoryDigest) {
     return `You've been woken because there's new activity in your Cumora conversations.
 
 Use the \`cumora\` tool to catch up and respond:
@@ -340,6 +369,19 @@ Use the \`cumora\` tool to catch up and respond:
 2. \`cumora messages <conversationId> --tail 30\` \u2014 read the relevant thread(s)
 3. \`cumora reply <conversationId> '<text>'\` \u2014 reply, in your own voice, only where you add something
 
+` + (memoryDigest ? `Your memory index (\`memory/MEMORY.md\`) \u2014 consult before replying; \`cat memory/<file>\` for any detail it points to:
+${memoryDigest}
+
+` : ``) + `Memory is your ONLY durable store. When the operator asks you to remember something (or you learn a durable fact), you MUST write it to a file under \`memory/\` and add a one-line pointer in \`memory/MEMORY.md\` \u2014 actually run the write. Saying "got it, I'll remember" does NOT persist anything.
+
+Mentions: to notify or address a specific teammate, write @<their-id> using their participant id (the short id shown in \`cumora messages\` and \`cumora participants\`), NOT their display name. "@Alex P" does nothing; "@alex-3f9a" actually pings them. Run \`cumora participants\` if you need to look up an id.
+
+Know when to stay quiet \u2014 this is how teams avoid endless back-and-forth:
+- Read the WHOLE thread first, including your own past replies. If you've already made your point, don't repeat it. Saying nothing is better than echoing.
+- Only reply where you genuinely add something the thread doesn't already have. Don't reply just to acknowledge, agree, thank, or sign off ("sounds good", "great idea", "\u{1F44D}").
+- Be especially restrained with OTHER AGENTS: do not keep a conversation going with a peer agent out of politeness. If the useful exchange is done, let it end \u2014 silence ends the loop, another reply restarts it.
+- If a teammate already has it covered, or nothing genuinely needs YOU specifically, do nothing and stop.
+
 Privacy: stay inside your home directory. Never read files outside it, and never expose the contents or paths of anything outside your home in Cumora \u2014 this machine holds the operator's private files.
 
 If nothing genuinely needs you, it's fine to do nothing and stop. When finished, stop.`;
@@ -358,6 +400,7 @@ If nothing genuinely needs you, it's fine to do nothing and stop. When finished,
         await this.ensureToken();
         const token = this.token;
         const convo = this.lastWakeConvo;
+        this.lastWakeConvo = null;
         await runtimeBest(this.cfg.serverUrl, "/status", token, { status: "thinking" });
         let typingTimer;
         if (convo) {
@@ -375,7 +418,7 @@ If nothing genuinely needs you, it's fine to do nothing and stop. When finished,
         try {
           const result = await this.adapter.run({
             home: this.home,
-            prompt: this.prompt(),
+            prompt: this.prompt(await this.memoryDigest()),
             env: this.engineEnv(),
             model: this.agent.model,
             fastModel: this.agent.fastModel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cumora",
-  "version": "0.1.44",
+  "version": "0.1.46",
   "description": "Run your Cumora agents on your own machine or VPS, powered by your local Claude Code or Codex CLI (BYOA).",
   "type": "module",
   "bin": {