@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

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

@@ -0,0 +1,36 @@
+/**
+ * Virtual file handler for API files.
+ *
+ * APIs appear as single TypeScript files (apis/MyAPI.ts) but are stored
+ * as directories containing YAML definitions and step files.
+ */
+import type { FileMetadata, VirtualFileHandler, VirtualPathInfo, VirtualReadOptions, VirtualWriteOptions, VirtualDeleteOptions } from "../virtual-fs-types.js";
+/**
+ * Handler for virtual API files.
+ *
+ * Virtual path: apis/MyAPI.ts
+ * Physical storage: apis/MyAPI/api.yaml + step files
+ * Scratch location: .superblocks/scratch/apis%2FMyAPI.ts
+ */
+export declare class ApiFileHandler implements VirtualFileHandler {
+    readonly type = "api";
+    private readonly logger;
+    matches(virtualPath: string): boolean;
+    matchesPhysical(physicalPath: string): boolean;
+    parse(virtualPath: string): VirtualPathInfo | undefined;
+    toVirtualPath(physicalPath: string): string | undefined;
+    read(virtualPath: string, options: VirtualReadOptions): Promise<string | undefined>;
+    write(virtualPath: string, content: string, options: VirtualWriteOptions): Promise<void>;
+    delete(virtualPath: string, options: VirtualDeleteOptions): Promise<string[]>;
+    /**
+     * 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")
+     * @param options - Read options including app root
+     * @returns FileMetadata or undefined if not found
+     */
+    getMetadata(virtualPath: string, options: VirtualReadOptions): Promise<FileMetadata | undefined>;
+    private deleteDirectoryContents;
+}
+//# sourceMappingURL=api-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-handler.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/app-interface/filesystem/handlers/api-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAsBhC;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,kBAAkB;IACvD,QAAQ,CAAC,IAAI,SAAS;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKrC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI9C,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAavD,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUjD,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA+FxB,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAcV,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,MAAM,EAAE,CAAC;IA2CpB;;;;;;;OAOG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;YA2CtB,uBAAuB;CAyBtC"}

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

@@ -0,0 +1,250 @@
+/**
+ * Virtual file handler for API files.
+ *
+ * APIs appear as single TypeScript files (apis/MyAPI.ts) but are stored
+ * as directories containing YAML definitions and step files.
+ */
+import { readFile, mkdir, writeFile, access, rm, readdir, stat, } from "node:fs/promises";
+import * as path from "node:path";
+import { getLogger, getErrorMeta } from "../../../../util/logger.js";
+import { Paths } from "../../../const.js";
+import { YamlToApiBuilderTransformer } from "../../../transform/api-builder/to-sdk-transformer.js";
+import { matchPath, matchMultiplePaths, renderPath, applyFileTransformations, } from "../../../transform/shared.js";
+// Path matchers
+const generatedApisMatch = matchPath(Paths.GeneratedApis);
+const apiArtifactsMatchRaw = matchMultiplePaths("apis/:apiName", "apis/:apiName/", "apis/:apiName/**");
+/**
+ * Matches physical API artifact paths (directories and files inside API dirs).
+ * Excludes virtual paths like apis/MyAPI.ts.
+ */
+function matchPhysicalApiPath(physicalPath) {
+    const match = apiArtifactsMatchRaw(physicalPath);
+    if (match.matched && !match.params.apiName.endsWith(".ts")) {
+        return match;
+    }
+    return { matched: false };
+}
+/**
+ * Handler for virtual API files.
+ *
+ * Virtual path: apis/MyAPI.ts
+ * Physical storage: apis/MyAPI/api.yaml + step files
+ * Scratch location: .superblocks/scratch/apis%2FMyAPI.ts
+ */
+export class ApiFileHandler {
+    type = "api";
+    logger = getLogger();
+    matches(virtualPath) {
+        const match = generatedApisMatch(virtualPath);
+        return match.matched && match.params.apiName.endsWith(".ts");
+    }
+    matchesPhysical(physicalPath) {
+        return matchPhysicalApiPath(physicalPath).matched;
+    }
+    parse(virtualPath) {
+        const match = generatedApisMatch(virtualPath);
+        if (match.matched && match.params.apiName.endsWith(".ts")) {
+            return {
+                type: this.type,
+                params: {
+                    apiName: path.basename(match.params.apiName, ".ts"),
+                },
+            };
+        }
+        return undefined;
+    }
+    toVirtualPath(physicalPath) {
+        const match = matchPhysicalApiPath(physicalPath);
+        if (match.matched) {
+            return renderPath(Paths.GeneratedApis, {
+                apiName: `${match.params.apiName}.ts`,
+            });
+        }
+        return undefined;
+    }
+    async read(virtualPath, options) {
+        const info = this.parse(virtualPath);
+        if (!info)
+            return undefined;
+        const { appRootDirPath, templateRenderer, entityNames = [] } = options;
+        const { apiName } = info.params;
+        if (!apiName)
+            return undefined;
+        // Build paths
+        const scratchPath = renderPath(Paths.Scratch, { path: virtualPath });
+        const fullScratchPath = path.join(appRootDirPath, scratchPath);
+        const yamlPath = renderPath(Paths.ApiYamls, { apiName });
+        const fullYamlPath = path.join(appRootDirPath, yamlPath);
+        // Check if both scratch and YAML exist, and compare timestamps
+        // If YAML is newer than scratch, the scratch is stale (user made manual edits)
+        let scratchExists = false;
+        let scratchMtime;
+        let yamlExists = false;
+        let yamlMtime;
+        try {
+            const scratchStat = await stat(fullScratchPath);
+            scratchExists = true;
+            scratchMtime = scratchStat.mtime;
+        }
+        catch {
+            this.logger.debug(`Scratch file does not exist: ${fullScratchPath}`);
+        }
+        try {
+            const yamlStat = await stat(fullYamlPath);
+            yamlExists = true;
+            yamlMtime = yamlStat.mtime;
+        }
+        catch {
+            this.logger.debug(`YAML file does not exist: ${fullYamlPath}`);
+        }
+        // If scratch exists and is newer than YAML (or YAML doesn't exist), use scratch
+        const scratchIsFresh = scratchExists &&
+            scratchMtime &&
+            (!yamlExists || !yamlMtime || scratchMtime >= yamlMtime);
+        if (scratchIsFresh) {
+            return await readFile(fullScratchPath, "utf-8");
+        }
+        // YAML doesn't exist and scratch is stale or missing
+        if (!yamlExists) {
+            this.logger.debug(`YAML file does not exist: ${fullYamlPath}`);
+            return undefined;
+        }
+        if (!templateRenderer) {
+            throw new Error("TemplateRenderer is required to generate API content from YAML");
+        }
+        // Generate from YAML (scratch is stale or doesn't exist)
+        const yamlArtifact = {
+            type: "file",
+            filePath: yamlPath,
+            content: "",
+        };
+        const [sdkArtifact] = await applyFileTransformations([yamlArtifact], [
+            new YamlToApiBuilderTransformer({
+                appRootDirPath,
+                entityNames,
+                skipCleanup: true,
+                templateRenderer,
+            }),
+        ]);
+        // Cache the transformed result to scratch for subsequent reads
+        if (sdkArtifact?.content) {
+            try {
+                await mkdir(path.dirname(fullScratchPath), { recursive: true });
+                await writeFile(fullScratchPath, sdkArtifact.content, "utf-8");
+            }
+            catch (err) {
+                // Cache write failure should not break the read operation
+                getLogger().warn(`Failed to cache transformed API to scratch: ${fullScratchPath}`, getErrorMeta(err));
+            }
+        }
+        return sdkArtifact?.content;
+    }
+    async write(virtualPath, content, options) {
+        const info = this.parse(virtualPath);
+        if (!info) {
+            throw new Error(`Invalid API path: ${virtualPath}`);
+        }
+        const { appRootDirPath } = options;
+        const scratchPath = renderPath(Paths.Scratch, { path: virtualPath });
+        const fullScratchPath = path.join(appRootDirPath, scratchPath);
+        await mkdir(path.dirname(fullScratchPath), { recursive: true });
+        await writeFile(fullScratchPath, content, "utf-8");
+    }
+    async delete(virtualPath, options) {
+        const info = this.parse(virtualPath);
+        if (!info) {
+            throw new Error(`Invalid API path: ${virtualPath}`);
+        }
+        const { appRootDirPath, createDraftDelete } = options;
+        const { apiName } = info.params;
+        if (!apiName) {
+            throw new Error(`Missing apiName in parsed path: ${virtualPath}`);
+        }
+        const deletedPaths = [];
+        // Delete API directory contents
+        const apiDirPath = renderPath(Paths.GeneratedApis, { apiName });
+        const absoluteApiDirPath = path.join(appRootDirPath, apiDirPath);
+        try {
+            await access(absoluteApiDirPath);
+            await this.deleteDirectoryContents(absoluteApiDirPath, appRootDirPath, createDraftDelete, deletedPaths);
+            await rm(absoluteApiDirPath, { recursive: true, force: true });
+        }
+        catch {
+            // API directory doesn't exist
+        }
+        // Delete scratch file if it exists
+        const scratchPath = renderPath(Paths.Scratch, { path: virtualPath });
+        try {
+            await createDraftDelete(scratchPath);
+            deletedPaths.push(scratchPath);
+        }
+        catch {
+            // Scratch file doesn't exist
+        }
+        return deletedPaths;
+    }
+    /**
+     * 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")
+     * @param options - Read options including app root
+     * @returns FileMetadata or undefined if not found
+     */
+    async getMetadata(virtualPath, options) {
+        const info = this.parse(virtualPath);
+        if (!info)
+            return undefined;
+        const { appRootDirPath } = options;
+        const { apiName } = info.params;
+        if (!apiName)
+            return undefined;
+        // Check scratch file first (for pending changes)
+        const scratchPath = renderPath(Paths.Scratch, { path: virtualPath });
+        const fullScratchPath = path.join(appRootDirPath, scratchPath);
+        try {
+            const stats = await stat(fullScratchPath);
+            return {
+                path: virtualPath,
+                size: stats.size,
+                mtime: stats.mtime,
+                isDirectory: false,
+                isFile: true,
+            };
+        }
+        catch {
+            // Fall back to YAML file
+        }
+        // Check YAML file
+        const yamlPath = renderPath(Paths.ApiYamls, { apiName });
+        const fullYamlPath = path.join(appRootDirPath, yamlPath);
+        try {
+            const stats = await stat(fullYamlPath);
+            return {
+                path: virtualPath,
+                size: stats.size,
+                mtime: stats.mtime,
+                isDirectory: false,
+                isFile: true,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async deleteDirectoryContents(dirPath, appRootDirPath, createDraftDelete, deletedPaths) {
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry.name);
+            const relativePath = path.relative(appRootDirPath, fullPath);
+            if (entry.isDirectory()) {
+                await this.deleteDirectoryContents(fullPath, appRootDirPath, createDraftDelete, deletedPaths);
+            }
+            else {
+                await createDraftDelete(relativePath);
+                deletedPaths.push(relativePath);
+            }
+        }
+    }
+}
+//# sourceMappingURL=api-handler.js.map

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

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

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

@@ -0,0 +1,95 @@
+import type { KnowledgeManager } from "../../../knowledge/knowledge-manager.js";
+import { SkillLayer, type VirtualSkillFile, type WriteResult } from "../../../skills/index.js";
+import type { FileMetadata, VirtualFileHandler, VirtualPathInfo, VirtualReadOptions, VirtualWriteOptions, VirtualDeleteOptions } from "../virtual-fs-types.js";
+export declare class SkillFileHandler implements VirtualFileHandler {
+    readonly type = "skill";
+    private readonly logger;
+    private readonly knowledgeManager?;
+    private currentAppRootDirPath?;
+    private systemSkillsDirPath?;
+    private systemSkillsMaterializationPromise?;
+    constructor(knowledgeManager?: KnowledgeManager, appRootDirPath?: string);
+    /**
+     * Check if path is a system skill path.
+     */
+    isSkillPathForLayer(layer: SkillLayer, virtualPath: string): boolean;
+    /**
+     * Check if this handler manages the given virtual path.
+     */
+    matches(virtualPath: string): boolean;
+    /**
+     * Check if a physical path belongs to this handler's domain.
+     * App skills are stored at their virtual path (.superblocks/skills/app/).
+     */
+    matchesPhysical(physicalPath: string): boolean;
+    /**
+     * Parse a virtual path to extract skill info.
+     */
+    parse(virtualPath: string): VirtualPathInfo | undefined;
+    /**
+     * Convert physical path to virtual path.
+     * App skills use their physical path as their virtual path.
+     */
+    toVirtualPath(physicalPath: string): string | undefined;
+    /**
+     * Read a skill file.
+     * Used by Clark's readFile tool for progressive loading.
+     */
+    read(virtualPath: string, options: VirtualReadOptions): Promise<string | undefined>;
+    /**
+     * Write a skill file.
+     * Only allowed for app skills; org/user skills go through Learning API.
+     */
+    write(virtualPath: string, content: string, options: VirtualWriteOptions): Promise<void>;
+    /**
+     * Write a skill file with result object.
+     * This is the preferred method for Track 2 integration.
+     */
+    writeSkillFile(virtualPath: string, _content: string, _options: VirtualWriteOptions): Promise<WriteResult>;
+    /**
+     * Delete a skill file.
+     * System skills cannot be deleted.
+     */
+    delete(virtualPath: string, _options: VirtualDeleteOptions): Promise<string[]>;
+    /**
+     * Get metadata for a skill file.
+     */
+    getMetadata(virtualPath: string, options: VirtualReadOptions): Promise<FileMetadata | undefined>;
+    /**
+     * List files in a skill directory.
+     * Used by Clark's listFiles tool for discovery.
+     */
+    listFiles(virtualPath: string, options: VirtualReadOptions): Promise<VirtualSkillFile[]>;
+    /**
+     * List skill files for AppShell compatibility.
+     * Returns FileMetadata[] for integration with existing listing code.
+     */
+    listSkillFilesAsMetadata(virtualPath: string, options: VirtualReadOptions): Promise<FileMetadata[]>;
+    private ensureSystemSkillsMaterialized;
+    private prewarmSystemSkillsMaterialization;
+    private readSystemSkill;
+    private getSystemSkillMetadata;
+    private listSystemSkills;
+    private listSystemSkillsFromDisk;
+    private listSystemSkillsFromRegistry;
+    /**
+     * Format a fact as markdown content for Clark to read.
+     */
+    private formatFactAsKnowledge;
+    /**
+     * Read an org fact.
+     * Path format: skills/org/{factId}/KNOWLEDGE.md
+     */
+    private readOrgFact;
+    /**
+     * Read a user fact.
+     * Path format: skills/user/{factId}/KNOWLEDGE.md
+     */
+    private readUserFact;
+    /**
+     * Read an integration fact.
+     * Path format: skills/integrations/{integrationId}/{factId}/KNOWLEDGE.md
+     */
+    private readIntegrationFact;
+}
+//# sourceMappingURL=skill-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-handler.d.ts","sourceRoot":"","sources":["../../../../../src/ai-service/app-interface/filesystem/handlers/skill-handler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAIL,UAAU,EAEV,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,gBAAiB,YAAW,kBAAkB;IACzD,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAmB;IACrD,OAAO,CAAC,qBAAqB,CAAC,CAAS;IACvC,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,kCAAkC,CAAC,CAAgB;gBAE/C,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,cAAc,CAAC,EAAE,MAAM;IAmBxE;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAIpE;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAQrC;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAO9C;;OAEG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAcvD;;;OAGG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAkBvD;;;OAGG;IACG,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAmC9B;;;OAGG;IACG,KAAK,CACT,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAOhB;;;OAGG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAAC,WAAW,CAAC;IAyBvB;;;OAGG;IACG,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,MAAM,EAAE,CAAC;IAYpB;;OAEG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAkBpC;;;OAGG;IACG,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA+B9B;;;OAGG;IACG,wBAAwB,CAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC;YAaZ,8BAA8B;IAuC5C,OAAO,CAAC,kCAAkC;YA2B5B,eAAe;YA2Cf,sBAAsB;YA2CtB,gBAAgB;YAgBhB,wBAAwB;IAuDtC,OAAO,CAAC,4BAA4B;IAgEpC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAsCnB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAsCpB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CA4C5B"}