veryfront 0.1.498 → 0.1.500

package/src/src/chat/provider-errors.ts

@@ -7,7 +7,7 @@ export interface ParsedProviderError {
 
 const DEFAULT_EXTERNAL_SERVICE_ERROR = {
   code: "EXTERNAL_SERVICE_ERROR",
-  message: "AI provider service error",
+  message: "LLM provider service error",
 } as const;
 
 function isErrorRecord(value: unknown): value is Record<string, unknown> {
@@ -81,7 +81,7 @@ function parseKnownProviderBody(body: unknown): ParsedProviderError | null {
       code: "OVERLOADED_ERROR",
       message: typeof body.message === "string"
         ? body.message
-        : "The AI provider is currently overloaded",
+        : "The LLM provider is currently overloaded",
     };
   }
 
@@ -193,7 +193,7 @@ function parseProviderErrorInner(error: unknown, seen: WeakSet<object>): ParsedP
       return { code: "INSUFFICIENT_CREDITS", message: "Insufficient AI credits", status: 402 };
     }
     if (normalizedMessage.includes("overload") || normalizedMessage.includes("capacity")) {
-      return { code: "OVERLOADED_ERROR", message: "The AI provider is currently overloaded" };
+      return { code: "OVERLOADED_ERROR", message: "The LLM provider is currently overloaded" };
     }
     if (
       normalizedMessage.includes("rate limit") ||

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

@@ -426,6 +426,54 @@ export const veryfrontConfigSchema = z
           })
           .partial()
           .optional(),
+        resources: z
+          .object({
+            discovery: z
+              .object({
+                enabled: z.boolean().optional(),
+                paths: z.array(z.string()).optional(),
+              })
+              .partial()
+              .optional(),
+          })
+          .partial()
+          .optional(),
+        prompts: z
+          .object({
+            discovery: z
+              .object({
+                enabled: z.boolean().optional(),
+                paths: z.array(z.string()).optional(),
+              })
+              .partial()
+              .optional(),
+          })
+          .partial()
+          .optional(),
+        workflows: z
+          .object({
+            discovery: z
+              .object({
+                enabled: z.boolean().optional(),
+                paths: z.array(z.string()).optional(),
+              })
+              .partial()
+              .optional(),
+          })
+          .partial()
+          .optional(),
+        tasks: z
+          .object({
+            discovery: z
+              .object({
+                enabled: z.boolean().optional(),
+                paths: z.array(z.string()).optional(),
+              })
+              .partial()
+              .optional(),
+          })
+          .partial()
+          .optional(),
         mcp: z
           .object({
             enabled: z.boolean().optional(),

package/src/src/discovery/index.ts

@@ -19,6 +19,10 @@ export type {
 
 // Re-export main discovery function
 export { discoverAll } from "./discovery-engine.js";
+export {
+  createProjectDiscoveryConfig,
+  DEFAULT_PROJECT_DISCOVERY_DIRS,
+} from "./project-discovery-config.js";
 
 // Re-export utilities
 export { clearTrackedAgents, filenameToId, filePathToPattern } from "./discovery-utils.js";

package/src/src/discovery/project-discovery-config.ts

@@ -0,0 +1,89 @@
+import type { VeryfrontConfig } from "../config/index.js";
+import type { FileSystemAdapter } from "../platform/adapters/base.js";
+import type { DiscoveryConfig } from "./types.js";
+
+export const DEFAULT_PROJECT_DISCOVERY_DIRS = {
+  toolDirs: ["tools"],
+  agentDirs: ["agents"],
+  skillDirs: ["skills"],
+  resourceDirs: ["resources"],
+  promptDirs: ["prompts"],
+  workflowDirs: ["workflows"],
+  taskDirs: ["tasks"],
+};
+
+type DiscoverySettings = {
+  enabled?: boolean;
+  paths?: string[];
+};
+
+type ProjectDiscoveryConfigInput = {
+  projectDir: string;
+  config?: VeryfrontConfig | null;
+  fsAdapter?: FileSystemAdapter;
+  verbose?: boolean;
+};
+
+export type ProjectDiscoveryConfig = DiscoveryConfig & {
+  toolDirs: string[];
+  agentDirs: string[];
+  skillDirs: string[];
+  resourceDirs: string[];
+  promptDirs: string[];
+  workflowDirs: string[];
+  taskDirs: string[];
+};
+
+function isDiscoveryEnabled(discovery: DiscoverySettings | undefined): boolean {
+  return discovery?.enabled ?? true;
+}
+
+function resolveDiscoveryPaths(
+  discovery: DiscoverySettings | undefined,
+  defaultPaths: string[],
+): string[] {
+  if (!isDiscoveryEnabled(discovery)) {
+    return [];
+  }
+  return discovery?.paths ?? defaultPaths;
+}
+
+export function createProjectDiscoveryConfig(
+  input: ProjectDiscoveryConfigInput,
+): ProjectDiscoveryConfig {
+  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/src/src/embedding/resolve.ts

@@ -3,8 +3,8 @@ import { getGoogleGenAIEnvConfig, getOpenAIEnvConfig } from "../config/env.js";
 import { createLocalEmbeddingModel } from "../provider/local/embedding-runtime-adapter.js";
 import type { EmbeddingRuntime } from "../provider/types.js";
 import { tryResolve } from "../extensions/contracts.js";
-import type { AIProviderRegistry } from "../extensions/interfaces/index.js";
-import { AIProviderRegistryName } from "../extensions/interfaces/index.js";
+import type { LLMProviderRegistry } from "../extensions/interfaces/index.js";
+import { LLMProviderRegistryName } from "../extensions/interfaces/index.js";
 import { createVeryfrontCloudEmbeddingModel } from "./veryfront-cloud/provider.js";
 
 type EmbeddingProviderFactory = (modelId: string) => EmbeddingRuntime;
@@ -43,7 +43,7 @@ function autoInitializeFromEnv(): void {
           }),
         );
       }
-      const registry = tryResolve<AIProviderRegistry>(AIProviderRegistryName);
+      const registry = tryResolve<LLMProviderRegistry>(LLMProviderRegistryName);
       const provider = registry?.get("openai");
       if (provider?.createEmbedding) {
         return provider.createEmbedding(id, {
@@ -55,7 +55,7 @@ function autoInitializeFromEnv(): void {
         createError({
           type: "config",
           message:
-            "OpenAI provider not installed. Add @veryfront/ext-openai to use openai/* embedding models.",
+            "OpenAI provider not installed. Add @veryfront/ext-llm-openai to use openai/* embedding models.",
         }),
       );
     });
@@ -73,7 +73,7 @@ function autoInitializeFromEnv(): void {
           }),
         );
       }
-      const registry = tryResolve<AIProviderRegistry>(AIProviderRegistryName);
+      const registry = tryResolve<LLMProviderRegistry>(LLMProviderRegistryName);
       const provider = registry?.get("google");
       if (provider?.createEmbedding) {
         return provider.createEmbedding(id, {
@@ -84,7 +84,7 @@ function autoInitializeFromEnv(): void {
         createError({
           type: "config",
           message:
-            "Google provider not installed. Add @veryfront/ext-google to use google/* embedding models.",
+            "Google provider not installed. Add @veryfront/ext-llm-google to use google/* embedding models.",
         }),
       );
     });

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

@@ -1,8 +1,8 @@
 import { createError, toError } from "../../errors/veryfront-error.js";
 import type { EmbeddingRuntime } from "../../provider/types.js";
 import { tryResolve } from "../../extensions/contracts.js";
-import type { AIProviderRegistry } from "../../extensions/interfaces/index.js";
-import { AIProviderRegistryName } from "../../extensions/interfaces/index.js";
+import type { LLMProviderRegistry } from "../../extensions/interfaces/index.js";
+import { LLMProviderRegistryName } from "../../extensions/interfaces/index.js";
 import {
   createVeryfrontCloudFetch,
   getVeryfrontCloudGatewayBaseUrl,
@@ -26,7 +26,7 @@ export function createVeryfrontCloudEmbeddingModel(modelId: string): EmbeddingRu
       });
 
     case "google": {
-      const registry = tryResolve<AIProviderRegistry>(AIProviderRegistryName);
+      const registry = tryResolve<LLMProviderRegistry>(LLMProviderRegistryName);
       const google = registry?.get("google");
       if (google?.createEmbedding) {
         return google.createEmbedding(upstreamModelId, {
@@ -40,7 +40,7 @@ export function createVeryfrontCloudEmbeddingModel(modelId: string): EmbeddingRu
         createError({
           type: "config",
           message:
-            "Google provider not installed. Add @veryfront/ext-google to use google/* embedding models via veryfront-cloud.",
+            "Google provider not installed. Add @veryfront/ext-llm-google to use google/* embedding models via veryfront-cloud.",
         }),
       );
     }

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

@@ -1,69 +1,68 @@
 import type { ResolvedExtension } from "./types.js";
 import { register, tryResolve } from "./contracts.js";
-import type { AIProvider, AIProviderRegistry } from "./interfaces/index.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 type { LLMProvider, LLMProviderRegistry } from "./llm/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";
 
-type BuiltinAIProviderDefinition = {
+type BuiltinLLMProviderDefinition = {
   extensionName: string;
   origin: string;
-  provider: () => AIProvider;
+  provider: () => LLMProvider;
 };
 
-const BUILTIN_AI_PROVIDERS: BuiltinAIProviderDefinition[] = [
+const BUILTIN_LLM_PROVIDERS: BuiltinLLMProviderDefinition[] = [
   {
-    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(): AIProviderRegistry {
-  const existing = tryResolve<AIProviderRegistry>(AIProviderRegistryName);
+function getOrCreateLLMProviderRegistry(): LLMProviderRegistry {
+  const existing = tryResolve<LLMProviderRegistry>(LLMProviderRegistryName);
   if (existing) return existing;
 
-  const registry = createAIProviderRegistry();
-  register(AIProviderRegistryName, registry);
+  const registry = createLLMProviderRegistry();
+  register(LLMProviderRegistryName, registry);
   return registry;
 }
 
-function registerBuiltinAIProvider(
-  registry: AIProviderRegistry,
-  provider: AIProvider,
+function registerBuiltinLLMProvider(
+  registry: LLMProviderRegistry,
+  provider: LLMProvider,
 ): boolean {
   if (registry.has(provider.id)) return false;
   registry.register(provider);
   return true;
 }
 
-export function ensureBuiltinAIProviders(): AIProviderRegistry {
-  const registry = getOrCreateAIProviderRegistry();
-  for (const definition of BUILTIN_AI_PROVIDERS) {
-    registerBuiltinAIProvider(registry, definition.provider());
+export function ensureBuiltinLLMProviders(): LLMProviderRegistry {
+  const registry = getOrCreateLLMProviderRegistry();
+  for (const definition of BUILTIN_LLM_PROVIDERS) {
+    registerBuiltinLLMProvider(registry, definition.provider());
   }
   return registry;
 }
 
-function createBuiltinAIProviderExtension(
-  definition: BuiltinAIProviderDefinition,
+function createBuiltinLLMProviderExtension(
+  definition: BuiltinLLMProviderDefinition,
 ): ResolvedExtension {
   const provider = definition.provider();
   let didRegister = false;
@@ -74,17 +73,17 @@ function createBuiltinAIProviderExtension(
     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<AIProviderRegistry>(AIProviderRegistryName);
-        didRegister = registerBuiltinAIProvider(registry, provider);
+        const registry = ctx.require<LLMProviderRegistry>(LLMProviderRegistryName);
+        didRegister = registerBuiltinLLMProvider(registry, provider);
         if (didRegister) {
           ctx.logger.info(`[${definition.extensionName}] ${provider.id} provider registered`);
         }
       },
       teardown() {
         if (didRegister) {
-          const registry = tryResolve<AIProviderRegistry>(AIProviderRegistryName);
+          const registry = tryResolve<LLMProviderRegistry>(LLMProviderRegistryName);
           registry?.unregister(provider.id);
           didRegister = false;
         }
@@ -120,6 +119,6 @@ export function createBuiltinExtensions(): ResolvedExtension[] {
       origin: "veryfront/ext-node-compat",
       extension: extNodeCompat(),
     },
-    ...BUILTIN_AI_PROVIDERS.map(createBuiltinAIProviderExtension),
+    ...BUILTIN_LLM_PROVIDERS.map(createBuiltinLLMProviderExtension),
   ];
 }

package/src/src/extensions/interfaces/index.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
  */
@@ -76,12 +80,12 @@ export type {
 // Tracing exporter
 export type { SpanData, TracerProvider, TracingExporter } from "./tracing-exporter.js";
 
-// AI provider (registry + per-provider contract)
-export type { AIProvider, AIProviderConfig, AIProviderRegistry } from "./ai-provider.js";
-export { AIProviderRegistryName } from "./ai-provider.js";
+// LLM provider (registry + per-provider contract) — moved to ../llm/
+export type { LLMProvider, LLMProviderConfig, LLMProviderRegistry } from "../llm/index.js";
+export { LLMProviderRegistryName } from "../llm/index.js";
 
-// Embedding provider
-export type { EmbeddingOptions, EmbeddingProvider, EmbeddingResult } from "./embedding-provider.js";
+// Embedding provider — moved to ../llm/
+export type { EmbeddingOptions, EmbeddingProvider, EmbeddingResult } from "../llm/index.js";
 
 // Code parser
 export type {

package/src/src/extensions/{interfaces → llm}/embedding-provider.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}. */

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

@@ -0,0 +1,17 @@
+/**
+ * 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";

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

@@ -1,18 +1,18 @@
 /**
- * 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
  */
 
-import type { AIProvider, AIProviderRegistry } from "../interfaces/ai-provider.js";
+import type { LLMProvider, LLMProviderRegistry } from "./llm-provider.js";
 
-class AIProviderRegistryImpl implements AIProviderRegistry {
-  private readonly providers = new Map<string, AIProvider>();
+class LLMProviderRegistryImpl implements LLMProviderRegistry {
+  private readonly providers = new Map<string, LLMProvider>();
 
-  register(provider: AIProvider): void {
+  register(provider: LLMProvider): void {
     if (this.providers.has(provider.id)) {
       return;
     }
@@ -23,16 +23,16 @@ class AIProviderRegistryImpl implements AIProviderRegistry {
     this.providers.delete(id);
   }
 
-  get(id: string): AIProvider | undefined {
+  get(id: string): LLMProvider | undefined {
     return this.providers.get(id);
   }
 
-  require(id: string): AIProvider {
+  require(id: string): LLMProvider {
     const p = this.providers.get(id);
     if (p) return p;
     const known = [...this.providers.keys()].join(", ") || "(none)";
     throw new Error(
-      `No AIProvider registered for "${id}". Known providers: ${known}.`,
+      `No LLMProvider registered for "${id}". Known providers: ${known}.`,
     );
   }
 
@@ -40,11 +40,11 @@ class AIProviderRegistryImpl implements AIProviderRegistry {
     return this.providers.has(id);
   }
 
-  list(): AIProvider[] {
+  list(): LLMProvider[] {
     return [...this.providers.values()];
   }
 }
 
-export function createAIProviderRegistry(): AIProviderRegistry {
-  return new AIProviderRegistryImpl();
+export function createLLMProviderRegistry(): LLMProviderRegistry {
+  return new LLMProviderRegistryImpl();
 }

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

@@ -1,19 +1,19 @@
 /**
  * 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). */
@@ -28,27 +28,27 @@ 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 const AIProviderRegistryName = "AIProviderRegistry" as const;
+export const LLMProviderRegistryName = "LLMProviderRegistry" as const;

package/src/src/extensions/loader.ts

@@ -22,7 +22,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: Record<string, unknown>): void {
     this.primed = { ...this.primed, ...contracts };

package/src/src/extensions/orchestrate.ts

@@ -34,7 +34,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/src/src/extensions/recommendations.ts

@@ -16,10 +16,10 @@ const recommendations = new Map<string, string>([
   ["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/src/src/provider/local/env.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.