@poncho-ai/harness 0.59.12 → 0.59.13

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.59.12 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.59.13 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
 > node scripts/embed-docs.js && tsup src/index.ts --format esm --dts
 
 [embed-docs] Generated poncho-docs.ts with 4 topics
@@ -9,8 +9,8 @@
 CLI Target: es2022
 ESM Build start
 ESM dist/isolate-F2PPSUL6.js 53.82 KB
-ESM dist/index.js            560.73 KB
-ESM ⚡️ Build success in 254ms
+ESM dist/index.js            561.36 KB
+ESM ⚡️ Build success in 214ms
 DTS Build start
-DTS ⚡️ Build success in 8487ms
+DTS ⚡️ Build success in 8568ms
 DTS dist/index.d.ts 102.50 KB

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @poncho-ai/harness
 
+## 0.59.13
+
+### Patch Changes
+
+- [`bf77523`](https://github.com/cesr/poncho-ai/commit/bf775237af883a53ee90f0a620434a1929ac82ea) Thanks [@cesr](https://github.com/cesr)! - `memory_main_edit` now treats an empty `old_str` as append: `new_str` is
+  appended to the end of memory (separated by a blank line when memory is
+  non-empty). This also handles the first-ever write into empty memory, so
+  `memory_main_edit` alone can bootstrap, add new facts, and edit existing
+  text — consumers that want to drop `memory_main_write` from the tool
+  surface no longer lose the ability to seed empty memory.
+
+  Both `memory_main_edit` and `memory_main_write` now return a minimal
+  `{ ok: true, bytes }` result instead of echoing the entire memory
+  document back as the tool result, which kept re-injecting the whole
+  document into the conversation on every targeted edit.
+
 ## 0.59.12
 
 ### Patch Changes

package/dist/index.js

@@ -1642,7 +1642,7 @@ When \`memory.enabled\` is true in \`poncho.config.js\`, the harness enables a s
 
 - A single persistent main memory document is loaded at run start and interpolated into the system prompt under \`## Persistent Memory\`.
 - \`memory_main_write\` overwrites the entire memory document (for initial writes or full rewrites).
-- \`memory_main_edit\` performs targeted string-replacement edits on memory (find \`old_str\`, replace with \`new_str\`), mirroring \`edit_file\` semantics. The tool description instructs the model to proactively evaluate each turn whether durable memory should be updated.
+- \`memory_main_edit\` performs targeted string-replacement edits on memory (find \`old_str\`, replace with \`new_str\`), mirroring \`edit_file\` semantics. An empty \`old_str\` appends \`new_str\` to the end of memory, which also handles the first-ever write into empty memory. The tool description instructs the model to proactively evaluate each turn whether durable memory should be updated.
 - \`conversation_recall\` can search, browse, and fetch past conversations. It supports keyword search (scoring by relevance), date-range filtering (\`after\`/\`before\`), and fetching a specific conversation's full message history by ID.
 
 \`\`\`javascript
@@ -5970,22 +5970,22 @@ var createMemoryTools = (store, options) => {
           throw new Error("content is required");
         }
         const memory = await resolveStore(context).updateMainMemory({ content });
-        return { ok: true, memory };
+        return { ok: true, bytes: memory.content.length };
       }
     }),
     defineTool6({
       name: "memory_main_edit",
-      description: "Edit persistent main memory by replacing an exact string match with new content. The old_str must match exactly one location in memory. Use an empty new_str to delete matched content. Proactively evaluate every turn whether memory should be updated.",
+      description: "Edit persistent main memory. With a non-empty old_str, replace that exact string (which must match exactly one location) with new_str; use an empty new_str to delete the matched content. With an empty old_str, append new_str to the end of memory \u2014 use this to add a brand-new fact or to write the first fact when memory is still empty. Proactively evaluate every turn whether memory should be updated.",
       inputSchema: {
         type: "object",
         properties: {
           old_str: {
             type: "string",
-            description: "The exact text to find and replace (must be unique in memory). Include surrounding context if needed to ensure uniqueness."
+            description: "The exact text to find and replace (must be unique in memory). Include surrounding context if needed to ensure uniqueness. Leave empty to append new_str to the end of memory instead."
           },
           new_str: {
             type: "string",
-            description: "The replacement text (use empty string to delete the matched content)"
+            description: "The replacement text (use empty string to delete the matched content), or the text to append when old_str is empty."
           }
         },
         required: ["old_str", "new_str"],
@@ -5994,26 +5994,33 @@ var createMemoryTools = (store, options) => {
       handler: async (input, context) => {
         const oldStr = typeof input.old_str === "string" ? input.old_str : "";
         const newStr = typeof input.new_str === "string" ? input.new_str : "";
-        if (!oldStr) {
-          throw new Error("old_str must not be empty.");
-        }
         const current = await resolveStore(context).getMainMemory();
         const content = current.content;
-        const first = content.indexOf(oldStr);
-        if (first === -1) {
-          throw new Error(
-            "old_str not found in memory. Make sure it matches exactly, including whitespace and line breaks."
-          );
-        }
-        const last = content.lastIndexOf(oldStr);
-        if (first !== last) {
-          throw new Error(
-            "old_str appears multiple times in memory. Please provide more context to ensure a unique match."
-          );
+        let newContent;
+        if (!oldStr) {
+          if (!newStr) {
+            throw new Error("new_str must not be empty when appending (old_str is empty).");
+          }
+          newContent = content ? `${content.replace(/\s+$/, "")}
+
+${newStr}` : newStr;
+        } else {
+          const first = content.indexOf(oldStr);
+          if (first === -1) {
+            throw new Error(
+              "old_str not found in memory. Make sure it matches exactly, including whitespace and line breaks."
+            );
+          }
+          const last = content.lastIndexOf(oldStr);
+          if (first !== last) {
+            throw new Error(
+              "old_str appears multiple times in memory. Please provide more context to ensure a unique match."
+            );
+          }
+          newContent = content.slice(0, first) + newStr + content.slice(first + oldStr.length);
         }
-        const newContent = content.slice(0, first) + newStr + content.slice(first + oldStr.length);
         const memory = await resolveStore(context).updateMainMemory({ content: newContent });
-        return { ok: true, memory };
+        return { ok: true, bytes: memory.content.length };
       }
     }),
     defineTool6({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/harness",
-  "version": "0.59.12",
+  "version": "0.59.13",
   "description": "Agent execution runtime - conversation loop, tool dispatch, streaming",
   "repository": {
     "type": "git",

package/src/memory.ts

@@ -192,15 +192,17 @@ export const createMemoryTools = (
           throw new Error("content is required");
         }
         const memory = await resolveStore(context).updateMainMemory({ content });
-        return { ok: true, memory };
+        return { ok: true, bytes: memory.content.length };
       },
     }),
     defineTool({
       name: "memory_main_edit",
       description:
-        "Edit persistent main memory by replacing an exact string match with new content. " +
-        "The old_str must match exactly one location in memory. " +
-        "Use an empty new_str to delete matched content. " +
+        "Edit persistent main memory. With a non-empty old_str, replace that exact " +
+        "string (which must match exactly one location) with new_str; use an empty " +
+        "new_str to delete the matched content. With an empty old_str, append new_str " +
+        "to the end of memory — use this to add a brand-new fact or to write the first " +
+        "fact when memory is still empty. " +
         "Proactively evaluate every turn whether memory should be updated.",
       inputSchema: {
         type: "object",
@@ -209,11 +211,14 @@ export const createMemoryTools = (
             type: "string",
             description:
               "The exact text to find and replace (must be unique in memory). " +
-              "Include surrounding context if needed to ensure uniqueness.",
+              "Include surrounding context if needed to ensure uniqueness. " +
+              "Leave empty to append new_str to the end of memory instead.",
           },
           new_str: {
             type: "string",
-            description: "The replacement text (use empty string to delete the matched content)",
+            description:
+              "The replacement text (use empty string to delete the matched content), " +
+              "or the text to append when old_str is empty.",
           },
         },
         required: ["old_str", "new_str"],
@@ -222,26 +227,35 @@ export const createMemoryTools = (
       handler: async (input, context) => {
         const oldStr = typeof input.old_str === "string" ? input.old_str : "";
         const newStr = typeof input.new_str === "string" ? input.new_str : "";
-        if (!oldStr) {
-          throw new Error("old_str must not be empty.");
-        }
         const current = await resolveStore(context).getMainMemory();
         const content = current.content;
-        const first = content.indexOf(oldStr);
-        if (first === -1) {
-          throw new Error(
-            "old_str not found in memory. Make sure it matches exactly, including whitespace and line breaks.",
-          );
-        }
-        const last = content.lastIndexOf(oldStr);
-        if (first !== last) {
-          throw new Error(
-            "old_str appears multiple times in memory. Please provide more context to ensure a unique match.",
-          );
+        let newContent: string;
+        if (!oldStr) {
+          // Append mode: add new_str to the end. Handles the first-ever write
+          // (empty memory) and adding new facts without needing existing text
+          // to match. Separate from prior content with a blank line when both
+          // sides are non-empty.
+          if (!newStr) {
+            throw new Error("new_str must not be empty when appending (old_str is empty).");
+          }
+          newContent = content ? `${content.replace(/\s+$/, "")}\n\n${newStr}` : newStr;
+        } else {
+          const first = content.indexOf(oldStr);
+          if (first === -1) {
+            throw new Error(
+              "old_str not found in memory. Make sure it matches exactly, including whitespace and line breaks.",
+            );
+          }
+          const last = content.lastIndexOf(oldStr);
+          if (first !== last) {
+            throw new Error(
+              "old_str appears multiple times in memory. Please provide more context to ensure a unique match.",
+            );
+          }
+          newContent = content.slice(0, first) + newStr + content.slice(first + oldStr.length);
         }
-        const newContent = content.slice(0, first) + newStr + content.slice(first + oldStr.length);
         const memory = await resolveStore(context).updateMainMemory({ content: newContent });
-        return { ok: true, memory };
+        return { ok: true, bytes: memory.content.length };
       },
     }),
     defineTool({