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

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

@@ -0,0 +1,59 @@
+import type { Clark, ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+interface ScreenshotToolOutput {
+    dataUrl?: string;
+    shortLivedUrl?: string;
+    fileName?: string;
+    mimeType?: string;
+    expirationAt?: number;
+    message?: string;
+}
+export declare const buildCaptureScreenshotToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: ClarkStateHandlerParams;
+}, import("../tools2/types.js").Tool<{
+    selector?: string | undefined;
+}, ScreenshotToolOutput>>;
+export declare const BUILD_CAPTURE_SCREENSHOT_TOOL_NAME: string;
+/**
+ * Message returned when the app preview has not rendered yet but there is no
+ * build/runtime error to point at — i.e. it's a transient state (still
+ * building/migrating) and the agent should simply wait and retry.
+ */
+export declare const APP_NOT_READY_TRANSIENT_MESSAGE = "APP_NOT_READY: The app preview has not rendered yet (it may still be building or migrating). No screenshot was taken \u2014 this is NOT a visual verification result and does NOT mean the UI is correct. Do not mark visual verification (or the task) as done. Wait a few seconds for the preview to finish rendering, then capture again. If you mention this to the user, just say the preview is still loading and you'll retry \u2014 do not paste this raw message.";
+export declare const APP_ROUTE_NOT_FOUND_MESSAGE = "APP_ROUTE_NOT_FOUND: The current preview route rendered the Superblocks 404 page (`Page not found` / `Content not found`). No screenshot was taken because this is a route verification failure, not a successful visual result. Fix the route registration/router entry and run debug checks before marking the page task complete.";
+export declare function isExpectedScreenshotVerificationError(message: string): boolean;
+/**
+ * Builds the APP_NOT_READY message for a not-rendered preview.
+ *
+ * If the app has build/runtime errors, those are almost always WHY it isn't
+ * rendering (e.g. a bad import that crashes the app shell before it mounts), so
+ * we surface them and tell the agent to fix the cause rather than just wait. If
+ * there are no errors, the non-render is transient and we return the plain
+ * wait/retry message.
+ */
+export declare function buildAppNotReadyMessage(errors: {
+    buildSystemErrors?: ReadonlyArray<{
+        message?: unknown;
+    }>;
+    runtimeErrors?: ReadonlyArray<{
+        error?: unknown;
+        message?: unknown;
+    }>;
+}): string;
+/**
+ * Validates a screenshot capture response and throws if invalid.
+ * @param response The response from the screenshot RPC call
+ * @param toolName Tool name prefix for logging (e.g., "build_captureScreenshot")
+ * @returns The validated response with dataUrl
+ * @throws Error if response is invalid
+ */
+export declare function validateScreenshotResponse(response: {
+    dataUrl?: string;
+    error?: string;
+    notReady?: boolean;
+    routeNotFound?: boolean;
+} | null | undefined, toolName: string): {
+    dataUrl: string;
+};
+export {};
+//# sourceMappingURL=build-capture-screenshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-capture-screenshot.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-capture-screenshot.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAgE1C,UAAU,oBAAoB;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,iCAAiC;WAMnC,KAAK;cACF,uBAAuB;;;yBAiRpC,CAAC;AAEF,eAAO,MAAM,kCAAkC,QACP,CAAC;AA6GzC;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,+cACwZ,CAAC;AAIrc,eAAO,MAAM,2BAA2B,yUACgS,CAAC;AAEzU,wBAAgB,qCAAqC,CACnD,OAAO,EAAE,MAAM,GACd,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,iBAAiB,CAAC,EAAE,aAAa,CAAC;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACvE,GAAG,MAAM,CA0BT;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EACJ;IACE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GACD,IAAI,GACJ,SAAS,EACb,QAAQ,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CA8CrB"}

package/dist/ai-service/agent/tools/build-capture-screenshot.js

@@ -0,0 +1,483 @@
+import z from "zod";
+import { safeJsonStringify } from "../../../util/log-sanitizer.js";
+import { getErrorMeta, getPrefixedLogger } from "../../../util/logger.js";
+import { uploadAttachmentToBucketeer } from "../../attachment-upload.js";
+import { isTransportCloseError } from "../../state-machine/helpers/stable-peer.js";
+import { callPeer, isGuardedPeerUnavailableError, } from "../../util/call-peer.js";
+import { CAPTURE_SCREENSHOT_RPC_TIMEOUT_MS, RpcTimeoutError, } from "../../util/rpc-timeout.js";
+import { createToolFactory, ToolCategory, PermissionLevel, } from "../tools2/types.js";
+import { createRuntimeAndBuildErrorsFunction } from "./debug-cache.js";
+import { normalizeScreenshotSelector } from "./screenshot-selector.js";
+const POST_RPC_TIMEOUT_BUFFER_MS = 60_000;
+const TOOL_EXECUTION_TIMEOUT_MS = CAPTURE_SCREENSHOT_RPC_TIMEOUT_MS + POST_RPC_TIMEOUT_BUFFER_MS;
+export const buildCaptureScreenshotToolFactory = createToolFactory("build_captureScreenshot", ({ clark, services, }) => {
+    return {
+        category: ToolCategory.DEBUG,
+        defaultPermission: PermissionLevel.ALLOW,
+        readOnly: true,
+        timeoutMs: TOOL_EXECUTION_TIMEOUT_MS,
+        skipOutputLimit: () => true, // Output is transformed to content type with media parts
+        description: `
+      Capture a screenshot of the app preview to verify how the UI looks (layout, styling, content).
+
+      When to use: only to check how the UI looks — this is expensive, so don't screenshot routinely. Rely on \`build_debug\` (which reports build, type, and runtime errors) to confirm the app works; use screenshots only to confirm it looks right.
+
+      Describe before concluding: first describe what you actually see (colors, spacing, text, element positions), then compare to the expected result.
+
+      Loading detection (mandatory after every capture): if you see skeletons, spinners, empty tables/charts, blank boxes, or "Loading…"/"Fetching…":
+        1. Say "Loading indicators detected — retrying."
+        2. Wait at least 3 seconds, then capture again (up to 3 retries); only after 3 retries still loading may you proceed.
+      Do not conclude the UI looks correct while loading indicators are visible.
+
+      Not rendered yet: a capture may return APP_NOT_READY — the preview hasn't rendered (still building/migrating, or a build/runtime error is blocking it). It is not a pass or a UI failure. If it lists errors, fix them and re-capture; otherwise wait a few seconds and retry. Never mark verification done on APP_NOT_READY, and after ~5 in a row stop and report the preview isn't rendering.
+
+      Route: captures only the current preview route. To verify another, call \`build_navigatePreview\` first, then \`build_captureScreenshot\`.
+
+      Prefer one full-page capture; use \`selector\` only to focus on a single element. \`selector\` must be a valid CSS selector — Playwright syntax (\`:has-text()\`, \`:visible\`, \`>>\`) and XPath are not supported.
+
+      Read-only (no interaction). Pages over 8000px in either dimension are scaled down to fit model limits.
+      `,
+        inputSchema: z.object({
+            selector: z
+                .string()
+                .optional()
+                .describe("Optional CSS selector for one element. Prefer full-page capture first; use selector only for focused follow-up."),
+        }),
+        execute: async ({ selector }) => {
+            const logger = clark.logger;
+            const telemetry = createScreenshotAttemptTelemetry({
+                hasSelector: selector !== undefined,
+                logger,
+                peer: clark.context.peer,
+            });
+            // Validate/normalize the selector before the RPC round-trip so invalid
+            // selectors (Playwright syntax, XPath, unescaped Tailwind colons) fail
+            // fast with an actionable message instead of an opaque querySelector
+            // error from the iframe.
+            telemetry.stage = "selector_validation";
+            let effectiveSelector = selector;
+            if (selector !== undefined) {
+                const normalized = normalizeScreenshotSelector(selector);
+                if (normalized.error) {
+                    telemetry.finish("invalid_selector", "selector_validation");
+                    logger.warn(`[build_captureScreenshot] Rejected invalid selector "${selector}": ${normalized.error}`);
+                    throw new Error(normalized.error);
+                }
+                effectiveSelector = normalized.selector;
+                if (effectiveSelector !== selector) {
+                    logger.info(`[build_captureScreenshot] Normalized selector "${selector}" -> "${effectiveSelector}"`);
+                }
+            }
+            logger.info(`[build_captureScreenshot] Starting screenshot capture${effectiveSelector ? ` (selector: "${effectiveSelector}")` : ""}`);
+            telemetry.stage = "peer_check";
+            if (!clark.context.peer) {
+                telemetry.finish("peer_missing", "peer_check");
+                const error = "Editor client not available - cannot capture screenshot";
+                logger.error(`[build_captureScreenshot] ${error}`);
+                throw new Error(error);
+            }
+            logger.info(`[build_captureScreenshot] Editor client available, sending capture request...`);
+            try {
+                const requestStartTime = Date.now();
+                // The editor enforces its own readiness (15s) + capture (20s)
+                // timeouts, but those errors arrive over the same websocket as the
+                // response — if the socket dies mid-call (e.g. dev pod RPC socket
+                // closed with 1006), a bare await hangs forever. Race a server-side
+                // deadline so a dead channel becomes a retriable error instead.
+                telemetry.markBeforeRpc(clark.context.peer);
+                telemetry.stage = "rpc_wait";
+                const peer = clark.context.peer;
+                const response = await callPeer(peer, () => peer.call.aiCaptureScreenshot(effectiveSelector ? { selector: effectiveSelector } : undefined), CAPTURE_SCREENSHOT_RPC_TIMEOUT_MS, "aiCaptureScreenshot");
+                const requestDuration = Date.now() - requestStartTime;
+                telemetry.markRpcComplete();
+                logger.info(`[build_captureScreenshot] Received RPC response after ${requestDuration}ms`);
+                // The preview hasn't rendered yet. Instead of just telling the agent
+                // to "wait", pull the current build/runtime errors so it can fix the
+                // cause (e.g. a bad import that prevents the app shell from mounting)
+                // when there is one. When diagnostics are clean it's transient and we
+                // keep the wait/retry guidance.
+                telemetry.stage = "response_classification";
+                if (response?.notReady) {
+                    let contextErrors;
+                    try {
+                        contextErrors = createRuntimeAndBuildErrorsFunction(clark, services.appShell)();
+                    }
+                    catch (errorsError) {
+                        // Never let a failure to read diagnostics turn an expected
+                        // not-ready into a hard capture error — fall back to the
+                        // transient message.
+                        logger.warn(`[build_captureScreenshot] Could not read build/runtime errors for APP_NOT_READY`, getErrorMeta(errorsError));
+                    }
+                    // Reuse one fallback so the message and the log can't disagree, and
+                    // so the log is safe whether diagnostics were missing entirely
+                    // (contextErrors undefined) or came back without one of the arrays.
+                    const safeErrors = contextErrors ?? {
+                        buildSystemErrors: [],
+                        runtimeErrors: [],
+                    };
+                    const message = buildAppNotReadyMessage(safeErrors);
+                    // info, not warn/error: APP_NOT_READY is an expected transient/
+                    // behavioral state. Include the message so oncall sees which errors
+                    // (if any) are blocking the render without a second query.
+                    logger.info(`[build_captureScreenshot] App not rendered; returning APP_NOT_READY (${safeErrors.buildSystemErrors?.length ?? 0} build, ${safeErrors.runtimeErrors?.length ?? 0} runtime errors). ${message}`);
+                    telemetry.finish("app_not_ready", "response_classification");
+                    throw new Error(message);
+                }
+                const responseWithStatus = response;
+                if (responseWithStatus?.routeNotFound || responseWithStatus?.error) {
+                    // Keep browser-declared error responses in response_classification
+                    // telemetry; validateScreenshotResponse throws for these cases.
+                    validateScreenshotResponse(responseWithStatus, "build_captureScreenshot");
+                }
+                telemetry.stage = "response_validation";
+                const { dataUrl } = validateScreenshotResponse(response, "build_captureScreenshot");
+                logger.info(`[build_captureScreenshot] Successfully captured screenshot (${dataUrl.length} chars)`);
+                const jwt = clark.context.jwt;
+                if (jwt) {
+                    let uploadResult;
+                    telemetry.stage = "upload";
+                    telemetry.markUploadStart();
+                    try {
+                        uploadResult = await uploadAttachmentToBucketeer({
+                            applicationId: services.applicationId,
+                            file: { data: dataUrl, mimeType: "image/webp" },
+                            fileName: "captured-screenshot.webp",
+                            prefix: "captured-screenshot",
+                            useServerUpload: services.features.aiFileUploadEnabled === true,
+                            superblocksBaseUrl: services.superblocksBaseUrl,
+                            jwt,
+                            logger,
+                        });
+                    }
+                    catch (uploadError) {
+                        telemetry.markUploadFallback("upload_error");
+                        logger.warn(`[build_captureScreenshot] S3 upload failed, falling back to base64`, getErrorMeta(uploadError));
+                        // Fall through to base64 fallback
+                    }
+                    finally {
+                        telemetry.markUploadComplete();
+                    }
+                    if (uploadResult) {
+                        logger.info(`[build_captureScreenshot] Uploaded to S3: ${uploadResult.fileName}`);
+                        telemetry.finish("success", "complete");
+                        return {
+                            dataUrl,
+                            fileName: uploadResult.fileName,
+                            shortLivedUrl: uploadResult.url,
+                            mimeType: "image/webp",
+                            expirationAt: uploadResult.expirationDate,
+                            message: `Successfully captured screenshot.
+REMINDER: Before making any conclusions, check this screenshot for loading indicators (skeletons, spinners, empty tables/charts, grey placeholder boxes). If ANY are visible, you MUST wait a few seconds and take another screenshot — do NOT treat a loading-state screenshot as the final result.
+If the screenshot is blank, check error logs. If there is nothing reported, consider using the reloadFile tool to reload the entire app.`,
+                        };
+                    }
+                }
+                else {
+                    telemetry.stage = "upload";
+                    telemetry.markUploadFallback("no_jwt");
+                    logger.warn(`[build_captureScreenshot] No JWT available, falling back to base64`);
+                }
+                telemetry.finish(telemetry.usedUploadFallback ? "upload_fallback" : "success", telemetry.usedUploadFallback ? "upload" : "complete");
+                return {
+                    dataUrl,
+                    message: `Successfully captured screenshot.
+REMINDER: Before making any conclusions, check this screenshot for loading indicators (skeletons, spinners, empty tables/charts, grey placeholder boxes). If ANY are visible, you MUST wait a few seconds and take another screenshot — do NOT treat a loading-state screenshot as the final result.
+If the screenshot is blank, check error logs. If there is nothing reported, consider using the reloadFile tool to reload the entire app.`,
+                };
+            }
+            catch (error) {
+                if (!telemetry.finished) {
+                    if (telemetry.stage === "rpc_wait") {
+                        telemetry.markRpcComplete();
+                    }
+                    telemetry.finish(classifyScreenshotFailure(error), telemetry.stage);
+                }
+                const errorMeta = getErrorMeta(error);
+                // Expected verification states are already logged at their intended
+                // levels by validateScreenshotResponse; don't re-log as tool errors.
+                if (!isExpectedScreenshotVerificationError(errorMeta.error.message) &&
+                    !isGuardedPeerUnavailableError(error)) {
+                    logger.error(`[build_captureScreenshot] Error capturing screenshot: ${errorMeta.error.message}`, errorMeta);
+                }
+                throw error;
+            }
+        },
+        getActionName: () => ({
+            future: "capture a screenshot of the running app",
+            present: "capturing a screenshot of the running app",
+            past: "captured a screenshot of the running app",
+        }),
+        toModelOutput: ({ output }) => screenshotToModelOutput(output, "build_captureScreenshot"),
+        getSummary: () => {
+            return { output: "Screenshot captured" };
+        },
+    };
+});
+export const BUILD_CAPTURE_SCREENSHOT_TOOL_NAME = buildCaptureScreenshotToolFactory.name;
+function createScreenshotAttemptTelemetry({ hasSelector, logger, peer, }) {
+    const startedAt = Date.now();
+    let rpcStartedAt;
+    let rpcDurationMs;
+    let uploadStartedAt;
+    let uploadDurationMs;
+    let uploadFallbackReason;
+    let usedUploadFallback = false;
+    const peerConnectedAtStart = isPeerConnected(peer);
+    const connectionGenerationAtStart = getConnectionGeneration(peer);
+    let peerConnectedBeforeRpc;
+    let connectionGenerationBeforeRpc;
+    let finished = false;
+    const telemetry = {
+        finish(outcome, stage = telemetry.stage) {
+            if (finished)
+                return;
+            finished = true;
+            logger.info("[build_captureScreenshot] attempt finished", {
+                connectionGenerationAtStart,
+                connectionGenerationBeforeRpc,
+                durationMs: Date.now() - startedAt,
+                event: "build_capture_screenshot_attempt",
+                hasSelector,
+                outcome,
+                peerConnectedAtStart,
+                peerConnectedBeforeRpc,
+                rpcDurationMs,
+                stage,
+                uploadFallbackReason,
+                uploadDurationMs,
+                usedUploadFallback,
+            });
+        },
+        get finished() {
+            return finished;
+        },
+        markBeforeRpc(currentPeer) {
+            rpcStartedAt = Date.now();
+            peerConnectedBeforeRpc = isPeerConnected(currentPeer);
+            connectionGenerationBeforeRpc = getConnectionGeneration(currentPeer);
+        },
+        markRpcComplete() {
+            if (rpcStartedAt !== undefined) {
+                rpcDurationMs = Date.now() - rpcStartedAt;
+            }
+        },
+        markUploadFallback(reason) {
+            uploadFallbackReason = reason;
+            usedUploadFallback = true;
+        },
+        markUploadComplete() {
+            if (uploadStartedAt !== undefined) {
+                uploadDurationMs = Date.now() - uploadStartedAt;
+            }
+        },
+        markUploadStart() {
+            uploadStartedAt = Date.now();
+        },
+        stage: "selector_validation",
+        get usedUploadFallback() {
+            return usedUploadFallback;
+        },
+    };
+    return telemetry;
+}
+function isPeerConnected(peer) {
+    if (!peer || typeof peer !== "object")
+        return false;
+    const connected = peer.isConnected;
+    return typeof connected === "boolean" ? connected : true;
+}
+function getConnectionGeneration(peer) {
+    if (!peer || typeof peer !== "object")
+        return undefined;
+    const generation = peer
+        .connectionGeneration;
+    return typeof generation === "number" ? generation : undefined;
+}
+function classifyScreenshotFailure(error) {
+    if (isGuardedPeerUnavailableError(error))
+        return "peer_disconnected";
+    if (error instanceof RpcTimeoutError)
+        return "rpc_timeout";
+    if (isTransportCloseError(error))
+        return "transport_close";
+    const message = error instanceof Error ? error.message : String(error ?? "unknown");
+    if (message.startsWith("APP_NOT_READY:"))
+        return "app_not_ready";
+    if (message === APP_ROUTE_NOT_FOUND_MESSAGE)
+        return "route_not_found";
+    if (message.includes("Screenshot capture timeout")) {
+        return "iframe_capture_timeout";
+    }
+    if (message.includes("Selector "))
+        return "selector_error";
+    if (message.includes("null/undefined response"))
+        return "empty_response";
+    if (message.includes("invalid data URL"))
+        return "invalid_response";
+    return "unknown_error";
+}
+/**
+ * Message returned when the app preview has not rendered yet but there is no
+ * build/runtime error to point at — i.e. it's a transient state (still
+ * building/migrating) and the agent should simply wait and retry.
+ */
+export const APP_NOT_READY_TRANSIENT_MESSAGE = "APP_NOT_READY: The app preview has not rendered yet (it may still be building or migrating). No screenshot was taken — this is NOT a visual verification result and does NOT mean the UI is correct. Do not mark visual verification (or the task) as done. Wait a few seconds for the preview to finish rendering, then capture again. If you mention this to the user, just say the preview is still loading and you'll retry — do not paste this raw message.";
+// Keep in sync with APP_ROUTE_NOT_FOUND_MESSAGE in
+// packages/ui/src/app/store/slices/clarkAi/agent-screenshot.ts.
+export const APP_ROUTE_NOT_FOUND_MESSAGE = "APP_ROUTE_NOT_FOUND: The current preview route rendered the Superblocks 404 page (`Page not found` / `Content not found`). No screenshot was taken because this is a route verification failure, not a successful visual result. Fix the route registration/router entry and run debug checks before marking the page task complete.";
+export function isExpectedScreenshotVerificationError(message) {
+    return (message.startsWith("APP_NOT_READY:") ||
+        message === APP_ROUTE_NOT_FOUND_MESSAGE);
+}
+/**
+ * Builds the APP_NOT_READY message for a not-rendered preview.
+ *
+ * If the app has build/runtime errors, those are almost always WHY it isn't
+ * rendering (e.g. a bad import that crashes the app shell before it mounts), so
+ * we surface them and tell the agent to fix the cause rather than just wait. If
+ * there are no errors, the non-render is transient and we return the plain
+ * wait/retry message.
+ */
+export function buildAppNotReadyMessage(errors) {
+    const buildMessages = (errors.buildSystemErrors ?? [])
+        .map((e) => String(e.message ?? "").trim())
+        .filter(Boolean);
+    const runtimeMessages = (errors.runtimeErrors ?? [])
+        .map((e) => String(e.error ?? e.message ?? "")
+        .split("\n")[0]
+        .trim())
+        .filter(Boolean);
+    const unique = Array.from(new Set([...buildMessages, ...runtimeMessages])).slice(0, 8);
+    if (unique.length === 0) {
+        return APP_NOT_READY_TRANSIENT_MESSAGE;
+    }
+    const list = unique.map((m) => `- ${m}`).join("\n");
+    return ("APP_NOT_READY: The app preview has not rendered yet, and these build/runtime errors are likely blocking it:\n" +
+        `${list}\n` +
+        "This is NOT a visual verification result. Fix these errors (use build_debug / get_runtime_errors for detail), then capture again. Do not mark visual verification (or the task) as done. When telling the user, summarize in plain language — name the blocking error and how you'll fix it; do not paste this raw output.");
+}
+/**
+ * Validates a screenshot capture response and throws if invalid.
+ * @param response The response from the screenshot RPC call
+ * @param toolName Tool name prefix for logging (e.g., "build_captureScreenshot")
+ * @returns The validated response with dataUrl
+ * @throws Error if response is invalid
+ */
+export function validateScreenshotResponse(response, toolName) {
+    const logger = getPrefixedLogger(`[${toolName}]`);
+    if (!response) {
+        const error = "Screenshot capture returned null/undefined response";
+        logger.error(error);
+        throw new Error(error);
+    }
+    // The preview had not rendered yet, so no screenshot was taken. Surface the
+    // explicit not-ready message verbatim (no "capture failed" prefix) so the
+    // agent treats it as "wait and retry", not as a visual verdict or a failure.
+    if (response.notReady) {
+        // Keep this fallback identical in substance to APP_NOT_READY_MESSAGE
+        // (agent-screenshot.ts) so the agent gets the full guidance even if the
+        // editor ever omits `error`. info-level: this is an expected transient
+        // state during migration, not an actionable warning.
+        const error = response.error || APP_NOT_READY_TRANSIENT_MESSAGE;
+        logger.info(error);
+        throw new Error(error);
+    }
+    if (response.routeNotFound) {
+        const error = response.error || APP_ROUTE_NOT_FOUND_MESSAGE;
+        logger.warn(error);
+        throw new Error(error);
+    }
+    if (response.error) {
+        const error = `Screenshot capture failed: ${response.error}`;
+        logger.error(error);
+        throw new Error(error);
+    }
+    if (!response.dataUrl ||
+        typeof response.dataUrl !== "string" ||
+        response.dataUrl.trim() === "" ||
+        !response.dataUrl.startsWith("data:image/")) {
+        const error = "Screenshot capture returned no data URL or invalid data URL";
+        logger.error(`${error}. Response: ${safeJsonStringify(response)}`);
+        throw new Error(error);
+    }
+    return { dataUrl: response.dataUrl };
+}
+function isScreenshotModelOutput(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const output = value;
+    if (output.type === "text" || output.type === "error-text") {
+        return typeof output.value === "string";
+    }
+    if (output.type !== "content" || !Array.isArray(output.value)) {
+        return false;
+    }
+    return output.value.every((part) => !!part &&
+        typeof part === "object" &&
+        part.type === "image-data" &&
+        typeof part.data === "string" &&
+        typeof part.mediaType === "string");
+}
+function screenshotToModelOutput(output, toolName) {
+    const logger = getPrefixedLogger(`[${toolName}]`);
+    if (!output || typeof output !== "object") {
+        logger.debug(`output is missing or invalid. Output: ${safeJsonStringify(output)}`);
+        return {
+            type: "text",
+            value: "Screenshot captured but output is missing or invalid",
+        };
+    }
+    if (isScreenshotModelOutput(output) && output.type === "error-text") {
+        return output;
+    }
+    if ("dataUrl" in output && output.dataUrl !== undefined) {
+        const dataUrl = output.dataUrl;
+        if (typeof dataUrl !== "string") {
+            logger.debug(`dataUrl is missing or invalid. Output: ${safeJsonStringify(output)}`);
+            return {
+                type: "text",
+                value: "Screenshot captured but data URL is missing or invalid",
+            };
+        }
+        const parts = dataUrl.split(",");
+        if (parts.length < 2) {
+            logger.debug(`data URL format is unexpected. dataUrl length: ${dataUrl.length}`);
+            return {
+                type: "text",
+                value: "Screenshot captured (data URL format error)",
+            };
+        }
+        const [header, base64Data] = parts;
+        if (!base64Data) {
+            logger.debug(`base64 data is missing after split. Header: ${header}`);
+            return {
+                type: "text",
+                value: "Screenshot captured (base64 data missing)",
+            };
+        }
+        const mediaTypeMatch = header?.match(/data:([^;]+)/);
+        const mediaType = mediaTypeMatch?.[1] || "image/png";
+        logger.debug(`Successfully converted to content type with media (type: ${mediaType}, data length: ${base64Data.length})`);
+        return {
+            type: "content",
+            value: [
+                {
+                    type: "image-data",
+                    data: base64Data,
+                    mediaType: mediaType,
+                },
+            ],
+        };
+    }
+    if ("type" in output &&
+        (output.type === "content" || output.type === "text")) {
+        return output;
+    }
+    logger.debug(`output.type is missing or invalid. Output: ${safeJsonStringify(output)}`);
+    return {
+        type: "text",
+        value: "Output is missing or invalid",
+    };
+}
+//# sourceMappingURL=build-capture-screenshot.js.map

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

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

package/dist/ai-service/agent/tools/build-copy-directory.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 buildCopyDirectoryToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: Pick<ClarkStateHandlerParams, "appShell">;
+}, import("../tools2/types.js").Tool<{
+    destinationDir: string;
+    sourceDir: string;
+    conflictStrategy?: "replace" | "fail" | "skip" | undefined;
+    verbose?: boolean | undefined;
+}, import("../../app-interface/shell.js").CopyToolResult>>;
+//# sourceMappingURL=build-copy-directory.d.ts.map

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

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

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

@@ -0,0 +1,51 @@
+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 buildCopyDirectoryToolFactory = createToolFactory("build_copyDirectory", ({ clark, services, }) => {
+    return {
+        category: ToolCategory.FILE,
+        description: `
+      Copy a directory in the application.
+
+      Use this tool when a source directory should be preserved under a new destination.
+      Prefer this tool over reading files and recreating them with build_writeFile whenever you are moving or copying existing content, including uploaded, generated, or staged directories.
+      If copied files need small follow-up changes, copy the directory first with this tool, then edit the copied destinations.
+
+      Usage requirements:
+      - Always use relative directory paths from the project root.
+      - sourceDir must be the exact existing directory from list/glob/downloadAttachments results; do not infer or shorten uploaded attachment paths from the directory name alone.
+      - 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,
+            destinationDir: z.string().describe("Destination relative directory"),
+            sourceDir: z
+                .string()
+                .describe("Source relative directory 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.copyDirectory(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.sourceDir} -> ${input.destinationDir}`,
+            output: formatCopyCounts(output),
+        }),
+    };
+});
+//# sourceMappingURL=build-copy-directory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-copy-directory.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-copy-directory.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,6BAA6B,GAAG,iBAAiB,CAC5D,qBAAqB,EACrB,CAAC,EACC,KAAK,EACL,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,IAAI;QAC3B,WAAW,EAAE;;;;;;;;;;;;KAYd;QACC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,gBAAgB,EAAE,0BAA0B;YAC5C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;YACrE,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,CAAC,wCAAwC,CAAC;YACrD,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,aAAa,CAAC,KAAK,CAAC,CAAC;YAE5D,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,SAAS,OAAO,KAAK,CAAC,cAAc,EAAE;YACtD,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC;SACjC,CAAC;KACH,CAAC;AACJ,CAAC,CACF,CAAC"}