veryfront 0.1.500 → 0.1.501

package/src/extensions/{ext-esbuild → ext-bundler-esbuild}/src/index.ts

@@ -1,8 +1,8 @@
 /**
- * ext-esbuild — Bundler + ModuleLexer contract implementations backed by
+ * ext-bundler-esbuild — Bundler + ModuleLexer contract implementations backed by
  * esbuild and es-module-lexer.
  *
- * @module extensions/ext-esbuild
+ * @module extensions/ext-bundler-esbuild
  */
 
 import type { ExtensionFactory } from "../../../src/extensions/index.js";
@@ -11,7 +11,7 @@ import { EsbuildBundler } from "./esbuild-bundler.js";
 import { EsModuleLexer } from "./es-module-lexer.js";
 
 /**
- * Default export — the ext-esbuild extension factory.
+ * Default export — the ext-bundler-esbuild extension factory.
  *
  * Registers both the `Bundler` (esbuild-backed) and `ModuleLexer`
  * (es-module-lexer-backed) contracts.
@@ -21,7 +21,7 @@ const extEsbuild: ExtensionFactory = () => {
   const lexer = new EsModuleLexer();
 
   return {
-    name: "ext-esbuild",
+    name: "ext-bundler-esbuild",
     version: "0.1.0",
     capabilities: [
       { type: "contract", name: "Bundler" },
@@ -34,7 +34,7 @@ const extEsbuild: ExtensionFactory = () => {
       if (!ctx.get("ModuleLexer")) {
         ctx.provide("ModuleLexer", lexer);
       }
-      ctx.logger.info("[ext-esbuild] Bundler + ModuleLexer registered");
+      ctx.logger.info("[ext-bundler-esbuild] Bundler + ModuleLexer registered");
     },
     async teardown() {
       await bundler.stop?.();

package/src/extensions/{ext-esbuild → ext-bundler-esbuild}/src/plugin-adapter.ts

@@ -5,7 +5,7 @@
  * translation is near-1:1; this module exists to isolate the esbuild
  * import from the rest of the extension.
  *
- * @module extensions/ext-esbuild/plugin-adapter
+ * @module extensions/ext-bundler-esbuild/plugin-adapter
  */
 
 import type {
@@ -15,7 +15,7 @@ import type {
   OnLoadResult,
   OnResolveArgs,
   OnResolveResult,
-} from "../../../src/extensions/interfaces/index.js";
+} from "../../../src/extensions/bundler/index.js";
 // deno-lint-ignore no-explicit-any
 type EsbuildPlugin = any;
 

package/src/extensions/{ext-esbuild → ext-bundler-esbuild}/src/runtime.ts

@@ -4,7 +4,7 @@
  *
  * Only the bits needed by the esbuild binary extractor are included here.
  *
- * @module extensions/ext-esbuild/runtime
+ * @module extensions/ext-bundler-esbuild/runtime
  */
 import * as dntShim from "../../../_dnt.shims.js";
 

package/src/extensions/{ext-tailwind → ext-css-tailwind}/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * ext-tailwind — CSSProcessor implementation backed by Tailwind CSS v4.
+ * ext-css-tailwind — CSSProcessor implementation backed by Tailwind CSS v4.
  *
  * Provides the `CSSProcessor` contract:
  *  - `compile(stylesheet, options)` — delegates to tailwindcss `compile()`
@@ -13,13 +13,13 @@
  * `plugin-loader.ts` rewrites plugin bundle code to reference these shims
  * by name; without the shims installed, dynamic plugin loading fails.
  *
- * @module extensions/ext-tailwind
+ * @module extensions/ext-css-tailwind
  */
 import * as dntShim from "../../../_dnt.shims.js";
 
 
 import type { ExtensionFactory } from "../../../src/extensions/index.js";
-import type { CSSCompileOptions, CSSCompiler, CSSProcessor } from "../../../src/extensions/interfaces/index.js";
+import type { CSSCompileOptions, CSSCompiler, CSSProcessor } from "../../../src/extensions/css/index.js";
 
 import { compile } from "tailwindcss";
 import plugin from "tailwindcss/plugin";
@@ -57,7 +57,7 @@ class TailwindCSSProcessor implements CSSProcessor {
 const extTailwind: ExtensionFactory = () => {
   const impl = new TailwindCSSProcessor();
   return {
-    name: "ext-tailwind",
+    name: "ext-css-tailwind",
     version: "0.1.0",
     capabilities: [
       { type: "contract", name: "CSSProcessor" },
@@ -66,7 +66,7 @@ const extTailwind: ExtensionFactory = () => {
     setup(ctx) {
       installTailwindPluginShims();
       ctx.provide("CSSProcessor", impl);
-      ctx.logger.info("[ext-tailwind] CSSProcessor registered");
+      ctx.logger.info("[ext-css-tailwind] CSSProcessor registered");
     },
     teardown() {
       // Shims stay installed — removing them could break in-flight plugin

package/src/extensions/{ext-node-compat → ext-node-compatibility}/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * ext-node-compat — Node.js compatibility shims for Veryfront.
+ * ext-node-compatibility — Node.js compatibility shims for Veryfront.
  *
  * Provides the `NodeCompat` contract:
  * - `importKreuzberg()` — document extraction via `@kreuzberg/wasm` (Deno)
@@ -12,7 +12,7 @@
  * Without this extension, core falls back to in-memory KV and document
  * extraction is unavailable.
  *
- * @module extensions/ext-node-compat
+ * @module extensions/ext-node-compatibility
  */
 import * as dntShim from "../../../_dnt.shims.js";
 
@@ -22,7 +22,7 @@ import type {
   KreuzbergExtractor,
   NodeCompat,
   NodeCompatSqliteDatabase,
-} from "../../../src/extensions/interfaces/index.js";
+} from "../../../src/extensions/compat/index.js";
 import { loadKreuzberg } from "./kreuzberg.js";
 
 // ---------------------------------------------------------------------------
@@ -122,7 +122,7 @@ const extNodeCompat: ExtensionFactory = () => {
   const impl = new NodeCompatImpl();
 
   return {
-    name: "ext-node-compat",
+    name: "ext-node-compatibility",
     version: "0.1.0",
     capabilities: [
       { type: "contract", name: "NodeCompat" },
@@ -131,7 +131,7 @@ const extNodeCompat: ExtensionFactory = () => {
 
     setup(ctx) {
       ctx.provide("NodeCompat", impl);
-      ctx.logger.info("[ext-node-compat] NodeCompat registered");
+      ctx.logger.info("[ext-node-compatibility] NodeCompat registered");
     },
   };
 };

package/src/extensions/{ext-node-compat → ext-node-compatibility}/src/kreuzberg.ts

@@ -1,17 +1,17 @@
 /**
- * Shared kreuzberg loader for the ext-node-compat extension.
+ * Shared kreuzberg loader for the ext-node-compatibility extension.
  *
  * Used by both `NodeCompatImpl.importKreuzberg()` (direct calls from
  * Node/Bun) and the extension's upload-extraction worker (Deno isolate).
  * Centralising the loader keeps the compiled-binary WASM glue + pdfium
  * pre-import dance in one place.
  *
- * @module extensions/ext-node-compat/kreuzberg
+ * @module extensions/ext-node-compatibility/kreuzberg
  */
 import * as dntShim from "../../../_dnt.shims.js";
 
 
-import type { KreuzbergExtractor } from "../../../src/extensions/interfaces/index.js";
+import type { KreuzbergExtractor } from "../../../src/extensions/compat/index.js";
 
 type KreuzbergModule = {
   initWasm?: () => Promise<void>;

package/src/extensions/{ext-babel → ext-parser-babel}/src/index.ts

@@ -1,5 +1,5 @@
 /**
- * ext-babel — CodeParser implementation backed by @babel/parser,
+ * ext-parser-babel — CodeParser implementation backed by @babel/parser,
  * @babel/traverse, @babel/generator, @babel/types.
  *
  * Provides the `CodeParser` contract:
@@ -11,7 +11,7 @@
  * Core's `src/transforms/plugins/babel-node-positions.ts` is a shim that
  * resolves this contract at call time.
  *
- * @module extensions/ext-babel
+ * @module extensions/ext-parser-babel
  */
 
 import * as parser from "@babel/parser";
@@ -26,7 +26,7 @@ import type {
   InjectJsxNodePositionsOptions,
   ParseOptions,
   TraverseVisitor,
-} from "../../../src/extensions/interfaces/index.js";
+} from "../../../src/extensions/parser/index.js";
 import { injectNodePositions } from "./inject-node-positions.js";
 
 type TraverseFunction = (ast: unknown, opts: Record<string, unknown>) => void;
@@ -91,12 +91,12 @@ class BabelCodeParser implements CodeParser {
 const extBabel: ExtensionFactory = () => {
   const impl = new BabelCodeParser();
   return {
-    name: "ext-babel",
+    name: "ext-parser-babel",
     version: "0.1.0",
     capabilities: [{ type: "contract", name: "CodeParser" }],
     setup(ctx) {
       ctx.provide("CodeParser", impl);
-      ctx.logger.info("[ext-babel] CodeParser registered");
+      ctx.logger.info("[ext-parser-babel] CodeParser registered");
     },
     teardown() {
       // No resources to release.

package/src/extensions/{ext-mdx → ext-transform-mdx}/src/compiler/markdown-compile.ts

@@ -12,7 +12,7 @@ import { visit } from "unist-util-visit";
 import { toString } from "mdast-util-to-string";
 import Slugger from "github-slugger";
 import type { Heading, Root as MdastRoot } from "@types/mdast";
-import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/interfaces/index.js";
+import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/transform/index.js";
 import { extractFrontmatter } from "../../../../src/transforms/mdx/compiler/frontmatter-extractor.js";
 import { isMarkdownPreview } from "../../../../src/transforms/md/utils.js";
 import { rehypeNodePositions } from "../plugins/rehype-node-positions.js";

package/src/extensions/{ext-mdx → ext-transform-mdx}/src/compiler/mdx-compile.ts

@@ -1,6 +1,6 @@
 import { compile } from "@mdx-js/mdx";
 import type { Pluggable } from "unified";
-import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/interfaces/index.js";
+import type { ContentCompileOptions, ContentRuntimeBundle } from "../../../../src/extensions/transform/index.js";
 import { extractFrontmatter } from "../../../../src/transforms/mdx/compiler/frontmatter-extractor.js";
 import { rewriteBodyImports, rewriteCompiledImports } from "../../../../src/transforms/mdx/compiler/import-rewriter.js";
 import { getRehypePlugins, getRemarkPlugins } from "../plugins/plugin-loader.js";

package/src/extensions/{ext-mdx → ext-transform-mdx}/src/index.ts

@@ -14,7 +14,7 @@
  * core throws an actionable install message (see
  * `src/extensions/recommendations.ts`).
  *
- * @module extensions/ext-mdx
+ * @module extensions/ext-transform-mdx
  */
 
 import type { ExtensionFactory } from "../../../src/extensions/index.js";
@@ -23,7 +23,7 @@ import type {
   ContentPlugin,
   ContentRuntimeBundle,
   ContentTransformer,
-} from "../../../src/extensions/interfaces/index.js";
+} from "../../../src/extensions/transform/index.js";
 import { compileMdx } from "./compiler/mdx-compile.js";
 import { compileMarkdown } from "./compiler/markdown-compile.js";
 import { getRehypePlugins, getRemarkPlugins } from "./plugins/plugin-loader.js";
@@ -46,7 +46,7 @@ class MdxContentTransformer implements ContentTransformer {
 const extMdx: ExtensionFactory = () => {
   const impl = new MdxContentTransformer();
   return {
-    name: "ext-mdx",
+    name: "ext-transform-mdx",
     version: "0.1.0",
     capabilities: [{ type: "contract", name: "ContentTransformer" }],
     setup(ctx) {

package/src/src/agent/default-hosted-chat-runtime.ts

@@ -45,6 +45,7 @@ export type DefaultHostedChatRuntimeConfig = {
   apiUrl: string;
   apiMcpUrl: string;
   studioMcpUrl?: string | null;
+  studioMcpEnabled?: boolean;
 };
 
 export type DefaultHostedChatRuntimeLogger = {
@@ -154,6 +155,7 @@ async function buildToolAssembly(
     apiUrl: input.config.apiUrl,
     apiMcpUrl: input.config.apiMcpUrl,
     studioMcpUrl: input.config.studioMcpUrl,
+    studioMcpEnabled: input.config.studioMcpEnabled,
     conversationId: input.options.conversationId,
     allowedToolNames: input.options.allowedTools ?? null,
     projectScopedRemoteToolOptions: input.projectScopedRemoteToolOptions,

package/src/src/agent/hosted-chat-runtime-tool-assembly.ts

@@ -58,6 +58,7 @@ export type PrepareHostedChatRuntimeToolAssemblyInput<
   apiUrl: string;
   apiMcpUrl: string;
   studioMcpUrl?: string | null;
+  studioMcpEnabled?: boolean;
   conversationId?: string;
   allowedToolNames?: HostedChatRuntimeAllowedToolNames;
   projectScopedRemoteToolOptions?: ProjectScopedRemoteToolOptions;
@@ -120,6 +121,7 @@ export async function prepareHostedChatRuntimeToolAssembly<
     authToken: input.taskContext.authToken,
     apiMcpUrl: input.apiMcpUrl,
     studioMcpUrl: input.studioMcpUrl,
+    studioMcpEnabled: input.studioMcpEnabled,
     clientProfile: input.taskContext.clientProfile,
     createRemoteToolSource: input.createRemoteToolSource ?? createRemoteMCPToolSource,
     defaultProjectId: () => activeProjectId(input.taskContext),

package/src/src/agent/hosted-project-remote-tool-source.ts

@@ -188,6 +188,7 @@ export type CreateHostedProjectRemoteToolSourcesInput =
     authToken: string;
     apiMcpUrl: string;
     studioMcpUrl?: string | null;
+    studioMcpEnabled?: boolean;
     clientProfile?: RuntimeClientProfile | null;
     getProjectId: () => string | null | undefined;
     conversationId?: string;
@@ -242,7 +243,9 @@ export function createHostedProjectRemoteToolSources(
     ),
   ];
 
-  if (!input.studioMcpUrl || !clientAllowsStudioMcp(input.clientProfile)) {
+  if (
+    !input.studioMcpEnabled || !input.studioMcpUrl || !clientAllowsStudioMcp(input.clientProfile)
+  ) {
     return sources;
   }
 

package/src/src/agent/index.ts

@@ -331,6 +331,7 @@ export {
 } from "./hosted-agent-service-runtime.js";
 export {
   createNodeVeryfrontCloudAgentServiceRuntime,
+  type NodeVeryfrontCloudAgentServiceMcpOptions,
   type NodeVeryfrontCloudAgentServiceOptions,
   type NodeVeryfrontCloudAgentServicePreparedExecution,
   type NodeVeryfrontCloudAgentServiceProcessTarget,

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

@@ -109,13 +109,35 @@ 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"];
   env?: CreateNodeAgentServiceRuntimeInfrastructureOptions["env"];
@@ -158,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.entrypointUrl !== undefined) {
+    return dirname(pathOptionToPath(options.entrypointUrl));
   }
-  if (options.entryUrl) {
-    return dirname(fileURLToPath(options.entryUrl));
+  if (options.entryUrl !== undefined) {
+    return dirname(pathOptionToPath(options.entryUrl));
   }
   if (typeof process !== "undefined") {
     return process.cwd();
@@ -192,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;
@@ -407,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,
   };
 }
@@ -491,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,

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/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 { LLMProviderRegistry } from "../extensions/interfaces/index.js";
-import { LLMProviderRegistryName } 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;

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 { LLMProviderRegistry } from "../../extensions/interfaces/index.js";
-import { LLMProviderRegistryName } from "../../extensions/interfaces/index.js";
+import type { LLMProviderRegistry } from "../../extensions/llm/index.js";
+import { LLMProviderRegistryName } from "../../extensions/llm/index.js";
 import {
   createVeryfrontCloudFetch,
   getVeryfrontCloudGatewayBaseUrl,

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";