veryfront 0.1.161 → 0.1.163

package/esm/src/rendering/orchestrator/html.js

@@ -10,11 +10,7 @@ import { resolveAppComponentPath } from "../layouts/utils/app-resolver.js";
 import { StreamTimeoutError, streamToString } from "../utils/stream-utils.js";
 import { profilePhase, profileSyncPhase } from "../../observability/request-profiler.js";
 import { normalizeCssModuleKey, rewriteCssModuleContent, } from "../../transforms/css-modules/naming.js";
-import { getProjectCSS } from "../../html/styles-builder/index.js";
-import { warmPreparedCSSArtifactFromFiles } from "../../html/styles-builder/css-pregeneration.js";
-import { getRouteCandidates } from "./css-candidate-manifest.js";
-import { resolveStyleContentVersion } from "../../html/styles-builder/content-version.js";
-import { createStyleScopeProfile } from "../../html/styles-builder/style-scope-profile.js";
+import { extractProjectClassesForRoute, startPreparedCSSWarmup, startProjectCSSPreparation, } from "./html-project-css.js";
 const logger = rendererLogger.component("html-generator");
 function applyExplicitThemeToDocument(html, colorScheme, enabled) {
     if (!enabled || !colorScheme)
@@ -67,7 +63,7 @@ export class HTMLGenerator {
             if (this.config.mode === "production" && context.options?.environment === "production") {
                 const mergedFrontmatter = this.mergeFrontmatter(context);
                 const htmlOptions = await profilePhase("html.build_options", () => this.buildHTMLOptions(context, mergedFrontmatter));
-                projectCSSPromise = this.startProjectCSSPreparation(context, htmlOptions);
+                projectCSSPromise = startProjectCSSPreparation(context, htmlOptions);
             }
             html = await this.handleFullHTMLDocument(context, projectCSSPromise);
         }
@@ -84,8 +80,8 @@ export class HTMLGenerator {
         const fullContext = context;
         const mergedFrontmatter = this.mergeFrontmatter(fullContext);
         const htmlOptions = await profilePhase("html.build_options", () => this.buildHTMLOptions(fullContext, mergedFrontmatter));
-        const projectCSSPromise = this.startProjectCSSPreparation(fullContext, htmlOptions);
-        this.startPreparedCSSWarmup(fullContext, htmlOptions);
+        const projectCSSPromise = startProjectCSSPreparation(fullContext, htmlOptions);
+        startPreparedCSSWarmup(this.config, fullContext, htmlOptions);
         let reactContent;
         try {
             reactContent = (await streamToString(reactStream)).trim();
@@ -181,8 +177,8 @@ export class HTMLGenerator {
     async wrapHTMLFragment(context) {
         const mergedFrontmatter = this.mergeFrontmatter(context);
         const htmlOptions = await profilePhase("html.build_options", () => this.buildHTMLOptions(context, mergedFrontmatter));
-        const projectCSSPromise = this.startProjectCSSPreparation(context, htmlOptions);
-        this.startPreparedCSSWarmup(context, htmlOptions);
+        const projectCSSPromise = startProjectCSSPreparation(context, htmlOptions);
+        startPreparedCSSWarmup(this.config, context, htmlOptions);
         const reactContent = context.html.trim();
         const { start, end } = await profilePhase("html.generate_shell_parts", () => this.generateShellParts(context, mergedFrontmatter, htmlOptions, reactContent, projectCSSPromise));
         return `${start}${reactContent}${end}`;
@@ -224,54 +220,6 @@ export class HTMLGenerator {
         }
         return { start: modifiedStart, end };
     }
-    startProjectCSSPreparation(context, htmlOptions) {
-        const isLocalProject = htmlOptions.isLocalProject ?? false;
-        if (isLocalProject || htmlOptions.environment !== "production")
-            return undefined;
-        const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
-        if (!projectScope || projectScope === "default")
-            return undefined;
-        return getProjectCSS(projectScope, htmlOptions.globalCSS, new Set([...(htmlOptions.projectClasses ?? [])]), {
-            minify: true,
-            environment: htmlOptions.environment,
-            buildMode: htmlOptions.mode,
-        });
-    }
-    startPreparedCSSWarmup(context, htmlOptions) {
-        const isLocalProject = htmlOptions.isLocalProject ?? false;
-        const usesPreviewStylesheet = isLocalProject || htmlOptions.environment !== "production";
-        if (!usesPreviewStylesheet)
-            return;
-        const wrappedFs = this.config.adapter.fs;
-        if (typeof wrappedFs.getUnderlyingAdapter !== "function")
-            return;
-        const fsAdapter = wrappedFs.getUnderlyingAdapter();
-        if (typeof fsAdapter.getAllSourceFiles !== "function")
-            return;
-        const projectScope = htmlOptions.projectSlug || htmlOptions.projectId || context.slug;
-        if (!projectScope || projectScope === "default")
-            return;
-        const projectVersion = this.getProjectContentVersion() ??
-            (this.config.mode === "development" ? "dev" : "unknown");
-        const styleProfile = createStyleScopeProfile(this.config.config);
-        const stylesheetPath = this.config.config?.tailwind?.stylesheet;
-        Promise.resolve(fsAdapter.getAllSourceFiles()).then((files) => warmPreparedCSSArtifactFromFiles({
-            projectSlug: projectScope,
-            projectVersion,
-            projectDir: this.config.projectDir,
-            files,
-            styleProfile,
-            stylesheetPath,
-            minify: true,
-            environment: "preview",
-            buildMode: "production",
-        })).catch((error) => {
-            logger.debug("Prepared CSS warmup skipped after source scan failure", {
-                projectScope,
-                error: error instanceof Error ? error.message : String(error),
-            });
-        });
-    }
     buildHeadElements(head) {
         if (!head)
             return { scripts: "", other: "" };
@@ -360,7 +308,7 @@ export class HTMLGenerator {
             profilePhase("html.load_global_css", () => this.loadProjectFile(stylesheetPath)),
         ]);
         const appComponentPath = appComponentPathOrNull ?? undefined;
-        const projectClasses = await profilePhase("html.route_candidates", () => this.extractProjectClassesForRoute(context, appComponentPath));
+        const projectClasses = await profilePhase("html.route_candidates", () => extractProjectClassesForRoute(this.config, context, appComponentPath));
         // Load CSS imported by components and merge with globalCSS.
         // Deduplicate against the configured stylesheet to avoid double-loading.
         const combinedCSS = await profilePhase("html.merge_imported_css", () => this.mergeImportedCSS(globalCSS, context.cssImports, stylesheetPath));
@@ -462,64 +410,4 @@ export class HTMLGenerator {
         });
         return combined;
     }
-    getProjectContentVersion() {
-        const wrappedFs = this.config.adapter.fs;
-        if (typeof wrappedFs.getUnderlyingAdapter !== "function")
-            return undefined;
-        const fsAdapter = wrappedFs.getUnderlyingAdapter();
-        const contentContext = typeof fsAdapter.getContentContext === "function"
-            ? fsAdapter.getContentContext()
-            : null;
-        if (contentContext)
-            return resolveStyleContentVersion(contentContext);
-        return fsAdapter.getProjectData?.()?.updated_at;
-    }
-    buildRouteManifestKey(pagePath) {
-        const relativePagePath = extractRelativePath(pagePath, this.config.projectDir);
-        return relativePagePath
-            .replace(/\.(tsx|ts|jsx|mdx|md|js)$/, "")
-            .replace(/^pages\//, "");
-    }
-    async extractProjectClassesForRoute(context, appComponentPath) {
-        const classes = new Set();
-        const wrappedFs = this.config.adapter.fs;
-        if (typeof wrappedFs.getUnderlyingAdapter !== "function")
-            return classes;
-        const fsAdapter = wrappedFs.getUnderlyingAdapter();
-        if (typeof fsAdapter.getAllSourceFiles !== "function")
-            return classes;
-        const files = await fsAdapter.getAllSourceFiles();
-        const projectScope = context.options?.projectSlug || context.options?.projectId ||
-            this.config.projectDir;
-        const projectVersion = this.getProjectContentVersion() ??
-            (this.config.mode === "development" ? "dev" : "unknown");
-        const routeKey = this.buildRouteManifestKey(context.pageInfo.entity.path);
-        const routeLayoutPaths = context.nestedLayouts
-            .map((layout) => layout.componentPath || layout.path)
-            .filter((path) => Boolean(path));
-        const routeFilePaths = [
-            context.pageInfo.entity.path,
-            ...routeLayoutPaths,
-            ...(appComponentPath ? [appComponentPath] : []),
-        ];
-        const routeCandidates = getRouteCandidates({
-            projectScope,
-            projectVersion,
-            projectDir: this.config.projectDir,
-            styleProfile: createStyleScopeProfile(this.config.config),
-            routeKey,
-            routeFilePaths,
-            files,
-            developmentMode: this.config.mode === "development",
-        });
-        for (const cls of routeCandidates)
-            classes.add(cls);
-        logger.debug("extractProjectClasses", {
-            filesProcessed: files.length,
-            routeKey,
-            routeFileCount: routeFilePaths.length,
-            totalClasses: classes.size,
-        });
-        return classes;
-    }
 }

package/esm/src/tool/factory.d.ts

@@ -1,16 +1,14 @@
 import type { Tool, ToolConfig, ToolExecutionContext } from "./types.js";
+import type { JsonSchema } from "./schema/json-schema.js";
 export declare function tool<TInput = unknown, TOutput = unknown>(config: ToolConfig<TInput, TOutput>): Tool<TInput, TOutput>;
 export interface DynamicToolConfig {
     id?: string;
     description: string;
     inputSchema: unknown;
+    inputSchemaJson?: JsonSchema;
     execute: (input: unknown, context?: ToolExecutionContext) => Promise<unknown> | unknown;
     toModelOutput?: (output: unknown) => unknown;
-    mcp?: {
-        enabled?: boolean;
-        requiresAuth?: boolean;
-        cachePolicy?: "no-cache" | "cache" | "cache-first";
-    };
+    mcp?: ToolConfig["mcp"];
 }
 export declare function dynamicTool(config: DynamicToolConfig): Tool<unknown, unknown>;
 //# sourceMappingURL=factory.d.ts.map

package/esm/src/tool/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/tool/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAwIzE,wBAAgB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACtD,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAqCvB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACxF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7C,GAAG,CAAC,EAAE;QACJ,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,WAAW,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,aAAa,CAAC;KACpD,CAAC;CACH;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CA2B7E"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/src/tool/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAuI1D,wBAAgB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACtD,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAqCvB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,UAAU,CAAC;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACxF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7C,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;CACzB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CA4B7E"}

package/esm/src/tool/factory.js

@@ -105,7 +105,8 @@ export function tool(config) {
 export function dynamicTool(config) {
     const explicitId = typeof config.id === "string" && config.id.length > 0 ? config.id : undefined;
     const id = explicitId ?? generateToolId();
-    const inputSchemaJson = convertSchemaToJson(config.inputSchema, id, "DYNAMIC_TOOL", true);
+    const inputSchemaJson = config.inputSchemaJson ??
+        convertSchemaToJson(config.inputSchema, id, "DYNAMIC_TOOL", true);
     const createdTool = {
         id,
         type: "dynamic",

package/esm/src/tool/index.d.ts

@@ -48,6 +48,8 @@ export { dynamicTool, tool } from "./factory.js";
 export type { DynamicToolConfig } from "./factory.js";
 export { createRemoteMCPToolSource } from "./remote-mcp.js";
 export type { RemoteMCPToolSourceConfig } from "./remote-mcp.js";
+export { createToolsFromRemoteDefinitions, loadRemoteToolsFromSource, } from "./remote-source-tools.js";
+export type { RemoteToolMaterializationOptions } from "./remote-source-tools.js";
 export { toolRegistry } from "./registry.js";
 export { executeTool } from "./executor.js";
 export type { JsonSchema } from "./schema/index.js";

package/esm/src/tool/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/tool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/tool/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,yBAAyB,CAAC;AAGjC,YAAY,EACV,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,cAAc,EACd,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EACL,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/esm/src/tool/index.js

@@ -45,5 +45,6 @@
 import "../../_dnt.polyfills.js";
 export { dynamicTool, tool } from "./factory.js";
 export { createRemoteMCPToolSource } from "./remote-mcp.js";
+export { createToolsFromRemoteDefinitions, loadRemoteToolsFromSource, } from "./remote-source-tools.js";
 export { toolRegistry } from "./registry.js";
 export { executeTool } from "./executor.js";

package/esm/src/tool/remote-source-tools.d.ts

@@ -0,0 +1,8 @@
+import type { RemoteToolSource, Tool, ToolDefinition, ToolExecutionContext } from "./types.js";
+export interface RemoteToolMaterializationOptions {
+    context?: ToolExecutionContext;
+    toolNameAliases?: Record<string, string>;
+}
+export declare function createToolsFromRemoteDefinitions(source: RemoteToolSource, definitions: readonly ToolDefinition[], options?: Omit<RemoteToolMaterializationOptions, "context">): Record<string, Tool<unknown, unknown>>;
+export declare function loadRemoteToolsFromSource(source: RemoteToolSource, options?: RemoteToolMaterializationOptions): Promise<Record<string, Tool<unknown, unknown>>>;
+//# sourceMappingURL=remote-source-tools.d.ts.map

package/esm/src/tool/remote-source-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-source-tools.d.ts","sourceRoot":"","sources":["../../../src/src/tool/remote-source-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE/F,MAAM,WAAW,gCAAgC;IAC/C,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAUD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,OAAO,GAAE,IAAI,CAAC,gCAAgC,EAAE,SAAS,CAAM,GAC9D,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAsBxC;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAKjD"}

package/esm/src/tool/remote-source-tools.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { dynamicTool } from "./factory.js";
+function toToolInputRecord(input) {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        return {};
+    }
+    return Object.fromEntries(Object.entries(input));
+}
+export function createToolsFromRemoteDefinitions(source, definitions, options = {}) {
+    return Object.fromEntries(definitions.map((definition) => {
+        const toolName = options.toolNameAliases?.[definition.name] ?? definition.name;
+        return [
+            toolName,
+            dynamicTool({
+                id: toolName,
+                description: definition.description,
+                inputSchema: z.object({}).passthrough(),
+                inputSchemaJson: definition.parameters,
+                mcp: {
+                    title: definition.title,
+                    annotations: definition.annotations,
+                },
+                execute: async (input, context) => await source.executeTool(definition.name, toToolInputRecord(input), context),
+            }),
+        ];
+    }));
+}
+export async function loadRemoteToolsFromSource(source, options = {}) {
+    const definitions = await source.listTools(options.context);
+    return createToolsFromRemoteDefinitions(source, definitions, {
+        toolNameAliases: options.toolNameAliases,
+    });
+}

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.161";
+export declare const VERSION = "0.1.163";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.161";
+export const VERSION = "0.1.163";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.161",
+  "version": "0.1.163",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.161",
+  "version": "0.1.163",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/platform/adapters/fs/veryfront/base-operations.ts

@@ -1,7 +1,7 @@
 import type { VeryfrontApiClient } from "../../veryfront-api-client/index.js";
 import { FileCache } from "../cache/file-cache.js";
+import type { ContentContextProvider } from "./file-list-access.js";
 import { PathNormalizer } from "./path-normalizer.js";
-import type { ContentContextProvider } from "./read-operations.js";
 
 export class VeryfrontOperationsBase {
   constructor(

package/src/src/platform/adapters/fs/veryfront/directory-operations.ts

@@ -2,13 +2,9 @@ import { logger as baseLogger } from "../../../../utils/index.js";
 import type { DirectoryEntry } from "./types.js";
 import type { ProjectFile } from "../../veryfront-api-client/index.js";
 import { VeryfrontOperationsBase } from "./base-operations.js";
-import {
-  buildDirCacheKeyPrefix,
-  buildFileCacheKeyPrefix,
-  buildFileListCacheKey,
-} from "./cache-keys.js";
+import { buildDirCacheKeyPrefix } from "./cache-keys.js";
+import { loadAllProjectFiles } from "./file-list-access.js";
 import { withSpan } from "../../../../observability/tracing/otlp-setup.js";
-import { withRetryOnTransient } from "./retry.js";
 
 const logger = baseLogger.component("directory-operations");
 
@@ -154,74 +150,13 @@ export class DirectoryOperations extends VeryfrontOperationsBase {
   }
 
   private getAllFilesRaw(): Promise<ProjectFile[]> {
-    return withSpan("fs.veryfront.getAllFilesRaw", async () => {
-      const cacheStart = performance.now();
-      const ctx = this.contextProvider?.getContentContext();
-      const cacheKeyPrefix = buildFileCacheKeyPrefix(ctx);
-      const skipPersistentCache =
-        this.contextProvider?.isPersistentCacheInvalidated?.(cacheKeyPrefix) ?? false;
-
-      const adapterFiles = !skipPersistentCache
-        ? await this.contextProvider?.getFileList?.()
-        : undefined;
-
-      if (adapterFiles) {
-        const cacheMs = Math.round(performance.now() - cacheStart);
-        logger.debug("getAllFilesRaw - from adapter cache", {
-          cacheMs,
-          fileCount: adapterFiles.length,
-        });
-        return adapterFiles as ProjectFile[];
-      }
-
-      const cacheKey = buildFileListCacheKey(ctx);
-
-      if (skipPersistentCache) {
-        logger.debug("getAllFilesRaw - skipping persistent cache", {
-          cacheKey,
-          cacheKeyPrefix,
-        });
-      }
-
-      const cached = skipPersistentCache
-        ? undefined
-        : await this.cache.getAsync<ProjectFile[]>(cacheKey);
-
-      const cacheMs = Math.round(performance.now() - cacheStart);
-      if (cached) {
-        logger.debug("getAllFilesRaw - fallback cache HIT", {
-          cacheKey,
-          cacheMs,
-          fileCount: cached.length,
-        });
-        return cached;
-      }
-
-      logger.warn("getAllFilesRaw - cache MISS, fetching from API", {
-        cacheKey,
-        cacheMs,
-      });
-
-      const isPublished = ctx?.sourceType !== "branch";
-      logger.debug("Fetching files from API", {
-        sourceType: ctx?.sourceType,
-        cacheKey,
-      });
-
-      const files = await withRetryOnTransient(
-        () =>
-          isPublished
-            ? this.client.listPublishedFiles(
-              undefined,
-              ctx?.releaseId ?? undefined,
-              ctx?.environmentName ?? undefined,
-            )
-            : this.client.listAllFiles(),
-        "getAllFilesRaw (dir)",
-      );
-
-      this.cache.set(cacheKey, files);
-      return files;
-    });
+    return withSpan("fs.veryfront.getAllFilesRaw", () =>
+      loadAllProjectFiles({
+        client: this.client,
+        cache: this.cache,
+        contextProvider: this.contextProvider,
+        logger,
+        operationLabel: "dir",
+      }));
   }
 }

package/src/src/platform/adapters/fs/veryfront/file-list-access.ts

@@ -0,0 +1,109 @@
+import type { ProjectFile, VeryfrontApiClient } from "../../veryfront-api-client/index.js";
+import { FileCache } from "../cache/file-cache.js";
+import { buildFileCacheKeyPrefix, buildFileListCacheKey } from "./cache-keys.js";
+import { withRetryOnTransient } from "./retry.js";
+import type { ResolvedContentContext } from "./types.js";
+
+export interface ContentContextProvider {
+  isProductionMode: () => boolean;
+  getReleaseId: () => string | null;
+  getContentContext: () => ResolvedContentContext | null;
+  getFileList?: () => Promise<
+    Array<{
+      id?: string;
+      path: string;
+      content?: string;
+      type?: string;
+      size?: number;
+      updated_at?: string;
+    }> | undefined
+  >;
+  hasCachedFileList?: () => Promise<boolean>;
+  isPersistentCacheInvalidated?: (prefix: string) => boolean;
+  isReleaseBeingInvalidated?: (releaseId: string) => boolean;
+}
+
+interface FileListLogger {
+  debug(message: string, context?: Record<string, unknown>): void;
+  warn(message: string, context?: Record<string, unknown>): void;
+}
+
+interface LoadAllProjectFilesOptions {
+  client: VeryfrontApiClient;
+  cache: FileCache;
+  contextProvider?: ContentContextProvider;
+  logger: FileListLogger;
+  operationLabel: string;
+}
+
+export async function loadAllProjectFiles({
+  client,
+  cache,
+  contextProvider,
+  logger,
+  operationLabel,
+}: LoadAllProjectFilesOptions): Promise<ProjectFile[]> {
+  const cacheStart = performance.now();
+  const ctx = contextProvider?.getContentContext();
+  const cacheKeyPrefix = buildFileCacheKeyPrefix(ctx);
+  const skipPersistentCache = contextProvider?.isPersistentCacheInvalidated?.(cacheKeyPrefix) ??
+    false;
+
+  const adapterFiles = !skipPersistentCache ? await contextProvider?.getFileList?.() : undefined;
+
+  if (adapterFiles) {
+    const cacheMs = Math.round(performance.now() - cacheStart);
+    logger.debug("getAllFilesRaw - from adapter cache", {
+      cacheMs,
+      fileCount: adapterFiles.length,
+    });
+    return adapterFiles as ProjectFile[];
+  }
+
+  const cacheKey = buildFileListCacheKey(ctx);
+
+  if (skipPersistentCache) {
+    logger.debug("getAllFilesRaw - skipping persistent cache", {
+      cacheKey,
+      cacheKeyPrefix,
+    });
+  }
+
+  const cached = skipPersistentCache ? undefined : await cache.getAsync<ProjectFile[]>(cacheKey);
+  const cacheMs = Math.round(performance.now() - cacheStart);
+
+  if (cached) {
+    logger.debug("getAllFilesRaw - fallback cache HIT", {
+      cacheKey,
+      cacheMs,
+      fileCount: cached.length,
+    });
+    return cached;
+  }
+
+  logger.warn("getAllFilesRaw - cache MISS, fetching from API", {
+    cacheKey,
+    cacheMs,
+  });
+
+  const isPublished = ctx?.sourceType !== "branch";
+  logger.debug("Fetching files from API", {
+    sourceType: ctx?.sourceType,
+    cacheKey,
+  });
+
+  const files = await withRetryOnTransient(
+    () =>
+      isPublished
+        ? client.listPublishedFiles(
+          undefined,
+          ctx?.releaseId ?? undefined,
+          ctx?.environmentName ?? undefined,
+        )
+        : client.listAllFiles(),
+    `getAllFilesRaw (${operationLabel})`,
+  );
+
+  cache.set(cacheKey, files);
+  return files;
+}

package/src/src/platform/adapters/fs/veryfront/read-operations.ts

@@ -7,6 +7,7 @@ import { FileListIndex, type FileListMatchResult } from "./file-list-index.js";
 import { InFlightRequestDeduper } from "./in-flight-dedupe.js";
 import { getRequestScopedFile, setRequestScopedFile } from "./multi-project-adapter.js";
 import { PathNormalizer } from "./path-normalizer.js";
+import type { ContentContextProvider } from "./file-list-access.js";
 import {
   assertProjectSourcePath,
   buildExtensionCandidatePaths,
@@ -28,28 +29,6 @@ export {
 
 const logger = baseLogger.component("read-operations");
 
-export interface ContentContextProvider {
-  isProductionMode: () => boolean;
-  getReleaseId: () => string | null;
-  getContentContext: () => ResolvedContentContext | null;
-  /** Cached file list from adapter initialization (single source of truth) */
-  getFileList?: () => Promise<
-    Array<{
-      id?: string;
-      path: string;
-      content?: string;
-      type?: string;
-      size?: number;
-      updated_at?: string;
-    }> | undefined
-  >;
-  hasCachedFileList?: () => Promise<boolean>;
-  /** True if cache prefix is being deleted - skip persistent cache reads */
-  isPersistentCacheInvalidated?: (prefix: string) => boolean;
-  /** Back-compat: release-scoped invalidation */
-  isReleaseBeingInvalidated?: (releaseId: string) => boolean;
-}
-
 const IN_FLIGHT_REQUEST_TIMEOUT_MS = 15_000;
 const MAX_IN_FLIGHT_REQUESTS = 100;
 const IN_FLIGHT_CLEANUP_INTERVAL_MS = 1_000;