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

package/dist/ai-service/app-interface/filesystem/virtual-fs-types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Type definitions for the virtual filesystem layer.
+ *
+ * The virtual filesystem provides an abstraction over physical files,
+ * allowing certain file types (like APIs) to appear differently to
+ * consumers than they are stored on disk.
+ */
+import type { TemplateRenderer } from "../../template-renderer.js";
+/**
+ * File metadata returned by listFiles when includeMetadata is true.
+ */
+export interface FileMetadata {
+    /** Relative file path (virtual path for APIs) */
+    path: string;
+    /** File size in bytes */
+    size: number;
+    /** Last modification time */
+    mtime: Date;
+    /** Whether this is a directory */
+    isDirectory: boolean;
+    /** Whether this is a file */
+    isFile: boolean;
+}
+/**
+ * Options for reading virtual files.
+ */
+export interface VirtualReadOptions {
+    appRootDirPath: string;
+    templateRenderer?: TemplateRenderer;
+    entityNames?: string[];
+}
+/**
+ * Options for writing virtual files.
+ */
+export interface VirtualWriteOptions {
+    appRootDirPath: string;
+}
+/**
+ * Options for deleting virtual files.
+ */
+export interface VirtualDeleteOptions {
+    appRootDirPath: string;
+    createDraftDelete: (relativePath: string) => Promise<void>;
+}
+/**
+ * Result of parsing a virtual path.
+ */
+export interface VirtualPathInfo {
+    /** The type of virtual file (e.g., "api") */
+    type: string;
+    /** Extracted parameters from the path (e.g., { apiName: "MyAPI" }) */
+    params: Record<string, string>;
+}
+/**
+ * Handler for a specific type of virtual file.
+ *
+ * Each handler is responsible for a category of virtual files
+ * (e.g., API files). The VirtualFileSystem uses handlers to
+ * route operations to the appropriate implementation.
+ */
+export interface VirtualFileHandler {
+    /** Unique identifier for this handler type */
+    readonly type: string;
+    /**
+     * Check if this handler manages the given virtual path.
+     *
+     * @param virtualPath - The virtual path to check
+     * @returns true if this handler should process the path
+     */
+    matches(virtualPath: string): boolean;
+    /**
+     * Check if a physical path belongs to this handler's domain.
+     * Used for converting physical paths to virtual paths in listings.
+     *
+     * @param physicalPath - The physical path to check
+     * @returns true if this handler should convert the path
+     */
+    matchesPhysical(physicalPath: string): boolean;
+    /**
+     * Parse a virtual path to extract metadata.
+     *
+     * @param virtualPath - The virtual path to parse
+     * @returns Parsed info or undefined if not a valid path for this handler
+     */
+    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 undefined if not convertible
+     */
+    toVirtualPath(physicalPath: string): string | undefined;
+    /**
+     * Read content from a virtual file.
+     *
+     * @param virtualPath - The virtual path to read
+     * @param options - Read options including app root and dependencies
+     * @returns The file content, or undefined if not found
+     */
+    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 including app root
+     */
+    write(virtualPath: string, content: string, options: VirtualWriteOptions): Promise<void>;
+    /**
+     * Delete a virtual file and its associated physical files.
+     *
+     * @param virtualPath - The virtual path to delete
+     * @param options - Delete options including draft delete function
+     * @returns List of physical paths that were deleted
+     */
+    delete(virtualPath: string, options: VirtualDeleteOptions): Promise<string[]>;
+    /**
+     * Get metadata for a virtual file.
+     *
+     * @param virtualPath - The virtual path to get metadata for
+     * @param options - Read options including app root
+     * @returns File metadata, or undefined if not found
+     */
+    getMetadata?(virtualPath: string, options: VirtualReadOptions): Promise<FileMetadata | undefined>;
+}
+//# sourceMappingURL=virtual-fs-types.d.ts.map

package/dist/ai-service/app-interface/filesystem/virtual-fs-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-fs-types.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/virtual-fs-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,IAAI,CAAC;IACZ,kCAAkC;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,6BAA6B;IAC7B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAEtC;;;;;;OAMG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAExD;;;;;OAKG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAExD;;;;;;OAMG;IACH,IAAI,CACF,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAE/B;;;;;;OAMG;IACH,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E;;;;;;OAMG;IACH,WAAW,CAAC,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CACtC"}

package/dist/ai-service/app-interface/filesystem/virtual-fs-types.js

@@ -0,0 +1,9 @@
+/**
+ * Type definitions for the virtual filesystem layer.
+ *
+ * The virtual filesystem provides an abstraction over physical files,
+ * allowing certain file types (like APIs) to appear differently to
+ * consumers than they are stored on disk.
+ */
+export {};
+//# sourceMappingURL=virtual-fs-types.js.map

package/dist/ai-service/app-interface/filesystem/virtual-fs-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-fs-types.js","sourceRoot":"","sources":["../../../../src/ai-service/app-interface/filesystem/virtual-fs-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -3,6 +3,9 @@ export declare class Linter {
     private readonly cwd;
     constructor(cwd: string);
     warmCache(files: string[]): Promise<void>;
-    lint(files: string[], abortSignal?: AbortSignal): Promise<Record<string, string[]>>;
+    lint(files: string[], abortSignal?: AbortSignal): Promise<{
+        errors: Record<string, string[]>;
+        fixedFiles: string[];
+    }>;
 }
 //# sourceMappingURL=linter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../../src/ai-service/app-interface/linter.ts"],"names":[],"mappings":"AAiCA,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IASjB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE;IAMzB,IAAI,CACR,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CA+DrC"}
+{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../../src/ai-service/app-interface/linter.ts"],"names":[],"mappings":"AAiCA,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IASjB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE;IAMzB,IAAI,CACR,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAoEvE"}

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

@@ -116,20 +116,24 @@ let Linter = (() => {
             if (abortSignal?.aborted) {
                 throw new Error("Operation was aborted");
             }
+            // Track which files were auto-fixed (have output)
+            const fixedFiles = results
+                .filter((r) => r.output !== undefined)
+                .map((r) => path.relative(this.cwd, r.filePath));
             await ESLint.outputFixes(results);
-            const result = results.reduce((acc, result) => {
+            const errors = results.reduce((acc, result) => {
                 const relativePath = path.relative(this.cwd, result.filePath);
-                const errors = result.messages
+                const errorMessages = result.messages
                     .filter((message) => !message.fix)
                     .map((m) => `${relativePath}(${m.line},${m.column}): ${m.message} (${m.ruleId})`);
-                if (errors.length > 0) {
-                    acc[relativePath] = errors;
+                if (errorMessages.length > 0) {
+                    acc[relativePath] = errorMessages;
                 }
                 return acc;
             }, {});
             const end = performance.now();
-            getLogger().debug(`[ai-service] Linting took ${end - start}ms for ${files.length} files`);
-            return result;
+            getLogger().debug(`[ai-service] Linting took ${end - start}ms for ${files.length} files, ${fixedFiles.length} auto-fixed`);
+            return { errors, fixedFiles };
         }
     };
 })();

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

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

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

@@ -1,15 +1,50 @@
 import { type GlobOptionsWithFileTypesUnset } from "glob";
 import { type FileArtifact } from "../types.js";
+import { type DraftChanges, type FileMetadata } 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";
+import type { TemplateRenderer } from "../template-renderer.js";
+/**
+ * Options for listing files with optional metadata.
+ */
+export interface ListFilesOptions extends GlobOptionsWithFileTypesUnset {
+    /** Include file metadata (size, mtime, type). Default: false */
+    includeMetadata?: boolean;
+    /** Include directories in listing. Default: false (files only) */
+    includeDirs?: boolean;
+}
+/**
+ * AppShell provides the primary interface for the AI agent to interact
+ * with the application environment.
+ *
+ * It encapsulates:
+ * - File system operations (read, write, delete, list, rename)
+ * - Virtual file abstraction (APIs appear as single .ts files)
+ * - Draft management for undo/redo capability
+ * - Code quality tools (linting, type checking)
+ * - Package management
+ */
 export declare class AppShell {
     readonly appRootDirPath: string;
     private readonly fsOperationQueue;
     private readonly linter;
     private messageSender?;
-    constructor({ appRootDirPath, fsOperationQueue, messageSender, }: {
+    private readonly draftManager?;
+    private readonly templateRenderer?;
+    private readonly virtualFs;
+    /**
+     * 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, }: {
         appRootDirPath: string;
         fsOperationQueue: IOperationQueue;
         messageSender?: (message: any) => Promise<void>;
+        draftInterface?: DraftInterface;
+        templateRenderer?: TemplateRenderer;
+        virtualFileSystem?: VirtualFileSystem;
     });
     readFiles(patterns: string[], globOptions?: GlobOptionsWithFileTypesUnset, enableAppBlacklist?: boolean): Promise<FileArtifact[]>;
     runTypecheck(abortSignal?: AbortSignal): Promise<Record<string, string[]> | null>;
@@ -41,5 +76,174 @@ export declare class AppShell {
      * This is typically called when a draft is rejected to clean up temporary artifacts.
      */
     clearScratchDirectory(): Promise<void>;
+    /**
+     * Reads a single file's content from the application.
+     *
+     * Handles virtual path translation for files managed by the VirtualFileSystem:
+     * - Virtual paths are read via the appropriate handler
+     * - Regular files are read directly from disk
+     *
+     * @param relativePath - The virtual path relative to app root
+     * @param options - Optional read options
+     * @param options.offset - Line number to start reading from (1-indexed)
+     * @param options.limit - Number of lines to read
+     * @returns The file content as a string
+     * @throws Error if file does not exist or cannot be read
+     */
+    readFile(relativePath: string, options?: {
+        offset?: number;
+        limit?: number;
+    }): Promise<string>;
+    /**
+     * Internal read implementation (no queue).
+     * Use this from other methods that are already enqueued to avoid deadlock.
+     */
+    private readFileInternal;
+    /**
+     * Writes content to a file as a draft.
+     *
+     * Handles virtual path translation for files managed by the VirtualFileSystem:
+     * - Virtual paths are written via the appropriate handler
+     * - Regular files are written via the draft interface
+     *
+     * @param relativePath - Virtual path relative to app root
+     * @param content - File content to write
+     * @param options - Optional write options
+     * @param options.bypassRequireRead - Skip the read-before-write check (use for new files)
+     * @throws Error if path is blacklisted, restricted, or draft manager not configured
+     * @throws Error if file requires reading first (unless bypassed)
+     */
+    writeFile(relativePath: string, content: string, options?: {
+        bypassRequireRead?: boolean;
+    }): Promise<void>;
+    /**
+     * Internal write implementation.
+     * Called directly by writeFile (no queue wrapper needed since draftInterface queues).
+     */
+    private writeFileInternal;
+    /**
+     * Deletes a file or directory as a draft operation.
+     *
+     * Handles virtual path translation for files managed by the VirtualFileSystem:
+     * - Virtual paths delete via the appropriate handler
+     * - Regular files/directories are deleted via the draft interface
+     *
+     * @param relativePath - Virtual path relative to app root
+     * @throws Error if path is protected or draft manager not configured
+     */
+    deleteFile(relativePath: string): Promise<void>;
+    /**
+     * Internal delete implementation.
+     * Called directly by deleteFile (no queue wrapper needed since draftInterface queues).
+     */
+    private deleteFileInternal;
+    /**
+     * Lists files matching patterns, returning virtual paths.
+     *
+     * Physical files managed by the VirtualFileSystem are converted to
+     * their virtual representations (e.g., apis/MyAPI/api.yaml -> apis/MyAPI.ts).
+     *
+     * @param patterns - Glob patterns to match (defaults to application files)
+     * @param options - Glob options
+     * @returns Array of matching virtual file paths
+     */
+    listFiles(patterns?: string[], options?: GlobOptionsWithFileTypesUnset): Promise<string[]>;
+    /**
+     * Lists files matching patterns with metadata.
+     *
+     * @param patterns - Glob patterns to match (defaults to application files)
+     * @param options - Options including includeMetadata: true
+     * @returns Array of FileMetadata objects
+     */
+    listFiles(patterns?: string[], options?: ListFilesOptions & {
+        includeMetadata: true;
+    }): Promise<FileMetadata[]>;
+    /**
+     * Gets metadata for a list of file paths.
+     *
+     * @param paths - Array of virtual paths to get metadata for
+     * @returns Array of FileMetadata objects (excludes paths that don't exist)
+     */
+    private getFileMetadataList;
+    /**
+     * Gets metadata for a single file path.
+     *
+     * @param virtualPath - The virtual path to get metadata for
+     * @returns FileMetadata or undefined if file doesn't exist
+     */
+    private getFileMetadata;
+    /**
+     * Gets metadata for a virtual API file.
+     * Checks scratch file first (for pending changes), then falls back to YAML.
+     *
+     * @param virtualPath - The virtual API path (e.g., "apis/MyAPI.ts")
+     * @returns FileMetadata or undefined if not found
+     */
+    private getApiFileMetadata;
+    /**
+     * Renames or moves a file.
+     *
+     * Implemented as read + write + delete to work with the draft system.
+     *
+     * @param oldPath - Current virtual path
+     * @param newPath - New virtual path
+     * @throws Error if old file doesn't exist or new path is invalid
+     * @throws Error if old file requires reading first
+     */
+    renameFile(oldPath: string, newPath: 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 draft interface for direct access.
+     *
+     * This should only be used for advanced operations that require
+     * direct access to the draft interface. Prefer using the AppShell
+     * methods when possible.
+     *
+     * @internal
+     */
+    getDraftInterface(): DraftInterface | undefined;
+    /**
+     * Check if a file must be read before it can be written.
+     *
+     * @param relativePath - The path to check
+     * @returns true if the file must be read before writing
+     */
+    isReadRequired(relativePath: string): boolean;
+    /**
+     * Mark a file as requiring a read before write.
+     *
+     * Call this when a file has been modified externally (e.g., by lint/format)
+     * to ensure the AI reads the updated content before making further changes.
+     *
+     * @param relativePath - The path to mark as requiring read
+     */
+    requireRead(relativePath: string): void;
+    /**
+     * Mark a file as having been read, allowing subsequent writes.
+     * Called internally after successful read operations.
+     */
+    private markRead;
+    /**
+     * Recursively deletes directory contents by creating draft deletes.
+     */
+    private deleteDirectoryRecursive;
 }
 //# sourceMappingURL=shell.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/ai-service/app-interface/shell.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,KAAK,6BAA6B,EAAE,MAAM,MAAM,CAAC;AAMhE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAarE,qBAAa,QAAQ;IACnB,SAAgB,cAAc,EAAE,MAAM,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,aAAa,CAAC,CAAkC;gBAE5C,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,EAAE;QACD,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,eAAe,CAAC;QAClC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACjD;IAQY,SAAS,CACpB,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,CAAC,EAAE,6BAA6B,EAC3C,kBAAkB,UAAO,GACxB,OAAO,CAAC,YAAY,EAAE,CAAC;IA4Cb,YAAY,CACvB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAoB9B,qBAAqB,CAChC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoCZ,SAAS,CACpB,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IAoBpC,eAAe;IAKT,aAAa,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BvD,wBAAwB,CAAC,WAAW,CAAC,EAAE,WAAW;IA8ClD,uBAAuB,CAClC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,EAClE,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,MAAM,CAAC;IAiGL,iBAAiB,CAC5B,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,GACA,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA2BjC,qBAAqB,CAChC,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAeH,WAAW,CAAC,OAAO,EAAE;QAChC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,GAAG,CAAC;KACf,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjB,mDAAmD;IACtC,UAAU,CAAC,YAAY,EAAE,MAAM;IAW5C;;;OAGG;IACU,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;CAcpD"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/ai-service/app-interface/shell.ts"],"names":[],"mappings":"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"}