@builder.io/ai-utils 0.66.2 → 0.67.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.66.2",
+  "version": "0.67.0",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/codegen.d.ts

@@ -2687,6 +2687,7 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
         Write: "Write";
     }>>>;
     enabledMCPs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    skippedMCPs: z.ZodOptional<z.ZodArray<z.ZodString>>;
     skipFileDiff: z.ZodOptional<z.ZodBoolean>;
     interruptActiveTask: z.ZodOptional<z.ZodBoolean>;
     localMCPTools: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -3482,6 +3483,7 @@ export declare const GenerateUserMessageSchema: z.ZodObject<{
         updateLastCommits: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     enabledMCPs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    skippedMCPs: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sessionMode: z.ZodOptional<z.ZodEnum<{
         "auto-planning": "auto-planning";
         "deep-research": "deep-research";
@@ -3522,6 +3524,7 @@ export interface UserInput {
     agentModelOverrides?: AgentModelOverrides;
     category?: CodeGenCategory;
     enabledMCPs?: string[];
+    skippedMCPs?: string[];
     /** @deprecated */
     repair?: boolean;
 }
@@ -3989,6 +3992,12 @@ export interface FusionConfig {
     browserAutomationInstructions?: string;
     /** Whether this branch is for a code review - affects enabled agents and tools */
     branchType?: BranchType;
+    /**
+     * When set, launch.ts hydrates `.builder/figma/<...>` from the corresponding
+     * GCS frame manifest before the agent starts. Only used on
+     * `branchType === "design-system-indexing"` branches.
+     */
+    figmaDecodeJobId?: string;
     featureBranch?: string;
     aiBranch?: string;
     /** Whether this is a fork PR - affects git operations (read-only, can't push) */

package/src/codegen.js

@@ -1761,6 +1761,9 @@ export const CodeGenInputOptionsSchema = z
     recommendedRoot: z.string().optional(),
     enabledTools: z.array(CodeGenToolsSchema).optional(),
     enabledMCPs: z.array(z.string()).optional(),
+    skippedMCPs: z.array(z.string()).optional().meta({
+        description: "Per-message denylist of MCP server ids to skip. Skipped servers are not mounted or connected for this message and will not trigger an `mcp-auth-required` event. Tokens and org-level enabled state are untouched; this is purely message-scoped.",
+    }),
     skipFileDiff: z.boolean().optional(),
     interruptActiveTask: z.boolean().optional().meta({
         description: "When true, the agent should interrupt its current task to handle this message immediately, rather than finishing the current task first.",
@@ -1858,6 +1861,9 @@ export const GenerateUserMessageSchema = z
     autoPush: AutoPushModeSchema.optional(),
     syncChanges: SyncChangesFromRemoteSchema.optional(),
     enabledMCPs: z.array(z.string()).optional(),
+    skippedMCPs: z.array(z.string()).optional().meta({
+        description: "Per-message denylist of MCP server names to skip. Skipped servers are not mounted or connected for this message and will not trigger an `mcp-auth-required` event. Tokens and org-level enabled state are untouched; this is purely message-scoped.",
+    }),
     sessionMode: SessionModeSchema.optional(),
     queue: z.boolean().optional(),
     agentType: z.string().optional().meta({

package/src/design-systems.d.ts

@@ -1,4 +1,16 @@
 import { z } from "zod";
+export interface FigmaHydrationFile {
+    /** Relative path to write under `.builder/figma/`. */
+    localPath: string;
+    downloadUrl: string;
+    contentType: string;
+}
+export interface FigmaHydrationResponse {
+    jobId: string;
+    status: "pending" | "processing" | "complete" | "error";
+    manifest: import("./events.js").FigmaFrameManifest | null;
+    files: FigmaHydrationFile[];
+}
 export type GenerateDesignSystemAttachmentKind = "fig" | "image" | "pdf" | "text";
 export interface GenerateDesignSystemFormFields {
     /**
@@ -6,6 +18,7 @@ export interface GenerateDesignSystemFormFields {
      * the uploaded `.fig` filenames.
      */
     projectName?: string;
+    devToolsVersion?: string;
     /**
      * Optional map of filename → page/frame GUIDs to restrict indexing.
      * GUIDs are file-local, so they must be scoped per attachment.
@@ -21,8 +34,13 @@ export interface GenerateDesignSystemRequest extends GenerateDesignSystemFormFie
 }
 export interface GenerateDesignSystemResponse {
     projectId: string;
-    branchName: string;
-    branchUrl: string;
+    /**
+     * Decode job id. The .fig file is decoded asynchronously in the
+     * `ai-queue-subscribers` worker. Clients should listen on the
+     * `figmaDecodeJobs/{jobId}` Firestore document for progress and the
+     * resolved `branchName` / `branchUrl`.
+     */
+    jobId: string;
 }
 export interface GenerateDesignSystemErrorResponse {
     error: string | Record<string, unknown>;
@@ -39,6 +57,7 @@ export declare const GENERATE_DESIGN_SYSTEM_MIN_ATTACHMENTS = 1;
  */
 export declare const generateDesignSystemBodySchema: z.ZodObject<{
     projectName: z.ZodOptional<z.ZodString>;
+    devToolsVersion: z.ZodOptional<z.ZodString>;
     selection: z.ZodOptional<z.ZodPreprocess<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>>;
 }, z.core.$strip>;
 export type GenerateDesignSystemBody = z.infer<typeof generateDesignSystemBodySchema>;

package/src/design-systems.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-export const GENERATE_DESIGN_SYSTEM_MAX_FILE_BYTES = 200 * 1024 * 1024;
+export const GENERATE_DESIGN_SYSTEM_MAX_FILE_BYTES = 2 * 1024 * 1024 * 1024;
 export const GENERATE_DESIGN_SYSTEM_MAX_ATTACHMENTS = 50;
 export const GENERATE_DESIGN_SYSTEM_MIN_ATTACHMENTS = 1;
 /**
@@ -11,6 +11,7 @@ export const GENERATE_DESIGN_SYSTEM_MIN_ATTACHMENTS = 1;
  */
 export const generateDesignSystemBodySchema = z.object({
     projectName: z.string().trim().min(1).max(200).optional(),
+    devToolsVersion: z.string().trim().min(1).max(64).optional(),
     selection: z
         .preprocess((v) => {
         if (typeof v !== "string")

package/src/events.d.ts

@@ -896,6 +896,69 @@ export interface SendMessageToOrgAgentInput {
      */
     autoCreateProject?: boolean;
 }
+export type FigmaDecodeJobV1 = FusionEventVariant<"figma.decode.job", {
+    jobId: string;
+    projectId: string;
+    projectName: string;
+    figmaName: string;
+    /**
+     * GCS object paths (relative to the configured bucket) of every attachment
+     * uploaded for this job. The worker streams these back down, runs
+     * `figProcessor.extract()` on the `.fig` entries, and forwards the rest as
+     * `FileUpload` attachments to the agent's initial message.
+     */
+    attachmentGcsPaths: Array<{
+        kind: "fig" | "image" | "pdf" | "text";
+        originalName: string;
+        gcsPath: string;
+        mimetype: string;
+        size: number;
+    }>;
+    devToolsVersion?: string;
+}, {}, 1>;
+export declare const FigmaDecodeJobV1: {
+    eventName: "figma.decode.job";
+    version: "1";
+};
+export interface FigmaDecodeJobDoc {
+    jobId: string;
+    ownerId: string;
+    userId?: string;
+    superuser?: Superuser;
+    projectId: string;
+    projectName: string;
+    figmaName: string;
+    status: "pending" | "processing" | "complete" | "error";
+    framesProcessed: number;
+    totalFrames: number;
+    manifestGcsPath: string | null;
+    branchName: string | null;
+    branchUrl: string | null;
+    error: string | null;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface FigmaFrameManifestEntry {
+    index: number;
+    frameName: string;
+    htmlGcsPath: string;
+    screenshotGcsPath: string | null;
+    htmlSizeBytes: number;
+}
+export interface FigmaFrameAsset {
+    /** Bucket-relative GCS path. */
+    gcsPath: string;
+    /** Relative path under `.builder/figma/` (e.g. `images/abc123.png`). */
+    localPath: string;
+    contentType: string;
+}
+export interface FigmaFrameManifest {
+    jobId: string;
+    figmaName: string;
+    frames: FigmaFrameManifestEntry[];
+    /** Raster assets referenced by frame HTML via relative `images/…` URLs. */
+    assets?: FigmaFrameAsset[];
+}
 export type PrReviewRequestedV1 = FusionEventVariant<"pr.review.requested", {
     repoFullName: string;
     repoHtmlUrl?: string;
@@ -967,7 +1030,7 @@ export declare const ClientDevtoolsToolResultV1: {
     eventName: "client.devtools.tool.result";
     version: "1";
 };
-export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionExternalPrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1;
+export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionExternalPrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -106,6 +106,10 @@ export const TimelineRecordingReadyV1 = {
     eventName: "timeline.recording.ready",
     version: "1",
 };
+export const FigmaDecodeJobV1 = {
+    eventName: "figma.decode.job",
+    version: "1",
+};
 export const PrReviewRequestedV1 = {
     eventName: "pr.review.requested",
     version: "1",

package/src/projects.js

@@ -36,7 +36,11 @@ export const EXAMPLE_REPOS = [
 ];
 export const STARTER_REPO = "BuilderIO/fusion-starter";
 export const DSI_PREVIEW_REPO = "BuilderIO/dsi-starter";
-export const EXAMPLE_OR_STARTER_REPOS = [...EXAMPLE_REPOS, STARTER_REPO];
+export const EXAMPLE_OR_STARTER_REPOS = [
+    ...EXAMPLE_REPOS,
+    STARTER_REPO,
+    DSI_PREVIEW_REPO,
+];
 export const EXAMPLE_OR_STARTER_REPOS_URLS = EXAMPLE_OR_STARTER_REPOS.map((repo) => `https://github.com/${repo}`);
 export const checkIsNewBranch = (branch) => {
     return "projectId" in branch;

package/src/repo-indexing.d.ts

@@ -105,6 +105,8 @@ export interface AddDesignSystemInput {
     gitOriginUrl: string | undefined;
     gitRelativePath: string | undefined;
     cliArgs: string[];
+    projectId?: string;
+    branchName?: string;
 }
 export interface UpdateDesignSystemInput {
     id: string;
@@ -133,6 +135,8 @@ export interface DesignSystem {
     gitRelativePath: string | undefined;
     cliArgs: string[];
     source: "custom" | "auto";
+    projectId?: string;
+    branchName?: string;
 }
 export interface DisplayDesignSystem extends DesignSystem {
     docCount: number;