veryfront 0.1.216 → 0.1.217

package/src/src/agent/runtime/index.ts

@@ -133,6 +133,51 @@ function getSkillActivationRequiredError(toolName: string): string {
     `Call "${LOAD_SKILL_TOOL_ID}" first to establish the active skill context.`;
 }
 
+function warnLocalToolSkipping(agentId: string, modelId: string): void {
+  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: string,
+  toolName: string,
+  result: unknown,
+): Message {
+  return {
+    id: `tool_${toolCallId}`,
+    role: "tool",
+    parts: [
+      {
+        type: "tool-result",
+        toolCallId,
+        toolName,
+        result,
+      },
+    ],
+    timestamp: Date.now(),
+  };
+}
+
+function createToolErrorMessage(toolCallId: string, toolName: string, error: string): Message {
+  return {
+    id: `tool_error_${toolCallId}`,
+    role: "tool",
+    parts: [
+      {
+        type: "tool-result",
+        toolCallId,
+        toolName,
+        result: { error },
+      },
+    ],
+    timestamp: Date.now(),
+  };
+}
+
 export function collectFinalStreamToolResults(
   state: Pick<ChatStreamState, "toolResults">,
 ): Map<string, StreamingToolResult> {
@@ -671,12 +716,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)
@@ -769,21 +809,13 @@ export class AgentRuntime {
         const persistGeneratedToolResult = async (
           generatedToolResult: RuntimeGenerateToolResult,
         ): Promise<void> => {
-          const toolResultMessage: Message = {
-            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);
         };
@@ -886,19 +918,11 @@ export class AgentRuntime {
                 mustLoadSkillFirst = false;
               }
 
-              const toolResultMessage: Message = {
-                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);
             } catch (error) {
@@ -906,19 +930,11 @@ export class AgentRuntime {
               toolCall.error = error instanceof Error ? error.message : String(error);
               setSpanAttributes(toolSpan, { error: true, "error.message": toolCall.error });
 
-              const errorMessage: Message = {
-                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);
             }
@@ -980,12 +996,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)
@@ -1100,21 +1111,13 @@ export class AgentRuntime {
           return;
         }
 
-        const toolResultMessage: Message = {
-          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(
@@ -1270,19 +1273,7 @@ export class AgentRuntime {
             ...(dynamic ? { dynamic: true } : {}),
           });
 
-          const toolResultMessage: Message = {
-            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);
@@ -1343,19 +1334,11 @@ export class AgentRuntime {
       ...(dynamic ? { dynamic: true } : {}),
     });
 
-    const errorMessage: Message = {
-      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/src/src/chat/ag-ui-helpers.ts

@@ -0,0 +1,139 @@
+import type { ChatFinishReason, ChatStreamEvent } from "./protocol.js";
+
+type ParsedRenderableCustomChunk = Extract<
+  ChatStreamEvent,
+  { type: "source-url" | "source-document" | "file" }
+>;
+
+export function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export function normalizeNewlines(value: string): string {
+  return value.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+}
+
+export function toRenderableCustomChunk(value: unknown): ParsedRenderableCustomChunk | null {
+  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: unknown): unknown {
+  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: unknown): string {
+  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: string | undefined): ChatFinishReason | undefined {
+  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: string): { frames: string[]; remainder: string } {
+  const blocks = value.split("\n\n");
+  return {
+    frames: blocks.slice(0, -1),
+    remainder: blocks.at(-1) ?? "",
+  };
+}
+
+export function isCommentOnlySseFrame(raw: string): boolean {
+  return raw
+    .split("\n")
+    .every((line) => line.trim().length === 0 || line.trimStart().startsWith(":"));
+}

package/src/src/chat/ag-ui.ts

@@ -1,6 +1,16 @@
 import "../../_dnt.polyfills.js";
 import { mergeToolInputDelta, parseToolInputObject } from "../agent/data-stream.js";
-import type { ChatFinishReason, ChatStreamEvent } from "./protocol.js";
+import {
+  formatToolErrorText,
+  isCommentOnlySseFrame,
+  isRecord,
+  mapFinishReason,
+  normalizeNewlines,
+  parseSerializedToolResult,
+  splitSseFrames,
+  toRenderableCustomChunk,
+} from "./ag-ui-helpers.js";
+import type { ChatStreamEvent } from "./protocol.js";
 import { z } from "zod";
 
 type JsonPatchOperation = {
@@ -10,11 +20,6 @@ type JsonPatchOperation = {
   value?: unknown;
 };
 
-type ParsedRenderableCustomChunk = Extract<
-  ChatStreamEvent,
-  { type: "source-url" | "source-document" | "file" }
->;
-
 type ToolCallState = {
   toolName: string;
   argsText: string;
@@ -292,125 +297,6 @@ export type AgUiSnapshotMessage = z.infer<typeof AgUiSnapshotMessageSchema>;
 export type AgUiWireEventName = z.infer<typeof AgUiWireEventNameSchema>;
 export type AgUiWireEvent = z.infer<typeof AgUiWireEventSchema>;
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function normalizeNewlines(value: string): string {
-  return value.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-}
-
-function toRenderableCustomChunk(value: unknown): ParsedRenderableCustomChunk | null {
-  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: unknown): unknown {
-  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: unknown): string {
-  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: string | undefined): ChatFinishReason | undefined {
-  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: AgUiChatEventDecoderState,
   payload: { id?: string; messageId?: string },
@@ -440,20 +326,6 @@ function getReasoningPartId(
   return fallbackId;
 }
 
-function splitSseFrames(value: string): { frames: string[]; remainder: string } {
-  const blocks = value.split("\n\n");
-  return {
-    frames: blocks.slice(0, -1),
-    remainder: blocks.at(-1) ?? "",
-  };
-}
-
-function isCommentOnlySseFrame(raw: string): boolean {
-  return raw
-    .split("\n")
-    .every((line) => line.trim().length === 0 || line.trimStart().startsWith(":"));
-}
-
 function parseAgUiWireEvent(
   frame: ParsedSseEvent,
   input: {

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

@@ -491,6 +491,17 @@ export const veryfrontConfigSchema = z
           .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/src/src/config/schemas/index.ts

@@ -7,7 +7,21 @@
 export {
   findUnknownTopLevelKeys,
   validateVeryfrontConfig,
-  type VeryfrontConfig,
   type VeryfrontConfigInput,
   veryfrontConfigSchema,
 } from "./config.schema.js";
+
+import type { VeryfrontConfig as BaseVeryfrontConfig } from "./config.schema.js";
+// Type-only reference — keeps the config layer free of a runtime dependency
+// on the extensions module. The schema stores `extensions` as `unknown[]`
+// at runtime; this type assertion tightens it at the TS layer.
+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[] };

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

@@ -0,0 +1,23 @@
+import type { ErrorCategory, RegisteredError } from "./types.js";
+
+export type ErrorRegistryMap = Record<string, RegisteredError>;
+
+export function getRegistryEntry<
+  Registry extends ErrorRegistryMap,
+  Slug extends keyof Registry,
+>(registry: Registry, slug: Slug): Registry[Slug] {
+  return registry[slug];
+}
+
+export function getRegistryEntriesByCategory(
+  registry: ErrorRegistryMap,
+  category: ErrorCategory,
+): RegisteredError[] {
+  return Object.values(registry).filter((error) => error.category === category);
+}
+
+export function getRegistrySlugs<Registry extends ErrorRegistryMap>(
+  registry: Registry,
+): Array<keyof Registry> {
+  return Object.keys(registry) as Array<keyof Registry>;
+}

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

@@ -1,3 +1,8 @@
+import {
+  getRegistryEntriesByCategory,
+  getRegistryEntry,
+  getRegistrySlugs,
+} from "./error-registry-helpers.js";
 import { defineError, type ErrorCategory } from "./types.js";
 
 // =============================================================================
@@ -801,19 +806,19 @@ export type ErrorSlug = keyof typeof ERROR_REGISTRY;
  * Get an error definition by slug
  */
 export function getErrorBySlug(slug: ErrorSlug) {
-  return ERROR_REGISTRY[slug];
+  return getRegistryEntry(ERROR_REGISTRY, slug);
 }
 
 /**
  * Get all errors in a category
  */
 export function getErrorsByCategory(category: ErrorCategory) {
-  return Object.values(ERROR_REGISTRY).filter((error) => error.category === category);
+  return getRegistryEntriesByCategory(ERROR_REGISTRY, category);
 }
 
 /**
  * Get all registered slugs
  */
 export function getAllSlugs(): ErrorSlug[] {
-  return Object.keys(ERROR_REGISTRY) as ErrorSlug[];
+  return getRegistrySlugs(ERROR_REGISTRY) as ErrorSlug[];
 }