v0.3.57: created documents are findable + shown in the GUI

- create_document saves a bare filename to the user's Downloads folder (not the
  server's working dir) and returns the absolute path, so the file is findable.
- The agentic gate emits a media_generated event for created documents, and the
  GUI renders a download card (with inline PDF preview), so the user actually
  gets the file instead of just being told it was created.

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.56"
+version = "0.3.57"
 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.56"
+__version__ = "0.3.57"

vortelio-pip/src/vortelio_cli/__main__.py

@@ -10,7 +10,7 @@
 import urllib.request
 from pathlib import Path
 
-VERSION = "0.3.56"
+VERSION = "0.3.57"
 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

@@ -309,19 +309,31 @@ func toolCreateDocument(argsJSON string) (string, error) {
 	if strings.TrimSpace(a.Path) == "" {
 		return "", fmt.Errorf("path is required")
 	}
+	// A bare filename (no directory) is saved to the user's Downloads folder so
+	// the document is actually findable, instead of the server's working dir.
+	if filepath.Dir(a.Path) == "." {
+		a.Path = filepath.Join(DefaultOutputDir(), a.Path)
+	}
 	if dir := filepath.Dir(a.Path); dir != "" {
 		os.MkdirAll(dir, 0755)
 	}
 	p, err := CreateDocument(a.Format, a.Path, a.Title, a.Content)
 	if err != nil {
 		return "", err
 	}
+	if abs, e := filepath.Abs(p); e == nil {
+		p = abs
+	}
 	fi, _ := os.Stat(p)
 	size := int64(0)
 	if fi != nil {
 		size = fi.Size()
 	}
-	return fmt.Sprintf("Documento creato: %s (%d byte)", p, size), nil
+	b, _ := json.Marshal(map[string]interface{}{
+		"status": "ok", "path": p, "size": size,
+		"note": "Document saved. The user can open/download it from the path above.",
+	})
+	return string(b), nil
 }
 
 // ── run_code ─────────────────────────────────────────────────────────────────

vortelio/internal/runtime/tools.go

@@ -1,6 +1,7 @@
 package server
 
 import (
+	"encoding/base64"
 	"encoding/json"
 	"fmt"
 	"net/http"
@@ -509,7 +510,49 @@ func (g *gatedProvider) Execute(name, args string) (string, error) {
 			}
 		}
 	}
-	return g.inner.Execute(name, args)
+	res, err := g.inner.Execute(name, args)
+	// Surface a created document in the GUI like generated media (path + inline
+	// download), otherwise the user is told "created" but never sees the file.
+	if err == nil && name == "create_document" && g.emit != nil {
+		g.emitDocument(res)
+	}
+	return res, err
+}
+
+// emitDocument reads the just-created document and emits a media_generated event
+// so the GUI shows a clickable/downloadable card.
+func (g *gatedProvider) emitDocument(result string) {
+	var r struct {
+		Path string `json:"path"`
+	}
+	if json.Unmarshal([]byte(result), &r) != nil || r.Path == "" {
+		return
+	}
+	data, err := os.ReadFile(r.Path)
+	if err != nil || len(data) > 25*1024*1024 {
+		// Still tell the UI where it is, even if too big to inline.
+		g.emit("media_generated", map[string]interface{}{"kind": "document", "path": r.Path})
+		return
+	}
+	mime := "application/octet-stream"
+	switch strings.ToLower(filepath.Ext(r.Path)) {
+	case ".pdf":
+		mime = "application/pdf"
+	case ".docx":
+		mime = "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+	case ".txt", ".md":
+		mime = "text/plain"
+	case ".html":
+		mime = "text/html"
+	case ".csv":
+		mime = "text/csv"
+	case ".json":
+		mime = "application/json"
+	}
+	g.emit("media_generated", map[string]interface{}{
+		"kind": "document", "path": r.Path, "mime": mime,
+		"data_uri": "data:" + mime + ";base64," + base64.StdEncoding.EncodeToString(data),
+	})
 }
 
 func gatedSummary(name, args string) string {

vortelio/internal/server/server_agentic.go

@@ -3936,14 +3936,19 @@ <h3 style="margin:0">☁️ Add cloud model</h3>
 function mediaArtifactEl(m) {
   const wrap = document.createElement('div');
   wrap.className = 'media-artifact';
-  const cap = '<div class="media-cap">🎨 ' + esc((m.kind||'media').toUpperCase()) + ' generated' +
+  const cap = '<div class="media-cap">' + (m.kind === 'document' ? '📄 ' : '🎨 ') + esc((m.kind||'media').toUpperCase()) + ' generated' +
     (m.path ? ' · <span style="font-family:var(--mono);font-size:11px">' + esc(m.path) + '</span>' : '') + '</div>';
   let body = '';
   const src = m.data_uri || m.path || '';
   if (m.kind === 'image')      body = '<img src="' + src + '" style="max-width:100%;border-radius:8px">';
   else if (m.kind === 'audio') body = '<audio controls src="' + src + '" style="width:100%"></audio>';
   else if (m.kind === 'video') body = '<video controls src="' + src + '" style="max-width:100%;border-radius:8px"></video>';
-  else                          body = '<div style="font-size:12px;color:var(--text2)">File 3D salvato. Aprilo dalla cartella output.</div>';
+  else if (m.kind === 'document') {
+    const fn = String(m.path || 'document').split(/[\\/]/).pop();
+    body = '<a class="btn primary" href="' + src + '" download="' + esc(fn) + '" style="display:inline-flex;text-decoration:none">⬇ Scarica ' + esc(fn) + '</a>';
+    if (m.mime === 'application/pdf' && m.data_uri) body += '<embed src="' + src + '" type="application/pdf" style="width:100%;height:480px;border-radius:8px;margin-top:8px">';
+  }
+  else                          body = '<div style="font-size:12px;color:var(--text2)">File salvato. Percorso sopra.</div>';
   wrap.innerHTML = cap + body;
   return wrap;
 }

vortelio/internal/server/ui.html

@@ -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.56"
+var Version = "0.3.57"