@builder.io/ai-utils 0.66.2 → 0.68.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.66.2",
+  "version": "0.68.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

@@ -528,7 +528,7 @@ export declare const ReviewSubmittedV1: {
     eventName: "review.submitted";
     version: "1";
 };
-export type BotMentionExternalPrV1 = FusionEventVariant<"bot.mention.external-pr", {
+export type BotMentionGitHubExternalPrV1 = FusionEventVariant<"bot.mention.external-pr", {
     projectId: string;
     repoFullName: string;
     prNumber: number;
@@ -554,10 +554,148 @@ export type BotMentionExternalPrV1 = FusionEventVariant<"bot.mention.external-pr
 }, {
     projectId: string;
 }, 1>;
-export declare const BotMentionExternalPrV1: {
+export declare const BotMentionGitHubExternalPrV1: {
     eventName: "bot.mention.external-pr";
     version: "1";
 };
+/**
+ * Common fields shared by all four bot-mention PR events.
+ *
+ * Extracting this base makes the future consolidation into a single
+ * `bot.mention.pr` event straightforward: the unified type will be
+ * `BaseBotMentionEventData & { provider: ..., ...providerSpecificOptionals }`.
+ */
+export type BaseBotMentionEventData = {
+    /** Fusion project ID resolved from PR metadata */
+    projectId: string;
+    /** Fusion branch name resolved from PR metadata */
+    branchName: string;
+    /** Raw comment body that triggered the bot mention */
+    comment: string;
+    commentLink?: string;
+    /** Dedup lock key — composite of comment ID and delivery ID */
+    commentIdStr: string;
+    userName?: string;
+    /** Provider-specific user ID as string (for credits / analytics) */
+    gitUserId?: string;
+    /** Commenter email when available from the provider (preferred for user resolution) */
+    userEmail?: string;
+    /** Original webhook delivery ID — passed through for logging */
+    webhookEventId: string;
+};
+/**
+ * Emitted when @builderio-bot is mentioned on a Fusion (internal) GitHub PR comment.
+ * Pre-flight checks (project existence, installation token, GitHub App rights) have
+ * already passed before this event is published. The heavy work — container
+ * provisioning and AI processing — is handled asynchronously by the subscriber.
+ */
+export type BotMentionGitHubInternalPrV1 = FusionEventVariant<"bot.mention.github-internal-pr", BaseBotMentionEventData & {
+    provider: "github";
+    repoFullName: string;
+    prNumber: number;
+    /** Numeric GitHub comment ID (for reaction / reply threading) */
+    commentNumericId?: number;
+    commentType: "issue" | "pr";
+    /** GitHub Enterprise hostname, if applicable */
+    hostname?: string;
+    /** For review comments: the comment being replied to */
+    inReplyToCommentId?: number;
+    /** For review comments: unified diff context */
+    diffHunk?: string;
+    /** For review comments: file path */
+    filePath?: string;
+    /** For review comments: first line of the comment range */
+    startLine?: number;
+    /** For review comments: last line of the comment range */
+    endLine?: number;
+    /** For review comments: reply target comment ID */
+    replyToCommentId?: number;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionGitHubInternalPrV1: {
+    eventName: "bot.mention.github-internal-pr";
+    version: "1";
+};
+/**
+ * Emitted when @builderio-bot is mentioned on a GitLab MR comment.
+ * Pre-flight checks have already passed before this event is published.
+ * Container provisioning and AI processing happen asynchronously in the subscriber.
+ */
+export type BotMentionGitLabPrV1 = FusionEventVariant<"bot.mention.gitlab-pr", BaseBotMentionEventData & {
+    provider: "gitlab";
+    /** GitLab numeric project ID (needed to re-fetch token and post comments) */
+    gitlabProjectId: number;
+    /** GitLab MR IID */
+    mrId: number;
+    /**
+     * Thread discussion ID for threaded replies.
+     * GitLab sends this as a hex SHA string (e.g. "6a9c1750b37d..."),
+     * not a number — used only in URL interpolation.
+     */
+    discussionId?: string;
+    /** GitLab Enterprise hostname, if applicable */
+    hostname?: string;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionGitLabPrV1: {
+    eventName: "bot.mention.gitlab-pr";
+    version: "1";
+};
+/**
+ * Emitted when @builderio-bot is mentioned on a Bitbucket PR comment.
+ * Pre-flight checks have already passed before this event is published.
+ */
+export type BotMentionBitbucketPrV1 = FusionEventVariant<"bot.mention.bitbucket-pr", BaseBotMentionEventData & {
+    provider: "bitbucket";
+    /** e.g. "workspace/repo" */
+    repositorySlug: string;
+    workspace?: string;
+    pullRequestId: number;
+    /** Numeric Bitbucket comment ID — used as parentCommentId for reply threading */
+    parentCommentId?: number;
+    /** PR browser URL (links.html.href from the pullrequest payload) */
+    pullRequestUrl?: string;
+    /** PR title from the pullrequest payload */
+    pullRequestTitle?: string;
+    /** PR description from the pullrequest payload */
+    pullRequestDescription?: string;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionBitbucketPrV1: {
+    eventName: "bot.mention.bitbucket-pr";
+    version: "1";
+};
+/**
+ * Emitted when @builderio-bot is mentioned on an Azure DevOps PR comment.
+ * Pre-flight checks have already passed before this event is published.
+ */
+export type BotMentionAzurePrV1 = FusionEventVariant<"bot.mention.azure-pr", BaseBotMentionEventData & {
+    provider: "azure";
+    azureOrg: string;
+    azureProject: string;
+    pullRequestId: number;
+    /** Repository ID extracted from comment links */
+    repositoryId: string;
+    /** Thread link URL — used for reply threading and thread context */
+    threadLink: string;
+    /**
+     * The actual Azure DevOps REST URL of the pull request
+     * (event.resource.url or pullRequest.url from the webhook payload).
+     * Distinct from commentLink which is the comment resource URL.
+     */
+    pullRequestUrl?: string;
+    /** PR description from the pullrequest payload */
+    pullRequestDescription?: string;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionAzurePrV1: {
+    eventName: "bot.mention.azure-pr";
+    version: "1";
+};
 export type ClientDevtoolsSessionStartedEvent = FusionEventVariant<"client.devtools.session.started", {
     sessionId?: string;
     sessionType?: string;
@@ -896,6 +1034,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 +1168,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 | BotMentionGitHubExternalPrV1 | BotMentionGitHubInternalPrV1 | BotMentionGitLabPrV1 | BotMentionBitbucketPrV1 | BotMentionAzurePrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -14,10 +14,26 @@ export const ReviewSubmittedV1 = {
     eventName: "review.submitted",
     version: "1",
 };
-export const BotMentionExternalPrV1 = {
+export const BotMentionGitHubExternalPrV1 = {
     eventName: "bot.mention.external-pr",
     version: "1",
 };
+export const BotMentionGitHubInternalPrV1 = {
+    eventName: "bot.mention.github-internal-pr",
+    version: "1",
+};
+export const BotMentionGitLabPrV1 = {
+    eventName: "bot.mention.gitlab-pr",
+    version: "1",
+};
+export const BotMentionBitbucketPrV1 = {
+    eventName: "bot.mention.bitbucket-pr",
+    version: "1",
+};
+export const BotMentionAzurePrV1 = {
+    eventName: "bot.mention.azure-pr",
+    version: "1",
+};
 export const ClientDevtoolsSessionStartedEvent = {
     eventName: "client.devtools.session.started",
     version: "1",
@@ -106,6 +122,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;