veryfront 0.1.73 → 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.73",
+    "version": "0.1.74",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

package/esm/src/server/handlers/request/ssr/ssr.handler.d.ts

@@ -9,6 +9,7 @@
 import * as dntShim from "../../../../../_dnt.shims.js";
 import { BaseHandler } from "../../response/base.js";
 import type { HandlerContext, HandlerMetadata, HandlerResult } from "../../types.js";
+import { type SSRServiceLike } from "../../../services/rendering/ssr.service.js";
 /**
  * Determine if request should serve production (released) content.
  * Uses resolvedEnvironment (from domain lookup) with fallback to requestContext.mode.
@@ -29,6 +30,7 @@ export declare function isProductionMode(ctx: HandlerContext, _url?: URL): boole
 export declare class SSRHandler extends BaseHandler {
     metadata: HandlerMetadata;
     private ssrService;
+    constructor(ssrService?: SSRServiceLike);
     handle(req: dntShim.Request, ctx: HandlerContext): Promise<HandlerResult>;
     private setupContextAndRender;
     private handleWithContext;

package/esm/src/server/handlers/request/ssr/ssr.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr.handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/request/ssr/ssr.handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAiBxB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAKzE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,QAAQ,EAAE,eAAe,CAIvB;IAEF,OAAO,CAAC,UAAU,CAAoB;IAEtC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BzE,OAAO,CAAC,qBAAqB;IAgE7B,OAAO,CAAC,iBAAiB;YAuDX,cAAc;YA6Bd,sBAAsB;YAgBtB,aAAa;CAU5B"}
+{"version":3,"file":"ssr.handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/request/ssr/ssr.handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,4CAA4C,CAAC;AAMpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAKzE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,QAAQ,EAAE,eAAe,CAIvB;IAEF,OAAO,CAAC,UAAU,CAAiB;gBAEvB,UAAU,CAAC,EAAE,cAAc;IAKvC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BzE,OAAO,CAAC,qBAAqB;IAgE7B,OAAO,CAAC,iBAAiB;YAuDX,cAAc;YA6Bd,sBAAsB;YAgBtB,aAAa;CAU5B"}

package/esm/src/server/handlers/request/ssr/ssr.handler.js

@@ -9,7 +9,7 @@ import { serverLogger } from "../../../../utils/index.js";
 import { endRequest, startRequest } from "../../../../utils/index.js";
 import { tryNotFoundFallback } from "./not-found-fallback.js";
 import { tryErrorPageFallback } from "./error-page-fallback.js";
-import { SSRService } from "../../../services/rendering/ssr.service.js";
+import { SSRService, } from "../../../services/rendering/ssr.service.js";
 import { ErrorPages } from "../../../utils/error-html.js";
 import { buildSSRResponse } from "./ssr-response-builder.js";
 const logger = serverLogger.component("ssr");
@@ -41,7 +41,11 @@ export class SSRHandler extends BaseHandler {
         priority: PRIORITY_LOW,
         patterns: [{ pattern: /^(?!\/_).*/, method: ["GET", "HEAD"] }],
     };
-    ssrService = new SSRService();
+    ssrService;
+    constructor(ssrService) {
+        super();
+        this.ssrService = ssrService ?? new SSRService();
+    }
     handle(req, ctx) {
         const url = new URL(req.url);
         const pathname = url.pathname;

package/esm/src/server/runtime-handler/adapter-factory.d.ts

@@ -8,6 +8,7 @@
  */
 import type { RuntimeAdapter } from "../../platform/adapters/base.js";
 import type { VeryfrontConfig } from "../../config/index.js";
+import { type ProjectDiscoveryCache } from "./local-project-discovery.js";
 import type { ParsedDomain } from "../utils/domain-parser.js";
 interface AdapterResolutionResult {
     /** The effective project directory to use */
@@ -46,6 +47,8 @@ interface AdapterResolutionOptions {
     headerProjectPath: string | undefined;
     /** Whether running in proxy mode */
     isProxyMode: boolean;
+    /** Optional injectable cache (defaults to module-level singleton) */
+    cache?: ProjectDiscoveryCache;
 }
 /**
  * Resolve the effective adapter and config for a request.

package/esm/src/server/runtime-handler/adapter-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter-factory.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/adapter-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM9D,UAAU,uBAAuB;IAC/B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,OAAO,EAAE,cAAc,CAAC;IACxB,kCAAkC;IAClC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,wBAAwB;IAChC,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,6BAA6B;IAC7B,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,mBAAmB;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,kBAAkB;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAC/C,kBAAkB;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,yCAAyC;IACzC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,+BAA+B;IAC/B,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAmHlC"}
+{"version":3,"file":"adapter-factory.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/adapter-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM9D,UAAU,uBAAuB;IAC/B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,OAAO,EAAE,cAAc,CAAC;IACxB,kCAAkC;IAClC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,yDAAyD;IACzD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,wBAAwB;IAChC,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,OAAO,EAAE,cAAc,CAAC;IACxB,6BAA6B;IAC7B,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,mBAAmB;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,kBAAkB;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,uCAAuC;IACvC,QAAQ,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IAC/C,kBAAkB;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,yCAAyC;IACzC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,+BAA+B;IAC/B,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAqHlC"}

package/esm/src/server/runtime-handler/adapter-factory.js

@@ -12,7 +12,7 @@ import { runtime } from "../../platform/adapters/detect.js";
 import { isExtendedFSAdapter } from "../../platform/adapters/fs/wrapper.js";
 import { getConfig } from "../../config/loader.js";
 import { timeAsync } from "./request-lifecycle.js";
-import { findLocalProjectPath, localAdapterCache } from "./local-project-discovery.js";
+import { defaultDiscoveryCache, findLocalProjectPath, } from "./local-project-discovery.js";
 const baseLogger = getBaseLogger("SERVER");
 const logger = baseLogger.component("adapter-factory");
 /**
@@ -22,6 +22,7 @@ const logger = baseLogger.component("adapter-factory");
  * For proxy mode: Uses VeryFront API adapter with project context.
  */
 export async function resolveAdapter(opts) {
+    const cache = opts.cache ?? defaultDiscoveryCache;
     let effectiveProjectDir = opts.projectDir;
     let effectiveAdapter = opts.adapter;
     let effectiveConfig = opts.config;
@@ -31,7 +32,7 @@ export async function resolveAdapter(opts) {
     const trustedHeaderProjectPath = opts.isProxyMode ? opts.headerProjectPath : undefined;
     const shouldCheckLocalPath = opts.projectSlug && (!opts.isProxyMode || trustedHeaderProjectPath);
     const localProjectPath = shouldCheckLocalPath
-        ? await findLocalProjectPath(opts.projectSlug, opts.adapter, trustedHeaderProjectPath)
+        ? await findLocalProjectPath(opts.projectSlug, opts.adapter, trustedHeaderProjectPath, cache)
         : undefined;
     const isLocalProject = !!localProjectPath;
     if (isLocalProject && localProjectPath) {
@@ -41,15 +42,15 @@ export async function resolveAdapter(opts) {
             projectDir: effectiveProjectDir,
         });
         // Get or create local adapter
-        if (!localAdapterCache.has(effectiveProjectDir)) {
+        if (!cache.adapters.has(effectiveProjectDir)) {
             const baseAdapter = await runtime.get();
-            localAdapterCache.set(effectiveProjectDir, baseAdapter);
+            cache.adapters.set(effectiveProjectDir, baseAdapter);
             logger.debug("Created local adapter for project", {
                 projectSlug: opts.projectSlug,
                 projectDir: effectiveProjectDir,
             });
         }
-        effectiveAdapter = localAdapterCache.get(effectiveProjectDir);
+        effectiveAdapter = cache.adapters.get(effectiveProjectDir);
         // Load project-specific config
         try {
             effectiveConfig = await timeAsync("config:load-project", () => getConfig(effectiveProjectDir, effectiveAdapter));

package/esm/src/server/runtime-handler/index.d.ts

@@ -9,7 +9,40 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import type { RuntimeAdapter } from "../../platform/adapters/base.js";
 import type { VeryfrontConfig } from "../../config/index.js";
+import { RouteRegistry } from "../../routing/registry/index.js";
+import type { Handler } from "../../types/index.js";
+import { ApiHandlerWrapper } from "../handlers/request/api/index.js";
 export { parseProxyEnvironment, type ProxyEnvironment } from "./proxy-environment.js";
+/** Handler names in registration order. */
+export declare const HANDLER_NAMES: readonly ["AuthHandler", "CsrfHandler", "HMRHandler", "CorsHandler", "HealthHandler", "MetricsHandler", "MemoryDebugHandler", "ClientLogHandler", "DevEndpointsHandler", "StylesCSSHandler", "DebugContextHandler", "OpenAPIHandler", "OpenAPIDocsHandler", "InternalAgentsListHandler", "AgentStreamHandler", "AgentRunResumeHandler", "AgentRunCancelHandler", "ChannelInvokeHandler", "DevDashboardHandler", "ProjectsHandler", "StudioBridgeModulesHandler", "CSSHandler", "DevFileHandler", "SnippetHandler", "StaticHandler", "LibModulesHandler", "RSCHandler", "ModuleHandler", "ApiHandlerWrapper", "MarkdownPreviewHandler", "SSRHandler", "NotFoundHandler"];
+/** Union of all registered handler names. */
+export type HandlerName = (typeof HANDLER_NAMES)[number];
+/**
+ * Dependencies for handler registry creation.
+ * All fields are optional — when omitted, the real handler implementation is used.
+ * This allows tests to inject mock handlers for specific slots.
+ */
+export interface HandlerDependencies {
+    /** Override any handler by its typed name. */
+    overrides?: Partial<Record<HandlerName, Handler>>;
+    /** When true, log handler registration details. */
+    debug?: boolean;
+}
+/**
+ * Creates a RouteRegistry populated with the standard handler chain.
+ *
+ * Handlers are instantiated lazily — overridden slots skip construction
+ * of the default handler entirely.
+ *
+ * @param projectDir - Root project directory
+ * @param adapter - Runtime adapter for environment access
+ * @param deps - Optional dependency overrides for testing
+ * @returns Object containing the registry and the api handler (for initialization)
+ */
+export declare function createHandlerRegistry(projectDir: string, adapter: RuntimeAdapter, deps?: HandlerDependencies): {
+    registry: RouteRegistry;
+    apiHandler: ApiHandlerWrapper;
+};
 export interface RuntimeHandlerOptions {
     projectDir: string;
     /** When true, expose additional debug logging. */

package/esm/src/server/runtime-handler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAQlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA6F7D,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAMtF,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAC/C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,qBAAsC,GAC3C,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CA4anF;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAQlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA0BpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AA8DrE,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAMtF,2CAA2C;AAC3C,eAAO,MAAM,aAAa,yoBAiChB,CAAC;AAEX,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyCD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,mBAAwB,GAC7B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAuB5D;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAC/C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,qBAAsC,GAC3C,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAsYnF;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC"}