@agent-native/core 0.128.0 → 0.128.2

package/dist/templates/chat/_gitignore

@@ -13,6 +13,8 @@ build/
 dist
 dist-ssr
 .output/
+.netlify/
+.deploy-tmp/
 *.local
 
 # Editor directories and files

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.128.0",
+  "version": "0.128.2",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -164,6 +164,7 @@
     "./application-state": "./dist/application-state/index.js",
     "./settings": "./dist/settings/index.js",
     "./user-profile": "./dist/user-profile/index.js",
+    "./user-profile/server": "./dist/user-profile/store.js",
     "./feature-flags": "./dist/feature-flags/index.js",
     "./feature-flags/registry": "./dist/feature-flags/registry.js",
     "./feature-flags/actions/get-feature-flags": "./dist/feature-flags/actions/get-feature-flags.js",
@@ -327,6 +328,7 @@
     "@assistant-ui/react-markdown": "^0.12.6",
     "@assistant-ui/store": ">=0.2.9 <0.2.14",
     "@assistant-ui/tap": "^0.5.14",
+    "@builder.io/ai-utils": "^0.84.0",
     "@clack/prompts": "^1.4.0",
     "@codemirror/lang-sql": "^6.10.0",
     "@codemirror/theme-one-dark": "^6.1.3",
@@ -388,8 +390,8 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31",
     "zod": "^4.3.6",
-    "@agent-native/recap-cli": "0.5.1",
-    "@agent-native/toolkit": "^0.10.9"
+    "@agent-native/toolkit": "^0.10.10",
+    "@agent-native/recap-cli": "0.5.1"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",

package/src/server/builder-design-systems.ts

@@ -1,3 +1,5 @@
+import type { DesignSystemSourceInput } from "@builder.io/ai-utils";
+
 import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
 import { FeatureNotConfiguredError } from "./credential-provider.js";
 import {
@@ -7,6 +9,12 @@ import {
 
 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;
+
 export interface BuilderDesignSystemIndexFile {
   name: string;
   data: Uint8Array;
@@ -123,16 +131,65 @@ interface UploadStartResponse {
   uploads?: Array<{ idx: number; uploadUrl: string; uploadToken: string }>;
 }
 
-interface GenerateResponse {
-  projectId?: string;
-  jobId?: string;
+interface IndexResponse {
   designSystemId?: string;
+  jobId?: string;
+  projectId?: string;
+  branchUrl?: string;
+  branchName?: string;
+}
+
+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;
 }
 
 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: string,
+): Promise<BuilderDesignSystemDecodeJobStatus> {
+  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()) as BuilderDesignSystemDecodeJobStatus;
+}
+
 function trimTrailingSlash(value: string): string {
   return value.replace(/\/+$/, "");
 }
@@ -318,17 +375,45 @@ async function assertOk(response: Response, label: string): Promise<void> {
   );
 }
 
+// GCS reports the highest committed byte in a `Range: bytes=0-<end>` header.
+function committedOffsetFromRange(response: Response): number | null {
+  const match = response.headers.get("Range")?.match(/bytes=0-(\d+)/);
+  return match ? parseInt(match[1], 10) + 1 : null;
+}
+
+async function queryCommittedOffset(
+  sessionUrl: string,
+  total: number,
+): Promise<number> {
+  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: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
 async function uploadToResumableUrl(
   slot: { uploadUrl: string },
   file: BuilderDesignSystemIndexFile,
 ): Promise<void> {
   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,
     },
   });
@@ -338,15 +423,60 @@ async function uploadToResumableUrl(
     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(
@@ -368,6 +498,25 @@ export function builderDesignSystemUrl(designSystemId?: string | null): string {
   });
 }
 
+export function builderProjectBranchUrl(
+  projectId?: string | null,
+  branchName?: string | null,
+): string | undefined {
+  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: string,
 ): string {
@@ -569,65 +718,58 @@ export async function hydrateBuilderDesignSystemReference(
   };
 }
 
-export async function startBuilderDesignSystemIndex(
-  options: BuilderDesignSystemIndexOptions,
-): Promise<BuilderDesignSystemIndexResult> {
-  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: BuilderDesignSystemUploadAttachment[],
+): Promise<BuilderDesignSystemUploadSlot[]> {
+  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()) as UploadStartResponse;
+  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: BuilderDesignSystemIndexFromSourcesOptions,
+): Promise<BuilderDesignSystemIndexResult> {
+  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: string[] = [];
-  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()) as UploadStartResponse;
-    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: {
@@ -635,39 +777,114 @@ export async function startBuilderDesignSystemIndex(
         "Content-Type": "application/json",
       },
       body: JSON.stringify({
-        uploads: uploadTokens,
+        sources: options.sources,
         ...(options.projectName?.trim()
-          ? { projectName: options.projectName.trim() }
-          : {}),
-        ...(options.githubRepoUrl?.trim()
-          ? { githubRepoUrl: options.githubRepoUrl.trim() }
+          ? { designSystemName: options.projectName.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()) as GenerateResponse;
-  if (!generated.projectId || !generated.jobId || !generated.designSystemId) {
+  await assertOk(index, "Builder design-system indexing failed");
+  const indexed = (await index.json()) as IndexResponse;
+  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: BuilderDesignSystemIndexOptions,
+): Promise<BuilderDesignSystemIndexResult> {
+  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: DesignSystemSourceInput[] = [];
+  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,
+  });
+}

package/src/server/email-template.ts

@@ -27,6 +27,12 @@ export interface EmailCta {
   url: string;
 }
 
+export interface EmailLinkBlock {
+  intro: string;
+  url: string;
+  placement?: "before-cta" | "after-cta";
+}
+
 export interface RenderEmailArgs {
   /** Short preview text shown by email clients next to the subject. */
   preheader?: string;
@@ -36,6 +42,8 @@ export interface RenderEmailArgs {
   paragraphs: string[];
   /** Primary call-to-action rendered as a real button. */
   cta?: EmailCta;
+  /** A treated, copyable URL shown before or after the CTA. */
+  linkBlock?: EmailLinkBlock;
   /**
    * Optional trusted HTML injected above the CTA — e.g. a template-owned video
    * thumbnail with a play badge. Injected verbatim, so only pass markup built
@@ -127,6 +135,19 @@ export function renderEmail(args: RenderEmailArgs): RenderedEmail {
     )
     .join("");
 
+  const linkBlockHtml = args.linkBlock
+    ? `
+      <p style="margin:24px 0 12px 0; font-size:15px; line-height:1.6; color:#d4d4d8;">${escapeHtml(args.linkBlock.intro)}</p>
+      <table role="presentation" cellpadding="0" cellspacing="0" border="0" width="100%" style="margin:0; border:1px solid #3f3f46; border-radius:10px; background:#0a0a0c;">
+        <tr>
+          <td style="padding:14px 16px;">
+            <a href="${escapeAttr(args.linkBlock.url)}" style="display:block; color:#d4d4d8; font-family:'SFMono-Regular', Consolas, 'Liberation Mono', monospace; font-size:13px; line-height:1.5; text-decoration:none; word-break:break-all; overflow-wrap:anywhere;">${escapeHtml(args.linkBlock.url)}</a>
+          </td>
+        </tr>
+      </table>
+    `
+    : "";
+
   const ctaHtml = args.cta
     ? `
       <table role="presentation" cellpadding="0" cellspacing="0" border="0" style="margin:24px 0 0 0;">
@@ -187,7 +208,9 @@ export function renderEmail(args: RenderEmailArgs): RenderedEmail {
                 </h1>
                 ${paragraphsHtml}
                 ${heroHtml}
+                ${args.linkBlock?.placement !== "after-cta" ? linkBlockHtml : ""}
                 ${ctaHtml}
+                ${args.linkBlock?.placement === "after-cta" ? linkBlockHtml : ""}
                 ${footerHtml}
               </td>
             </tr>
@@ -205,10 +228,20 @@ export function renderEmail(args: RenderEmailArgs): RenderedEmail {
     textLines.push(stripTags(p));
     textLines.push("");
   }
+  if (args.linkBlock && args.linkBlock.placement !== "after-cta") {
+    textLines.push(args.linkBlock.intro);
+    textLines.push(args.linkBlock.url);
+    textLines.push("");
+  }
   if (args.cta) {
     textLines.push(`${args.cta.label}: ${args.cta.url}`);
     textLines.push("");
   }
+  if (args.linkBlock?.placement === "after-cta") {
+    textLines.push(args.linkBlock.intro);
+    textLines.push(args.linkBlock.url);
+    textLines.push("");
+  }
   if (args.footer) {
     textLines.push(args.footer);
   }

package/src/server/index.ts

@@ -486,23 +486,31 @@ export {
 } from "./credential-provider.js";
 export {
   builderDesignSystemUrl,
+  builderProjectBranchUrl,
   buildBuilderDesignSystemIndexFiles,
   createBuilderDesignSystemProxyFields,
+  fetchBuilderDesignSystemDecodeJobStatus,
   fetchBuilderDesignSystemDocs,
   getBuilderDesignSystemsBaseUrl,
   hydrateBuilderDesignSystemReference,
+  indexBuilderDesignSystem,
   localBuilderDesignSystemId,
   mimeTypeForBuilderDesignSystemFilename,
   parseBuilderDesignSystemProxyReference,
   startBuilderDesignSystemIndex,
+  startBuilderDesignSystemUpload,
   type BuildBuilderDesignSystemIndexFilesOptions,
   type BuilderDesignSystemCodeFileInput,
+  type BuilderDesignSystemDecodeJobStatus,
   type BuilderDesignSystemDocsOptions,
   type BuilderDesignSystemDocument,
   type BuilderDesignSystemHydratedReference,
   type BuilderDesignSystemIndexFile,
+  type BuilderDesignSystemIndexFromSourcesOptions,
   type BuilderDesignSystemIndexOptions,
   type BuilderDesignSystemIndexResult,
+  type BuilderDesignSystemUploadAttachment,
+  type BuilderDesignSystemUploadSlot,
   type BuilderDesignSystemProxyFields,
   type BuilderDesignSystemProxyFieldsOptions,
   type BuilderDesignSystemProxyReference,

package/src/templates/chat/_gitignore

@@ -13,6 +13,8 @@ build/
 dist
 dist-ssr
 .output/
+.netlify/
+.deploy-tmp/
 *.local
 
 # Editor directories and files