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

package/dist/ai-service/agent/tools/build-multi-edit-file.js

@@ -0,0 +1,207 @@
+import { createTwoFilesPatch } from "diff";
+import z from "zod";
+import { createToolFactory, ToolCategory, ToolExecutionError, } from "../tools2/types.js";
+import { markSdkApiAsUntestedIfNeeded } from "./apis/api-testing-state.js";
+import { replace } from "./build-edit-file.js";
+import { debugCache, createTypeScriptCheckFunction } from "./debug-cache.js";
+function trimDiff(diff) {
+    const lines = diff.split("\n");
+    const contentLines = lines.filter((line) => (line.startsWith("+") || line.startsWith("-") || line.startsWith(" ")) &&
+        !line.startsWith("---") &&
+        !line.startsWith("+++"));
+    if (contentLines.length === 0)
+        return diff;
+    let min = Infinity;
+    for (const line of contentLines) {
+        const content = line.slice(1);
+        if (content.trim().length > 0) {
+            const match = content.match(/^(\s*)/);
+            if (match?.[1])
+                min = Math.min(min, match[1].length);
+        }
+    }
+    if (min === Infinity || min === 0)
+        return diff;
+    const trimmedLines = lines.map((line) => {
+        if ((line.startsWith("+") || line.startsWith("-") || line.startsWith(" ")) &&
+            !line.startsWith("---") &&
+            !line.startsWith("+++")) {
+            const prefix = line[0] ?? "";
+            const content = line.slice(1);
+            return prefix + content.slice(min);
+        }
+        return line;
+    });
+    return trimmedLines.join("\n");
+}
+export const buildMultiEditFileToolFactory = createToolFactory("build_multiEditFile", ({ clark, services, }) => {
+    return {
+        category: ToolCategory.FILE,
+        description: `
+      A tool for making multiple edits to a single file in one operation. Built on top of the Edit tool, it allows efficient find-and-replace operations across a file.
+
+      Before using this tool:
+      1. Use the Read tool to understand the file's contents and context
+      2. Verify the directory path is correct
+
+      To make multiple file edits, provide the following:
+      1. filePath: The relative path to the file to modify (must be relative, not absolute)
+      2. edits: An array of edit operations to perform, where each edit contains:
+         - oldString: The text to replace (must match the file contents exactly, including all whitespace and indentation)
+         - newString: The edited text to replace the oldString
+         - replaceAll: Replace all occurrences of oldString. This parameter is optional and defaults to false.
+
+      IMPORTANT:
+      - All edits are applied in sequence, in the order they are provided
+      - Each edit operates on the result of the previous edit
+      - All edits must be valid for the operation to succeed - if any edit fails, none will be applied
+      - This tool is ideal when you need to make several changes to different parts of the same file
+
+      CRITICAL REQUIREMENTS:
+      1. All edits follow the same requirements as the single Edit tool
+      2. The edits are atomic - either all succeed or none are applied
+      3. Plan your edits carefully to avoid conflicts between sequential operations
+
+      WARNING:
+      - The tool will fail if edits.oldString doesn't match the file contents exactly (including whitespace)
+      - The tool will fail if edits.oldString and edits.new String are the same
+      - Since edits are applied in sequence, ensure that earlier edits don't affect the text that later edits are trying to find
+
+      When making edits:
+      - Ensure all edits result in idiomatic, correct code
+      - Do not leave the code in a broken state
+      - Always use relative file paths
+      - Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.
+      - Use replaceAll for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.
+
+      If you want to create a new file, use:
+      - A new file path, including dir name if needed
+      - First edit: empty oldString and the new file's contents as newString
+      - Subsequent edits: normal edit operations on the created content
+
+      DO NOT USE FOR API SOURCE CODE. Use the appropriate specialized tools instead.
+    `,
+        inputSchema: z.object({
+            filePath: z
+                .string()
+                .describe("The relative path to the file to modify"),
+            edits: z
+                .array(z.object({
+                oldString: z.string().describe("The text to replace"),
+                newString: z.string().describe("The text to replace it with"),
+                replaceAll: z
+                    .boolean()
+                    .optional()
+                    .describe("Replace all occurrences of oldString (default false)."),
+            }))
+                .min(1)
+                .describe("Array of edit operations to perform sequentially on the file"),
+        }),
+        execute: async ({ filePath, edits }) => {
+            if (!filePath) {
+                throw new Error("filePath is required");
+            }
+            // Prevent editing API source code - use writeApi + buildApi instead
+            // Match apis/*.ts but not apis/*.d.ts (type definitions are allowed)
+            if (/^apis\/[^/]+\.ts$/.test(filePath) && !filePath.endsWith(".d.ts")) {
+                throw new ToolExecutionError(`Cannot edit API source code directly. Use the writeApi tool to modify "${filePath}", then buildApi to compile and validate it.`, {
+                    toolName: "build_multiEditFile",
+                    input: {},
+                    context: {},
+                    severity: "warn",
+                });
+            }
+            if (!edits || edits.length === 0) {
+                throw new Error("At least one edit operation is required");
+            }
+            // Validate all edits first
+            for (const [index, edit] of edits.entries()) {
+                if (edit.oldString === edit.newString) {
+                    throw new ToolExecutionError(`Edit ${index + 1}: oldString and newString must be different`, { toolName: "", input: {}, context: {}, severity: "warn" });
+                }
+            }
+            let contentCurrent = "";
+            let contentOriginal = "";
+            // Handle file creation if first edit has empty oldString
+            const firstEdit = edits[0];
+            if (firstEdit.oldString === "") {
+                contentCurrent = firstEdit.newString;
+                contentOriginal = "";
+                // Apply remaining edits to the created content
+                for (let i = 1; i < edits.length; i++) {
+                    const edit = edits[i];
+                    try {
+                        contentCurrent = replace(contentCurrent, edit.oldString, edit.newString, edit.replaceAll ?? false);
+                    }
+                    catch (error) {
+                        throw new Error(`Edit ${i + 1} failed: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+            }
+            else {
+                try {
+                    contentCurrent = await services.appShell.readFile(filePath);
+                    contentOriginal = contentCurrent;
+                }
+                catch {
+                    throw new ToolExecutionError(`File ${filePath} not found`, {
+                        toolName: "",
+                        input: {},
+                        context: {},
+                        severity: "warn",
+                    });
+                }
+                // Apply all edits sequentially
+                for (let i = 0; i < edits.length; i++) {
+                    const edit = edits[i];
+                    try {
+                        contentCurrent = replace(contentCurrent, edit.oldString, edit.newString, edit.replaceAll ?? false);
+                    }
+                    catch (error) {
+                        throw new Error(`Edit ${i + 1} failed: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+            }
+            // Generate diff between original and final content
+            const diff = trimDiff(createTwoFilesPatch(filePath, filePath, contentOriginal, contentCurrent));
+            await services.appShell.writeFile(filePath, contentCurrent);
+            // Immediately invalidate TypeScript cache since we just modified files
+            debugCache.invalidateTypeScript();
+            // Update last modification time
+            clark.updateContext({
+                lastFileModificationTime: Date.now(),
+                runtimeErrors: [],
+            });
+            debugCache.invalidateContextErrors();
+            // When an SDK API file is created/edited, mark it as untested
+            try {
+                await markSdkApiAsUntestedIfNeeded(filePath, clark, services, {
+                    previous: contentOriginal,
+                    next: contentCurrent,
+                });
+            }
+            catch {
+                // Best-effort bookkeeping should not fail a successful file write.
+            }
+            // Trigger eager TypeScript check after multi-edit (debounced to avoid excessive checks)
+            const typeCheckFunction = createTypeScriptCheckFunction(services.appShell, clark.context.abortController?.signal);
+            debugCache.startEagerTypeScriptCheck(typeCheckFunction);
+            const result = {
+                filePath,
+                diff,
+                editsApplied: edits.length,
+                originalLength: contentOriginal.length,
+                finalLength: contentCurrent.length,
+                message: `Successfully applied ${edits.length} edit${edits.length === 1 ? "" : "s"} to ${filePath}`,
+            };
+            return result;
+        },
+        getSummary: (_input, output) => {
+            const count = output.editsApplied;
+            return {
+                output: `${count} edit${count === 1 ? "" : "s"} applied`,
+            };
+        },
+    };
+});
+//# sourceMappingURL=build-multi-edit-file.js.map

package/dist/ai-service/agent/tools/build-multi-edit-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-multi-edit-file.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-multi-edit-file.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/agent/tools/build-navigate-preview.d.ts

@@ -0,0 +1,17 @@
+import type { Clark, ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+interface NavigatePreviewToolOutput {
+    message: string;
+    path: string;
+    success: boolean;
+}
+export declare const buildNavigatePreviewToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: ClarkStateHandlerParams;
+}, import("../tools2/types.js").Tool<{
+    path: string;
+    hash?: string | undefined;
+    queryParams?: Record<string, string> | undefined;
+    routeParams?: Record<string, string> | undefined;
+}, NavigatePreviewToolOutput>>;
+export {};
+//# sourceMappingURL=build-navigate-preview.d.ts.map

package/dist/ai-service/agent/tools/build-navigate-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-navigate-preview.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-navigate-preview.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAS1C,UAAU,yBAAyB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,+BAA+B;WAErB,KAAK;cAAY,uBAAuB;;;;;;8BAwF9D,CAAC"}

package/dist/ai-service/agent/tools/build-navigate-preview.js

@@ -0,0 +1,71 @@
+import z from "zod";
+import { callPeer } from "../../util/call-peer.js";
+import { DEFAULT_RPC_TIMEOUT_MS } from "../../util/rpc-timeout.js";
+import { createToolFactory, PermissionLevel, ToolCategory, } from "../tools2/types.js";
+export const buildNavigatePreviewToolFactory = createToolFactory("build_navigatePreview", ({ clark }) => {
+    return {
+        category: ToolCategory.DEBUG,
+        defaultPermission: PermissionLevel.ALLOW,
+        description: `
+Navigate the app preview to a route path. Does not capture a screenshot.
+
+Use before \`build_captureScreenshot\` when you need visual verification on a route other than the one currently displayed.
+
+For dynamic routes (e.g. \`/users/:userId\`), pass \`routeParams\` when known; missing params default to \`TEST_VALUE_1\`, \`TEST_VALUE_2\`, etc.
+`,
+        execute: async ({ hash, path, queryParams, routeParams, }) => {
+            const logger = clark.logger;
+            logger.info(`[build_navigatePreview] Navigating preview to ${path}`);
+            if (!clark.context.peer) {
+                const error = "Editor client not available - cannot navigate preview";
+                logger.error(`[build_navigatePreview] ${error}`);
+                throw new Error(error);
+            }
+            const peer = clark.context.peer;
+            const response = await callPeer(peer, () => peer.call.aiNavigatePreviewRoute({
+                hash,
+                path,
+                queryParams,
+                routeParams,
+            }), DEFAULT_RPC_TIMEOUT_MS, "aiNavigatePreviewRoute");
+            if (!response?.success) {
+                const error = response?.error ?? `Failed to navigate preview to ${path}`;
+                logger.error(`[build_navigatePreview] ${error}`);
+                throw new Error(error);
+            }
+            const resolvedPath = response.path ?? path;
+            return {
+                message: `Successfully navigated preview to ${resolvedPath}`,
+                path: resolvedPath,
+                success: true,
+            };
+        },
+        getActionName: () => ({
+            future: "navigate the app preview to a route",
+            past: "navigated the app preview to a route",
+            present: "navigating the app preview to a route",
+        }),
+        getSummary: ({ path }) => ({
+            output: `Navigated preview to ${path}`,
+        }),
+        inputSchema: z.object({
+            hash: z
+                .string()
+                .optional()
+                .describe("Optional URL hash to append after navigation."),
+            path: z
+                .string()
+                .describe("Route path to navigate to (for example, '/feedback' or '/users/:userId')."),
+            queryParams: z
+                .record(z.string())
+                .optional()
+                .describe("Optional query string parameters for the route."),
+            routeParams: z
+                .record(z.string())
+                .optional()
+                .describe("Optional route params for dynamic segments (for example, { userId: '123' })."),
+        }),
+        readOnly: true,
+    };
+});
+//# sourceMappingURL=build-navigate-preview.js.map

package/dist/ai-service/agent/tools/build-navigate-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-navigate-preview.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-navigate-preview.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/agent/tools/build-read-file.d.ts

@@ -0,0 +1,21 @@
+import type { ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+/**
+ * Interface for tracking which system skill files have already been read
+ * in the current session. Used to prevent redundant re-reads of the same
+ * protected skill content.
+ */
+export interface SkillReadTracker {
+    hasRead(path: string): boolean;
+    markRead(path: string): void;
+}
+export declare const buildReadFileToolFactory: import("../tools2/types.js").ToolFactory<{
+    services: Pick<ClarkStateHandlerParams, "appShell">;
+    skillReadTracker?: SkillReadTracker;
+}, import("../tools2/types.js").Tool<{
+    filePath: string;
+    ranges?: {
+        start: number;
+        end: number;
+    }[] | undefined;
+}, string>>;
+//# sourceMappingURL=build-read-file.d.ts.map

package/dist/ai-service/agent/tools/build-read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-read-file.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-read-file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAUhF;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,wBAAwB;cAMvB,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC;uBAChC,gBAAgB;;;;;;;WAmLtC,CAAC"}

package/dist/ai-service/agent/tools/build-read-file.js

@@ -0,0 +1,135 @@
+import z from "zod";
+import { recordAppKnowledgeReadIfApplicable } from "../../knowledge/knowledge-metrics-emitters.js";
+import { SKILL_PATH_PREFIXES, SkillLayer } from "../../skills/types.js";
+import { createToolFactory, ToolCategory, ToolExecutionError, } from "../tools2/types.js";
+const MAX_LIMIT_READ_FILES = 25000;
+const ERROR_PREFIX = "Failed to read file:";
+export const buildReadFileToolFactory = createToolFactory("build_readFile", ({ services, skillReadTracker, }) => {
+    return {
+        category: ToolCategory.FILE,
+        description: `
+      Read content from a file in the application. You can read the entire file or specify line ranges to read specific portions.
+      - If the file is too large (>25k characters), you must read it in parts by specifying line ranges.
+      - You can specify multiple ranges to read different sections of the file.
+      - Only 25k characters can be read at once across all ranges.
+    `,
+        inputSchema: z.object({
+            filePath: z.string().describe("Path to the file to read"),
+            ranges: z
+                .array(z.object({
+                start: z
+                    .number()
+                    .int()
+                    .positive()
+                    .describe("Starting line number (1-indexed)"),
+                end: z
+                    .number()
+                    .int()
+                    .positive()
+                    .describe("Ending line number (1-indexed, inclusive)"),
+            }))
+                .optional()
+                .describe("Optional line ranges to read. If not provided, attempts to read the entire file."),
+        }),
+        execute: async ({ filePath, ranges }) => {
+            let fileContent;
+            let lines;
+            let totalLines;
+            // Deduplicate full reads of system skill files that are already in context
+            const isSystemSkill = filePath.startsWith(SKILL_PATH_PREFIXES[SkillLayer.SYSTEM]);
+            if (isSystemSkill &&
+                (!ranges || ranges.length === 0) &&
+                skillReadTracker?.hasRead(filePath)) {
+                return `This skill file has already been read in this session and is still in context. You do not need to read it again.`;
+            }
+            try {
+                fileContent = await services.appShell.readFile(filePath);
+                lines = fileContent.split("\n");
+                totalLines = lines.length;
+                // If no ranges specified, check if entire file is too large
+                if (!ranges || ranges.length === 0) {
+                    // Read entire file
+                    const output = `<file lines="${totalLines}">\n<content range="1-${totalLines}" lines="${totalLines}">\n${fileContent}\n</content>\n</file>`;
+                    if (output.length > MAX_LIMIT_READ_FILES) {
+                        throw new ToolExecutionError(`The file is too large to read all at once. Please read it in parts by specifying line ranges.`, { toolName: "", input: {}, context: {}, severity: "warn" });
+                    }
+                    if (isSystemSkill) {
+                        skillReadTracker?.markRead(filePath);
+                    }
+                    recordAppKnowledgeReadIfApplicable(filePath);
+                    return output;
+                }
+                // Extract specified ranges
+                const contentParts = [];
+                for (const range of ranges) {
+                    const startLine = Math.max(1, range.start) - 1; // Convert to 0-indexed
+                    const endLine = Math.min(totalLines, range.end); // Keep 1-indexed for display
+                    const actualStartLine = Math.max(0, startLine);
+                    const actualEndLine = Math.min(totalLines, endLine);
+                    if (actualStartLine >= actualEndLine ||
+                        actualStartLine >= lines.length) {
+                        continue; // Skip invalid ranges
+                    }
+                    const selectedLines = lines.slice(actualStartLine, actualEndLine);
+                    const rangeContent = selectedLines.join("\n");
+                    const rangeLines = selectedLines.length;
+                    contentParts.push({
+                        range: `${range.start}-${range.end}`,
+                        lines: rangeLines,
+                        content: rangeContent,
+                    });
+                }
+                if (contentParts.length === 0) {
+                    throw new ToolExecutionError("No valid line ranges were provided or all ranges were invalid.", { toolName: "", input: {}, context: {}, severity: "warn" });
+                }
+                // Build XML output
+                const contentTags = contentParts
+                    .map((part) => `<content range="${part.range}" lines="${part.lines}">\n${part.content}\n</content>`)
+                    .join("\n");
+                const output = `<file lines="${totalLines}">\n${contentTags}\n</file>`;
+                // Check total output size
+                if (output.length > MAX_LIMIT_READ_FILES) {
+                    throw new ToolExecutionError(`The total content across all specified ranges exceeds the 25k character limit. Please reduce the number of ranges or the size of each range.`, { toolName: "", input: {}, context: {}, severity: "warn" });
+                }
+                recordAppKnowledgeReadIfApplicable(filePath);
+                return output;
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw new Error(`${ERROR_PREFIX} Unknown error`);
+                }
+                throw new ToolExecutionError(`${ERROR_PREFIX} ${error.message}`, {
+                    toolName: "",
+                    input: {},
+                    context: {},
+                    severity: "warn",
+                });
+            }
+        },
+        readOnly: true,
+        getSummary: (input, output) => {
+            // Check if this is a system skill file (protected from compaction)
+            const isSystemSkill = input.filePath.startsWith(SKILL_PATH_PREFIXES[SkillLayer.SYSTEM]);
+            // Full file read
+            if (!input.ranges || input.ranges.length === 0) {
+                return { output: "full read", protected: isSystemSkill };
+            }
+            // Extract ranges from output XML content tags
+            const rangeMatches = typeof output === "string"
+                ? [...output.matchAll(/<content range="(\d+-\d+)"/g)]
+                : [];
+            const ranges = rangeMatches.map((m) => m[1]);
+            if (ranges.length === 0) {
+                return { output: "full read", protected: isSystemSkill };
+            }
+            if (ranges.length === 1) {
+                return { output: `lines ${ranges[0]}`, protected: isSystemSkill };
+            }
+            return {
+                output: `lines ${ranges.join(", ")}`,
+                protected: isSystemSkill,
+            };
+        },
+    };
+});
+//# sourceMappingURL=build-read-file.js.map

package/dist/ai-service/agent/tools/build-read-file.js.map

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

package/dist/ai-service/agent/tools/build-reload-file.d.ts

@@ -0,0 +1,14 @@
+import type { Clark, ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+export declare const buildReloadFileToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: ClarkStateHandlerParams;
+}, import("../tools2/types.js").Tool<{
+    filePath?: string | undefined;
+}, {
+    message: string;
+    filePath: undefined;
+} | {
+    message: string;
+    filePath: string;
+}>>;
+//# sourceMappingURL=build-reload-file.d.ts.map

package/dist/ai-service/agent/tools/build-reload-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-reload-file.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-reload-file.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAS1C,eAAO,MAAM,0BAA0B;WAM5B,KAAK;cACF,uBAAuB;;;;;;;;;GA6FpC,CAAC"}

package/dist/ai-service/agent/tools/build-reload-file.js

@@ -0,0 +1,78 @@
+import path from "node:path";
+import z from "zod";
+import { getPrefixedLogger } from "../../../util/logger.js";
+import { callPeer } from "../../util/call-peer.js";
+import { DEFAULT_RPC_TIMEOUT_MS } from "../../util/rpc-timeout.js";
+import { createToolFactory, PermissionLevel, ToolCategory, } from "../tools2/types.js";
+export const buildReloadFileToolFactory = createToolFactory("build_reloadFile", ({ clark, services, }) => {
+    return {
+        category: ToolCategory.GENERAL,
+        defaultPermission: PermissionLevel.ALLOW,
+        readOnly: true,
+        description: `
+Reload a part of the app.
+
+If a file path is provided, we will trigger a Hot Module Replacement (HMR) and remount the components in the app. 
+File paths are relative (e.g. "pages/Home/index.tsx").
+
+Use this tool with a path when:
+- You update an API that is run off a useEffect that should be re-evaluated.
+- You need to re-trigger some logic that only runs on component mount or file evaluation.
+
+If no file path is provided, we will trigger a full reload of the app. This can be useful if the app is not rendering after an initial generation.
+
+**IMPORTANT:**
+This tool should NOT be used as a first resort for fixing app issues. Examine error logs or build errors first.
+`,
+        inputSchema: z.object({
+            filePath: z
+                .string()
+                .optional()
+                .describe("Relative path to the file to reload (e.g., 'pages/Home/index.tsx')"),
+        }),
+        execute: async ({ filePath }) => {
+            if (!services.viteServer) {
+                throw new Error("Vite server is not available. This tool can only be used in development mode.");
+            }
+            const logger = getPrefixedLogger(`[reloadFile]`);
+            if (!filePath) {
+                // Trigger full iframe reload through the socket connection
+                if (clark.context.peer) {
+                    const peer = clark.context.peer;
+                    await callPeer(peer, () => peer.call.reloadIframe(), DEFAULT_RPC_TIMEOUT_MS, "reloadIframe");
+                }
+                logger.info("Reload tool - full reload via socket");
+                return {
+                    message: "Successfully triggered full reload",
+                    filePath: undefined,
+                };
+            }
+            const fullPath = path.join(services.appShell.appRootDirPath, filePath);
+            logger.info(`Reloading file: ${filePath} (full path: ${fullPath})`);
+            const module = services.viteServer.moduleGraph.getModuleById(fullPath);
+            if (!module) {
+                throw new Error(`Module not found for file: ${filePath}. The file may not have been imported yet.`);
+            }
+            // Invalidate the module
+            services.viteServer.moduleGraph.invalidateModule(module);
+            // Trigger immediate reload
+            await services.viteServer.reloadModule(module);
+            services.viteServer.ws.send({
+                type: "custom",
+                event: "sb:force-remount-after-reload",
+                data: {},
+            });
+            logger.info(`Successfully reloaded file: ${filePath}`);
+            return {
+                message: `Successfully reloaded file: ${filePath}`,
+                filePath,
+            };
+        },
+        getSummary: (input) => {
+            return {
+                output: input.filePath ? "File reloaded" : "App reloaded",
+            };
+        },
+    };
+});
+//# sourceMappingURL=build-reload-file.js.map

package/dist/ai-service/agent/tools/build-reload-file.js.map

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

package/dist/ai-service/agent/tools/build-rename-file.d.ts

@@ -0,0 +1,14 @@
+import type { Clark } from "../../state-machine/clark-fsm.js";
+import type { ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+export declare const buildRenameFileToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: Pick<ClarkStateHandlerParams, "appShell">;
+}, import("../tools2/types.js").Tool<{
+    oldPath: string;
+    newPath: string;
+}, {
+    oldPath: string;
+    newPath: string;
+    message: string;
+}>>;
+//# sourceMappingURL=build-rename-file.d.ts.map

package/dist/ai-service/agent/tools/build-rename-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-rename-file.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-rename-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAIhF,eAAO,MAAM,0BAA0B;WAM5B,KAAK;cACF,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC;;;;;;;;GAgFtD,CAAC"}