v0.3.65: write_file gains append mode for building large files in chunks

The model could only overwrite a file in one shot, so building a big dataset
failed (it wrote just "[" and stopped). write_file now takes append=true to add
to the end; the coding prompt and tool descriptions tell the model to build
large files in chunks and verify the result.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: metiu1

vortelio-pip/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vortelio"
-version = "0.3.64"
+version = "0.3.65"
 description = "Local-first AI platform. Run LLMs, generate images & video, transcribe audio, create 3D — on your own machine. OpenAI & Ollama API compatible. Apache 2.0."
 readme = "README.md"
 requires-python = ">=3.8"

vortelio-pip/src/vortelio_cli/__init__.py

@@ -1 +1 @@
-__version__ = "0.3.64"
+__version__ = "0.3.65"

vortelio-pip/src/vortelio_cli/__main__.py

@@ -10,7 +10,7 @@
 import urllib.request
 from pathlib import Path
 
-VERSION = "0.3.64"
+VERSION = "0.3.65"
 RELEASE_BASE = os.environ.get(
     "VORTELIO_RELEASE_BASE",
     f"https://github.com/metiu1/Vortelio/releases/download/v{VERSION}",

vortelio-pip/src/vortelio_cli/bin/vortelio-windows-amd64.exe

@@ -182,8 +182,8 @@ func BuiltinTools() []ToolDef {
 			Type: "function",
 			Function: ToolFuncDef{
 				Name:        "write_file",
-				Description: "Writes content to a file on the local filesystem. Creates the file if it does not exist.",
-				Parameters:  json.RawMessage(`{"type":"object","properties":{"path":{"type":"string","description":"Path to the file"},"content":{"type":"string","description":"Content to write"}},"required":["path","content"]}`),
+				Description: "Writes content to a file. Creates it if missing. Set append=true to add to the end instead of overwriting — use this to build large files (e.g. a big dataset) in several chunks.",
+				Parameters:  json.RawMessage(`{"type":"object","properties":{"path":{"type":"string","description":"Path to the file"},"content":{"type":"string","description":"Content to write"},"append":{"type":"boolean","description":"If true, append to the end of the file instead of overwriting. Default false."}},"required":["path","content"]}`),
 			},
 		},
 		{
@@ -722,20 +722,37 @@ func toolWriteFile(argsJSON string) (string, error) {
 	var args struct {
 		Path    string `json:"path"`
 		Content string `json:"content"`
+		Append  bool   `json:"append"`
 	}
 	if err := json.Unmarshal([]byte(argsJSON), &args); err != nil || args.Path == "" {
 		return "", fmt.Errorf("path and content are required")
 	}
 	if err := os.MkdirAll(filepath.Dir(args.Path), 0755); err != nil {
 		return "", fmt.Errorf("cannot create directory: %w", err)
 	}
-	if err := os.WriteFile(args.Path, []byte(args.Content), 0644); err != nil {
+	if args.Append {
+		f, err := os.OpenFile(args.Path, os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
+		if err != nil {
+			return "", fmt.Errorf("cannot open file %q: %w", args.Path, err)
+		}
+		if _, err := f.WriteString(args.Content); err != nil {
+			f.Close()
+			return "", fmt.Errorf("cannot append to file %q: %w", args.Path, err)
+		}
+		f.Close()
+	} else if err := os.WriteFile(args.Path, []byte(args.Content), 0644); err != nil {
 		return "", fmt.Errorf("cannot write file %q: %w", args.Path, err)
 	}
+	total := int64(0)
+	if fi, err := os.Stat(args.Path); err == nil {
+		total = fi.Size()
+	}
 	b, _ := json.Marshal(map[string]interface{}{
-		"path":    args.Path,
-		"written": len(args.Content),
-		"status":  "ok",
+		"path":       args.Path,
+		"written":    len(args.Content),
+		"total_size": total,
+		"appended":   args.Append,
+		"status":     "ok",
 	})
 	return string(b), nil
 }

vortelio/internal/runtime/tools.go

@@ -206,6 +206,9 @@ func CodingSystemPrompt(autonomous bool) string {
 		"l'utente li chiede davvero, e per impostazione predefinita salva gli artefatti dentro la cartella di lavoro. " +
 		"Dopo che uno strumento restituisce un risultato, scrivi una risposta chiara e completa nella lingua dell'utente; " +
 		"non limitarti a ripetere il JSON grezzo. " +
+		"Per file molto grandi (dataset, migliaia di righe) NON tentare un'unica scrittura gigante: " +
+		"crea il file e poi AGGIUNGI il contenuto a blocchi con write_file e append=true, ripetendo finché è completo, " +
+		"e alla fine verifica la dimensione/righe con read_file. " +
 		conciseNudgeIT + " " +
 		askUserNudgeIT
 }
@@ -761,8 +764,8 @@ func (c *codingProvider) Tools() []rt.ToolDef {
 			`{"type":"object","properties":{"pattern":{"type":"string","description":"Glob pattern relative to workspace root."}},"required":["pattern"]}`),
 		toolDef("grep_search", "Search file contents for a substring and return matching lines.",
 			`{"type":"object","properties":{"query":{"type":"string"},"path":{"type":"string","description":"Optional sub-path to search. Defaults to workspace root."}},"required":["query"]}`),
-		toolDef("write_file", "Create or overwrite a file with the given content. (requires approval)",
-			`{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"}},"required":["path","content"]}`),
+		toolDef("write_file", "Create or overwrite a file. Set append=true to add to the end instead — use it to build large files (e.g. a big dataset) in several chunks. (requires approval)",
+			`{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"},"append":{"type":"boolean","description":"Append to the end instead of overwriting. Default false."}},"required":["path","content"]}`),
 		toolDef("edit_file", "Replace the first occurrence of old_text with new_text in a file. (requires approval)",
 			`{"type":"object","properties":{"path":{"type":"string"},"old_text":{"type":"string"},"new_text":{"type":"string"}},"required":["path","old_text","new_text"]}`),
 		toolDef("run_shell", "Run a shell command in the workspace and return its output. (requires approval)",
@@ -1070,6 +1073,7 @@ func (c *codingProvider) writeFile(argsJSON string) (string, error) {
 	var a struct {
 		Path    string `json:"path"`
 		Content string `json:"content"`
+		Append  bool   `json:"append"`
 	}
 	json.Unmarshal([]byte(argsJSON), &a)
 	full, err := c.resolvePath(a.Path)
@@ -1079,10 +1083,28 @@ func (c *codingProvider) writeFile(argsJSON string) (string, error) {
 	if err := os.MkdirAll(filepath.Dir(full), 0755); err != nil {
 		return "", err
 	}
-	if err := os.WriteFile(full, []byte(a.Content), 0644); err != nil {
+	if a.Append {
+		f, err := os.OpenFile(full, os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
+		if err != nil {
+			return "", err
+		}
+		if _, err := f.WriteString(a.Content); err != nil {
+			f.Close()
+			return "", err
+		}
+		f.Close()
+	} else if err := os.WriteFile(full, []byte(a.Content), 0644); err != nil {
 		return "", err
 	}
-	return fmt.Sprintf("wrote %d bytes to %s", len(a.Content), full), nil
+	total := int64(0)
+	if fi, err := os.Stat(full); err == nil {
+		total = fi.Size()
+	}
+	verb := "wrote"
+	if a.Append {
+		verb = "appended"
+	}
+	return fmt.Sprintf("%s %d bytes to %s (total %d bytes)", verb, len(a.Content), full, total), nil
 }
 
 func (c *codingProvider) editFile(argsJSON string) (string, error) {

vortelio/internal/server/server_agentic.go

@@ -3,4 +3,4 @@ package version
 // Version è impostabile a build time via:
 //
 //	-ldflags "-X github.com/vortelio/vortelio/internal/version.Version=X.Y.Z"
-var Version = "0.3.64"
+var Version = "0.3.65"