@runcore-sh/runcore 0.1.2

package/dist/library/brain-shadow.js

@@ -0,0 +1,158 @@
+/**
+ * Brain Shadow Files — read-only viewer for whitelisted brain directories.
+ * Mounted at /api/library/brain in server.ts.
+ * Pure GET routes, zero mutation surface.
+ */
+import { Hono } from "hono";
+import { readdir, stat, readFile } from "node:fs/promises";
+import { join, basename, extname } from "node:path";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("library.brain-shadow");
+const CATEGORIES = [
+    { key: "research", label: "Research", icon: "🔬", relPath: "knowledge/research" },
+    { key: "notes", label: "Notes", icon: "📝", relPath: "knowledge/notes" },
+    { key: "protocols", label: "Protocols", icon: "📐", relPath: "knowledge/protocols" },
+    { key: "identity", label: "Identity", icon: "🧬", relPath: "identity", mdOnly: true },
+    { key: "templates", label: "Templates", icon: "📋", relPath: "content/templates" },
+];
+const CATEGORY_MAP = new Map(CATEGORIES.map((c) => [c.key, c]));
+const ALLOWED_EXTENSIONS = new Set([".md", ".yaml", ".yml"]);
+const BLOCKED_FILES = new Set([".session-key", "human.json"]);
+let brainDir = "";
+/** Call once during server init to set the brain directory root. */
+export function initBrainShadow(dir) {
+    brainDir = dir;
+    log.info(`Brain shadow initialized: ${dir}`);
+}
+// ── Helpers ─────────────────────────────────────────────────────────────
+function isAllowed(filename, mdOnly) {
+    const base = basename(filename);
+    if (base.startsWith("."))
+        return false;
+    if (BLOCKED_FILES.has(base))
+        return false;
+    const ext = extname(base).toLowerCase();
+    if (mdOnly)
+        return ext === ".md";
+    return ALLOWED_EXTENSIONS.has(ext);
+}
+function mimeForExt(ext) {
+    switch (ext.toLowerCase()) {
+        case ".md":
+            return "text/markdown";
+        case ".yaml":
+        case ".yml":
+            return "text/yaml";
+        default:
+            return "text/plain";
+    }
+}
+async function scanCategory(cat) {
+    const dirPath = join(brainDir, cat.relPath);
+    let entries;
+    try {
+        entries = await readdir(dirPath);
+    }
+    catch {
+        return [];
+    }
+    const files = [];
+    for (const entry of entries) {
+        if (!isAllowed(entry, cat.mdOnly))
+            continue;
+        const filePath = join(dirPath, entry);
+        try {
+            const st = await stat(filePath);
+            if (!st.isFile())
+                continue;
+            const content = await readFile(filePath, "utf-8");
+            files.push({
+                id: `shadow_${cat.key}_${entry}`,
+                name: entry,
+                sizeBytes: st.size,
+                mimeType: mimeForExt(extname(entry)),
+                modifiedAt: st.mtime.toISOString(),
+                textPreview: content.slice(0, 500),
+            });
+        }
+        catch {
+            // Skip files we can't read
+        }
+    }
+    // Sort by modified date descending
+    files.sort((a, b) => new Date(b.modifiedAt).getTime() - new Date(a.modifiedAt).getTime());
+    return files;
+}
+// ── Routes ──────────────────────────────────────────────────────────────
+export const brainShadowRoutes = new Hono();
+/** GET / — List categories with file counts */
+brainShadowRoutes.get("/", async (c) => {
+    try {
+        const categories = await Promise.all(CATEGORIES.map(async (cat) => {
+            const files = await scanCategory(cat);
+            return {
+                key: cat.key,
+                label: cat.label,
+                icon: cat.icon,
+                fileCount: files.length,
+                totalBytes: files.reduce((sum, f) => sum + f.sizeBytes, 0),
+            };
+        }));
+        return c.json({ categories });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.error(`Failed to list brain categories: ${msg}`);
+        return c.json({ error: msg }, 500);
+    }
+});
+/** GET /:category — List files in category */
+brainShadowRoutes.get("/:category", async (c) => {
+    try {
+        const key = c.req.param("category");
+        const cat = CATEGORY_MAP.get(key);
+        if (!cat)
+            return c.json({ error: "Unknown category" }, 404);
+        const files = await scanCategory(cat);
+        return c.json({
+            category: { key: cat.key, label: cat.label, icon: cat.icon },
+            files,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.error(`Failed to list brain files: ${msg}`);
+        return c.json({ error: msg }, 500);
+    }
+});
+/** GET /:category/:filename/download — Serve file with path traversal protection */
+brainShadowRoutes.get("/:category/:filename/download", async (c) => {
+    try {
+        const key = c.req.param("category");
+        const cat = CATEGORY_MAP.get(key);
+        if (!cat)
+            return c.json({ error: "Unknown category" }, 404);
+        const rawFilename = c.req.param("filename");
+        const safe = basename(rawFilename);
+        if (!isAllowed(safe, cat.mdOnly)) {
+            return c.json({ error: "File type not allowed" }, 403);
+        }
+        const filePath = join(brainDir, cat.relPath, safe);
+        const content = await readFile(filePath);
+        return new Response(content, {
+            headers: {
+                "Content-Type": mimeForExt(extname(safe)),
+                "Content-Disposition": `attachment; filename="${safe}"`,
+                "Content-Length": content.length.toString(),
+            },
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("ENOENT"))
+            return c.json({ error: "File not found" }, 404);
+        log.error(`Failed to download brain file: ${msg}`);
+        return c.json({ error: msg }, 500);
+    }
+});
+//# sourceMappingURL=brain-shadow.js.map

package/dist/library/brain-shadow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-shadow.js","sourceRoot":"","sources":["../../src/library/brain-shadow.ts"],"names":[],"mappings":"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"}

package/dist/library/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Library module — virtual folder navigation over the file registry.
+ */
+export type { LibraryFolder, LibraryStateEntry, FolderTreeNode } from "./types.js";
+export { DEFAULT_ROOT_FOLDERS } from "./types.js";
+export { LibraryStore, createLibraryStore, getLibraryStore } from "./store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/library/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/library/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/library/index.js

@@ -0,0 +1,6 @@
+/**
+ * Library module — virtual folder navigation over the file registry.
+ */
+export { DEFAULT_ROOT_FOLDERS } from "./types.js";
+export { LibraryStore, createLibraryStore, getLibraryStore } from "./store.js";
+//# sourceMappingURL=index.js.map

package/dist/library/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/library/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/library/routes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Library API routes — mounted at /api/library in server.ts.
+ * Virtual folder navigation + file browsing over the flat FileManager registry.
+ */
+import { Hono } from "hono";
+export declare const libraryRoutes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=routes.d.ts.map

package/dist/library/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/library/routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ5B,eAAO,MAAM,aAAa,4EAAa,CAAC"}

package/dist/library/routes.js

@@ -0,0 +1,473 @@
+/**
+ * Library API routes — mounted at /api/library in server.ts.
+ * Virtual folder navigation + file browsing over the flat FileManager registry.
+ */
+import { Hono } from "hono";
+import { createLogger } from "../utils/logger.js";
+import { FileManager } from "../files/manager.js";
+import { getLibraryStore } from "./store.js";
+const log = createLogger("library.routes");
+export const libraryRoutes = new Hono();
+/** Get store or 503. */
+function store() {
+    const s = getLibraryStore();
+    if (!s)
+        throw new Error("Library not initialized");
+    return s;
+}
+/** Get FileManager or 503. */
+function fm() {
+    const f = FileManager.getInstance();
+    if (!f)
+        throw new Error("FileManager not initialized");
+    return f;
+}
+// ── Folder tree ────────────────────────────────────────────────────────────
+libraryRoutes.get("/tree", async (c) => {
+    try {
+        const lib = store();
+        const fileMgr = fm();
+        // Count files per folderId
+        const allFiles = await fileMgr.list();
+        const fileCounts = new Map();
+        for (const f of allFiles) {
+            const fid = f.meta?.folderId;
+            if (fid)
+                fileCounts.set(fid, (fileCounts.get(fid) ?? 0) + 1);
+        }
+        const tree = await lib.getTree(fileCounts);
+        const unfiled = allFiles.filter((f) => !f.meta?.folderId).length;
+        return c.json({ tree, unfiled });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Folder contents ────────────────────────────────────────────────────────
+libraryRoutes.get("/folders/:id", async (c) => {
+    try {
+        const lib = store();
+        const fileMgr = fm();
+        const id = c.req.param("id");
+        const folder = await lib.getFolder(id);
+        if (!folder)
+            return c.json({ error: "Folder not found" }, 404);
+        const subfolders = await lib.listFolders(id);
+        const breadcrumb = await lib.getBreadcrumb(id);
+        // System folder: "last-used" pulls from recents instead of folderId
+        let files;
+        if (folder.systemType === "last-used") {
+            const recents = await lib.getRecents(60);
+            const hydrated = [];
+            const seen = new Set();
+            for (const r of recents) {
+                if (r.targetType !== "file")
+                    continue;
+                if (seen.has(r.targetId))
+                    continue;
+                seen.add(r.targetId);
+                const file = await fileMgr.get(r.targetId);
+                if (file && file.status !== "archived") {
+                    hydrated.push({ ...file, _lastAccessed: r.timestamp });
+                }
+                if (hydrated.length >= 30)
+                    break;
+            }
+            files = hydrated;
+        }
+        else {
+            files = await fileMgr.list({ folderId: id });
+        }
+        // Record access
+        await lib.recordAccess(id, "folder");
+        return c.json({ folder, subfolders, files, breadcrumb });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Create folder ──────────────────────────────────────────────────────────
+libraryRoutes.post("/folders", async (c) => {
+    try {
+        const lib = store();
+        const body = await c.req.json();
+        if (!body.name)
+            return c.json({ error: "name required" }, 400);
+        const folder = await lib.createFolder({
+            name: body.name,
+            parentId: body.parentId ?? null,
+            icon: body.icon,
+            color: body.color,
+        });
+        return c.json(folder, 201);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Update folder ──────────────────────────────────────────────────────────
+libraryRoutes.patch("/folders/:id", async (c) => {
+    try {
+        const lib = store();
+        const id = c.req.param("id");
+        const body = await c.req.json();
+        const updated = await lib.updateFolder(id, body);
+        if (!updated)
+            return c.json({ error: "Folder not found or not modifiable" }, 404);
+        return c.json(updated);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Archive folder ─────────────────────────────────────────────────────────
+libraryRoutes.delete("/folders/:id", async (c) => {
+    try {
+        const lib = store();
+        const id = c.req.param("id");
+        const result = await lib.archiveFolder(id);
+        return c.json(result, result.ok ? 200 : 400);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── List files ─────────────────────────────────────────────────────────────
+libraryRoutes.get("/files", async (c) => {
+    try {
+        const fileMgr = fm();
+        const folderId = c.req.query("folderId");
+        const category = c.req.query("category");
+        const search = c.req.query("search");
+        const unfiled = c.req.query("unfiled");
+        const limit = parseInt(c.req.query("limit") ?? "50", 10);
+        const offset = parseInt(c.req.query("offset") ?? "0", 10);
+        if (unfiled === "true") {
+            // All files without a folderId
+            const all = await fileMgr.list({ category, search, limit: 1000 });
+            let results = all.filter((f) => !f.meta?.folderId);
+            const total = results.length;
+            results = results.slice(offset, offset + limit);
+            return c.json({ files: results, total });
+        }
+        const files = await fileMgr.list({ folderId: folderId ?? undefined, category, search, limit, offset });
+        return c.json({ files, total: files.length });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Upload file ────────────────────────────────────────────────────────────
+libraryRoutes.post("/files/upload", async (c) => {
+    try {
+        const fileMgr = fm();
+        const formData = await c.req.formData();
+        const file = formData.get("file");
+        if (!file)
+            return c.json({ error: "No file provided" }, 400);
+        const buffer = Buffer.from(await file.arrayBuffer());
+        const folderId = formData.get("folderId");
+        const category = formData.get("category") || "upload";
+        const tags = formData.get("tags");
+        const result = await fileMgr.upload({
+            buffer,
+            originalName: file.name,
+            mimeType: file.type || "application/octet-stream",
+            category,
+            tags: tags ? tags.split(",").map((t) => t.trim()) : [],
+            origin: "user-upload",
+        });
+        if (!result.ok || !result.file) {
+            return c.json({ error: result.message }, 400);
+        }
+        // Assign to folder via meta
+        if (folderId) {
+            await fileMgr.updateMetadata(result.file.id, {
+                meta: { folderId },
+            });
+            // Re-fetch to get updated entry
+            const updated = await fileMgr.get(result.file.id);
+            if (updated)
+                result.file = updated;
+        }
+        return c.json({ file: result.file }, 201);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── File metadata ──────────────────────────────────────────────────────────
+libraryRoutes.get("/files/:id", async (c) => {
+    try {
+        const fileMgr = fm();
+        const lib = store();
+        const id = c.req.param("id");
+        const file = await fileMgr.get(id);
+        if (!file)
+            return c.json({ error: "File not found" }, 404);
+        // Record access
+        await lib.recordAccess(id, "file");
+        // Check favorite status
+        const favorited = await lib.isFavorite(id);
+        return c.json({ file, favorited });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── File text content (for feed/preview rendering) ────────────────────────
+libraryRoutes.get("/files/:id/content", async (c) => {
+    try {
+        const fileMgr = fm();
+        const id = c.req.param("id");
+        const maxChars = parseInt(c.req.query("max") ?? "10000", 10);
+        const result = await fileMgr.read(id);
+        if (!result.ok || !result.data || !result.entry) {
+            return c.json({ error: result.message }, 404);
+        }
+        const textMimes = [
+            "text/markdown", "text/plain", "text/yaml", "text/csv",
+            "application/json", "application/x-yaml",
+        ];
+        const isText = textMimes.some((m) => result.entry.mimeType.includes(m))
+            || result.entry.name.match(/\.(md|txt|yaml|yml|json|csv|log)$/i);
+        if (!isText) {
+            return c.json({ id, content: null, reason: "binary" });
+        }
+        const full = result.data.toString("utf-8");
+        const content = full.slice(0, maxChars);
+        const truncated = full.length > maxChars;
+        return c.json({ id, content, truncated, totalChars: full.length });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Download file ──────────────────────────────────────────────────────────
+libraryRoutes.get("/files/:id/download", async (c) => {
+    try {
+        const fileMgr = fm();
+        const id = c.req.param("id");
+        const result = await fileMgr.read(id);
+        if (!result.ok || !result.data || !result.entry) {
+            return c.json({ error: result.message }, 404);
+        }
+        return new Response(result.data, {
+            headers: {
+                "Content-Type": result.entry.mimeType,
+                "Content-Disposition": `attachment; filename="${result.entry.name}"`,
+                "Content-Length": result.data.length.toString(),
+            },
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Update file metadata ───────────────────────────────────────────────────
+libraryRoutes.patch("/files/:id", async (c) => {
+    try {
+        const fileMgr = fm();
+        const id = c.req.param("id");
+        const body = await c.req.json();
+        const patch = {};
+        if (body.name)
+            patch.name = body.name;
+        if (body.tags)
+            patch.tags = body.tags;
+        if (body.category)
+            patch.category = body.category;
+        if (body.folderId !== undefined) {
+            patch.meta = { folderId: body.folderId };
+        }
+        const result = await fileMgr.updateMetadata(id, patch);
+        if (!result.ok)
+            return c.json({ error: result.message }, 404);
+        return c.json({ file: result.file });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Archive file ───────────────────────────────────────────────────────────
+libraryRoutes.delete("/files/:id", async (c) => {
+    try {
+        const fileMgr = fm();
+        const id = c.req.param("id");
+        const result = await fileMgr.archive(id, "user");
+        return c.json(result, result.ok ? 200 : 404);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Search ─────────────────────────────────────────────────────────────────
+libraryRoutes.get("/search", async (c) => {
+    try {
+        const fileMgr = fm();
+        const lib = store();
+        const q = c.req.query("q") ?? "";
+        const category = c.req.query("category");
+        const folderId = c.req.query("folderId");
+        if (!q)
+            return c.json({ files: [], folders: [] });
+        // Search files
+        const files = await fileMgr.list({
+            search: q,
+            category,
+            folderId: folderId ?? undefined,
+            limit: 50,
+        });
+        // Search folders by name
+        const allFolders = await lib.listFolders();
+        const qLower = q.toLowerCase();
+        const folders = allFolders.filter((f) => f.name.toLowerCase().includes(qLower) || f.path.toLowerCase().includes(qLower));
+        return c.json({ files, folders });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Last Used (virtual folder) ────────────────────────────────────────────
+libraryRoutes.get("/last-used", async (c) => {
+    try {
+        const lib = store();
+        const fileMgr = fm();
+        const limit = parseInt(c.req.query("limit") ?? "30", 10);
+        const recents = await lib.getRecents(limit * 2); // over-fetch to handle missing files
+        // Hydrate file entries, skip folders and missing files
+        const files = [];
+        const seen = new Set();
+        for (const r of recents) {
+            if (r.targetType !== "file")
+                continue;
+            if (seen.has(r.targetId))
+                continue;
+            seen.add(r.targetId);
+            const file = await fileMgr.get(r.targetId);
+            if (file && file.status !== "archived") {
+                files.push({ ...file, _lastAccessed: r.timestamp });
+            }
+            if (files.length >= limit)
+                break;
+        }
+        return c.json({ files, total: files.length });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Recents ────────────────────────────────────────────────────────────────
+libraryRoutes.get("/recents", async (c) => {
+    try {
+        const lib = store();
+        const files = fm();
+        const limit = parseInt(c.req.query("limit") ?? "20", 10);
+        const recents = await lib.getRecents(limit);
+        // Resolve names so the UI doesn't have to show raw IDs
+        const enriched = await Promise.all(recents.map(async (r) => {
+            let name = null;
+            if (r.targetType === "folder") {
+                const folder = await lib.getFolder(r.targetId);
+                name = folder?.name ?? null;
+            }
+            else {
+                const file = await files.get(r.targetId);
+                name = file?.name ?? null;
+            }
+            return { ...r, name };
+        }));
+        // Filter out entries whose target no longer exists
+        return c.json({ recents: enriched.filter((r) => r.name !== null) });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Favorites ──────────────────────────────────────────────────────────────
+libraryRoutes.get("/favorites", async (c) => {
+    try {
+        const lib = store();
+        const favorites = await lib.getFavorites();
+        return c.json({ favorites });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+libraryRoutes.post("/favorites/:id", async (c) => {
+    try {
+        const lib = store();
+        const id = c.req.param("id");
+        const body = await c.req.json();
+        const targetType = body.type === "folder" ? "folder" : "file";
+        const result = await lib.toggleFavorite(id, targetType);
+        return c.json(result);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+// ── Stats ──────────────────────────────────────────────────────────────────
+libraryRoutes.get("/stats", async (c) => {
+    try {
+        const fileMgr = fm();
+        const lib = store();
+        const usage = await fileMgr.getStats();
+        const allFiles = await fileMgr.list({ limit: 10000 });
+        // Files per folder
+        const byFolder = new Map();
+        let unfiledCount = 0;
+        let unfiledBytes = 0;
+        for (const f of allFiles) {
+            const fid = f.meta?.folderId;
+            if (fid) {
+                const current = byFolder.get(fid) ?? { count: 0, bytes: 0 };
+                current.count++;
+                current.bytes += f.sizeBytes;
+                byFolder.set(fid, current);
+            }
+            else {
+                unfiledCount++;
+                unfiledBytes += f.sizeBytes;
+            }
+        }
+        // Resolve folder names
+        const folderStats = [];
+        for (const [fid, stats] of byFolder) {
+            const folder = await lib.getFolder(fid);
+            folderStats.push({
+                folderId: fid,
+                name: folder?.name ?? "Unknown",
+                ...stats,
+            });
+        }
+        return c.json({
+            total: usage,
+            byFolder: folderStats,
+            unfiled: { count: unfiledCount, bytes: unfiledBytes },
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return c.json({ error: msg }, 500);
+    }
+});
+//# sourceMappingURL=routes.js.map