@builder.io/ai-utils 0.25.2 → 0.25.4

package/package.json

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

package/src/codegen.d.ts

@@ -276,17 +276,24 @@ export interface ProposeConfigToolInput {
     config: SetupAnalysisValues;
     message?: string;
 }
-export type SetupValueField = "installCommand" | "devServer" | "validationScript";
+export type SetupValueField = "installCommand" | "devServer" | "validationScript" | "environmentVariables";
 export interface UpdateSetupValueToolInput {
     field: SetupValueField;
     value: {
-        command: string;
+        command?: string;
         url?: string;
         port?: number;
+        environmentVariables?: Array<{
+            key: string;
+            description?: string;
+            isRequired?: boolean;
+            isSecret?: boolean;
+            defaultValue?: string | null;
+        }>;
     };
     reason: string;
 }
-export type ExitState = "verified" | "more-disk" | "more-memory" | "user-question" | "other";
+export type ExitState = "verified" | "more-disk" | "more-memory" | "user-question" | "other" | "started";
 export interface ExitToolInput {
     state: ExitState;
     summary: string;
@@ -554,7 +561,7 @@ export interface CodeGenToolMap {
 }
 export type CodeGenTools = keyof CodeGenToolMap;
 export type AllCodeGenTools = CodeGenTools | "web_search";
-export type SessionMode = "planning" | "normal" | "auto-planning";
+export type SessionMode = "planning" | "normal" | "auto-planning" | "deep-research";
 export type CodeGenMode = "quality" | "quality-v3" | "quality-v4" | "quality-v4-agent";
 export type BaseCodeGenPosition = "fusion" | "editor-ai" | "repo-indexing" | "cli" | "create-app-firebase" | "create-app-lovable" | "builder-code-panel" | "dsi-mcp";
 export type CodeGenPosition = BaseCodeGenPosition | `${BaseCodeGenPosition}-agent`;
@@ -1054,9 +1061,16 @@ export interface GenerateCompletionStepUpdateSetupValue {
     type: "update_setup_value";
     field: SetupValueField;
     value: {
-        command: string;
+        command?: string;
         url?: string;
         port?: number;
+        environmentVariables?: Array<{
+            key: string;
+            description?: string;
+            isRequired?: boolean;
+            isSecret?: boolean;
+            defaultValue?: string | null;
+        }>;
     };
     reason: string;
 }

package/src/events.d.ts

@@ -1,6 +1,7 @@
 import type { BuilderContent, BuilderElement } from "@builder.io/sdk";
 import type { AssistantMessage, AssistantMessageAction } from "./messages.js";
 import type { AssistantSettings } from "./settings.js";
+import type { ExitState } from "./codegen.js";
 export type BuilderAssistantEventHandler = (ev: BuilderAssistantEvent) => void;
 export type BuilderAssistantEvent = AssistantCompletionResultEvent | AssistantErrorEvent | AssistantStreamErrorEvent | AppCloseEvent | AppMessagesClickEvent | AppMessagesGenerationEvent | AppMessageEditCustomInstructionsEvent | AppPromptAbortEvent | AppPromptFocusEvent | AppPromptSubmitEvent | AppReadyEvent | AppSettingsSetEvent | AppThreadNewEvent | AssistantStatsEvent | AssistantThemeEvent | BuilderEditorAuthEvent | BuilderEditorStateEvent | ContentUpdateEvent | ContentApplySnapshotEvent | ModelUndoEvent | ModelRedoEvent | ResultEvent | ThreadCreatedEvent | ThreadMessageCompletedEvent | ThreadMessageCreatedEvent | ThreadMessageDeltaEvent | ThreadMessageFeedbackEvent | ThreadRunStepCreatedEvent | ThreadRunStepDeltaEvent | AppAcceptChangeEvent | AppAcceptRejectEvent | AssistantTrackEvent | AssistantEditorAuthMessage | AppAttachmentTemplateEvent | AppPasteSmartExportEvent | ThreadMessageRetryEvent | AppFigmaImportEvent | AppWebImportEvent | AppMcpServersEvent | AssistantContentInitialEvent | ThreadMessageSummaryEvent | ThreadMessageSummaryCodegenDeltaEvent | ThreadMessageThinkingDeltaEvent | AssistantHeartbeatEvent | ShowUpgradeDialogEvent | AssistantFusionSuggestionEvent | AppNavigateToFusionEvent;
 export interface AssistantCompletionResultEvent {
@@ -420,6 +421,10 @@ export interface AssistantFusionSuggestionEvent {
         message: string;
     };
 }
+interface Superuser {
+    isSuperUser: boolean;
+    permissions: string[];
+}
 export interface BaseFusionEvent<ExtraData extends Record<string, unknown> = {}, ExtraAttrs extends Record<string, string> = {}, V extends number = number> {
     data: {
         eventId: string;
@@ -427,6 +432,7 @@ export interface BaseFusionEvent<ExtraData extends Record<string, unknown> = {},
         timestamp: number;
         correlationId?: string;
         userId?: string;
+        superuser?: Superuser;
         source?: string;
         tags?: string[];
         audience?: string;
@@ -482,5 +488,25 @@ export declare const ClientDevtoolsSessionStartedEvent: {
     eventName: "client.devtools.session.started";
     version: "1";
 };
-export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | GitPrCreatedEvent | ClientDevtoolsSessionStartedEvent;
+export type FusionProjectCreatedV1 = FusionEventVariant<"fusion.project.created", {
+    projectId: string;
+    branchName?: string;
+    branchId?: string;
+}, {}, 1>;
+export declare const FusionProjectCreatedV1: {
+    eventName: "fusion.project.created";
+    version: "1";
+};
+export type SetupAgentCompletedV1 = FusionEventVariant<"fusion.setup.completed", {
+    proposedConfigId: string;
+    projectId: string;
+    branchName: string;
+    branchId?: string;
+    state: ExitState;
+}, {}, 1>;
+export declare const SetupAgentCompletedV1: {
+    eventName: "fusion.setup.completed";
+    version: "1";
+};
+export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | GitPrCreatedEvent | ClientDevtoolsSessionStartedEvent | FusionProjectCreatedV1 | SetupAgentCompletedV1;
 export {};

package/src/events.js

@@ -14,3 +14,11 @@ export const ClientDevtoolsSessionStartedEvent = {
     eventName: "client.devtools.session.started",
     version: "1",
 };
+export const FusionProjectCreatedV1 = {
+    eventName: "fusion.project.created",
+    version: "1",
+};
+export const SetupAgentCompletedV1 = {
+    eventName: "fusion.setup.completed",
+    version: "1",
+};

package/src/projects.d.ts

@@ -234,12 +234,16 @@ export interface GitBackupUploadUrlOptions {
     size: number;
     partial: boolean;
     contentMd5: string;
+    folderName?: string;
+    repoUrl?: string;
 }
 export interface GitBackupDownloadUrlOptions {
     ownerId: string;
     projectId: string;
     branchName: string;
     partial: boolean;
+    folderName?: string;
+    repoUrl?: string;
 }
 export type ForcedBackup = "offline-full" | "offline" | undefined;
 export interface GitBackupRecordOptions {
@@ -258,6 +262,7 @@ export interface GitBackupRecordOptions {
     version: "v1" | "v2";
     forced: ForcedBackup;
     metadata?: Record<string, string | string[] | undefined>;
+    folderName?: string;
 }
 export interface RecordScreenshotOptions {
     projectId: string;
@@ -267,6 +272,9 @@ export interface RecordScreenshotOptions {
     href?: string;
     meta?: Record<string, any>;
 }
+export type GitBackupRecordBody = GitBackupRecordOptions | {
+    backups: GitBackupRecordOptions[];
+};
 export interface GitBackupRecordResult {
     success: boolean;
 }
@@ -336,6 +344,7 @@ export interface PartialBranchData {
     lockedFusionEnvironment?: FusionExecutionEnvironment;
     metadata?: BranchMetadata;
     backup?: BranchBackup;
+    backups?: Record<string, BranchBackup>;
     hidden?: boolean;
     gitAiBranch?: string | null;
     lastCommitHash?: GitSnapshot | null;
@@ -394,7 +403,7 @@ export interface BranchReview {
     updatedAt: number;
 }
 export type BranchType = "code-review" | "setup-project";
-interface BranchSharedData {
+export interface BranchSharedData {
     appName?: string | null;
     prNumber?: number | null;
     prUrl?: string | null;
@@ -430,6 +439,7 @@ interface BranchSharedData {
         allocated: boolean | null;
     } | null;
     backup?: BranchBackup;
+    backups?: Record<string, BranchBackup>;
     metadata?: BranchMetadata;
     memoriesExtracted?: boolean;
     needsCleanup?: boolean;
@@ -541,6 +551,7 @@ export interface Project {
     pinned?: boolean;
     archived?: boolean;
     createdBy: string;
+    lastUpdateBy?: string;
     checkRunCounts?: Record<string, number>;
     repoAddedBy?: string;
     pipelineCounts?: Record<string, number>;