@builder.io/ai-utils 0.19.0 → 0.20.0

package/package.json

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

package/src/codegen.d.ts

@@ -301,21 +301,28 @@ export interface VerifyRuntimeDependencyToolInput {
     version: string;
     source?: string;
 }
-export interface AddQAReviewComment {
+/** Comment for PR review - used by both SubmitPRReview and SubmitRecording */
+export interface PRReviewComment {
     file_path: string;
     line: number;
     start_line?: number;
     title: string;
     body: string;
-    severity: "high" | "medium" | "low";
+    severity: "high" | "medium";
     debugInfo?: string;
     gif_id?: string;
 }
-export interface AddQAReviewToolInput {
+/** SubmitPRReview - Fast code review without recording */
+export interface SubmitPRReviewToolInput {
     summary: string;
-    comments?: AddQAReviewComment[];
+    comments?: PRReviewComment[];
+}
+/** SubmitRecording - Visual verification with recording (posted as separate review) */
+export interface SubmitRecordingToolInput {
     gif_id: string;
-    recording_caption?: string;
+    recording_caption: string;
+    summary?: string;
+    comments?: PRReviewComment[];
 }
 export interface ResolveQACommentsToolInput {
     thread_node_ids: string[];
@@ -370,9 +377,10 @@ export interface CodeGenToolMap {
     ExitPlanMode: ExitPlanModeToolInput;
     ReadMcpResource: ReadMcpResourceToolInput;
     RecordFrame: RecordFrameToolInput;
+    SubmitPRReview: SubmitPRReviewToolInput;
+    SubmitRecording: SubmitRecordingToolInput;
     ProposeConfig: ProposeConfigToolInput;
     UpdateSetupValue: UpdateSetupValueToolInput;
-    AddQAReview: AddQAReviewToolInput;
     ResolveQAComments: ResolveQACommentsToolInput;
     ReportUIIssue: ReportUIIssueToolInput;
     VerifyInstallCommand: VerifyInstallCommandToolInput;
@@ -957,7 +965,7 @@ export interface GenerateUserMessage {
     includeRelevantMemories?: boolean;
     category?: CodeGenCategory;
     metadata?: Record<string, any>;
-    autoPush?: "force-push" | "merge-push" | "ff-push" | "none";
+    autoPush?: "force-push" | "merge-push" | "ff-push" | "safe-push" | "none";
     syncChanges?: SyncChangesFromRemote;
     enabledMCPs?: string[];
     sessionMode?: SessionMode;
@@ -1593,6 +1601,10 @@ export interface PushChangesOptions {
     };
     /** If specified, only push changes for this folder (multi-repo support) */
     folderName?: string;
+    /** If true, abort and clean up if merge conflict is detected during pull */
+    abortOnMergeConflict?: boolean;
+    /** If true, verify fast-forward is possible before pushing, fail if not */
+    requireFastForward?: boolean;
 }
 export interface SyncChangesFromRemote {
     remoteBranches?: "both" | "main" | "ai";
@@ -1846,3 +1858,27 @@ export interface LaunchInitializeSessionOptions {
     customInstructions?: CustomInstruction[];
     privacyMode?: PrivacyMode;
 }
+/**
+ * Request for generating a commit message via LLM
+ */
+export interface CommitMessageRequest {
+    /** Git diff from previous commit */
+    diff: string;
+    /** User messages sent during AI work */
+    userMessages: string[];
+    /** Last 10 commits from main branch for style reference */
+    recentCommits: string[];
+    /** Whether to generate a long commit message */
+    longCommit?: boolean;
+}
+/**
+ * Response from commit message generation
+ */
+export interface CommitMessageResponse {
+    /** Full commit message */
+    message: string;
+    /** First line (50-72 chars) - the commit title */
+    title: string;
+    /** Optional extended description */
+    body?: string;
+}

package/src/projects.d.ts

@@ -272,7 +272,7 @@ export type FusionExecutionEnvironment = "containerized" | "container-less" | "c
 export interface PartialBranchData {
     name?: string;
     createdBy: string;
-    friendlyName: string;
+    friendlyName?: string;
     isDefault: boolean;
     isPublic: boolean;
     lockedFusionEnvironment?: FusionExecutionEnvironment;
@@ -323,6 +323,13 @@ export interface BranchMetadata {
     [key: string]: unknown;
 }
 export type PRStatus = "open" | "closed" | "merged" | "draft" | "approved";
+export interface BranchReview {
+    userId: string;
+    status: "approved" | "changes_requested" | "commented" | "pending";
+    comment?: string | null;
+    createdAt: number;
+    updatedAt: number;
+}
 interface BranchSharedData {
     appName?: string | null;
     prNumber?: number | null;
@@ -348,6 +355,8 @@ interface BranchSharedData {
     friendlyName?: string;
     useHomeDir?: boolean;
     useCloudHomeDir?: boolean;
+    reviewers?: string[] | null;
+    reviews?: BranchReview[] | null;
     ipv4?: {
         address: string | null;
         allocated: boolean | null;