@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.84af65cd215b6ca1

package/dist/ai-service/app-interface/cancellable-exec.d.ts

@@ -0,0 +1,34 @@
+export interface ExecCancellableOptions {
+    cwd?: string;
+    signal?: AbortSignal;
+    /**
+     * How long to wait after SIGTERM before escalating to SIGKILL.
+     */
+    killGraceMs?: number;
+}
+/**
+ * Runs a shell command and, when `signal` aborts, terminates the ENTIRE
+ * process tree it started -- not just the direct child.
+ *
+ * `child_process.exec(cmd, { signal })` only ever signals the `/bin/sh` it
+ * spawns. For the typecheck command that shell is the shallowest of four
+ * processes:
+ *
+ *   sh -c "npx tsc -b ..."     <- the only process exec's abort reaches
+ *   npm exec tsc -b ...
+ *   sh -c 'tsc' -b ...
+ *   node .../node_modules/.bin/tsc -b ...   <- holds the compiler heap
+ *
+ * So aborting resolved the promise while the compiler kept running and kept
+ * its memory. Callers then started the next check believing the previous one
+ * was gone, and the resident compilers accumulated until the pod was
+ * OOMKilled. Putting the child in its own process group (`detached`) lets us
+ * signal the whole group with `kill(-pid)`, which does reach the compiler.
+ *
+ * Resolution is deliberately deferred until the process tree has actually
+ * exited, so that "the promise settled" means "the memory is released".
+ * Aborting resolves with whatever output was captured rather than throwing,
+ * matching the previous behavior callers depend on.
+ */
+export declare function execCancellable(command: string, options?: ExecCancellableOptions): Promise<string>;
+//# sourceMappingURL=cancellable-exec.d.ts.map

package/dist/ai-service/app-interface/cancellable-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellable-exec.d.ts","sourceRoot":"","sources":["../../../src/ai-service/app-interface/cancellable-exec.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,CAAC,CAgFjB"}

package/dist/ai-service/app-interface/cancellable-exec.js

@@ -0,0 +1,98 @@
+import { spawn } from "node:child_process";
+const DEFAULT_KILL_GRACE_MS = 2000;
+/**
+ * Runs a shell command and, when `signal` aborts, terminates the ENTIRE
+ * process tree it started -- not just the direct child.
+ *
+ * `child_process.exec(cmd, { signal })` only ever signals the `/bin/sh` it
+ * spawns. For the typecheck command that shell is the shallowest of four
+ * processes:
+ *
+ *   sh -c "npx tsc -b ..."     <- the only process exec's abort reaches
+ *   npm exec tsc -b ...
+ *   sh -c 'tsc' -b ...
+ *   node .../node_modules/.bin/tsc -b ...   <- holds the compiler heap
+ *
+ * So aborting resolved the promise while the compiler kept running and kept
+ * its memory. Callers then started the next check believing the previous one
+ * was gone, and the resident compilers accumulated until the pod was
+ * OOMKilled. Putting the child in its own process group (`detached`) lets us
+ * signal the whole group with `kill(-pid)`, which does reach the compiler.
+ *
+ * Resolution is deliberately deferred until the process tree has actually
+ * exited, so that "the promise settled" means "the memory is released".
+ * Aborting resolves with whatever output was captured rather than throwing,
+ * matching the previous behavior callers depend on.
+ */
+export function execCancellable(command, options = {}) {
+    const { cwd, signal, killGraceMs = DEFAULT_KILL_GRACE_MS } = options;
+    if (signal?.aborted) {
+        return Promise.resolve("");
+    }
+    return new Promise((resolve) => {
+        const child = spawn(command, {
+            cwd,
+            shell: true,
+            // New process group, so a negative-pid kill reaches every descendant.
+            detached: true,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        let killTimer = null;
+        let settled = false;
+        child.stdout?.setEncoding("utf-8");
+        child.stderr?.setEncoding("utf-8");
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        // Signalling the group requires a pid. If spawn failed there is nothing to
+        // kill and `error` will settle the promise.
+        const signalGroup = (sig) => {
+            if (child.pid === undefined) {
+                return;
+            }
+            try {
+                process.kill(-child.pid, sig);
+            }
+            catch {
+                // ESRCH: the group is already gone. Nothing to do.
+            }
+        };
+        const onAbort = () => {
+            signalGroup("SIGTERM");
+            // A compiler wedged in a syscall will not honor SIGTERM. Escalate rather
+            // than leave it holding its heap.
+            killTimer = setTimeout(() => signalGroup("SIGKILL"), killGraceMs);
+            killTimer.unref?.();
+        };
+        const cleanup = () => {
+            if (killTimer) {
+                clearTimeout(killTimer);
+                killTimer = null;
+            }
+            signal?.removeEventListener("abort", onAbort);
+        };
+        const settle = (value) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            resolve(value);
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+        child.on("error", () => {
+            settle(stdout || stderr);
+        });
+        // `close` (not `exit`) fires once the tree's stdio has been released, which
+        // is the closest observable proxy for "the descendants are gone".
+        child.on("close", () => {
+            settle(stdout || stderr);
+        });
+    });
+}
+//# sourceMappingURL=cancellable-exec.js.map

package/dist/ai-service/app-interface/cancellable-exec.js.map

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

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

@@ -0,0 +1,60 @@
+/**
+ * Constants for AppShell filesystem operations.
+ *
+ * This module contains blacklist patterns, protected paths, and validation
+ * rules used by the AppShell to enforce security constraints on file operations.
+ */
+export type FileOperationBlacklistOptions = {
+    /**
+     * Use less-protected patterns, flagging to allow deletion of package-manager lock files.
+     */
+    useLessProtectedPatterns?: boolean;
+};
+/**
+ * Clark AI specific folders to blacklist from context.
+ * These are framework/system folders that Clark shouldn't edit or include in prompts.
+ */
+export declare const CLARK_APP_BLACKLIST_PATTERNS: readonly [];
+/**
+ * Consolidated blacklist configuration for file operations.
+ */
+export declare function getFileOperationBlacklist(options?: FileOperationBlacklistOptions): {
+    readonly exactPaths: readonly ["package.json", "tsconfig.json", "turbo.json", "superblocks.json", "vite.config.ts"] | readonly ["package.json", "tsconfig.json", "turbo.json", "superblocks.json", "vite.config.ts", "yarn.lock", "pnpm-lock.yaml", "package-lock.json"];
+    readonly directories: readonly [".git", "node_modules", ".superblocks", "pages", "apis"];
+    readonly patterns: readonly [RegExp, RegExp, RegExp, RegExp];
+};
+/**
+ * Standard ignore patterns for glob operations.
+ * Files matching these patterns are excluded from file listings.
+ */
+export declare const STANDARD_IGNORE_PATTERNS: readonly ["node_modules/**"];
+/**
+ * Glob patterns for listing application files.
+ */
+export declare const APPLICATION_FILE_PATTERNS: readonly ["**/*.{ts,tsx,yaml,css}", "package.json"];
+/**
+ * Operation types for validation.
+ */
+export type FileOperation = "read" | "write" | "delete" | "rename" | "list";
+/**
+ * Validation options for file operations.
+ */
+export interface FileOperationValidationOptions {
+    /** Check against blacklist patterns (default: true) */
+    checkBlacklist?: boolean;
+    /** Require file to be read before writing (default: true for write/edit) */
+    checkReadBeforeWrite?: boolean;
+    /** Allow operations on API virtual files (default: false for direct writes) */
+    allowApiFiles?: boolean;
+    /** Allow operations on scope files (default: false) */
+    allowScopeFiles?: boolean;
+    /** Allow operations on package.json (default: false) */
+    allowPackageJson?: boolean;
+    /** Allow direct page paths like pages/xyz.tsx (default: false) */
+    allowDirectPagePath?: boolean;
+}
+/**
+ * Default validation options per operation type.
+ */
+export declare const DEFAULT_VALIDATION_OPTIONS: Record<FileOperation, FileOperationValidationOptions>;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/ai-service/app-interface/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgDH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;OAEG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,aAAc,CAAC;AAExD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,6BAA6B;;;;EAWxC;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,8BAA+B,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,yBAAyB,qDAG5B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uDAAuD;IACvD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAC7C,aAAa,EACb,8BAA8B,CA0C/B,CAAC"}

package/dist/ai-service/app-interface/constants.js

@@ -0,0 +1,124 @@
+/**
+ * Constants for AppShell filesystem operations.
+ *
+ * This module contains blacklist patterns, protected paths, and validation
+ * rules used by the AppShell to enforce security constraints on file operations.
+ */
+/**
+ * Files that cannot be deleted, written to, or modified directly.
+ * These are critical configuration files that could break the application.
+ */
+const PROTECTED_EXACT_PATHS = [
+    "package.json",
+    "tsconfig.json",
+    "turbo.json",
+    "superblocks.json",
+    "vite.config.ts",
+];
+const PROTECTED_EXACT_PATHS_WITH_PACKAGE_LOCK = [
+    ...PROTECTED_EXACT_PATHS,
+    "yarn.lock",
+    "pnpm-lock.yaml",
+    "package-lock.json",
+];
+/**
+ * Directories that cannot be deleted or have their contents directly modified.
+ * - .git: Version control
+ * - node_modules: Dependencies
+ * - .superblocks: Internal system files
+ * - pages: Must use subdirectories, not direct files
+ * - components: Framework internals
+ * - apis: Must use virtual API file interface
+ */
+const PROTECTED_DIRECTORIES = [
+    ".git",
+    "node_modules",
+    ".superblocks",
+    "pages",
+    "apis",
+];
+/**
+ * Regex patterns for protected files (environment files, package manager configs).
+ */
+const PROTECTED_FILE_PATTERNS = [
+    /^\.env$/,
+    /^\.env\..+$/,
+    /^\.npmrc$/,
+    /^\.pnpmrc$/,
+];
+/**
+ * Clark AI specific folders to blacklist from context.
+ * These are framework/system folders that Clark shouldn't edit or include in prompts.
+ */
+export const CLARK_APP_BLACKLIST_PATTERNS = [];
+/**
+ * Consolidated blacklist configuration for file operations.
+ */
+export function getFileOperationBlacklist(options) {
+    const useLessProtectedPatterns = options?.useLessProtectedPatterns ?? false;
+    return {
+        exactPaths: useLessProtectedPatterns
+            ? PROTECTED_EXACT_PATHS
+            : PROTECTED_EXACT_PATHS_WITH_PACKAGE_LOCK,
+        directories: PROTECTED_DIRECTORIES,
+        patterns: PROTECTED_FILE_PATTERNS,
+    };
+}
+/**
+ * Standard ignore patterns for glob operations.
+ * Files matching these patterns are excluded from file listings.
+ */
+export const STANDARD_IGNORE_PATTERNS = ["node_modules/**"];
+/**
+ * Glob patterns for listing application files.
+ */
+export const APPLICATION_FILE_PATTERNS = [
+    "**/*.{ts,tsx,yaml,css}",
+    "package.json",
+];
+/**
+ * Default validation options per operation type.
+ */
+export const DEFAULT_VALIDATION_OPTIONS = {
+    read: {
+        checkBlacklist: false,
+        checkReadBeforeWrite: false,
+        allowApiFiles: true,
+        allowScopeFiles: true,
+        allowPackageJson: true,
+        allowDirectPagePath: true,
+    },
+    write: {
+        checkBlacklist: true,
+        checkReadBeforeWrite: true,
+        allowApiFiles: false,
+        allowScopeFiles: false,
+        allowPackageJson: false,
+        allowDirectPagePath: false,
+    },
+    delete: {
+        checkBlacklist: true,
+        checkReadBeforeWrite: false,
+        allowApiFiles: true, // API deletion has special handling
+        allowScopeFiles: false,
+        allowPackageJson: false,
+        allowDirectPagePath: true, // Page deletion has special handling
+    },
+    rename: {
+        checkBlacklist: true,
+        checkReadBeforeWrite: false,
+        allowApiFiles: false,
+        allowScopeFiles: false,
+        allowPackageJson: false,
+        allowDirectPagePath: false,
+    },
+    list: {
+        checkBlacklist: false,
+        checkReadBeforeWrite: false,
+        allowApiFiles: true,
+        allowScopeFiles: true,
+        allowPackageJson: true,
+        allowDirectPagePath: true,
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/ai-service/app-interface/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/ai-service/app-interface/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,qBAAqB,GAAG;IAC5B,cAAc;IACd,eAAe;IACf,YAAY;IACZ,kBAAkB;IAClB,gBAAgB;CACR,CAAC;AAEX,MAAM,uCAAuC,GAAG;IAC9C,GAAG,qBAAqB;IACxB,WAAW;IACX,gBAAgB;IAChB,mBAAmB;CACX,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,qBAAqB,GAAG;IAC5B,MAAM;IACN,cAAc;IACd,cAAc;IACd,OAAO;IACP,MAAM;CACE,CAAC;AAEX;;GAEG;AACH,MAAM,uBAAuB,GAAG;IAC9B,SAAS;IACT,aAAa;IACb,WAAW;IACX,YAAY;CACJ,CAAC;AASX;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAW,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAuC;IAEvC,MAAM,wBAAwB,GAAG,OAAO,EAAE,wBAAwB,IAAI,KAAK,CAAC;IAE5E,OAAO;QACL,UAAU,EAAE,wBAAwB;YAClC,CAAC,CAAC,qBAAqB;YACvB,CAAC,CAAC,uCAAuC;QAC3C,WAAW,EAAE,qBAAqB;QAClC,QAAQ,EAAE,uBAAuB;KACzB,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,iBAAiB,CAAU,CAAC;AAErE;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,wBAAwB;IACxB,cAAc;CACN,CAAC;AAyBX;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAGnC;IACF,IAAI,EAAE;QACJ,cAAc,EAAE,KAAK;QACrB,oBAAoB,EAAE,KAAK;QAC3B,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,mBAAmB,EAAE,IAAI;KAC1B;IACD,KAAK,EAAE;QACL,cAAc,EAAE,IAAI;QACpB,oBAAoB,EAAE,IAAI;QAC1B,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,gBAAgB,EAAE,KAAK;QACvB,mBAAmB,EAAE,KAAK;KAC3B;IACD,MAAM,EAAE;QACN,cAAc,EAAE,IAAI;QACpB,oBAAoB,EAAE,KAAK;QAC3B,aAAa,EAAE,IAAI,EAAE,oCAAoC;QACzD,eAAe,EAAE,KAAK;QACtB,gBAAgB,EAAE,KAAK;QACvB,mBAAmB,EAAE,IAAI,EAAE,qCAAqC;KACjE;IACD,MAAM,EAAE;QACN,cAAc,EAAE,IAAI;QACpB,oBAAoB,EAAE,KAAK;QAC3B,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,gBAAgB,EAAE,KAAK;QACvB,mBAAmB,EAAE,KAAK;KAC3B;IACD,IAAI,EAAE;QACJ,cAAc,EAAE,KAAK;QACrB,oBAAoB,EAAE,KAAK;QAC3B,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,mBAAmB,EAAE,IAAI;KAC1B;CACF,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { SbElement } from "@superblocksteam/library-shared/types";
+import type { FileSystemManager } from "../../file-system-manager.js";
+import type { SourceTracker } from "../../source-tracker.js";
+export declare class FileSystemInterface {
+    private sourceTracker;
+    private fileSystemManager;
+    setSourceTracker(sourceTracker: SourceTracker | undefined): void;
+    setFileSystemManager(fileSystemManager: FileSystemManager): void;
+    getFileSystemManager(): FileSystemManager;
+    getSourceTracker(): SourceTracker;
+    getCurrentFiles(): Record<string, import("../../source-tracker.js").FileMeta>;
+    getElementToFilePathMap(): Record<`SB-${string}`, string> | undefined;
+    getElementToFilePath(el: SbElement): string;
+    getElementToLocation(el: SbElement): import("@babel/traverse").NodePath<import("@babel/traverse").Node>;
+    getAndFlushChanges(): Promise<{
+        fileName: string;
+        source: string;
+        kind: import("../../source-tracker.js").SourceKind;
+    }[]>;
+    isCustomComponent(elementId: string): boolean;
+}
+//# sourceMappingURL=file-system-interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-interface.d.ts","sourceRoot":"","sources":["../../../src/ai-service/app-interface/file-system-interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAGvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,iBAAiB,CAAgC;IAClD,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS;IAOzD,oBAAoB,CAAC,iBAAiB,EAAE,iBAAiB;IAIhE,oBAAoB;IAOpB,gBAAgB;IAOhB,eAAe;IAOf,uBAAuB;IAIvB,oBAAoB,CAAC,EAAE,EAAE,SAAS;IAQlC,oBAAoB,CAAC,EAAE,EAAE,SAAS;IAYlC,kBAAkB;;;;;IAOlB,iBAAiB,CAAC,SAAS,EAAE,MAAM;CAMpC"}

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

@@ -0,0 +1,109 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { ComponentsManager } from "../../components-manager.js";
+import llmobs from "../llmobs/index.js";
+let FileSystemInterface = (() => {
+    let _instanceExtraInitializers = [];
+    let _getAndFlushChanges_decorators;
+    return class FileSystemInterface {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _getAndFlushChanges_decorators = [llmobs.decorate({
+                    kind: "task",
+                    name: "FileSystemInterface.getAndFlushChanges",
+                })];
+            __esDecorate(this, null, _getAndFlushChanges_decorators, { kind: "method", name: "getAndFlushChanges", static: false, private: false, access: { has: obj => "getAndFlushChanges" in obj, get: obj => obj.getAndFlushChanges }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        sourceTracker = __runInitializers(this, _instanceExtraInitializers);
+        fileSystemManager;
+        setSourceTracker(sourceTracker) {
+            if (this.sourceTracker) {
+                throw new Error("Source tracker already initialized");
+            }
+            this.sourceTracker = sourceTracker;
+        }
+        setFileSystemManager(fileSystemManager) {
+            this.fileSystemManager = fileSystemManager;
+        }
+        getFileSystemManager() {
+            if (!this.fileSystemManager) {
+                throw new Error("File system manager not initialized");
+            }
+            return this.fileSystemManager;
+        }
+        getSourceTracker() {
+            if (!this.sourceTracker) {
+                throw new Error("Source tracker not initialized");
+            }
+            return this.sourceTracker;
+        }
+        getCurrentFiles() {
+            if (!this.sourceTracker) {
+                throw new Error("Source tracker not initialized");
+            }
+            return this.sourceTracker.getCurrentFiles();
+        }
+        getElementToFilePathMap() {
+            return this.sourceTracker?.getElementToFilePath();
+        }
+        getElementToFilePath(el) {
+            if (!this.sourceTracker) {
+                throw new Error("Source tracker not initialized");
+            }
+            return this.sourceTracker.getElementToFilePath(el);
+        }
+        getElementToLocation(el) {
+            if (!this.sourceTracker) {
+                throw new Error("Source tracker not initialized");
+            }
+            return this.sourceTracker.getElementToLocation(el);
+        }
+        getAndFlushChanges() {
+            if (!this.sourceTracker) {
+                throw new Error("Source tracker not initialized");
+            }
+            return this.sourceTracker.getAndFlushChanges();
+        }
+        isCustomComponent(elementId) {
+            if (!this.sourceTracker) {
+                throw new Error("Source tracker not initialized");
+            }
+            return ComponentsManager.getInstance().isCustomComponent(elementId);
+        }
+    };
+})();
+export { FileSystemInterface };
+//# sourceMappingURL=file-system-interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-interface.js","sourceRoot":"","sources":["../../../src/ai-service/app-interface/file-system-interface.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,MAAM,MAAM,oBAAoB,CAAC;IAE3B,mBAAmB;;;iBAAnB,mBAAmB;;;8CAuD7B,MAAM,CAAC,QAAQ,CAAC;oBACf,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,wCAAwC;iBAC/C,CAAC;YACF,yMAAA,kBAAkB,6DAKjB;;;QA/DO,aAAa,GADV,mDAAmB,CACmB;QACzC,iBAAiB,CAAgC;QAClD,gBAAgB,CAAC,aAAwC;YAC9D,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACrC,CAAC;QAEM,oBAAoB,CAAC,iBAAoC;YAC9D,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC7C,CAAC;QAED,oBAAoB;YAClB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,IAAI,CAAC,iBAAiB,CAAC;QAChC,CAAC;QAED,gBAAgB;YACd,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED,eAAe;YACb,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC;QAC9C,CAAC;QAED,uBAAuB;YACrB,OAAO,IAAI,CAAC,aAAa,EAAE,oBAAoB,EAAE,CAAC;QACpD,CAAC;QAED,oBAAoB,CAAC,EAAa;YAChC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YAED,OAAO,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,oBAAoB,CAAC,EAAa;YAChC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YAED,OAAO,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;QAMD,kBAAkB;YAChB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,CAAC;QACjD,CAAC;QAED,iBAAiB,CAAC,SAAiB;YACjC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,OAAO,iBAAiB,CAAC,WAAW,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACtE,CAAC;;;SAvEU,mBAAmB"}

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

@@ -0,0 +1,87 @@
+/**
+ * Draft management wrapper.
+ *
+ * Encapsulates the DraftInterface to provide a clean internal API
+ * for managing draft file operations within the AppShell.
+ * External consumers (tools) should not interact with this directly.
+ */
+import type { DraftInterface } from "../../../draft-interface.js";
+/**
+ * Draft changes categorized by operation type.
+ */
+export interface DraftChanges {
+    /** Files that have been edited (content modified) */
+    edits: string[];
+    /** Files that have been added (new files) */
+    additions: string[];
+    /** Files that have been deleted */
+    deletions: string[];
+}
+/**
+ * Manages draft file operations.
+ *
+ * This class wraps the DraftInterface to provide a simplified API
+ * for the AppShell filesystem operations. It handles all draft
+ * creation, deletion, and query operations internally.
+ */
+export declare class DraftManager {
+    private readonly draftInterface;
+    constructor(draftInterface: DraftInterface);
+    /**
+     * Creates a draft file with the given content.
+     *
+     * This stages a file write that can be committed or discarded.
+     * Parent directories are created automatically.
+     *
+     * @param filePath - Relative path of the file
+     * @param content - Content to write
+     */
+    createDraft(filePath: string, content: string | Buffer): Promise<void>;
+    /**
+     * Creates a draft marker without content.
+     *
+     * Used to mark a file as having a pending draft without
+     * specifying the content immediately.
+     *
+     * @param filePath - Relative path of the file
+     */
+    createDraftMarker(filePath: string): Promise<void>;
+    /**
+     * Creates a draft deletion for a file.
+     *
+     * This stages a file deletion that can be committed or discarded.
+     *
+     * @param filePath - Relative path of the file to delete
+     */
+    createDraftDelete(filePath: string): Promise<void>;
+    /**
+     * Checks if there are any pending draft changes.
+     *
+     * @returns true if there are uncommitted draft changes
+     */
+    hasDraftChanges(): Promise<boolean>;
+    /**
+     * Gets a unified diff of pending draft changes.
+     *
+     * @param paths - Optional specific paths to diff. If empty, diffs all changes.
+     * @returns Unified diff string
+     */
+    getDraftDiff(paths?: string[]): Promise<string>;
+    /**
+     * Gets categorized draft changes.
+     *
+     * @returns Object containing arrays of edited, added, and deleted paths
+     */
+    getDraftChanges(): Promise<DraftChanges>;
+    /**
+     * Gets the underlying DraftInterface.
+     *
+     * This should only be used for advanced operations that require
+     * direct access to the draft interface. Prefer using the methods
+     * on this class when possible.
+     *
+     * @internal
+     */
+    getInterface(): DraftInterface;
+}
+//# sourceMappingURL=draft-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draft-manager.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/draft-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mCAAmC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,cAAc;IAE3D;;;;;;;;OAQG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E;;;;;;;OAOG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;;;;;OAMG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzC;;;;;OAKG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAIrD;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IAI9C;;;;;;;;OAQG;IACH,YAAY,IAAI,cAAc;CAG/B"}

package/dist/ai-service/app-interface/filesystem/draft-manager.js

@@ -0,0 +1,91 @@
+/**
+ * Draft management wrapper.
+ *
+ * Encapsulates the DraftInterface to provide a clean internal API
+ * for managing draft file operations within the AppShell.
+ * External consumers (tools) should not interact with this directly.
+ */
+/**
+ * Manages draft file operations.
+ *
+ * This class wraps the DraftInterface to provide a simplified API
+ * for the AppShell filesystem operations. It handles all draft
+ * creation, deletion, and query operations internally.
+ */
+export class DraftManager {
+    draftInterface;
+    constructor(draftInterface) {
+        this.draftInterface = draftInterface;
+    }
+    /**
+     * Creates a draft file with the given content.
+     *
+     * This stages a file write that can be committed or discarded.
+     * Parent directories are created automatically.
+     *
+     * @param filePath - Relative path of the file
+     * @param content - Content to write
+     */
+    async createDraft(filePath, content) {
+        await this.draftInterface.createDraftFile(filePath, content);
+    }
+    /**
+     * Creates a draft marker without content.
+     *
+     * Used to mark a file as having a pending draft without
+     * specifying the content immediately.
+     *
+     * @param filePath - Relative path of the file
+     */
+    async createDraftMarker(filePath) {
+        await this.draftInterface.createDraftMarkerOnly(filePath);
+    }
+    /**
+     * Creates a draft deletion for a file.
+     *
+     * This stages a file deletion that can be committed or discarded.
+     *
+     * @param filePath - Relative path of the file to delete
+     */
+    async createDraftDelete(filePath) {
+        await this.draftInterface.createDraftDelete(filePath);
+    }
+    /**
+     * Checks if there are any pending draft changes.
+     *
+     * @returns true if there are uncommitted draft changes
+     */
+    async hasDraftChanges() {
+        return await this.draftInterface.hasLocalDraftChanges();
+    }
+    /**
+     * Gets a unified diff of pending draft changes.
+     *
+     * @param paths - Optional specific paths to diff. If empty, diffs all changes.
+     * @returns Unified diff string
+     */
+    async getDraftDiff(paths) {
+        return await this.draftInterface.getDraftDiff(paths ?? []);
+    }
+    /**
+     * Gets categorized draft changes.
+     *
+     * @returns Object containing arrays of edited, added, and deleted paths
+     */
+    async getDraftChanges() {
+        return await this.draftInterface.getDraftChanges();
+    }
+    /**
+     * Gets the underlying DraftInterface.
+     *
+     * This should only be used for advanced operations that require
+     * direct access to the draft interface. Prefer using the methods
+     * on this class when possible.
+     *
+     * @internal
+     */
+    getInterface() {
+        return this.draftInterface;
+    }
+}
+//# sourceMappingURL=draft-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draft-manager.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/draft-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAE/D;;;;;;;;OAQG;IACH,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,OAAwB;QAC1D,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,IAAI,CAAC,cAAc,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,IAAI,CAAC,cAAc,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe;QACnB,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,oBAAoB,EAAE,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,KAAgB;QACjC,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe;QACnB,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;IACrD,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}