veryfront 0.1.49 → 0.1.51

package/esm/src/embedding/veryfront-cloud/rag-store.js

@@ -0,0 +1,360 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { readDir, readTextFile } from "../../platform/compat/fs.js";
+import { extname, join } from "../../platform/compat/path/basic-operations.js";
+import { getCurrentRequestContext } from "../../platform/adapters/fs/veryfront/multi-project-adapter.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
+import { serverLogger } from "../../utils/index.js";
+import { createVeryfrontCloudFetch, requireVeryfrontCloudBootstrap, } from "../../provider/veryfront-cloud/shared.js";
+import { chunk } from "../chunk.js";
+import { embedding } from "../embedding.js";
+const DEFAULT_TOP_K = 5;
+const MAX_TEXT_LENGTH = 5 * 1024 * 1024; // 5 MB text limit per document
+const MAX_API_CHUNK_BATCH = 500;
+const MAX_API_EMBEDDING_BATCH = 100;
+const MAX_SEARCH_LIMIT = 100;
+const SEARCH_OVERSCAN = 25;
+const DOCUMENTS_DIR = ".veryfront/rag/documents";
+function buildUrl(base, path) {
+    return `${base.replace(/\/+$/, "")}/${path.replace(/^\/+/, "")}`;
+}
+function estimateTokenCount(text) {
+    return Math.max(1, Math.ceil(text.length / 4));
+}
+function toSupportedDimension(length) {
+    switch (length) {
+        case 768:
+        case 1024:
+        case 1536:
+        case 3072:
+        case 4096:
+            return length;
+        default:
+            throw INVALID_ARGUMENT.create({
+                detail: `Unsupported embedding dimension ${length}. Expected one of 768, 1024, 1536, 3072, 4096.`,
+            });
+    }
+}
+function normalizeEmbeddingModelDescriptor(model, dimension) {
+    const normalized = model.startsWith("veryfront-cloud/")
+        ? model.slice("veryfront-cloud/".length)
+        : model;
+    const slashIndex = normalized.indexOf("/");
+    if (slashIndex === -1) {
+        return {
+            name: normalized,
+            provider: "unknown",
+            dimension,
+        };
+    }
+    return {
+        provider: normalized.slice(0, slashIndex),
+        name: normalized.slice(slashIndex + 1),
+        dimension,
+    };
+}
+function buildDocumentFilePath(documentId, type) {
+    const extension = type?.trim().toLowerCase().replace(/[^a-z0-9]+/g, "");
+    return `${DOCUMENTS_DIR}/${documentId}.${extension || "txt"}`;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function toStringValue(value, fallback = "") {
+    return typeof value === "string" ? value : fallback;
+}
+function buildDocumentChunks(sourceText, chunkTexts, metadata) {
+    let searchStart = 0;
+    return chunkTexts.map((content, index) => {
+        const foundAt = sourceText.indexOf(content, searchStart);
+        const startOffset = foundAt >= 0 ? foundAt : searchStart;
+        const endOffset = startOffset + content.length;
+        searchStart = Math.max(startOffset + 1, endOffset);
+        return {
+            chunk_index: index,
+            content,
+            start_offset: startOffset,
+            end_offset: endOffset,
+            token_count: estimateTokenCount(content),
+            metadata,
+        };
+    });
+}
+async function requestJson(context, path, init, options) {
+    const request = new dntShim.Request(buildUrl(context.apiBaseUrl, path), init);
+    const headers = new dntShim.Headers(request.headers);
+    if (!headers.has("Content-Type") && request.method !== "GET" && request.method !== "HEAD") {
+        headers.set("Content-Type", "application/json");
+    }
+    const response = await context.fetch(new dntShim.Request(request, { headers }));
+    if (options?.allowNotFound && response.status === 404) {
+        return null;
+    }
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw INVALID_ARGUMENT.create({
+            detail: `Veryfront Cloud RAG request failed (${response.status} ${response.statusText}): ${body || path}`,
+        });
+    }
+    if (response.status === 204) {
+        return null;
+    }
+    return await response.json();
+}
+function getCloudStoreContext(config) {
+    const bootstrap = requireVeryfrontCloudBootstrap();
+    if (!bootstrap.projectSlug) {
+        throw INVALID_ARGUMENT.create({
+            detail: "VERYFRONT_PROJECT_SLUG not set. Set the environment variable or runtime projectSlug before using the veryfront-cloud RAG store.",
+        });
+    }
+    return {
+        apiBaseUrl: bootstrap.apiBaseUrl,
+        fetch: createVeryfrontCloudFetch(bootstrap.apiToken),
+        projectSlug: bootstrap.projectSlug,
+        branch: config.branch ?? getCurrentRequestContext()?.branch ?? "main",
+    };
+}
+function getFileChunksPath(context, filePath) {
+    return `/projects/${encodeURIComponent(context.projectSlug)}/branches/${encodeURIComponent(context.branch)}/files/${encodeURIComponent(filePath)}/chunks`;
+}
+function getSearchPath(context) {
+    return `/projects/${encodeURIComponent(context.projectSlug)}/branches/${encodeURIComponent(context.branch)}/search`;
+}
+function getEmbeddingsPath(context) {
+    return `/projects/${encodeURIComponent(context.projectSlug)}/embeddings`;
+}
+function getRagDocumentsPath(context) {
+    return `/projects/${encodeURIComponent(context.projectSlug)}/rag/documents`;
+}
+async function deleteFileChunks(context, filePath) {
+    await requestJson(context, getFileChunksPath(context, filePath), { method: "DELETE" }, { allowNotFound: true });
+}
+async function upsertFileChunks(context, filePath, chunks) {
+    if (chunks.length === 0) {
+        return [];
+    }
+    const results = [];
+    for (let i = 0; i < chunks.length; i += MAX_API_CHUNK_BATCH) {
+        const batch = chunks.slice(i, i + MAX_API_CHUNK_BATCH);
+        const response = await requestJson(context, getFileChunksPath(context, filePath), {
+            method: "POST",
+            body: JSON.stringify({ chunks: batch }),
+        });
+        if (response) {
+            results.push(...response.chunks);
+        }
+    }
+    results.sort((a, b) => a.index - b.index);
+    return results;
+}
+async function upsertEmbeddings(context, chunkIds, vectors, model) {
+    for (let i = 0; i < chunkIds.length; i += MAX_API_EMBEDDING_BATCH) {
+        const batchChunkIds = chunkIds.slice(i, i + MAX_API_EMBEDDING_BATCH);
+        const batchVectors = vectors.slice(i, i + MAX_API_EMBEDDING_BATCH);
+        await requestJson(context, getEmbeddingsPath(context), {
+            method: "POST",
+            body: JSON.stringify({
+                chunk_ids: batchChunkIds,
+                vectors: batchVectors,
+                model,
+            }),
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Server-side RAG document management
+// ---------------------------------------------------------------------------
+async function listRagDocuments(context) {
+    const response = await requestJson(context, getRagDocumentsPath(context));
+    return (response?.documents ?? []).map((doc) => ({
+        id: doc.id,
+        title: doc.title,
+        source: doc.source,
+        type: doc.type,
+        createdAt: new Date(doc.created_at).getTime(),
+    }));
+}
+async function upsertRagDocument(context, document) {
+    await requestJson(context, getRagDocumentsPath(context), {
+        method: "POST",
+        body: JSON.stringify({
+            id: document.id,
+            title: document.title,
+            source: document.source ?? "",
+            type: document.type ?? "",
+            metadata: document.metadata,
+        }),
+    });
+}
+async function deleteRagDocument(context, documentId) {
+    await requestJson(context, `${getRagDocumentsPath(context)}/${encodeURIComponent(documentId)}`, { method: "DELETE" }, { allowNotFound: true });
+}
+// ---------------------------------------------------------------------------
+// Document ingestion (chunks + embeddings + server-side record)
+// ---------------------------------------------------------------------------
+async function ingestDocument(context, config, title, text, meta) {
+    if (text.length > MAX_TEXT_LENGTH) {
+        throw INVALID_ARGUMENT.create({
+            detail: `Upload text exceeds ${MAX_TEXT_LENGTH / 1024 / 1024} MB limit`,
+        });
+    }
+    const chunkTexts = await chunk(text, config.chunkOptions);
+    if (chunkTexts.length === 0) {
+        throw INVALID_ARGUMENT.create({ detail: "Upload contains no extractable text" });
+    }
+    const documentId = dntShim.crypto.randomUUID();
+    const filePath = buildDocumentFilePath(documentId, meta?.type);
+    const embedder = createEmbedder(config);
+    const vectors = await embedder.embedMany(chunkTexts);
+    const dimension = toSupportedDimension(vectors[0]?.length ?? 0);
+    const chunkInputs = buildDocumentChunks(text, chunkTexts, {
+        kind: "rag-document",
+        document_id: documentId,
+        title,
+        source: meta?.source ?? "",
+        type: meta?.type ?? "",
+    });
+    try {
+        const createdChunks = await upsertFileChunks(context, filePath, chunkInputs);
+        const chunkIds = createdChunks.map((entry) => entry.id);
+        if (chunkIds.length !== vectors.length) {
+            throw INVALID_ARGUMENT.create({
+                detail: `Expected ${vectors.length} chunk IDs from Veryfront Cloud, received ${chunkIds.length}.`,
+            });
+        }
+        await upsertEmbeddings(context, chunkIds, vectors, normalizeEmbeddingModelDescriptor(config.model, dimension));
+    }
+    catch (error) {
+        await deleteFileChunks(context, filePath).catch(() => undefined);
+        throw error;
+    }
+    // Record document in server-side store (atomic, no client-side manifest needed)
+    await upsertRagDocument(context, {
+        id: documentId,
+        title,
+        source: meta?.source ?? "",
+        type: meta?.type ?? "",
+        metadata: { filePath },
+    });
+    return documentId;
+}
+function createEmbedder(config) {
+    return embedding({
+        model: config.model,
+        documentPrefix: config.documentPrefix,
+        queryPrefix: config.queryPrefix,
+        batchSize: config.batchSize,
+    });
+}
+async function listContentFiles(contentDir, contentExtensions) {
+    const files = [];
+    try {
+        for await (const entry of readDir(contentDir)) {
+            const fullPath = join(contentDir, entry.name);
+            if (entry.isDirectory) {
+                files.push(...(await listContentFiles(fullPath, contentExtensions)));
+            }
+            else if (entry.isFile && contentExtensions.has(extname(entry.name))) {
+                files.push(fullPath);
+            }
+        }
+    }
+    catch (_) {
+        // expected: directory may not exist yet
+    }
+    return files;
+}
+export function createVeryfrontCloudRagStore(config) {
+    const contentDir = config.contentDir;
+    const contentExtensions = new Set(config.contentExtensions ?? [".md", ".mdx", ".txt"]);
+    return {
+        async ingest(title, text, meta) {
+            const context = getCloudStoreContext(config);
+            return ingestDocument(context, config, title, text, meta);
+        },
+        async search(query, options) {
+            const context = getCloudStoreContext(config);
+            const queryEmbedder = createEmbedder(config);
+            const vector = await queryEmbedder.embed(query);
+            const topK = options?.topK ?? DEFAULT_TOP_K;
+            const limit = Math.min(MAX_SEARCH_LIMIT, topK + SEARCH_OVERSCAN);
+            const dimension = toSupportedDimension(vector.length);
+            const response = await requestJson(context, getSearchPath(context), {
+                method: "POST",
+                body: JSON.stringify({
+                    vector,
+                    dimension,
+                    limit,
+                    threshold: options?.threshold ?? 0,
+                }),
+            });
+            const results = (response?.data ?? [])
+                .filter((result) => result.chunk.metadata?.kind !== "rag-manifest" &&
+                result.chunk.metadata?.kind !== "rag-manifest-padding")
+                .map((result) => {
+                const metadata = isRecord(result.chunk.metadata) ? result.chunk.metadata : {};
+                return {
+                    text: result.chunk.content,
+                    score: result.score,
+                    documentId: toStringValue(metadata.document_id, result.chunk.file_path),
+                    title: toStringValue(metadata.title, "Unknown"),
+                    source: toStringValue(metadata.source, result.chunk.file_path),
+                    type: toStringValue(metadata.type, ""),
+                };
+            });
+            return results.slice(0, topK);
+        },
+        async listDocuments() {
+            const context = getCloudStoreContext(config);
+            return listRagDocuments(context);
+        },
+        async removeDocument(id) {
+            const context = getCloudStoreContext(config);
+            // Fetch document metadata to find its filePath for chunk cleanup
+            const documents = await listRagDocuments(context);
+            const target = documents.find((doc) => doc.id === id);
+            // Delete server-side document record first (authoritative)
+            await deleteRagDocument(context, id);
+            // Best-effort cleanup of file chunks
+            if (target) {
+                const filePath = buildDocumentFilePath(id, target.type);
+                try {
+                    await deleteFileChunks(context, filePath);
+                }
+                catch (error) {
+                    serverLogger.warn("[rag-store/cloud] Failed to clean up file chunks for document", {
+                        id,
+                        filePath,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+        },
+        async indexContentDir() {
+            if (!contentDir)
+                return;
+            const context = getCloudStoreContext(config);
+            const existingDocuments = await listRagDocuments(context);
+            const indexedSources = new Set(existingDocuments.map((doc) => doc.source));
+            const files = await listContentFiles(contentDir, contentExtensions);
+            const newFiles = files.filter((file) => !indexedSources.has(file));
+            for (const file of newFiles) {
+                const content = await readTextFile(file);
+                if (!content?.trim())
+                    continue;
+                if (content.length > MAX_TEXT_LENGTH) {
+                    serverLogger.warn(`[rag-store/cloud] Skipping ${file}: exceeds ${MAX_TEXT_LENGTH / 1024 / 1024} MB text limit`);
+                    continue;
+                }
+                const title = file.startsWith(contentDir + "/")
+                    ? file.slice(contentDir.length + 1).replace(/\.[^.]+$/, "")
+                    : file.replace(/\.[^.]+$/, "");
+                const type = extname(file).slice(1);
+                await ingestDocument(context, config, title, content, {
+                    source: file,
+                    type,
+                });
+            }
+        },
+    };
+}

package/esm/src/errors/catalog/general-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"general-errors.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/catalog/general-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD,eAAO,MAAM,qBAAqB,EAAE,mBAwDnC,CAAC"}
+{"version":3,"file":"general-errors.d.ts","sourceRoot":"","sources":["../../../../src/src/errors/catalog/general-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD,eAAO,MAAM,qBAAqB,EAAE,mBAmEnC,CAAC"}

package/esm/src/errors/catalog/general-errors.js

@@ -16,6 +16,11 @@ export const GENERAL_ERROR_CATALOG = {
         "Verify file exists in project",
         "Check for typos in file name",
     ]),
+    "resource-not-found": createSimpleError("resource-not-found", "Resource not found", "The requested resource does not exist.", [
+        "Verify the referenced workflow, run, approval, or tool ID",
+        "Check for typos in the resource name",
+        "Confirm the resource has not been deleted",
+    ]),
     "invalid-argument": createSimpleError("invalid-argument", "Invalid argument", "Command received invalid argument.", [
         "Check command syntax",
         "Verify argument values",

package/esm/src/errors/error-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-context.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-context.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAKjF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,uCAAuC;IACvC,QAAQ,EAAE,CAAC,CAAC;IACZ,mCAAmC;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAuCD,8DAA8D;AAC9D,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,6DAA6D;AAC7D,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,SAAS,EAAE,MAAM,CAAC,EAClB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,CAAC,CAOH;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAC1B,OAAO,EAAE;IAAE,EAAE,EAAE;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,MAAM,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAA;CAAE,EAC/F,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAM3D;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAC1B,OAAO,EAAE;IAAE,EAAE,EAAE;QAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,EAChE,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED,uCAAuC;AACvC,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE;IAAE,EAAE,EAAE;QAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,CAAA;KAAE,CAAA;CAAE,EAChE,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,EAAE,CAAC,CASd;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG;IACzD,GAAG,CAAC,CAAC,EACH,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EACxC,QAAQ,EAAE,CAAC,EACX,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,OAAO,CAAC,CAAC,EACP,SAAS,EAAE,MAAM,CAAC,EAClB,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EACxC,QAAQ,EAAE,CAAC,EACX,QAAQ,CAAC,EAAE,QAAQ,GAClB,CAAC,CAAC;CACN,CAwBA"}
+{"version":3,"file":"error-context.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-context.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAQjF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,uCAAuC;IACvC,QAAQ,EAAE,CAAC,CAAC;IACZ,mCAAmC;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAuCD,8DAA8D;AAC9D,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,6DAA6D;AAC7D,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,SAAS,EAAE,MAAM,CAAC,EAClB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,CAAC,CAOH;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAC1B,OAAO,EAAE;IAAE,EAAE,EAAE;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;YAAE,MAAM,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,OAAO,CAAA;SAAE,CAAC,CAAA;KAAE,CAAA;CAAE,EAC/F,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAM3D;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAC1B,OAAO,EAAE;IAAE,EAAE,EAAE;QAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,EAChE,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED,uCAAuC;AACvC,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE;IAAE,EAAE,EAAE;QAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,CAAA;KAAE,CAAA;CAAE,EAChE,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,EAAE,CAAC,CASd;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG;IACzD,GAAG,CAAC,CAAC,EACH,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EACxC,QAAQ,EAAE,CAAC,EACX,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,OAAO,CAAC,CAAC,EACP,SAAS,EAAE,MAAM,CAAC,EAClB,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EACxC,QAAQ,EAAE,CAAC,EACX,QAAQ,CAAC,EAAE,QAAQ,GAClB,CAAC,CAAC;CACN,CAwBA"}

package/esm/src/errors/error-context.js

@@ -1,4 +1,7 @@
 /******** Structured error handling with logging for silent failure operations */
+// NOTE: serverLogger is imported but only accessed inside function bodies (never at
+// module-eval time). This is safe even with circular deps because by the time any
+// function in this module is called, all modules have finished initializing.
 import { serverLogger } from "../utils/logger/logger.js";
 import { getErrorMessage } from "./veryfront-error.js";
 function getErrorStack(error) {

package/esm/src/errors/error-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handlers.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAoBzD,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,CAAC,EACX,MAAM,GAAE,OAAO,YAA2B,GACzC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,EAAE,EAAE,MAAM,CAAC,EACX,QAAQ,EAAE,CAAC,EACX,MAAM,GAAE,OAAO,YAA2B,GACzC,CAAC,CAOH;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,YAAY,CAAC;CACzB,GACL,OAAO,CAAC,CAAC,CAAC,CA4BZ"}
+{"version":3,"file":"error-handlers.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAoBzD,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,CAAC,EACX,MAAM,GAAE,OAAO,YAA2B,GACzC,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,EAAE,EAAE,MAAM,CAAC,EACX,QAAQ,EAAE,CAAC,EACX,MAAM,GAAE,OAAO,YAA2B,GACzC,CAAC,CAOH;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,YAAY,CAAC;CACzB,GACL,OAAO,CAAC,CAAC,CAAC,CA6BZ"}

package/esm/src/errors/error-handlers.js

@@ -10,8 +10,8 @@ function safeLog(logFn) {
         try {
             logger.warn("Logging failed:", error);
         }
-        catch {
-            // Silently ignore if even warning fails
+        catch (_) {
+            // expected: last-resort fallback; nothing left to do if logging itself fails
         }
     }
 }
@@ -47,6 +47,7 @@ export async function retryWithBackoff(fn, options = {}) {
             if (attempt >= maxRetries - 1) {
                 continue;
             }
+            // no cleanup needed: one-shot
             await new Promise((resolve) => dntShim.setTimeout(resolve, delay));
             delay = Math.min(delay * 2, maxDelay);
         }

package/esm/src/errors/error-registry.d.ts

@@ -77,6 +77,7 @@ export declare const ORCHESTRATION_ERROR: import("./types.js").RegisteredError;
 export declare const UNKNOWN_ERROR: import("./types.js").RegisteredError;
 export declare const PERMISSION_DENIED: import("./types.js").RegisteredError;
 export declare const FILE_NOT_FOUND: import("./types.js").RegisteredError;
+export declare const RESOURCE_NOT_FOUND: import("./types.js").RegisteredError;
 export declare const INVALID_ARGUMENT: import("./types.js").RegisteredError;
 export declare const TIMEOUT_ERROR: import("./types.js").RegisteredError;
 export declare const INITIALIZATION_ERROR: import("./types.js").RegisteredError;
@@ -160,6 +161,7 @@ export declare const ERROR_REGISTRY: {
     readonly "unknown-error": import("./types.js").RegisteredError;
     readonly "permission-denied": import("./types.js").RegisteredError;
     readonly "file-not-found": import("./types.js").RegisteredError;
+    readonly "resource-not-found": import("./types.js").RegisteredError;
     readonly "invalid-argument": import("./types.js").RegisteredError;
     readonly "timeout-error": import("./types.js").RegisteredError;
     readonly "initialization-error": import("./types.js").RegisteredError;

package/esm/src/errors/error-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-registry.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error-registry.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-registry.ts"],"names":[],"mappings":"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"}

package/esm/src/errors/error-registry.js

@@ -536,6 +536,13 @@ export const FILE_NOT_FOUND = defineError({
     title: "File not found",
     suggestion: "Verify the file path exists",
 });
+export const RESOURCE_NOT_FOUND = defineError({
+    slug: "resource-not-found",
+    category: "GENERAL",
+    status: 404,
+    title: "Requested resource not found",
+    suggestion: "Verify the referenced resource ID or name exists",
+});
 export const INVALID_ARGUMENT = defineError({
     slug: "invalid-argument",
     category: "GENERAL",
@@ -669,6 +676,7 @@ export const ERROR_REGISTRY = {
     "unknown-error": UNKNOWN_ERROR,
     "permission-denied": PERMISSION_DENIED,
     "file-not-found": FILE_NOT_FOUND,
+    "resource-not-found": RESOURCE_NOT_FOUND,
     "invalid-argument": INVALID_ARGUMENT,
     "timeout-error": TIMEOUT_ERROR,
     "initialization-error": INITIALIZATION_ERROR,

package/esm/src/errors/index.d.ts

@@ -6,7 +6,7 @@
  */
 export { defineError, VeryfrontError } from "./types.js";
 export type { ErrorCategory, ErrorCreateOptions, ErrorDefinition, RegisteredError, RFC9457Response, VeryfrontErrorOptions, } from "./types.js";
-export { AGENT_ERROR, AGENT_INTENT_ERROR, AGENT_NOT_FOUND, AGENT_TIMEOUT, API_CLIENT_ERROR, API_ERROR, API_ROUTE_ERROR, ASSET_OPTIMIZATION_ERROR, BUILD_FAILED, BUNDLE_ERROR, CACHE_ERROR, CACHE_INVARIANT_VIOLATION, CACHE_PATH_MISMATCH, CIRCULAR_DEPENDENCY, CLIENT_BOUNDARY_VIOLATION, CLIENT_ONLY_IN_SERVER, COMPILATION_ERROR, COMPONENT_ERROR, CONFIG_INVALID, CONFIG_NOT_FOUND, CONFIG_PARSE_ERROR, CONFIG_TYPE_ERROR, CONFIG_VALIDATION_ERROR, CONFIG_VALIDATION_FAILED, CORS_CONFIG_INVALID, DEPENDENCY_MISSING, DEPLOYMENT_ERROR, DEV_SERVER_ERROR, DYNAMIC_ROUTE_ERROR, ENV_VAR_MISSING, ERROR_OVERLAY_ERROR, ERROR_REGISTRY, type ErrorSlug, FALLBACK_EXHAUSTED, FAST_REFRESH_ERROR, FILE_NOT_FOUND, FILE_WATCH_ERROR, getAllSlugs, getErrorBySlug, getErrorsByCategory, HMR_ERROR, HYDRATION_MISMATCH, IMPORT_MAP_INVALID, IMPORT_RESOLUTION_ERROR, INITIALIZATION_ERROR, INPUT_VALIDATION_FAILED, INVALID_ARGUMENT, INVALID_IMPORT, INVALID_ROUTE_FILE, INVALID_USE_CLIENT, INVALID_USE_SERVER, LAYOUT_NOT_FOUND, MDX_COMPILE_ERROR, MIDDLEWARE_ERROR, MODULE_NOT_FOUND, NETWORK_ERROR, NOT_SUPPORTED, ORCHESTRATION_ERROR, PAGE_NOT_FOUND, PERMISSION_DENIED, PLATFORM_ERROR, PORT_IN_USE, PRODUCTION_BUILD_REQUIRED, RELEASE_NOT_FOUND, RENDER_ERROR, REQUEST_ERROR, ROUTE_CONFLICT, ROUTE_HANDLER_INVALID, ROUTE_PARAMS_ERROR, RSC_PAYLOAD_ERROR, SECURITY_VIOLATION, SERVER_ONLY_IN_CLIENT, SERVER_START_ERROR, SERVICE_OVERLOADED, SOURCE_MAP_ERROR, SOURCEMAP_ERROR, SSG_GENERATION_ERROR, TIMEOUT_ERROR, TOKEN_STORAGE_ERROR, TYPESCRIPT_ERROR, UNKNOWN_ERROR, VERSION_MISMATCH, } from "./error-registry.js";
+export { AGENT_ERROR, AGENT_INTENT_ERROR, AGENT_NOT_FOUND, AGENT_TIMEOUT, API_CLIENT_ERROR, API_ERROR, API_ROUTE_ERROR, ASSET_OPTIMIZATION_ERROR, BUILD_FAILED, BUNDLE_ERROR, CACHE_ERROR, CACHE_INVARIANT_VIOLATION, CACHE_PATH_MISMATCH, CIRCULAR_DEPENDENCY, CLIENT_BOUNDARY_VIOLATION, CLIENT_ONLY_IN_SERVER, COMPILATION_ERROR, COMPONENT_ERROR, CONFIG_INVALID, CONFIG_NOT_FOUND, CONFIG_PARSE_ERROR, CONFIG_TYPE_ERROR, CONFIG_VALIDATION_ERROR, CONFIG_VALIDATION_FAILED, CORS_CONFIG_INVALID, DEPENDENCY_MISSING, DEPLOYMENT_ERROR, DEV_SERVER_ERROR, DYNAMIC_ROUTE_ERROR, ENV_VAR_MISSING, ERROR_OVERLAY_ERROR, ERROR_REGISTRY, type ErrorSlug, FALLBACK_EXHAUSTED, FAST_REFRESH_ERROR, FILE_NOT_FOUND, FILE_WATCH_ERROR, getAllSlugs, getErrorBySlug, getErrorsByCategory, HMR_ERROR, HYDRATION_MISMATCH, IMPORT_MAP_INVALID, IMPORT_RESOLUTION_ERROR, INITIALIZATION_ERROR, INPUT_VALIDATION_FAILED, INVALID_ARGUMENT, INVALID_IMPORT, INVALID_ROUTE_FILE, INVALID_USE_CLIENT, INVALID_USE_SERVER, LAYOUT_NOT_FOUND, MDX_COMPILE_ERROR, MIDDLEWARE_ERROR, MODULE_NOT_FOUND, NETWORK_ERROR, NOT_SUPPORTED, ORCHESTRATION_ERROR, PAGE_NOT_FOUND, PERMISSION_DENIED, PLATFORM_ERROR, PORT_IN_USE, PRODUCTION_BUILD_REQUIRED, RELEASE_NOT_FOUND, RENDER_ERROR, REQUEST_ERROR, RESOURCE_NOT_FOUND, ROUTE_CONFLICT, ROUTE_HANDLER_INVALID, ROUTE_PARAMS_ERROR, RSC_PAYLOAD_ERROR, SECURITY_VIOLATION, SERVER_ONLY_IN_CLIENT, SERVER_START_ERROR, SERVICE_OVERLOADED, SOURCE_MAP_ERROR, SOURCEMAP_ERROR, SSG_GENERATION_ERROR, TIMEOUT_ERROR, TOKEN_STORAGE_ERROR, TYPESCRIPT_ERROR, UNKNOWN_ERROR, VERSION_MISMATCH, } from "./error-registry.js";
 export { createErrorHandler, createErrorResponse, createErrorResponseFromDefinition, createProblemResponse, errorToResponse, formatErrorLog, isVeryfrontError, PROBLEM_JSON_CONTENT_TYPE, } from "./http-error.js";
 export { cliErrorBoundary, cliErrorBoundarySync, errorToRFC9457Response, formatCLIError, httpErrorBoundary, wrapHandlerWithErrorBoundary, wrapUnknownError, wrapWithContext, } from "./middleware/index.js";
 export { logError, logErrorWithMessage } from "./logging.js";

package/esm/src/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/errors/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/errors/index.ts"],"names":[],"mappings":"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"}

package/esm/src/errors/index.js

@@ -26,7 +26,7 @@ HYDRATION_MISMATCH, IMPORT_MAP_INVALID, IMPORT_RESOLUTION_ERROR, INITIALIZATION_
 // MODULE
 MODULE_NOT_FOUND, NETWORK_ERROR, NOT_SUPPORTED, ORCHESTRATION_ERROR, PAGE_NOT_FOUND, PERMISSION_DENIED, PLATFORM_ERROR, 
 // SERVER
-PORT_IN_USE, PRODUCTION_BUILD_REQUIRED, RELEASE_NOT_FOUND, RENDER_ERROR, REQUEST_ERROR, 
+PORT_IN_USE, PRODUCTION_BUILD_REQUIRED, RELEASE_NOT_FOUND, RENDER_ERROR, REQUEST_ERROR, RESOURCE_NOT_FOUND, 
 // ROUTE
 ROUTE_CONFLICT, ROUTE_HANDLER_INVALID, ROUTE_PARAMS_ERROR, RSC_PAYLOAD_ERROR, SECURITY_VIOLATION, SERVER_ONLY_IN_CLIENT, SERVER_START_ERROR, SERVICE_OVERLOADED, SOURCE_MAP_ERROR, SOURCEMAP_ERROR, SSG_GENERATION_ERROR, TIMEOUT_ERROR, TOKEN_STORAGE_ERROR, TYPESCRIPT_ERROR, 
 // GENERAL

package/esm/src/errors/logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/src/errors/logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAoCN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAMN"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/src/errors/logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAqCN;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAMN"}

package/esm/src/errors/logging.js

@@ -5,6 +5,7 @@
  * fields for metrics/tracing integration, and environment-aware formatting.
  */
 import { isProduction } from "../build/config/environment.js";
+import { serverLogger } from "../utils/logger/logger.js";
 /**
  * Log a VeryfrontError with structured formatting
  *
@@ -30,24 +31,25 @@ export function logError(error, context) {
             : error.context,
     };
     if (isProduction()) {
-        // Structured JSON for log aggregation systems
+        // Direct JSON output — this module owns its own structured format
+        // (slug, category, status, docs) which differs from the logger envelope.
         console.error(JSON.stringify(entry));
     }
     else {
         // Human-readable format for development
-        console.error(`[ERROR] ${error.slug} (${error.category}) — ${error.title}`);
+        serverLogger.error(`[ERROR] ${error.slug} (${error.category}) — ${error.title}`);
         if (error.detail) {
-            console.error(`  Detail: ${error.detail}`);
+            serverLogger.error(`  Detail: ${error.detail}`);
         }
         if (error.suggestion) {
-            console.error(`  💡 Suggestion: ${error.suggestion}`);
+            serverLogger.error(`  💡 Suggestion: ${error.suggestion}`);
         }
-        console.error(`  📚 Docs: ${entry.docs}`);
+        serverLogger.error(`  📚 Docs: ${entry.docs}`);
         const mergedContext = context
             ? { ...(error.context ?? {}), ...context }
             : error.context;
         if (mergedContext) {
-            console.error(`  Context: ${JSON.stringify(mergedContext, null, 2)}`);
+            serverLogger.error(`  Context: ${JSON.stringify(mergedContext, null, 2)}`);
         }
     }
 }

package/esm/src/errors/types.d.ts

@@ -29,6 +29,8 @@ export interface ErrorDefinition {
  * Options for creating an error instance
  */
 export interface ErrorCreateOptions {
+    /** Override the error message (defaults to detail or definition title) */
+    message?: string;
     detail?: string;
     cause?: unknown;
     instance?: string;

package/esm/src/errors/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/errors/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,KAAK,GACL,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAAC;CACtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,eAAe,GAAG,eAAe,CAiBxE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEN,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB;IAe3D;;OAEG;IACH,SAAS,IAAI,eAAe;IAa5B;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/errors/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,KAAK,GACL,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,MAAM,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAAC;CACtD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,eAAe,GAAG,eAAe,CAiBxE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEN,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB;IAe3D;;OAEG;IACH,SAAS,IAAI,eAAe;IAa5B;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB"}

package/esm/src/errors/types.js

@@ -5,7 +5,7 @@ export function defineError(definition) {
     return {
         ...definition,
         create(options) {
-            return new VeryfrontError(options?.detail || definition.title, {
+            return new VeryfrontError(options?.message || options?.detail || definition.title, {
                 slug: definition.slug,
                 category: definition.category,
                 status: options?.status ?? definition.status,

package/esm/src/errors/veryfront-error.d.ts

@@ -45,7 +45,7 @@ export interface FileContext {
     operation?: "read" | "write" | "delete" | "mkdir";
     permissions?: string;
 }
-export interface NetworkContext {
+interface NetworkContext {
     url?: string;
     timeout?: number;
     retryCount?: number;
@@ -117,11 +117,6 @@ export declare const isConfigError: (error: VeryfrontErrorData) => error is {
     message: string;
     context?: ConfigContext;
 };
-export declare const isAgentError: (error: VeryfrontErrorData) => error is {
-    type: "agent";
-    message: string;
-    context?: AgentContext;
-};
 export declare const isFileError: (error: VeryfrontErrorData) => error is {
     type: "file";
     message: string;
@@ -150,4 +145,5 @@ export declare function getErrorMessage(error: unknown): string;
  * Ensure error is an Error instance
  */
 export declare function ensureError(error: unknown): Error;
+export {};
 //# sourceMappingURL=veryfront-error.d.ts.map