@builder.io/ai-utils 0.22.3 → 0.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.22.3",
+  "version": "0.23.0",
   "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;
@@ -425,7 +426,7 @@ export interface CodeGenInputOptions {
     rerankFiles?: number;
     toolResults?: ContentMessageItemToolResult[];
     attachments?: Attachment[];
-    beforeCommit?: string;
+    beforeCommit?: GitSnapshot;
     workingDirectory?: string;
     includeRelevantMemories?: boolean;
     encryptKey?: string;
@@ -840,7 +841,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 +915,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 +935,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 +1001,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 +1013,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 +1027,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 +1040,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>;
 }
@@ -1487,7 +1472,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 +1481,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/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.
@@ -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,7 +336,7 @@ export interface PartialBranchData {
     metadata?: BranchMetadata;
     backup?: BranchBackup;
     gitAiBranch?: string | null;
-    lastCommitHash?: string | null;
+    lastCommitHash?: GitSnapshot | null;
     lastCommitDate?: number | null;
     commitMode?: CommitMode;
     useHomeDir?: boolean;
@@ -354,6 +355,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 +400,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 +450,8 @@ 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>;
 }
 /**
  * fields that are required in the new branch format, but optional in the legacy branch format.