@agent-native/core 0.127.3 → 0.128.1

package/dist/server/builder-design-systems.d.ts

@@ -1,3 +1,4 @@
+import type { DesignSystemSourceInput } from "@builder.io/ai-utils";
 export interface BuilderDesignSystemIndexFile {
     name: string;
     data: Uint8Array;
@@ -93,14 +94,62 @@ export interface BuilderDesignSystemIndexResult {
     builderUrl: string;
     status: "in-progress";
 }
+export interface BuilderDesignSystemUploadAttachment {
+    name: string;
+    mimetype: string;
+    declaredSize: number;
+}
+export interface BuilderDesignSystemUploadSlot {
+    idx: number;
+    uploadUrl: string;
+    uploadToken: string;
+}
+export interface BuilderDesignSystemIndexFromSourcesOptions {
+    sources: DesignSystemSourceInput[];
+    projectName?: string;
+    devToolsVersion?: string;
+}
+export interface BuilderDesignSystemDecodeJobStatus {
+    jobId: string;
+    status: "pending" | "processing" | "complete" | "error";
+    framesProcessed: number;
+    totalFrames: number;
+    branchName: string | null;
+    branchUrl: string | null;
+    error: string | null;
+    partialFailure?: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+export declare function fetchBuilderDesignSystemDecodeJobStatus(jobId: string): Promise<BuilderDesignSystemDecodeJobStatus>;
 export declare function getBuilderDesignSystemsBaseUrl(): string;
 export declare function mimeTypeForBuilderDesignSystemFilename(filename: string, explicit?: string): string;
 export declare function buildBuilderDesignSystemIndexFiles({ codeFiles, designMd, designMdFilename, maxCodeFiles, maxTotalCodeBytes, overflowBehavior, }: BuildBuilderDesignSystemIndexFilesOptions): BuilderDesignSystemIndexFile[];
 export declare function builderDesignSystemUrl(designSystemId?: string | null): string;
+export declare function builderProjectBranchUrl(projectId?: string | null, branchName?: string | null): string | undefined;
 export declare function localBuilderDesignSystemId(builderDesignSystemId: string): string;
 export declare function createBuilderDesignSystemProxyFields({ result, projectName, description, surface, }: BuilderDesignSystemProxyFieldsOptions): BuilderDesignSystemProxyFields;
 export declare function parseBuilderDesignSystemProxyReference(data: unknown): BuilderDesignSystemProxyReference | null;
 export declare function fetchBuilderDesignSystemDocs(designSystemId: string, options?: BuilderDesignSystemDocsOptions): Promise<BuilderDesignSystemDocument[]>;
 export declare function hydrateBuilderDesignSystemReference(reference: BuilderDesignSystemProxyReference, options?: BuilderDesignSystemDocsOptions): Promise<BuilderDesignSystemHydratedReference>;
+/**
+ * Opens signed resumable-upload slots for `.fig`/code/design attachments so
+ * the browser can stream each file's bytes straight to GCS. Large `.fig`
+ * files must not ride through the app server as one request body -- the
+ * serverless host caps request bodies well below Figma export sizes.
+ */
+export declare function startBuilderDesignSystemUpload(attachments: BuilderDesignSystemUploadAttachment[]): Promise<BuilderDesignSystemUploadSlot[]>;
+/**
+ * Finalizes indexing from already-resolved sources (uploaded file tokens,
+ * public repos, connected projects). Callers that stream uploads from the
+ * browser pass the returned `uploadToken`s as `file` sources here.
+ */
+export declare function indexBuilderDesignSystem(options: BuilderDesignSystemIndexFromSourcesOptions): Promise<BuilderDesignSystemIndexResult>;
+/**
+ * Server-side indexing for in-memory files (the agent action's small inline
+ * payloads). Uploads each file server->GCS in resumable chunks, then
+ * finalizes. Browser callers should instead stream via
+ * `startBuilderDesignSystemUpload` + `indexBuilderDesignSystem`.
+ */
 export declare function startBuilderDesignSystemIndex(options: BuilderDesignSystemIndexOptions): Promise<BuilderDesignSystemIndexResult>;
 //# sourceMappingURL=builder-design-systems.d.ts.map

package/dist/server/builder-design-systems.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder-design-systems.d.ts","sourceRoot":"","sources":["../../src/server/builder-design-systems.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builder-design-systems.d.ts","sourceRoot":"","sources":["../../src/server/builder-design-systems.ts"],"names":[],"mappings":"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"}

package/dist/server/builder-design-systems.js

@@ -2,9 +2,24 @@ import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js
 import { FeatureNotConfiguredError } from "./credential-provider.js";
 import { getBuilderProxyOrigin, resolveBuilderCredentials, } from "./credential-provider.js";
 const DEFAULT_TIMEOUT_MS = 120_000;
+// GCS resumable uploads require every chunk except the last to be a multiple
+// of 256 KiB. 16 MiB is the recommended default and keeps very large `.fig`
+// files off a single unbounded request body.
+const GCS_CHUNK_SIZE = 16 * 1024 * 1024;
+const MAX_CHUNK_RETRIES = 5;
 const DEFAULT_MAX_CODE_FILES = 50;
 const DEFAULT_MAX_TOTAL_CODE_BYTES = 2 * 1024 * 1024;
 const MAX_DOC_CONTENT_CHARS = 4_000;
+export async function fetchBuilderDesignSystemDecodeJobStatus(jobId) {
+    const credentials = await resolveBuilderDesignSystemCredentials();
+    const url = makeBuilderDesignSystemUrl("decode-jobs/" + encodeURIComponent(jobId), credentials);
+    const response = await fetchWithTimeout(url, {
+        method: "GET",
+        headers: makeBuilderHeaders(credentials),
+    });
+    await assertOk(response, "Builder design-system decode-job status failed");
+    return (await response.json());
+}
 function trimTrailingSlash(value) {
     return value.replace(/\/+$/, "");
 }
@@ -145,14 +160,35 @@ async function assertOk(response, label) {
         return;
     throw new Error(`${label} (${response.status}): ${await parseErrorBody(response)}`);
 }
+// GCS reports the highest committed byte in a `Range: bytes=0-<end>` header.
+function committedOffsetFromRange(response) {
+    const match = response.headers.get("Range")?.match(/bytes=0-(\d+)/);
+    return match ? parseInt(match[1], 10) + 1 : null;
+}
+async function queryCommittedOffset(sessionUrl, total) {
+    const response = await fetchWithTimeout(sessionUrl, {
+        method: "PUT",
+        headers: { "Content-Range": `bytes */${total}` },
+    });
+    if (response.status === 200 || response.status === 201)
+        return total;
+    if (response.status === 308) {
+        return committedOffsetFromRange(response) ?? 0;
+    }
+    throw new Error(`Builder design-system upload status query failed (${response.status}).`);
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 async function uploadToResumableUrl(slot, file) {
     const mimeType = mimeTypeForFile(file);
     const bytes = file.data;
+    const total = bytes.byteLength;
     const start = await fetchWithTimeout(slot.uploadUrl, {
         method: "POST",
         headers: {
             "x-goog-resumable": "start",
-            "x-goog-content-length-range": `0,${bytes.byteLength}`,
+            "x-goog-content-length-range": `0,${total}`,
             "Content-Type": mimeType,
         },
     });
@@ -161,15 +197,60 @@ async function uploadToResumableUrl(slot, file) {
     if (!sessionUrl) {
         throw new Error("Builder design-system upload session returned no URL.");
     }
-    const response = await fetchWithTimeout(sessionUrl, {
-        method: "PUT",
-        headers: {
-            "Content-Range": `bytes 0-${bytes.byteLength - 1}/${bytes.byteLength}`,
-            "Content-Type": mimeType,
-        },
-        body: makeBody(bytes, mimeType),
-    });
-    await assertOk(response, "Builder design-system file upload failed");
+    if (total === 0) {
+        const response = await fetchWithTimeout(sessionUrl, {
+            method: "PUT",
+            headers: { "Content-Range": "bytes */0" },
+            body: makeBody(bytes, mimeType),
+        });
+        await assertOk(response, "Builder design-system file upload failed");
+        return;
+    }
+    // A failed PUT may have still landed at GCS, so the local offset can't be
+    // trusted after an error — only GCS's committed-offset response is
+    // authoritative.
+    let offset = 0;
+    let retries = 0;
+    while (offset < total) {
+        const end = Math.min(offset + GCS_CHUNK_SIZE, total);
+        const isLast = end === total;
+        try {
+            const response = await fetchWithTimeout(sessionUrl, {
+                method: "PUT",
+                headers: {
+                    "Content-Range": `bytes ${offset}-${end - 1}/${total}`,
+                    "Content-Type": mimeType,
+                },
+                body: makeBody(bytes.subarray(offset, end), mimeType),
+            });
+            if (response.status === 200 || response.status === 201) {
+                offset = total;
+            }
+            else if (!isLast && response.status === 308) {
+                const nextOffset = committedOffsetFromRange(response) ?? offset;
+                if (nextOffset <= offset) {
+                    throw new Error(`Builder design-system upload stalled at byte ${offset}.`);
+                }
+                offset = nextOffset;
+            }
+            else {
+                throw new Error(`Builder design-system file upload failed (${response.status}).`);
+            }
+            retries = 0;
+        }
+        catch (err) {
+            if (++retries > MAX_CHUNK_RETRIES)
+                throw err;
+            await delay(500 * retries);
+            try {
+                offset = await queryCommittedOffset(sessionUrl, total);
+            }
+            catch {
+                // If the offset query also fails, retry from the last local offset —
+                // GCS's resumable PUT safely re-acknowledges bytes it already has.
+            }
+        }
+    }
 }
 function nonEmptyFiles(files) {
     return (files ?? []).filter((file) => file.data.byteLength > 0);
@@ -184,6 +265,21 @@ export function builderDesignSystemUrl(designSystemId) {
         content: "design_system_intelligence",
     });
 }
+export function builderProjectBranchUrl(projectId, branchName) {
+    const project = projectId?.trim();
+    const branch = branchName?.trim();
+    if (!project || !branch)
+        return undefined;
+    const host = trimTrailingSlash(getBuilderAppHost());
+    const path = "/app/projects/" +
+        encodeURIComponent(project) +
+        "/" +
+        encodeURIComponent(branch);
+    return withBuilderUtmTrackingParams(host + path, {
+        campaign: "product",
+        content: "design_system_intelligence",
+    });
+}
 export function localBuilderDesignSystemId(builderDesignSystemId) {
     const slug = builderDesignSystemId
         .replace(/[^a-zA-Z0-9_-]+/g, "-")
@@ -351,89 +447,145 @@ export async function hydrateBuilderDesignSystemReference(reference, options = {
         docCount: docs.length,
     };
 }
-export async function startBuilderDesignSystemIndex(options) {
-    const files = nonEmptyFiles(options.files);
-    const description = options.description?.trim();
-    if (description) {
-        files.unshift({
-            name: "additional-context.txt",
-            data: new TextEncoder().encode(description),
-            mimeType: "text/plain",
-        });
+/**
+ * Opens signed resumable-upload slots for `.fig`/code/design attachments so
+ * the browser can stream each file's bytes straight to GCS. Large `.fig`
+ * files must not ride through the app server as one request body -- the
+ * serverless host caps request bodies well below Figma export sizes.
+ */
+export async function startBuilderDesignSystemUpload(attachments) {
+    if (attachments.length === 0)
+        return [];
+    const credentials = await resolveBuilderDesignSystemCredentials();
+    const uploadStart = await fetchWithTimeout(makeBuilderDesignSystemUrl("upload/start", credentials), {
+        method: "POST",
+        headers: {
+            ...makeBuilderHeaders(credentials),
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ attachments }),
+    });
+    await assertOk(uploadStart, "Builder design-system upload start failed");
+    const uploadJson = (await uploadStart.json());
+    const slots = [...(uploadJson.uploads ?? [])].sort((a, b) => a.idx - b.idx);
+    if (slots.length !== attachments.length) {
+        throw new Error("Builder did not return upload slots for all files.");
     }
-    if (files.length === 0 &&
-        !options.githubRepoUrl &&
-        !options.connectedProjectId) {
+    for (let i = 0; i < slots.length; i++) {
+        if (slots[i].idx !== i) {
+            throw new Error("Builder upload slot mismatch: expected " + i + ".");
+        }
+    }
+    return slots;
+}
+/**
+ * Finalizes indexing from already-resolved sources (uploaded file tokens,
+ * public repos, connected projects). Callers that stream uploads from the
+ * browser pass the returned `uploadToken`s as `file` sources here.
+ */
+export async function indexBuilderDesignSystem(options) {
+    if (options.sources.length === 0) {
         throw new Error("Provide at least one .fig/code/text file or a GitHub repository URL to index with Builder.");
     }
     const credentials = await resolveBuilderDesignSystemCredentials();
-    let uploadTokens = [];
-    if (files.length > 0) {
-        const uploadStart = await fetchWithTimeout(makeBuilderDesignSystemUrl("upload/start", credentials), {
-            method: "POST",
-            headers: {
-                ...makeBuilderHeaders(credentials),
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify({
-                attachments: files.map((file) => ({
-                    name: file.name,
-                    mimetype: mimeTypeForFile(file),
-                    declaredSize: file.data.byteLength,
-                })),
-            }),
-        });
-        await assertOk(uploadStart, "Builder design-system upload start failed");
-        const uploadJson = (await uploadStart.json());
-        const slots = [...(uploadJson.uploads ?? [])].sort((a, b) => a.idx - b.idx);
-        if (slots.length !== files.length) {
-            throw new Error("Builder did not return upload slots for all files.");
-        }
-        for (let i = 0; i < slots.length; i++) {
-            if (slots[i].idx !== i) {
-                throw new Error(`Builder upload slot mismatch: expected ${i}.`);
-            }
-            await uploadToResumableUrl(slots[i], files[i]);
-        }
-        uploadTokens = slots.map((slot) => slot.uploadToken);
-    }
-    const generate = await fetchWithTimeout(makeBuilderDesignSystemUrl("generate", credentials), {
+    const index = await fetchWithTimeout(makeBuilderDesignSystemUrl("index", credentials), {
         method: "POST",
         headers: {
             ...makeBuilderHeaders(credentials),
             "Content-Type": "application/json",
         },
         body: JSON.stringify({
-            uploads: uploadTokens,
+            sources: options.sources,
             ...(options.projectName?.trim()
-                ? { projectName: options.projectName.trim() }
+                ? { designSystemName: options.projectName.trim() }
                 : {}),
-            ...(options.githubRepoUrl?.trim()
-                ? { githubRepoUrl: options.githubRepoUrl.trim() }
-                : {}),
-            ...(options.connectedProjectId?.trim()
-                ? { connectedProjectId: options.connectedProjectId.trim() }
-                : {}),
-            ...(options.selection ? { selection: options.selection } : {}),
             ...(options.devToolsVersion?.trim()
                 ? { devToolsVersion: options.devToolsVersion.trim() }
                 : {}),
         }),
     });
-    await assertOk(generate, "Builder design-system indexing failed");
-    const generated = (await generate.json());
-    if (!generated.projectId || !generated.jobId || !generated.designSystemId) {
+    await assertOk(index, "Builder design-system indexing failed");
+    const indexed = (await index.json());
+    if (!indexed.designSystemId) {
         throw new Error("Builder design-system indexing returned an incomplete response.");
     }
+    const jobId = indexed.jobId ?? "";
+    // The `.fig` decode job creates the Fusion branch asynchronously, so
+    // `/index` usually can't return a branchUrl yet — the caller polls the
+    // decode-job status endpoint for it once the job completes.
+    const branchUrl = indexed.branchUrl?.trim() || null;
     return {
         ok: true,
         source: "builder",
-        projectId: generated.projectId,
-        jobId: generated.jobId,
-        designSystemId: generated.designSystemId,
+        projectId: indexed.projectId ?? "",
+        jobId,
+        designSystemId: indexed.designSystemId,
         suggestedTitle: options.projectName?.trim() || null,
-        builderUrl: builderDesignSystemUrl(generated.designSystemId),
+        builderUrl: branchUrl ||
+            builderProjectBranchUrl(indexed.projectId, indexed.branchName) ||
+            builderDesignSystemUrl(indexed.designSystemId),
         status: "in-progress",
     };
 }
+/**
+ * Server-side indexing for in-memory files (the agent action's small inline
+ * payloads). Uploads each file server->GCS in resumable chunks, then
+ * finalizes. Browser callers should instead stream via
+ * `startBuilderDesignSystemUpload` + `indexBuilderDesignSystem`.
+ */
+export async function startBuilderDesignSystemIndex(options) {
+    const files = nonEmptyFiles(options.files);
+    const description = options.description?.trim();
+    if (description) {
+        files.unshift({
+            name: "additional-context.txt",
+            data: new TextEncoder().encode(description),
+            mimeType: "text/plain",
+        });
+    }
+    if (files.length === 0 &&
+        !options.githubRepoUrl &&
+        !options.connectedProjectId) {
+        throw new Error("Provide at least one .fig/code/text file or a GitHub repository URL to index with Builder.");
+    }
+    const sources = [];
+    if (files.length > 0) {
+        const slots = await startBuilderDesignSystemUpload(files.map((file) => ({
+            name: file.name,
+            mimetype: mimeTypeForFile(file),
+            declaredSize: file.data.byteLength,
+        })));
+        for (let i = 0; i < slots.length; i++) {
+            await uploadToResumableUrl(slots[i], files[i]);
+        }
+        for (let i = 0; i < slots.length; i++) {
+            const name = files[i].name;
+            const fileSelection = options.selection?.[name];
+            sources.push({
+                kind: "file",
+                uploadToken: slots[i].uploadToken,
+                ...(fileSelection && fileSelection.length > 0
+                    ? { selection: { [name]: fileSelection } }
+                    : {}),
+            });
+        }
+    }
+    if (options.githubRepoUrl?.trim()) {
+        sources.push({
+            kind: "public-repo",
+            repoUrl: options.githubRepoUrl.trim(),
+        });
+    }
+    if (options.connectedProjectId?.trim()) {
+        sources.push({
+            kind: "connected-repo",
+            fusionProjectId: options.connectedProjectId.trim(),
+        });
+    }
+    return indexBuilderDesignSystem({
+        sources,
+        projectName: options.projectName,
+        devToolsVersion: options.devToolsVersion,
+    });
+}
 //# sourceMappingURL=builder-design-systems.js.map