veryfront 0.1.72 → 0.1.74

package/esm/src/server/shared/renderer/adapter.js

@@ -10,12 +10,72 @@ const logger = rendererLogger.component("renderer-adapter");
 const RENDER_CACHE_TTL_SECONDS = 3_600;
 /** Maximum entries for the local render cache layer */
 const RENDER_CACHE_LOCAL_MAX_ENTRIES = 200;
-let rendererInitPromise = null;
+/**
+ * Default initializer that delegates to the real shared renderer
+ * singleton from `#veryfront/rendering/renderer.ts`.
+ */
+const defaultInitializer = {
+    initialize: initializeRenderer,
+    isInitialized: isRendererInitialized,
+    get: getRenderer,
+    destroy: destroySharedRenderer,
+};
+let activeInitializer = defaultInitializer;
+let rendererInitState = null;
+function scheduleInitializerDestroy(initializer, pendingPromise) {
+    const destroy = async () => {
+        try {
+            await initializer.destroy();
+        }
+        catch (error) {
+            logger.warn("Failed to destroy renderer initializer", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    };
+    if (pendingPromise) {
+        void pendingPromise
+            .catch(() => undefined)
+            .then(destroy);
+        return;
+    }
+    if (!initializer.isInitialized())
+        return;
+    void destroy();
+}
+/**
+ * Replace the renderer initializer used by the adapter layer.
+ * Pass `undefined` to restore the default (real) initializer.
+ *
+ * Returns a disposer that restores the previous initializer — use in
+ * `afterEach` or with `using` to prevent test pollution:
+ *
+ * ```ts
+ * afterEach(() => setRendererInitializer(undefined));
+ * ```
+ *
+ * @internal Test-only — not part of the public API.
+ */
+export function setRendererInitializer(initializer) {
+    const nextInitializer = initializer ?? defaultInitializer;
+    const previous = activeInitializer;
+    const previousPendingPromise = rendererInitState?.initializer === previous
+        ? rendererInitState.promise
+        : undefined;
+    activeInitializer = nextInitializer;
+    if (rendererInitState?.initializer !== activeInitializer) {
+        rendererInitState = null;
+    }
+    if (previous !== activeInitializer) {
+        scheduleInitializerDestroy(previous, previousPendingPromise);
+    }
+}
 async function getOrInitRenderer() {
-    if (isRendererInitialized())
-        return getRenderer();
-    if (rendererInitPromise)
-        return rendererInitPromise;
+    if (activeInitializer.isInitialized())
+        return activeInitializer.get();
+    if (rendererInitState?.initializer === activeInitializer) {
+        return rendererInitState.promise;
+    }
     const isProxyMode = getEnvBoolean("PROXY_MODE", false, {
         trueValues: ["1"],
         trim: false,
@@ -42,12 +102,19 @@ async function getOrInitRenderer() {
         hasApiUrl: !!apiBaseUrl,
         cacheType: useApiCache ? "api-distributed" : "memory",
     });
-    rendererInitPromise = initializeRenderer(options);
+    const initializer = activeInitializer;
+    const initPromise = initializer.initialize(options);
+    rendererInitState = {
+        initializer,
+        promise: initPromise,
+    };
     try {
-        return await rendererInitPromise;
+        return await initPromise;
     }
     finally {
-        rendererInitPromise = null;
+        if (rendererInitState?.promise === initPromise) {
+            rendererInitState = null;
+        }
     }
 }
 function resolveEnvironment(ctx) {
@@ -210,6 +277,12 @@ export async function getRendererForProject(ctx) {
     return new RendererAdapterImpl(renderer, renderCtx);
 }
 export async function destroyRendererAdapter() {
-    await destroySharedRenderer();
-    rendererInitPromise = null;
+    const pendingPromise = rendererInitState?.initializer === activeInitializer
+        ? rendererInitState.promise
+        : undefined;
+    rendererInitState = null;
+    if (pendingPromise) {
+        await pendingPromise.catch(() => undefined);
+    }
+    await activeInitializer.destroy();
 }

package/esm/src/server/shared/renderer/index.d.ts

@@ -3,6 +3,6 @@
  *
  * @module server/shared/renderer
  */
-export { destroyRendererAdapter, getRendererForProject, type RendererAdapter } from "./adapter.js";
+export { destroyRendererAdapter, getRendererForProject, type RendererAdapter, type RendererInitializer, setRendererInitializer, } from "./adapter.js";
 export { shouldRejectDueToMemory } from "./memory/pressure.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/server/shared/renderer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/shared/renderer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/shared/renderer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/esm/src/server/shared/renderer/index.js

@@ -3,5 +3,5 @@
  *
  * @module server/shared/renderer
  */
-export { destroyRendererAdapter, getRendererForProject } from "./adapter.js";
+export { destroyRendererAdapter, getRendererForProject, setRendererInitializer, } from "./adapter.js";
 export { shouldRejectDueToMemory } from "./memory/pressure.js";

package/esm/src/server/utils/error-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-html.d.ts","sourceRoot":"","sources":["../../../../src/src/server/utils/error-html.ts"],"names":[],"mappings":"AAAA,UAAU,gBAAgB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAQnE;AAuFD,eAAO,MAAM,UAAU;wBACD,MAAM,GAAG,MAAM;0BAUb,MAAM,GAAG,MAAM;kBAQvB,MAAM;sBAQF,MAAM;CAOzB,CAAC"}
+{"version":3,"file":"error-html.d.ts","sourceRoot":"","sources":["../../../../src/src/server/utils/error-html.ts"],"names":[],"mappings":"AAEA,UAAU,gBAAgB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAQnE;AA4GD,eAAO,MAAM,UAAU;wBACD,MAAM,GAAG,MAAM;0BAUb,MAAM,GAAG,MAAM;kBAQvB,MAAM;sBAQF,MAAM;CAOzB,CAAC"}

package/esm/src/server/utils/error-html.js

@@ -1,3 +1,4 @@
+import { escapeHTML } from "../../html/html-escape.js";
 export function generateErrorHtml(options) {
     const { statusCode, title, message, pathname, minimal } = options;
     if (minimal) {
@@ -6,13 +7,16 @@ export function generateErrorHtml(options) {
     return generateStyledErrorHtml(statusCode, title, message);
 }
 function generateStyledErrorHtml(statusCode, title, message) {
+    const errorMessage = title === "Not Found" ? `Page not found: ${message}` : message;
+    // 4xx = warning (routing/config issue), 5xx = error (something broke)
+    const errorType = statusCode >= 500 ? "error" : "warning";
     return `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width">
   <link rel="icon" type="image/png" href="https://cdn.veryfront.com/images/veryfront-favicon.png">
-  <title>${statusCode} ${title} — Veryfront</title>
+  <title>${statusCode} ${escapeHTML(title)} — Veryfront</title>
   <style>
     :root {
       --bg: #ffffff;
@@ -61,9 +65,25 @@ function generateStyledErrorHtml(statusCode, title, message) {
 </head>
 <body>
   <div class="container">
-    <h1 class="title">${title}</h1>
-    <p class="message">${message}</p>
+    <h1 class="title">${escapeHTML(title)}</h1>
+    <p class="message">${escapeHTML(message)}</p>
   </div>
+  <script>
+    if (window.parent !== window) {
+      try {
+        window.parent.postMessage({
+          action: 'appUpdated',
+          isInitialLoad: true,
+          hasError: true,
+          url: window.location.href,
+          errors: [{
+            type: '${errorType}',
+            message: ${JSON.stringify(errorMessage).replace(/</g, "\\u003c")}
+          }]
+        }, '*');
+      } catch (e) { /* postMessage may fail in cross-origin iframes */ }
+    }
+  </script>
 </body>
 </html>`;
 }
@@ -74,11 +94,11 @@ function generateMinimalErrorHtml(statusCode, title, message, pathname) {
 <head>
   <meta charset="utf-8"/>
   <meta name="viewport" content="width=device-width, initial-scale=1"/>
-  <title>${statusCode} ${title}</title>
+  <title>${statusCode} ${escapeHTML(title)}</title>
 </head>
 <body>
-  <h1>${statusCode} ${title}</h1>
-  <p>${fullMessage}</p>
+  <h1>${statusCode} ${escapeHTML(title)}</h1>
+  <p>${escapeHTML(fullMessage)}</p>
 </body>
 </html>`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.72",
+  "version": "0.1.74",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/cli/commands/knowledge/command-help.ts

@@ -3,7 +3,7 @@ import type { CommandHelp } from "../../help/types.js";
 export const knowledgeHelp: CommandHelp = {
   name: "knowledge",
   description: "Ingest documents into the project knowledge base",
-  usage: "veryfront knowledge ingest <source> [options]",
+  usage: "veryfront knowledge ingest <source...> [options]",
   options: [
     {
       flag: "--project, -p <slug>",
@@ -28,6 +28,7 @@ export const knowledgeHelp: CommandHelp = {
   ],
   examples: [
     "veryfront knowledge ingest uploads/contracts/q1.pdf --json",
+    "veryfront knowledge ingest uploads/contracts/a.pdf uploads/contracts/b.pdf uploads/contracts/c.pdf --json",
     "veryfront knowledge ingest /workspace/uploads/q1.pdf --json",
     "veryfront knowledge ingest --path uploads/ --all --json",
   ],
@@ -36,5 +37,6 @@ export const knowledgeHelp: CommandHelp = {
     "`uploads/...` means a remote project upload; use `./uploads/...` or `/workspace/uploads/...` to force a local file",
     "`ingest` orchestrates upload resolution, parsing, and project file writes",
     "Requires python3; non-text formats also require the supported parser packages unless you run inside the Veryfront sandbox",
+    "The Veryfront sandbox image includes `kreuzberg`, and knowledge ingest falls back to the built-in parser when `kreuzberg` is unavailable or extraction fails",
   ],
 };

package/src/cli/commands/knowledge/command.ts

@@ -62,7 +62,7 @@ type DownloadResult = { uploadPath: string; localPath: string; bytes?: number };
 const KnowledgeIngestArgsSchema = z.object({
   projectSlug: z.string().optional(),
   projectDir: z.string().optional(),
-  source: z.string().optional(),
+  sources: z.array(z.string()).default([]),
   path: z.string().optional(),
   all: z.boolean().default(false),
   recursive: z.boolean().default(false),
@@ -72,6 +72,44 @@ const KnowledgeIngestArgsSchema = z.object({
   slug: z.string().optional(),
   json: z.boolean().default(false),
   quiet: z.boolean().default(false),
+}).superRefine((value, ctx) => {
+  const hasExplicitSources = value.sources.length > 0;
+  const hasPath = typeof value.path === "string" && value.path.length > 0;
+
+  if (hasExplicitSources && (hasPath || value.all)) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "Use either explicit source paths or --path with --all, not both.",
+    });
+  }
+
+  if (!hasExplicitSources && !hasPath && !value.all) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "Provide one or more source paths or use --path with --all.",
+    });
+  }
+
+  if (hasPath && !value.all) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "--path requires --all.",
+    });
+  }
+
+  if (!hasPath && value.all) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "--all requires --path.",
+    });
+  }
+
+  if (value.slug && value.sources.length !== 1) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "--slug can only be used with a single explicit source.",
+    });
+  }
 });
 
 export type KnowledgeIngestOptions = z.infer<typeof KnowledgeIngestArgsSchema>;
@@ -97,7 +135,7 @@ function showKnowledgeUsage(): void {
 Veryfront Knowledge
 
 Usage:
-  veryfront knowledge ingest <source> [options]
+  veryfront knowledge ingest <source...> [options]
   veryfront knowledge ingest --path <prefix-or-dir> --all [options]
 
 Subcommands:
@@ -111,7 +149,7 @@ export function parseKnowledgeIngestArgs(
   return KnowledgeIngestArgsSchema.safeParse({
     projectSlug: getStringArg(args, "project", "p", "project-slug"),
     projectDir: getStringArg(args, "project-dir", "dir", "d"),
-    source: typeof args._[2] === "string" ? args._[2] : undefined,
+    sources: args._.slice(2).filter((value): value is string => typeof value === "string"),
     path: getStringArg(args, "path"),
     all: getBooleanArg(args, "all"),
     recursive: getBooleanArg(args, "recursive"),
@@ -273,6 +311,7 @@ export async function runKnowledgeParser(input: {
   description?: string;
   slug?: string;
   sourceReference?: string;
+  env?: Record<string, string>;
 }): Promise<KnowledgeParserResult> {
   const tempDir = await dntShim.Deno.makeTempDir({ prefix: "veryfront-knowledge-parser-" });
   const inputJsonPath = `${tempDir}/input.json`;
@@ -296,6 +335,7 @@ export async function runKnowledgeParser(input: {
     try {
       result = await new dntShim.Deno.Command("python3", {
         args: [scriptPath, "--input-json", inputJsonPath, "--output-json", outputJsonPath],
+        ...(input.env ? { env: input.env } : {}),
         stdout: "piped",
         stderr: "piped",
       }).output();
@@ -321,7 +361,7 @@ export async function runKnowledgeParser(input: {
 }
 
 export async function collectKnowledgeSources(
-  options: Pick<KnowledgeIngestOptions, "source" | "path" | "all" | "recursive">,
+  options: Pick<KnowledgeIngestOptions, "sources" | "path" | "all" | "recursive">,
   deps: {
     client: ApiClient;
     projectSlug: string;
@@ -330,29 +370,68 @@ export async function collectKnowledgeSources(
 ): Promise<KnowledgeSource[]> {
   const fs = createFileSystem();
 
-  if (options.source) {
-    if (!isProjectUploadReference(options.source) && await fs.exists(options.source)) {
-      const localFiles = await collectLocalFiles(options.source, options.recursive);
-      if (!localFiles.length) throw new Error(`No supported files found at ${options.source}`);
-      return localFiles.map((localPath) => ({ kind: "local", input: options.source!, localPath }));
+  if (options.sources.length > 0) {
+    const explicitSources: Array<
+      | { kind: "local"; sources: KnowledgeSource[] }
+      | { kind: "upload"; input: string; uploadPath: string }
+    > = [];
+    const uploadTargets: string[] = [];
+
+    for (const input of options.sources) {
+      if (!isProjectUploadReference(input) && await fs.exists(input)) {
+        const localFiles = await collectLocalFiles(input, options.recursive);
+        if (!localFiles.length) throw new Error(`No supported files found at ${input}`);
+        explicitSources.push({
+          kind: "local",
+          sources: localFiles.map((localPath) => ({ kind: "local", input, localPath })),
+        });
+        continue;
+      }
+
+      if (isLikelyLocalPath(input)) {
+        throw new Error(`Local file not found: ${input}`);
+      }
+
+      const uploadPath = normalizeProjectUploadPath(input);
+      explicitSources.push({ kind: "upload", input, uploadPath });
+      uploadTargets.push(uploadPath);
+    }
+
+    const downloads = uploadTargets.length > 0 ? await deps.downloadUploads(uploadTargets) : [];
+    const downloadsByPath = new Map<string, DownloadResult[]>();
+
+    for (const download of downloads) {
+      const existing = downloadsByPath.get(download.uploadPath) ?? [];
+      existing.push(download);
+      downloadsByPath.set(download.uploadPath, existing);
     }
 
-    if (isLikelyLocalPath(options.source)) {
-      throw new Error(`Local file not found: ${options.source}`);
+    const resolvedSources: KnowledgeSource[] = [];
+    for (const source of explicitSources) {
+      if (source.kind === "local") {
+        resolvedSources.push(...source.sources);
+        continue;
+      }
+
+      const matchingDownloads = downloadsByPath.get(source.uploadPath);
+      const download = matchingDownloads?.shift();
+      if (!download) {
+        throw new Error(`Upload not found: ${formatKnowledgeUploadSource(source.uploadPath)}`);
+      }
+
+      resolvedSources.push({
+        kind: "upload",
+        input: source.input,
+        uploadPath: download.uploadPath,
+        localPath: download.localPath,
+      });
     }
 
-    const uploadPath = normalizeProjectUploadPath(options.source);
-    const downloads = await deps.downloadUploads([uploadPath]);
-    return downloads.map((download) => ({
-      kind: "upload",
-      input: options.source!,
-      uploadPath: download.uploadPath,
-      localPath: download.localPath,
-    }));
+    return resolvedSources;
   }
 
   if (!options.path || !options.all) {
-    throw new Error("Provide a source path or use --path with --all.");
+    throw new Error("Provide one or more source paths or use --path with --all.");
   }
 
   if (!isProjectUploadReference(options.path) && await fs.exists(options.path)) {
@@ -407,7 +486,11 @@ export async function ingestResolvedSources(
     uploadKnowledgeFile: (remotePath: string, localPath: string) => Promise<{ path: string }>;
   },
 ): Promise<KnowledgeIngestFileResult[]> {
-  const slugs = options.slug && sources.length === 1 ? [options.slug] : ensureUniqueSlugs(sources);
+  if (options.slug && sources.length !== 1) {
+    throw new Error("--slug can only be used with a single explicit source.");
+  }
+
+  const slugs = options.slug ? [options.slug] : ensureUniqueSlugs(sources);
   const results: KnowledgeIngestFileResult[] = [];
 
   for (const [index, source] of sources.entries()) {

package/src/cli/commands/knowledge/parser-source.ts

@@ -3,6 +3,7 @@ import argparse
 import csv
 import json
 import re
+import subprocess
 from datetime import date
 from pathlib import Path
 from typing import Any, Optional
@@ -71,6 +72,107 @@ def build_frontmatter(source: str, source_type: str, description: str) -> str:
     ])
 
 
+def metadata_int(metadata: dict[str, Any], *keys: str) -> Optional[int]:
+    for key in keys:
+        value = metadata.get(key)
+        if isinstance(value, int) and not isinstance(value, bool):
+            return value
+    return None
+
+
+def metadata_string_list(metadata: dict[str, Any], *keys: str) -> Optional[list[str]]:
+    for key in keys:
+        value = metadata.get(key)
+        if isinstance(value, list) and all(isinstance(item, str) for item in value):
+            return value
+    return None
+
+
+def build_kreuzberg_stats(source_type: str, content: str, metadata: dict[str, Any]):
+    stats: dict[str, Any] = {
+        "characters": len(content),
+        "lines": len(content.splitlines()) if content else 0,
+        "engine": "kreuzberg",
+    }
+
+    if isinstance(metadata.get("mime_type"), str):
+        stats["mime_type"] = metadata["mime_type"]
+
+    if source_type == "pdf":
+        stats["pages"] = metadata_int(metadata, "page_count") or 0
+        stats["tables"] = metadata_int(metadata, "table_count") or 0
+    elif source_type in {"xlsx", "xls"}:
+        stats["sheets"] = metadata_int(metadata, "sheet_count") or 0
+        stats["rows"] = metadata_int(metadata, "row_count") or 0
+        stats["sheet_names"] = metadata_string_list(metadata, "sheet_names") or []
+    elif source_type == "docx":
+        stats["paragraphs"] = metadata_int(metadata, "paragraph_count") or 0
+        stats["tables"] = metadata_int(metadata, "table_count") or 0
+    elif source_type == "pptx":
+        stats["slides"] = metadata_int(metadata, "slide_count", "page_count") or 0
+        stats["tables"] = metadata_int(metadata, "table_count") or 0
+    elif source_type == "html":
+        stats["tables"] = metadata_int(metadata, "table_count") or 0
+
+    return stats
+
+
+def parse_with_kreuzberg(path: str, source_type: str):
+    warnings: list[str] = []
+    completed = subprocess.run(
+        [
+            "kreuzberg",
+            "extract",
+            path,
+            "--format",
+            "json",
+            "--output-format",
+            "markdown",
+        ],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+
+    if completed.returncode != 0:
+        detail = completed.stderr.strip() or completed.stdout.strip() or f"exit code {completed.returncode}"
+        raise RuntimeError(f"kreuzberg extract failed: {detail}")
+
+    try:
+        payload = json.loads(completed.stdout)
+    except json.JSONDecodeError as error:
+        raise RuntimeError(f"kreuzberg extract returned invalid JSON: {error}") from error
+
+    content = payload.get("content", "")
+    if not isinstance(content, str):
+        raise RuntimeError("kreuzberg extract did not return string content")
+
+    metadata = payload.get("metadata") if isinstance(payload.get("metadata"), dict) else {}
+    normalized_content = clean_text(content)
+    stats = build_kreuzberg_stats(source_type, normalized_content, metadata)
+
+    return normalized_content or "_No extractable text found in document._", stats, warnings
+
+
+def prefer_kreuzberg(source_type: str, fallback_parser):
+    def parser(path: str):
+        try:
+            return parse_with_kreuzberg(path, source_type)
+        except FileNotFoundError as error:
+            if getattr(error, "filename", "") == "kreuzberg":
+                return fallback_parser(path)
+            raise
+        except RuntimeError as error:
+            content, stats, warnings = fallback_parser(path)
+            warnings.append(
+                "kreuzberg extraction failed; fell back to the built-in parser: "
+                + str(error)
+            )
+            return content, stats, warnings
+
+    return parser
+
+
 def parse_csv_like(path: str, delimiter: str = ","):
     warnings: list[str] = []
     with open(path, newline="", encoding="utf-8-sig") as file:
@@ -305,18 +407,19 @@ def parse_json(path: str):
 def select_parser(path: Path):
     ext = path.suffix.lower()
     if ext == ".pdf":
-        return "pdf", parse_pdf
+        return "pdf", prefer_kreuzberg("pdf", parse_pdf)
     if ext in {".csv", ".tsv"}:
         delimiter = "\t" if ext == ".tsv" else ","
         return ext.lstrip("."), lambda file_path: parse_csv_like(file_path, delimiter)
     if ext in {".xlsx", ".xls"}:
-        return ext.lstrip("."), parse_excel
+        source_type = ext.lstrip(".")
+        return source_type, prefer_kreuzberg(source_type, parse_excel)
     if ext == ".docx":
-        return "docx", parse_docx
+        return "docx", prefer_kreuzberg("docx", parse_docx)
     if ext == ".pptx":
-        return "pptx", parse_pptx
+        return "pptx", prefer_kreuzberg("pptx", parse_pptx)
     if ext in {".html", ".htm"}:
-        return "html", parse_html
+        return "html", prefer_kreuzberg("html", parse_html)
     if ext in {".txt", ".md", ".mdx"}:
         return ext.lstrip("."), parse_text
     if ext == ".json":
@@ -325,6 +428,8 @@ def select_parser(path: Path):
 
 
 def build_summary(source_type: str, stats: dict[str, Any]) -> str:
+    if stats.get("engine") == "kreuzberg":
+        return f"Converted {source_type.upper()} to markdown ({stats.get('characters', 0)} chars)."
     if source_type in {"csv", "tsv"}:
         return f"Parsed {stats.get('rows', 0)} rows across {stats.get('columns', 0)} columns."
     if source_type in {"xlsx", "xls"}:

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.72",
+  "version": "0.1.74",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/html/html-shell-generator.ts

@@ -208,6 +208,14 @@ async function generateHTMLShellPartsImpl(
 
   const nonceAttr = nonce ? ` nonce="${nonce}"` : "";
 
+  // Expose project slug for runtime error overlay "Fix in Veryfront" button
+  const overlaySlug = options.projectId || meta.slug;
+  const slugForOverlay = useDevScripts && overlaySlug
+    ? `<script${nonceAttr}>window.__VF_PROJECT_SLUG__=${
+      JSON.stringify(overlaySlug).replace(/</g, "\\u003c")
+    };</script>`
+    : "";
+
   const hydrationErrorSuppression = useDevScripts ? "" : `<script${nonceAttr}>
 (function(){
   var origError = console.error;
@@ -303,6 +311,7 @@ async function generateHTMLShellPartsImpl(
   ${linkTags}
   ${styleTags}
   ${modeStyles}
+  ${slugForOverlay}
 </head>
 <body${bodyClass ? ` class="${bodyClass}"` : ""} suppressHydrationWarning>
   <div ${rootAttributes}>`;