@builder.io/ai-utils 0.40.0 → 0.41.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.40.0",
+  "version": "0.41.1",
   "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;
@@ -730,7 +730,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 +743,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 +787,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 +833,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 +920,7 @@ export interface RankedResult {
 }
 export interface GenerateCompletionStepThinking {
     type: "thinking";
+    content: string;
 }
 export interface FileInfo {
     filePath: string;
@@ -925,10 +932,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 +1297,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;
@@ -2369,3 +2372,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;
@@ -554,7 +592,10 @@ export type ClientDevtoolsSessionIdleEventV1 = FusionEventVariant<"client.devtoo
     branchName?: string;
     hasPlanToApply?: boolean;
     sessionMode?: string;
-}, {}, 1>;
+}, {
+    projectId?: string;
+    branchName?: string;
+}, 1>;
 export declare const ClientDevtoolsSessionIdleEventV1: {
     eventName: "client.devtools.session.idle";
     version: "1";
@@ -636,6 +677,7 @@ export declare const CodegenCompletionV1: {
     version: "1";
 };
 export type CodegenUserPromptV1 = FusionEventVariant<"codegen.user.prompt", {
+    position: CodeGenPosition;
     completionId: string;
     role?: string;
     projectId?: string;
@@ -753,7 +795,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 | FusionBranchContainerStartedV1 | FusionBranchMessageSentV1 | 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",

package/src/index.d.ts

@@ -10,5 +10,6 @@ export * from "./organization.js";
 export * from "./features.js";
 export * from "./vscode-tunnel.js";
 export * from "./claw.js";
+export * from "./kube-error.js";
 export * from "./connectivity/types.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";

package/src/index.js

@@ -10,5 +10,6 @@ export * from "./organization.js";
 export * from "./features.js";
 export * from "./vscode-tunnel.js";
 export * from "./claw.js";
+export * from "./kube-error.js";
 export * from "./connectivity/types.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";

package/src/kube-error.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extract the HTTP status code from a Kubernetes client error.
+ * ApiException (v1.x) uses numeric `.code`, but raw network errors (e.g. ECONNREFUSED)
+ * set `.code` to a string. This helper ensures we always return a number.
+ */
+export declare function kubeErrorStatus(error: any): number;

package/src/kube-error.js

@@ -0,0 +1,13 @@
+/**
+ * Extract the HTTP status code from a Kubernetes client error.
+ * ApiException (v1.x) uses numeric `.code`, but raw network errors (e.g. ECONNREFUSED)
+ * set `.code` to a string. This helper ensures we always return a number.
+ */
+export function kubeErrorStatus(error) {
+    var _a;
+    if (typeof error.code === "number")
+        return error.code;
+    if (typeof ((_a = error.response) === null || _a === void 0 ? void 0 : _a.statusCode) === "number")
+        return error.response.statusCode;
+    return 0;
+}

package/src/organization.d.ts

@@ -54,6 +54,14 @@ export interface FallbackTokensPrivate {
         token: string;
     };
 }
+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;
@@ -92,6 +100,7 @@ interface OrganizationSettings {
     ticketAssessmentPrompt?: string;
     ticketAssessmentModel?: string;
     ticketAssessmentDailyLimit?: number;
+    fusionWebhooks?: FusionWebhook[];
 }
 interface RoleOptions {
     read?: boolean;

package/src/projects.d.ts

@@ -405,6 +405,8 @@ export interface BranchMetadata {
     description?: string;
     /** Whether the branch is a cloned branch */
     isClonedBranch?: boolean;
+    /** Data passed in via /agents/run api that we echo in webhook response **/
+    webhookContext?: Record<string, unknown>;
     [key: string]: unknown;
 }
 export type PRStatus = "open" | "closed" | "merged" | "draft" | "approved";
@@ -752,6 +754,7 @@ export interface OrganizationPrivate {
     createdAt: number;
     updatedAt: number;
     fallbackTokens?: FallbackTokensPrivate;
+    fusionWebhookSecrets?: Record<string, string>;
 }
 export interface CreateProjectOptions {
     name?: string;