@superblocksteam/vite-plugin-file-sync 2.0.86 → 2.0.87-next.0

package/dist/ai-service/app-interface/filesystem/sdk-path-validator.d.ts

@@ -0,0 +1,50 @@
+/**
+ * SDK mode path validator implementation.
+ *
+ * Handles path validation for the nested template structure:
+ * - APIs: server/apis/ApiName/api.ts
+ * - Pages: client/pages/PageName/index.tsx
+ * - App root: client/App.tsx
+ * - No scope files in SDK mode
+ */
+import type { PathValidator } from "./path-validator.js";
+/**
+ * Path validator for SDK mode (nested structure).
+ *
+ * In SDK mode:
+ * - APIs are at server/apis/ (e.g., server/apis/MyApi/api.ts)
+ * - Pages are at client/pages/ (e.g., client/pages/Home/index.tsx)
+ * - App root is client/App.tsx
+ * - Scope files do not exist in SDK mode
+ */
+export declare class SdkPathValidator implements PathValidator {
+    readonly apiPrefix = "server/apis";
+    readonly pagesPrefix = "client/pages";
+    readonly appRoot = "client/App.tsx";
+    /**
+     * Checks if a path is an API file path.
+     * In SDK mode, API files start with "server/apis/".
+     */
+    isApiFilePath(filePath: string): boolean;
+    /**
+     * Checks if a path is a direct page path (client/pages/xyz.tsx rather than client/pages/xyz/index.tsx).
+     * Direct page paths are not allowed - pages must be in subdirectories.
+     */
+    isDirectPagePath(filePath: string): boolean;
+    /**
+     * Checks if a path is a scope file.
+     * SDK mode does not use scope files, so this always returns false.
+     */
+    isScopeFile(_filePath: string): boolean;
+    /**
+     * Get directories that are protected from modification.
+     * In SDK mode, pages are under client/pages, not at root level.
+     */
+    getProtectedDirectories(): readonly string[];
+    /**
+     * Check if a path should bypass blacklist checks.
+     * In SDK mode, server/apis/ and client/pages/ directories have special handling.
+     */
+    shouldBypassBlacklist(relativePath: string, _firstDir: string): boolean;
+}
+//# sourceMappingURL=sdk-path-validator.d.ts.map

package/dist/ai-service/app-interface/filesystem/sdk-path-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-path-validator.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/sdk-path-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACpD,QAAQ,CAAC,SAAS,iBAAiB;IACnC,QAAQ,CAAC,WAAW,kBAAkB;IACtC,QAAQ,CAAC,OAAO,oBAAoB;IAEpC;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI3C;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIvC;;;OAGG;IACH,uBAAuB,IAAI,SAAS,MAAM,EAAE;IAI5C;;;OAGG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAYxE"}

package/dist/ai-service/app-interface/filesystem/sdk-path-validator.js

@@ -0,0 +1,68 @@
+/**
+ * SDK mode path validator implementation.
+ *
+ * Handles path validation for the nested template structure:
+ * - APIs: server/apis/ApiName/api.ts
+ * - Pages: client/pages/PageName/index.tsx
+ * - App root: client/App.tsx
+ * - No scope files in SDK mode
+ */
+/**
+ * Path validator for SDK mode (nested structure).
+ *
+ * In SDK mode:
+ * - APIs are at server/apis/ (e.g., server/apis/MyApi/api.ts)
+ * - Pages are at client/pages/ (e.g., client/pages/Home/index.tsx)
+ * - App root is client/App.tsx
+ * - Scope files do not exist in SDK mode
+ */
+export class SdkPathValidator {
+    apiPrefix = "server/apis";
+    pagesPrefix = "client/pages";
+    appRoot = "client/App.tsx";
+    /**
+     * Checks if a path is an API file path.
+     * In SDK mode, API files start with "server/apis/".
+     */
+    isApiFilePath(filePath) {
+        return filePath.startsWith("server/apis/");
+    }
+    /**
+     * Checks if a path is a direct page path (client/pages/xyz.tsx rather than client/pages/xyz/index.tsx).
+     * Direct page paths are not allowed - pages must be in subdirectories.
+     */
+    isDirectPagePath(filePath) {
+        return /^client\/pages\/[^/]+\.tsx$/.test(filePath);
+    }
+    /**
+     * Checks if a path is a scope file.
+     * SDK mode does not use scope files, so this always returns false.
+     */
+    isScopeFile(_filePath) {
+        return false;
+    }
+    /**
+     * Get directories that are protected from modification.
+     * In SDK mode, pages are under client/pages, not at root level.
+     */
+    getProtectedDirectories() {
+        return [".git", "node_modules", ".superblocks"];
+    }
+    /**
+     * Check if a path should bypass blacklist checks.
+     * In SDK mode, server/apis/ and client/pages/ directories have special handling.
+     */
+    shouldBypassBlacklist(relativePath, _firstDir) {
+        // server/apis/ directory is allowed for API file operations
+        if (relativePath.startsWith("server/apis/")) {
+            return true;
+        }
+        // client/pages/ directory - allow files in subdirectories
+        // Direct page paths like client/pages/Foo.tsx will be caught by isDirectPagePath check
+        if (relativePath.startsWith("client/pages/")) {
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=sdk-path-validator.js.map

package/dist/ai-service/app-interface/filesystem/sdk-path-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-path-validator.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/sdk-path-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAClB,SAAS,GAAG,aAAa,CAAC;IAC1B,WAAW,GAAG,cAAc,CAAC;IAC7B,OAAO,GAAG,gBAAgB,CAAC;IAEpC;;;OAGG;IACH,aAAa,CAAC,QAAgB;QAC5B,OAAO,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,QAAgB;QAC/B,OAAO,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,SAAiB;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,uBAAuB;QACrB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,CAAU,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,qBAAqB,CAAC,YAAoB,EAAE,SAAiB;QAC3D,4DAA4D;QAC5D,IAAI,YAAY,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,0DAA0D;QAC1D,uFAAuF;QACvF,IAAI,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

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

@@ -3,8 +3,19 @@
  *
  * Provides centralized validation logic for all filesystem operations,
  * including blacklist checking, path restrictions, and operation-specific rules.
+ *
+ * Supports both YAML mode (flat structure) and SDK mode (nested structure)
+ * through the PathValidator abstraction.
  */
 import { type FileOperation, type FileOperationValidationOptions } from "../constants.js";
+import type { PathValidator } from "./path-validator.js";
+/**
+ * Creates the appropriate path validator based on feature flag.
+ *
+ * @param sdkApiEnabled - Whether SDK API mode is enabled
+ * @returns PathValidator implementation for the appropriate mode
+ */
+export declare function createPathValidator(sdkApiEnabled: boolean): PathValidator;
 /**
  * Error thrown when a file operation fails validation.
  */
@@ -13,26 +24,29 @@ export declare class FileValidationError extends Error {
     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/").
+ * Checks if a path is an API file path.
  *
  * @param filePath - Relative file path to check
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns true if the path is an API file path
  */
-export declare function isApiFilePath(filePath: string): boolean;
+export declare function isApiFilePath(filePath: string, validator?: PathValidator): 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
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns true if the path is a direct page file
  */
-export declare function isDirectPagePath(filePath: string): boolean;
+export declare function isDirectPagePath(filePath: string, validator?: PathValidator): boolean;
 /**
  * Checks if a path is a scope file.
  *
  * @param filePath - Relative file path to check
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns true if the path is a scope file
  */
-export declare function isScopeFile(filePath: string): boolean;
+export declare function isScopeFile(filePath: string, validator?: PathValidator): boolean;
 /**
  * Checks if a path is the package.json file.
  *
@@ -44,10 +58,11 @@ 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
+ * @param _appRootDirPath - Application root directory for relative path calculation
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns Error message if blacklisted, null otherwise
  */
-export declare function checkBlacklist(relativePath: string, _appRootDirPath: string): string | null;
+export declare function checkBlacklist(relativePath: string, _appRootDirPath: string, validator?: PathValidator): string | null;
 /**
  * Validates a file operation against all applicable rules.
  *
@@ -55,17 +70,19 @@ export declare function checkBlacklist(relativePath: string, _appRootDirPath: st
  * @param relativePath - Relative path of the file
  * @param appRootDirPath - Application root directory
  * @param options - Optional validation options to override defaults
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @throws FileValidationError if validation fails
  */
-export declare function validateFileOperation(operation: FileOperation, relativePath: string, appRootDirPath: string, options?: Partial<FileOperationValidationOptions>): void;
+export declare function validateFileOperation(operation: FileOperation, relativePath: string, appRootDirPath: string, options?: Partial<FileOperationValidationOptions>, validator?: PathValidator): void;
 /**
  * Recursively checks if a directory contains any blacklisted content.
  *
  * @param entries - Directory entries to scan
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns Error message if blacklisted content found, null otherwise
  */
 export declare function checkDirectoryContentBlacklist(entries: Array<{
     name: string;
     isDirectory: boolean;
-}>): string | null;
+}>, validator?: PathValidator): string | null;
 //# sourceMappingURL=validation.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,8BAA8B,EACpC,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,OAAO,GAAG,aAAa,CAEzE;AAKD;;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;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,aAAgC,GAC1C,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,aAAgC,GAC1C,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,aAAgC,GAC1C,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAcD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,SAAS,GAAE,aAAgC,GAC1C,MAAM,GAAG,IAAI,CA+Cf;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,EACjD,SAAS,GAAE,aAAgC,GAC1C,IAAI,CAkDN;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,EACtD,SAAS,GAAE,aAAgC,GAC1C,MAAM,GAAG,IAAI,CA2Bf"}

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

@@ -3,9 +3,25 @@
  *
  * Provides centralized validation logic for all filesystem operations,
  * including blacklist checking, path restrictions, and operation-specific rules.
+ *
+ * Supports both YAML mode (flat structure) and SDK mode (nested structure)
+ * through the PathValidator abstraction.
  */
 import path from "node:path";
 import { FILE_OPERATION_BLACKLIST, DEFAULT_VALIDATION_OPTIONS, } from "../constants.js";
+import { SdkPathValidator } from "./sdk-path-validator.js";
+import { YamlPathValidator } from "./yaml-path-validator.js";
+/**
+ * Creates the appropriate path validator based on feature flag.
+ *
+ * @param sdkApiEnabled - Whether SDK API mode is enabled
+ * @returns PathValidator implementation for the appropriate mode
+ */
+export function createPathValidator(sdkApiEnabled) {
+    return sdkApiEnabled ? new SdkPathValidator() : new YamlPathValidator();
+}
+/** Default path validator (YAML mode for backwards compatibility) */
+const defaultValidator = new YamlPathValidator();
 /**
  * Error thrown when a file operation fails validation.
  */
@@ -18,31 +34,34 @@ export class FileValidationError extends Error {
     }
 }
 /**
- * Checks if a path is an API file path (starts with "apis/").
+ * Checks if a path is an API file path.
  *
  * @param filePath - Relative file path to check
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns true if the path is an API file path
  */
-export function isApiFilePath(filePath) {
-    return filePath.startsWith("apis/");
+export function isApiFilePath(filePath, validator = defaultValidator) {
+    return validator.isApiFilePath(filePath);
 }
 /**
  * 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
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns true if the path is a direct page file
  */
-export function isDirectPagePath(filePath) {
-    return /^pages\/[^/]+\.tsx$/.test(filePath);
+export function isDirectPagePath(filePath, validator = defaultValidator) {
+    return validator.isDirectPagePath(filePath);
 }
 /**
  * Checks if a path is a scope file.
  *
  * @param filePath - Relative file path to check
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns true if the path is a scope file
  */
-export function isScopeFile(filePath) {
-    return filePath === "scope.ts" || filePath.endsWith("/scope.ts");
+export function isScopeFile(filePath, validator = defaultValidator) {
+    return validator.isScopeFile(filePath);
 }
 /**
  * Checks if a path is the package.json file.
@@ -66,10 +85,11 @@ function matchesProtectedPattern(fileName) {
  * Checks if a path is in the blacklist.
  *
  * @param relativePath - Relative path to check
- * @param appRootDirPath - Application root directory for relative path calculation
+ * @param _appRootDirPath - Application root directory for relative path calculation
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns Error message if blacklisted, null otherwise
  */
-export function checkBlacklist(relativePath, _appRootDirPath) {
+export function checkBlacklist(relativePath, _appRootDirPath, validator = defaultValidator) {
     const fileName = path.basename(relativePath);
     // Check if it's the app root
     if (relativePath === "" || relativePath === ".") {
@@ -79,25 +99,26 @@ export function checkBlacklist(relativePath, _appRootDirPath) {
     if (FILE_OPERATION_BLACKLIST.exactPaths.includes(fileName)) {
         return `Cannot operate on protected file: ${fileName}`;
     }
+    // Get protected directories from validator
+    const protectedDirs = validator.getProtectedDirectories();
     // Check protected directories
-    if (FILE_OPERATION_BLACKLIST.directories.includes(fileName)) {
+    if (protectedDirs.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") {
+    if (firstDir && protectedDirs.includes(firstDir)) {
+        // Check if validator allows this path to bypass blacklist
+        if (validator.shouldBypassBlacklist(relativePath, firstDir)) {
             return null;
         }
         return `Cannot operate on files in protected directory: ${firstDir}`;
     }
+    // For SDK mode, also check nested protected paths (e.g., client/pages)
+    // Allow special directories like server/apis/ and client/pages/
+    if (validator.shouldBypassBlacklist(relativePath, firstDir ?? "")) {
+        return null;
+    }
     // Check patterns
     if (matchesProtectedPattern(fileName)) {
         return `Cannot operate on protected file matching pattern: ${fileName}`;
@@ -111,26 +132,27 @@ export function checkBlacklist(relativePath, _appRootDirPath) {
  * @param relativePath - Relative path of the file
  * @param appRootDirPath - Application root directory
  * @param options - Optional validation options to override defaults
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @throws FileValidationError if validation fails
  */
-export function validateFileOperation(operation, relativePath, appRootDirPath, options) {
+export function validateFileOperation(operation, relativePath, appRootDirPath, options, validator = defaultValidator) {
     const opts = {
         ...DEFAULT_VALIDATION_OPTIONS[operation],
         ...options,
     };
     // Check blacklist
     if (opts.checkBlacklist) {
-        const blacklistError = checkBlacklist(relativePath, appRootDirPath);
+        const blacklistError = checkBlacklist(relativePath, appRootDirPath, validator);
         if (blacklistError) {
             throw new FileValidationError(blacklistError, "BLACKLISTED");
         }
     }
     // Check API files
-    if (!opts.allowApiFiles && isApiFilePath(relativePath)) {
+    if (!opts.allowApiFiles && isApiFilePath(relativePath, validator)) {
         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)) {
+    if (!opts.allowScopeFiles && isScopeFile(relativePath, validator)) {
         throw new FileValidationError("Directly operating on scope files is not allowed. Use the appropriate tool.", "SCOPE_FILE");
     }
     // Check package.json
@@ -138,17 +160,20 @@ export function validateFileOperation(operation, relativePath, appRootDirPath, o
         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");
+    if (!opts.allowDirectPagePath && isDirectPagePath(relativePath, validator)) {
+        const pagesPrefix = validator.pagesPrefix;
+        throw new FileValidationError(`Direct file creation in the pages directory is not allowed. Please create files within subdirectories (e.g., ${pagesPrefix}/yourFeature/index.tsx)`, "DIRECT_PAGE");
     }
 }
 /**
  * Recursively checks if a directory contains any blacklisted content.
  *
  * @param entries - Directory entries to scan
+ * @param validator - Optional path validator (defaults to YAML mode)
  * @returns Error message if blacklisted content found, null otherwise
  */
-export function checkDirectoryContentBlacklist(entries) {
+export function checkDirectoryContentBlacklist(entries, validator = defaultValidator) {
+    const protectedDirs = validator.getProtectedDirectories();
     for (const entry of entries) {
         const fileName = entry.name;
         // Check exact paths
@@ -156,8 +181,7 @@ export function checkDirectoryContentBlacklist(entries) {
             return `Cannot remove protected file: ${fileName}`;
         }
         // Check protected directories
-        if (entry.isDirectory &&
-            FILE_OPERATION_BLACKLIST.directories.includes(fileName)) {
+        if (entry.isDirectory && protectedDirs.includes(fileName)) {
             return `Cannot remove protected directory: ${fileName}`;
         }
         // Check patterns

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

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

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

@@ -126,5 +126,6 @@ export declare class VirtualFileSystem {
  */
 export declare function createDefaultVirtualFileSystem(options?: {
     useSystemSkills?: boolean;
+    sdkApiEnabled?: boolean;
 }): VirtualFileSystem;
 //# sourceMappingURL=virtual-file-system.d.ts.map

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

@@ -1 +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;AAIH,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;;;;;;;;;OASG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;OAKG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAKjD;;;;;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;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE;IACvD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,iBAAiB,CASpB"}
+{"version":3,"file":"virtual-file-system.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/virtual-file-system.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,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;;;;;;;;;OASG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIrC;;;;;OAKG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAKjD;;;;;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;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE;IACvD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,iBAAiB,CAYpB"}

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

@@ -177,7 +177,10 @@ export class VirtualFileSystem {
  */
 export function createDefaultVirtualFileSystem(options) {
     const vfs = new VirtualFileSystem();
-    vfs.registerHandler(new ApiFileHandler());
+    // ApiFileHandler transforms YAML API files to virtual TS - only needed in YAML mode
+    if (!options?.sdkApiEnabled) {
+        vfs.registerHandler(new ApiFileHandler());
+    }
     if (options?.useSystemSkills) {
         vfs.registerHandler(new SkillFileHandler());
     }

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-file-system.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/virtual-file-system.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAS/D;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,iBAAiB;IACpB,QAAQ,GAAyB,EAAE,CAAC;IAE5C;;;;OAIG;IACH,eAAe,CAAC,OAA2B;QACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,WAAmB;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,YAAoB;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,YAAoB;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QACrD,OAAO,kCAAkC,YAAY,yCAAyC,WAAW,EAAE,CAAC;IAC9G,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAmB;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,OAAO,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,YAAoB;QAChC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YACxD,IAAI,WAAW,EAAE,CAAC;gBAChB,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,aAAuB;QACpC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QAEvC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,WAAmB,EACnB,OAA2B;QAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CACT,WAAmB,EACnB,OAAe,EACf,OAA4B;QAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,WAAW,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,WAAmB,EACnB,OAA6B;QAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,WAAW,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAE9C;IACC,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACpC,GAAG,CAAC,eAAe,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;IAE1C,IAAI,OAAO,EAAE,eAAe,EAAE,CAAC;QAC7B,GAAG,CAAC,eAAe,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"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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"}

package/dist/ai-service/app-interface/filesystem/yaml-path-validator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * YAML mode path validator implementation.
+ *
+ * Handles path validation for the flat template structure:
+ * - APIs: apis/ApiName/api.yaml
+ * - Pages: pages/PageName/index.tsx
+ * - App root: App.tsx
+ * - Scope file: scope.ts
+ */
+import type { PathValidator } from "./path-validator.js";
+/**
+ * Path validator for YAML mode (flat structure).
+ *
+ * In YAML mode:
+ * - APIs are at apis/ (e.g., apis/MyApi/api.yaml)
+ * - Pages are at pages/ (e.g., pages/Home/index.tsx)
+ * - App root is App.tsx
+ * - Scope files (scope.ts) are protected from direct modification
+ */
+export declare class YamlPathValidator implements PathValidator {
+    readonly apiPrefix = "apis";
+    readonly pagesPrefix = "pages";
+    readonly appRoot = "App.tsx";
+    /**
+     * Checks if a path is an API file path.
+     * In YAML mode, API files start with "apis/".
+     */
+    isApiFilePath(filePath: string): boolean;
+    /**
+     * Checks if a path is a direct page path (pages/xyz.tsx rather than pages/xyz/index.tsx).
+     * Direct page paths are not allowed - pages must be in subdirectories.
+     */
+    isDirectPagePath(filePath: string): boolean;
+    /**
+     * Checks if a path is a scope file.
+     * Scope files are protected from direct modification.
+     */
+    isScopeFile(filePath: string): boolean;
+    /**
+     * Get directories that are protected from modification.
+     */
+    getProtectedDirectories(): readonly string[];
+    /**
+     * Check if a path should bypass blacklist checks.
+     * In YAML mode, apis/ and pages/ directories have special handling.
+     */
+    shouldBypassBlacklist(_relativePath: string, firstDir: string): boolean;
+}
+//# sourceMappingURL=yaml-path-validator.d.ts.map

package/dist/ai-service/app-interface/filesystem/yaml-path-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-path-validator.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/yaml-path-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,SAAS,UAAU;IAC5B,QAAQ,CAAC,WAAW,WAAW;IAC/B,QAAQ,CAAC,OAAO,aAAa;IAE7B;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI3C;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,uBAAuB,IAAI,SAAS,MAAM,EAAE;IAI5C;;;OAGG;IACH,qBAAqB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;CAYxE"}

package/dist/ai-service/app-interface/filesystem/yaml-path-validator.js

@@ -0,0 +1,67 @@
+/**
+ * YAML mode path validator implementation.
+ *
+ * Handles path validation for the flat template structure:
+ * - APIs: apis/ApiName/api.yaml
+ * - Pages: pages/PageName/index.tsx
+ * - App root: App.tsx
+ * - Scope file: scope.ts
+ */
+/**
+ * Path validator for YAML mode (flat structure).
+ *
+ * In YAML mode:
+ * - APIs are at apis/ (e.g., apis/MyApi/api.yaml)
+ * - Pages are at pages/ (e.g., pages/Home/index.tsx)
+ * - App root is App.tsx
+ * - Scope files (scope.ts) are protected from direct modification
+ */
+export class YamlPathValidator {
+    apiPrefix = "apis";
+    pagesPrefix = "pages";
+    appRoot = "App.tsx";
+    /**
+     * Checks if a path is an API file path.
+     * In YAML mode, API files start with "apis/".
+     */
+    isApiFilePath(filePath) {
+        return filePath.startsWith("apis/");
+    }
+    /**
+     * Checks if a path is a direct page path (pages/xyz.tsx rather than pages/xyz/index.tsx).
+     * Direct page paths are not allowed - pages must be in subdirectories.
+     */
+    isDirectPagePath(filePath) {
+        return /^pages\/[^/]+\.tsx$/.test(filePath);
+    }
+    /**
+     * Checks if a path is a scope file.
+     * Scope files are protected from direct modification.
+     */
+    isScopeFile(filePath) {
+        return filePath === "scope.ts" || filePath.endsWith("/scope.ts");
+    }
+    /**
+     * Get directories that are protected from modification.
+     */
+    getProtectedDirectories() {
+        return [".git", "node_modules", ".superblocks", "pages"];
+    }
+    /**
+     * Check if a path should bypass blacklist checks.
+     * In YAML mode, apis/ and pages/ directories have special handling.
+     */
+    shouldBypassBlacklist(_relativePath, firstDir) {
+        // apis directory is allowed for virtual file operations
+        if (firstDir === "apis") {
+            return true;
+        }
+        // pages directory - allow files in subdirectories
+        // Direct page paths like pages/Foo.tsx will be caught by isDirectPagePath check
+        if (firstDir === "pages") {
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=yaml-path-validator.js.map

package/dist/ai-service/app-interface/filesystem/yaml-path-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-path-validator.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/yaml-path-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IACnB,SAAS,GAAG,MAAM,CAAC;IACnB,WAAW,GAAG,OAAO,CAAC;IACtB,OAAO,GAAG,SAAS,CAAC;IAE7B;;;OAGG;IACH,aAAa,CAAC,QAAgB;QAC5B,OAAO,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,QAAgB;QAC/B,OAAO,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,QAAgB;QAC1B,OAAO,QAAQ,KAAK,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,CAAU,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,qBAAqB,CAAC,aAAqB,EAAE,QAAgB;QAC3D,wDAAwD;QACxD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,kDAAkD;QAClD,gFAAgF;QAChF,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/ai-service/app-interface/shell.d.ts

@@ -1,6 +1,6 @@
 import { type GlobOptionsWithFileTypesUnset } from "glob";
 import { type FileArtifact } from "../types.js";
-import { type DraftChanges, type FileMetadata } from "./filesystem/index.js";
+import { type DraftChanges, type FileMetadata, type PathValidator } from "./filesystem/index.js";
 import type { VirtualFileSystem } from "./filesystem/index.js";
 import type { DraftInterface } from "../../draft-interface.js";
 import type { IOperationQueue } from "../../util/operation-queue.js";
@@ -33,18 +33,21 @@ export declare class AppShell {
     private readonly draftManager?;
     private readonly templateRenderer?;
     private readonly virtualFs;
+    private readonly pathValidator;
     /**
      * Tracks files that must be read before they can be written.
      * Used to enforce read-before-write pattern for AI safety.
      */
     private readonly requiredReads;
-    constructor({ appRootDirPath, fsOperationQueue, messageSender, draftInterface, templateRenderer, virtualFileSystem, }: {
+    constructor({ appRootDirPath, fsOperationQueue, messageSender, draftInterface, templateRenderer, virtualFileSystem, pathValidator, }: {
         appRootDirPath: string;
         fsOperationQueue: IOperationQueue;
         messageSender?: (message: any) => Promise<void>;
         draftInterface?: DraftInterface;
         templateRenderer?: TemplateRenderer;
         virtualFileSystem: VirtualFileSystem;
+        /** Path validator for template-specific path restrictions */
+        pathValidator: PathValidator;
     });
     readFiles(patterns: string[], globOptions?: GlobOptionsWithFileTypesUnset, enableAppBlacklist?: boolean): Promise<FileArtifact[]>;
     runTypecheck(abortSignal?: AbortSignal): Promise<Record<string, string[]> | null>;