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

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

@@ -0,0 +1,234 @@
+import z from "zod";
+import { clearChecklistItemsMarkedForFinalize, readPersistedChecklist, } from "../../checklist/persisted-checklist-store.js";
+import { sendUserMessageChannel } from "../../state-machine/helpers/peer.js";
+import { createToolFactory, ToolCategory, ToolExecutionError, } from "../tools2/types.js";
+import { checkChecklistCompletion, } from "./build-manage-checklist.js";
+import { debugCache } from "./debug-cache.js";
+export const buildFinalizeToolFactory = createToolFactory("build_finalize", ({ clark, services, }) => {
+    const sendUserMessage = sendUserMessageChannel(clark, services.chatSessionStore);
+    return {
+        category: ToolCategory.GENERAL,
+        description: `
+      Finalize the build and complete the generation.
+      You must call build_debug at least once before this will succeed.
+    `,
+        inputSchema: z.object({
+            summary: z
+                .string()
+                .describe("A no longer than 80 words summary of the build to be returned to the reader. Make sure it is correctly formatted so it can be rendered by streamdown in the ui."),
+            adviceToAgents: z
+                .string()
+                .optional()
+                .describe("Advice for other agents to be used in subsequent LLM calls"),
+            relevantFilePaths: z.array(z.string()).optional(),
+            goals: z.array(z.string()).optional().describe("The user's goals"),
+            decisions: z
+                .array(z.string())
+                .optional()
+                .describe("The agent's decisions"),
+        }),
+        outputSchema: BuildFinalizeSuccessSchema,
+        execute: async ({ summary, relevantFilePaths, goals, decisions, adviceToAgents, }) => {
+            const activeChecklist = await readPersistedChecklist(services.appRootDirPath);
+            // Check for failed API builds - must be fixed before finalizing
+            if (clark.context.failedApiBuilds?.size) {
+                const failedApisList = Array.from(clark.context.failedApiBuilds)
+                    .map((api) => `- ${api}`)
+                    .join("\n");
+                throw new BuildFinalizeError({
+                    status: "failed_api_builds",
+                    message: `Cannot finalize: ${clark.context.failedApiBuilds.size} API build(s) failed and have not been successfully rebuilt:\n\n${failedApisList}\n\nThese changes exist only in scratch files and will NOT be saved.`,
+                    instruction: "Fix the build errors and call buildApi successfully for each failed API, then call build_finalize again",
+                });
+            }
+            // Require testApi for every SDK API before finalizing (same policy as build_debug warnings)
+            const untestedForFinalize = clark.context.apiTestingState?.untested;
+            if (untestedForFinalize?.size) {
+                const skipEligibleApis = new Set((activeChecklist?.items ?? [])
+                    .filter((item) => {
+                    if (item.status !== "completed")
+                        return false;
+                    if (item.verificationSkippedReason !== "mutation" &&
+                        item.verificationSkippedReason !== "testing_denied") {
+                        return false;
+                    }
+                    return (typeof item.id === "string" && item.id.startsWith("api_"));
+                })
+                    .map((item) => item.id.slice("api_".length)));
+                const stillUntested = Array.from(untestedForFinalize).filter((apiName) => !skipEligibleApis.has(apiName));
+                if (stillUntested.length > 0) {
+                    const untestedList = stillUntested
+                        .map((api) => `- ${api}`)
+                        .join("\n");
+                    throw new BuildFinalizeError({
+                        status: "apis_untested",
+                        message: `Cannot finalize: ${stillUntested.length} API(s) have not been tested yet:\n\n${untestedList}`,
+                        instruction: "Call testApi for each untested API, then run build_debug again before build_finalize",
+                    });
+                }
+            }
+            // Check if checklist is complete
+            const checklistStatus = await checkChecklistCompletion(services.appRootDirPath);
+            if (!checklistStatus.complete) {
+                const pendingTasksList = checklistStatus.pendingTasks
+                    .map((task) => `- [${task.id}] ${task.content}`)
+                    .join("\n");
+                throw new BuildFinalizeError({
+                    status: "checklist_incomplete",
+                    message: `You have incomplete tasks in your checklist. Please complete all tasks before finalizing (item IDs shown in brackets):\n\n${pendingTasksList}`,
+                    instruction: "Update each listed item by its ID using build_manageChecklist, then call build_finalize again. If a checklist is too long to read in full, use build_manageChecklist get with offset/limit to page through it.",
+                    pendingTasks: checklistStatus.pendingTasks,
+                });
+            }
+            const hasDiff = await services.draftInterface.hasLocalDraftChanges();
+            if (!clark.context.debugToolCalled && hasDiff) {
+                throw new BuildFinalizeError({
+                    status: "debug_required",
+                    message: "You must call build_debug at least once before finalizing to ensure there are no lint or type errors",
+                    instruction: "Please call build_debug first, fix any errors found, then call build_finalize again",
+                });
+            }
+            // Optional: Check if debug was called recently (within reasonable time)
+            const debugAge = Date.now() - (clark.context.lastDebugTimestamp || 0);
+            const maxDebugAge = 5 * 60 * 1000; // 5 minutes
+            if (debugAge > maxDebugAge) {
+                throw new BuildFinalizeError({
+                    status: "debug_stale",
+                    message: "The last debug check was performed too long ago. Please run build_debug again to ensure current code is error-free",
+                    instruction: "Please call build_debug again, then call build_finalize",
+                });
+            }
+            // Check if the last debug run had type errors
+            if (clark.context.lastDebugHadTypeErrors) {
+                throw new BuildFinalizeError({
+                    status: "type_errors_unresolved",
+                    message: "The last debug check found TypeScript errors that have not been fixed. Please fix the type errors and run build_debug again.",
+                    instruction: "Fix the TypeScript errors reported by build_debug, then run build_debug again to verify they are resolved before calling build_finalize",
+                });
+            }
+            // Check for unresolved disappearing errors against CURRENT errors
+            const errorTracker = debugCache.getErrorHistoryTracker();
+            const getTopFrame = (stack) => {
+                if (!stack)
+                    return "";
+                const text = String(stack);
+                const firstLine = text.split("\n").find((l) => l.trim().length > 0);
+                return firstLine ? firstLine.trim() : "";
+            };
+            const getFingerprintKey = (e) => {
+                const componentType = e?.identifier?.type || "";
+                const instanceId = e?.identifier?.instanceId;
+                const sourceId = e?.identifier?.sourceId;
+                const sourceIdStr = sourceId ? String(JSON.stringify(sourceId)) : "";
+                const errorString = String(e?.error ?? "");
+                const errorMessage = errorString.split("\n")[0] || errorString;
+                const topFrame = getTopFrame(e?.errorInfo?.componentStack);
+                const fingerprintParts = [
+                    errorMessage.trim(),
+                    componentType,
+                    instanceId ?? sourceIdStr,
+                    topFrame,
+                ].filter(Boolean);
+                const fallback = `${errorMessage}::${componentType}`;
+                const joined = fingerprintParts.join("::");
+                const key = joined || fallback;
+                return key;
+            };
+            const currentErrorKeys = new Set();
+            for (const e of (clark.context.runtimeErrors ?? [])) {
+                currentErrorKeys.add(getFingerprintKey(e));
+            }
+            const disappeared = errorTracker.getUnresolvedDisappearances(currentErrorKeys);
+            if (disappeared.length > 0) {
+                const errorList = disappeared
+                    .map((h) => `- ${h.errorKey}`)
+                    .join("\n");
+                throw new BuildFinalizeError({
+                    status: "unresolved_errors",
+                    message: `Runtime errors were detected earlier but have disappeared without clear fixes:\n\n${errorList}\n\nThese may resurface under different conditions.`,
+                    instruction: "Please review code that accesses API data and add defensive patterns (optional chaining, fallback values), then run build_debug again to confirm all errors are resolved.",
+                });
+            }
+            // Proceed with normal finalization
+            await sendUserMessage({
+                role: "assistant",
+                type: "text",
+                content: summary,
+            });
+            await services.chatSessionStore.recordSummary({
+                summary,
+                relevantFilePaths: relevantFilePaths || [],
+                goals: goals || [],
+                decisions: decisions || [],
+                adviceToAgents: adviceToAgents || "",
+            });
+            if ((activeChecklist?.items.length ?? 0) > 0) {
+                const cleanupResult = await clearChecklistItemsMarkedForFinalize(services.appRootDirPath);
+                if (cleanupResult.removedCount > 0 &&
+                    cleanupResult.remainingCount === 0) {
+                    // Notify UI that checklist should be cleared only when no items remain.
+                    await services.appShell.sendMessage({
+                        type: "checklist_cleared",
+                        payload: {},
+                    });
+                }
+            }
+            // Clear build system errors and failed API tracking since finalization succeeded
+            clark.updateContext((context) => ({
+                ...context,
+                buildSystemErrors: [],
+                failedApiBuilds: new Set(),
+                apiTestingState: context.apiTestingState
+                    ? {
+                        untested: new Set(),
+                        failed: new Set(),
+                        passed: context.apiTestingState.passed,
+                        denied: new Set(),
+                    }
+                    : undefined,
+                // APPS-3771: preserve registry cache so the next build can diff
+                // against it instead of treating every API as newly added.
+                sdkApiRegistryEntryPoints: context.sdkApiRegistryEntryPoints,
+            }));
+            // Invalidate context errors cache since build system errors changed
+            debugCache.invalidateContextErrors();
+            return {
+                status: "success",
+                summary,
+                relevantFilePaths,
+                goals,
+                decisions,
+            };
+        },
+        toModelOutput: ({ output }) => {
+            return { type: "text", value: output.summary };
+        },
+        getSummary: (_input, output) => {
+            return { output: output.status === "success" ? "Completed" : "Failed" };
+        },
+    };
+});
+const BuildFinalizeSuccessSchema = z.object({
+    status: z.literal("success"),
+    summary: z.string(),
+    relevantFilePaths: z.array(z.string()).optional(),
+    goals: z.array(z.string()).optional(),
+    decisions: z.array(z.string()).optional(),
+});
+class BuildFinalizeError extends ToolExecutionError {
+    status;
+    instruction;
+    pendingTasks;
+    constructor(options) {
+        super(options.message, {
+            toolName: "build_finalize",
+            input: {},
+            context: {},
+            severity: "warn",
+        });
+        this.status = options.status;
+        this.instruction = options.instruction;
+        this.pendingTasks = options.pendingTasks;
+    }
+}
+//# sourceMappingURL=build-finalize.js.map

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

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

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

@@ -0,0 +1,89 @@
+import type { TriageVerdict } from "@superblocksteam/shared";
+import type { Clark } from "../../state-machine/clark-fsm.js";
+import type { ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+import type { NpmInstallBlocked as NpmInstallBlockedType, NpmInstallBlockedMessageVariant } from "../../types.js";
+interface VersionChangeInfo {
+    name: string;
+    oldVersion: string;
+    newVersion: string;
+    isDev: boolean;
+}
+type InstallPackagesToolResult = {
+    error?: ReturnType<NpmInstallBlockedType["toJSON"]>;
+    message: string;
+    ok?: false;
+    output?: string;
+    triageVerdicts?: TriageVerdict[];
+    /** Bare package names from this install that appear in the triggering user message. */
+    userRequested?: string[];
+    versionChanges?: VersionChangeInfo[];
+};
+/**
+ * True when `packageName` appears as a literal token in `message`.
+ * Scoped names (`@scope/name`) and unscoped names are matched with npm-name
+ * boundaries so `react` does not match `preact` / `reactive`.
+ *
+ * The trailing boundary allows `@` (builders write `left-pad@1.3.0`) and a
+ * sentence-ending `.`, but not a `.` that continues the token (`left-pad.js`).
+ */
+export declare function isPackageNamedInMessage(packageName: string, message: string): boolean;
+export declare function findUserRequestedPackageNames(packages: Array<{
+    name: string;
+}>, message: string): string[];
+/**
+ * Names from `packages` the builder asked for by name: either matched in the
+ * current turn's message, or carried over from an earlier turn's CVE block.
+ * The carry-over matters because the builder answers "do you still want it?"
+ * with a bare reason ("we need it for the demo") that never repeats the name.
+ */
+export declare function resolveUserRequestedPackageNames(packages: Array<{
+    name: string;
+}>, message: string, pendingCveProceedPackages: string[]): string[];
+/**
+ * Render a `NpmInstallBlocked` into an actionable one-paragraph message for
+ * the agent, plus the discriminator that selected the message branch. The
+ * structured `error` field carries the canonical inputs; this string is what
+ * the model reads first.
+ *
+ * Branch selection (see `NpmInstallBlockedMessageVariant`):
+ *
+ *   - `unreachable_escalation` — `registry_unreachable` + zero configured
+ *     rows + host is npmjs (or unknown). Covers both the SaaS "npmjs is down"
+ *     case and the airgapped "egress is blocked and no private registry is
+ *     wired up" case with one hybrid message, because the dev-server cannot
+ *     distinguish them from the error alone.
+ *   - `private_mirror_hint` — `not_in_registry` + at least one configured
+ *     row + host is private. Appends "an org admin may need to mirror this
+ *     package" because that's an actionable escalation on a private
+ *     registry; same hint on npmjs would be misleading.
+ *   - `malware_block` — `vulnerable_package` + malware finding. Hard-block;
+ *     agent must pick a different package (no retry / no override).
+ *   - `index_unavailable` — security index / dry-run probe could not vouch
+ *     for the install. Fail-closed; retry later. Not a malware verdict.
+ *   - `cve_block` / `cve_no_safe_version` — CVE findings listed per package
+ *     (suggested pin vs no safe version). Variant is `cve_block` when any
+ *     finding carries a suggested pin; otherwise `cve_no_safe_version`.
+ *   - `default` — every other combination, including all
+ *     `registry_auth_failed` failures.
+ *
+ * Exported so the matrix can be unit-tested directly without round-tripping
+ * through the AppShell + npm exec mock.
+ */
+export declare function buildBlockedMessage(err: NpmInstallBlockedType): {
+    message: string;
+    variant: NpmInstallBlockedMessageVariant;
+};
+export declare const buildInstallPackagesToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: ClarkStateHandlerParams;
+}, import("../tools2/types.js").Tool<{
+    packages?: {
+        name: string;
+        version?: string | undefined;
+        dev?: boolean | undefined;
+    }[] | undefined;
+    remove?: string[] | undefined;
+    proceedWithReason?: string | undefined;
+}, InstallPackagesToolResult>>;
+export {};
+//# sourceMappingURL=build-install-packages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-install-packages.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-install-packages.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQ7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAEhF,OAAO,KAAK,EACV,iBAAiB,IAAI,qBAAqB,EAE1C,+BAA+B,EAChC,MAAM,gBAAgB,CAAC;AAQxB,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,KAAK,yBAAyB,GAAG;IAC/B,KAAK,CAAC,EAAE,UAAU,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACtC,CAAC;AAiCF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAOT;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACjC,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CAWV;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,yBAAyB,EAAE,MAAM,EAAE,GAClC,MAAM,EAAE,CAOV;AAgHD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,qBAAqB,GAAG;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,+BAA+B,CAAC;CAC1C,CA2GA;AAsHD,eAAO,MAAM,+BAA+B;WAMjC,KAAK;cACF,uBAAuB;;;;;;;;;8BAyapC,CAAC"}