veryfront 0.1.161 → 0.1.162

package/esm/deno.js

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

package/esm/src/platform/adapters/fs/veryfront/base-operations.d.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 declare class VeryfrontOperationsBase {
     protected readonly client: VeryfrontApiClient;
     protected readonly cache: FileCache;

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

@@ -1 +1 @@
-{"version":3,"file":"base-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/base-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,qBAAa,uBAAuB;IAEhC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB;IAC7C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS;IACnC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc;IAC7C,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB;gBAHxC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA;CAE9D"}
+{"version":3,"file":"base-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/base-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,uBAAuB;IAEhC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB;IAC7C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS;IACnC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc;IAC7C,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB;gBAHxC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA;CAE9D"}

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

@@ -1 +1 @@
-{"version":3,"file":"directory-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/directory-operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAgB/D,qBAAa,mBAAoB,SAAQ,uBAAuB;IAC9D,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,YAAY,CAA8B;IAElD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YAsDlC,eAAe;IAa7B,OAAO,CAAC,SAAS;IA6DjB,SAAS,IAAI,IAAI;IAIjB,OAAO,CAAC,cAAc;CAuEvB"}
+{"version":3,"file":"directory-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/directory-operations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAY/D,qBAAa,mBAAoB,SAAQ,uBAAuB;IAC9D,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,YAAY,CAA8B;IAElD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YAsDlC,eAAe;IAa7B,OAAO,CAAC,SAAS;IA6DjB,SAAS,IAAI,IAAI;IAIjB,OAAO,CAAC,cAAc;CAUvB"}

package/esm/src/platform/adapters/fs/veryfront/directory-operations.js

@@ -1,8 +1,8 @@
 import { logger as baseLogger } from "../../../../utils/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");
 export class DirectoryOperations extends VeryfrontOperationsBase {
     dirTree = null;
@@ -110,55 +110,12 @@ export class DirectoryOperations extends VeryfrontOperationsBase {
         this.dirTree = null;
     }
     getAllFilesRaw() {
-        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;
-            }
-            const cacheKey = buildFileListCacheKey(ctx);
-            if (skipPersistentCache) {
-                logger.debug("getAllFilesRaw - skipping persistent cache", {
-                    cacheKey,
-                    cacheKeyPrefix,
-                });
-            }
-            const cached = skipPersistentCache
-                ? undefined
-                : await this.cache.getAsync(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/esm/src/platform/adapters/fs/veryfront/file-list-access.d.ts

@@ -0,0 +1,33 @@
+import type { ProjectFile, VeryfrontApiClient } from "../../veryfront-api-client/index.js";
+import { FileCache } from "../cache/file-cache.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 declare function loadAllProjectFiles({ client, cache, contextProvider, logger, operationLabel, }: LoadAllProjectFilesOptions): Promise<ProjectFile[]>;
+export {};
+//# sourceMappingURL=file-list-access.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-list-access.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/file-list-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACvD,WAAW,CAAC,EAAE,MAAM,OAAO,CACzB,KAAK,CAAC;QACJ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GAAG,SAAS,CACf,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,UAAU,cAAc;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAChE;AAED,UAAU,0BAA0B;IAClC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,mBAAmB,CAAC,EACxC,MAAM,EACN,KAAK,EACL,eAAe,EACf,MAAM,EACN,cAAc,GACf,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAgErD"}

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

@@ -0,0 +1,49 @@
+import { buildFileCacheKeyPrefix, buildFileListCacheKey } from "./cache-keys.js";
+import { withRetryOnTransient } from "./retry.js";
+export async function loadAllProjectFiles({ client, cache, contextProvider, logger, operationLabel, }) {
+    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;
+    }
+    const cacheKey = buildFileListCacheKey(ctx);
+    if (skipPersistentCache) {
+        logger.debug("getAllFilesRaw - skipping persistent cache", {
+            cacheKey,
+            cacheKeyPrefix,
+        });
+    }
+    const cached = skipPersistentCache ? undefined : await cache.getAsync(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/esm/src/platform/adapters/fs/veryfront/read-operations.d.ts

@@ -1,27 +1,8 @@
 import type { VeryfrontApiClient } from "../../veryfront-api-client/index.js";
 import { FileCache } from "../cache/file-cache.js";
 import { PathNormalizer } from "./path-normalizer.js";
-import type { ResolvedContentContext } from "./types.js";
+import type { ContentContextProvider } from "./file-list-access.js";
 export { endRequestMetrics, getContentMetricsSnapshot, resetContentMetrics, startRequestMetrics, } from "./content-metrics.js";
-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;
-}
 export declare class ReadOperations {
     private readonly client;
     private readonly cache;

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

@@ -1 +1 @@
-{"version":3,"file":"read-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAWtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACvD,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,OAAO,CACzB,KAAK,CAAC;QACJ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,GAAG,SAAS,CACf,CAAC;IACF,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,0EAA0E;IAC1E,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,+CAA+C;IAC/C,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAUD,qBAAa,cAAc;IAWvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAfpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI9B;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;gBAGnD,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA,EACxC,kBAAkB,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,aAAA,EAC7C,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAC/C,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CACtD,aAAA;IAKH,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIrD,kBAAkB,IAAI,IAAI;IAK1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,OAAO,CAAC,mBAAmB;YAsBb,+BAA+B;YA0C/B,mBAAmB;IA0CjC,OAAO,CAAC,kBAAkB;YAoFZ,2BAA2B;YA8D3B,uCAAuC;IAmCrD,OAAO,CAAC,oBAAoB;YAgBd,YAAY;YA6JZ,qBAAqB;YA8DrB,qBAAqB;YAgDrB,+BAA+B;YA8D/B,iBAAiB;CAyBhC"}
+{"version":3,"file":"read-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAapE,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAY9B,qBAAa,cAAc;IAWvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAfpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI9B;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;gBAGnD,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA,EACxC,kBAAkB,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,aAAA,EAC7C,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAC/C,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CACtD,aAAA;IAKH,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIrD,kBAAkB,IAAI,IAAI;IAK1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,OAAO,CAAC,mBAAmB;YAsBb,+BAA+B;YA0C/B,mBAAmB;IA0CjC,OAAO,CAAC,kBAAkB;YAoFZ,2BAA2B;YA8D3B,uCAAuC;IAmCrD,OAAO,CAAC,oBAAoB;YAgBd,YAAY;YA6JZ,qBAAqB;YA8DrB,qBAAqB;YAgDrB,+BAA+B;YA8D/B,iBAAiB;CAyBhC"}

package/esm/src/platform/adapters/fs/veryfront/stat-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stat-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/stat-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AA2B/D,qBAAa,cAAe,SAAQ,uBAAuB;IACzD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,qBAAqB,CAA8B;IAE3D,OAAO,CAAC,WAAW,CAAkC;IAErD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAGrC;IAEH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAiHvB,gBAAgB;YAwChB,UAAU;IAkDxB,UAAU,IAAI,IAAI;IAMlB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;YAIpC,cAAc;IAqE5B,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,qBAAqB;YAQf,sBAAsB;YA8EtB,iBAAiB;IASzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAkI1F"}
+{"version":3,"file":"stat-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/stat-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAuB/D,qBAAa,cAAe,SAAQ,uBAAuB;IACzD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,qBAAqB,CAA8B;IAE3D,OAAO,CAAC,WAAW,CAAkC;IAErD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAGrC;IAEH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAiHvB,gBAAgB;YAwChB,UAAU;IAkDxB,UAAU,IAAI,IAAI;IAMlB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;YAIpC,cAAc;IAU5B,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,qBAAqB;YAQf,sBAAsB;YA8EtB,iBAAiB;IASzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAkI1F"}

package/esm/src/platform/adapters/fs/veryfront/stat-operations.js

@@ -2,12 +2,12 @@ import { logger as baseLogger } from "../../../../utils/index.js";
 import { isFrameworkSourcePath } from "../../../../utils/path-utils.js";
 import { VeryfrontOperationsBase } from "./base-operations.js";
 import { createError, toError } from "../../../../errors/index.js";
-import { buildFileCacheKeyPrefix, buildFileListCacheKey, buildStatCacheKeyPrefix, } from "./cache-keys.js";
-import { withRetryOnTransient } from "./retry.js";
+import { buildStatCacheKeyPrefix } from "./cache-keys.js";
 import { STAT_OPERATION_EXTENSION_PRIORITY as EXTENSION_PRIORITY } from "./extension-priority.js";
 import { collectParentDirectories, normalizeIndexedFilePath, resolveByExtensionPriority, resolveIndexByExtensionPriority, sortPathsByExtensionPriority, stripKnownExtension, } from "./stat-operations-helpers.js";
 import { ApiSearchCircuitBreaker } from "./api-search-circuit-breaker.js";
 import { withSpan } from "../../../../observability/tracing/otlp-setup.js";
+import { loadAllProjectFiles } from "./file-list-access.js";
 const logger = baseLogger.component("stat-operations");
 const NOT_FOUND_SENTINEL = "__NOT_FOUND__";
 const API_SEARCH_CIRCUIT_BREAKER_THRESHOLD = 5;
@@ -206,54 +206,13 @@ export class StatOperations extends VeryfrontOperationsBase {
         return this.pathMapping.get(normalizedPath) ?? normalizedPath;
     }
     async getAllFilesRaw() {
-        const cacheStart = performance.now();
-        const ctx = this.contextProvider?.getContentContext();
-        const cacheKeyPrefix = buildFileCacheKeyPrefix(ctx);
-        const skipPersistentCache = this.contextProvider?.isPersistentCacheInvalidated?.(cacheKeyPrefix) ?? false;
-        if (!skipPersistentCache) {
-            const files = await this.contextProvider?.getFileList?.();
-            if (files) {
-                const cacheMs = Math.round(performance.now() - cacheStart);
-                logger.debug("getAllFilesRaw - from adapter cache", {
-                    cacheMs,
-                    fileCount: files.length,
-                });
-                return files;
-            }
-        }
-        const cacheKey = buildFileListCacheKey(ctx);
-        if (skipPersistentCache) {
-            logger.debug("getAllFilesRaw - skipping persistent cache (invalidation)", {
-                cacheKey,
-                cacheKeyPrefix,
-            });
-        }
-        const cached = skipPersistentCache
-            ? undefined
-            : await this.cache.getAsync(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,
+        return await loadAllProjectFiles({
+            client: this.client,
+            cache: this.cache,
+            contextProvider: this.contextProvider,
+            logger,
+            operationLabel: "stat",
         });
-        const files = await withRetryOnTransient(() => isPublished
-            ? this.client.listPublishedFiles(undefined, ctx?.releaseId ?? undefined, ctx?.environmentName ?? undefined)
-            : this.client.listAllFiles(), "getAllFilesRaw (stat)");
-        this.cache.set(cacheKey, files);
-        return files;
     }
     buildResolveSearchPatterns(normalizedPath, options, knownExtensionFallback = "exact") {
         const patterns = new Set();

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.162";
 //# 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.162";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.161",
+  "version": "0.1.162",
   "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.162",
   "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;

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

@@ -4,12 +4,7 @@ import type { FileInfo, ResolveFileOptions } from "../../base.js";
 import type { ProjectFile } from "../../veryfront-api-client/index.js";
 import { VeryfrontOperationsBase } from "./base-operations.js";
 import { createError, toError } from "../../../../errors/index.js";
-import {
-  buildFileCacheKeyPrefix,
-  buildFileListCacheKey,
-  buildStatCacheKeyPrefix,
-} from "./cache-keys.js";
-import { withRetryOnTransient } from "./retry.js";
+import { buildStatCacheKeyPrefix } from "./cache-keys.js";
 import { STAT_OPERATION_EXTENSION_PRIORITY as EXTENSION_PRIORITY } from "./extension-priority.js";
 import {
   collectParentDirectories,
@@ -21,6 +16,7 @@ import {
 } from "./stat-operations-helpers.js";
 import { ApiSearchCircuitBreaker } from "./api-search-circuit-breaker.js";
 import { withSpan } from "../../../../observability/tracing/otlp-setup.js";
+import { loadAllProjectFiles } from "./file-list-access.js";
 
 const logger = baseLogger.component("stat-operations");
 
@@ -258,72 +254,13 @@ export class StatOperations extends VeryfrontOperationsBase {
   }
 
   private async getAllFilesRaw(): Promise<ProjectFile[]> {
-    const cacheStart = performance.now();
-    const ctx = this.contextProvider?.getContentContext();
-    const cacheKeyPrefix = buildFileCacheKeyPrefix(ctx);
-    const skipPersistentCache =
-      this.contextProvider?.isPersistentCacheInvalidated?.(cacheKeyPrefix) ?? false;
-
-    if (!skipPersistentCache) {
-      const files = await this.contextProvider?.getFileList?.();
-      if (files) {
-        const cacheMs = Math.round(performance.now() - cacheStart);
-        logger.debug("getAllFilesRaw - from adapter cache", {
-          cacheMs,
-          fileCount: files.length,
-        });
-        return files as ProjectFile[];
-      }
-    }
-
-    const cacheKey = buildFileListCacheKey(ctx);
-
-    if (skipPersistentCache) {
-      logger.debug("getAllFilesRaw - skipping persistent cache (invalidation)", {
-        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,
+    return await loadAllProjectFiles({
+      client: this.client,
+      cache: this.cache,
+      contextProvider: this.contextProvider,
+      logger,
+      operationLabel: "stat",
     });
-
-    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 (stat)",
-    );
-
-    this.cache.set(cacheKey, files);
-    return files;
   }
 
   private buildResolveSearchPatterns(

package/src/src/tool/factory.ts

@@ -179,20 +179,18 @@ 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 function dynamicTool(config: DynamicToolConfig): Tool<unknown, unknown> {
   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: Tool<unknown, unknown> = {
     id,

package/src/src/tool/index.ts

@@ -57,6 +57,11 @@ 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";
 

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

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { dynamicTool } from "./factory.js";
+import type { RemoteToolSource, Tool, ToolDefinition, ToolExecutionContext } from "./types.js";
+
+export interface RemoteToolMaterializationOptions {
+  context?: ToolExecutionContext;
+  toolNameAliases?: Record<string, string>;
+}
+
+function toToolInputRecord(input: unknown): Record<string, unknown> {
+  if (typeof input !== "object" || input === null || Array.isArray(input)) {
+    return {};
+  }
+
+  return Object.fromEntries(Object.entries(input));
+}
+
+export function createToolsFromRemoteDefinitions(
+  source: RemoteToolSource,
+  definitions: readonly ToolDefinition[],
+  options: Omit<RemoteToolMaterializationOptions, "context"> = {},
+): Record<string, Tool<unknown, unknown>> {
+  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: RemoteToolSource,
+  options: RemoteToolMaterializationOptions = {},
+): Promise<Record<string, Tool<unknown, unknown>>> {
+  const definitions = await source.listTools(options.context);
+  return createToolsFromRemoteDefinitions(source, definitions, {
+    toolNameAliases: options.toolNameAliases,
+  });
+}

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

@@ -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.162";