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

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

@@ -0,0 +1,12 @@
+import type { Clark } from "../../state-machine/clark-fsm.js";
+import type { ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+export declare const buildCopyFileToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: Pick<ClarkStateHandlerParams, "appShell">;
+}, import("../tools2/types.js").Tool<{
+    destinationPath: string;
+    sourcePath: string;
+    conflictStrategy?: "replace" | "fail" | "skip" | undefined;
+    verbose?: boolean | undefined;
+}, import("../../app-interface/shell.js").CopyToolResult>>;
+//# sourceMappingURL=build-copy-file.d.ts.map

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

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

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

@@ -0,0 +1,52 @@
+import z from "zod";
+import { createToolFactory, ToolCategory } from "../tools2/types.js";
+import { copyConflictStrategySchema, copyToolResultSchema, formatCopyCounts, } from "./build-copy-utils.js";
+import { createTypeScriptCheckFunction, debugCache } from "./debug-cache.js";
+export const buildCopyFileToolFactory = createToolFactory("build_copyFile", ({ clark, services, }) => {
+    return {
+        category: ToolCategory.FILE,
+        description: `
+      Copy one file in the application.
+
+      Use this tool when an existing file should be preserved byte-for-byte at a new destination.
+      Prefer this tool over reading a file and recreating it with build_writeFile whenever you are moving or copying existing content, including uploaded, generated, or staged files.
+      If the copied file needs small follow-up changes, copy it first with this tool, then edit the copied destination.
+
+      Usage requirements:
+      - Always use relative file paths from the project root.
+      - sourcePath must be the exact existing path from list/glob/downloadAttachments results; do not infer or shorten uploaded attachment paths from the filename alone.
+      - The destination path should include the copied filename.
+      - conflictStrategy defaults to "fail"; use "skip" to leave existing files unchanged or "replace" to overwrite.
+      - Set verbose to true only when you need per-file copied/skipped/rejected details.
+    `,
+        inputSchema: z.object({
+            conflictStrategy: copyConflictStrategySchema,
+            destinationPath: z
+                .string()
+                .describe("Destination relative path for the copied file"),
+            sourcePath: z.string().describe("Source relative path to copy from"),
+            verbose: z
+                .boolean()
+                .optional()
+                .describe("When true, include detailed copied/skipped/rejected arrays"),
+        }),
+        outputSchema: copyToolResultSchema,
+        execute: async (input) => {
+            const result = await services.appShell.copyFile(input);
+            debugCache.invalidateTypeScript();
+            clark.updateContext({
+                lastFileModificationTime: Date.now(),
+                runtimeErrors: [],
+            });
+            debugCache.invalidateContextErrors();
+            const typeCheckFunction = createTypeScriptCheckFunction(services.appShell, clark.context.abortController?.signal);
+            debugCache.startEagerTypeScriptCheck(typeCheckFunction);
+            return result;
+        },
+        getSummary: (input, output) => ({
+            input: `${input.sourcePath} -> ${input.destinationPath}`,
+            output: formatCopyCounts(output),
+        }),
+    };
+});
+//# sourceMappingURL=build-copy-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-copy-file.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-copy-file.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAIpB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,6BAA6B,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7E,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CACvD,gBAAgB,EAChB,CAAC,EACC,KAAK,EACL,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,IAAI;QAC3B,WAAW,EAAE;;;;;;;;;;;;;KAad;QACC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,gBAAgB,EAAE,0BAA0B;YAC5C,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,CAAC,+CAA+C,CAAC;YAC5D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACpE,OAAO,EAAE,CAAC;iBACP,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,4DAA4D,CAC7D;SACJ,CAAC;QACF,YAAY,EAAE,oBAAoB;QAClC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEvD,UAAU,CAAC,oBAAoB,EAAE,CAAC;YAClC,KAAK,CAAC,aAAa,CAAC;gBAClB,wBAAwB,EAAE,IAAI,CAAC,GAAG,EAAE;gBACpC,aAAa,EAAE,EAAE;aAClB,CAAC,CAAC;YACH,UAAU,CAAC,uBAAuB,EAAE,CAAC;YAErC,MAAM,iBAAiB,GAAG,6BAA6B,CACrD,QAAQ,CAAC,QAAQ,EACjB,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CACtC,CAAC;YACF,UAAU,CAAC,yBAAyB,CAAC,iBAAiB,CAAC,CAAC;YAExD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YAC9B,KAAK,EAAE,GAAG,KAAK,CAAC,UAAU,OAAO,KAAK,CAAC,eAAe,EAAE;YACxD,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC;SACjC,CAAC;KACH,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/ai-service/agent/tools/build-copy-utils.d.ts

@@ -0,0 +1,57 @@
+import z from "zod";
+import type { CopyToolResult } from "../../app-interface/shell.js";
+export declare const copyConflictStrategySchema: z.ZodDefault<z.ZodOptional<z.ZodEnum<["fail", "skip", "replace"]>>>;
+export declare const copyToolResultSchema: z.ZodObject<{
+    copied: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    copiedCount: z.ZodNumber;
+    rejected: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        reason: string;
+    }, {
+        path: string;
+        reason: string;
+    }>, "many">>;
+    rejectedCount: z.ZodNumber;
+    skipped: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason: z.ZodEnum<["destination_exists", "default_excluded"]>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        reason: "destination_exists" | "default_excluded";
+    }, {
+        path: string;
+        reason: "destination_exists" | "default_excluded";
+    }>, "many">>;
+    skippedCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    copiedCount: number;
+    rejectedCount: number;
+    skippedCount: number;
+    rejected?: {
+        path: string;
+        reason: string;
+    }[] | undefined;
+    skipped?: {
+        path: string;
+        reason: "destination_exists" | "default_excluded";
+    }[] | undefined;
+    copied?: string[] | undefined;
+}, {
+    copiedCount: number;
+    rejectedCount: number;
+    skippedCount: number;
+    rejected?: {
+        path: string;
+        reason: string;
+    }[] | undefined;
+    skipped?: {
+        path: string;
+        reason: "destination_exists" | "default_excluded";
+    }[] | undefined;
+    copied?: string[] | undefined;
+}>;
+export declare function formatCopyCounts(output: CopyToolResult): string;
+//# sourceMappingURL=build-copy-utils.d.ts.map

package/dist/ai-service/agent/tools/build-copy-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-copy-utils.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-copy-utils.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,eAAO,MAAM,0BAA0B,qEAGrB,CAAC;AAEnB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqB/B,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAY/D"}

package/dist/ai-service/agent/tools/build-copy-utils.js

@@ -0,0 +1,37 @@
+import z from "zod";
+export const copyConflictStrategySchema = z
+    .enum(["fail", "skip", "replace"])
+    .optional()
+    .default("fail");
+export const copyToolResultSchema = z.object({
+    copied: z.array(z.string()).optional(),
+    copiedCount: z.number().int().nonnegative(),
+    rejected: z
+        .array(z.object({
+        path: z.string(),
+        reason: z.string(),
+    }))
+        .optional(),
+    rejectedCount: z.number().int().nonnegative(),
+    skipped: z
+        .array(z.object({
+        path: z.string(),
+        reason: z.enum(["destination_exists", "default_excluded"]),
+    }))
+        .optional(),
+    skippedCount: z.number().int().nonnegative(),
+});
+export function formatCopyCounts(output) {
+    const parts = [];
+    if (output.copiedCount > 0) {
+        parts.push(`${output.copiedCount} copied`);
+    }
+    if (output.skippedCount > 0) {
+        parts.push(`${output.skippedCount} skipped`);
+    }
+    if (output.rejectedCount > 0) {
+        parts.push(`${output.rejectedCount} rejected`);
+    }
+    return parts.length > 0 ? parts.join(", ") : "no files copied";
+}
+//# sourceMappingURL=build-copy-utils.js.map

package/dist/ai-service/agent/tools/build-copy-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-copy-utils.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-copy-utils.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAIpB,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;KACjC,QAAQ,EAAE;KACV,OAAO,CAAC,MAAM,CAAC,CAAC;AAEnB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,QAAQ,EAAE,CAAC;SACR,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC,CACH;SACA,QAAQ,EAAE;IACb,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC7C,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;KAC3D,CAAC,CACH;SACA,QAAQ,EAAE;IACb,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC7C,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,SAAS,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,YAAY,UAAU,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,aAAa,WAAW,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { Clark, ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+import { type CombinedDebugResult } from "./debug-cache.js";
+/**
+ * Explain the ordering to the agent, but only claim what the list actually
+ * shows. `buildErrors` must be the errors the pipeline sort ran over, not the
+ * outgoing list: findings we synthesize here (the App.tsx check) are appended
+ * afterwards and are independent requirements, so letting them open the note
+ * would tell the agent a mandatory fix is somebody else's symptom.
+ */
+export declare function addBuildErrorOrderingNote(result: CombinedDebugResult, buildErrors?: Array<{
+    phase?: unknown;
+}>): void;
+export declare const buildDebugToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: ClarkStateHandlerParams;
+}, import("../tools2/types.js").Tool<{}, CombinedDebugResult>>;
+//# sourceMappingURL=build-debug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-debug.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-debug.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAEL,KAAK,mBAAmB,EAIzB,MAAM,kBAAkB,CAAC;AAmB1B;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,WAAW,GAAE,KAAK,CAAC;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAA4B,GACjE,IAAI,CAqBN;AAED,eAAO,MAAM,qBAAqB;WAMvB,KAAK;cACF,uBAAuB;8DAqRpC,CAAC"}

package/dist/ai-service/agent/tools/build-debug.js

@@ -0,0 +1,244 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import z from "zod";
+import { needsAppProviderFixInAppTsx } from "../../../ensure-app-provider.js";
+import { getLogger } from "../../../util/logger.js";
+import { Paths } from "../../const.js";
+import { createToolFactory, ToolCategory } from "../tools2/types.js";
+import { debugCache, buildErrorPhaseRank, createTypeScriptCheckFunction, createRuntimeAndBuildErrorsFunction, } from "./debug-cache.js";
+const TYPESCRIPT_DIAGNOSTIC_PATTERN = /^[^\n]+?\(\d+,\d+\): error TS\d+:/gm;
+function pluralize(count, singular) {
+    return `${count} ${singular}${count === 1 ? "" : "s"}`;
+}
+function countTypeScriptDiagnostics(typeErrors) {
+    if (!typeErrors.trim()) {
+        return 0;
+    }
+    const diagnosticCount = typeErrors.match(TYPESCRIPT_DIAGNOSTIC_PATTERN)?.length;
+    return diagnosticCount && diagnosticCount > 0 ? diagnosticCount : 1;
+}
+/**
+ * Explain the ordering to the agent, but only claim what the list actually
+ * shows. `buildErrors` must be the errors the pipeline sort ran over, not the
+ * outgoing list: findings we synthesize here (the App.tsx check) are appended
+ * afterwards and are independent requirements, so letting them open the note
+ * would tell the agent a mandatory fix is somebody else's symptom.
+ */
+export function addBuildErrorOrderingNote(result, buildErrors = result.buildSystemErrors) {
+    // Key on the rank the sort actually used, not on the phase labels. Unphased
+    // errors are ranked and reordered too, so keying on labels would stay silent
+    // in the common case of one dependency-optimization error (unphased) plus the
+    // import error it caused, which is exactly when the agent needs the note.
+    const ranks = new Set(buildErrors.map((error) => buildErrorPhaseRank(error.phase)));
+    if (ranks.size < 2) {
+        return;
+    }
+    let note = "\n\nNote: build errors are listed in build-pipeline order, so an earlier one is usually the root cause of a later one.";
+    // Only make the claim about browser-side import failures when there is one
+    // in the list to make it about.
+    if (buildErrors.some((error) => error.phase === "import")) {
+        note +=
+            " A module the browser fails to load is normally a downstream symptom of an earlier failure, so those are listed last.";
+    }
+    result.message += note;
+}
+export const buildDebugToolFactory = createToolFactory("build_debug", ({ clark, services, }) => {
+    return {
+        category: ToolCategory.GENERAL,
+        description: `
+      Run type checking and application validation on the current code.
+      Call this before finalizing to ensure there are no errors.
+
+      REQUIRED: You must call this tool at least once before calling build_finalize.
+
+      IMPORTANT: This tool provides the most accurate results when called shortly after
+      making code changes. The system automatically invalidates cached results when files
+      are modified to ensure you always get fresh validation data.
+    `,
+        inputSchema: z.object({}),
+        execute: async () => {
+            const now = Date.now();
+            const STALE_ERROR_THRESHOLD = 2 * 60 * 1000;
+            const RECENT_MODIFICATION_THRESHOLD = 5 * 1000; // 5 seconds
+            const isTypecheckEnabled = clark.context.llmConfig?.flags?.isTypecheckEnabled ?? true;
+            // Check if files were recently modified
+            const lastModTime = clark.context.lastFileModificationTime || 0;
+            const timeSinceLastModification = now - lastModTime;
+            const filesRecentlyModified = timeSinceLastModification < RECENT_MODIFICATION_THRESHOLD;
+            // If files were recently modified, invalidate TypeScript cache to force fresh check
+            if (filesRecentlyModified) {
+                debugCache.invalidateTypeScript();
+                getLogger().info(`[build_debug] Files modified ${timeSinceLastModification}ms ago, forcing fresh TypeScript check`);
+            }
+            let staleBuildErrorsDropped = 0;
+            if (clark.context.buildSystemErrors?.length) {
+                const freshErrors = clark.context.buildSystemErrors.filter((e) => {
+                    const ts = e.timestamp || 0;
+                    const errorAge = now - ts;
+                    const occurredBeforeLatestEdit = ts < lastModTime;
+                    const keep = errorAge < STALE_ERROR_THRESHOLD && !occurredBeforeLatestEdit;
+                    if (!keep)
+                        staleBuildErrorsDropped++;
+                    return keep;
+                });
+                if (freshErrors.length !== clark.context.buildSystemErrors.length) {
+                    clark.updateContext((context) => ({
+                        ...context,
+                        buildSystemErrors: freshErrors,
+                    }));
+                    debugCache.invalidateContextErrors();
+                }
+            }
+            // Use the debug cache to get combined results
+            const typeCheckFunction = isTypecheckEnabled
+                ? createTypeScriptCheckFunction(services.appShell, clark.context.abortController?.signal)
+                : async () => ({
+                    status: "success",
+                    timestamp: Date.now(),
+                    typeErrors: "",
+                });
+            const contextErrorsFunction = createRuntimeAndBuildErrorsFunction(clark, services.appShell);
+            const result = await debugCache.getCombinedResult(typeCheckFunction, contextErrorsFunction);
+            let appProviderBuildError = null;
+            try {
+                const appTsxPath = path.join(services.appShell.appRootDirPath, Paths.AppRoot);
+                const appTsx = await fs.readFile(appTsxPath, "utf-8");
+                if (needsAppProviderFixInAppTsx(appTsx)) {
+                    appProviderBuildError = {
+                        message: "CRITICAL: App.tsx must import `AppProvider` from `@superblocksteam/library` and wrap the components in `App.tsx`. (Import `{ App as AppProvider }` and ensure it wraps the `<Outlet />`.)",
+                        timestamp: now,
+                        age: 0,
+                    };
+                }
+            }
+            catch (e) {
+                const message = e instanceof Error ? e.message : String(e);
+                getLogger().debug(`[build_debug] Failed to validate App.tsx AppProvider wrapper: ${message}`);
+            }
+            const effectiveResult = appProviderBuildError
+                ? {
+                    ...result,
+                    status: "errors_found",
+                    message: result.status === "success"
+                        ? "Found errors that need to be fixed"
+                        : result.message,
+                    buildSystemErrors: [
+                        ...(result.buildSystemErrors ?? []),
+                        appProviderBuildError,
+                    ],
+                }
+                : result;
+            if (!isTypecheckEnabled) {
+                effectiveResult.message =
+                    effectiveResult.message +
+                        "\n\nNote: Type checking skipped because `isTypecheckEnabled` is false for this generation.";
+            }
+            // Track runtime errors in history
+            const errorTracker = debugCache.getErrorHistoryTracker();
+            const currentErrorKeys = new Set();
+            for (const err of effectiveResult.runtimeErrors) {
+                const errorKey = err.fingerprint
+                    ? String(err.fingerprint)
+                    : `${String(err.error)}::${err.componentType || "unknown"}`;
+                currentErrorKeys.add(errorKey);
+                errorTracker.recordError(errorKey);
+            }
+            // Check for errors that disappeared without being fixed
+            const disappeared = errorTracker.getUnresolvedDisappearances(currentErrorKeys);
+            // Add warnings about disappeared errors to result
+            const warnings = [];
+            // Warn about failed API builds that haven't been rebuilt
+            if (clark.context.failedApiBuilds?.size) {
+                warnings.push(`${clark.context.failedApiBuilds.size} API build(s) have failed and not been rebuilt:`);
+                for (const apiName of clark.context.failedApiBuilds) {
+                    warnings.push(`   - ${apiName}`);
+                }
+                warnings.push("", "These APIs must be successfully rebuilt before you can finalize.");
+            }
+            if (disappeared.length > 0) {
+                warnings.push(`${disappeared.length} runtime error(s) that were seen earlier are no longer appearing:`);
+                for (const hist of disappeared) {
+                    warnings.push(`   - "${hist.errorKey}" (seen ${hist.seenCount} time(s), last seen ${Math.round((Date.now() - hist.lastSeen) / 1000)}s ago)`);
+                }
+                warnings.push("", "These errors may not have been fixed - they might only be hidden because:", "   - Component is rendering with different data now", "   - Error boundary recovered", "   - Component is in a different state", "", "Verify these errors are actually fixed by:", "   1. Reviewing code that accesses these properties", "   2. Adding optional chaining (?.) and fallback values", "   3. Testing with null/undefined data states");
+            }
+            // Untested SDK APIs: warn in the result instead of throwing so the tool succeeds,
+            // debug state is recorded, and the agent still sees the required testApi calls.
+            const untestedApis = clark.context.apiTestingState?.untested;
+            if (untestedApis?.size) {
+                if (warnings.length > 0) {
+                    warnings.push("");
+                }
+                warnings.push(`${untestedApis.size} API(s) have not been tested yet:`);
+                for (const apiName of untestedApis) {
+                    warnings.push(`   - ${apiName}`);
+                }
+                warnings.push("", "You must call testApi for each untested API before finalizing.");
+            }
+            // Add warning about failed API tests
+            const failedApiTests = clark.context.apiTestingState?.failed;
+            if (failedApiTests?.size) {
+                if (warnings.length > 0) {
+                    warnings.push(""); // Add spacing between warning sections
+                }
+                warnings.push(`WARNING: ${failedApiTests.size} API test(s) failed:`);
+                for (const apiName of failedApiTests) {
+                    warnings.push(`   - ${apiName}`);
+                }
+                warnings.push("", "These failures may indicate bugs in your changes. Review the test output and fix any issues before finalizing.");
+            }
+            // Only mark as resolved on a clean run: no runtime errors and no disappearances
+            if ((result.runtimeErrors?.length ?? 0) === 0 &&
+                disappeared.length === 0) {
+                errorTracker.markAllNotInCurrentAsResolved(currentErrorKeys);
+            }
+            clark.updateContext({
+                debugToolCalled: true,
+                lastDebugTimestamp: result.timestamp,
+                lastDebugHadTypeErrors: Boolean(effectiveResult.typeErrors),
+            });
+            // Describe the ordering of the pipeline errors only. The App.tsx
+            // finding is appended after the sort and is an independent requirement,
+            // so it neither takes part in the ordering nor triggers the note.
+            addBuildErrorOrderingNote(effectiveResult, result.buildSystemErrors ?? []);
+            // Return result with warnings if applicable
+            if (warnings.length > 0) {
+                return {
+                    ...effectiveResult,
+                    message: effectiveResult.message + "\n\n" + warnings.join("\n"),
+                };
+            }
+            // If we dropped stale build errors but have no other warnings, surface a brief diagnostic note
+            if (staleBuildErrorsDropped > 0) {
+                return {
+                    ...effectiveResult,
+                    message: effectiveResult.message +
+                        `\n\nNote: ${staleBuildErrorsDropped} stale build error(s) were filtered because they predated the latest edits or exceeded the staleness threshold.`,
+                };
+            }
+            return effectiveResult;
+        },
+        readOnly: true,
+        getSummary: (_input, output) => {
+            const typeErrorText = typeof output.typeErrors === "string" ? output.typeErrors.trim() : "";
+            const typeErrors = countTypeScriptDiagnostics(typeErrorText);
+            const buildErrors = output.buildSystemErrors?.length ?? 0;
+            const runtimeErrors = output.runtimeErrors?.length ?? 0;
+            const total = typeErrors + buildErrors + runtimeErrors;
+            if (total === 0) {
+                return { output: "All checks passed" };
+            }
+            const parts = [];
+            if (typeErrors > 0)
+                parts.push(pluralize(typeErrors, "TS error"));
+            if (buildErrors > 0)
+                parts.push(pluralize(buildErrors, "build error"));
+            if (runtimeErrors > 0)
+                parts.push(pluralize(runtimeErrors, "runtime error"));
+            return {
+                output: parts.join(", "),
+            };
+        },
+    };
+});
+//# sourceMappingURL=build-debug.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { Clark, ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+import { PermissionLevel } from "../tools2/types.js";
+/**
+ * Check if file deletion requires user confirmation.
+ * Prompts for:
+ * - APIs (always)
+ * - Pages (except the legacy `Page1` placeholder)
+ * Allows without prompting:
+ * - `Page1`, the empty placeholder page shipped by pre-`Home` templates
+ * - All other files (components, utils, etc.)
+ */
+export declare const checkDeleteFilePermissions: (input?: {
+    filePath?: string;
+}) => Promise<PermissionLevel>;
+export declare const buildDeleteFileToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: Pick<ClarkStateHandlerParams, "appShell">;
+}, import("../tools2/types.js").Tool<{
+    filePath: string;
+    reason?: string | undefined;
+}, {
+    filePath: string;
+    type: "api" | "file" | "page";
+    message: string;
+    reason: string | undefined;
+}>>;
+//# sourceMappingURL=build-delete-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-delete-file.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-delete-file.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAGL,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAuB5B;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GAAU,QAAQ;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAG,OAAO,CAAC,eAAe,CAgC1B,CAAC;AAEF,eAAO,MAAM,0BAA0B;WAM5B,KAAK;cACF,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC;;;;;;;;;GAiLtD,CAAC"}