@builder.io/ai-utils 0.50.4 → 0.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.50.4",
+  "version": "0.52.0",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/codegen.d.ts

@@ -202,7 +202,7 @@ export interface AskUserQuestion {
 }
 export interface AskUserQuestionToolInput {
     questions: AskUserQuestion[];
-    answers?: Record<string, string>;
+    answers?: Record<string, string | string[]>;
 }
 export interface AgentToolInput {
     description: string;
@@ -448,7 +448,7 @@ export interface UpdateSetupValueToolInput {
     };
     reason: string;
 }
-export type ExitState = "verified" | "no-frontend" | "empty-project" | "mobile-project" | "user-question" | "code-change-required" | "other" | "started";
+export type ExitState = "verified" | "no-frontend" | "empty-project" | "mobile-project" | "user-question" | "code-change-required" | "other" | "started" | "failed";
 export interface ExitToolInput {
     state: ExitState;
     summary: string;

package/src/events.d.ts

@@ -798,6 +798,8 @@ export type PrReviewRequestedV1 = FusionEventVariant<"pr.review.requested", {
     triggerSource?: string;
     isSynchronize?: boolean;
     isFork?: boolean;
+    prAuthorGithubUsername?: string;
+    prAuthorIsBot?: boolean;
     forceBrowserTesting?: boolean;
 }, {}, 1>;
 export declare const PrReviewRequestedV1: {

package/src/index.d.ts

@@ -12,5 +12,5 @@ export * from "./vscode-tunnel.js";
 export * from "./claw.js";
 export * from "./kube-error.js";
 export * from "./connectivity/types.js";
-export * from "./vpc-peering.js";
+export * from "./single-tenancy.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";

package/src/index.js

@@ -12,5 +12,5 @@ export * from "./vscode-tunnel.js";
 export * from "./claw.js";
 export * from "./kube-error.js";
 export * from "./connectivity/types.js";
-export * from "./vpc-peering.js";
+export * from "./single-tenancy.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";

package/src/organization.d.ts

@@ -101,9 +101,9 @@ interface OrganizationSettings {
     ticketAssessmentModel?: string;
     ticketAssessmentDailyLimit?: number;
     fusionWebhooks?: FusionWebhook[];
-    /** Default VPC peering ID for this space. References a document in the vpcPeerings collection.
-     *  Projects can override this with their own vpcPeering setting. */
-    defaultVpcPeering?: string;
+    /** Default single tenancy config ID for this space. References a document in the singleTenancyConfigurations collection.
+     *  Projects can override this with their own singleTenancyConfig setting. */
+    defaultSingleTenancyConfig?: string;
     controlModelAvailability?: boolean;
     allowedAiModels?: string[];
     autoModelOverride?: string;

package/src/projects.d.ts

@@ -371,6 +371,13 @@ export interface PartialBranchData {
         projectId: string;
         branchName: string;
     };
+    /**
+     * Pre-generated sessionId. internal use only. When provided, the branch will use this sessionId
+     * instead of generating a new one. Allows callers (e.g. setup-agent spawner)
+     * to bootstrap a ProposedConfig doc keyed by sessionId before the branch
+     * record is fully created.
+     */
+    sessionId?: string;
 }
 export type EntityState = "active" | "deleted" | "archived";
 /**
@@ -407,6 +414,10 @@ export interface BranchMetadata {
     description?: string;
     /** Whether the branch is a cloned branch */
     isClonedBranch?: boolean;
+    /** For QA branches reviewing an internal PR (originated from Builder): the project ID of the source branch */
+    originalProjectId?: string;
+    /** For QA branches reviewing an internal PR (originated from Builder): the name of the source branch */
+    originalBranchName?: string;
     /** Data passed in via /agents/run api that we echo in webhook response **/
     webhookContext?: Record<string, unknown>;
     [key: string]: unknown;
@@ -691,9 +702,9 @@ export interface Project {
          * Agents will pick this project when asked to do something with the connected repository.
          */
         isPreferredForRepo?: boolean;
-        /** VPC peering ID for this project. Overrides the space-level defaultVpcPeering.
-         *  References a document in the vpcPeerings collection. */
-        vpcPeering?: string;
+        /** Single tenancy config ID for this project. Overrides the space-level defaultSingleTenancyConfig.
+         *  References a document in the singleTenancyConfigurations collection. */
+        singleTenancyConfig?: string;
         previewPasswordProtection?: PreviewPasswordProtection;
     };
     screenshot: string | null;
@@ -720,6 +731,8 @@ export interface Project {
     useBranchesCollection?: boolean;
     /** When true, the project is in code-only mode */
     codeOnlyMode?: boolean;
+    /** When true, analysis detected a mobile-only app (no usable web dev server path) */
+    mobileOnlyDetected?: boolean;
     /** When true, this project is an org-level Claw agent */
     isOrgAgent?: boolean;
     /** Configuration for the org agent */
@@ -850,6 +863,17 @@ export interface CreateBranchOptions {
         branchName: string;
         url: string;
     }) => Promise<void> | void;
+    /**
+     * INTERNAL ONLY. Pre-generated sessionId used by trusted callers
+     * (e.g. setup-agent spawner) to bootstrap a ProposedConfig doc keyed by
+     * sessionId before the branch record exists.
+     *
+     * SECURITY: Must be stripped from any user-facing HTTP request body — this
+     * value becomes a Firestore document ID and accepting it from untrusted
+     * input enables cross-user ProposedConfig corruption via
+     * `.set(..., { merge: true })`.
+     */
+    sessionId?: string;
 }
 interface BaseCreateBranchMessage {
 }

package/src/single-tenancy.d.ts

@@ -0,0 +1,92 @@
+/** Fields common to all VPC connectivity types. */
+interface VpcConnectionBase {
+    type: string;
+    proxyIp: string;
+    customerDnsServers: string[];
+}
+/** Traditional VPC Peering via bridge VPC. */
+export interface VpcGcpPeering extends VpcConnectionBase {
+    type: "gcp-peering";
+    gcpProjectId: string;
+    gcpNetworkName: string;
+    bridgeCidr: string;
+    importCustomRoutes: boolean;
+}
+/**
+ * PSC Network Attachment — customer creates the network attachment in their VPC,
+ * our proxy VM connects to it via a PSC interface on nic1.
+ * No bridge VPC or bridge CIDR needed on our side.
+ */
+export interface VpcGcpNetworkAttachment extends VpcConnectionBase {
+    type: "gcp-network-attachment";
+    gcpProjectId: string;
+    networkAttachmentName: string;
+}
+/** Discriminated union of all VPC connectivity types. */
+export type VpcConnection = VpcGcpPeering | VpcGcpNetworkAttachment;
+/**
+ * Dedicated node pool preferences for a single tenancy customer.
+ * Independent of VPC connectivity.
+ */
+export interface DedicatedNodePoolConfig {
+    enabled: boolean;
+    machineType?: string;
+    minNodes?: number;
+    maxNodes?: number;
+    diskSizeGb?: number;
+    diskType?: string;
+}
+/**
+ * Single tenancy configuration — unified data model for VPC connectivity
+ * and dedicated node pool preferences per customer.
+ *
+ * Stored in the `singleTenancyConfigurations` Firestore collection.
+ */
+export interface SingleTenancyConfig {
+    id: string;
+    ownerId: string;
+    enabled: boolean;
+    createdAt: number;
+    updatedAt: number;
+    /** VPC connectivity — optional, not all customers need VPC. */
+    vpc?: VpcConnection;
+    /** Dedicated node pool — optional, independent of VPC. */
+    dedicatedNodePool?: DedicatedNodePoolConfig;
+}
+export interface CreateVpcGcpPeeringParams {
+    type: "gcp-peering";
+    gcpProjectId: string;
+    gcpNetworkName: string;
+    bridgeCidr: string;
+    customerDnsServers: string[];
+    importCustomRoutes?: boolean;
+}
+export interface CreateVpcGcpNetworkAttachmentParams {
+    type: "gcp-network-attachment";
+    gcpProjectId: string;
+    networkAttachmentName: string;
+    customerDnsServers: string[];
+}
+export type CreateSingleTenancyVpcParams = CreateVpcGcpPeeringParams | CreateVpcGcpNetworkAttachmentParams;
+/**
+ * Full create payload — VPC connectivity plus optional dedicated node pool.
+ * The {@link CreateSingleTenancyVpcParams} discriminated union still drives
+ * which VPC fields are required.
+ */
+export type CreateSingleTenancyConfigOpts = CreateSingleTenancyVpcParams & {
+    dedicatedNodePool?: DedicatedNodePoolConfig;
+};
+/**
+ * Patch payload for an existing single tenancy config.
+ * Only the safe-to-edit fields are exposed; `vpc.type`, `vpc.proxyIp`,
+ * `vpc.gcpProjectId`, `vpc.gcpNetworkName`, `vpc.networkAttachmentName`, and
+ * `vpc.bridgeCidr` are immutable because changing them would diverge from
+ * already-provisioned infrastructure.
+ */
+export interface UpdateSingleTenancyConfigOpts {
+    enabled?: boolean;
+    customerDnsServers?: string[];
+    importCustomRoutes?: boolean;
+    dedicatedNodePool?: DedicatedNodePoolConfig | null;
+}
+export {};

package/src/vpc-peering.d.ts

@@ -1,49 +0,0 @@
-/** Fields common to all VPC connectivity types. */
-interface VpcConnectionBase {
-    id: string;
-    ownerId: string;
-    type: string;
-    gcpRegion: string;
-    customerDnsServers: string[];
-    proxyIp: string;
-    enabled: boolean;
-    createdAt: number;
-    updatedAt: number;
-}
-/** Traditional VPC Peering via bridge VPC. */
-export interface VpcGcpPeering extends VpcConnectionBase {
-    type: "gcp-peering";
-    gcpProjectId: string;
-    gcpNetworkName: string;
-    bridgeCidr: string;
-    importCustomRoutes: boolean;
-}
-/**
- * PSC Network Attachment — customer creates the network attachment in their VPC,
- * our proxy VM connects to it via a PSC interface on nic1.
- * No bridge VPC or bridge CIDR needed on our side.
- */
-export interface VpcGcpNetworkAttachment extends VpcConnectionBase {
-    type: "gcp-network-attachment";
-    gcpProjectId: string;
-    networkAttachmentName: string;
-}
-/** Discriminated union of all VPC connectivity types. */
-export type VpcPeering = VpcGcpPeering | VpcGcpNetworkAttachment;
-export interface CreateVpcGcpPeeringParams {
-    type: "gcp-peering";
-    gcpRegion: string;
-    gcpProjectId: string;
-    gcpNetworkName: string;
-    bridgeCidr: string;
-    customerDnsServers: string[];
-    importCustomRoutes?: boolean;
-}
-export interface CreateVpcGcpNetworkAttachmentParams {
-    type: "gcp-network-attachment";
-    gcpProjectId: string;
-    networkAttachmentName: string;
-    customerDnsServers: string[];
-}
-export type CreateVpcPeeringParams = CreateVpcGcpPeeringParams | CreateVpcGcpNetworkAttachmentParams;
-export {};