veryfront 0.1.216 → 0.1.217

package/esm/src/agent/runtime/index.js

@@ -59,6 +59,42 @@ function getSkillActivationRequiredError(toolName) {
     return `Tool "${toolName}" cannot run before load-skill succeeds in the same step. ` +
         `Call "${LOAD_SKILL_TOOL_ID}" first to establish the active skill context.`;
 }
+function warnLocalToolSkipping(agentId, modelId) {
+    logger.warn(`Agent "${agentId}" has tools configured but is using local model "${modelId}". ` +
+        "Local models don't support tool calling — tools will be skipped. " +
+        "Set VERYFRONT_API_TOKEN and VERYFRONT_PROJECT_SLUG, or configure " +
+        "OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY for full tool support.");
+}
+function createToolResultMessage(toolCallId, toolName, result) {
+    return {
+        id: `tool_${toolCallId}`,
+        role: "tool",
+        parts: [
+            {
+                type: "tool-result",
+                toolCallId,
+                toolName,
+                result,
+            },
+        ],
+        timestamp: Date.now(),
+    };
+}
+function createToolErrorMessage(toolCallId, toolName, error) {
+    return {
+        id: `tool_error_${toolCallId}`,
+        role: "tool",
+        parts: [
+            {
+                type: "tool-result",
+                toolCallId,
+                toolName,
+                result: { error },
+            },
+        ],
+        timestamp: Date.now(),
+    };
+}
 export function collectFinalStreamToolResults(state) {
     const finalToolResults = new Map();
     for (const toolResult of state.toolResults) {
@@ -405,10 +441,7 @@ export class AgentRuntime {
             // Local models can't reliably do function calling — skip tools gracefully.
             const isLocal = isLocalModelRuntime(languageModel);
             if (isLocal && this.config.tools) {
-                logger.warn(`Agent "${this.id}" has tools configured but is using local model "${effectiveModel}". ` +
-                    "Local models don't support tool calling — tools will be skipped. " +
-                    "Set VERYFRONT_API_TOKEN and VERYFRONT_PROJECT_SLUG, or configure " +
-                    "OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY for full tool support.");
+                warnLocalToolSkipping(this.id, effectiveModel);
             }
             // Request-scoped skill policy (not class-level mutable state)
             let activeSkillPolicy;
@@ -483,21 +516,9 @@ export class AgentRuntime {
                 await this.memory.add(assistantMessage);
                 const generatedToolResults = collectGeneratedToolResults(response.toolResults);
                 const persistGeneratedToolResult = async (generatedToolResult) => {
-                    const toolResultMessage = {
-                        id: `tool_${generatedToolResult.toolCallId}`,
-                        role: "tool",
-                        parts: [
-                            {
-                                type: "tool-result",
-                                toolCallId: generatedToolResult.toolCallId,
-                                toolName: generatedToolResult.toolName,
-                                result: generatedToolResult.isError === true
-                                    ? { error: stringifyToolError(generatedToolResult.result) }
-                                    : generatedToolResult.result,
-                            },
-                        ],
-                        timestamp: Date.now(),
-                    };
+                    const toolResultMessage = createToolResultMessage(generatedToolResult.toolCallId, generatedToolResult.toolName, generatedToolResult.isError === true
+                        ? { error: stringifyToolError(generatedToolResult.result) }
+                        : generatedToolResult.result);
                     currentMessages.push(toolResultMessage);
                     await this.memory.add(toolResultMessage);
                 };
@@ -577,19 +598,7 @@ export class AgentRuntime {
                                 activeSkillPolicy = extractSkillPolicy(result);
                                 mustLoadSkillFirst = false;
                             }
-                            const toolResultMessage = {
-                                id: `tool_${tc.toolCallId}`,
-                                role: "tool",
-                                parts: [
-                                    {
-                                        type: "tool-result",
-                                        toolCallId: tc.toolCallId,
-                                        toolName: tc.toolName,
-                                        result,
-                                    },
-                                ],
-                                timestamp: Date.now(),
-                            };
+                            const toolResultMessage = createToolResultMessage(tc.toolCallId, tc.toolName, result);
                             currentMessages.push(toolResultMessage);
                             await this.memory.add(toolResultMessage);
                         }
@@ -597,19 +606,7 @@ export class AgentRuntime {
                             toolCall.status = "error";
                             toolCall.error = error instanceof Error ? error.message : String(error);
                             setSpanAttributes(toolSpan, { error: true, "error.message": toolCall.error });
-                            const errorMessage = {
-                                id: `tool_error_${tc.toolCallId}`,
-                                role: "tool",
-                                parts: [
-                                    {
-                                        type: "tool-result",
-                                        toolCallId: tc.toolCallId,
-                                        toolName: tc.toolName,
-                                        result: { error: toolCall.error },
-                                    },
-                                ],
-                                timestamp: Date.now(),
-                            };
+                            const errorMessage = createToolErrorMessage(tc.toolCallId, tc.toolName, toolCall.error);
                             currentMessages.push(errorMessage);
                             await this.memory.add(errorMessage);
                         }
@@ -646,10 +643,7 @@ export class AgentRuntime {
         // Local models can't reliably do function calling — skip tools gracefully.
         const isLocalStreaming = isLocalModelRuntime(languageModel);
         if (isLocalStreaming && this.config.tools) {
-            logger.warn(`Agent "${this.id}" has tools configured but is using local model "${effectiveModel}". ` +
-                "Local models don't support tool calling — tools will be skipped. " +
-                "Set VERYFRONT_API_TOKEN and VERYFRONT_PROJECT_SLUG, or configure " +
-                "OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY for full tool support.");
+            warnLocalToolSkipping(this.id, effectiveModel);
         }
         // Request-scoped skill policy (not class-level mutable state)
         let activeSkillPolicy;
@@ -746,21 +740,9 @@ export class AgentRuntime {
                 if (currentStepToolResults.has(toolResult.toolCallId)) {
                     return;
                 }
-                const toolResultMessage = {
-                    id: `tool_${toolResult.toolCallId}`,
-                    role: "tool",
-                    parts: [
-                        {
-                            type: "tool-result",
-                            toolCallId: toolResult.toolCallId,
-                            toolName: toolResult.toolName,
-                            result: toolResult.error === undefined
-                                ? toolResult.output
-                                : { error: stringifyToolError(toolResult.error) },
-                        },
-                    ],
-                    timestamp: Date.now(),
-                };
+                const toolResultMessage = createToolResultMessage(toolResult.toolCallId, toolResult.toolName, toolResult.error === undefined
+                    ? toolResult.output
+                    : { error: stringifyToolError(toolResult.error) });
                 currentMessages.push(toolResultMessage);
                 await this.memory.add(toolResultMessage);
                 currentStepToolResults.set(toolResult.toolCallId, toolResultMessage.parts[0]);
@@ -869,19 +851,7 @@ export class AgentRuntime {
                         output: result,
                         ...(dynamic ? { dynamic: true } : {}),
                     });
-                    const toolResultMessage = {
-                        id: `tool_${tc.id}`,
-                        role: "tool",
-                        parts: [
-                            {
-                                type: "tool-result",
-                                toolCallId: tc.id,
-                                toolName: tc.name,
-                                result,
-                            },
-                        ],
-                        timestamp: Date.now(),
-                    };
+                    const toolResultMessage = createToolResultMessage(tc.id, tc.name, result);
                     if (!currentStepToolResults.has(tc.id)) {
                         currentMessages.push(toolResultMessage);
                         await this.memory.add(toolResultMessage);
@@ -923,19 +893,7 @@ export class AgentRuntime {
             errorText: errorStr,
             ...(dynamic ? { dynamic: true } : {}),
         });
-        const errorMessage = {
-            id: `tool_error_${toolCall.id}`,
-            role: "tool",
-            parts: [
-                {
-                    type: "tool-result",
-                    toolCallId: toolCall.id,
-                    toolName: toolCall.name,
-                    result: { error: errorStr },
-                },
-            ],
-            timestamp: Date.now(),
-        };
+        const errorMessage = createToolErrorMessage(toolCall.id, toolCall.name, errorStr);
         currentMessages.push(errorMessage);
         await this.memory.add(errorMessage);
     }

package/esm/src/chat/ag-ui-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { ChatFinishReason, ChatStreamEvent } from "./protocol.js";
+type ParsedRenderableCustomChunk = Extract<ChatStreamEvent, {
+    type: "source-url" | "source-document" | "file";
+}>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function normalizeNewlines(value: string): string;
+export declare function toRenderableCustomChunk(value: unknown): ParsedRenderableCustomChunk | null;
+export declare function parseSerializedToolResult(value: unknown): unknown;
+export declare function formatToolErrorText(result: unknown): string;
+export declare function mapFinishReason(reason: string | undefined): ChatFinishReason | undefined;
+export declare function splitSseFrames(value: string): {
+    frames: string[];
+    remainder: string;
+};
+export declare function isCommentOnlySseFrame(raw: string): boolean;
+export {};
+//# sourceMappingURL=ag-ui-helpers.d.ts.map

package/esm/src/chat/ag-ui-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ag-ui-helpers.d.ts","sourceRoot":"","sources":["../../../src/src/chat/ag-ui-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEvE,KAAK,2BAA2B,GAAG,OAAO,CACxC,eAAe,EACf;IAAE,IAAI,EAAE,YAAY,GAAG,iBAAiB,GAAG,MAAM,CAAA;CAAE,CACpD,CAAC;AAEF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,GAAG,IAAI,CA2C1F;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAsBjE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAgB3D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAsBxF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAMrF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI1D"}

package/esm/src/chat/ag-ui-helpers.js

@@ -0,0 +1,111 @@
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function normalizeNewlines(value) {
+    return value.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+}
+export function toRenderableCustomChunk(value) {
+    if (!isRecord(value) || typeof value.type !== "string") {
+        return null;
+    }
+    if (value.type === "source-url" && typeof value.url === "string") {
+        return {
+            type: "source-url",
+            sourceId: typeof value.sourceId === "string" && value.sourceId.length > 0
+                ? value.sourceId
+                : value.url,
+            url: value.url,
+            ...(typeof value.title === "string" ? { title: value.title } : {}),
+        };
+    }
+    if (value.type === "source-document" &&
+        typeof value.sourceId === "string" &&
+        typeof value.mediaType === "string" &&
+        typeof value.title === "string") {
+        return {
+            type: "source-document",
+            sourceId: value.sourceId,
+            mediaType: value.mediaType,
+            title: value.title,
+            ...(typeof value.filename === "string" ? { filename: value.filename } : {}),
+        };
+    }
+    if (value.type === "file" && typeof value.url === "string" && typeof value.mediaType === "string") {
+        return {
+            type: "file",
+            url: value.url,
+            mediaType: value.mediaType,
+            ...(typeof value.filename === "string" ? { filename: value.filename } : {}),
+        };
+    }
+    return null;
+}
+export function parseSerializedToolResult(value) {
+    if (typeof value !== "string") {
+        return value;
+    }
+    const trimmed = value.trim();
+    if (!trimmed.startsWith("{") &&
+        !trimmed.startsWith("[") &&
+        trimmed !== "null" &&
+        trimmed !== "true" &&
+        trimmed !== "false" &&
+        !/^[-]?\d+(\.\d+)?$/.test(trimmed)) {
+        return value;
+    }
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return value;
+    }
+}
+export function formatToolErrorText(result) {
+    if (typeof result === "string" && result.length > 0) {
+        return result;
+    }
+    if (isRecord(result)) {
+        if (typeof result.error === "string" && result.error.length > 0) {
+            return result.error;
+        }
+        if (typeof result.message === "string" && result.message.length > 0) {
+            return result.message;
+        }
+    }
+    return JSON.stringify(result ?? { error: "Tool execution failed" });
+}
+export function mapFinishReason(reason) {
+    if (!reason)
+        return undefined;
+    switch (reason.trim().toLowerCase()) {
+        case "stop":
+        case "end_turn":
+        case "stop_sequence":
+            return "stop";
+        case "length":
+        case "max_tokens":
+            return "length";
+        case "tool_calls":
+        case "tool_use":
+            return "tool-calls";
+        case "content_filter":
+        case "content-filter":
+            return "content-filter";
+        case "error":
+            return "error";
+        default:
+            return "other";
+    }
+}
+export function splitSseFrames(value) {
+    const blocks = value.split("\n\n");
+    return {
+        frames: blocks.slice(0, -1),
+        remainder: blocks.at(-1) ?? "",
+    };
+}
+export function isCommentOnlySseFrame(raw) {
+    return raw
+        .split("\n")
+        .every((line) => line.trim().length === 0 || line.trimStart().startsWith(":"));
+}

package/esm/src/chat/ag-ui.d.ts.map

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

package/esm/src/chat/ag-ui.js

@@ -1,4 +1,5 @@
 import { mergeToolInputDelta, parseToolInputObject } from "../agent/data-stream.js";
+import { formatToolErrorText, isCommentOnlySseFrame, isRecord, mapFinishReason, normalizeNewlines, parseSerializedToolResult, splitSseFrames, toRenderableCustomChunk, } from "./ag-ui-helpers.js";
 import { z } from "zod";
 export const AgUiRunFinishedMetadataSchema = z.object({
     provider: z.string().optional(),
@@ -230,105 +231,6 @@ export const AgUiWireEventSchema = z.discriminatedUnion("eventName", [
         }),
     }),
 ]);
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function normalizeNewlines(value) {
-    return value.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-}
-function toRenderableCustomChunk(value) {
-    if (!isRecord(value) || typeof value.type !== "string") {
-        return null;
-    }
-    if (value.type === "source-url" && typeof value.url === "string") {
-        return {
-            type: "source-url",
-            sourceId: typeof value.sourceId === "string" && value.sourceId.length > 0
-                ? value.sourceId
-                : value.url,
-            url: value.url,
-            ...(typeof value.title === "string" ? { title: value.title } : {}),
-        };
-    }
-    if (value.type === "source-document" &&
-        typeof value.sourceId === "string" &&
-        typeof value.mediaType === "string" &&
-        typeof value.title === "string") {
-        return {
-            type: "source-document",
-            sourceId: value.sourceId,
-            mediaType: value.mediaType,
-            title: value.title,
-            ...(typeof value.filename === "string" ? { filename: value.filename } : {}),
-        };
-    }
-    if (value.type === "file" && typeof value.url === "string" && typeof value.mediaType === "string") {
-        return {
-            type: "file",
-            url: value.url,
-            mediaType: value.mediaType,
-            ...(typeof value.filename === "string" ? { filename: value.filename } : {}),
-        };
-    }
-    return null;
-}
-function parseSerializedToolResult(value) {
-    if (typeof value !== "string") {
-        return value;
-    }
-    const trimmed = value.trim();
-    if (!trimmed.startsWith("{") &&
-        !trimmed.startsWith("[") &&
-        trimmed !== "null" &&
-        trimmed !== "true" &&
-        trimmed !== "false" &&
-        !/^[-]?\d+(\.\d+)?$/.test(trimmed)) {
-        return value;
-    }
-    try {
-        return JSON.parse(trimmed);
-    }
-    catch {
-        return value;
-    }
-}
-function formatToolErrorText(result) {
-    if (typeof result === "string" && result.length > 0) {
-        return result;
-    }
-    if (isRecord(result)) {
-        if (typeof result.error === "string" && result.error.length > 0) {
-            return result.error;
-        }
-        if (typeof result.message === "string" && result.message.length > 0) {
-            return result.message;
-        }
-    }
-    return JSON.stringify(result ?? { error: "Tool execution failed" });
-}
-function mapFinishReason(reason) {
-    if (!reason)
-        return undefined;
-    switch (reason.trim().toLowerCase()) {
-        case "stop":
-        case "end_turn":
-        case "stop_sequence":
-            return "stop";
-        case "length":
-        case "max_tokens":
-            return "length";
-        case "tool_calls":
-        case "tool_use":
-            return "tool-calls";
-        case "content_filter":
-        case "content-filter":
-            return "content-filter";
-        case "error":
-            return "error";
-        default:
-            return "other";
-    }
-}
 function getReasoningPartId(state, payload, phase) {
     if (typeof payload.id === "string" && payload.id.length > 0) {
         return payload.id;
@@ -350,18 +252,6 @@ function getReasoningPartId(state, payload, phase) {
     }
     return fallbackId;
 }
-function splitSseFrames(value) {
-    const blocks = value.split("\n\n");
-    return {
-        frames: blocks.slice(0, -1),
-        remainder: blocks.at(-1) ?? "",
-    };
-}
-function isCommentOnlySseFrame(raw) {
-    return raw
-        .split("\n")
-        .every((line) => line.trim().length === 0 || line.trimStart().startsWith(":"));
-}
 function parseAgUiWireEvent(frame, input) {
     if (frame.data === "[DONE]" || !frame.event || !frame.data) {
         return null;

package/esm/src/config/schemas/config.schema.d.ts

@@ -330,6 +330,7 @@ export declare const veryfrontConfigSchema: z.ZodObject<{
         perUser: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         tools: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>>>>>;
+    extensions: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodUnknown>>>;
     openapi: z.ZodOptional<z.ZodOptional<z.ZodObject<{
         enabled: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
         docs: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;

package/esm/src/config/schemas/config.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.schema.d.ts","sourceRoot":"","sources":["../../../../src/src/config/schemas/config.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6ftB,CAAC;AAGb,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGzE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAyBvE;AAQD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAEhF"}
+{"version":3,"file":"config.schema.d.ts","sourceRoot":"","sources":["../../../../src/src/config/schemas/config.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwgBtB,CAAC;AAGb,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGzE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAyBvE;AAQD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAEhF"}

package/esm/src/config/schemas/config.schema.js

@@ -480,6 +480,17 @@ export const veryfrontConfigSchema = z
         .partial()
         .optional())
         .optional(),
+    /**
+     * Extensions registered for this project.
+     *
+     * Each entry is either a fully-materialized `Extension` object or a
+     * disable directive `{ name, enabled: false }` that vetoes an extension
+     * discovered from a lower-priority source. The runtime type is
+     * tightened at the `veryfront/extensions` barrel — we keep this as
+     * `z.unknown()` here to avoid pulling the extensions module into the
+     * config layer (would introduce a circular import).
+     */
+    extensions: z.array(z.unknown()).optional(),
     /** OpenAPI documentation configuration */
     openapi: z
         .object({

package/esm/src/config/schemas/index.d.ts

@@ -3,5 +3,15 @@
  *
  * @module config/schemas
  */
-export { findUnknownTopLevelKeys, validateVeryfrontConfig, type VeryfrontConfig, type VeryfrontConfigInput, veryfrontConfigSchema, } from "./config.schema.js";
+export { findUnknownTopLevelKeys, validateVeryfrontConfig, type VeryfrontConfigInput, veryfrontConfigSchema, } from "./config.schema.js";
+import type { VeryfrontConfig as BaseVeryfrontConfig } from "./config.schema.js";
+import type { ExtensionConfigEntry } from "../../extensions/types.js";
+/**
+ * Project configuration. The underlying zod schema stores `extensions` as
+ * `unknown[]`; this tightened alias surfaces the expected
+ * `ExtensionConfigEntry[]` shape to TypeScript consumers.
+ */
+export type VeryfrontConfig = Omit<BaseVeryfrontConfig, "extensions"> & {
+    extensions?: ExtensionConfigEntry[];
+};
 //# sourceMappingURL=index.d.ts.map

package/esm/src/config/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/config/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/config/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,eAAe,IAAI,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,GACvC;IAAE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAA;CAAE,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { ErrorCategory, RegisteredError } from "./types.js";
+export type ErrorRegistryMap = Record<string, RegisteredError>;
+export declare function getRegistryEntry<Registry extends ErrorRegistryMap, Slug extends keyof Registry>(registry: Registry, slug: Slug): Registry[Slug];
+export declare function getRegistryEntriesByCategory(registry: ErrorRegistryMap, category: ErrorCategory): RegisteredError[];
+export declare function getRegistrySlugs<Registry extends ErrorRegistryMap>(registry: Registry): Array<keyof Registry>;
+//# sourceMappingURL=error-registry-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-registry-helpers.d.ts","sourceRoot":"","sources":["../../../src/src/errors/error-registry-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE/D,wBAAgB,gBAAgB,CAC9B,QAAQ,SAAS,gBAAgB,EACjC,IAAI,SAAS,MAAM,QAAQ,EAC3B,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAEhD;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,aAAa,GACtB,eAAe,EAAE,CAEnB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,SAAS,gBAAgB,EAChE,QAAQ,EAAE,QAAQ,GACjB,KAAK,CAAC,MAAM,QAAQ,CAAC,CAEvB"}

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

@@ -0,0 +1,9 @@
+export function getRegistryEntry(registry, slug) {
+    return registry[slug];
+}
+export function getRegistryEntriesByCategory(registry, category) {
+    return Object.values(registry).filter((error) => error.category === category);
+}
+export function getRegistrySlugs(registry) {
+    return Object.keys(registry);
+}

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

@@ -1,3 +1,4 @@
+import { getRegistryEntriesByCategory, getRegistryEntry, getRegistrySlugs, } from "./error-registry-helpers.js";
 import { defineError } from "./types.js";
 // =============================================================================
 // CONFIG - Configuration & environment errors
@@ -696,17 +697,17 @@ export const ERROR_REGISTRY = {
  * Get an error definition by slug
  */
 export function getErrorBySlug(slug) {
-    return ERROR_REGISTRY[slug];
+    return getRegistryEntry(ERROR_REGISTRY, slug);
 }
 /**
  * Get all errors in a category
  */
 export function getErrorsByCategory(category) {
-    return Object.values(ERROR_REGISTRY).filter((error) => error.category === category);
+    return getRegistryEntriesByCategory(ERROR_REGISTRY, category);
 }
 /**
  * Get all registered slugs
  */
 export function getAllSlugs() {
-    return Object.keys(ERROR_REGISTRY);
+    return getRegistrySlugs(ERROR_REGISTRY);
 }

package/esm/src/extensions/factory-loader.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Dynamic factory loader.
+ *
+ * Loads an extension factory from a filesystem path by dynamic import,
+ * invokes it, and wraps the result as a `ResolvedExtension`.
+ *
+ * @module extensions/factory-loader
+ */
+import type { ExtensionSource, ResolvedExtension } from "./types.js";
+/**
+ * Dynamically import an extension factory from `path` and resolve it.
+ *
+ * `path` may be either an absolute filesystem path (for project and
+ * local-file sources) or a bare module specifier (for `package` source).
+ * Absolute paths are converted to `file://` URLs; bare specifiers are
+ * passed through so the runtime's module resolver can find them.
+ *
+ * The module must `export default` an `ExtensionFactory` (a function that
+ * returns an `Extension`). On any error — missing default export, default
+ * export that is not a function, factory throw, or import failure — this
+ * throws `EXTENSION_VALIDATION_ERROR` with a `detail` field that names the
+ * path and what went wrong.
+ *
+ * @param path Absolute filesystem path or bare module specifier.
+ * @param source Where the extension was discovered (drives merge priority).
+ * @param config Optional config forwarded to the factory.
+ */
+export declare function loadExtensionFactory(path: string, source: ExtensionSource, config?: unknown): Promise<ResolvedExtension>;
+//# sourceMappingURL=factory-loader.d.ts.map

package/esm/src/extensions/factory-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-loader.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/factory-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAA+B,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElG;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,OAAO,GACf,OAAO,CAAC,iBAAiB,CAAC,CAwC5B"}