@builder.io/ai-utils 0.22.3 → 0.23.1

package/package.json

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

package/src/codegen.d.ts

@@ -5,6 +5,7 @@ import type { UserContext } from "./mapping";
 import type { ForcedBackup, SetupDependency, GitDiagnostics } from "./projects";
 import type { Feature } from "./features";
 import type { CpuKind } from "./projects";
+export type GitSnapshot = unknown;
 export type ImportType = "named" | "default";
 export interface ESMImport {
     importName: string;
@@ -332,6 +333,13 @@ export interface ReportUIIssueToolInput {
     description: string;
     debugInfo?: string;
 }
+export interface ReportIssueToolInput {
+    file_path: string;
+    line: number;
+    title: string;
+    severity: "high" | "medium";
+    body: string;
+}
 export interface CodeGenToolMap {
     view_path: ReadToolInput;
     glob_search: GlobSearchToolInput;
@@ -383,6 +391,7 @@ export interface CodeGenToolMap {
     UpdateSetupValue: UpdateSetupValueToolInput;
     ResolveQAComments: ResolveQACommentsToolInput;
     ReportUIIssue: ReportUIIssueToolInput;
+    ReportIssue: ReportIssueToolInput;
     VerifyInstallCommand: VerifyInstallCommandToolInput;
     VerifyDevServer: VerifyDevServerToolInput;
     VerifyValidationScript: VerifyValidationScriptToolInput;
@@ -425,7 +434,7 @@ export interface CodeGenInputOptions {
     rerankFiles?: number;
     toolResults?: ContentMessageItemToolResult[];
     attachments?: Attachment[];
-    beforeCommit?: string;
+    beforeCommit?: GitSnapshot;
     workingDirectory?: string;
     includeRelevantMemories?: boolean;
     encryptKey?: string;
@@ -840,7 +849,7 @@ export interface CustomInstructionDefinition {
 export interface GenerateCompletionStepSession {
     type: "session";
     title: string | undefined;
-    beforeCommit: string | undefined;
+    beforeCommit: GitSnapshot | undefined;
     createdUnixTime: number;
     updatedUnixTime: number;
     id: string;
@@ -914,13 +923,18 @@ export interface UserSourceBase {
     jobs?: string[];
     permissions?: UserSourcePermission[];
 }
+/** All integration sources: Slack, Teams, Jira, Linear, and git providers (GitHub, GitLab, Azure, Bitbucket). */
 export interface UserSourceOther extends UserSourceBase {
-    source: "slack" | "teams" | "jira" | "linear";
-    /** User ID from the external platform (Slack user ID, Jira account ID, etc.) */
+    source: "slack" | "teams" | "jira" | "linear" | "github" | "gitlab" | "azure" | "bitbucket";
+    /** User ID from the external platform (Slack user ID, GitHub user id, etc.) */
     userId?: string;
     userName?: string;
     userEmail?: string;
     photoURL?: string;
+    /** Resolved Builder user ID for attribution/credits */
+    builderUserId?: string;
+    /** Optional link (e.g. comment/PR URL) for git provider sources */
+    link?: string;
 }
 export interface UserSourceBuilder extends UserSourceBase {
     source: "builder.io";
@@ -929,31 +943,10 @@ export interface UserSourceBuilder extends UserSourceBase {
     userEmail?: string;
     photoURL?: string;
 }
-export interface UserSourceGithub extends UserSourceBase {
-    source: "github";
-    userName: string;
-    userEmail?: string;
-    link?: string;
-}
-export interface UserSourceGitlab extends UserSourceBase {
-    source: "gitlab";
-    userName: string;
-    link?: string;
-}
-export interface UserSourceAzure extends UserSourceBase {
-    source: "azure";
-    userName: string;
-    link?: string;
-}
-export interface UserSourceBitbucket extends UserSourceBase {
-    source: "bitbucket";
-    userName: string;
-    link?: string;
-}
 export interface UserSourceAgent extends UserSourceBase {
     source: "agent";
 }
-export type UserSource = UserSourceOther | UserSourceBuilder | UserSourceGithub | UserSourceGitlab | UserSourceAzure | UserSourceBitbucket | UserSourceAgent;
+export type UserSource = UserSourceOther | UserSourceBuilder | UserSourceAgent;
 export interface GenerateUserMessage {
     idempotencyKey?: string;
     user?: UserSource;
@@ -1016,9 +1009,9 @@ export interface CodegenTurn {
     sentiment: "positive" | "negative" | "undo" | undefined;
     applyResults: ApplyActionsResult[];
     userMessage: GenerateUserMessage | undefined;
-    beforeCommit: string | undefined;
-    afterCommit: string | undefined;
-    lastCommit: string | undefined;
+    beforeCommit: GitSnapshot | undefined;
+    afterCommit: GitSnapshot | undefined;
+    lastCommit: GitSnapshot | undefined;
     cachedToolResults?: ContentMessageItemToolResult[];
     autoContinue: boolean;
 }
@@ -1028,7 +1021,7 @@ export interface GetSessionTurnsResult {
     lastCompletionId: string | undefined;
     sessionId: string;
     initialUrl: string | undefined;
-    beforeCommit: string | undefined;
+    beforeCommit: GitSnapshot | undefined;
     title: string | undefined;
     createdUnixTime: number | undefined;
     updatedUnixTime: number | undefined;
@@ -1042,8 +1035,8 @@ export interface CodegenFeedback {
     feedbackSentiment?: string;
     framework?: string;
     acceptedLines?: number;
-    beforeCommit?: string;
-    afterCommit?: string;
+    beforeCommit?: GitSnapshot;
+    afterCommit?: GitSnapshot;
     linesOfCodeAdded?: number;
     linesOfCodeRemoved?: number;
     commitFailed?: boolean;
@@ -1055,9 +1048,9 @@ export interface CodegenFinalize {
     projectId?: string;
     branchName?: string;
     userCompletionId?: string;
-    beforeCommit?: string;
-    afterCommit?: string;
-    lastCommit?: string;
+    beforeCommit?: GitSnapshot;
+    afterCommit?: GitSnapshot;
+    lastCommit?: GitSnapshot;
     commitFailed?: boolean;
     metadata?: Record<string, any>;
 }
@@ -1362,6 +1355,8 @@ export interface FusionConfig {
     branchName?: string;
     sessionId?: string;
     browserAutomationInstructions?: string;
+    /** Whether this branch is for a code review - affects enabled agents and tools */
+    branchType?: "code-review";
     featureBranch?: string;
     aiBranch?: string;
     /** Whether this is a fork PR - affects git operations (read-only, can't push) */
@@ -1487,7 +1482,7 @@ export interface LoadWholeSessionOptions {
 export interface LoadWholeSessionResult {
     sessionId: string;
     title: string | undefined;
-    beforeCommit: string | undefined;
+    beforeCommit: GitSnapshot | undefined;
     createdUnixTime: number;
     updatedUnixTime: number;
     addedTurns: number;
@@ -1496,7 +1491,7 @@ export interface LoadWholeSessionResult {
 export interface LoadHistoryResult {
     sessionId: string;
     title: string | undefined;
-    beforeCommit: string | undefined;
+    beforeCommit: GitSnapshot | undefined;
     createdUnixTime: number;
     updatedUnixTime: number;
     turns: CodegenTurn[];

package/src/organization.d.ts

@@ -197,7 +197,7 @@ export interface AiCreditsRolloverInfo {
 }
 export type PaymentError = "failed" | "unpaid" | "incomplete" | "incomplete_expired";
 export interface CustomPlan extends SubscriptionInfo {
-    organizationId: string;
+    ownerId: string;
     plan: keyof SubscriptionInfoMap;
     id: string;
 }

package/src/projects.d.ts

@@ -1,5 +1,5 @@
 import type { ConnectivityErrorCode, CheckType, LikelyCause } from "./connectivity/types.js";
-import type { FileOverride, EnvironmentVariable, LaunchServerState, LaunchServerStatus, BranchBackup, CommitMode, CustomInstruction, CustomAgentDefinition } from "./codegen";
+import type { FileOverride, EnvironmentVariable, LaunchServerState, LaunchServerStatus, BranchBackup, CommitMode, CustomInstruction, CustomAgentDefinition, GitSnapshot } from "./codegen";
 import type { FallbackTokensPrivate } from "./organization";
 /**
  * Temporary type for date fields during migration.
@@ -236,7 +236,7 @@ export interface GitBackupUploadUrlOptions {
     contentMd5: string;
 }
 export interface GitBackupDownloadUrlOptions {
-    spaceId: string;
+    ownerId: string;
     projectId: string;
     branchName: string;
     partial: boolean;
@@ -264,6 +264,7 @@ export interface RecordScreenshotOptions {
     branchName: string;
     completionId?: string;
     screenshotUrl: string;
+    href?: string;
     meta?: Record<string, any>;
 }
 export interface GitBackupRecordResult {
@@ -272,13 +273,13 @@ export interface GitBackupRecordResult {
 export interface CodegenSetLastCommit {
     projectId: string;
     branchName: string;
-    lastCommitHash: string;
+    lastCommitHash: GitSnapshot;
     clearSecondaryVolumeId: boolean;
 }
 export interface CodegenRuntimeStatus {
     projectId: string;
     branchName: string;
-    lastCommitHash?: string;
+    lastCommitHash?: GitSnapshot;
     clearSecondaryVolumeId?: boolean;
     lastServerState?: LaunchServerState;
     lastServerVersion?: string;
@@ -335,13 +336,15 @@ export interface PartialBranchData {
     metadata?: BranchMetadata;
     backup?: BranchBackup;
     gitAiBranch?: string | null;
-    lastCommitHash?: string | null;
+    lastCommitHash?: GitSnapshot | null;
     lastCommitDate?: number | null;
     commitMode?: CommitMode;
     useHomeDir?: boolean;
     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;
     cloneFrom?: {
         projectId: string;
         branchName: string;
@@ -354,6 +357,7 @@ export type EntityState = "active" | "deleted" | "archived";
 export interface PrInfo {
     prNumber: number;
     prUrl: string;
+    status: PRStatus;
 }
 /**
  * Metadata stored in branches for integration tracking and PR description generation.
@@ -398,7 +402,7 @@ interface BranchSharedData {
     secondaryVolumeId?: string | null;
     volumeName?: string | null;
     gitAiBranch?: string | null;
-    lastCommitHash?: string | null;
+    lastCommitHash?: GitSnapshot | null;
     lastCommitDate?: number | null;
     lastServerState?: LaunchServerState | null;
     lastServerStateDate?: number | null;
@@ -448,6 +452,10 @@ interface BranchSharedData {
     /** Whether the branch has unpushed changes (ahead > 0 or dirty working directory) */
     hasUnpushedChanges?: boolean;
     screenshot?: string | null;
+    /** 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;
 }
 /**
  * fields that are required in the new branch format, but optional in the legacy branch format.
@@ -687,4 +695,16 @@ export interface CreateProjectOptions {
     isExample?: boolean;
     templateId?: string;
 }
+export interface BuilderMyContext {
+    success: boolean;
+    projectId: string;
+    branchName: string;
+    branchId: string | null;
+    organizationId: string | null;
+    isEnterprise: boolean;
+    passwordProtection: {
+        enabled: boolean;
+    };
+    error?: string;
+}
 export {};