@aion0/forge 0.10.51 → 0.10.53

package/RELEASE_NOTES.md

@@ -1,8 +1,8 @@
-# Forge v0.10.51
+# Forge v0.10.53
 
 Released: 2026-06-09
 
-## Changes since v0.10.50
+## Changes since v0.10.52
 
 
-**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.10.50...v0.10.51
+**Full Changelog**: https://github.com/aiwatching/forge/compare/v0.10.52...v0.10.53

package/app/scratch/[...path]/page.tsx

@@ -0,0 +1,24 @@
+/**
+ * /scratch/<path...> — in-browser viewer for files under <dataDir>/scratch/.
+ *
+ * Why this page exists: the raw `/api/scratch/<path>` route returns the
+ * file with its proper MIME, which works for images / pdf but is poor UX
+ * for markdown — browsers either show raw text or trigger a download
+ * (depending on the browser's text/markdown handling).
+ *
+ * This wrapper renders .md through MarkdownContent (same renderer as
+ * chat), and falls back to a plain <pre> for other text formats. It also
+ * exposes a one-click download link for any file type.
+ */
+
+import ScratchViewer from '@/components/ScratchViewer';
+
+export default async function ScratchPage({
+  params,
+}: {
+  params: Promise<{ path: string[] }>;
+}) {
+  const { path } = await params;
+  const joined = (path || []).map(encodeURIComponent).join('/');
+  return <ScratchViewer path={joined} />;
+}

package/components/ScratchViewer.tsx

@@ -0,0 +1,141 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import MarkdownContent from './MarkdownContent';
+
+const TEXT_LIKE = new Set(['md', 'txt', 'log', 'json', 'yaml', 'yml', 'csv', 'html']);
+const IMAGE_LIKE = new Set(['png', 'jpg', 'jpeg', 'gif', 'svg']);
+const EMBED_LIKE = new Set(['pdf']);
+
+/** Cap inline text rendering. Anything larger falls back to a download
+ *  prompt — react-markdown on multi-MB strings locks the tab. */
+const MAX_INLINE_BYTES = 2 * 1024 * 1024;
+
+function extOf(p: string): string {
+  const m = p.match(/\.([^./]+)$/);
+  return m ? m[1].toLowerCase() : '';
+}
+
+export default function ScratchViewer({ path }: { path: string }) {
+  const decoded = (() => {
+    try {
+      return decodeURIComponent(path);
+    } catch {
+      return path;
+    }
+  })();
+  const ext = extOf(decoded);
+  const rawUrl = `/api/scratch/${path}`;
+  const downloadUrl = `${rawUrl}?download=1`;
+
+  const [text, setText] = useState<string | null>(null);
+  const [err, setErr] = useState<string>('');
+  const [tooLarge, setTooLarge] = useState(false);
+
+  useEffect(() => {
+    if (!TEXT_LIKE.has(ext)) return;
+    let cancelled = false;
+    (async () => {
+      try {
+        const r = await fetch(rawUrl);
+        if (!r.ok) {
+          if (!cancelled) setErr(`${r.status} ${r.statusText}`);
+          return;
+        }
+        const len = Number(r.headers.get('content-length') || '0');
+        if (len > MAX_INLINE_BYTES) {
+          if (!cancelled) setTooLarge(true);
+          return;
+        }
+        const body = await r.text();
+        if (cancelled) return;
+        if (body.length > MAX_INLINE_BYTES) {
+          setTooLarge(true);
+          return;
+        }
+        setText(body);
+      } catch (e) {
+        if (!cancelled) setErr((e as Error).message);
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [rawUrl, ext]);
+
+  return (
+    <div className="min-h-screen bg-[var(--bg-primary)] text-[var(--text-primary)]">
+      <header className="sticky top-0 z-10 flex items-center justify-between gap-2 px-4 py-2 border-b border-[var(--border)] bg-[var(--bg-secondary)]">
+        <div className="flex items-center gap-2 min-w-0">
+          <span className="text-[10px] uppercase tracking-wide text-[var(--text-secondary)]">scratch</span>
+          <span className="text-xs font-mono truncate" title={decoded}>
+            {decoded}
+          </span>
+        </div>
+        <div className="flex items-center gap-2 flex-shrink-0">
+          <a
+            href={rawUrl}
+            className="text-xs px-2 py-1 rounded border border-[var(--border)] hover:bg-[var(--bg-tertiary)]"
+            target="_blank"
+            rel="noopener"
+          >
+            Open raw
+          </a>
+          <a
+            href={downloadUrl}
+            className="text-xs px-2 py-1 rounded bg-[var(--accent)] text-white hover:opacity-90"
+          >
+            Download
+          </a>
+        </div>
+      </header>
+
+      <main className="px-4 py-3 max-w-4xl mx-auto">
+        {err && (
+          <div className="text-xs text-red-400 border border-red-400/40 rounded p-2 bg-red-400/5">
+            Failed to load: {err}
+          </div>
+        )}
+
+        {tooLarge && (
+          <div className="text-xs text-[var(--text-secondary)] border border-[var(--border)] rounded p-3">
+            File is larger than {Math.round(MAX_INLINE_BYTES / 1024 / 1024)} MB — inline preview skipped. Use Download or Open raw.
+          </div>
+        )}
+
+        {!err && !tooLarge && IMAGE_LIKE.has(ext) && (
+          <img src={rawUrl} alt={decoded} className="max-w-full rounded border border-[var(--border)]" />
+        )}
+
+        {!err && !tooLarge && EMBED_LIKE.has(ext) && (
+          <embed src={rawUrl} type="application/pdf" className="w-full h-[calc(100vh-60px)]" />
+        )}
+
+        {!err && !tooLarge && TEXT_LIKE.has(ext) && text != null && (
+          ext === 'md' ? (
+            <MarkdownContent content={text} />
+          ) : ext === 'html' ? (
+            // Wrap in iframe srcdoc so any embedded scripts can't reach Forge's
+            // origin or steal session cookies. sandbox blocks everything.
+            <iframe
+              srcDoc={text}
+              sandbox=""
+              className="w-full h-[calc(100vh-60px)] bg-white rounded border border-[var(--border)]"
+              title={decoded}
+            />
+          ) : (
+            <pre className="text-[12px] font-mono text-[var(--text-primary)] bg-[var(--bg-tertiary)] border border-[var(--border)] rounded p-3 overflow-auto whitespace-pre-wrap break-words" style={{ fontFamily: 'Menlo, Monaco, "Courier New", monospace' }}>
+              {text}
+            </pre>
+          )
+        )}
+
+        {!err && !tooLarge && !TEXT_LIKE.has(ext) && !IMAGE_LIKE.has(ext) && !EMBED_LIKE.has(ext) && (
+          <div className="text-xs text-[var(--text-secondary)] border border-[var(--border)] rounded p-3">
+            No inline preview for <code className="font-mono">.{ext || '?'}</code> files. Use Download.
+          </div>
+        )}
+      </main>
+    </div>
+  );
+}

package/lib/chat/link-patterns.ts

@@ -83,13 +83,13 @@ export const LINK_PATTERNS: LinkPattern[] = [
   },
   // Forge scratch-dir files. LLMs frequently emit paths like
   // `scratch/foo.md` when they write reports during chat-launched tasks.
-  // Turn them into clickable links served by /api/scratch/<path>.
-  // Match path segments + filename with extension; bound to a known set
-  // of extensions to avoid linkifying noise like `scratch/notes`.
+  // Link to the in-browser viewer at /scratch/<path> (page renders .md
+  // through the chat markdown component + download button); the viewer
+  // itself fetches /api/scratch/<path> for raw bytes.
   {
     id: 'scratch-file',
     regex: /\bscratch\/([\w\-./]+?\.(?:md|txt|json|yaml|yml|csv|log|html|pdf|png|jpg|jpeg|gif|svg))\b/gi,
-    url: '/api/scratch/{1}',
+    url: '/scratch/{1}',
     label: 'scratch/{1}',
   },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aion0/forge",
-  "version": "0.10.51",
+  "version": "0.10.53",
   "description": "Unified AI workflow platform — multi-model task orchestration, persistent sessions, web terminal, remote access",
   "type": "module",
   "scripts": {