clawlet 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawlet",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "A lightweight AI based personal assistant.",
   "main": "src/cli.ts",
   "type": "module",

package/src/tools.ts

@@ -485,6 +485,27 @@ export function createTools(memory: AgentMemory, model: LanguageModel) {
       }
     }),
 
+    'fs.appendFile': tool({
+      description: 'Apped specific string to a file (will create it if it does not exist yet). Use this for appending something to daily memory files and the likes.',
+      inputSchema: jsonSchema<{ path: string, find: string, replace: string }>({
+        type: 'object',
+        properties: {
+          path: { type: 'string', description: 'Path/key of the file to edit' },
+          content: { type: 'string', description: 'The new text to append to the file.' },
+        },
+        required: ['path', 'content'],
+      }),
+      execute: async ({ path, find, replace }) => {
+        logger.debug({ path }, 'FS appendFile');
+        try {
+          const content = await memory.workspace.getItem(path);
+          const fileText = String(content || '');
+          await memory.workspace.setItem(path, (fileText != '' ? (fileText + "\n") : '') + content);
+          return `Success: Appended "${path}".`;
+        } catch (e: any) { return "Error appending file: " + e.message; }
+      }
+    }),
+
     'fs.delete': tool({
       description: 'Delete a file. If the file is outside .trash/, it is moved to .trash/ (soft delete). If the file is already inside .trash/, it is permanently removed.',
       inputSchema: jsonSchema<{ path: string }>({
@@ -937,6 +958,20 @@ Return ONLY a JSON object mapping tool names to arrays of permission rules. Exam
           }
         ];
 
+        skillPermissions['fs.appendFile'] = skillPermissions['fs.appendFile'] || [
+          {
+            path: "memory/*",
+            allowed: "1"
+          }
+        ];
+
+        skillPermissions['fs.editFile'] = skillPermissions['fs.editFile'] || [
+          {
+            path: "memory/*",
+            allowed: "1"
+          }
+        ];
+
         skillPermissions['fs.readFile'] = skillPermissions['fs.readFile'] || [
           {
             path: "memory/*",

package/template/AGENTS.template

@@ -36,7 +36,7 @@ You wake up fresh each session. Files are your only continuity.
 
 ### 📝 Write It Down or It Didn't Happen
 **Memory is limited.** "Mental notes" die when the session ends.
--   **Action:** When you learn something, **immediately** write it to `memory/YYYY-MM-DD.md` or `MEMORY.md` using `fs.writeFile`.
+-   **Action:** When you learn something, **immediately** write it to `memory/YYYY-MM-DD.md` by using `fs.appendFile` or `MEMORY.md` using `fs.writeFile` or `fs.editFile`.
 -   **Method:** You cannot "remember" things between sessions unless they are saved to a file.
 
 ### 🚨 Error Transparency Protocol
@@ -105,13 +105,13 @@ Use `skills.install <name> "<url>"` to add new capabilities.
 
 **1. File Writing Protocol:**
 You must use `fs.writeFile` to persist **ALL** critical updates.
--   Updating user preferences? -> `fs.writeFile` to `USER.md`.
--   Logging an event? -> `fs.writeFile` to `memory/YYYY-MM-DD.md`.
+-   Updating user preferences? -> `fs.writeFile` or `fs.editFile` to `USER.md`.
+-   Logging an event? -> `fs.appendFile` or `fs.editFile` to `memory/YYYY-MM-DD.md`.
 -   **Never** assume stating "I have updated the memory" is enough. You must execute the write.
 
 **2. Message History Persistence:**
 -   Message history is **not** stored in RAM.
--   Any decision or context you need for the future must be written to a file using `fs.writeFile`.
+-   Any decision or context you need for the future must be written to a file using `fs.writeFile` or `fs.editFile`.
 -   **Violation Consequence:** If you fail to write to a file, you will forget that information immediately upon session restart.
 
 ## 🔐 Security
@@ -119,4 +119,4 @@ You must use `fs.writeFile` to persist **ALL** critical updates.
 -   **Secrets:** Never print API keys in plain text logs.
 
 ## Make It Yours
-Refine this `AGENTS.md` as you learn. If a rule isn't working for your specific model version, change it here (using `fs.editFile` or read only part of the file to avoid exceeding token limits).
+Refine this `AGENTS.md` as you learn. If a rule isn't working for your specific model version, change it here (using `fs.editFile` or add a section using `fs.appendFile` or read only part of the file to avoid exceeding token limits).