@builder.io/ai-utils 0.41.0 → 0.42.0

package/package.json

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

package/src/codegen.d.ts

@@ -49,7 +49,7 @@ export interface CustomAgentDefinition {
     model?: string;
     roundRobinModels?: string[];
     mode?: CodeGenMode;
-    position?: string;
+    position?: CodeGenPosition;
     needDevServer?: boolean;
     needValidation?: boolean;
     includeMemories?: boolean;
@@ -264,6 +264,25 @@ export interface ReportTestOutcomeToolInput {
     outcome: TestOutcome;
     summary: string;
     details?: string;
+    test_case_id?: string;
+    evidence_frame_count?: number;
+    failure_category?: TestCaseFailureCategory;
+    failure_detail?: string;
+    console_errors?: string;
+    network_failures?: string;
+    steps_attempted?: string;
+    urls_tested?: string[];
+}
+export type TestCaseFailureCategory = "env_issue" | "creds_missing" | "needs_user_input" | "server_not_ready" | "feature_not_reachable" | "timeout" | "assertion_failed" | "unexpected_error" | "not_applicable";
+export interface RegisterTestPlanToolInput {
+    mode: "quick" | "thorough";
+    test_cases: Array<{
+        id: string;
+        description: string;
+        expected_outcome: string;
+        priority: "critical" | "high" | "medium" | "low";
+        source?: string;
+    }>;
 }
 export type TimelineEventCategory = "navigation" | "interaction" | "assertion" | "error" | "milestone" | "code-change" | "observation";
 export interface TimelineEvent {
@@ -710,6 +729,7 @@ export interface CodeGenToolMap {
     ReportUIIssue: ReportUIIssueToolInput;
     ReportIssue: ReportIssueToolInput;
     ReportTestOutcome: ReportTestOutcomeToolInput;
+    RegisterTestPlan: RegisterTestPlanToolInput;
     VerifySetupCommand: VerifySetupCommandToolInput;
     VerifyDevCommand: VerifyDevCommandToolInput;
     VerifyDevServer: VerifyDevServerToolInput;
@@ -730,7 +750,7 @@ export type AllCodeGenTools = CodeGenTools | "web_search";
 export type SessionMode = "planning" | "normal" | "auto-planning" | "deep-research";
 export type CodeGenMode = "quality" | "quality-v3" | "quality-v4" | "quality-v4-agent";
 export type QueueMode = "next-turn" | "until-idle";
-export type BaseCodeGenPosition = "fusion" | "editor-ai" | "repo-indexing" | "cli" | "create-app-firebase" | "create-app-lovable" | "builder-code-panel" | "dsi-mcp";
+export type BaseCodeGenPosition = "fusion" | "editor-ai" | "repo-indexing" | "cli" | "create-app-firebase" | "create-app-lovable" | "builder-code-panel" | "setup-project" | "code-review-orchestrator" | "project-configuration" | "org-agent" | "browser-testing" | "projects-scheduler-memory-extraction" | "unknown" | "dsi-mcp";
 export type CodeGenPosition = BaseCodeGenPosition | `${BaseCodeGenPosition}-agent`;
 export interface RepoIndexingConfig {
     designSystems: string[];
@@ -743,7 +763,7 @@ export interface LocalMCPTools {
 }
 export type CodeGenCategory = `repair-${string}` | `user-normal` | `user-figma` | `user-pdf` | `user-image` | `setup-agent` | `background-${string}` | `indexing-${string}`;
 export interface CodeGenInputOptions {
-    position: string;
+    position: CodeGenPosition;
     eventName?: string;
     sessionId: string;
     codeGenMode?: CodeGenMode;
@@ -787,6 +807,11 @@ export interface CodeGenInputOptions {
     enabledTools?: CodeGenTools[];
     enabledMCPs?: string[];
     skipFileDiff?: boolean;
+    /**
+     * When true, the agent should interrupt its current task to handle this
+     * message immediately, rather than finishing the current task first.
+     */
+    interruptActiveTask?: boolean;
     /**
      * Local MCP tool definitions from stdio servers (CLI-side only)
      * These tools will be executed on the client side and passed through from the server
@@ -828,6 +853,7 @@ export interface CodeGenInputOptions {
     projectId?: string;
     branchName?: string;
     repoHash?: string;
+    repoBranch?: string;
     /**
      * Server-side branch.agentType cached from middleware Firestore lookup.
      * Used to avoid redundant getBranch calls for billing exemption checks.
@@ -914,6 +940,7 @@ export interface RankedResult {
 }
 export interface GenerateCompletionStepThinking {
     type: "thinking";
+    content: string;
 }
 export interface FileInfo {
     filePath: string;
@@ -925,10 +952,6 @@ export interface GenerateCompletionStepUserInput {
     prompt: string;
     files: FileInfo[];
 }
-export interface GenerateCompletionStepPlanning {
-    type: "planning";
-    content: string;
-}
 export interface GenerateCompletionStepUser {
     type: "user";
     displayPrompt: string | undefined;
@@ -1294,7 +1317,7 @@ export interface GenerateCompletionStepUpdateSetupValue {
     };
     reason: string;
 }
-export type GenerateCompletionStep = GenerateCompletionStepPlanning | GenerateCompletionStepStart | GenerateCompletionStepDelta | GenerateCompletionStepUser | GenerateCompletionStepFile | GenerateCompletionStepDiff | GenerateCompletionStepTool | GenerateCompletionStepError | GenerateCompletionStepContinue | GenerateCompletionStepWaitForInput | GenerateCompletionStepAbort | GenerateCompletionStepDone | GenerateCompletionStepUserInput | GenerateCompletionStepText | GenerateCompletionStepRestore | GenerateCompletionStepState | GenerateCompletionStepStdio | GenerateCompletionStepSession | GenerateCompletionStepServerToolResult | GenerateCompletionStepGit | GenerateCompletionStepBuilderAction | GenerateCompletionStepToolResult | GenerateCompletionStepFusionConfigPatch | GenerateCompletionStepToolCallRequest | GenerateCodeEventMCPStatus | GenerateCodeEventMCPAuthRequired | GenerateCompletionStepDevServerState | GenerateCompletionStepAgent | GenerateCompletionStepBatch | GenerateCompletionStepTerminals | GenerateCompletionStepMetadata | GenerateCompletionStepMessageQueue | GenerateCompletionStepProposeConfig | GenerateCompletionStepUpdateSetupValue | GenerateCompletionStepIde;
+export type GenerateCompletionStep = GenerateCompletionStepThinking | GenerateCompletionStepStart | GenerateCompletionStepDelta | GenerateCompletionStepUser | GenerateCompletionStepFile | GenerateCompletionStepDiff | GenerateCompletionStepTool | GenerateCompletionStepError | GenerateCompletionStepContinue | GenerateCompletionStepWaitForInput | GenerateCompletionStepAbort | GenerateCompletionStepDone | GenerateCompletionStepUserInput | GenerateCompletionStepText | GenerateCompletionStepRestore | GenerateCompletionStepState | GenerateCompletionStepStdio | GenerateCompletionStepSession | GenerateCompletionStepServerToolResult | GenerateCompletionStepGit | GenerateCompletionStepBuilderAction | GenerateCompletionStepToolResult | GenerateCompletionStepFusionConfigPatch | GenerateCompletionStepToolCallRequest | GenerateCodeEventMCPStatus | GenerateCodeEventMCPAuthRequired | GenerateCompletionStepDevServerState | GenerateCompletionStepAgent | GenerateCompletionStepBatch | GenerateCompletionStepTerminals | GenerateCompletionStepMetadata | GenerateCompletionStepMessageQueue | GenerateCompletionStepProposeConfig | GenerateCompletionStepUpdateSetupValue | GenerateCompletionStepIde;
 export interface ApplyActionsResult {
     filePath: string;
     addedLines: number;
@@ -2337,6 +2360,7 @@ export interface LaunchInitializeSessionOptions {
     sessionId?: string;
     customInstructions?: CustomInstruction[];
     privacyMode?: PrivacyMode;
+    forceSessionReload?: boolean;
 }
 /**
  * Request for generating a commit message via LLM
@@ -2369,3 +2393,28 @@ export interface TodoItem {
     status: "pending" | "in_progress" | "completed";
     id: string;
 }
+export interface SessionData {
+    lastCompletionId: string | undefined;
+    ownerId: string;
+    initialUrl?: string;
+    contentOrProjectId?: string;
+    createdAt: number;
+    createdBy?: string;
+    updatedAt: number;
+    lastUpdatedBy?: string;
+    beforeCommit?: GitSnapshot;
+    title?: string;
+    id: string;
+    sessionMode: SessionMode;
+    projectId: string | undefined;
+    branchName: string | undefined;
+    repoHash: string | undefined;
+    repoBranch: string | undefined;
+    description?: string;
+    hasPlanToApply?: boolean;
+    cost: number;
+    totalCompletions: number;
+    numUserMessages: number;
+    numNormalUserMessages: number;
+    metadata?: Record<string, any>;
+}

package/src/events.d.ts

@@ -1,7 +1,7 @@
 import type { BuilderContent, BuilderElement } from "@builder.io/sdk";
 import type { AssistantMessage, AssistantMessageAction } from "./messages.js";
 import type { AssistantSettings } from "./settings.js";
-import type { ExitState, UserSource } from "./codegen.js";
+import type { ExitState, UserSource, CodeGenPosition } from "./codegen.js";
 import type { FileUpload } from "./messages.js";
 export type BuilderAssistantEventHandler = (ev: BuilderAssistantEvent) => void;
 export type BuilderAssistantEvent = AssistantCompletionResultEvent | AssistantErrorEvent | AssistantStreamErrorEvent | AppCloseEvent | AppMessagesClickEvent | AppMessagesGenerationEvent | AppMessageEditCustomInstructionsEvent | AppPromptAbortEvent | AppPromptFocusEvent | AppPromptSubmitEvent | AppReadyEvent | AppSettingsSetEvent | AppThreadNewEvent | AssistantStatsEvent | AssistantThemeEvent | BuilderEditorAuthEvent | BuilderEditorStateEvent | ContentUpdateEvent | ContentApplySnapshotEvent | ModelUndoEvent | ModelRedoEvent | ResultEvent | ThreadCreatedEvent | ThreadMessageCompletedEvent | ThreadMessageCreatedEvent | ThreadMessageDeltaEvent | ThreadMessageFeedbackEvent | ThreadRunStepCreatedEvent | ThreadRunStepDeltaEvent | AppAcceptChangeEvent | AppAcceptRejectEvent | AssistantTrackEvent | AssistantEditorAuthMessage | AppAttachmentTemplateEvent | AppPasteSmartExportEvent | ThreadMessageRetryEvent | AppFigmaImportEvent | AppWebImportEvent | AppMcpServersEvent | AssistantContentInitialEvent | ThreadMessageSummaryEvent | ThreadMessageSummaryCodegenDeltaEvent | ThreadMessageThinkingDeltaEvent | AssistantHeartbeatEvent | ShowUpgradeDialogEvent | AssistantFusionSuggestionEvent | AppNavigateToFusionEvent | ModelPermissionRequiredEvent | ModelPermissionResponseEvent;
@@ -505,6 +505,44 @@ export declare const GitPrMergedV1: {
     eventName: "git.pr.merged";
     version: "1";
 };
+export type ReviewSubmittedV1 = FusionEventVariant<"review.submitted", {
+    projectId: string;
+    branchName: string;
+    repoFullName: string;
+    prNumber: number;
+    commitSha: string;
+    /** Firestore doc ID (deterministic — config.id or generated upfront) */
+    reviewDocId: string;
+    /** GitHub review ID (empty string for clean reviews) */
+    reviewId: string;
+    /** Session ID for cost tracking (empty if unavailable) */
+    sessionId: string;
+    summary: string;
+    /** Whether this review includes a visual recording */
+    hasRecording?: boolean;
+    /** Recording URL if hasRecording is true */
+    recordingUrl?: string;
+    /** Posted comments from GitHub API */
+    postedComments: Array<{
+        id: number;
+        node_id: string;
+        thread_node_id: string;
+        path: string;
+        line: number | null;
+        start_line?: number | null;
+        body: string;
+    }>;
+    riskLevel: "high" | "medium" | "low";
+    totalIssuesSubmitted: number;
+    issuesPosted: number;
+    issuesHigh: number;
+    issuesMedium: number;
+    issuesDropped: number;
+}, {}, 1>;
+export declare const ReviewSubmittedV1: {
+    eventName: "review.submitted";
+    version: "1";
+};
 export type BotMentionExternalPrV1 = FusionEventVariant<"bot.mention.external-pr", {
     projectId: string;
     repoFullName: string;
@@ -639,6 +677,7 @@ export declare const CodegenCompletionV1: {
     version: "1";
 };
 export type CodegenUserPromptV1 = FusionEventVariant<"codegen.user.prompt", {
+    position: CodeGenPosition;
     completionId: string;
     role?: string;
     projectId?: string;
@@ -678,7 +717,8 @@ export type FusionBranchCreatedV1 = FusionEventVariant<"fusion.branch.created",
     projectId: string;
     branchName: string;
     branchFriendlyName?: string;
-    actor: string;
+    createdBy: string;
+    actor?: string;
 }, {
     projectId: string;
     branchName: string;
@@ -687,7 +727,7 @@ export declare const FusionBranchCreatedV1: {
     eventName: "fusion.branch.created";
     version: "1";
 };
-export type FusionBranchContainerStartedV1 = FusionEventVariant<"fusion.branch.container-started", {
+export type FusionContainerStartedV1 = FusionEventVariant<"fusion.container.started", {
     projectId: string;
     branchName: string;
     url: string;
@@ -695,26 +735,26 @@ export type FusionBranchContainerStartedV1 = FusionEventVariant<"fusion.branch.c
     projectId: string;
     branchName: string;
 }, 1>;
-export declare const FusionBranchContainerStartedV1: {
-    eventName: "fusion.branch.container-started";
+export declare const FusionContainerStartedV1: {
+    eventName: "fusion.container.started";
     version: "1";
 };
-export type FusionBranchMessageSentV1 = FusionEventVariant<"fusion.branch.message-sent", {
+export type FusionContainerFailedV1 = FusionEventVariant<"fusion.container.failed", {
     projectId: string;
     branchName: string;
+    error: string;
 }, {
     projectId: string;
     branchName: string;
 }, 1>;
-export declare const FusionBranchMessageSentV1: {
-    eventName: "fusion.branch.message-sent";
+export declare const FusionContainerFailedV1: {
+    eventName: "fusion.container.failed";
     version: "1";
 };
 export type FusionBranchFailedV1 = FusionEventVariant<"fusion.branch.failed", {
     projectId: string;
     branchName?: string;
     error: string;
-    phase: string;
 }, {
     projectId: string;
     branchName?: string;
@@ -756,7 +796,7 @@ export interface SendMessageToOrgAgentInput {
      */
     autoCreateProject?: boolean;
 }
-export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | FusionBranchCreatedV1 | FusionBranchContainerStartedV1 | FusionBranchMessageSentV1 | FusionBranchFailedV1 | BotMentionExternalPrV1;
+export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionExternalPrV1 | ReviewSubmittedV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -18,6 +18,10 @@ export const GitPrMergedV1 = {
     eventName: "git.pr.merged",
     version: "1",
 };
+export const ReviewSubmittedV1 = {
+    eventName: "review.submitted",
+    version: "1",
+};
 export const BotMentionExternalPrV1 = {
     eventName: "bot.mention.external-pr",
     version: "1",
@@ -66,12 +70,12 @@ export const FusionBranchCreatedV1 = {
     eventName: "fusion.branch.created",
     version: "1",
 };
-export const FusionBranchContainerStartedV1 = {
-    eventName: "fusion.branch.container-started",
+export const FusionContainerStartedV1 = {
+    eventName: "fusion.container.started",
     version: "1",
 };
-export const FusionBranchMessageSentV1 = {
-    eventName: "fusion.branch.message-sent",
+export const FusionContainerFailedV1 = {
+    eventName: "fusion.container.failed",
     version: "1",
 };
 export const FusionBranchFailedV1 = {

package/src/organization.d.ts

@@ -54,8 +54,14 @@ export interface FallbackTokensPrivate {
         token: string;
     };
 }
-export type BackgroundAgentsWebhookEvent = "started" | "completed" | "error";
-export type BackgroundAgentsWebhookEvents = ["all"] | BackgroundAgentsWebhookEvent[];
+export type FusionWebhookEvent = "background.agent.started" | "background.agent.completed" | "background.agent.error";
+export type FusionWebhookEvents = ["all"] | FusionWebhookEvent[];
+export interface FusionWebhook {
+    id: string;
+    disabled?: boolean;
+    url: string;
+    events: FusionWebhookEvents;
+}
 interface OrganizationSettings {
     attribution?: string[];
     visualEditorAiStyleInspirationURL?: string;
@@ -94,10 +100,7 @@ interface OrganizationSettings {
     ticketAssessmentPrompt?: string;
     ticketAssessmentModel?: string;
     ticketAssessmentDailyLimit?: number;
-    backgroundAgentsWebhook?: {
-        url?: string;
-        events?: BackgroundAgentsWebhookEvents;
-    };
+    fusionWebhooks?: FusionWebhook[];
 }
 interface RoleOptions {
     read?: boolean;

package/src/projects.d.ts

@@ -754,7 +754,7 @@ export interface OrganizationPrivate {
     createdAt: number;
     updatedAt: number;
     fallbackTokens?: FallbackTokensPrivate;
-    backgroundAgentsWebhookSecret?: string;
+    fusionWebhookSecrets?: Record<string, string>;
 }
 export interface CreateProjectOptions {
     name?: string;