@builder.io/ai-utils 0.23.2 → 0.24.0

package/package.json

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

package/src/codegen.d.ts

@@ -50,7 +50,7 @@ export interface CustomAgentDefinition {
 }
 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;
-export type CompletionStopReason = "max_tokens" | "stop_sequence" | "tool_use" | "end_turn" | "content_filter" | "error" | "aborted" | "pause_turn" | "refusal" | "model_context_window_exceeded" | null;
+export type CompletionStopReason = "max_tokens" | "stop_sequence" | "tool_use" | "end_turn" | "content_filter" | "error" | "aborted" | "pause_turn" | "refusal" | "compaction" | "model_context_window_exceeded" | null;
 export interface ReadToolInput {
     file_path: string;
     view_range?: [number, number];
@@ -64,6 +64,7 @@ export interface GrepSearchToolInput {
     query: string;
     include_glob?: string | null;
     exclude_glob?: string | null;
+    case_sensitive?: boolean | null;
 }
 export interface GetRuleToolInput {
     name: string;
@@ -81,7 +82,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;
@@ -214,6 +215,8 @@ export interface ExplorationMetadataToolInput {
         limit?: number;
     }[];
 }
+export interface EnterPlanModeToolInput {
+}
 export interface ExitPlanModeToolInput {
     plan: string;
     handled?: boolean;
@@ -283,15 +286,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;
+    dependencies?: Array<{
+        tool: string;
+        version?: string;
+    }>;
+}
+export interface VerifyDevCommandToolInput {
     command: string;
-    timeout?: number;
 }
 export interface VerifyDevServerToolInput {
-    command: string;
-    url: string;
-    port: number;
-    timeout?: number;
+    autoDetect: boolean;
+    autoDetectPattern?: string;
+    hardcodedUrl?: string;
+    appOrigin: string;
+    defaultOrigin?: string;
 }
 export interface VerifyValidationScriptToolInput {
     command: string;
@@ -302,6 +444,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 +458,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 +466,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 {
@@ -338,7 +488,7 @@ export interface ReportIssueToolInput {
     line: number;
     start_line?: number;
     title: string;
-    severity: "high" | "medium";
+    severity: "high" | "medium" | "low";
     body: string;
 }
 export interface CodeGenToolMap {
@@ -375,7 +525,7 @@ export interface CodeGenToolMap {
     Grep: GrepSearchToolInput;
     Glob: GlobSearchToolInput;
     DevServerControl: DevServerControlInput;
-    ServerLogs: ServerLogsInput;
+    DevServerLogs: DevServerLogsInput;
     Revert: RevertToolInput;
     TodoRead: TodoReadToolInput;
     TodoWrite: TodoWriteToolInput;
@@ -383,6 +533,7 @@ export interface CodeGenToolMap {
     LS: ListDirToolInput;
     WebFetch: WebFetchToolInput;
     ExplorationMetadata: ExplorationMetadataToolInput;
+    EnterPlanMode: EnterPlanModeToolInput;
     ExitPlanMode: ExitPlanModeToolInput;
     ReadMcpResource: ReadMcpResourceToolInput;
     RecordFrame: RecordFrameToolInput;
@@ -390,13 +541,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";
@@ -413,7 +567,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;
@@ -906,9 +1060,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;
@@ -1319,6 +1488,8 @@ export interface EnvironmentVariable {
     key: string;
     value: string;
     isSecret: boolean;
+    placeholder?: boolean;
+    explanation?: string;
 }
 export interface FileOverride {
     /**
@@ -1357,7 +1528,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) */
@@ -1549,6 +1720,8 @@ export interface LaunchServerStatus {
     containerState: "idle" | "busy";
     containerStateTimestamp: number;
     activeOperations: number;
+    diskUsage?: number;
+    memoryUsage?: number;
 }
 /**
  * VS Code Tunnel status information
@@ -1592,6 +1765,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,7 +609,7 @@ export interface Project {
             enabled: boolean;
             instructions?: string;
         };
-        createSnapshot?: boolean;
+        enableSnapshots?: boolean;
         postMergeMemories?: boolean;
         commitInstructions?: string;
         maxAgentCompletions?: number;