@builder.io/ai-utils 0.11.26-0 → 0.11.27

package/package.json

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

package/src/codegen.d.ts

@@ -849,6 +849,9 @@ export interface GitBackupDownloadUrlResult {
     partial: boolean;
 }
 export interface BranchBackup {
+    projectId: string;
+    ownerId: string;
+    branchName: string;
     at: number;
     size: number;
     gitBranchName: string;
@@ -971,6 +974,18 @@ export interface EnvironmentVariable {
     value: string;
     isSecret: boolean;
 }
+export interface FileOverride {
+    /**
+     * Absolute path where the file should be written in the container.
+     * Example: "/app/.env", "/etc/config/app.conf"
+     */
+    path: string;
+    /**
+     * Content to write to the file.
+     * Can be plain text or binary content (base64 encoded if needed).
+     */
+    content: string;
+}
 export interface FusionConfig {
     devCommand?: string;
     checkCommand?: string;
@@ -1041,6 +1056,12 @@ export interface FusionConfig {
      * @default false
      */
     autoConfigureHosts?: boolean;
+    /**
+     * Array of files to inject into the container during setup.
+     * These files will be written before setupCommand or devCommand is executed.
+     * Useful for configuration files, credentials, or environment-specific overrides.
+     */
+    fileOverrides?: FileOverride[];
     /**
      * Local MCP server configurations.
      * Servers defined here will be merged with servers from mcp.json.
@@ -1052,6 +1073,10 @@ export interface FusionConfig {
         env?: Record<string, string>;
         envFile?: string;
     }>;
+    /**
+     * List of built-in tools to disable.
+     */
+    disabledTools?: string[];
     /** @deprecated use devCommand */
     command?: string;
 }
@@ -1192,6 +1217,7 @@ export interface CodegenApiTerminal {
 export interface SetupCommandResult {
     code: number | null;
     output: string;
+    capturedEnv?: Record<string, string>;
 }
 export type DevCommandResult = DevCommandResultSuccess | DevCommandResultFailure;
 export interface DevCommandResultSuccess {

package/src/index.d.ts

@@ -8,4 +8,3 @@ export * from "./projects.js";
 export * from "./repo-indexing.js";
 export * from "./organization.js";
 export * from "./features.js";
-export * from "./fusion.js";

package/src/index.js

@@ -8,4 +8,3 @@ export * from "./projects.js";
 export * from "./repo-indexing.js";
 export * from "./organization.js";
 export * from "./features.js";
-export * from "./fusion.js";

package/src/projects.d.ts

@@ -1,4 +1,4 @@
-import type { LaunchServerState, LaunchServerStatus } from "./codegen";
+import type { FileOverride, EnvironmentVariable, LaunchServerState, LaunchServerStatus, BranchBackup } from "./codegen";
 export interface ConfigStatus {
     isReady: boolean;
     lastUpdated: string;
@@ -85,6 +85,7 @@ export interface ErrorMessage extends BaseMessage {
     error: string;
     details?: any;
     message?: string;
+    code?: string;
 }
 export interface InfoMessage extends BaseMessage {
     type: "info";
@@ -134,7 +135,7 @@ export interface ReadyMessage extends BaseMessage {
 }
 export type MachineState = "unknown" | "created" | "starting" | "started" | "stopping" | "stopped" | "suspending" | "suspended" | "replacing" | "destroying" | "destroyed" | "not-found" | "running" | "failed";
 export type FlyVolumeState = "unknown" | "creating" | "created" | "extending" | "restoring" | "enabling_remote_export" | "hydrating" | "recovering" | "scheduling_destroy" | "pending_destroy" | "failed";
-export type GitAuthErrorCode = "git-auth-failed" | "git-auth-failed-root-repo" | "git-auth-failed-folder-added-by" | "git-auth-failed-folder-created-by" | "git-auth-failed-folder-server-token" | "git-auth-failed-root-repo-server-token";
+export type GitAuthErrorCode = "git-auth-failed" | "git-auth-failed-root-repo" | "git-auth-failed-folder-added-by" | "git-auth-failed-folder-created-by" | "git-auth-failed-repo-not-found" | "git-auth-failed-folder-server-token" | "git-auth-failed-root-repo-server-token";
 export type EnsureContainerErrorCode = "FAILED_TO_START_MACHINE_ERROR" | "FLY_APP_CHECK_ERROR" | "FLY_CAPACITY_ERROR" | "FLY_PERMISSIONS_TOKEN_ERROR" | "FLY_VOLUME_CREATE_ERROR" | "FLY_VOLUME_FORK_ERROR" | "FLY_VOLUME_DELETE_RECENTLY_FORKED_ERROR" | "FLY_MACHINE_CREATE_ERROR" | "FLY_VOLUME_CHECK_ERROR" | "FLY_NON_MOUNTABLE_VOLUME_ERROR" | "FLY_DEPRECATED_REGION_ERROR" | "FLY_VOLUME_NOT_FOUND" | "FLY_MACHINE_LIMIT_ERROR" | "KUBE_CAPACITY_ERROR" | "KUBE_PERMISSIONS_ERROR" | "KUBE_POD_LIMIT_ERROR" | "KUBE_RESOURCE_QUOTA_ERROR" | "KUBE_NAMESPACE_CHECK_ERROR" | "KUBE_PVC_CREATE_ERROR" | "KUBE_PVC_CHECK_ERROR" | "KUBE_POD_CREATE_ERROR" | "KUBE_SERVICE_CREATE_ERROR" | "KUBE_INGRESS_CREATE_ERROR" | "KUBE_POD_FAILED_TO_START_ERROR" | "ensure-checking-existing-machines" | "found-multiple-failed-machine" | "maximun-retries-machine-creation" | GitAuthErrorCode | "unknown" | "project-bad-state" | "project-not-found" | "project-branch-not-found" | "project-branch-no-session-id" | "project-repo-full-name-not-found" | "project-org-not-found" | "invalid-project-repo-url-already-in-use" | "no-available-regions" | "invalid-backup-without-volume-id" | "missing-app-with-machine-or-volume" | "update-branch-info-in-firebase" | "update-branch-app-name-in-firebase" | `machine-status-polling-${MachineState}` | `machine-image-exited-immediately` | `volume-not-found-${FlyVolumeState}` | "trying-to-remove-used-volume" | "timeout" | "fatal:zod-validation-error" | `fatal:${string}`;
 export interface ErrorStateMessage extends BaseMessage {
     state: "error";
@@ -254,4 +255,191 @@ export interface SetupScriptDependency {
     name: string;
     script: string;
 }
+export type FusionExecutionEnvironment = "containerized" | "container-less" | "cloud";
+export interface PartialBranchData {
+    name?: string;
+    createdBy: string;
+    friendlyName: string;
+    isDefault: boolean;
+    isPublic: boolean;
+    lockedFusionEnvironment: FusionExecutionEnvironment;
+    metadata?: Record<string, unknown>;
+    backup?: BranchBackup;
+    gitAiBranch?: string | null;
+    lastCommitHash?: string | null;
+    lastCommitDate?: number | null;
+    commitMode?: "commits" | "draft-prs" | "prs";
+    useHomeDir?: boolean;
+    cloneFrom?: {
+        projectId: string;
+        branchName: string;
+    };
+}
+export interface Branch {
+    lockedFusionEnvironment?: FusionExecutionEnvironment;
+    id?: string;
+    appName?: string | null;
+    prNumber?: number | null;
+    prUrl?: string | null;
+    machineId?: string | null;
+    lastMachineIdRemovedAt?: number | null;
+    volumeId?: string | null;
+    secondaryVolumeId?: string | null;
+    volumeName?: string | null;
+    gitAiBranch?: string | null;
+    lastCommitHash?: string | null;
+    lastCommitDate?: number | null;
+    lastServerState?: LaunchServerState | null;
+    lastServerStateDate?: number | null;
+    lastServerVersion?: string | null;
+    name?: string;
+    createdBy?: string;
+    isPublic?: boolean;
+    isDefault?: boolean;
+    sessionId?: string;
+    createdAt?: number | null;
+    friendlyName?: string;
+    useHomeDir?: boolean;
+    useCloudHomeDir?: boolean;
+    ipv4?: {
+        address: string | null;
+        allocated: boolean | null;
+    } | null;
+    ipv6?: {
+        address: string | null;
+        allocated: boolean | null;
+    } | null;
+    preRecoveryData?: Partial<Branch> & {
+        recoveryDate: Date;
+    };
+    backup?: BranchBackup;
+    metadata?: Record<string, unknown>;
+    needsCleanup?: boolean;
+    deleted?: boolean;
+    updatedAt?: string;
+    commitMode?: "commits" | "draft-prs" | "prs";
+    kubePodName?: string | null;
+    kubeNamespace?: string | null;
+    kubePvcName?: string | null;
+    kubeHostname?: string | null;
+}
+export type CpuKind = "performance" | "shared";
+export type MachineAutoStop = "stop" | "off" | "suspend";
+export interface Project {
+    id: string;
+    name: string;
+    ownerId: string;
+    repoFullName: string | undefined;
+    repoProvider: string;
+    repoProtocol: string | undefined;
+    repoDescription?: string;
+    repoPrivate: boolean;
+    repoUrl: string | undefined;
+    createdDate: string;
+    updatedAt: string;
+    pinned?: boolean;
+    archived?: boolean;
+    createdBy: string;
+    checkRunCounts?: Record<string, number>;
+    repoAddedBy?: string;
+    pipelineCounts?: Record<string, number>;
+    needSetup?: boolean;
+    domains?: string[];
+    settings: {
+        autoDetectDevServer?: boolean;
+        autoDetectDevServerPatterns?: string[];
+        fusionEnvironment?: FusionExecutionEnvironment;
+        devServerPort?: number;
+        devServerUrl?: string;
+        refreshPreview?: boolean;
+        installCommand?: string;
+        gitBranchNamingStrategy?: "ai-session" | "branch-name" | "custom";
+        setupDependencies?: SetupDependency[];
+        gitBranchNamingCustom?: string;
+        devServerCommand?: string;
+        memoryLimit?: 1024 | 2048 | 4096 | 8192 | 16384;
+        cpuKind?: CpuKind;
+        autoStop?: MachineAutoStop;
+        mainBranchName?: string;
+        minMachinesRunning?: number;
+        volumeSize?: 5 | 10 | 12 | 15 | 20;
+        includePath?: string;
+        includePatterns?: string[];
+        environmentVariables?: EnvironmentVariable[];
+        fileOverrides?: FileOverride[];
+        commitMode?: "commits" | "draft-prs" | "prs";
+        dockerImagePath?: string;
+        nodeVersion?: string;
+        designSystems?: string[];
+        useNI?: boolean;
+        folders?: Array<{
+            name: string;
+            remoteUrl: string;
+            mainBranchName?: string;
+            includePath?: string;
+            addedBy?: string;
+            repoProvider?: string;
+            repoProtocol?: string;
+        }>;
+        agentsMD?: string;
+        initializationCommand?: string;
+        repoSubpath?: string;
+        recommendedRoot?: string;
+        https?: boolean;
+        localHttpsDomain?: string;
+        httpsServerKeyPath?: string;
+        httpsServerCertPath?: string;
+        httpsServerCaPath?: string;
+        httpsServerKeyContent?: string;
+        httpsServerCertContent?: string;
+        httpsServerCaContent?: string;
+        httpsServerPfx?: string;
+        httpsServerPassphrase?: string;
+        httpsServerSecureProtocol?: string;
+        httpsServerSecureOptions?: number;
+        httpsServerCiphers?: string;
+        httpsServerHonorCipherOrder?: boolean;
+        httpsServerRequestCert?: boolean;
+        httpsServerRejectUnauthorized?: boolean;
+    };
+    screenshot: string | null;
+    isExample?: boolean;
+    isPublic?: boolean;
+    snapshotVolume?: {
+        volumeId: string;
+        appName: string;
+        createdAt: number;
+    };
+    isFromUserTemplate?: boolean;
+    templateId?: string | null;
+    localPath?: string | null;
+}
+export interface ProjectWithBranches extends Project {
+    branches: Record<string, Branch>;
+}
+export interface OrganizationPrivate {
+    ownerId: string;
+    id: string;
+    installs?: {
+        ids: number[];
+        host: string;
+    }[];
+    createdAt: number;
+    updatedAt: number;
+}
+export interface CreateProjectOptions {
+    name: string;
+    repoFullName: string;
+    repoProvider: string;
+    repoProtocol: string;
+    repoDescription?: string;
+    repoPrivate: boolean;
+    repoUrl: string;
+    needSetup: boolean;
+    domains?: string[];
+    settings?: Partial<Project["settings"]>;
+    isPublic?: boolean;
+    isExample?: boolean;
+    templateId?: string;
+}
 export {};

package/src/fusion.d.ts

@@ -1,160 +0,0 @@
-import type { BranchBackup, EnvironmentVariable, LaunchServerState, SetupDependency } from "./index.js";
-export type FusionExecutionEnvironment = "containerized" | "container-less" | "cloud";
-export interface PartialBranchData {
-    name?: string;
-    createdBy: string;
-    friendlyName: string;
-    isDefault: boolean;
-    isPublic: boolean;
-    lockedFusionEnvironment: FusionExecutionEnvironment;
-    metadata?: Record<string, unknown>;
-    useHomeDir?: boolean;
-}
-export interface Branch {
-    lockedFusionEnvironment?: FusionExecutionEnvironment;
-    id?: string;
-    appName?: string | null;
-    prNumber?: number | null;
-    prUrl?: string | null;
-    machineId?: string | null;
-    lastMachineIdRemovedAt?: number | null;
-    volumeId?: string | null;
-    secondaryVolumeId?: string | null;
-    volumeName?: string | null;
-    gitAiBranch?: string | null;
-    lastCommitHash?: string | null;
-    lastCommitDate?: number | null;
-    lastServerState?: LaunchServerState | null;
-    lastServerStateDate?: number | null;
-    lastServerVersion?: string | null;
-    name?: string;
-    createdBy?: string;
-    isPublic?: boolean;
-    isDefault?: boolean;
-    sessionId?: string;
-    createdAt?: number | null;
-    friendlyName?: string;
-    useHomeDir?: boolean;
-    ipv4?: {
-        address: string | null;
-        allocated: boolean | null;
-    } | null;
-    ipv6?: {
-        address: string | null;
-        allocated: boolean | null;
-    } | null;
-    preRecoveryData?: Partial<Branch> & {
-        recoveryDate: Date;
-    };
-    backup?: BranchBackup;
-    metadata?: Record<string, unknown>;
-    needsCleanup?: boolean;
-    deleted?: boolean;
-    updatedAt?: string;
-    commitMode?: "commits" | "draft-prs" | "prs";
-    kubePodName?: string | null;
-    kubeNamespace?: string | null;
-    kubePvcName?: string | null;
-    kubeHostname?: string | null;
-}
-export type CpuKind = "performance" | "shared";
-export type MachineAutoStop = "stop" | "off" | "suspend";
-export interface Project {
-    id: string;
-    name: string;
-    ownerId: string;
-    repoFullName: string | undefined;
-    repoProvider: string;
-    repoProtocol: string | undefined;
-    repoDescription?: string;
-    repoPrivate: boolean;
-    repoUrl: string | undefined;
-    createdDate: string;
-    updatedAt: string;
-    pinned?: boolean;
-    archived?: boolean;
-    createdBy: string;
-    checkRunCounts?: Record<string, number>;
-    repoAddedBy?: string;
-    pipelineCounts?: Record<string, number>;
-    needSetup?: boolean;
-    domains?: string[];
-    settings: {
-        autoDetectDevServer?: boolean;
-        autoDetectDevServerPatterns?: string[];
-        fusionEnvironment?: FusionExecutionEnvironment;
-        devServerPort?: number;
-        devServerUrl?: string;
-        refreshPreview?: boolean;
-        installCommand?: string;
-        gitBranchNamingStrategy?: "ai-session" | "branch-name" | "custom";
-        setupDependencies?: SetupDependency[];
-        gitBranchNamingCustom?: string;
-        devServerCommand?: string;
-        memoryLimit?: 1024 | 2048 | 4096 | 8192 | 16384;
-        cpuKind?: CpuKind;
-        autoStop?: MachineAutoStop;
-        mainBranchName?: string;
-        minMachinesRunning?: number;
-        volumeSize?: 5 | 10 | 12 | 15 | 20;
-        includePath?: string;
-        includePatterns?: string[];
-        environmentVariables?: EnvironmentVariable[];
-        commitMode?: "commits" | "draft-prs" | "prs";
-        dockerImagePath?: string;
-        nodeVersion?: string;
-        designSystems?: string[];
-        useNI?: boolean;
-        folders?: Array<{
-            name: string;
-            remoteUrl: string;
-            mainBranchName?: string;
-            includePath?: string;
-            addedBy?: string;
-            repoProvider?: string;
-            repoProtocol?: string;
-        }>;
-        agentsMD?: string;
-        initializationCommand?: string;
-        repoSubpath?: string;
-        recommendedRoot?: string;
-        https?: boolean;
-        localHttpsDomain?: string;
-        httpsServerKeyPath?: string;
-        httpsServerCertPath?: string;
-        httpsServerCaPath?: string;
-        httpsServerKeyContent?: string;
-        httpsServerCertContent?: string;
-        httpsServerCaContent?: string;
-        httpsServerPfx?: string;
-        httpsServerPassphrase?: string;
-        httpsServerSecureProtocol?: string;
-        httpsServerSecureOptions?: number;
-        httpsServerCiphers?: string;
-        httpsServerHonorCipherOrder?: boolean;
-        httpsServerRequestCert?: boolean;
-        httpsServerRejectUnauthorized?: boolean;
-    };
-    screenshot: string | null;
-    isExample?: boolean;
-    snapshotVolume?: {
-        volumeId: string;
-        appName: string;
-        createdAt: number;
-    };
-    isFromUserTemplate?: boolean;
-    localPath?: string | null;
-}
-export interface ProjectWithBranches extends Project {
-    branches: Record<string, Branch>;
-}
-export interface OrganizationPrivate {
-    ownerId: string;
-    id: string;
-    installs?: {
-        ids: number[];
-        host: string;
-    }[];
-    createdAt: number;
-    updatedAt: number;
-}

package/src/fusion.js

@@ -1 +0,0 @@
-export {};