@builder.io/ai-utils 0.38.3 → 0.40.0

package/package.json

@@ -1,25 +1,25 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.38.3",
+  "version": "0.40.0",
   "description": "Builder.io AI utils",
+  "files": [
+    "src"
+  ],
   "type": "module",
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "exports": {
     ".": {
-      "import": "./src/index.js",
-      "types": "./src/index.d.ts"
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
     },
     "./src/connectivity/node": {
-      "import": "./src/connectivity/node.js",
-      "types": "./src/connectivity/node.d.ts"
+      "types": "./src/connectivity/node.d.ts",
+      "import": "./src/connectivity/node.js"
     },
     "./src/connectivity/browser": {
-      "import": "./src/connectivity/browser.js",
-      "types": "./src/connectivity/browser.d.ts"
+      "types": "./src/connectivity/browser.d.ts",
+      "import": "./src/connectivity/browser.js"
     }
-  },
-  "files": [
-    "src"
-  ]
+  }
 }

package/src/codegen.d.ts

@@ -60,6 +60,13 @@ export interface CustomAgentDefinition {
     filePath?: string;
     /** Default reasoning effort level for this agent type. Overrides the session default. */
     reasoning?: ReasoningEffort;
+    /**
+     * When true and the parent session has an explicit model override (e.g. set
+     * via org/project PR-reviewer settings), that model is used for this agent
+     * instead of the agent's own `model` / `roundRobinModels` defaults.
+     * Has no effect when no session-level model override is present.
+     */
+    inheritSessionModel?: boolean;
 }
 export type CodeGenFramework = "react" | "html" | "mitosis" | "react-native" | "angular" | "vue" | "svelte" | "qwik" | "solid" | "marko" | "swiftui" | "jetpack-compose" | "flutter";
 export type CodeGenStyleLibrary = "tailwind" | "tailwind-precise" | "emotion" | "styled-components" | "styled-jsx" | "react-native" | undefined;
@@ -169,16 +176,17 @@ export interface ScoreMemoriesToolInput {
     outcome: "worked" | "failed" | "partial" | "unknown";
     memory_scores: Record<string, "worked" | "failed" | "partial" | "unknown">;
 }
-export interface AskUserQuestionToolInput {
-    questions: {
-        question: string;
-        header: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        multiSelect?: boolean;
+export interface AskUserQuestion {
+    question: string;
+    header: string;
+    options: {
+        label: string;
+        description: string;
     }[];
+    multiSelect?: boolean;
+}
+export interface AskUserQuestionToolInput {
+    questions: AskUserQuestion[];
     answers?: Record<string, string>;
 }
 export interface AgentToolInput {
@@ -189,9 +197,6 @@ export interface AgentToolInput {
     origin_channel_id?: string;
     attachmentUrls?: string[];
 }
-export interface ListDirToolInput {
-    path: string;
-}
 export interface RevertToolInput {
     checkpoint_id: string;
 }
@@ -310,6 +315,27 @@ export interface TimelineRecording {
         debugInfo?: string;
     }>;
 }
+export interface CompileRecordingToolInput {
+    caption: string;
+    recording_caption: string;
+    summary?: string;
+    comments?: PRReviewComment[];
+}
+export interface TimelineSubmissionMetadata {
+    prNumber?: number;
+    repoFullName?: string;
+    hostname?: string;
+    prHeadSha?: string;
+    checkRunId?: number;
+    recordingCaption?: string;
+    summary?: string;
+    comments?: PRReviewComment[];
+    projectId?: string;
+    branchName?: string;
+    ownerId?: string;
+    configId?: string;
+    containerUrl?: string;
+}
 /**
  * Configuration values proposed by the setup analyzer agent
  */
@@ -595,7 +621,7 @@ export interface ArchiveBranchToolInput {
     builder_user_id: string;
     reason?: string;
 }
-/** Comment for PR review - used by both SubmitPRReview and SubmitRecording */
+/** Comment for PR review - used by SubmitPRReview and CompileRecording */
 export interface PRReviewComment {
     file_path: string;
     line: number;
@@ -612,14 +638,6 @@ export interface SubmitPRReviewToolInput {
     comments?: PRReviewComment[];
     risk_level?: "high" | "medium" | "low";
 }
-/** SubmitRecording - Visual verification with recording (posted as separate review) */
-export interface SubmitRecordingToolInput {
-    gif_id: string;
-    timeline_id?: string;
-    recording_caption: string;
-    summary?: string;
-    comments?: PRReviewComment[];
-}
 export interface ResolveQACommentsToolInput {
     thread_node_ids: string[];
 }
@@ -677,15 +695,14 @@ export interface CodeGenToolMap {
     TodoRead: TodoReadToolInput;
     TodoWrite: TodoWriteToolInput;
     BuilderEdit: BuilderEditToolInput;
-    LS: ListDirToolInput;
     WebFetch: WebFetchToolInput;
     ExplorationMetadata: ExplorationMetadataToolInput;
     EnterPlanMode: EnterPlanModeToolInput;
     ExitPlanMode: ExitPlanModeToolInput;
     ReadMcpResource: ReadMcpResourceToolInput;
     RecordFrame: RecordFrameToolInput;
+    CompileRecording: CompileRecordingToolInput;
     SubmitPRReview: SubmitPRReviewToolInput;
-    SubmitRecording: SubmitRecordingToolInput;
     ProposeConfig: ProposeConfigToolInput;
     UpdateSetupValue: UpdateSetupValueToolInput;
     Exit: ExitToolInput;
@@ -706,6 +723,7 @@ export interface CodeGenToolMap {
     ReadBranch: ReadBranchToolInput;
     ArchiveBranch: ArchiveBranchToolInput;
     RunningAgents: RunningAgentsToolInput;
+    IDEDiagnostics: IDEDiagnosticsToolInput;
 }
 export type CodeGenTools = keyof CodeGenToolMap;
 export type AllCodeGenTools = CodeGenTools | "web_search";
@@ -1078,10 +1096,12 @@ export interface SuggestedActionBuildError extends SuggestedActionBase {
 export type SuggestedAction = SuggestedActionBuildError;
 export interface GenerateCompletionStepWaitForInput {
     type: "wait-for-input";
+    id: string;
     state: GenerateCompletionState;
     suggestion?: SuggestedAction;
     sessionMode: SessionMode;
     hasPlanToApply: boolean;
+    modelOverride?: string;
 }
 export type GenerateCompletionStepBuilderAction = GenerateCompletionStepBuilderActionRefresh | GenerateCompletionStepBuilderActionOpenPath | GenerateCompletionStepBuilderActionMCPConnect;
 export interface GenerateCompletionStepBuilderActionRefresh {
@@ -1190,14 +1210,16 @@ export interface GenerateCompletionStepSession {
     fusionConfig: FusionConfig | undefined;
     hasBrowserAutomation: boolean;
     customInstructions: CustomInstructionDefinition[];
+    hasPlanToApply: boolean;
 }
 export interface GenerateCompletionStepMetadata {
     type: "metadata";
     [key: string]: unknown;
 }
+export type MessageQueue = Pick<GenerateUserMessage, "idempotencyKey" | "displayPrompt" | "user">[];
 export interface GenerateCompletionStepMessageQueue {
     type: "message-queue";
-    queue: Pick<GenerateUserMessage, "idempotencyKey" | "displayPrompt" | "user">[];
+    queue: MessageQueue;
 }
 export interface GenerateCompletionStepServerToolResult {
     type: "server_tool_result";
@@ -1223,6 +1245,31 @@ export interface GenerateCompletionStepTerminals {
     type: "terminals";
     terminals: CodegenApiTerminal[];
 }
+export interface IdeContext {
+    ideName: string;
+    file: string | null;
+    line: number | null;
+    column: number | null;
+    selection: string | null;
+}
+export interface DiagnosticEntry {
+    file: string;
+    severity: string;
+    message: string;
+    line: number;
+    source: string | null;
+}
+export interface IDEDiagnosticsToolInput {
+    file_path?: string;
+}
+export interface DiagnosticsResponse {
+    ideName: string;
+    diagnostics: DiagnosticEntry[];
+}
+export interface GenerateCompletionStepIde {
+    type: "ide";
+    context: IdeContext | null;
+}
 export interface GenerateCompletionStepProposeConfig {
     type: "propose_config";
     config: SetupAnalysisValues;
@@ -1247,9 +1294,7 @@ export interface GenerateCompletionStepUpdateSetupValue {
     };
     reason: string;
 }
-export type GenerateCompletionStep = {
-    timestamp?: number;
-} & (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);
+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 interface ApplyActionsResult {
     filePath: string;
     addedLines: number;
@@ -1721,6 +1766,7 @@ export interface MCPServerDefinition {
     args?: string[];
     env?: Record<string, string>;
     envFile?: string;
+    retries?: number;
 }
 export type MCPServerConfig = Record<string, MCPServerDefinition>;
 export interface FusionConfig {
@@ -2318,3 +2364,8 @@ export interface CommitMessageResponse {
     /** Optional extended description */
     body?: string;
 }
+export interface TodoItem {
+    content: string;
+    status: "pending" | "in_progress" | "completed";
+    id: string;
+}

package/src/connectivity/checks/dns-check.js

@@ -1,4 +1,4 @@
-import dns from "dns";
+import dns from "node:dns";
 import { mapNodeErrorToConnectivityCode } from "../error-codes.js";
 const { resolve4, resolve6 } = dns.promises;
 const DEFAULT_TIMEOUT_MS = 10000;

package/src/events.d.ts

@@ -472,15 +472,69 @@ export declare const AiTaskFailedEvent: {
     eventName: "ai.task.failed";
     version: "1";
 };
-export type GitPrCreatedEvent = FusionEventVariant<"git.pr.created", {
-    prNumber?: number;
-    repo?: string;
-    branch?: string;
+export type GitPrCreatedV1 = FusionEventVariant<"git.pr.created", {
+    projectId: string;
+    branchName: string;
+    branchId?: string;
+    provider: "github" | "gitlab" | "bitbucket" | "azure";
+    prNumber?: number | string;
 }, {}, 1>;
-export declare const GitPrCreatedEvent: {
+export declare const GitPrCreatedV1: {
     eventName: "git.pr.created";
     version: "1";
 };
+export type GitPrClosedV1 = FusionEventVariant<"git.pr.closed", {
+    projectId: string;
+    branchName: string;
+    branchId?: string;
+    provider: "github" | "gitlab" | "bitbucket" | "azure";
+    prNumber?: number | string;
+}, {}, 1>;
+export declare const GitPrClosedV1: {
+    eventName: "git.pr.closed";
+    version: "1";
+};
+export type GitPrMergedV1 = FusionEventVariant<"git.pr.merged", {
+    projectId: string;
+    branchName: string;
+    branchId?: string;
+    provider: "github" | "gitlab" | "bitbucket" | "azure";
+    prNumber?: number | string;
+}, {}, 1>;
+export declare const GitPrMergedV1: {
+    eventName: "git.pr.merged";
+    version: "1";
+};
+export type BotMentionExternalPrV1 = FusionEventVariant<"bot.mention.external-pr", {
+    projectId: string;
+    repoFullName: string;
+    prNumber: number;
+    comment: string;
+    commentLink?: string;
+    commentNumericId?: number;
+    commentIdStr: string;
+    deliveryId: string;
+    commentType: "issue" | "pr";
+    userName?: string;
+    gitUserId?: string;
+    hostname?: string;
+    prHeadRef?: string;
+    isFork?: boolean;
+    filePath?: string;
+    startLine?: number;
+    endLine?: number;
+    diffHunk?: string;
+    replyToCommentId?: number;
+    inReplyToCommentId?: number;
+    prTitle?: string;
+    authorAssociation?: string;
+}, {
+    projectId: string;
+}, 1>;
+export declare const BotMentionExternalPrV1: {
+    eventName: "bot.mention.external-pr";
+    version: "1";
+};
 export type ClientDevtoolsSessionStartedEvent = FusionEventVariant<"client.devtools.session.started", {
     sessionId?: string;
     sessionType?: string;
@@ -609,6 +663,76 @@ export declare const GitWebhooksRegisterV1: {
     eventName: "git.webhooks.register";
     version: "1";
 };
+export type FusionProjectSettingsUpdatedV1 = FusionEventVariant<"fusion.project.settings.updated", {
+    projectId: string;
+    changedFields: string[];
+}, {}, 1>;
+export declare const FusionProjectSettingsUpdatedV1: {
+    eventName: "fusion.project.settings.updated";
+    version: "1";
+};
+export type FusionBranchCreatedV1 = FusionEventVariant<"fusion.branch.created", {
+    projectId: string;
+    branchName: string;
+    branchFriendlyName?: string;
+    actor: string;
+}, {
+    projectId: string;
+    branchName: string;
+}, 1>;
+export declare const FusionBranchCreatedV1: {
+    eventName: "fusion.branch.created";
+    version: "1";
+};
+export type FusionBranchContainerStartedV1 = FusionEventVariant<"fusion.branch.container-started", {
+    projectId: string;
+    branchName: string;
+    url: string;
+}, {
+    projectId: string;
+    branchName: string;
+}, 1>;
+export declare const FusionBranchContainerStartedV1: {
+    eventName: "fusion.branch.container-started";
+    version: "1";
+};
+export type FusionBranchMessageSentV1 = FusionEventVariant<"fusion.branch.message-sent", {
+    projectId: string;
+    branchName: string;
+}, {
+    projectId: string;
+    branchName: string;
+}, 1>;
+export declare const FusionBranchMessageSentV1: {
+    eventName: "fusion.branch.message-sent";
+    version: "1";
+};
+export type FusionBranchFailedV1 = FusionEventVariant<"fusion.branch.failed", {
+    projectId: string;
+    branchName?: string;
+    error: string;
+    phase: string;
+}, {
+    projectId: string;
+    branchName?: string;
+}, 1>;
+export declare const FusionBranchFailedV1: {
+    eventName: "fusion.branch.failed";
+    version: "1";
+};
+export type VideoRecordingCompletedV1 = FusionEventVariant<"video.recording.completed", {
+    recordingId: string;
+    videoUrl: string;
+    thumbnailUrl?: string;
+    projectId: string | null;
+    branchName: string | null;
+}, {
+    recordingId: string;
+}, 1>;
+export declare const VideoRecordingCompletedV1: {
+    eventName: "video.recording.completed";
+    version: "1";
+};
 export interface SendMessageToOrgAgentInput {
     agentBranchName?: string;
     agentProjectId?: string;
@@ -629,7 +753,7 @@ export interface SendMessageToOrgAgentInput {
      */
     autoCreateProject?: boolean;
 }
-export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | GitPrCreatedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1;
+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 interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -6,10 +6,22 @@ export const AiTaskFailedEvent = {
     eventName: "ai.task.failed",
     version: "1",
 };
-export const GitPrCreatedEvent = {
+export const GitPrCreatedV1 = {
     eventName: "git.pr.created",
     version: "1",
 };
+export const GitPrClosedV1 = {
+    eventName: "git.pr.closed",
+    version: "1",
+};
+export const GitPrMergedV1 = {
+    eventName: "git.pr.merged",
+    version: "1",
+};
+export const BotMentionExternalPrV1 = {
+    eventName: "bot.mention.external-pr",
+    version: "1",
+};
 export const ClientDevtoolsSessionStartedEvent = {
     eventName: "client.devtools.session.started",
     version: "1",
@@ -46,3 +58,27 @@ export const GitWebhooksRegisterV1 = {
     eventName: "git.webhooks.register",
     version: "1",
 };
+export const FusionProjectSettingsUpdatedV1 = {
+    eventName: "fusion.project.settings.updated",
+    version: "1",
+};
+export const FusionBranchCreatedV1 = {
+    eventName: "fusion.branch.created",
+    version: "1",
+};
+export const FusionBranchContainerStartedV1 = {
+    eventName: "fusion.branch.container-started",
+    version: "1",
+};
+export const FusionBranchMessageSentV1 = {
+    eventName: "fusion.branch.message-sent",
+    version: "1",
+};
+export const FusionBranchFailedV1 = {
+    eventName: "fusion.branch.failed",
+    version: "1",
+};
+export const VideoRecordingCompletedV1 = {
+    eventName: "video.recording.completed",
+    version: "1",
+};

package/src/projects.d.ts

@@ -338,7 +338,7 @@ export interface SetupScriptDependency {
     script: string;
 }
 export type FusionExecutionEnvironment = "containerized" | "container-less" | "cloud" | "cloud-v2";
-export type AgentType = "setup-project" | "project-configuration" | "org-agent";
+export type AgentType = "setup-project" | "project-configuration" | "org-agent" | "code-review-orchestrator";
 export interface PartialBranchData {
     name?: string;
     createdBy: string;
@@ -675,6 +675,11 @@ export interface Project {
         httpsServerHonorCipherOrder?: boolean;
         httpsServerRequestCert?: boolean;
         httpsServerRejectUnauthorized?: boolean;
+        /**
+         * When true, this project is the preferred project for its connected repository.
+         * Agents will pick this project when asked to do something with the connected repository.
+         */
+        isPreferredForRepo?: boolean;
     };
     screenshot: string | null;
     isExample?: boolean;
@@ -706,6 +711,10 @@ export interface Project {
     orgAgentConfig?: OrgAgentConfig;
     /** When true, the project is hidden from normal project listings */
     hidden?: boolean;
+    /** Status of the auto-setup process */
+    autoSetupStatus?: "idle" | "running" | "needs-input" | "completed" | "error";
+    /** True only when the user has explicitly chosen auto-setup via the UI; never set by backend infrastructure */
+    userInitiatedAutoSetup?: boolean;
     /** When true, automatically apply verified setup configuration when the setup agent completes */
     autoApplySetup?: boolean;
 }

package/src/proxy.js

@@ -20,7 +20,9 @@ export function getProxyConfig({ devServerUrl, proxyOrigin, proxyDefaultOrigin,
         try {
             parsedUrl = new URL(devServerUrl);
         }
-        catch (_a) { }
+        catch (_a) {
+            // intentionally empty
+        }
     }
     if (!proxyOrigin && parsedUrl) {
         if (isLocalhost(parsedUrl.hostname)) {