veryfront 0.1.499 → 0.1.501

package/src/src/agent/veryfront-cloud-agent-service.ts

@@ -77,6 +77,7 @@ import {
   type AgentServiceRuntimeConfig,
   createAgentServiceRuntime,
   type CreateAgentServiceRuntimeOptions,
+  startAgentServiceRuntime,
   startNodeAgentService,
   type StartNodeAgentServiceResult,
 } from "./hosted-agent-service-runtime.js";
@@ -108,21 +109,51 @@ export type NodeVeryfrontCloudAgentServiceProcessTarget =
 
 export type NodeVeryfrontCloudAgentServiceAgentSource = "auto" | "code" | "markdown";
 
+export type NodeVeryfrontCloudAgentServiceMcpOptions = {
+  /**
+   * Opt in to Studio UI/control-plane MCP tools for trusted Studio-capable clients.
+   * API MCP tools remain part of the Veryfront Cloud service preset.
+   */
+  studio?: boolean;
+};
+
+type AgentServicePathOption = string | URL;
+
 export type NodeVeryfrontCloudAgentServiceOptions = {
   serviceName: string;
   agentId: string;
-  baseDir?: string;
+  /**
+   * Project/discovery root. Defaults to the process cwd when neither baseDir
+   * nor an entrypoint URL is provided.
+   */
+  baseDir?: AgentServicePathOption;
   projectDir?: string;
-  entryUrl?: string | URL;
+  /**
+   * Convenience URL for deriving baseDir from the entry module location.
+   */
+  entrypointUrl?: AgentServicePathOption;
+  /**
+   * Compatibility alias for entrypointUrl.
+   */
+  entryUrl?: AgentServicePathOption;
   agentSource?: NodeVeryfrontCloudAgentServiceAgentSource;
+  mcp?: NodeVeryfrontCloudAgentServiceMcpOptions;
   forwardedConfigNamespace?: string;
-  createBashTool: HostedSandboxToolsOptions["createBashTool"];
+  createBashTool?: HostedSandboxToolsOptions["createBashTool"];
   env?: CreateNodeAgentServiceRuntimeInfrastructureOptions["env"];
   processTarget?: NodeVeryfrontCloudAgentServiceProcessTarget;
   drainTimeoutMs?: number;
   hardShutdownTimeoutMs?: number;
 };
 
+export type VeryfrontCloudAgentServiceOptions = NodeVeryfrontCloudAgentServiceOptions;
+
+type ResolvedNodeVeryfrontCloudAgentServiceOptions =
+  & NodeVeryfrontCloudAgentServiceOptions
+  & {
+    createBashTool: HostedSandboxToolsOptions["createBashTool"];
+  };
+
 export type NodeVeryfrontCloudAgentServicePreparedExecution = PreparedHostedChatExecution & {
   config: AgentServiceRuntimeConfig;
   agent: HostedChatRuntimeCreationResult["agent"];
@@ -149,14 +180,21 @@ const PROJECT_CONFIG_FILES = [
   "veryfront.config.mjs",
 ];
 
+function pathOptionToPath(pathOption: AgentServicePathOption): string {
+  return pathOption instanceof URL ? fileURLToPath(pathOption) : pathOption;
+}
+
 function resolveBaseDir(
-  options: Pick<NodeVeryfrontCloudAgentServiceOptions, "baseDir" | "entryUrl">,
+  options: Pick<NodeVeryfrontCloudAgentServiceOptions, "baseDir" | "entrypointUrl" | "entryUrl">,
 ): string {
-  if (options.baseDir) {
-    return options.baseDir;
+  if (options.baseDir !== undefined) {
+    return pathOptionToPath(options.baseDir);
   }
-  if (options.entryUrl) {
-    return dirname(fileURLToPath(options.entryUrl));
+  if (options.entrypointUrl !== undefined) {
+    return dirname(pathOptionToPath(options.entrypointUrl));
+  }
+  if (options.entryUrl !== undefined) {
+    return dirname(pathOptionToPath(options.entryUrl));
   }
   if (typeof process !== "undefined") {
     return process.cwd();
@@ -183,7 +221,10 @@ function uniquePaths(paths: string[]): string[] {
 }
 
 function resolveProjectDir(
-  options: Pick<NodeVeryfrontCloudAgentServiceOptions, "baseDir" | "entryUrl" | "projectDir">,
+  options: Pick<
+    NodeVeryfrontCloudAgentServiceOptions,
+    "baseDir" | "entrypointUrl" | "entryUrl" | "projectDir"
+  >,
 ): string {
   if (options.projectDir) {
     return options.projectDir;
@@ -201,6 +242,22 @@ function resolveDefaultProcessTarget(): NodeVeryfrontCloudAgentServiceProcessTar
   return process;
 }
 
+async function loadDefaultCreateBashTool(): Promise<
+  HostedSandboxToolsOptions["createBashTool"]
+> {
+  const { createBashTool } = await import("bash-tool");
+  return createBashTool;
+}
+
+async function resolveNodeVeryfrontCloudAgentServiceOptions(
+  options: NodeVeryfrontCloudAgentServiceOptions,
+): Promise<ResolvedNodeVeryfrontCloudAgentServiceOptions> {
+  return {
+    ...options,
+    createBashTool: options.createBashTool ?? await loadDefaultCreateBashTool(),
+  };
+}
+
 function resolveEnvironment(
   options: Pick<NodeVeryfrontCloudAgentServiceOptions, "env" | "processTarget">,
 ): CreateNodeAgentServiceRuntimeInfrastructureOptions["env"] {
@@ -213,11 +270,14 @@ function resolveEnvironment(
   if (typeof process !== "undefined") {
     return process.env;
   }
+  if (typeof dntShim.Deno !== "undefined") {
+    return dntShim.Deno.env.toObject();
+  }
   return {};
 }
 
 function createNodeVeryfrontCloudAgentServiceContext(
-  options: NodeVeryfrontCloudAgentServiceOptions,
+  options: ResolvedNodeVeryfrontCloudAgentServiceOptions,
 ) {
   const processTarget = options.processTarget ?? resolveDefaultProcessTarget();
   const infrastructure = createNodeAgentServiceRuntimeInfrastructure({
@@ -379,11 +439,12 @@ function getInvokeAgentConfig(
   context: NodeVeryfrontCloudAgentServiceContext,
 ): DefaultHostedInvokeAgentConfig {
   const config = context.infrastructure.getConfig();
+  const studioMcpUrl = context.options.mcp?.studio ? config.VERYFRONT_STUDIO_MCP_URL : "";
 
   return {
     apiUrl: config.VERYFRONT_API_URL,
     apiMcpUrl: config.VERYFRONT_MCP_URL,
-    studioMcpUrl: config.VERYFRONT_STUDIO_MCP_URL,
+    studioMcpUrl,
     enableDurableInvokeAgent: config.VERYFRONT_ENABLE_DURABLE_INVOKE_AGENT,
   };
 }
@@ -463,7 +524,8 @@ function createAgentRuntime(
     config: {
       apiUrl: config.VERYFRONT_API_URL,
       apiMcpUrl: config.VERYFRONT_MCP_URL,
-      studioMcpUrl: config.VERYFRONT_STUDIO_MCP_URL,
+      studioMcpUrl: context.options.mcp?.studio ? config.VERYFRONT_STUDIO_MCP_URL : "",
+      studioMcpEnabled: context.options.mcp?.studio ?? false,
     },
     buildLocalTools: (taskContext) => buildLocalTools(context, options, taskContext),
     refreshSystem,
@@ -700,7 +762,8 @@ function createNodeVeryfrontCloudAgentServiceRuntimeOptions(
 export async function createNodeVeryfrontCloudAgentServiceRuntime(
   options: NodeVeryfrontCloudAgentServiceOptions,
 ): Promise<AgentServiceRuntimeBundle<NodeVeryfrontCloudAgentServicePreparedExecution>> {
-  const context = createNodeVeryfrontCloudAgentServiceContext(options);
+  const resolvedOptions = await resolveNodeVeryfrontCloudAgentServiceOptions(options);
+  const context = createNodeVeryfrontCloudAgentServiceContext(resolvedOptions);
   await initializeNodeVeryfrontCloudAgentServiceContext(context);
   return createAgentServiceRuntime(createNodeVeryfrontCloudAgentServiceRuntimeOptions(context));
 }
@@ -708,7 +771,8 @@ export async function createNodeVeryfrontCloudAgentServiceRuntime(
 export async function startNodeVeryfrontCloudAgentService(
   options: NodeVeryfrontCloudAgentServiceOptions,
 ): Promise<StartNodeAgentServiceResult<NodeVeryfrontCloudAgentServicePreparedExecution>> {
-  const context = createNodeVeryfrontCloudAgentServiceContext(options);
+  const resolvedOptions = await resolveNodeVeryfrontCloudAgentServiceOptions(options);
+  const context = createNodeVeryfrontCloudAgentServiceContext(resolvedOptions);
   await initializeNodeVeryfrontCloudAgentServiceContext(context);
   return await startNodeAgentService({
     ...createNodeVeryfrontCloudAgentServiceRuntimeOptions(context),
@@ -716,7 +780,7 @@ export async function startNodeVeryfrontCloudAgentService(
   });
 }
 
-export async function runNodeVeryfrontCloudAgentServiceMain(
+export async function startAgentService(
   options: NodeVeryfrontCloudAgentServiceOptions,
 ): Promise<void> {
   const processTarget = options.processTarget ?? resolveDefaultProcessTarget();
@@ -724,8 +788,9 @@ export async function runNodeVeryfrontCloudAgentServiceMain(
     () => ({});
 
   await loadAgentServiceEnvFiles();
+  const resolvedOptions = await resolveNodeVeryfrontCloudAgentServiceOptions(options);
   const context = createNodeVeryfrontCloudAgentServiceContext({
-    ...options,
+    ...resolvedOptions,
     processTarget,
   });
   getRuntimeTraceContext = context.infrastructure.getTraceContext;
@@ -747,7 +812,7 @@ export async function runNodeVeryfrontCloudAgentServiceMain(
       __registerTraceContextGetter(getter);
     },
     start: async () => {
-      await startNodeAgentService({
+      await startAgentServiceRuntime({
         ...createNodeVeryfrontCloudAgentServiceRuntimeOptions(context),
         hardShutdownTimeoutMs: options.hardShutdownTimeoutMs ?? DEFAULT_HARD_SHUTDOWN_TIMEOUT_MS,
       });
@@ -759,3 +824,9 @@ export async function runNodeVeryfrontCloudAgentServiceMain(
     processTarget,
   });
 }
+
+export async function runNodeVeryfrontCloudAgentServiceMain(
+  options: NodeVeryfrontCloudAgentServiceOptions,
+): Promise<void> {
+  await startAgentService(options);
+}

package/src/src/build/bundler/code-splitter/build-context.ts

@@ -3,7 +3,7 @@
  * @module code-splitter/build-context
  */
 
-import { type BuildContext, context } from "../../../extensions/bundler.js";
+import { type BuildContext, context } from "../../../extensions/bundler/index.js";
 import { join } from "../../../platform/compat/path/index.js";
 import { createFileSystem } from "../../../platform/compat/fs.js";
 import { getReactImportMap, REACT_DEFAULT_VERSION } from "../../../utils/index.js";

package/src/src/build/bundler/code-splitter/esbuild-plugin.ts

@@ -3,7 +3,7 @@ import {
   getReactImportMap,
   REACT_DEFAULT_VERSION,
 } from "../../../utils/index.js";
-import type { OnResolveArgs, Plugin, PluginBuild } from "../../../extensions/bundler.js";
+import type { OnResolveArgs, Plugin, PluginBuild } from "../../../extensions/bundler/index.js";
 import { join } from "../../../platform/compat/path/index.js";
 
 export function createSplitterPlugin(projectDir: string): Plugin {

package/src/src/build/bundler/code-splitter/manifest-builder.ts

@@ -5,7 +5,7 @@
 import * as dntShim from "../../../../_dnt.shims.js";
 
 
-import type { Metafile } from "../../../extensions/bundler.js";
+import type { Metafile } from "../../../extensions/bundler/index.js";
 import { join, relative } from "../../../platform/compat/path/index.js";
 import { createFileSystem } from "../../../platform/compat/fs.js";
 import type { ChunkInfo, ChunkManifest, MetafileOutput } from "./types.js";

package/src/src/build/bundler/code-splitter/splitter.ts

@@ -1,5 +1,5 @@
 import { bundlerLogger as logger } from "../../../utils/index.js";
-import type { Metafile } from "../../../extensions/bundler.js";
+import type { Metafile } from "../../../extensions/bundler/index.js";
 import { ensureDir } from "../../../../deps/jsr.io/@std/fs/1.0.23/mod.js";
 import { relative } from "../../../platform/compat/path/index.js";
 import type { ChunkInfo, SplitOptions, SplitResult } from "./types.js";

package/src/src/build/bundler/code-splitter/types.ts

@@ -1,4 +1,4 @@
-import type { Metafile } from "../../../extensions/bundler.js";
+import type { Metafile } from "../../../extensions/bundler/index.js";
 
 export type MetafileOutput = Metafile["outputs"][string];
 

package/src/src/build/compiler/mdx-compiler/transpiler.ts

@@ -1,4 +1,4 @@
-import * as esbuild from "../../../extensions/bundler.js";
+import * as esbuild from "../../../extensions/bundler/index.js";
 import type { CompileOptions } from "./types.js";
 
 export async function transpileCode(code: string, options: CompileOptions): Promise<string> {

package/src/src/build/compiler/mdx-to-js.ts

@@ -1,6 +1,6 @@
 import { compile as compileMdx } from "@mdx-js/mdx";
 import { bundlerLogger as logger } from "../../utils/index.js";
-import * as esbuild from "../../extensions/bundler.js";
+import * as esbuild from "../../extensions/bundler/index.js";
 import { extract } from "../../platform/compat/std/front-matter-yaml.js";
 import type { RuntimeAdapter } from "../../platform/adapters/base.js";
 import { createError, toError } from "../../errors/veryfront-error.js";

package/src/src/build/embedded/preset.ts

@@ -1,7 +1,7 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { bundlerLogger as logger } from "../../utils/index.js";
 import { createError, toError } from "../../errors/veryfront-error.js";
-import * as esbuild from "../../extensions/bundler.js";
+import * as esbuild from "../../extensions/bundler/index.js";
 import { join } from "../../platform/compat/path/index.js";
 import { compileMDXToJS } from "../compiler/index.js";
 import { runtime } from "../../platform/adapters/detect.js";

package/src/src/build/production-build/client-runtime.ts

@@ -14,7 +14,7 @@ import {
   resolve,
 } from "../../platform/compat/path/index.js";
 import { serverLogger as logger } from "../../utils/index.js";
-import type { OnResolveArgs, Plugin } from "../../extensions/bundler.js";
+import type { OnResolveArgs, Plugin } from "../../extensions/bundler/index.js";
 import type { RuntimeAdapter } from "../../platform/adapters/base.js";
 import { createError, toError } from "../../errors/veryfront-error.js";
 import { createFileSystem } from "../../platform/compat/fs.js";
@@ -305,7 +305,7 @@ function createFsLoaderPlugin(): Plugin {
 }
 
 async function bundleClientEntry(entryRelative: string): Promise<string> {
-  const { build, stop } = await import("../../extensions/bundler.js");
+  const { build, stop } = await import("../../extensions/bundler/index.js");
   const entryUrl = new URL(entryRelative, import.meta.url);
   const shimUrl = new URL("../../rendering/client/browser-stubs/logger.ts", import.meta.url);
 

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/discovery/transpiler.ts

@@ -7,7 +7,7 @@
 import * as dntShim from "../../_dnt.shims.js";
 
 
-import type { Plugin, PluginBuild } from "../extensions/bundler.js";
+import type { Plugin, PluginBuild } from "../extensions/bundler/index.js";
 import { isDeno, isDenoCompiled } from "../platform/compat/runtime.js";
 import { createFileSystem } from "../platform/compat/fs.js";
 import * as pathHelper from "../platform/compat/path/index.js";
@@ -167,7 +167,7 @@ export async function importModule(
   }
 
   const loader = getEsbuildLoader(filePath);
-  const { build } = await import("../extensions/bundler.js");
+  const { build } = await import("../extensions/bundler/index.js");
   const fileDir = pathHelper.dirname(filePath);
 
   // When using fsAdapter (VFS), bundle all relative imports via the plugin.

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/llm/index.js";
+import { LLMProviderRegistryName } from "../extensions/llm/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/upload-loader.ts

@@ -1,5 +1,5 @@
 import { tryResolve } from "../extensions/contracts.js";
-import type { NodeCompat } from "../extensions/interfaces/node-compat.js";
+import type { NodeCompat } from "../extensions/compat/node-compat.js";
 
 /**
  * Extracts plain text from various upload formats.
@@ -36,7 +36,7 @@ export async function loadUpload(buffer: ArrayBuffer, mimeType: string): Promise
   if (!nodeCompat?.extractInWorker) {
     throw new Error(
       "Document extraction requires the NodeCompat extension. " +
-        "Install @veryfront/ext-node-compat and add it to your extensions configuration.",
+        "Install @veryfront/ext-node-compatibility and add it to your extensions configuration.",
     );
   }
   return nodeCompat.extractInWorker(buffer, mimeType);

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/llm/index.js";
+import { LLMProviderRegistryName } from "../../extensions/llm/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/{interfaces → auth}/auth-provider.ts

@@ -1,9 +1,9 @@
 /**
  * Contract interface for authentication token providers.
  *
- * Default implementation: `@veryfront/ext-jwt`
+ * Default implementation: `@veryfront/ext-auth-jwt`
  *
- * @module extensions/interfaces/auth-provider
+ * @module extensions/auth/auth-provider
  */
 
 /** Payload data stored within a signed token. */

package/src/src/extensions/auth/index.ts

@@ -0,0 +1,15 @@
+/**
+ * Auth category barrel — AuthProvider contract and token shapes.
+ *
+ * @module extensions/auth
+ */
+import "../../../_dnt.polyfills.js";
+
+
+export type {
+  AuthProvider,
+  SignOptions,
+  TokenHeader,
+  TokenPayload,
+  VerifyOptions,
+} from "./auth-provider.js";

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 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";
+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-bundler-esbuild/src/index.js";
+import extBabel from "../../extensions/ext-parser-babel/src/index.js";
+import extMdx from "../../extensions/ext-transform-mdx/src/index.js";
+import extTailwind from "../../extensions/ext-css-tailwind/src/index.js";
+import extNodeCompat from "../../extensions/ext-node-compatibility/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;
         }
@@ -97,12 +96,12 @@ export function createBuiltinExtensions(): ResolvedExtension[] {
   return [
     {
       source: "builtin",
-      origin: "veryfront/ext-esbuild",
+      origin: "veryfront/ext-bundler-esbuild",
       extension: extEsbuild(),
     },
     {
       source: "builtin",
-      origin: "veryfront/ext-babel",
+      origin: "veryfront/ext-parser-babel",
       extension: extBabel(),
     },
     {
@@ -112,14 +111,14 @@ export function createBuiltinExtensions(): ResolvedExtension[] {
     },
     {
       source: "builtin",
-      origin: "veryfront/ext-tailwind",
+      origin: "veryfront/ext-css-tailwind",
       extension: extTailwind(),
     },
     {
       source: "builtin",
-      origin: "veryfront/ext-node-compat",
+      origin: "veryfront/ext-node-compatibility",
       extension: extNodeCompat(),
     },
-    ...BUILTIN_AI_PROVIDERS.map(createBuiltinAIProviderExtension),
+    ...BUILTIN_LLM_PROVIDERS.map(createBuiltinLLMProviderExtension),
   ];
 }

package/src/src/extensions/{interfaces → bundler}/bundler.ts

@@ -1,9 +1,9 @@
 /**
  * Contract interface for module bundlers.
  *
- * Default implementation: `@veryfront/ext-esbuild`
+ * Default implementation: `@veryfront/ext-bundler-esbuild`
  *
- * @module extensions/interfaces/bundler
+ * @module extensions/bundler/bundler
  */
 
 /** Location of an error or warning in source. */