@zachjxyz/moxie 0.4.2 → 0.4.3

package/bin/moxie

@@ -16,7 +16,7 @@
 
 set -euo pipefail
 
-MOXIE_VERSION="0.4.2"
+MOXIE_VERSION="0.4.3"
 # Resolve symlinks (npm installs bin as a symlink)
 _self="$0"
 while [ -L "$_self" ]; do

package/lib/gateway-agent.mjs

@@ -47,6 +47,14 @@ function toolWriteFile(args) {
   return `Written ${args.content.length} bytes to ${args.path}`;
 }
 
+function toolAppendFile(args) {
+  const filepath = resolve(CWD, args.path);
+  mkdirSync(dirname(filepath), { recursive: true });
+  const existing = existsSync(filepath) ? readFileSync(filepath, 'utf8') : '';
+  writeFileSync(filepath, existing + args.content, 'utf8');
+  return `Appended ${args.content.length} bytes to ${args.path} (total: ${existing.length + args.content.length} bytes)`;
+}
+
 function toolEditFile(args) {
   const filepath = resolve(CWD, args.path);
   if (!existsSync(filepath)) return `Error: File not found: ${args.path}`;
@@ -157,6 +165,7 @@ function executeTool(name, args) {
     switch (name) {
       case 'read_file': return toolReadFile(args);
       case 'write_file': return toolWriteFile(args);
+      case 'append_file': return toolAppendFile(args);
       case 'edit_file': return toolEditFile(args);
       case 'run_command': return toolRunCommand(args);
       case 'list_directory': return toolListDirectory(args);
@@ -203,6 +212,21 @@ const TOOL_DEFINITIONS = [
       },
     },
   },
+  {
+    type: 'function',
+    function: {
+      name: 'append_file',
+      description: 'Append content to a file. Creates the file if it does not exist. Use this to write large documents incrementally — one section at a time.',
+      parameters: {
+        type: 'object',
+        properties: {
+          path: { type: 'string', description: 'File path relative to project root' },
+          content: { type: 'string', description: 'Content to append' },
+        },
+        required: ['path', 'content'],
+      },
+    },
+  },
   {
     type: 'function',
     function: {
@@ -286,13 +310,21 @@ const TOOL_DEFINITIONS = [
 
 const SYSTEM_PROMPT = `You are a coding agent working in the directory: ${CWD}
 
-You have access to tools for reading, writing, and editing files, running shell commands, listing directories, and searching code. Use these tools to accomplish the task given to you.
+You have access to tools for reading, writing, editing, and appending to files, running shell commands, listing directories, and searching code. Use these tools to accomplish the task given to you.
 
 Rules:
 - Always use tools to read files before modifying them.
 - Use tools to verify your work (e.g., read a file after editing to confirm the change).
 - When editing files, provide enough surrounding context in old_string to make the match unique.
-- Be thorough and complete the task fully.`;
+- Be thorough and complete the task fully.
+
+IMPORTANT — Writing large documents:
+When writing reports, RFCs, audits, plans, or any document longer than ~100 lines, you MUST
+write incrementally using append_file rather than a single write_file call. Write one section
+at a time — e.g., first the header, then section 1, then section 2, etc. Each append_file call
+should contain at most one section (~50-150 lines). This prevents connection timeouts on long
+generations. Start with write_file for the first section (to create/overwrite), then use
+append_file for all subsequent sections.`;
 
 // ---- SSE streaming API client ----
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zachjxyz/moxie",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Run multiple AI coding agents through spec-driven phases with quorum convergence. Supports CLI agents (Claude, Codex, Qwen, Aider, Goose, Amp, Cline, Roo) and Vercel AI Gateway models.",
   "bin": {
     "moxie": "bin/moxie"