@builder.io/ai-utils 0.25.3 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.25.3",
+  "version": "0.26.0",
   "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;
@@ -967,6 +974,7 @@ export interface GenerateCompletionStepGit {
     hasGeneratingPlaceholder: boolean;
     remoteBranchExists: boolean;
     remoteBranchHasChanges: boolean;
+    hasStagedChanges: boolean;
     canPush: boolean;
     canPull: boolean;
     canSync: boolean;
@@ -1054,30 +1062,22 @@ 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;
 }
-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 | GenerateCompletionStepExit);
+} & (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);
 export interface ApplyActionsResult {
     filePath: string;
     addedLines: number;
@@ -1117,6 +1117,7 @@ export interface UserSourceAgent extends UserSourceBase {
     source: "agent";
 }
 export type UserSource = UserSourceOther | UserSourceBuilder | UserSourceAgent;
+export type AutoPushMode = "force-push" | "merge-push" | "ff-push" | "safe-push" | "none";
 export interface GenerateUserMessage {
     idempotencyKey?: string;
     user?: UserSource;
@@ -1137,7 +1138,7 @@ export interface GenerateUserMessage {
     includeRelevantMemories?: boolean;
     category?: CodeGenCategory;
     metadata?: Record<string, any>;
-    autoPush?: "force-push" | "merge-push" | "ff-push" | "safe-push" | "none";
+    autoPush?: AutoPushMode;
     syncChanges?: SyncChangesFromRemote;
     enabledMCPs?: string[];
     sessionMode?: SessionMode;
@@ -1516,6 +1517,7 @@ export interface FusionConfig {
     setupCommand?: string;
     validateCommand?: string;
     fusionServerPort?: number;
+    autoPush?: AutoPushMode;
     lockFile?: {
         filePath: string;
         conflictBehavior: "replace" | "exit" | "kill";

package/src/connectivity/checks/http-check.d.ts

@@ -1,8 +1,9 @@
-import type { CheckResult, Source, TestId } from "../types.js";
+import type { CheckResult, Source, TestId, ConnectivityFetchFn } from "../types.js";
 export interface HttpCheckOptions {
     target: string;
     source: Source;
     testId: TestId;
     timeout?: number;
+    fetchFn?: ConnectivityFetchFn;
 }
 export declare function httpCheck(options: HttpCheckOptions): Promise<CheckResult>;

package/src/connectivity/checks/http-check.js

@@ -2,12 +2,12 @@ import { mapHttpStatusToErrorCode, mapFetchErrorToConnectivityCode, } from "../e
 const DEFAULT_TIMEOUT_MS = 30000;
 const LATENCY_THRESHOLD_MS = 5000;
 export async function httpCheck(options) {
-    const { target, source, testId, timeout = DEFAULT_TIMEOUT_MS } = options;
+    const { target, source, testId, timeout = DEFAULT_TIMEOUT_MS, fetchFn = fetch, } = options;
     const startTime = Date.now();
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout);
     try {
-        const response = await fetch(target, {
+        const response = await fetchFn(target, {
             method: "HEAD",
             signal: controller.signal,
             redirect: "follow",

package/src/connectivity/node.d.ts

@@ -1,4 +1,4 @@
-export type { Source, TestId, Test, RunChecksInput, ProgressEvent, CheckResult, CheckReport, ConnectivityErrorCode, CheckType, Recommendation, LikelyCause, ConnectivityStatus, AnalysisResult, AnalyzeConnectivityInput, } from "./types.js";
+export type { Source, TestId, Test, RunChecksInput, ProgressEvent, CheckResult, CheckReport, ConnectivityErrorCode, CheckType, Recommendation, LikelyCause, ConnectivityStatus, AnalysisResult, AnalyzeConnectivityInput, ConnectivityFetchFn, } from "./types.js";
 export { runChecks } from "./run-checks.js";
 export { mapNodeErrorToConnectivityCode, mapHttpStatusToErrorCode, mapFetchErrorToConnectivityCode, connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, SELF_SIGNED_CERT_ERRORS, CERT_EXPIRED_ERRORS, CERT_NOT_YET_VALID_ERRORS, CERT_INVALID_ERRORS, CERT_HOSTNAME_MISMATCH_ERRORS, SSL_PROTOCOL_ERRORS, SSL_HANDSHAKE_ERRORS, NETWORK_UNREACHABLE_ERRORS, TIMEOUT_ERRORS, PROXY_ERRORS, DNS_ERRORS, } from "./error-codes.js";
 export { BUILDER_TARGETS, DEFAULT_PORTS, resolveTarget, extractHostname, extractPort, } from "./targets.js";

package/src/connectivity/run-checks.js

@@ -6,7 +6,7 @@ import { tcpCheck } from "./checks/tcp-check.js";
 import { tlsCheck } from "./checks/tls-check.js";
 import { sshCheck } from "./checks/ssh-check.js";
 export async function runChecks(input) {
-    const { tests, gitHost, onProgress } = input;
+    const { tests, gitHost, onProgress, fetchFn } = input;
     const results = [];
     const total = tests.length;
     for (let index = 0; index < tests.length; index++) {
@@ -17,7 +17,7 @@ export async function runChecks(input) {
             index,
             total,
         });
-        const result = await runSingleCheck(test, gitHost);
+        const result = await runSingleCheck(test, gitHost, fetchFn);
         results.push(result);
         emitProgress(onProgress, {
             type: "test:complete",
@@ -36,7 +36,7 @@ export async function runChecks(input) {
         results,
     };
 }
-async function runSingleCheck(test, gitHost) {
+async function runSingleCheck(test, gitHost, fetchFn) {
     const { source, testId } = test;
     const checkType = getCheckTypeForTestId(testId);
     if (!isCheckAvailable(checkType)) {
@@ -80,7 +80,7 @@ async function runSingleCheck(test, gitHost) {
     }
     switch (checkType) {
         case "http":
-            return httpCheck({ target, source, testId });
+            return httpCheck({ target, source, testId, fetchFn });
         case "dns":
             return dnsCheck({
                 hostname: extractHostname(target),

package/src/connectivity/types.d.ts

@@ -4,10 +4,21 @@ export interface Test {
     source: Source;
     testId: TestId;
 }
+export type ConnectivityFetchFn = (input: string | URL, init?: {
+    method?: string;
+    signal?: AbortSignal;
+    redirect?: "follow" | "error" | "manual";
+}) => Promise<Pick<Response, "ok" | "status" | "statusText">>;
 export interface RunChecksInput {
     tests: Test[];
     gitHost?: string;
     onProgress?: (event: ProgressEvent) => void;
+    /**
+     * Use this to pass a proxy-aware fetch function. Typically
+     * only necessary when running connectivity checks from Node
+     * environments.
+     */
+    fetchFn?: ConnectivityFetchFn;
 }
 export type ProgressEvent = {
     type: "test:start";

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 {
@@ -488,7 +489,8 @@ export declare const ClientDevtoolsSessionStartedEvent: {
     version: "1";
 };
 export type FusionProjectCreatedV1 = FusionEventVariant<"fusion.project.created", {
-    projectId?: string;
+    projectId: string;
+    branchName?: string;
     branchId?: string;
 }, {}, 1>;
 export declare const FusionProjectCreatedV1: {
@@ -496,8 +498,11 @@ export declare const FusionProjectCreatedV1: {
     version: "1";
 };
 export type SetupAgentCompletedV1 = FusionEventVariant<"fusion.setup.completed", {
-    projectId?: string;
+    proposedConfigId: string;
+    projectId: string;
+    branchName: string;
     branchId?: string;
+    state: ExitState;
 }, {}, 1>;
 export declare const SetupAgentCompletedV1: {
     eventName: "fusion.setup.completed";

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, GitSnapshot } from "./codegen";
+import type { FileOverride, EnvironmentVariable, LaunchServerState, LaunchServerStatus, BranchBackup, CommitMode, CustomInstruction, CustomAgentDefinition, GitSnapshot, AutoPushMode } from "./codegen";
 import type { FallbackTokensPrivate } from "./organization";
 /**
  * Temporary type for date fields during migration.
@@ -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>;
@@ -561,6 +572,7 @@ export interface Project {
         validateCommand?: string;
         proxyOrigin?: string;
         proxyDefaultOrigin?: string;
+        defaultAutoPush?: AutoPushMode;
         gitBranchNamingStrategy?: "ai-session" | "branch-name" | "custom";
         setupDependencies?: SetupDependency[];
         gitBranchNamingCustom?: string;