veryfront 0.1.149 → 0.1.151

package/src/src/chat/protocol.ts

@@ -0,0 +1,210 @@
+/**
+ * Canonical chat message and stream protocol for Veryfront chat surfaces.
+ *
+ * These types describe the framework-owned message parts and stream events used
+ * by AG-UI-aligned chat clients, hooks, and adapters.
+ */
+import "../../_dnt.polyfills.js";
+
+
+export type ChatPartState = "streaming" | "done";
+
+export interface ChatTextPart {
+  type: "text";
+  text: string;
+  state?: ChatPartState;
+}
+
+export interface ChatReasoningPart {
+  type: "reasoning";
+  text: string;
+  state?: ChatPartState;
+}
+
+export type ChatToolState =
+  | "input-streaming"
+  | "input-available"
+  | "output-streaming"
+  | "output-available"
+  | "output-error";
+
+export interface ChatToolPart<NAME extends string = string, INPUT = unknown, OUTPUT = unknown> {
+  type: `tool-${NAME}`;
+  toolCallId: string;
+  toolName: NAME;
+  state: ChatToolState;
+  input?: INPUT;
+  output?: OUTPUT;
+  errorText?: string;
+}
+
+export interface ChatToolResultPart<RESULT = unknown> {
+  type: "tool-result";
+  toolCallId: string;
+  toolName: string;
+  result: RESULT;
+  isError?: boolean;
+}
+
+export interface ChatDynamicToolPart {
+  type: "dynamic-tool";
+  toolCallId: string;
+  toolName: string;
+  state: ChatToolState;
+  input?: unknown;
+  output?: unknown;
+  errorText?: string;
+}
+
+export interface ChatStepPart {
+  type: "step-start" | "step-end";
+  stepIndex: number;
+}
+
+export type ChatMessagePart =
+  | ChatTextPart
+  | ChatReasoningPart
+  | ChatToolPart
+  | ChatToolResultPart
+  | ChatDynamicToolPart
+  | ChatStepPart;
+
+export interface ChatMessage {
+  id: string;
+  role: "system" | "user" | "assistant";
+  parts: ChatMessagePart[];
+  metadata?: Record<string, unknown>;
+  createdAt?: Date | string;
+}
+
+export type ChatFinishReason =
+  | "stop"
+  | "length"
+  | "tool-calls"
+  | "content-filter"
+  | "error"
+  | "other";
+
+type ChatStreamEventBase = {
+  providerExecuted?: boolean;
+  dynamic?: boolean;
+};
+
+export type ChatStreamEvent =
+  | {
+    type: "start";
+    messageId?: string;
+    messageMetadata?: unknown;
+  }
+  | {
+    type: "message-metadata";
+    messageMetadata: unknown;
+  }
+  | {
+    type: "text-start";
+    id: string;
+  }
+  | {
+    type: "text-delta";
+    id: string;
+    delta: string;
+  }
+  | {
+    type: "text-end";
+    id: string;
+  }
+  | {
+    type: "reasoning-start";
+    id: string;
+  }
+  | {
+    type: "reasoning-delta";
+    id: string;
+    delta: string;
+  }
+  | {
+    type: "reasoning-end";
+    id: string;
+  }
+  | ({
+    type: "tool-input-start";
+    toolCallId: string;
+    toolName: string;
+  } & ChatStreamEventBase)
+  | ({
+    type: "tool-input-delta";
+    toolCallId: string;
+    inputTextDelta: string;
+  } & ChatStreamEventBase)
+  | ({
+    type: "tool-input-available";
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+  } & ChatStreamEventBase)
+  | ({
+    type: "tool-input-error";
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    errorText: string;
+  } & ChatStreamEventBase)
+  | {
+    type: "tool-approval-request";
+    approvalId: string;
+    toolCallId: string;
+  }
+  | ({
+    type: "tool-output-available";
+    toolCallId: string;
+    output: unknown;
+  } & ChatStreamEventBase)
+  | {
+    type: "tool-output-denied";
+    toolCallId: string;
+  }
+  | ({
+    type: "tool-output-error";
+    toolCallId: string;
+    errorText: string;
+  } & ChatStreamEventBase)
+  | {
+    type: "source-url";
+    sourceId: string;
+    url: string;
+    title?: string;
+  }
+  | {
+    type: "source-document";
+    sourceId: string;
+    mediaType: string;
+    title: string;
+    filename?: string;
+  }
+  | {
+    type: "file";
+    url: string;
+    mediaType: string;
+    filename?: string;
+  }
+  | {
+    type: "start-step";
+  }
+  | {
+    type: "finish-step";
+  }
+  | {
+    type: `data-${string}`;
+    data: unknown;
+  }
+  | {
+    type: "finish";
+    finishReason?: ChatFinishReason;
+  }
+  | {
+    type: "abort";
+  }
+  | {
+    type: "error";
+    errorText: string;
+  };

package/src/src/discovery/import-rewriter.ts

@@ -17,11 +17,7 @@ import * as pathHelper from "../platform/compat/path/index.js";
  */
 export function rewriteForDeno(code: string, fileDir: string): string {
   const npmReplacements: Array<[RegExp, string]> = [
-    [/from\s+["']ai["']/g, 'from "npm:ai"'],
-    [/from\s+["']ai\/([^"']+)["']/g, 'from "npm:ai/$1"'],
-    [/from\s+["']@ai-sdk\/([^"']+)["']/g, 'from "npm:@ai-sdk/$1"'],
     [/from\s+["']zod["']/g, 'from "npm:zod"'],
-    [/import\s*\(\s*["']ai["']\s*\)/g, 'import("npm:ai")'],
     [/import\s*\(\s*["']zod["']\s*\)/g, 'import("npm:zod")'],
   ];
 
@@ -142,16 +138,7 @@ export async function rewriteDiscoveryImports(
     };
 
     // Rewrite external package imports
-    const externalPackages = [
-      "zod",
-      "ai",
-      "@ai-sdk/anthropic",
-      "@ai-sdk/openai",
-      "@ai-sdk/google",
-      "@ai-sdk/mistral",
-      "@ai-sdk/provider",
-      "@ai-sdk/provider-utils",
-    ];
+    const externalPackages = ["zod"];
 
     for (const pkg of externalPackages) {
       transformed = await rewritePackageImports(transformed, pkg);

package/src/src/discovery/index.ts

@@ -26,5 +26,5 @@ export { clearTrackedAgents, filenameToId, filePathToPattern } from "./discovery
 // Re-export transpiler utilities
 export { clearTranspileCache } from "./transpiler.js";
 
-// Re-export config validation (pure logic — no ANSI colors)
-export { validateAIConfig, type ValidationResult } from "./config-validator.js";
+// Re-export provider config validation (pure logic — no ANSI colors)
+export { validateProviderConfig, type ValidationResult } from "./provider-config-validator.js";

package/src/src/discovery/{config-validator.ts → provider-config-validator.ts}

@@ -1,8 +1,8 @@
 /**
- * AI Config Validator
+ * Provider Config Validator
  *
- * Pure validation logic for AI configuration. Returns plain-text messages
- * without ANSI formatting — the CLI caller applies colors when printing.
+ * Pure validation logic for configured model providers. Returns plain-text
+ * messages without ANSI formatting; the CLI caller applies colors when printing.
  */
 
 import type { VeryfrontConfig } from "../config/index.js";
@@ -13,7 +13,7 @@ export interface ValidationResult {
   errors: string[];
 }
 
-export function validateAIConfig(config: VeryfrontConfig): ValidationResult {
+export function validateProviderConfig(config: VeryfrontConfig): ValidationResult {
   const result: ValidationResult = { valid: true, warnings: [], errors: [] };
 
   const providers = config.ai?.providers;

package/src/src/discovery/transpiler.ts

@@ -192,9 +192,6 @@ export async function importModule(
     resolveExtensions: [".ts", ".tsx", ".js", ".jsx", ".mjs"],
     plugins,
     external: [
-      "ai",
-      "ai/*",
-      "@ai-sdk/*",
       "zod",
       "node:*",
       "veryfront",

package/src/src/embedding/embedding.ts

@@ -1,7 +1,7 @@
-import { embed, embedMany } from "ai";
 import type { Embedding, EmbeddingConfig } from "./types.js";
 import { resolveEmbeddingModel } from "./resolve.js";
 import { resolveConfiguredEmbeddingModel } from "./model-resolution.js";
+import { embed, embedMany } from "../runtime/runtime-bridge.js";
 
 const DEFAULT_BATCH_SIZE = 100;
 

package/src/src/embedding/index.ts

@@ -1,8 +1,8 @@
 /**
  * Embedding — RAG primitives for chunking, embedding, and similarity search.
  *
- * Provides a facade over AI SDK (embeddings, similarity) and LangChain
- * (text splitting) behind veryfront's own API.
+ * Provides a facade over the framework's current embedding runtime and
+ * LangChain text splitting behind veryfront's own API.
  *
  * @module embedding
  *
@@ -19,7 +19,7 @@ import "../../_dnt.polyfills.js";
 
 export { embedding } from "./embedding.js";
 export { chunk } from "./chunk.js";
-export { cosineSimilarity as similarity } from "ai";
+export { cosineSimilarity as similarity } from "../runtime/runtime-bridge.js";
 export { vectorStore } from "./vector-store.js";
 export { ragStore } from "./rag-store.js";
 export { createUploadHandler } from "./upload-handler.js";

package/src/src/embedding/rag-store.ts

@@ -1,5 +1,4 @@
 import * as dntShim from "../../_dnt.shims.js";
-import { cosineSimilarity } from "ai";
 import {
   isNotFoundError,
   mkdir,
@@ -25,6 +24,7 @@ import type {
   RagStoreConfig,
   RagStoreData,
 } from "./types.js";
+import { cosineSimilarity } from "../runtime/runtime-bridge.js";
 
 // Legacy data shapes used only for migrating old upload-store JSON files.
 interface LegacyStoredChunk {

package/src/src/embedding/resolve.ts

@@ -1,12 +1,14 @@
-import type { EmbeddingModel } from "ai";
 import { createError, toError } from "../errors/veryfront-error.js";
-import { createOpenAI } from "@ai-sdk/openai";
-import { createGoogleGenerativeAI } from "@ai-sdk/google";
 import { getGoogleGenAIEnvConfig, getOpenAIEnvConfig } from "../config/env.js";
-import { createLocalEmbeddingModel } from "../provider/local/local-embedding-adapter.js";
+import { createLocalEmbeddingModel } from "../provider/local/embedding-runtime-adapter.js";
+import {
+  createGoogleEmbeddingRuntime,
+  createOpenAIEmbeddingRuntime,
+} from "../provider/runtime-loader.js";
+import type { EmbeddingRuntime } from "../provider/types.js";
 import { createVeryfrontCloudEmbeddingModel } from "./veryfront-cloud/provider.js";
 
-type EmbeddingProviderFactory = (modelId: string) => EmbeddingModel;
+type EmbeddingProviderFactory = (modelId: string) => EmbeddingRuntime;
 
 const providers = new Map<string, EmbeddingProviderFactory>();
 let autoInitialized = false;
@@ -16,9 +18,7 @@ let autoInitialized = false;
  *
  * @example
  * ```ts
- * registerEmbeddingProvider("openai", (id) =>
- *   createOpenAI({ apiKey })().embedding(id)
- * );
+ * registerEmbeddingProvider("openai", (id) => createOpenAIEmbeddingRuntime({ apiKey }, id));
  * ```
  */
 export function registerEmbeddingProvider(
@@ -44,7 +44,10 @@ function autoInitializeFromEnv(): void {
           }),
         );
       }
-      return createOpenAI({ apiKey: config.apiKey, baseURL: config.baseURL }).embedding(id);
+      return createOpenAIEmbeddingRuntime(
+        { apiKey: config.apiKey, baseURL: config.baseURL },
+        id,
+      );
     });
   }
 
@@ -60,7 +63,7 @@ function autoInitializeFromEnv(): void {
           }),
         );
       }
-      return createGoogleGenerativeAI({ apiKey: config.apiKey }).textEmbeddingModel(id);
+      return createGoogleEmbeddingRuntime({ apiKey: config.apiKey }, id);
     });
   }
 
@@ -74,14 +77,14 @@ function autoInitializeFromEnv(): void {
 }
 
 /**
- * Resolve a "provider/model" string to an AI SDK EmbeddingModel instance.
+ * Resolve a "provider/model" string to an embedding runtime instance.
  *
  * @example
  * ```ts
  * const model = resolveEmbeddingModel("openai/text-embedding-3-small");
  * ```
  */
-export function resolveEmbeddingModel(modelString: string): EmbeddingModel {
+export function resolveEmbeddingModel(modelString: string): EmbeddingRuntime {
   autoInitializeFromEnv();
 
   const slashIndex = modelString.indexOf("/");

package/src/src/embedding/vector-store.ts

@@ -1,4 +1,3 @@
-import { cosineSimilarity } from "ai";
 import type {
   Embedding,
   SearchOptions,
@@ -6,6 +5,7 @@ import type {
   VectorStore,
   VectorStoreConfig,
 } from "./types.js";
+import { cosineSimilarity } from "../runtime/runtime-bridge.js";
 
 interface VectorEntry {
   text: string;

package/src/src/embedding/veryfront-cloud/provider.ts

@@ -1,7 +1,9 @@
-import type { EmbeddingModel } from "ai";
-import { createGoogleGenerativeAI } from "@ai-sdk/google";
-import { createOpenAI } from "@ai-sdk/openai";
 import { createError, toError } from "../../errors/veryfront-error.js";
+import {
+  createGoogleEmbeddingRuntime,
+  createOpenAIEmbeddingRuntime,
+} from "../../provider/runtime-loader.js";
+import type { EmbeddingRuntime } from "../../provider/types.js";
 import {
   createVeryfrontCloudFetch,
   getVeryfrontCloudGatewayBaseUrl,
@@ -9,7 +11,7 @@ import {
   requireVeryfrontCloudBootstrap,
 } from "../../provider/veryfront-cloud/shared.js";
 
-export function createVeryfrontCloudEmbeddingModel(modelId: string): EmbeddingModel {
+export function createVeryfrontCloudEmbeddingModel(modelId: string): EmbeddingRuntime {
   const { provider, modelId: upstreamModelId } = parseVeryfrontCloudModelId(modelId, "embedding");
   const { apiBaseUrl, apiToken } = requireVeryfrontCloudBootstrap();
   const baseURL = getVeryfrontCloudGatewayBaseUrl(apiBaseUrl, provider);
@@ -17,20 +19,20 @@ export function createVeryfrontCloudEmbeddingModel(modelId: string): EmbeddingMo
 
   switch (provider) {
     case "openai":
-      return createOpenAI({
+      return createOpenAIEmbeddingRuntime({
         apiKey: apiToken,
         baseURL,
         name: "veryfront-cloud",
         fetch,
-      }).embedding(upstreamModelId);
+      }, upstreamModelId);
 
     case "google":
-      return createGoogleGenerativeAI({
+      return createGoogleEmbeddingRuntime({
         apiKey: apiToken,
         baseURL,
         name: "veryfront-cloud",
         fetch,
-      }).textEmbeddingModel(upstreamModelId);
+      }, upstreamModelId);
   }
 
   throw toError(

package/src/src/internal-agents/ag-ui-sse.ts

@@ -41,6 +41,18 @@ const agUiEventPayloadSchemas = {
     threadId: z.string().min(1),
     agentId: z.string().min(1),
   }),
+  StateSnapshot: z.object({
+    snapshot: z.record(z.string(), z.unknown()),
+  }),
+  MessagesSnapshot: z.object({
+    messages: z.array(z.object({
+      id: z.string().min(1),
+      role: z.enum(["user", "assistant", "system", "tool"]),
+      parts: z.array(z.record(z.string(), z.unknown())),
+      metadata: z.record(z.string(), z.unknown()).optional(),
+      createdAt: z.string().optional(),
+    })),
+  }),
   TextMessageStart: z.object({
     messageId: z.string().min(1),
     role: z.literal("assistant"),

package/src/src/markdown/index.ts

@@ -17,4 +17,4 @@ export {
   type CodeBlockProps,
   Markdown,
   type MarkdownProps,
-} from "../react/components/ai/markdown.js";
+} from "../react/components/chat/markdown.js";

package/src/src/modules/import-map/default-import-map.ts

@@ -33,8 +33,8 @@ function getVeryfrontSsrImportMap(): Record<string, string> {
   const react = `${base}/react/public.js${ssr}`;
 
   // Map veryfront/embedding to the React hooks submodule for SSR.
-  // The full embedding/index.ts imports heavy server-side code (vectorStore, ragStore,
-  // AI SDK) that fails to transform. SSR only needs the React hook (useUploads).
+  // The full embedding/index.ts imports heavy server-side code (vectorStore, ragStore)
+  // that fails to transform. SSR only needs the React hook (useUploads).
   const embedding = `${base}/embedding/react/index.js${ssr}`;
 
   return {

package/src/src/prompt/registry.ts

@@ -1,7 +1,7 @@
 import type { Prompt } from "./types.js";
 import { createError, toError } from "../errors/veryfront-error.js";
-import { ProjectScopedRegistryManager } from "../ai/registry-manager.js";
-import { ScopedRegistryFacade } from "../ai/registry-facade.js";
+import { ScopedRegistryFacade } from "../registry/scoped-registry-facade.js";
+import { ProjectScopedRegistryManager } from "../registry/project-scoped-registry-manager.js";
 
 const promptRegistryManager = new ProjectScopedRegistryManager<Prompt>("prompt");
 

package/src/src/provider/index.ts

@@ -1,18 +1,16 @@
 /**
- * AI SDK model provider registry.
+ * Provider registry.
  *
- * Maps "provider/model" strings to AI SDK LanguageModel instances.
- * Auto-initializes providers from environment variables on first use.
+ * Maps "provider/model" strings to framework-compatible model runtimes.
+ * Auto-initializes built-in providers from environment variables on first use.
  *
  * @module provider
  *
- * @example Register and resolve a model
+ * @example Resolve a model
  * ```ts
- * import { registerModelProvider, resolveModel } from "veryfront/provider";
- * import { createOpenAI } from "@ai-sdk/openai";
+ * import { resolveModel } from "veryfront/provider";
  *
- * registerModelProvider("openai", (id) => createOpenAI({ apiKey })(id));
- * const model = resolveModel("openai/gpt-4o");
+ * const model = resolveModel("veryfront-cloud/openai/gpt-5.2");
  * ```
  */
 import "../../_dnt.polyfills.js";
@@ -28,6 +26,7 @@ export {
   resolveModel,
 } from "./model-registry.js";
 export type { ModelProviderFactory } from "./model-registry.js";
+export type { ModelRuntime } from "./types.js";
 export {
   runWithVeryfrontCloudContext,
   runWithVeryfrontCloudContextAsync,

package/src/src/provider/local/{local-embedding-adapter.ts → embedding-runtime-adapter.ts}

@@ -1,25 +1,25 @@
 /**
- * AI SDK Adapter for Local Embedding Models
+ * Local Embedding Runtime Adapter
  *
  * Bridges `@huggingface/transformers` local embedding inference to the
- * AI SDK `EmbeddingModel` interface. This allows `embed()` and
+ * framework's current embedding runtime interface. This allows `embed()` and
  * `embedMany()` to work with local models seamlessly.
  *
  * @module provider/local
  */
 
-import type { EmbeddingModel } from "ai";
 import { embedTexts } from "./local-embedding-engine.js";
 import { DEFAULT_LOCAL_EMBEDDING_MODEL } from "./model-catalog.js";
+import type { EmbeddingRuntime } from "../types.js";
 
 /**
- * Create a local AI SDK EmbeddingModel for the given model ID.
+ * Create a local embedding runtime for the given model ID.
  *
- * The returned object implements the EmbeddingModelV2 interface, making it
- * compatible with all AI SDK embedding functions and the VeryFront
+ * The returned object implements the current embedding runtime interface, making it
+ * compatible with all framework embedding functions and the Veryfront
  * embedding/RAG primitives.
  */
-export function createLocalEmbeddingModel(modelId?: string): EmbeddingModel {
+export function createLocalEmbeddingModel(modelId?: string): EmbeddingRuntime {
   const resolvedId = modelId || DEFAULT_LOCAL_EMBEDDING_MODEL;
 
   return {
@@ -33,5 +33,5 @@ export function createLocalEmbeddingModel(modelId?: string): EmbeddingModel {
       const embeddings = await embedTexts(resolvedId, values);
       return { embeddings, usage: { tokens: 0 }, rawResponse: undefined, warnings: [] };
     },
-  } as EmbeddingModel;
+  };
 }

package/src/src/provider/local/{ai-sdk-adapter.ts → model-runtime-adapter.ts}

@@ -1,36 +1,36 @@
 /**
- * AI SDK Adapter for Local Models
+ * Local Model Runtime Adapter
  *
- * Bridges `@huggingface/transformers` local inference to the AI SDK
- * `LanguageModelV2` interface. This allows `streamText()` and
+ * Bridges `@huggingface/transformers` local inference to the framework's
+ * current model runtime substrate. This allows `streamText()` and
  * `generateText()` to work with local models seamlessly.
  *
  * @module provider/local
  */
 
-import type { LanguageModel } from "ai";
 import { generate, generateStream } from "./local-engine.js";
 import type { ChatMessage, GenerateOptions } from "./local-engine.js";
 import { DEFAULT_LOCAL_MODEL } from "./model-catalog.js";
 import { serverLogger } from "../../utils/index.js";
 import { fromError } from "../../errors/veryfront-error.js";
 import { throwIfLocalAIDisabled } from "./env.js";
+import type { ModelRuntime } from "../types.js";
 
 const logger = serverLogger.component("local-llm");
 
 /** Default maximum new tokens for local model generation */
 const DEFAULT_MAX_NEW_TOKENS = 512;
 
-/** Shape of a single message in the AI SDK LanguageModelV2 prompt array. */
+/** Shape of a single message in the current model-runtime prompt array. */
 interface PromptMessage {
   role: string;
   content: string | ReadonlyArray<{ type: string; text?: string }>;
 }
 
 /**
- * Convert AI SDK LanguageModelV2 prompt format to simple ChatMessage array.
+ * Convert model-runtime prompt format to simple ChatMessage array.
  *
- * The AI SDK prompt is an array of message objects with role and content arrays.
+ * The prompt is an array of message objects with role and content arrays.
  * We extract text content for the local model.
  */
 function convertPrompt(prompt: ReadonlyArray<PromptMessage>): ChatMessage[] {
@@ -75,7 +75,7 @@ interface LocalModelOptions {
   stopSequences?: string[];
 }
 
-/** Map AI SDK generation options to local engine GenerateOptions. */
+/** Map model-runtime generation options to local engine GenerateOptions. */
 function toGenerateOptions(options: LocalModelOptions): GenerateOptions {
   return {
     maxNewTokens: options.maxOutputTokens ?? DEFAULT_MAX_NEW_TOKENS,
@@ -87,16 +87,15 @@ function toGenerateOptions(options: LocalModelOptions): GenerateOptions {
 }
 
 /**
- * Create a local AI SDK LanguageModel for the given model ID.
+ * Create a local model runtime for the given model ID.
  *
- * The returned object implements the LanguageModelV2 interface, making it
- * compatible with all AI SDK functions (`streamText`, `generateText`, etc.)
- * and all VeryFront hooks (`useChat`).
+ * The returned object implements the current runtime interface, making it
+ * compatible with the framework execution path and related hooks.
  */
-export function createLocalModel(modelId?: string): LanguageModel {
+export function createLocalModel(modelId?: string): ModelRuntime {
   const resolvedId = modelId || DEFAULT_LOCAL_MODEL;
 
-  const model = {
+  return {
     /** Marker so ensureModelReady() can distinguish real local-engine models
      *  from mock/custom providers that happen to use provider:"local". */
     _isVfLocalModel: true as const,
@@ -200,6 +199,4 @@ export function createLocalModel(modelId?: string): LanguageModel {
       return { stream };
     },
   };
-
-  return model as LanguageModel;
 }