veryfront 0.1.498 → 0.1.500

package/esm/src/discovery/project-discovery-config.js

@@ -0,0 +1,33 @@
+export const DEFAULT_PROJECT_DISCOVERY_DIRS = {
+    toolDirs: ["tools"],
+    agentDirs: ["agents"],
+    skillDirs: ["skills"],
+    resourceDirs: ["resources"],
+    promptDirs: ["prompts"],
+    workflowDirs: ["workflows"],
+    taskDirs: ["tasks"],
+};
+function isDiscoveryEnabled(discovery) {
+    return discovery?.enabled ?? true;
+}
+function resolveDiscoveryPaths(discovery, defaultPaths) {
+    if (!isDiscoveryEnabled(discovery)) {
+        return [];
+    }
+    return discovery?.paths ?? defaultPaths;
+}
+export function createProjectDiscoveryConfig(input) {
+    const aiConfig = input.config?.ai;
+    return {
+        baseDir: input.projectDir,
+        toolDirs: resolveDiscoveryPaths(aiConfig?.tools?.discovery, DEFAULT_PROJECT_DISCOVERY_DIRS.toolDirs),
+        agentDirs: resolveDiscoveryPaths(aiConfig?.agents?.discovery, DEFAULT_PROJECT_DISCOVERY_DIRS.agentDirs),
+        skillDirs: resolveDiscoveryPaths(aiConfig?.skills?.discovery, DEFAULT_PROJECT_DISCOVERY_DIRS.skillDirs),
+        resourceDirs: resolveDiscoveryPaths(aiConfig?.resources?.discovery, DEFAULT_PROJECT_DISCOVERY_DIRS.resourceDirs),
+        promptDirs: resolveDiscoveryPaths(aiConfig?.prompts?.discovery, DEFAULT_PROJECT_DISCOVERY_DIRS.promptDirs),
+        workflowDirs: resolveDiscoveryPaths(aiConfig?.workflows?.discovery, DEFAULT_PROJECT_DISCOVERY_DIRS.workflowDirs),
+        taskDirs: resolveDiscoveryPaths(aiConfig?.tasks?.discovery, DEFAULT_PROJECT_DISCOVERY_DIRS.taskDirs),
+        fsAdapter: input.fsAdapter,
+        verbose: input.verbose ?? false,
+    };
+}

package/esm/src/embedding/resolve.js

@@ -2,7 +2,7 @@ import { createError, toError } from "../errors/veryfront-error.js";
 import { getGoogleGenAIEnvConfig, getOpenAIEnvConfig } from "../config/env.js";
 import { createLocalEmbeddingModel } from "../provider/local/embedding-runtime-adapter.js";
 import { tryResolve } from "../extensions/contracts.js";
-import { AIProviderRegistryName } from "../extensions/interfaces/index.js";
+import { LLMProviderRegistryName } from "../extensions/interfaces/index.js";
 import { createVeryfrontCloudEmbeddingModel } from "./veryfront-cloud/provider.js";
 const providers = new Map();
 let autoInitialized = false;
@@ -30,7 +30,7 @@ function autoInitializeFromEnv() {
                     message: "OPENAI_API_KEY not set. Set the environment variable or register a custom provider with registerEmbeddingProvider().",
                 }));
             }
-            const registry = tryResolve(AIProviderRegistryName);
+            const registry = tryResolve(LLMProviderRegistryName);
             const provider = registry?.get("openai");
             if (provider?.createEmbedding) {
                 return provider.createEmbedding(id, {
@@ -40,7 +40,7 @@ function autoInitializeFromEnv() {
             }
             throw toError(createError({
                 type: "config",
-                message: "OpenAI provider not installed. Add @veryfront/ext-openai to use openai/* embedding models.",
+                message: "OpenAI provider not installed. Add @veryfront/ext-llm-openai to use openai/* embedding models.",
             }));
         });
     }
@@ -53,7 +53,7 @@ function autoInitializeFromEnv() {
                     message: "GOOGLE_API_KEY (or GOOGLE_GENERATIVE_AI_API_KEY) not set. Set the environment variable or register a custom provider with registerEmbeddingProvider().",
                 }));
             }
-            const registry = tryResolve(AIProviderRegistryName);
+            const registry = tryResolve(LLMProviderRegistryName);
             const provider = registry?.get("google");
             if (provider?.createEmbedding) {
                 return provider.createEmbedding(id, {
@@ -62,7 +62,7 @@ function autoInitializeFromEnv() {
             }
             throw toError(createError({
                 type: "config",
-                message: "Google provider not installed. Add @veryfront/ext-google to use google/* embedding models.",
+                message: "Google provider not installed. Add @veryfront/ext-llm-google to use google/* embedding models.",
             }));
         });
     }

package/esm/src/embedding/veryfront-cloud/provider.js

@@ -1,6 +1,6 @@
 import { createError, toError } from "../../errors/veryfront-error.js";
 import { tryResolve } from "../../extensions/contracts.js";
-import { AIProviderRegistryName } from "../../extensions/interfaces/index.js";
+import { LLMProviderRegistryName } from "../../extensions/interfaces/index.js";
 import { createVeryfrontCloudFetch, getVeryfrontCloudGatewayBaseUrl, parseVeryfrontCloudModelId, requireVeryfrontCloudBootstrap, } from "../../provider/veryfront-cloud/shared.js";
 import { createVeryfrontCloudOpenAIEmbeddingModel } from "../../provider/veryfront-cloud/openai.js";
 export function createVeryfrontCloudEmbeddingModel(modelId) {
@@ -16,7 +16,7 @@ export function createVeryfrontCloudEmbeddingModel(modelId) {
                 fetch,
             });
         case "google": {
-            const registry = tryResolve(AIProviderRegistryName);
+            const registry = tryResolve(LLMProviderRegistryName);
             const google = registry?.get("google");
             if (google?.createEmbedding) {
                 return google.createEmbedding(upstreamModelId, {
@@ -28,7 +28,7 @@ export function createVeryfrontCloudEmbeddingModel(modelId) {
             }
             throw toError(createError({
                 type: "config",
-                message: "Google provider not installed. Add @veryfront/ext-google to use google/* embedding models via veryfront-cloud.",
+                message: "Google provider not installed. Add @veryfront/ext-llm-google to use google/* embedding models via veryfront-cloud.",
             }));
         }
     }

package/esm/src/extensions/builtin-extensions.d.ts

@@ -1,5 +1,5 @@
 import type { ResolvedExtension } from "./types.js";
-import type { AIProviderRegistry } from "./interfaces/index.js";
-export declare function ensureBuiltinAIProviders(): AIProviderRegistry;
+import type { LLMProviderRegistry } from "./llm/index.js";
+export declare function ensureBuiltinLLMProviders(): LLMProviderRegistry;
 export declare function createBuiltinExtensions(): ResolvedExtension[];
 //# sourceMappingURL=builtin-extensions.d.ts.map

package/esm/src/extensions/builtin-extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-extensions.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/builtin-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EAAc,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAsD5E,wBAAgB,wBAAwB,IAAI,kBAAkB,CAM7D;AAiCD,wBAAgB,uBAAuB,IAAI,iBAAiB,EAAE,CA6B7D"}
+{"version":3,"file":"builtin-extensions.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/builtin-extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAqDvE,wBAAgB,yBAAyB,IAAI,mBAAmB,CAM/D;AAiCD,wBAAgB,uBAAuB,IAAI,iBAAiB,EAAE,CA6B7D"}

package/esm/src/extensions/builtin-extensions.js

@@ -1,53 +1,52 @@
 import { register, tryResolve } from "./contracts.js";
-import { AIProviderRegistryName } from "./interfaces/index.js";
-import { createAIProviderRegistry } from "./registries/ai-provider-registry.js";
-import { OpenAIProvider } from "../../extensions/ext-openai/src/index.js";
-import { AnthropicProvider } from "../../extensions/ext-anthropic/src/index.js";
-import { GoogleProvider } from "../../extensions/ext-google/src/index.js";
+import { createLLMProviderRegistry, LLMProviderRegistryName } from "./llm/index.js";
+import { OpenAIProvider } from "../../extensions/ext-llm-openai/src/index.js";
+import { AnthropicProvider } from "../../extensions/ext-llm-anthropic/src/index.js";
+import { GoogleProvider } from "../../extensions/ext-llm-google/src/index.js";
 import extEsbuild from "../../extensions/ext-esbuild/src/index.js";
 import extBabel from "../../extensions/ext-babel/src/index.js";
 import extMdx from "../../extensions/ext-mdx/src/index.js";
 import extTailwind from "../../extensions/ext-tailwind/src/index.js";
 import extNodeCompat from "../../extensions/ext-node-compat/src/index.js";
-const BUILTIN_AI_PROVIDERS = [
+const BUILTIN_LLM_PROVIDERS = [
     {
-        extensionName: "ext-openai",
-        origin: "veryfront/ext-openai",
+        extensionName: "ext-llm-openai",
+        origin: "veryfront/ext-llm-openai",
         provider: () => new OpenAIProvider(),
     },
     {
-        extensionName: "ext-anthropic",
-        origin: "veryfront/ext-anthropic",
+        extensionName: "ext-llm-anthropic",
+        origin: "veryfront/ext-llm-anthropic",
         provider: () => new AnthropicProvider(),
     },
     {
-        extensionName: "ext-google",
-        origin: "veryfront/ext-google",
+        extensionName: "ext-llm-google",
+        origin: "veryfront/ext-llm-google",
         provider: () => new GoogleProvider(),
     },
 ];
-function getOrCreateAIProviderRegistry() {
-    const existing = tryResolve(AIProviderRegistryName);
+function getOrCreateLLMProviderRegistry() {
+    const existing = tryResolve(LLMProviderRegistryName);
     if (existing)
         return existing;
-    const registry = createAIProviderRegistry();
-    register(AIProviderRegistryName, registry);
+    const registry = createLLMProviderRegistry();
+    register(LLMProviderRegistryName, registry);
     return registry;
 }
-function registerBuiltinAIProvider(registry, provider) {
+function registerBuiltinLLMProvider(registry, provider) {
     if (registry.has(provider.id))
         return false;
     registry.register(provider);
     return true;
 }
-export function ensureBuiltinAIProviders() {
-    const registry = getOrCreateAIProviderRegistry();
-    for (const definition of BUILTIN_AI_PROVIDERS) {
-        registerBuiltinAIProvider(registry, definition.provider());
+export function ensureBuiltinLLMProviders() {
+    const registry = getOrCreateLLMProviderRegistry();
+    for (const definition of BUILTIN_LLM_PROVIDERS) {
+        registerBuiltinLLMProvider(registry, definition.provider());
     }
     return registry;
 }
-function createBuiltinAIProviderExtension(definition) {
+function createBuiltinLLMProviderExtension(definition) {
     const provider = definition.provider();
     let didRegister = false;
     return {
@@ -56,17 +55,17 @@ function createBuiltinAIProviderExtension(definition) {
         extension: {
             name: definition.extensionName,
             version: "0.1.0",
-            capabilities: [{ type: "contract", name: `AIProvider:${provider.id}` }],
+            capabilities: [{ type: "contract", name: `LLMProvider:${provider.id}` }],
             setup(ctx) {
-                const registry = ctx.require(AIProviderRegistryName);
-                didRegister = registerBuiltinAIProvider(registry, provider);
+                const registry = ctx.require(LLMProviderRegistryName);
+                didRegister = registerBuiltinLLMProvider(registry, provider);
                 if (didRegister) {
                     ctx.logger.info(`[${definition.extensionName}] ${provider.id} provider registered`);
                 }
             },
             teardown() {
                 if (didRegister) {
-                    const registry = tryResolve(AIProviderRegistryName);
+                    const registry = tryResolve(LLMProviderRegistryName);
                     registry?.unregister(provider.id);
                     didRegister = false;
                 }
@@ -101,6 +100,6 @@ export function createBuiltinExtensions() {
             origin: "veryfront/ext-node-compat",
             extension: extNodeCompat(),
         },
-        ...BUILTIN_AI_PROVIDERS.map(createBuiltinAIProviderExtension),
+        ...BUILTIN_LLM_PROVIDERS.map(createBuiltinLLMProviderExtension),
     ];
 }

package/esm/src/extensions/interfaces/index.d.ts

@@ -1,7 +1,11 @@
 /**
- * Barrel export for all extension contract interfaces.
+ * Back-compat barrel for extension contract interfaces.
  *
- * Every export is a pure TypeScript type -- no runtime code is emitted.
+ * Re-exports the category-folder modules under `../{ai,auth,cache,...}/`.
+ * Most entries are interface re-exports (erased at runtime); the
+ * `LLMProviderRegistryName` re-export is a runtime value (a const).
+ * This file will be deleted once all consumers migrate to the
+ * `veryfront/extensions/<category>` paths.
  *
  * @module extensions/interfaces
  */
@@ -15,9 +19,9 @@ export type { CompilationMode, CompilationTarget, ContentCompileOptions, Content
 export type { DatabaseClient, QueryResult } from "./database-client.js";
 export type { AuthProvider, SignOptions, TokenHeader, TokenPayload, VerifyOptions, } from "./auth-provider.js";
 export type { SpanData, TracerProvider, TracingExporter } from "./tracing-exporter.js";
-export type { AIProvider, AIProviderConfig, AIProviderRegistry } from "./ai-provider.js";
-export { AIProviderRegistryName } from "./ai-provider.js";
-export type { EmbeddingOptions, EmbeddingProvider, EmbeddingResult } from "./embedding-provider.js";
+export type { LLMProvider, LLMProviderConfig, LLMProviderRegistry } from "../llm/index.js";
+export { LLMProviderRegistryName } from "../llm/index.js";
+export type { EmbeddingOptions, EmbeddingProvider, EmbeddingResult } from "../llm/index.js";
 export type { ASTNode, CodeParser, GenerateOptions, GenerateResult, InjectJsxNodePositionsOptions, NodePath, ParseOptions, TraverseVisitor, } from "./code-parser.js";
 export type { InferSchema, InferShape, Schema, SchemaFactory, SchemaValidator, SchemaValidatorCoerce, ValidationFailure, ValidationIssue, ValidationResult, ValidationSuccess, } from "./schema-validator.js";
 export type { KreuzbergExtractor, NodeCompat, NodeCompatSqliteDatabase, SqliteStatement, } from "./node-compat.js";

package/esm/src/extensions/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,4BAA4B,CAAC;AAEpC,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,MAAM,EACN,QAAQ,EACR,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGtE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGhG,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxE,YAAY,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGvF,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGpG,YAAY,EACV,OAAO,EACP,UAAU,EACV,eAAe,EACf,cAAc,EACd,6BAA6B,EAC7B,QAAQ,EACR,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,UAAU,EACV,MAAM,EACN,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,4BAA4B,CAAC;AAEpC,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,MAAM,EACN,QAAQ,EACR,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGtE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGhG,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxE,YAAY,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGvF,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG5F,YAAY,EACV,OAAO,EACP,UAAU,EACV,eAAe,EACf,cAAc,EACd,6BAA6B,EAC7B,QAAQ,EACR,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,UAAU,EACV,MAAM,EACN,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/esm/src/extensions/interfaces/index.js

@@ -1,10 +1,14 @@
 /**
- * Barrel export for all extension contract interfaces.
+ * Back-compat barrel for extension contract interfaces.
  *
- * Every export is a pure TypeScript type -- no runtime code is emitted.
+ * Re-exports the category-folder modules under `../{ai,auth,cache,...}/`.
+ * Most entries are interface re-exports (erased at runtime); the
+ * `LLMProviderRegistryName` re-export is a runtime value (a const).
+ * This file will be deleted once all consumers migrate to the
+ * `veryfront/extensions/<category>` paths.
  *
  * @module extensions/interfaces
  */
 // Bundler
 import "../../../_dnt.polyfills.js";
-export { AIProviderRegistryName } from "./ai-provider.js";
+export { LLMProviderRegistryName } from "../llm/index.js";

package/esm/src/extensions/{interfaces → llm}/embedding-provider.d.ts

@@ -3,7 +3,7 @@
  *
  * Default implementation: `@veryfront/ext-embeddings`
  *
- * @module extensions/interfaces/embedding-provider
+ * @module extensions/llm/embedding-provider
  */
 /** Options passed to {@link EmbeddingProvider.embed}. */
 export interface EmbeddingOptions {

package/esm/src/extensions/llm/embedding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-provider.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/llm/embedding-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;IACvB,8BAA8B;IAC9B,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5D"}

package/esm/src/extensions/{interfaces → llm}/embedding-provider.js

@@ -3,6 +3,6 @@
  *
  * Default implementation: `@veryfront/ext-embeddings`
  *
- * @module extensions/interfaces/embedding-provider
+ * @module extensions/llm/embedding-provider
  */
 export {};

package/esm/src/extensions/llm/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LLM category barrel — provider, embedding, and registry contracts.
+ *
+ * Interfaces re-exported with `export type { ... }` because Deno `--no-check`
+ * transpiles each file in isolation and would otherwise emit a runtime value
+ * re-export that fails ESM resolution. Reserve plain `export { ... }` for
+ * runtime values.
+ *
+ * @module extensions/llm
+ */
+import "../../../_dnt.polyfills.js";
+export { LLMProviderRegistryName } from "./llm-provider.js";
+export type { LLMProvider, LLMProviderConfig, LLMProviderRegistry } from "./llm-provider.js";
+export type { EmbeddingOptions, EmbeddingProvider, EmbeddingResult } from "./embedding-provider.js";
+export { createLLMProviderRegistry } from "./llm-provider-registry.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/src/extensions/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/llm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,4BAA4B,CAAC;AAGpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7F,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC"}

package/esm/src/extensions/llm/index.js

@@ -0,0 +1,13 @@
+/**
+ * LLM category barrel — provider, embedding, and registry contracts.
+ *
+ * Interfaces re-exported with `export type { ... }` because Deno `--no-check`
+ * transpiles each file in isolation and would otherwise emit a runtime value
+ * re-export that fails ESM resolution. Reserve plain `export { ... }` for
+ * runtime values.
+ *
+ * @module extensions/llm
+ */
+import "../../../_dnt.polyfills.js";
+export { LLMProviderRegistryName } from "./llm-provider.js";
+export { createLLMProviderRegistry } from "./llm-provider-registry.js";

package/esm/src/extensions/llm/llm-provider-registry.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Default Map-backed implementation of the LLMProviderRegistry contract.
+ *
+ * Preserves insertion order via Map (used by `list()`). Duplicate ids are
+ * first-write-wins so higher-priority extensions keep their provider binding.
+ *
+ * @module extensions/llm/llm-provider-registry
+ */
+import type { LLMProviderRegistry } from "./llm-provider.js";
+export declare function createLLMProviderRegistry(): LLMProviderRegistry;
+//# sourceMappingURL=llm-provider-registry.d.ts.map

package/esm/src/extensions/llm/llm-provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-registry.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/llm/llm-provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAsC1E,wBAAgB,yBAAyB,IAAI,mBAAmB,CAE/D"}

package/esm/src/extensions/{registries/ai-provider-registry.js → llm/llm-provider-registry.js}

@@ -1,12 +1,12 @@
 /**
- * Default Map-backed implementation of the AIProviderRegistry contract.
+ * Default Map-backed implementation of the LLMProviderRegistry contract.
  *
  * Preserves insertion order via Map (used by `list()`). Duplicate ids are
  * first-write-wins so higher-priority extensions keep their provider binding.
  *
- * @module extensions/registries/ai-provider-registry
+ * @module extensions/llm/llm-provider-registry
  */
-class AIProviderRegistryImpl {
+class LLMProviderRegistryImpl {
     providers = new Map();
     register(provider) {
         if (this.providers.has(provider.id)) {
@@ -25,7 +25,7 @@ class AIProviderRegistryImpl {
         if (p)
             return p;
         const known = [...this.providers.keys()].join(", ") || "(none)";
-        throw new Error(`No AIProvider registered for "${id}". Known providers: ${known}.`);
+        throw new Error(`No LLMProvider registered for "${id}". Known providers: ${known}.`);
     }
     has(id) {
         return this.providers.has(id);
@@ -34,6 +34,6 @@ class AIProviderRegistryImpl {
         return [...this.providers.values()];
     }
 }
-export function createAIProviderRegistry() {
-    return new AIProviderRegistryImpl();
+export function createLLMProviderRegistry() {
+    return new LLMProviderRegistryImpl();
 }

package/esm/src/extensions/{interfaces/ai-provider.d.ts → llm/llm-provider.d.ts}

@@ -1,17 +1,17 @@
 /**
  * Contract interface for LLM provider extensions.
  *
- * A single `AIProviderRegistry` impl lives in the contract registry under
- * {@link AIProviderRegistryName}. Each provider extension resolves the
+ * A single `LLMProviderRegistry` impl lives in the contract registry under
+ * {@link LLMProviderRegistryName}. Each provider extension resolves the
  * registry in its `setup()` and calls `registry.register(provider)`.
  * Core consumers (model-registry, veryfront-cloud) resolve the registry
  * and dispatch on provider id parsed from `"provider/model"` strings.
  *
- * @module extensions/interfaces/ai-provider
+ * @module extensions/llm/llm-provider
  */
 import type { EmbeddingRuntime, ModelRuntime } from "../../provider/types.js";
 /** Config passed to any provider's create* method. */
-export interface AIProviderConfig {
+export interface LLMProviderConfig {
     /** API credential — maps to OpenAI `apiKey`, Anthropic `authToken`, Google `apiKey` internally. */
     credential: string;
     /** Override the provider's base URL (e.g. Azure OpenAI, self-hosted gateway). */
@@ -25,26 +25,26 @@ export interface AIProviderConfig {
 }
 /**
  * An LLM provider implementation. Extensions register one of these with the
- * {@link AIProviderRegistry} during setup(). `createModel` is required;
+ * {@link LLMProviderRegistry} during setup(). `createModel` is required;
  * `createEmbedding` and `createResponses` are optional and absent on
  * providers that don't support them.
  */
-export interface AIProvider {
+export interface LLMProvider {
     /** Stable id used in model strings: "openai" / "anthropic" / "google". */
     readonly id: string;
-    createModel(modelId: string, config: AIProviderConfig): ModelRuntime;
-    createEmbedding?(modelId: string, config: AIProviderConfig): EmbeddingRuntime;
-    createResponses?(modelId: string, config: AIProviderConfig): ModelRuntime;
+    createModel(modelId: string, config: LLMProviderConfig): ModelRuntime;
+    createEmbedding?(modelId: string, config: LLMProviderConfig): EmbeddingRuntime;
+    createResponses?(modelId: string, config: LLMProviderConfig): ModelRuntime;
 }
 /** Registry contract. Single impl created at bootstrap. */
-export interface AIProviderRegistry {
-    register(provider: AIProvider): void;
+export interface LLMProviderRegistry {
+    register(provider: LLMProvider): void;
     unregister(id: string): void;
-    get(id: string): AIProvider | undefined;
-    require(id: string): AIProvider;
-    list(): AIProvider[];
+    get(id: string): LLMProvider | undefined;
+    require(id: string): LLMProvider;
+    list(): LLMProvider[];
     has(id: string): boolean;
 }
 /** Contract name used for `resolve()` / `provide()`. */
-export declare const AIProviderRegistryName: "AIProviderRegistry";
-//# sourceMappingURL=ai-provider.d.ts.map
+export declare const LLMProviderRegistryName: "LLMProviderRegistry";
+//# sourceMappingURL=llm-provider.d.ts.map

package/esm/src/extensions/llm/llm-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../../../../src/src/extensions/llm/llm-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE9E,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,mGAAmG;IACnG,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAAC;IACtE,eAAe,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAAC;IAC/E,eAAe,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAAC;CAC5E;AAED,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACzC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAAC;IACjC,IAAI,IAAI,WAAW,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,wDAAwD;AACxD,eAAO,MAAM,uBAAuB,EAAG,qBAA8B,CAAC"}

package/esm/src/extensions/{interfaces/ai-provider.js → llm/llm-provider.js}

@@ -1,13 +1,13 @@
 /**
  * Contract interface for LLM provider extensions.
  *
- * A single `AIProviderRegistry` impl lives in the contract registry under
- * {@link AIProviderRegistryName}. Each provider extension resolves the
+ * A single `LLMProviderRegistry` impl lives in the contract registry under
+ * {@link LLMProviderRegistryName}. Each provider extension resolves the
  * registry in its `setup()` and calls `registry.register(provider)`.
  * Core consumers (model-registry, veryfront-cloud) resolve the registry
  * and dispatch on provider id parsed from `"provider/model"` strings.
  *
- * @module extensions/interfaces/ai-provider
+ * @module extensions/llm/llm-provider
  */
 /** Contract name used for `resolve()` / `provide()`. */
-export const AIProviderRegistryName = "AIProviderRegistry";
+export const LLMProviderRegistryName = "LLMProviderRegistry";

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

@@ -11,7 +11,7 @@ export declare class ExtensionLoader {
     /**
      * Register contracts that will be re-applied after each `setupAll()`
      * teardown pass. Used by `orchestrateExtensions()` to seed infrastructure
-     * (e.g. `AIProviderRegistry`) before per-extension `setup()` runs.
+     * (e.g. `LLMProviderRegistry`) before per-extension `setup()` runs.
      */
     primeContracts(contracts: Record<string, unknown>): void;
     constructor(logger: ExtensionLogger);

package/esm/src/extensions/loader.js

@@ -14,7 +14,7 @@ export class ExtensionLoader {
     /**
      * Register contracts that will be re-applied after each `setupAll()`
      * teardown pass. Used by `orchestrateExtensions()` to seed infrastructure
-     * (e.g. `AIProviderRegistry`) before per-extension `setup()` runs.
+     * (e.g. `LLMProviderRegistry`) before per-extension `setup()` runs.
      */
     primeContracts(contracts) {
         this.primed = { ...this.primed, ...contracts };

package/esm/src/extensions/orchestrate.d.ts

@@ -27,7 +27,7 @@ export interface OrchestrateOptions {
     primeContracts?: Record<string, unknown>;
     /** Built-in extensions shipped with the framework. Lowest priority — any
      *  project, package, or config extension with the same name overrides them.
-     *  Users can disable them via `{ name: "ext-anthropic", enabled: false }`. */
+     *  Users can disable them via `{ name: "ext-llm-anthropic", enabled: false }`. */
     builtinExtensions?: ResolvedExtension[];
     /** @internal Override discovery functions in tests. */
     discovery?: {

package/esm/src/extensions/orchestrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,gBAAgB,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EAEf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAChD,MAAM,EAAE,eAAe,CAAC;IACxB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC;;kFAE8E;IAC9E,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC,uDAAuD;IACvD,SAAS,CAAC,EAAE;QACV,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,uBAAuB,EAAE,OAAO,gBAAgB,CAAC,uBAAuB,CAAC;QACzE,eAAe,EAAE,OAAO,gBAAgB,CAAC,eAAe,CAAC;KAC1D,CAAC;IACF,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,kBAAkB,CAAC;CACzC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAgF1B"}
+{"version":3,"file":"orchestrate.d.ts","sourceRoot":"","sources":["../../../src/src/extensions/orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,gBAAgB,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAEV,oBAAoB,EACpB,eAAe,EAEf,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAChD,MAAM,EAAE,eAAe,CAAC;IACxB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC;;sFAEkF;IAClF,iBAAiB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACxC,uDAAuD;IACvD,SAAS,CAAC,EAAE;QACV,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,yBAAyB,EAAE,OAAO,gBAAgB,CAAC,yBAAyB,CAAC;QAC7E,uBAAuB,EAAE,OAAO,gBAAgB,CAAC,uBAAuB,CAAC;QACzE,eAAe,EAAE,OAAO,gBAAgB,CAAC,eAAe,CAAC;KAC1D,CAAC;IACF,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,kBAAkB,CAAC;CACzC;AAmCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAgF1B"}

package/esm/src/extensions/recommendations.js

@@ -15,10 +15,10 @@ const recommendations = new Map([
     ["DatabaseClient", "@veryfront/ext-postgres"],
     ["AuthProvider", "@veryfront/ext-jwt"],
     ["TracingExporter", "@veryfront/ext-opentelemetry"],
-    ["AIProviderRegistry", "@veryfront/ext-openai"],
-    ["AIProvider:openai", "@veryfront/ext-openai"],
-    ["AIProvider:anthropic", "@veryfront/ext-anthropic"],
-    ["AIProvider:google", "@veryfront/ext-google"],
+    ["LLMProviderRegistry", "@veryfront/ext-llm-openai"],
+    ["LLMProvider:openai", "@veryfront/ext-llm-openai"],
+    ["LLMProvider:anthropic", "@veryfront/ext-llm-anthropic"],
+    ["LLMProvider:google", "@veryfront/ext-llm-google"],
     ["EmbeddingProvider", "@veryfront/ext-embeddings"],
     ["CodeParser", "@veryfront/ext-babel"],
     ["SchemaValidator", "@veryfront/ext-zod"],

package/esm/src/provider/local/env.d.ts

@@ -1,5 +1,5 @@
 /**
- * Cross-platform environment helpers for local AI provider.
+ * Cross-platform environment helpers for local LLM provider.
  *
  * Uses the platform compat layer so all local-AI checks go through
  * a single function — no duplicated env access patterns.

package/esm/src/provider/local/env.js

@@ -1,5 +1,5 @@
 /**
- * Cross-platform environment helpers for local AI provider.
+ * Cross-platform environment helpers for local LLM provider.
  *
  * Uses the platform compat layer so all local-AI checks go through
  * a single function — no duplicated env access patterns.

package/esm/src/provider/model-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../src/src/provider/model-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC;AAOrE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAEN;AAmKD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAWvD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CA6D9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAGtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}
+{"version":3,"file":"model-registry.d.ts","sourceRoot":"","sources":["../../../src/src/provider/model-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,CAAC;AAOrE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAEN;AAoKD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAWvD;AAMD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CA6D9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAGtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}