@poncho-ai/harness 0.24.0 → 0.25.0

package/dist/index.js

@@ -1402,7 +1402,8 @@ if (result.compacted) {
 When \`memory.enabled\` is true in \`poncho.config.js\`, the harness enables a simple memory model:
 
 - A single persistent main memory document is loaded at run start and interpolated into the system prompt under \`## Persistent Memory\`.
-- \`memory_main_update\` can replace or append to that document. The tool description instructs the model to proactively evaluate each turn whether durable memory should be updated.
+- \`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.
 - \`conversation_recall\` can search recent prior conversations (keyword scoring) when historical context is relevant (\`as we discussed\`, \`last time\`, etc.).
 
 \`\`\`javascript
@@ -1420,9 +1421,10 @@ export default {
 
 Available memory tools:
 
-- \`memory_main_get\`
-- \`memory_main_update\`
-- \`conversation_recall\`
+- \`memory_main_get\` \u2014 read the current memory document
+- \`memory_main_write\` \u2014 overwrite the entire memory document
+- \`memory_main_edit\` \u2014 edit memory via exact string replacement (\`old_str\` / \`new_str\`)
+- \`conversation_recall\` \u2014 search past conversations
 `,
   "configuration": `# Configuration & Security
 
@@ -2028,6 +2030,8 @@ var ponchoDocsTool = defineTool({
 
 // src/harness.ts
 import { randomUUID as randomUUID3 } from "crypto";
+import { readFile as readFile7 } from "fs/promises";
+import { resolve as resolve9 } from "path";
 import { getTextContent as getTextContent3 } from "@poncho-ai/sdk";
 
 // src/upload-store.ts
@@ -2384,14 +2388,9 @@ var InMemoryMemoryStore = class {
     return this.mainMemory;
   }
   async updateMainMemory(input) {
-    const now2 = Date.now();
-    const existing = await this.getMainMemory();
-    const nextContent = input.mode === "append" && existing.content ? `${existing.content}
-
-${input.content}`.trim() : input.content;
     this.mainMemory = {
-      content: nextContent.trim(),
-      updatedAt: now2
+      content: input.content.trim(),
+      updatedAt: Date.now()
     };
     return this.mainMemory;
   }
@@ -2449,12 +2448,8 @@ var FileMainMemoryStore = class {
   }
   async updateMainMemory(input) {
     await this.ensureLoaded();
-    const existing = await this.getMainMemory();
-    const nextContent = input.mode === "append" && existing.content ? `${existing.content}
-
-${input.content}`.trim() : input.content;
     this.mainMemory = {
-      content: nextContent.trim(),
+      content: input.content.trim(),
       updatedAt: Date.now()
     };
     await this.persist();
@@ -2493,8 +2488,7 @@ var KeyValueMainMemoryStoreBase = class {
       }
     } catch {
       await this.memoryFallback.updateMainMemory({
-        content: payload.main.content,
-        mode: "replace"
+        content: payload.main.content
       });
     }
   }
@@ -2505,11 +2499,8 @@ var KeyValueMainMemoryStoreBase = class {
   async updateMainMemory(input) {
     const key = this.key();
     const payload = await this.readPayload(key);
-    const nextContent = input.mode === "append" && payload.main.content ? `${payload.main.content}
-
-${input.content}`.trim() : input.content;
     payload.main = {
-      content: nextContent.trim(),
+      content: input.content.trim(),
       updatedAt: Date.now()
     };
     await this.writePayload(key, payload);
@@ -2775,19 +2766,14 @@ var createMemoryTools = (store, options) => {
       }
     }),
     defineTool2({
-      name: "memory_main_update",
-      description: "Update persistent main memory when new stable preferences, long-term goals, or durable facts appear. Proactively evaluate every turn whether memory should be updated, and avoid storing ephemeral details.",
+      name: "memory_main_write",
+      description: "Overwrite the entire persistent main memory document. Use for initial writes or full rewrites. Prefer memory_main_edit for targeted changes to existing memory.",
       inputSchema: {
         type: "object",
         properties: {
-          mode: {
-            type: "string",
-            enum: ["replace", "append"],
-            description: "replace overwrites memory; append adds content to the end"
-          },
           content: {
             type: "string",
-            description: "The memory content to write"
+            description: "The full memory content to write"
           }
         },
         required: ["content"],
@@ -2798,8 +2784,50 @@ var createMemoryTools = (store, options) => {
         if (!content) {
           throw new Error("content is required");
         }
-        const mode = input.mode === "append" || input.mode === "replace" ? input.mode : "replace";
-        const memory = await store.updateMainMemory({ content, mode });
+        const memory = await store.updateMainMemory({ content });
+        return { ok: true, memory };
+      }
+    }),
+    defineTool2({
+      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.",
+      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."
+          },
+          new_str: {
+            type: "string",
+            description: "The replacement text (use empty string to delete the matched content)"
+          }
+        },
+        required: ["old_str", "new_str"],
+        additionalProperties: false
+      },
+      handler: async (input) => {
+        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 store.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."
+          );
+        }
+        const newContent = content.slice(0, first) + newStr + content.slice(first + oldStr.length);
+        const memory = await store.updateMainMemory({ content: newContent });
         return { ok: true, memory };
       }
     }),
@@ -4688,6 +4716,7 @@ var AgentHarness = class _AgentHarness {
   _browserSession;
   _browserMod;
   parsedAgent;
+  agentFileFingerprint = "";
   mcpBridge;
   subagentManager;
   resolveToolAccess(toolName) {
@@ -4800,20 +4829,17 @@ var AgentHarness = class _AgentHarness {
     return this.parsedAgent?.frontmatter.approvalRequired?.scripts ?? [];
   }
   getRequestedMcpPatterns() {
-    const skillPatterns = /* @__PURE__ */ new Set();
+    const patterns = new Set(this.getAgentMcpIntent());
     for (const skillName of this.activeSkillNames) {
       const skill = this.loadedSkills.find((entry) => entry.name === skillName);
       if (!skill) {
         continue;
       }
       for (const pattern of skill.allowedTools.mcp) {
-        skillPatterns.add(pattern);
+        patterns.add(pattern);
       }
     }
-    if (skillPatterns.size > 0) {
-      return [...skillPatterns];
-    }
-    return this.getAgentMcpIntent();
+    return [...patterns];
   }
   getRequestedScriptPatterns() {
     const patterns = new Set(this.getAgentScriptIntent());
@@ -4829,20 +4855,17 @@ var AgentHarness = class _AgentHarness {
     return [...patterns];
   }
   getRequestedMcpApprovalPatterns() {
-    const skillPatterns = /* @__PURE__ */ new Set();
+    const patterns = new Set(this.getAgentMcpApprovalPatterns());
     for (const skillName of this.activeSkillNames) {
       const skill = this.loadedSkills.find((entry) => entry.name === skillName);
       if (!skill) {
         continue;
       }
       for (const pattern of skill.approvalRequired.mcp) {
-        skillPatterns.add(pattern);
+        patterns.add(pattern);
       }
     }
-    if (skillPatterns.size > 0) {
-      return [...skillPatterns];
-    }
-    return this.getAgentMcpApprovalPatterns();
+    return [...patterns];
   }
   getRequestedScriptApprovalPatterns() {
     const patterns = new Set(this.getAgentScriptApprovalPatterns());
@@ -4973,13 +4996,54 @@ var AgentHarness = class _AgentHarness {
     );
   }
   static SKILL_REFRESH_DEBOUNCE_MS = 3e3;
-  async refreshSkillsIfChanged() {
+  /**
+   * Re-read AGENT.md and update the parsed agent when the file has changed
+   * on disk.  Returns `true` when the agent was actually re-parsed.
+   *
+   * Preserves the agent identity (id) across reloads so conversation
+   * continuity isn't broken.
+   */
+  async refreshAgentIfChanged() {
     if (this.environment !== "development") {
-      return;
+      return false;
     }
-    const elapsed = Date.now() - this.lastSkillRefreshAt;
-    if (this.lastSkillRefreshAt > 0 && elapsed < _AgentHarness.SKILL_REFRESH_DEBOUNCE_MS) {
-      return;
+    try {
+      const agentFilePath = resolve9(this.workingDir, "AGENT.md");
+      const rawContent = await readFile7(agentFilePath, "utf8");
+      if (rawContent === this.agentFileFingerprint) {
+        return false;
+      }
+      const parsed = parseAgentMarkdown(rawContent);
+      if (!parsed.frontmatter.id && this.parsedAgent?.frontmatter.id) {
+        parsed.frontmatter.id = this.parsedAgent.frontmatter.id;
+      }
+      this.parsedAgent = parsed;
+      this.agentFileFingerprint = rawContent;
+      return true;
+    } catch (error) {
+      console.warn(
+        `[poncho][agent] Failed to refresh AGENT.md in development mode: ${error instanceof Error ? error.message : String(error)}`
+      );
+      return false;
+    }
+  }
+  /**
+   * Re-scan skill directories and update metadata, tools, and context window
+   * when skills have changed on disk. Returns `true` when the skill set was
+   * actually updated.
+   *
+   * @param force - bypass the time-based debounce (used for mid-run refreshes
+   *   after the agent may have written new skill files).
+   */
+  async refreshSkillsIfChanged(force = false) {
+    if (this.environment !== "development") {
+      return false;
+    }
+    if (!force) {
+      const elapsed = Date.now() - this.lastSkillRefreshAt;
+      if (this.lastSkillRefreshAt > 0 && elapsed < _AgentHarness.SKILL_REFRESH_DEBOUNCE_MS) {
+        return false;
+      }
     }
     this.lastSkillRefreshAt = Date.now();
     try {
@@ -4989,22 +5053,35 @@ var AgentHarness = class _AgentHarness {
       );
       const nextFingerprint = this.buildSkillFingerprint(latestSkills);
       if (nextFingerprint === this.skillFingerprint) {
-        return;
+        return false;
       }
       this.loadedSkills = latestSkills;
       this.skillContextWindow = buildSkillContextWindow(latestSkills);
       this.skillFingerprint = nextFingerprint;
       this.registerSkillTools(latestSkills);
-      this.activeSkillNames.clear();
+      const latestSkillNames = new Set(latestSkills.map((s) => s.name));
+      for (const name of this.activeSkillNames) {
+        if (!latestSkillNames.has(name)) {
+          this.activeSkillNames.delete(name);
+        }
+      }
+      if (this.mcpBridge) {
+        await this.mcpBridge.discoverTools();
+      }
       await this.refreshMcpTools("skills:changed");
+      return true;
     } catch (error) {
       console.warn(
         `[poncho][skills] Failed to refresh skills in development mode: ${error instanceof Error ? error.message : String(error)}`
       );
+      return false;
     }
   }
   async initialize() {
-    this.parsedAgent = await parseAgentFile(this.workingDir);
+    const agentFilePath = resolve9(this.workingDir, "AGENT.md");
+    const agentRawContent = await readFile7(agentFilePath, "utf8");
+    this.parsedAgent = parseAgentMarkdown(agentRawContent);
+    this.agentFileFingerprint = agentRawContent;
     const identity = await ensureAgentIdentity(this.workingDir);
     if (!this.parsedAgent.frontmatter.id) {
       this.parsedAgent.frontmatter.id = identity.id;
@@ -5082,9 +5159,9 @@ var AgentHarness = class _AgentHarness {
           await writeFile6(filePath, json, "utf8");
         },
         async load() {
-          const { readFile: readFile8 } = await import("fs/promises");
+          const { readFile: readFile9 } = await import("fs/promises");
           try {
-            return await readFile8(filePath, "utf8");
+            return await readFile9(filePath, "utf8");
           } catch {
             return void 0;
           }
@@ -5248,9 +5325,9 @@ var AgentHarness = class _AgentHarness {
           for await (const event of this.run(input)) {
             eventQueue.push(event);
             if (queueResolve) {
-              const resolve10 = queueResolve;
+              const resolve11 = queueResolve;
               queueResolve = null;
-              resolve10();
+              resolve11();
             }
           }
         } catch (error) {
@@ -5269,8 +5346,8 @@ var AgentHarness = class _AgentHarness {
           if (eventQueue.length > 0) {
             yield eventQueue.shift();
           } else if (!generatorDone) {
-            await new Promise((resolve10) => {
-              queueResolve = resolve10;
+            await new Promise((resolve11) => {
+              queueResolve = resolve11;
             });
           }
         }
@@ -5308,13 +5385,14 @@ var AgentHarness = class _AgentHarness {
       await this.initialize();
     }
     const memoryPromise = this.memoryStore ? this.memoryStore.getMainMemory() : void 0;
+    await this.refreshAgentIfChanged();
     await this.refreshSkillsIfChanged();
     this._currentRunConversationId = input.conversationId;
     const ownerParam = input.parameters?.__ownerId;
     if (typeof ownerParam === "string") {
       this._currentRunOwnerId = ownerParam;
     }
-    const agent = this.parsedAgent;
+    let agent = this.parsedAgent;
     const runId = `run_${randomUUID3()}`;
     const start = now();
     const maxSteps = agent.frontmatter.limits?.maxSteps ?? 50;
@@ -5325,11 +5403,11 @@ var AgentHarness = class _AgentHarness {
     const messages = [...input.messages ?? []];
     const inputMessageCount = messages.length;
     const events = [];
-    const systemPrompt = renderAgentPrompt(agent, {
+    const renderCurrentAgentPrompt = () => renderAgentPrompt(this.parsedAgent, {
       parameters: input.parameters,
       runtime: {
         runId,
-        agentId: agent.frontmatter.id ?? agent.frontmatter.name,
+        agentId: this.parsedAgent.frontmatter.id ?? this.parsedAgent.frontmatter.name,
         environment: this.environment,
         workingDir: this.workingDir
       }
@@ -5357,9 +5435,6 @@ Browser sessions (cookies, localStorage, login state) are automatically saved an
 
 ### Tabs and resources
 Each conversation gets its own browser tab sharing a single browser instance. Call \`browser_close\` when done to free the tab. If you don't close it, the tab stays open and the user can continue interacting with it.` : "";
-    const promptWithSkills = this.skillContextWindow ? `${systemPrompt}${developmentContext}
-
-${this.skillContextWindow}${browserContext}` : `${systemPrompt}${developmentContext}${browserContext}`;
     const mainMemory = await memoryPromise;
     const boundedMainMemory = mainMemory && mainMemory.content.length > 4e3 ? `${mainMemory.content.slice(0, 4e3)}
 ...[truncated]` : mainMemory?.content;
@@ -5367,7 +5442,12 @@ ${this.skillContextWindow}${browserContext}` : `${systemPrompt}${developmentCont
 ## Persistent Memory
 
 ${boundedMainMemory.trim()}` : "";
-    const integrityPrompt = `${promptWithSkills}${memoryContext}
+    const buildSystemPrompt = () => {
+      const agentPrompt = renderCurrentAgentPrompt();
+      const promptWithSkills = this.skillContextWindow ? `${agentPrompt}${developmentContext}
+
+${this.skillContextWindow}${browserContext}` : `${agentPrompt}${developmentContext}${browserContext}`;
+      return `${promptWithSkills}${memoryContext}
 
 ## Execution Integrity
 
@@ -5375,6 +5455,10 @@ ${boundedMainMemory.trim()}` : "";
 - Do not fabricate "Tool Used" or "Tool Result" logs as plain text.
 - Never output faux execution transcripts, markdown tool logs, or "Tool Used/Result" sections.
 - If no suitable tool is available, explicitly say that and ask for guidance.`;
+    };
+    let integrityPrompt = buildSystemPrompt();
+    let lastPromptFingerprint = `${this.agentFileFingerprint}
+${this.skillFingerprint}`;
     const pushEvent = (event) => {
       events.push(event);
       return event;
@@ -5797,8 +5881,8 @@ ${textContent}` };
               let timer;
               nextPart = await Promise.race([
                 fullStreamIterator.next(),
-                new Promise((resolve10) => {
-                  timer = setTimeout(() => resolve10(null), timeout);
+                new Promise((resolve11) => {
+                  timer = setTimeout(() => resolve11(null), timeout);
                 })
               ]);
               clearTimeout(timer);
@@ -6106,6 +6190,19 @@ ${textContent}` };
           content: JSON.stringify(toolResultsForModel),
           metadata: toolMsgMeta
         });
+        if (this.environment === "development") {
+          const agentChanged = await this.refreshAgentIfChanged();
+          const skillsChanged = await this.refreshSkillsIfChanged(true);
+          if (agentChanged || skillsChanged) {
+            agent = this.parsedAgent;
+            const currentFingerprint = `${this.agentFileFingerprint}
+${this.skillFingerprint}`;
+            if (currentFingerprint !== lastPromptFingerprint) {
+              integrityPrompt = buildSystemPrompt();
+              lastPromptFingerprint = currentFingerprint;
+            }
+          }
+        }
         yield pushEvent({
           type: "step:completed",
           step,
@@ -6294,8 +6391,8 @@ var LatitudeCapture = class {
 
 // src/state.ts
 import { randomUUID as randomUUID4 } from "crypto";
-import { mkdir as mkdir4, readFile as readFile7, readdir as readdir4, rename as rename2, rm as rm3, writeFile as writeFile5 } from "fs/promises";
-import { dirname as dirname4, resolve as resolve9 } from "path";
+import { mkdir as mkdir4, readFile as readFile8, readdir as readdir4, rename as rename2, rm as rm3, writeFile as writeFile5 } from "fs/promises";
+import { dirname as dirname4, resolve as resolve10 } from "path";
 var DEFAULT_OWNER = "local-owner";
 var LOCAL_STATE_FILE = "state.json";
 var CONVERSATIONS_DIRECTORY = "conversations";
@@ -6488,8 +6585,8 @@ var FileConversationStore = class {
       agentId: this.agentId
     });
     const agentDir = getAgentStoreDirectory(identity);
-    const conversationsDir = resolve9(agentDir, CONVERSATIONS_DIRECTORY);
-    const indexPath = resolve9(conversationsDir, LOCAL_CONVERSATION_INDEX_FILE);
+    const conversationsDir = resolve10(agentDir, CONVERSATIONS_DIRECTORY);
+    const indexPath = resolve10(conversationsDir, LOCAL_CONVERSATION_INDEX_FILE);
     this.paths = { conversationsDir, indexPath };
     return this.paths;
   }
@@ -6503,9 +6600,9 @@ var FileConversationStore = class {
   }
   async readConversationFile(fileName) {
     const { conversationsDir } = await this.resolvePaths();
-    const filePath = resolve9(conversationsDir, fileName);
+    const filePath = resolve10(conversationsDir, fileName);
     try {
-      const raw = await readFile7(filePath, "utf8");
+      const raw = await readFile8(filePath, "utf8");
       return JSON.parse(raw);
     } catch {
       return void 0;
@@ -6551,7 +6648,7 @@ var FileConversationStore = class {
     this.loaded = true;
     const { indexPath } = await this.resolvePaths();
     try {
-      const raw = await readFile7(indexPath, "utf8");
+      const raw = await readFile8(indexPath, "utf8");
       const parsed = JSON.parse(raw);
       for (const conversation of parsed.conversations ?? []) {
         this.conversations.set(conversation.conversationId, conversation);
@@ -6574,7 +6671,7 @@ var FileConversationStore = class {
     const { conversationsDir } = await this.resolvePaths();
     const existing = this.conversations.get(conversation.conversationId);
     const fileName = existing?.fileName ?? this.resolveConversationFileName(conversation);
-    const filePath = resolve9(conversationsDir, fileName);
+    const filePath = resolve10(conversationsDir, fileName);
     this.writing = this.writing.then(async () => {
       await writeJsonAtomic2(filePath, conversation);
       this.conversations.set(conversation.conversationId, {
@@ -6672,7 +6769,7 @@ var FileConversationStore = class {
     if (removed) {
       this.writing = this.writing.then(async () => {
         if (existing) {
-          await rm3(resolve9(conversationsDir, existing.fileName), { force: true });
+          await rm3(resolve10(conversationsDir, existing.fileName), { force: true });
         }
         await this.writeIndex();
       });
@@ -6702,7 +6799,7 @@ var FileStateStore = class {
       workingDir: this.workingDir,
       agentId: this.agentId
     });
-    this.filePath = resolve9(getAgentStoreDirectory(identity), LOCAL_STATE_FILE);
+    this.filePath = resolve10(getAgentStoreDirectory(identity), LOCAL_STATE_FILE);
   }
   isExpired(state) {
     return typeof this.ttlMs === "number" && Date.now() - state.updatedAt > this.ttlMs;
@@ -6714,7 +6811,7 @@ var FileStateStore = class {
     }
     this.loaded = true;
     try {
-      const raw = await readFile7(this.filePath, "utf8");
+      const raw = await readFile8(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       for (const state of parsed.states ?? []) {
         this.states.set(state.runId, state);

package/package.json

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