@builder.io/ai-utils 0.23.1 → 0.23.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.23.1",
+  "version": "0.23.3",
   "description": "Builder.io AI utils",
   "type": "module",
   "main": "src/index.js",

package/src/codegen.d.ts

@@ -81,7 +81,7 @@ export interface DevServerControlInput {
     set_and_run_setup_command?: string | null;
     set_env_variable?: [string, string] | null;
 }
-export interface ServerLogsInput {
+export interface DevServerLogsInput {
 }
 export interface BashToolInput {
     command?: string | null;
@@ -283,15 +283,154 @@ export interface UpdateSetupValueToolInput {
     };
     reason: string;
 }
-export interface VerifyInstallCommandToolInput {
+export type ExitState = "verified" | "more-disk" | "more-memory" | "user-question" | "other";
+export interface ExitToolInput {
+    state: ExitState;
+    summary: string;
+    questions?: Array<{
+        question: string;
+        context: string;
+        header?: string;
+        options?: Array<{
+            label: string;
+            description: string;
+        }>;
+        multiSelect?: boolean;
+    }>;
+    isMonorepo?: boolean;
+    isMicrofrontend?: boolean;
+    setupNeedsCredentials?: boolean;
+    devServerNeedsCredentials?: boolean;
+}
+/**
+ * Configuration proposed by the configuration agent, stored in Firebase
+ */
+export interface ProposedConfig {
+    id: string;
+    projectId: string;
+    branchName: string;
+    createdAt: number;
+    updatedAt: number;
+    ownerId: string;
+    state: ExitState;
+    summary: string;
+    questions?: Array<{
+        question: string;
+        context: string;
+        whatYouTried?: string;
+        header?: string;
+        options?: Array<{
+            label: string;
+            description: string;
+        }>;
+        multiSelect?: boolean;
+    }>;
+    configuration: {
+        setupCommand: {
+            value: string | undefined;
+            verified: boolean;
+            elapsed?: number;
+        };
+        setupDependencies: {
+            value: SetupDependency[] | undefined;
+            verified: boolean;
+        };
+        devCommand: {
+            value: string | undefined;
+            verified: boolean;
+            elapsed?: number;
+        };
+        devServer: {
+            value: string | undefined;
+            verified: boolean;
+        };
+        validateCommand: {
+            value: string | undefined;
+            verified: boolean;
+            elapsed?: number;
+        };
+        appOrigin: {
+            value: string | undefined;
+            verified: boolean;
+        };
+        defaultOrigin: {
+            value: string | undefined;
+            verified: boolean;
+        };
+        environmentVariables: {
+            value: EnvironmentVariable[] | undefined;
+            verified: boolean;
+        };
+        autoDetectDevServer: {
+            value: boolean | undefined;
+            verified: boolean;
+        };
+        autoDetectDevServerPatterns: {
+            value: string[] | undefined;
+            verified: boolean;
+        };
+    };
+    sessionId: string;
+    orchestratorStates: {
+        setupState: SetupCommandState;
+        devState: DevCommandState;
+        httpServerState: HttpServerState;
+        validateState: ValidateCommandState;
+    };
+    peakDiskUsage?: number;
+    peakMemoryUsage?: number;
+    screenshotUrl?: string;
+    isMonorepo?: boolean;
+    isMicrofrontend?: boolean;
+    setupNeedsCredentials?: boolean;
+    devServerNeedsCredentials?: boolean;
+}
+/**
+ * Parameters for proposing a configuration to the backend
+ */
+export interface ProposeConfigParams {
+    projectId: string;
+    branchName: string;
+    state: ExitState;
+    summary: string;
+    questions?: Array<{
+        question: string;
+        context: string;
+        whatYouTried?: string;
+        header?: string;
+        options?: Array<{
+            label: string;
+            description: string;
+        }>;
+        multiSelect?: boolean;
+    }>;
+    configuration: ProposedConfig["configuration"];
+    sessionId: string;
+    orchestratorStates: ProposedConfig["orchestratorStates"];
+    peakDiskUsage?: number;
+    peakMemoryUsage?: number;
+    screenshotUrl?: string;
+    isMonorepo?: boolean;
+    isMicrofrontend?: boolean;
+    setupNeedsCredentials?: boolean;
+    devServerNeedsCredentials?: boolean;
+}
+export interface VerifySetupCommandToolInput {
     command: string;
-    timeout?: number;
+    dependencies?: Array<{
+        tool: string;
+        version?: string;
+    }>;
 }
-export interface VerifyDevServerToolInput {
+export interface VerifyDevCommandToolInput {
     command: string;
-    url: string;
-    port: number;
-    timeout?: number;
+}
+export interface VerifyDevServerToolInput {
+    autoDetect: boolean;
+    autoDetectPattern?: string;
+    hardcodedUrl?: string;
+    appOrigin: string;
+    defaultOrigin?: string;
 }
 export interface VerifyValidationScriptToolInput {
     command: string;
@@ -302,6 +441,13 @@ export interface VerifyRuntimeDependencyToolInput {
     version: string;
     source?: string;
 }
+export interface SetEnvVariableToolInput {
+    key: string;
+    value: string;
+    secret?: boolean;
+    placeholder?: boolean;
+    explanation?: string;
+}
 /** Comment for PR review - used by both SubmitPRReview and SubmitRecording */
 export interface PRReviewComment {
     file_path: string;
@@ -309,7 +455,7 @@ export interface PRReviewComment {
     start_line?: number;
     title: string;
     body: string;
-    severity: "high" | "medium";
+    severity: "high" | "medium" | "low";
     debugInfo?: string;
     gif_id?: string;
 }
@@ -317,6 +463,7 @@ export interface PRReviewComment {
 export interface SubmitPRReviewToolInput {
     summary: string;
     comments?: PRReviewComment[];
+    risk_level?: "high" | "medium" | "low";
 }
 /** SubmitRecording - Visual verification with recording (posted as separate review) */
 export interface SubmitRecordingToolInput {
@@ -336,8 +483,9 @@ export interface ReportUIIssueToolInput {
 export interface ReportIssueToolInput {
     file_path: string;
     line: number;
+    start_line?: number;
     title: string;
-    severity: "high" | "medium";
+    severity: "high" | "medium" | "low";
     body: string;
 }
 export interface CodeGenToolMap {
@@ -374,7 +522,7 @@ export interface CodeGenToolMap {
     Grep: GrepSearchToolInput;
     Glob: GlobSearchToolInput;
     DevServerControl: DevServerControlInput;
-    ServerLogs: ServerLogsInput;
+    DevServerLogs: DevServerLogsInput;
     Revert: RevertToolInput;
     TodoRead: TodoReadToolInput;
     TodoWrite: TodoWriteToolInput;
@@ -389,13 +537,16 @@ export interface CodeGenToolMap {
     SubmitRecording: SubmitRecordingToolInput;
     ProposeConfig: ProposeConfigToolInput;
     UpdateSetupValue: UpdateSetupValueToolInput;
+    Exit: ExitToolInput;
     ResolveQAComments: ResolveQACommentsToolInput;
     ReportUIIssue: ReportUIIssueToolInput;
     ReportIssue: ReportIssueToolInput;
-    VerifyInstallCommand: VerifyInstallCommandToolInput;
+    VerifySetupCommand: VerifySetupCommandToolInput;
+    VerifyDevCommand: VerifyDevCommandToolInput;
     VerifyDevServer: VerifyDevServerToolInput;
     VerifyValidationScript: VerifyValidationScriptToolInput;
     VerifyRuntimeDependency: VerifyRuntimeDependencyToolInput;
+    SetEnvVariable: SetEnvVariableToolInput;
 }
 export type CodeGenTools = keyof CodeGenToolMap;
 export type AllCodeGenTools = CodeGenTools | "web_search";
@@ -412,7 +563,7 @@ export interface LocalMCPTools {
     inputSchema?: any;
     serverName: string;
 }
-export type CodeGenCategory = `repair-${string}` | `user-normal` | `user-figma` | `user-pdf` | `user-image` | `background-${string}` | `indexing-${string}`;
+export type CodeGenCategory = `repair-${string}` | `user-normal` | `user-figma` | `user-pdf` | `user-image` | `setup-agent` | `background-${string}` | `indexing-${string}`;
 export interface CodeGenInputOptions {
     position: string;
     eventName?: string;
@@ -905,9 +1056,24 @@ export interface GenerateCompletionStepUpdateSetupValue {
     };
     reason: string;
 }
+export interface GenerateCompletionStepExit {
+    type: "exit";
+    state: ExitState;
+    summary: string;
+    questions: Array<{
+        question: string;
+        context: string;
+        header?: string;
+        options?: Array<{
+            label: string;
+            description: string;
+        }>;
+        multiSelect?: boolean;
+    }>;
+}
 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);
+} & (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 | GenerateCompletionStepExit);
 export interface ApplyActionsResult {
     filePath: string;
     addedLines: number;
@@ -1318,6 +1484,8 @@ export interface EnvironmentVariable {
     key: string;
     value: string;
     isSecret: boolean;
+    placeholder?: boolean;
+    explanation?: string;
 }
 export interface FileOverride {
     /**
@@ -1356,7 +1524,7 @@ export interface FusionConfig {
     sessionId?: string;
     browserAutomationInstructions?: string;
     /** Whether this branch is for a code review - affects enabled agents and tools */
-    branchType?: "code-review";
+    branchType?: "code-review" | "setup-project";
     featureBranch?: string;
     aiBranch?: string;
     /** Whether this is a fork PR - affects git operations (read-only, can't push) */
@@ -1462,6 +1630,8 @@ export interface FusionConfig {
      * Errors matching these patterns will not show the error popup.
      */
     errorIgnorePatterns?: string[];
+    /** When true, sync the git working tree to the latest remote state during init */
+    syncBranch?: boolean;
     /**
      * Maximum number of agent completions before pausing to ask the user to continue.
      * Read from project settings, with fallback to organization/space settings.
@@ -1496,7 +1666,7 @@ export interface LoadHistoryResult {
     updatedUnixTime: number;
     turns: CodegenTurn[];
 }
-export type InitStateStep = "initial" | "init" | "validation" | "check-directories" | "create-directories" | "configure-git-repos" | "check-existing-git" | "update-remote-url" | "clone-repo" | "apply-partial-backup" | "configure-git-user" | "stash-changes" | "collect-repo-info" | "init-success" | "init-command" | "init-failed";
+export type InitStateStep = "initial" | "init" | "validation" | "check-directories" | "create-directories" | "configure-git-repos" | "check-existing-git" | "update-remote-url" | "clone-repo" | "apply-partial-backup" | "configure-git-user" | "stash-changes" | "collect-repo-info" | "init-success" | "init-command" | "init-failed" | "snapshot-git-sync";
 export interface InitStatusLog {
     id: number;
     timestamp: string;
@@ -1546,6 +1716,8 @@ export interface LaunchServerStatus {
     containerState: "idle" | "busy";
     containerStateTimestamp: number;
     activeOperations: number;
+    diskUsage?: number;
+    memoryUsage?: number;
 }
 /**
  * VS Code Tunnel status information
@@ -1589,6 +1761,10 @@ export interface FusionStatus {
     eventLoopDelays?: number[];
     /** Max memory pressure observed in the reporting period (0-1, where 1 is near OOM) */
     memoryPressure?: number;
+    /** Current disk usage as a ratio (0-1, where 1 is full) */
+    diskUsage?: number;
+    /** Current memory usage as a ratio (0-1, where 1 is fully used) */
+    memoryUsage?: number;
 }
 export interface FusionMetrics {
     counters: {

package/src/events.d.ts

@@ -15,6 +15,7 @@ export interface AssistantError {
     message: string;
     status?: number;
     actions?: AssistantMessageAction[];
+    details?: string;
 }
 export interface AssistantErrorEvent {
     type: "assistant.error";

package/src/messages.d.ts

@@ -245,6 +245,10 @@ export interface AssistantMessageParam {
      * typically used when there is an error.
      */
     actions?: AssistantMessageAction[];
+    /**
+     * Technical details for expandable view in error messages.
+     */
+    details?: string;
 }
 export interface SystemMessage extends SystemMessageParam {
     id: string;

package/src/projects.d.ts

@@ -326,6 +326,7 @@ export interface SetupScriptDependency {
     script: string;
 }
 export type FusionExecutionEnvironment = "containerized" | "container-less" | "cloud" | "cloud-v2";
+export type AgentType = "setup-project" | "project-configuration";
 export interface PartialBranchData {
     name?: string;
     createdBy: string;
@@ -335,16 +336,18 @@ export interface PartialBranchData {
     lockedFusionEnvironment?: FusionExecutionEnvironment;
     metadata?: BranchMetadata;
     backup?: BranchBackup;
+    hidden?: boolean;
     gitAiBranch?: string | null;
     lastCommitHash?: GitSnapshot | null;
     lastCommitDate?: number | null;
     commitMode?: CommitMode;
     useHomeDir?: boolean;
+    agentType?: AgentType;
     checkoutBranch?: string | null;
     /** Whether this branch is for a fork PR - affects git operations (read-only, can't push) */
     isFork?: boolean | null;
     /** Whether this branch is for a code review - affects enabled agents and tools*/
-    type?: "code-review" | null;
+    type?: BranchType | null;
     cloneFrom?: {
         projectId: string;
         branchName: string;
@@ -390,6 +393,7 @@ export interface BranchReview {
     createdAt: number;
     updatedAt: number;
 }
+export type BranchType = "code-review" | "setup-project";
 interface BranchSharedData {
     appName?: string | null;
     prNumber?: number | null;
@@ -408,7 +412,7 @@ interface BranchSharedData {
     lastServerStateDate?: number | null;
     lastServerVersion?: string | null;
     name?: string;
-    agentType?: string | null;
+    hidden?: boolean;
     createdBy?: string;
     isPublic?: boolean;
     isDefault?: boolean;
@@ -455,7 +459,8 @@ interface BranchSharedData {
     /** Screenshots indexed by normalized href (without query params, fragments, protocol) */
     screenshots?: Record<string, string>;
     /** Whether this branch is for a code review - affects enabled agents and tools */
-    type?: "code-review" | null;
+    type?: BranchType | null;
+    agentType?: AgentType | null;
 }
 /**
  * fields that are required in the new branch format, but optional in the legacy branch format.
@@ -604,6 +609,7 @@ export interface Project {
             enabled: boolean;
             instructions?: string;
         };
+        enableSnapshots?: boolean;
         postMergeMemories?: boolean;
         commitInstructions?: string;
         maxAgentCompletions?: number;