@builder.io/ai-utils 0.25.4 → 0.26.1

package/package.json

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

package/src/codegen.d.ts

@@ -293,7 +293,7 @@ export interface UpdateSetupValueToolInput {
     };
     reason: string;
 }
-export type ExitState = "verified" | "more-disk" | "more-memory" | "user-question" | "other" | "started";
+export type ExitState = "verified" | "no-frontend" | "empty-project" | "user-question" | "other" | "started";
 export interface ExitToolInput {
     state: ExitState;
     summary: string;
@@ -353,6 +353,7 @@ export interface ProposedConfig {
         devServer: {
             value: string | undefined;
             verified: boolean;
+            elapsed?: number;
         };
         validateCommand: {
             value: string | undefined;
@@ -442,7 +443,7 @@ export interface VerifyDevServerToolInput {
     appOrigin: string;
     defaultOrigin?: string;
 }
-export interface VerifyValidationScriptToolInput {
+export interface VerifyValidateCommandToolInput {
     command: string;
     timeout?: number;
 }
@@ -555,7 +556,7 @@ export interface CodeGenToolMap {
     VerifySetupCommand: VerifySetupCommandToolInput;
     VerifyDevCommand: VerifyDevCommandToolInput;
     VerifyDevServer: VerifyDevServerToolInput;
-    VerifyValidationScript: VerifyValidationScriptToolInput;
+    VerifyValidateCommand: VerifyValidateCommandToolInput;
     VerifyRuntimeDependency: VerifyRuntimeDependencyToolInput;
     SetEnvVariable: SetEnvVariableToolInput;
 }
@@ -974,6 +975,7 @@ export interface GenerateCompletionStepGit {
     hasGeneratingPlaceholder: boolean;
     remoteBranchExists: boolean;
     remoteBranchHasChanges: boolean;
+    hasStagedChanges: boolean;
     canPush: boolean;
     canPull: boolean;
     canSync: boolean;
@@ -1074,24 +1076,9 @@ export interface GenerateCompletionStepUpdateSetupValue {
     };
     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;
@@ -1131,6 +1118,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;
@@ -1151,7 +1139,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;
@@ -1530,6 +1518,7 @@ export interface FusionConfig {
     setupCommand?: string;
     validateCommand?: string;
     fusionServerPort?: number;
+    autoPush?: AutoPushMode;
     lockFile?: {
         filePath: string;
         conflictBehavior: "replace" | "exit" | "kill";
@@ -1656,6 +1645,11 @@ export interface FusionConfig {
      * Read from project settings, with fallback to organization/space settings.
      */
     maxAgentCompletions?: number;
+    /**
+     * If true, skip all command security policy validation (e.g. allow curl, npx, etc without restrictions).
+     * This is a dangerous setting that removes safety guardrails - equivalent to full shell access.
+     */
+    skipCommandSecurity?: boolean;
     /** @deprecated use devCommand */
     command?: string;
 }

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

@@ -481,7 +481,11 @@ export declare const GitPrCreatedEvent: {
     version: "1";
 };
 export type ClientDevtoolsSessionStartedEvent = FusionEventVariant<"client.devtools.session.started", {
+    sessionId?: string;
     sessionType?: string;
+    projectId?: string;
+    branchName?: string;
+    branchId?: string;
     platform?: string;
 }, {}, 1>;
 export declare const ClientDevtoolsSessionStartedEvent: {

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.
@@ -152,7 +152,7 @@ export type GitAuthErrorCode = "git-auth-failed" | "git-auth-failed-root-repo" |
 /**
  * Git provider types for diagnostics.
  */
-export type GitDiagnosticsProvider = "github" | "bitbucket" | "gitlab" | "azure" | "unknown";
+export type GitDiagnosticsProvider = "github" | "selfHostedGithub" | "bitbucket" | "gitlab" | "azure" | "unknown";
 /**
  * Detect git provider from a repository URL (HTTPS or SSH).
  * Used by both error diagnostics and connectivity checks for consistent provider labeling.
@@ -213,9 +213,10 @@ export interface CleanupCompletedMessage extends BaseMessage {
  * Messages sent by the container orchestrator.
  */
 export type ProjectsChunkMessage = InitializingMessage | FetchingGithubTokenMessage | FetchingFusionKeyMessage | CheckingAppMessage | CleaningUpAppMessage | CreatingAppMessage | CheckingIPMessage | AllocatingIPMessage | CheckingMachineMessage | CheckingVolumeMessage | ForkingVolumeMessage | RetryingWithNewRegionMessage | WaitingBeforePollingMessage | PollingMachineStatusMessage | WarningStateMessage | PingMessage | DebugMessage | ErrorMessage | InfoMessage | WarningMessage | MachineStatusMessage | LogsMessage | ConfigStatusMessage | AppCreatedMessage | MachineCreatedMessage | IpAllocatedMessage | VolumeForkedMessage | ReadyMessage | ErrorStateMessage | CleanupCompletedMessage;
+export type GitProvider = "github" | "selfHostedGithub" | "bitbucket" | "gitlab" | "azure";
 export interface GitConfig {
     url: string;
-    provider: "github" | "bitbucket" | "gitlab" | "azure" | "unknown";
+    provider: GitProvider | "unknown";
     token: string | undefined;
 }
 export type GitConfigs = Record<string, GitConfig>;
@@ -572,6 +573,7 @@ export interface Project {
         validateCommand?: string;
         proxyOrigin?: string;
         proxyDefaultOrigin?: string;
+        defaultAutoPush?: AutoPushMode;
         gitBranchNamingStrategy?: "ai-session" | "branch-name" | "custom";
         setupDependencies?: SetupDependency[];
         gitBranchNamingCustom?: string;
@@ -628,6 +630,7 @@ export interface Project {
         postMergeMemories?: boolean;
         commitInstructions?: string;
         maxAgentCompletions?: number;
+        skipCommandSecurity?: boolean;
         httpsServerKeyPath?: string;
         httpsServerCertPath?: string;
         httpsServerCaPath?: string;