@superblocksteam/vite-plugin-file-sync 2.0.76 → 2.0.77-next.1

package/dist/ai-service/app-interface/filesystem/handlers/api-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-handler.js","sourceRoot":"","sources":["../../../../../src/ai-service/app-interface/filesystem/handlers/api-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EACR,KAAK,EACL,SAAS,EACT,MAAM,EACN,EAAE,EACF,OAAO,EACP,IAAI,GACL,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AACnG,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,wBAAwB,GACzB,MAAM,8BAA8B,CAAC;AAUtC,gBAAgB;AAChB,MAAM,kBAAkB,GAAG,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;AAC1D,MAAM,oBAAoB,GAAG,kBAAkB,CAC7C,eAAe,EACf,gBAAgB,EAChB,kBAAkB,CACnB,CAAC;AAEF;;;GAGG;AACH,SAAS,oBAAoB,CAAC,YAAoB;IAChD,MAAM,KAAK,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAc,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,KAAK,CAAC;IAEtB,OAAO,CAAC,WAAmB;QACzB,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED,eAAe,CAAC,YAAoB;QAClC,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,WAAmB;QACvB,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1D,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE;oBACN,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC;iBACpD;aACF,CAAC;QACJ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,YAAoB;QAChC,MAAM,KAAK,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACjD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,UAAU,CAAC,KAAK,CAAC,aAAa,EAAE;gBACrC,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,KAAK;aACtC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,OAA2B;QAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAE5B,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;QACvE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,cAAc;QACd,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACrE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAEzD,+DAA+D;QAC/D,+EAA+E;QAC/E,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,YAA8B,CAAC;QACnC,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,SAA2B,CAAC;QAEhC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,CAAC;YAChD,aAAa,GAAG,IAAI,CAAC;YACrB,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1C,UAAU,GAAG,IAAI,CAAC;YAClB,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QAED,gFAAgF;QAChF,MAAM,cAAc,GAClB,aAAa;YACb,YAAY;YACZ,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,IAAI,YAAY,IAAI,SAAS,CAAC,CAAC;QAE3D,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,MAAM,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAED,qDAAqD;QACrD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QAED,yDAAyD;QACzD,MAAM,YAAY,GAAG;YACnB,IAAI,EAAE,MAAe;YACrB,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,EAAE;SACZ,CAAC;QAEF,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,wBAAwB,CAClD,CAAC,YAAY,CAAC,EACd;YACE,IAAI,2BAA2B,CAAC;gBAC9B,cAAc;gBACd,WAAW;gBACX,WAAW,EAAE,IAAI;gBACjB,gBAAgB;aACjB,CAAC;SACH,CACF,CAAC;QAEF,OAAO,WAAW,EAAE,OAAO,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,KAAK,CACT,WAAmB,EACnB,OAAe,EACf,OAA4B;QAE5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,qBAAqB,WAAW,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QACnC,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACrE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAE/D,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,SAAS,CAAC,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,OAA6B;QAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,qBAAqB,WAAW,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;QACtD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,mCAAmC,WAAW,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,gCAAgC;QAChC,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAChE,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAEjE,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACjC,MAAM,IAAI,CAAC,uBAAuB,CAChC,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,YAAY,CACb,CAAC;YACF,MAAM,EAAE,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;QAED,mCAAmC;QACnC,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;YACrC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,CACf,WAAmB,EACnB,OAA2B;QAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAE5B,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QACnC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAE/B,iDAAiD;QACjD,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACrE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAE/D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1C,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK;gBAClB,MAAM,EAAE,IAAI;aACb,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QAED,kBAAkB;QAClB,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAEzD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;YACvC,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK;gBAClB,MAAM,EAAE,IAAI;aACb,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACnC,OAAe,EACf,cAAsB,EACtB,iBAA0D,EAC1D,YAAsB;QAEtB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;YAE7D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,uBAAuB,CAChC,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,YAAY,CACb,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;gBACtC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/ai-service/app-interface/filesystem/handlers/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Virtual file handlers.
+ */
+export { ApiFileHandler } from "./api-handler.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/app-interface/filesystem/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/app-interface/filesystem/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai-service/app-interface/filesystem/handlers/index.js

@@ -0,0 +1,5 @@
+/**
+ * Virtual file handlers.
+ */
+export { ApiFileHandler } from "./api-handler.js";
+//# sourceMappingURL=index.js.map

package/dist/ai-service/app-interface/filesystem/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/ai-service/app-interface/filesystem/handlers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/ai-service/app-interface/filesystem/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Filesystem abstraction layer for AppShell.
+ *
+ * Re-exports all filesystem-related utilities including validation,
+ * virtual filesystem operations, and draft management.
+ */
+export * from "./validation.js";
+export { DraftManager, type DraftChanges } from "./draft-manager.js";
+export type { FileMetadata, VirtualFileHandler, VirtualPathInfo, VirtualReadOptions, VirtualWriteOptions, VirtualDeleteOptions, } from "./virtual-fs-types.js";
+export { VirtualFileSystem, createDefaultVirtualFileSystem, } from "./virtual-file-system.js";
+export { ApiFileHandler } from "./handlers/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-service/app-interface/filesystem/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGrE,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/ai-service/app-interface/filesystem/index.js

@@ -0,0 +1,11 @@
+/**
+ * Filesystem abstraction layer for AppShell.
+ *
+ * Re-exports all filesystem-related utilities including validation,
+ * virtual filesystem operations, and draft management.
+ */
+export * from "./validation.js";
+export { DraftManager } from "./draft-manager.js";
+export { VirtualFileSystem, createDefaultVirtualFileSystem, } from "./virtual-file-system.js";
+export { ApiFileHandler } from "./handlers/index.js";
+//# sourceMappingURL=index.js.map

package/dist/ai-service/app-interface/filesystem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AAWrE,OAAO,EACL,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/ai-service/app-interface/filesystem/validation.d.ts

@@ -0,0 +1,71 @@
+/**
+ * File operation validation utilities.
+ *
+ * Provides centralized validation logic for all filesystem operations,
+ * including blacklist checking, path restrictions, and operation-specific rules.
+ */
+import { type FileOperation, type FileOperationValidationOptions } from "../constants.js";
+/**
+ * Error thrown when a file operation fails validation.
+ */
+export declare class FileValidationError extends Error {
+    readonly code: "BLACKLISTED" | "API_FILE" | "SCOPE_FILE" | "PACKAGE_JSON" | "DIRECT_PAGE" | "ROOT_DIR" | "READ_REQUIRED";
+    constructor(message: string, code: "BLACKLISTED" | "API_FILE" | "SCOPE_FILE" | "PACKAGE_JSON" | "DIRECT_PAGE" | "ROOT_DIR" | "READ_REQUIRED");
+}
+/**
+ * Checks if a path is an API file path (starts with "apis/").
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is an API file path
+ */
+export declare function isApiFilePath(filePath: string): boolean;
+/**
+ * Checks if a path is a direct page path (pages/xyz.tsx rather than pages/xyz/index.tsx).
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is a direct page file
+ */
+export declare function isDirectPagePath(filePath: string): boolean;
+/**
+ * Checks if a path is a scope file.
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is a scope file
+ */
+export declare function isScopeFile(filePath: string): boolean;
+/**
+ * Checks if a path is the package.json file.
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is package.json
+ */
+export declare function isPackageJson(filePath: string): boolean;
+/**
+ * Checks if a path is in the blacklist.
+ *
+ * @param relativePath - Relative path to check
+ * @param appRootDirPath - Application root directory for relative path calculation
+ * @returns Error message if blacklisted, null otherwise
+ */
+export declare function checkBlacklist(relativePath: string, _appRootDirPath: string): string | null;
+/**
+ * Validates a file operation against all applicable rules.
+ *
+ * @param operation - The type of file operation
+ * @param relativePath - Relative path of the file
+ * @param appRootDirPath - Application root directory
+ * @param options - Optional validation options to override defaults
+ * @throws FileValidationError if validation fails
+ */
+export declare function validateFileOperation(operation: FileOperation, relativePath: string, appRootDirPath: string, options?: Partial<FileOperationValidationOptions>): void;
+/**
+ * Recursively checks if a directory contains any blacklisted content.
+ *
+ * @param entries - Directory entries to scan
+ * @returns Error message if blacklisted content found, null otherwise
+ */
+export declare function checkDirectoryContentBlacklist(entries: Array<{
+    name: string;
+    isDirectory: boolean;
+}>): string | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/ai-service/app-interface/filesystem/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,8BAA8B,EACpC,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,IAAI,EAChB,aAAa,GACb,UAAU,GACV,YAAY,GACZ,cAAc,GACd,aAAa,GACb,UAAU,GACV,eAAe;gBARnB,OAAO,EAAE,MAAM,EACC,IAAI,EAChB,aAAa,GACb,UAAU,GACV,YAAY,GACZ,cAAc,GACd,aAAa,GACb,UAAU,GACV,eAAe;CAKtB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAcD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,MAAM,GAAG,IAAI,CAoDf;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAChD,IAAI,CA6CN;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,GACrD,MAAM,GAAG,IAAI,CA8Bf"}

package/dist/ai-service/app-interface/filesystem/validation.js

@@ -0,0 +1,170 @@
+/**
+ * File operation validation utilities.
+ *
+ * Provides centralized validation logic for all filesystem operations,
+ * including blacklist checking, path restrictions, and operation-specific rules.
+ */
+import path from "node:path";
+import { FILE_OPERATION_BLACKLIST, DEFAULT_VALIDATION_OPTIONS, } from "../constants.js";
+/**
+ * Error thrown when a file operation fails validation.
+ */
+export class FileValidationError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "FileValidationError";
+    }
+}
+/**
+ * Checks if a path is an API file path (starts with "apis/").
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is an API file path
+ */
+export function isApiFilePath(filePath) {
+    return filePath.startsWith("apis/");
+}
+/**
+ * Checks if a path is a direct page path (pages/xyz.tsx rather than pages/xyz/index.tsx).
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is a direct page file
+ */
+export function isDirectPagePath(filePath) {
+    return /^pages\/[^/]+\.tsx$/.test(filePath);
+}
+/**
+ * Checks if a path is a scope file.
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is a scope file
+ */
+export function isScopeFile(filePath) {
+    return filePath === "scope.ts" || filePath.endsWith("/scope.ts");
+}
+/**
+ * Checks if a path is the package.json file.
+ *
+ * @param filePath - Relative file path to check
+ * @returns true if the path is package.json
+ */
+export function isPackageJson(filePath) {
+    return filePath === "package.json" || filePath.endsWith("/package.json");
+}
+/**
+ * Checks if a file name matches any of the protected patterns.
+ *
+ * @param fileName - The file name (not full path) to check
+ * @returns true if the file name is protected
+ */
+function matchesProtectedPattern(fileName) {
+    return FILE_OPERATION_BLACKLIST.patterns.some((pattern) => pattern.test(fileName));
+}
+/**
+ * Checks if a path is in the blacklist.
+ *
+ * @param relativePath - Relative path to check
+ * @param appRootDirPath - Application root directory for relative path calculation
+ * @returns Error message if blacklisted, null otherwise
+ */
+export function checkBlacklist(relativePath, _appRootDirPath) {
+    const fileName = path.basename(relativePath);
+    // Check if it's the app root
+    if (relativePath === "" || relativePath === ".") {
+        return "Cannot operate on the application root directory";
+    }
+    // Check exact paths
+    if (FILE_OPERATION_BLACKLIST.exactPaths.includes(fileName)) {
+        return `Cannot operate on protected file: ${fileName}`;
+    }
+    // Check protected directories
+    if (FILE_OPERATION_BLACKLIST.directories.includes(fileName)) {
+        return `Cannot operate on protected directory: ${fileName}`;
+    }
+    // Check if path starts with a protected directory
+    const firstDir = relativePath.split("/")[0];
+    if (firstDir &&
+        FILE_OPERATION_BLACKLIST.directories.includes(firstDir)) {
+        // Special case: apis directory is allowed for virtual file operations
+        if (firstDir === "apis") {
+            return null;
+        }
+        // Special case: pages directory - allow files in subdirectories
+        // Direct page paths like pages/Foo.tsx will be caught by isDirectPagePath check
+        if (firstDir === "pages") {
+            return null;
+        }
+        return `Cannot operate on files in protected directory: ${firstDir}`;
+    }
+    // Check patterns
+    if (matchesProtectedPattern(fileName)) {
+        return `Cannot operate on protected file matching pattern: ${fileName}`;
+    }
+    return null;
+}
+/**
+ * Validates a file operation against all applicable rules.
+ *
+ * @param operation - The type of file operation
+ * @param relativePath - Relative path of the file
+ * @param appRootDirPath - Application root directory
+ * @param options - Optional validation options to override defaults
+ * @throws FileValidationError if validation fails
+ */
+export function validateFileOperation(operation, relativePath, appRootDirPath, options) {
+    const opts = {
+        ...DEFAULT_VALIDATION_OPTIONS[operation],
+        ...options,
+    };
+    // Check blacklist
+    if (opts.checkBlacklist) {
+        const blacklistError = checkBlacklist(relativePath, appRootDirPath);
+        if (blacklistError) {
+            throw new FileValidationError(blacklistError, "BLACKLISTED");
+        }
+    }
+    // Check API files
+    if (!opts.allowApiFiles && isApiFilePath(relativePath)) {
+        throw new FileValidationError(`Directly ${operation === "write" ? "writing to" : operation === "delete" ? "deleting" : "operating on"} API files is not allowed. Use the API interface instead.`, "API_FILE");
+    }
+    // Check scope files
+    if (!opts.allowScopeFiles && isScopeFile(relativePath)) {
+        throw new FileValidationError("Directly operating on scope files is not allowed. Use the appropriate tool.", "SCOPE_FILE");
+    }
+    // Check package.json
+    if (!opts.allowPackageJson && isPackageJson(relativePath)) {
+        throw new FileValidationError("Directly editing package.json is not allowed. Use the build_installPackages tool instead.", "PACKAGE_JSON");
+    }
+    // Check direct page paths
+    if (!opts.allowDirectPagePath && isDirectPagePath(relativePath)) {
+        throw new FileValidationError("Direct file creation in the pages directory is not allowed. Please create files within subdirectories (e.g., pages/yourFeature/index.tsx)", "DIRECT_PAGE");
+    }
+}
+/**
+ * Recursively checks if a directory contains any blacklisted content.
+ *
+ * @param entries - Directory entries to scan
+ * @returns Error message if blacklisted content found, null otherwise
+ */
+export function checkDirectoryContentBlacklist(entries) {
+    for (const entry of entries) {
+        const fileName = entry.name;
+        // Check exact paths
+        if (FILE_OPERATION_BLACKLIST.exactPaths.includes(fileName)) {
+            return `Cannot remove protected file: ${fileName}`;
+        }
+        // Check protected directories
+        if (entry.isDirectory &&
+            FILE_OPERATION_BLACKLIST.directories.includes(fileName)) {
+            return `Cannot remove protected directory: ${fileName}`;
+        }
+        // Check patterns
+        if (matchesProtectedPattern(fileName)) {
+            return `Cannot remove protected file matching pattern: ${fileName}`;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=validation.js.map

package/dist/ai-service/app-interface/filesystem/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,0BAA0B,GAG3B,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAG1B;IAFlB,YACE,OAAe,EACC,IAOG;QAEnB,KAAK,CAAC,OAAO,CAAC,CAAC;QATC,SAAI,GAAJ,IAAI,CAOD;QAGnB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,QAAQ,KAAK,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,QAAQ,KAAK,cAAc,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,SAAS,uBAAuB,CAAC,QAAgB;IAC/C,OAAO,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CACxD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CACvB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,YAAoB,EACpB,eAAuB;IAEvB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAE7C,6BAA6B;IAC7B,IAAI,YAAY,KAAK,EAAE,IAAI,YAAY,KAAK,GAAG,EAAE,CAAC;QAChD,OAAO,kDAAkD,CAAC;IAC5D,CAAC;IAED,oBAAoB;IACpB,IACE,wBAAwB,CAAC,UAAU,CAAC,QAAQ,CAC1C,QAAgE,CACjE,EACD,CAAC;QACD,OAAO,qCAAqC,QAAQ,EAAE,CAAC;IACzD,CAAC;IAED,8BAA8B;IAC9B,IACE,wBAAwB,CAAC,WAAW,CAAC,QAAQ,CAC3C,QAAiE,CAClE,EACD,CAAC;QACD,OAAO,0CAA0C,QAAQ,EAAE,CAAC;IAC9D,CAAC;IAED,kDAAkD;IAClD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IACE,QAAQ;QACR,wBAAwB,CAAC,WAAW,CAAC,QAAQ,CAC3C,QAAiE,CAClE,EACD,CAAC;QACD,sEAAsE;QACtE,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,gEAAgE;QAChE,gFAAgF;QAChF,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,mDAAmD,QAAQ,EAAE,CAAC;IACvE,CAAC;IAED,iBAAiB;IACjB,IAAI,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,OAAO,sDAAsD,QAAQ,EAAE,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAwB,EACxB,YAAoB,EACpB,cAAsB,EACtB,OAAiD;IAEjD,MAAM,IAAI,GAAG;QACX,GAAG,0BAA0B,CAAC,SAAS,CAAC;QACxC,GAAG,OAAO;KACX,CAAC;IAEF,kBAAkB;IAClB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,cAAc,GAAG,cAAc,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QACpE,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,IAAI,mBAAmB,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,mBAAmB,CAC3B,YAAY,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,2DAA2D,EAClK,UAAU,CACX,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,mBAAmB,CAC3B,6EAA6E,EAC7E,YAAY,CACb,CAAC;IACJ,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,mBAAmB,CAC3B,2FAA2F,EAC3F,cAAc,CACf,CAAC;IACJ,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC,IAAI,CAAC,mBAAmB,IAAI,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,mBAAmB,CAC3B,2IAA2I,EAC3I,aAAa,CACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAsD;IAEtD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;QAE5B,oBAAoB;QACpB,IACE,wBAAwB,CAAC,UAAU,CAAC,QAAQ,CAC1C,QAAgE,CACjE,EACD,CAAC;YACD,OAAO,iCAAiC,QAAQ,EAAE,CAAC;QACrD,CAAC;QAED,8BAA8B;QAC9B,IACE,KAAK,CAAC,WAAW;YACjB,wBAAwB,CAAC,WAAW,CAAC,QAAQ,CAC3C,QAAiE,CAClE,EACD,CAAC;YACD,OAAO,sCAAsC,QAAQ,EAAE,CAAC;QAC1D,CAAC;QAED,iBAAiB;QACjB,IAAI,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtC,OAAO,kDAAkD,QAAQ,EAAE,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ai-service/app-interface/filesystem/virtual-file-system.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Virtual filesystem manager.
+ *
+ * Coordinates multiple virtual file handlers to provide a unified
+ * interface for reading, writing, and listing files that may have
+ * different physical representations.
+ */
+import type { VirtualFileHandler, VirtualPathInfo, VirtualReadOptions, VirtualWriteOptions, VirtualDeleteOptions } from "./virtual-fs-types.js";
+/**
+ * Manages virtual file handlers and routes operations to the appropriate handler.
+ *
+ * Usage:
+ * ```typescript
+ * const vfs = new VirtualFileSystem();
+ * vfs.registerHandler(new ApiFileHandler());
+ *
+ * // Check if a path is virtual
+ * if (vfs.isVirtualPath("apis/MyAPI.ts")) {
+ *   const content = await vfs.read("apis/MyAPI.ts", options);
+ * }
+ * ```
+ */
+export declare class VirtualFileSystem {
+    private handlers;
+    /**
+     * Register a handler for a type of virtual file.
+     *
+     * @param handler - The handler to register
+     */
+    registerHandler(handler: VirtualFileHandler): void;
+    /**
+     * Get all registered handlers.
+     */
+    getHandlers(): readonly VirtualFileHandler[];
+    /**
+     * Find the handler for a virtual path.
+     *
+     * @param virtualPath - The virtual path to look up
+     * @returns The matching handler, or undefined if none match
+     */
+    getHandler(virtualPath: string): VirtualFileHandler | undefined;
+    /**
+     * Find the handler for a physical path.
+     *
+     * @param physicalPath - The physical path to look up
+     * @returns The matching handler, or undefined if none match
+     */
+    getHandlerForPhysical(physicalPath: string): VirtualFileHandler | undefined;
+    /**
+     * Check if a path is a virtual path managed by any handler.
+     *
+     * @param path - The path to check
+     * @returns true if any handler manages this path
+     */
+    isVirtualPath(path: string): boolean;
+    /**
+     * Parse a virtual path to extract metadata.
+     *
+     * @param virtualPath - The virtual path to parse
+     * @returns Parsed info or undefined if not a virtual path
+     */
+    parse(virtualPath: string): VirtualPathInfo | undefined;
+    /**
+     * Convert a physical path to its virtual representation.
+     *
+     * @param physicalPath - The physical path to convert
+     * @returns The virtual path, or the original path if not managed by any handler
+     */
+    toVirtualPath(physicalPath: string): string;
+    /**
+     * Convert a list of physical paths to virtual paths, deduplicating as needed.
+     *
+     * @param physicalPaths - The physical paths to convert
+     * @returns Array of virtual paths (deduplicated)
+     */
+    toVirtualPaths(physicalPaths: string[]): string[];
+    /**
+     * Read content from a virtual file.
+     *
+     * @param virtualPath - The virtual path to read
+     * @param options - Read options
+     * @returns The file content, or undefined if not found or not a virtual path
+     */
+    read(virtualPath: string, options: VirtualReadOptions): Promise<string | undefined>;
+    /**
+     * Write content to a virtual file.
+     *
+     * @param virtualPath - The virtual path to write
+     * @param content - The content to write
+     * @param options - Write options
+     * @throws Error if path is not managed by any handler
+     */
+    write(virtualPath: string, content: string, options: VirtualWriteOptions): Promise<void>;
+    /**
+     * Delete a virtual file.
+     *
+     * @param virtualPath - The virtual path to delete
+     * @param options - Delete options
+     * @returns List of physical paths that were deleted
+     * @throws Error if path is not managed by any handler
+     */
+    delete(virtualPath: string, options: VirtualDeleteOptions): Promise<string[]>;
+}
+/**
+ * Create a VirtualFileSystem with the default handlers registered.
+ */
+export declare function createDefaultVirtualFileSystem(): VirtualFileSystem;
+//# sourceMappingURL=virtual-file-system.d.ts.map

package/dist/ai-service/app-interface/filesystem/virtual-file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-file-system.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/virtual-file-system.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAA4B;IAE5C;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAIlD;;OAEG;IACH,WAAW,IAAI,SAAS,kBAAkB,EAAE;IAI5C;;;;;OAKG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI/D;;;;;OAKG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI3E;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;;OAKG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAKvD;;;;;OAKG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAU3C;;;;;OAKG;IACH,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAUjD;;;;;;OAMG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAQ9B;;;;;;;OAOG;IACG,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;;;;OAOG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC;CAOrB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,iBAAiB,CAIlE"}

package/dist/ai-service/app-interface/filesystem/virtual-file-system.js

@@ -0,0 +1,157 @@
+/**
+ * Virtual filesystem manager.
+ *
+ * Coordinates multiple virtual file handlers to provide a unified
+ * interface for reading, writing, and listing files that may have
+ * different physical representations.
+ */
+import { ApiFileHandler } from "./handlers/api-handler.js";
+/**
+ * Manages virtual file handlers and routes operations to the appropriate handler.
+ *
+ * Usage:
+ * ```typescript
+ * const vfs = new VirtualFileSystem();
+ * vfs.registerHandler(new ApiFileHandler());
+ *
+ * // Check if a path is virtual
+ * if (vfs.isVirtualPath("apis/MyAPI.ts")) {
+ *   const content = await vfs.read("apis/MyAPI.ts", options);
+ * }
+ * ```
+ */
+export class VirtualFileSystem {
+    handlers = [];
+    /**
+     * Register a handler for a type of virtual file.
+     *
+     * @param handler - The handler to register
+     */
+    registerHandler(handler) {
+        this.handlers.push(handler);
+    }
+    /**
+     * Get all registered handlers.
+     */
+    getHandlers() {
+        return this.handlers;
+    }
+    /**
+     * Find the handler for a virtual path.
+     *
+     * @param virtualPath - The virtual path to look up
+     * @returns The matching handler, or undefined if none match
+     */
+    getHandler(virtualPath) {
+        return this.handlers.find((h) => h.matches(virtualPath));
+    }
+    /**
+     * Find the handler for a physical path.
+     *
+     * @param physicalPath - The physical path to look up
+     * @returns The matching handler, or undefined if none match
+     */
+    getHandlerForPhysical(physicalPath) {
+        return this.handlers.find((h) => h.matchesPhysical(physicalPath));
+    }
+    /**
+     * Check if a path is a virtual path managed by any handler.
+     *
+     * @param path - The path to check
+     * @returns true if any handler manages this path
+     */
+    isVirtualPath(path) {
+        return this.handlers.some((h) => h.matches(path));
+    }
+    /**
+     * Parse a virtual path to extract metadata.
+     *
+     * @param virtualPath - The virtual path to parse
+     * @returns Parsed info or undefined if not a virtual path
+     */
+    parse(virtualPath) {
+        const handler = this.getHandler(virtualPath);
+        return handler?.parse(virtualPath);
+    }
+    /**
+     * Convert a physical path to its virtual representation.
+     *
+     * @param physicalPath - The physical path to convert
+     * @returns The virtual path, or the original path if not managed by any handler
+     */
+    toVirtualPath(physicalPath) {
+        for (const handler of this.handlers) {
+            const virtualPath = handler.toVirtualPath(physicalPath);
+            if (virtualPath) {
+                return virtualPath;
+            }
+        }
+        return physicalPath;
+    }
+    /**
+     * Convert a list of physical paths to virtual paths, deduplicating as needed.
+     *
+     * @param physicalPaths - The physical paths to convert
+     * @returns Array of virtual paths (deduplicated)
+     */
+    toVirtualPaths(physicalPaths) {
+        const virtualPaths = new Set();
+        for (const physPath of physicalPaths) {
+            virtualPaths.add(this.toVirtualPath(physPath));
+        }
+        return Array.from(virtualPaths);
+    }
+    /**
+     * Read content from a virtual file.
+     *
+     * @param virtualPath - The virtual path to read
+     * @param options - Read options
+     * @returns The file content, or undefined if not found or not a virtual path
+     */
+    async read(virtualPath, options) {
+        const handler = this.getHandler(virtualPath);
+        if (!handler) {
+            return undefined;
+        }
+        return await handler.read(virtualPath, options);
+    }
+    /**
+     * Write content to a virtual file.
+     *
+     * @param virtualPath - The virtual path to write
+     * @param content - The content to write
+     * @param options - Write options
+     * @throws Error if path is not managed by any handler
+     */
+    async write(virtualPath, content, options) {
+        const handler = this.getHandler(virtualPath);
+        if (!handler) {
+            throw new Error(`No handler found for virtual path: ${virtualPath}`);
+        }
+        await handler.write(virtualPath, content, options);
+    }
+    /**
+     * Delete a virtual file.
+     *
+     * @param virtualPath - The virtual path to delete
+     * @param options - Delete options
+     * @returns List of physical paths that were deleted
+     * @throws Error if path is not managed by any handler
+     */
+    async delete(virtualPath, options) {
+        const handler = this.getHandler(virtualPath);
+        if (!handler) {
+            throw new Error(`No handler found for virtual path: ${virtualPath}`);
+        }
+        return await handler.delete(virtualPath, options);
+    }
+}
+/**
+ * Create a VirtualFileSystem with the default handlers registered.
+ */
+export function createDefaultVirtualFileSystem() {
+    const vfs = new VirtualFileSystem();
+    vfs.registerHandler(new ApiFileHandler());
+    return vfs;
+}
+//# sourceMappingURL=virtual-file-system.js.map

package/dist/ai-service/app-interface/filesystem/virtual-file-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-file-system.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/virtual-file-system.ts"],"names":[],"mappings":"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"}