veryfront 0.1.72 → 0.1.74

package/esm/cli/commands/knowledge/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,WAqC3B,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,WAuC3B,CAAC"}

package/esm/cli/commands/knowledge/command-help.js

@@ -1,7 +1,7 @@
 export const knowledgeHelp = {
     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>",
@@ -26,6 +26,7 @@ export const knowledgeHelp = {
     ],
     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",
     ],
@@ -34,5 +35,6 @@ export const knowledgeHelp = {
         "`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/esm/cli/commands/knowledge/command.d.ts

@@ -41,10 +41,10 @@ type DownloadResult = {
     localPath: string;
     bytes?: number;
 };
-declare const KnowledgeIngestArgsSchema: z.ZodObject<{
+declare const KnowledgeIngestArgsSchema: z.ZodEffects<z.ZodObject<{
     projectSlug: z.ZodOptional<z.ZodString>;
     projectDir: z.ZodOptional<z.ZodString>;
-    source: z.ZodOptional<z.ZodString>;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     path: z.ZodOptional<z.ZodString>;
     all: z.ZodDefault<z.ZodBoolean>;
     recursive: z.ZodDefault<z.ZodBoolean>;
@@ -58,6 +58,7 @@ declare const KnowledgeIngestArgsSchema: z.ZodObject<{
     json: boolean;
     recursive: boolean;
     all: boolean;
+    sources: string[];
     quiet: boolean;
     knowledgePath: string;
     path?: string | undefined;
@@ -66,7 +67,6 @@ declare const KnowledgeIngestArgsSchema: z.ZodObject<{
     outputDir?: string | undefined;
     projectDir?: string | undefined;
     slug?: string | undefined;
-    source?: string | undefined;
 }, {
     path?: string | undefined;
     projectSlug?: string | undefined;
@@ -77,7 +77,33 @@ declare const KnowledgeIngestArgsSchema: z.ZodObject<{
     projectDir?: string | undefined;
     slug?: string | undefined;
     all?: boolean | undefined;
-    source?: string | undefined;
+    sources?: string[] | undefined;
+    quiet?: boolean | undefined;
+    knowledgePath?: string | undefined;
+}>, {
+    json: boolean;
+    recursive: boolean;
+    all: boolean;
+    sources: string[];
+    quiet: boolean;
+    knowledgePath: string;
+    path?: string | undefined;
+    projectSlug?: string | undefined;
+    description?: string | undefined;
+    outputDir?: string | undefined;
+    projectDir?: string | undefined;
+    slug?: string | undefined;
+}, {
+    path?: string | undefined;
+    projectSlug?: string | undefined;
+    description?: string | undefined;
+    outputDir?: string | undefined;
+    json?: boolean | undefined;
+    recursive?: boolean | undefined;
+    projectDir?: string | undefined;
+    slug?: string | undefined;
+    all?: boolean | undefined;
+    sources?: string[] | undefined;
     quiet?: boolean | undefined;
     knowledgePath?: string | undefined;
 }>;
@@ -102,8 +128,9 @@ export declare function runKnowledgeParser(input: {
     description?: string;
     slug?: string;
     sourceReference?: string;
+    env?: Record<string, string>;
 }): Promise<KnowledgeParserResult>;
-export declare function collectKnowledgeSources(options: Pick<KnowledgeIngestOptions, "source" | "path" | "all" | "recursive">, deps: {
+export declare function collectKnowledgeSources(options: Pick<KnowledgeIngestOptions, "sources" | "path" | "all" | "recursive">, deps: {
     client: ApiClient;
     projectSlug: string;
     downloadUploads: (uploadPaths: string[]) => Promise<DownloadResult[]>;

package/esm/cli/commands/knowledge/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,KAAK,SAAS,EAA0C,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAqBxD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,KAAK,eAAe,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,KAAK,cAAc,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmD7B,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AA+B/E,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,UAAU,GACf,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAexD;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGxD;AAoBD,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3E;AAgED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,MAAM,CAQR;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC,CAAC;CAChG,GAAG,yBAAyB,CAY5B;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA8CjC;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC,EAC/E,IAAI,EAAE;IACJ,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACvE,GACA,OAAO,CAAC,eAAe,EAAE,CAAC,CA0G5B;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,eAAe,EAAE,EAC1B,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE;IACJ,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,kBAAkB,CAAC;IACrC,mBAAmB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F,GACA,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAkCtC;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEtE"}

package/esm/cli/commands/knowledge/command.js

@@ -26,7 +26,7 @@ const SUPPORTED_EXTENSIONS = new Set([
 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),
@@ -36,6 +36,39 @@ 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.",
+        });
+    }
 });
 function getStringArg(args, ...keys) {
     for (const key of keys) {
@@ -56,7 +89,7 @@ function showKnowledgeUsage() {
 Veryfront Knowledge
 
 Usage:
-  veryfront knowledge ingest <source> [options]
+  veryfront knowledge ingest <source...> [options]
   veryfront knowledge ingest --path <prefix-or-dir> --all [options]
 
 Subcommands:
@@ -67,7 +100,7 @@ export function parseKnowledgeIngestArgs(args) {
     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) => typeof value === "string"),
         path: getStringArg(args, "path"),
         all: getBooleanArg(args, "all"),
         recursive: getBooleanArg(args, "recursive"),
@@ -218,6 +251,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();
@@ -241,27 +275,56 @@ export async function runKnowledgeParser(input) {
 }
 export async function collectKnowledgeSources(options, deps) {
     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 = [];
+        const uploadTargets = [];
+        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);
         }
-        if (isLikelyLocalPath(options.source)) {
-            throw new Error(`Local file not found: ${options.source}`);
+        const downloads = uploadTargets.length > 0 ? await deps.downloadUploads(uploadTargets) : [];
+        const downloadsByPath = new Map();
+        for (const download of downloads) {
+            const existing = downloadsByPath.get(download.uploadPath) ?? [];
+            existing.push(download);
+            downloadsByPath.set(download.uploadPath, existing);
         }
-        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,
-        }));
+        const resolvedSources = [];
+        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,
+            });
+        }
+        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)) {
         const localFiles = await collectLocalFiles(options.path, options.recursive);
@@ -298,7 +361,10 @@ export async function collectKnowledgeSources(options, deps) {
     }));
 }
 export async function ingestResolvedSources(sources, options, deps) {
-    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 = [];
     for (const [index, source] of sources.entries()) {
         const parser = await deps.runParser({

package/esm/cli/commands/knowledge/parser-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser-source.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/parser-source.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,QA8ZvC,CAAC"}
+{"version":3,"file":"parser-source.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/parser-source.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,QAugBvC,CAAC"}

package/esm/cli/commands/knowledge/parser-source.js

@@ -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/esm/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/esm/src/html/html-shell-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-shell-generator.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-shell-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAmBxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA+ExD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,EACtB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAWzC;AAsPD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAmBjB"}
+{"version":3,"file":"html-shell-generator.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-shell-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAmBxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA+ExD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,EACtB,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAWzC;AA+PD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/esm/src/html/html-shell-generator.js

@@ -134,6 +134,11 @@ async function generateHTMLShellPartsImpl(meta, options, params, props, contentF
         ? `<link rel="modulepreload" href="${jsxRuntimeUrl}">`
         : "";
     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;
@@ -222,6 +227,7 @@ async function generateHTMLShellPartsImpl(meta, options, params, props, contentF
   ${linkTags}
   ${styleTags}
   ${modeStyles}
+  ${slugForOverlay}
 </head>
 <body${bodyClass ? ` class="${bodyClass}"` : ""} suppressHydrationWarning>
   <div ${rootAttributes}>`;

package/esm/src/rendering/orchestrator/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA6ChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxE,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;CAC1E;AAQD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,MAAM,EAAE,oBAAoB;IAaxC;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAKxB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,sBAAsB;YAIhB,0BAA0B;IAaxC;;;;;;;;;OASG;YACW,qBAAqB;IAyDnC;;;OAGG;YACW,mBAAmB;IAqH3B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAgP9E,+EAA+E;IACzE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6LvF;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAetB"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA6ChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxE,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;CAC1E;AAQD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,MAAM,EAAE,oBAAoB;IAaxC;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAKxB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,sBAAsB;YAIhB,0BAA0B;IAaxC;;;;;;;;;OASG;YACW,qBAAqB;IAyDnC;;;OAGG;YACW,mBAAmB;IAqH3B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA8P9E,+EAA+E;IACzE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6LvF;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAetB"}