@builder.io/ai-utils 0.106.0 → 0.107.0

package/package.json

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

package/src/codegen.d.ts

@@ -125,6 +125,15 @@ export declare const ReadToolInputSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 export type ReadToolInput = z.infer<typeof ReadToolInputSchema>;
+/** Image files the Read tool returns as image content instead of rejecting as binary. */
+declare const READ_TOOL_IMAGE_MEDIA_TYPES: {
+    readonly ".png": "image/png";
+    readonly ".jpg": "image/jpeg";
+    readonly ".jpeg": "image/jpeg";
+    readonly ".gif": "image/gif";
+    readonly ".webp": "image/webp";
+};
+export declare function readToolImageMediaType(filePath: string): (typeof READ_TOOL_IMAGE_MEDIA_TYPES)[keyof typeof READ_TOOL_IMAGE_MEDIA_TYPES] | undefined;
 export declare const GlobSearchToolInputSchema: z.ZodObject<{
     pattern: z.ZodString;
 }, z.core.$strip>;
@@ -4497,6 +4506,8 @@ export interface FusionConfig {
     branchFriendlyName?: string;
     sessionId?: string;
     browserAutomationInstructions?: string;
+    /** Start a headed Chromium in the container, driven from scripts over DevTools. */
+    branchBrowser?: boolean;
     /** Whether this branch is for a code review - affects enabled agents and tools */
     branchType?: BranchType;
     /**

package/src/codegen.js

@@ -128,6 +128,19 @@ export const ReadToolInputSchema = z
     }),
 })
     .meta({ title: "ReadToolInput" });
+/** Image files the Read tool returns as image content instead of rejecting as binary. */
+const READ_TOOL_IMAGE_MEDIA_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+};
+export function readToolImageMediaType(filePath) {
+    const lower = filePath.toLowerCase();
+    const ext = lower.slice(lower.lastIndexOf("."));
+    return READ_TOOL_IMAGE_MEDIA_TYPES[ext];
+}
 export const GlobSearchToolInputSchema = z
     .object({
     pattern: z.string().meta({ description: "The pattern to search for" }),

package/src/common-schemas.d.ts

@@ -7,6 +7,11 @@ export declare const EnvironmentVariableSchema: z.ZodObject<{
     explanation: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type EnvironmentVariable = z.infer<typeof EnvironmentVariableSchema>;
+export declare const NETLIFY_PRODUCTION_ENV_VALUE_MAX_LENGTH = 5000;
+export declare function getOversizedProductionEnvVar(entries: ReadonlyArray<EnvironmentVariable> | undefined): {
+    key: string;
+    length: number;
+} | undefined;
 export declare const SetupMiseDependencySchema: z.ZodObject<{
     key: z.ZodString;
     type: z.ZodLiteral<"mise">;

package/src/common-schemas.js

@@ -19,6 +19,18 @@ export const EnvironmentVariableSchema = z
     }),
 })
     .meta({ title: "EnvironmentVariable" });
+export const NETLIFY_PRODUCTION_ENV_VALUE_MAX_LENGTH = 5000;
+export function getOversizedProductionEnvVar(entries) {
+    for (const entry of entries !== null && entries !== void 0 ? entries : []) {
+        const key = entry.key.trim();
+        if (key &&
+            !entry.placeholder &&
+            entry.value.length > NETLIFY_PRODUCTION_ENV_VALUE_MAX_LENGTH) {
+            return { key, length: entry.value.length };
+        }
+    }
+    return undefined;
+}
 export const SetupMiseDependencySchema = z
     .object({
     key: z.string(),

package/src/credits.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+export declare const BuilderReferralInfoResponseSchema: z.ZodObject<{
+    eligible: z.ZodBoolean;
+    inviteUrl: z.ZodNullable<z.ZodURL>;
+    creditsPerReferral: z.ZodNumber;
+    completedReferrals: z.ZodNumber;
+    pendingReferrals: z.ZodNumber;
+    creditsEarned: z.ZodNumber;
+}, z.core.$strip>;
+export type BuilderReferralInfoResponse = z.infer<typeof BuilderReferralInfoResponseSchema>;

package/src/credits.js

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export const BuilderReferralInfoResponseSchema = z.object({
+    eligible: z.boolean(),
+    inviteUrl: z.url().nullable(),
+    creditsPerReferral: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
+    completedReferrals: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
+    pendingReferrals: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
+    creditsEarned: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
+});

package/src/index.d.ts

@@ -22,6 +22,7 @@ export * from "./single-tenancy.js";
 export * from "./design-systems.js";
 export * from "./editor-ai.js";
 export * from "./realtime.js";
+export * from "./credits.js";
 export * from "./embeddings.js";
 export * from "./system-one.js";
 export * from "./mcp-servers.js";

package/src/index.js

@@ -22,6 +22,7 @@ export * from "./single-tenancy.js";
 export * from "./design-systems.js";
 export * from "./editor-ai.js";
 export * from "./realtime.js";
+export * from "./credits.js";
 export * from "./embeddings.js";
 export * from "./system-one.js";
 export * from "./mcp-servers.js";

package/src/organization.d.ts

@@ -355,6 +355,7 @@ export interface FeatureMap {
     performanceInfrastructure?: boolean;
     previewPasswordProtection?: boolean;
     siteAccessControl?: boolean;
+    hostingCustomDomain?: boolean;
     publicPreviews?: boolean;
     privacyMode?: boolean;
     usageInsights?: boolean;

package/src/projects.d.ts

@@ -1434,6 +1434,7 @@ export declare const ProjectSettingsSchema: z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
         authUser: z.ZodOptional<z.ZodString>;
         authPassword: z.ZodOptional<z.ZodString>;
+        branchBrowser: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     prReviewer: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodBoolean;
@@ -1771,6 +1772,7 @@ export declare const ProjectSettingsExternalSchema: z.ZodObject<{
         instructions: z.ZodOptional<z.ZodString>;
         authUser: z.ZodOptional<z.ZodString>;
         authPassword: z.ZodOptional<z.ZodString>;
+        branchBrowser: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     prReviewer: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodBoolean;
@@ -2982,6 +2984,7 @@ export declare const UpdateProjectOptionsSchema: z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
             authUser: z.ZodOptional<z.ZodString>;
             authPassword: z.ZodOptional<z.ZodString>;
+            branchBrowser: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
         prReviewer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
             enabled: z.ZodBoolean;
@@ -3692,6 +3695,8 @@ export declare const HostingDomainSchema: z.ZodObject<{
     routeError: z.ZodOptional<z.ZodString>;
     routeErrorAt: z.ZodOptional<z.ZodNumber>;
     servingConfirmedAt: z.ZodOptional<z.ZodNumber>;
+    certIssue: z.ZodOptional<z.ZodString>;
+    certIssueAt: z.ZodOptional<z.ZodNumber>;
     createdBy: z.ZodString;
 }, z.core.$strip>;
 export type HostingDomain = z.infer<typeof HostingDomainSchema>;
@@ -4274,6 +4279,7 @@ export declare const ProjectTemplateSchema: z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
             authUser: z.ZodOptional<z.ZodString>;
             authPassword: z.ZodOptional<z.ZodString>;
+            branchBrowser: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
         prReviewer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
             enabled: z.ZodBoolean;
@@ -4699,6 +4705,7 @@ export declare const ProjectTemplateOverridesSchema: z.ZodObject<{
             instructions: z.ZodOptional<z.ZodString>;
             authUser: z.ZodOptional<z.ZodString>;
             authPassword: z.ZodOptional<z.ZodString>;
+            branchBrowser: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
         prReviewer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
             enabled: z.ZodBoolean;
@@ -5092,6 +5099,7 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodPipe<z.
                 instructions: z.ZodOptional<z.ZodString>;
                 authUser: z.ZodOptional<z.ZodString>;
                 authPassword: z.ZodOptional<z.ZodString>;
+                branchBrowser: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             prReviewer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodBoolean;
@@ -5468,6 +5476,7 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodPipe<z.
                 instructions: z.ZodOptional<z.ZodString>;
                 authUser: z.ZodOptional<z.ZodString>;
                 authPassword: z.ZodOptional<z.ZodString>;
+                branchBrowser: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             prReviewer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodBoolean;
@@ -5740,6 +5749,7 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodPipe<z.
                 instructions?: string | undefined;
                 authUser?: string | undefined;
                 authPassword?: string | undefined;
+                branchBrowser?: boolean | undefined;
             } | undefined;
             prReviewer?: {
                 enabled: boolean;
@@ -6008,6 +6018,7 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodPipe<z.
                 instructions?: string | undefined;
                 authUser?: string | undefined;
                 authPassword?: string | undefined;
+                branchBrowser?: boolean | undefined;
             } | undefined;
             prReviewer?: {
                 enabled: boolean;
@@ -6270,6 +6281,7 @@ export declare const CreateProjectTemplateFromProjectOptionsSchema: z.ZodPipe<z.
                 instructions?: string | undefined;
                 authUser?: string | undefined;
                 authPassword?: string | undefined;
+                branchBrowser?: boolean | undefined;
             } | undefined;
             prReviewer?: {
                 enabled: boolean;
@@ -6693,6 +6705,7 @@ export declare const ListProjectTemplatesResponseSchema: z.ZodObject<{
                 instructions: z.ZodOptional<z.ZodString>;
                 authUser: z.ZodOptional<z.ZodString>;
                 authPassword: z.ZodOptional<z.ZodString>;
+                branchBrowser: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             prReviewer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodBoolean;
@@ -7113,6 +7126,7 @@ export declare const UpdateProjectTemplateOptionsSchema: z.ZodObject<{
                 instructions: z.ZodOptional<z.ZodString>;
                 authUser: z.ZodOptional<z.ZodString>;
                 authPassword: z.ZodOptional<z.ZodString>;
+                branchBrowser: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             prReviewer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodBoolean;
@@ -7525,6 +7539,7 @@ export declare const UpdateProjectTemplateResponseSchema: z.ZodObject<{
                 instructions: z.ZodOptional<z.ZodString>;
                 authUser: z.ZodOptional<z.ZodString>;
                 authPassword: z.ZodOptional<z.ZodString>;
+                branchBrowser: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
             prReviewer: z.ZodOptional<z.ZodOptional<z.ZodObject<{
                 enabled: z.ZodBoolean;

package/src/projects.js

@@ -777,6 +777,9 @@ export const ProjectSettingsSchema = z
         authPassword: z.string().optional().meta({
             description: "Password for sites requiring authentication.",
         }),
+        branchBrowser: z.boolean().optional().meta({
+            description: "Run a headed Chrome inside every cloud branch container, which the agent drives from scripts over DevTools.",
+        }),
     })
         .optional()
         .meta({
@@ -2022,7 +2025,13 @@ export const HostingDomainSchema = z.object({
         description: "When `routeError` was last set.",
     }),
     servingConfirmedAt: z.number().optional().meta({
-        description: "When the domain was confirmed serving over HTTPS: stamped by the serving-check loop once `https://<domain>/` answers over TLS through a Builder route (or by a healthy route recreate on deploy/repair). Definitive 'serving confirmed' signal for the UI's third setup step, distinct from cert issuance (`status: active`).",
+        description: "When the domain was confirmed serving over HTTPS: stamped by the serving-check loop once `https://<domain>/` answers over TLS through a Builder route (or by a healthy route recreate on deploy/repair on an `active` domain). Definitive 'serving confirmed' signal for the UI's third setup step, distinct from cert issuance (`status: active`). Never set while `provisioning`.",
+    }),
+    certIssue: z.string().optional().meta({
+        description: "Non-fatal, user-facing reason Google's latest certificate domain-authorization attempt failed while the domain is `provisioning` (e.g. the `_acme-challenge` CNAME wasn't found). Google keeps retrying, so `status` stays `provisioning`; this drives a warning on the HTTPS step instead of a silent spinner. Cleared when an attempt stops failing or the cert is issued.",
+    }),
+    certIssueAt: z.number().optional().meta({
+        description: "When `certIssue` was last set.",
     }),
     createdBy: z.string(),
 });

package/src/single-tenancy.d.ts

@@ -56,7 +56,13 @@ export interface PrivateLinkEndpoint {
  */
 export interface VpcAwsPrivateLink extends VpcConnectionBase {
     type: "aws-privatelink";
-    /** Must match the region aws-vpc-module runs in ({@link BUILDER_AWS_REGION}). */
+    /**
+     * The region the customer's Endpoint Service lives in, as embedded in each
+     * `endpoints[].serviceName`. May differ from {@link BUILDER_AWS_REGION}: the
+     * interface endpoints always live in Builder's region and reach a remote
+     * service via cross-region PrivateLink (`service_region` in aws-vpc-module).
+     * Every endpoint in one config shares this region.
+     */
     awsRegion: string;
     endpoints: PrivateLinkEndpoint[];
     /**
@@ -219,11 +225,18 @@ export interface SingleTenancyDerivedNames {
     privateLinkEndpointIps?: Record<string, string[]>;
 }
 /**
- * The single AWS region Builder's PrivateLink infrastructure runs in. Keep in
- * sync with the `aws` provider region in packages/terraform/main.tf — an Endpoint
- * Service in another region is unreachable by our interface endpoints.
+ * The region Builder's PrivateLink interface endpoints run in. Keep in sync with
+ * the `aws` provider region in packages/terraform/main.tf. A customer's Endpoint
+ * Service in another region is still reachable via cross-region PrivateLink (the
+ * endpoint names it through `service_region`); this constant is only the
+ * *consumer* region where our endpoints and their pinned IPs live.
  */
 export declare const BUILDER_AWS_REGION = "us-east-1";
+/**
+ * AWS region id (e.g. `us-east-1`, `eu-west-2`, `ap-southeast-3`). Used to
+ * validate a config's declared service region for cross-region PrivateLink.
+ */
+export declare const AWS_REGION_RE: RegExp;
 /**
  * AWS-generated VPC Endpoint Service name: `com.amazonaws.vpce.<region>.vpce-svc-<id>`.
  * The id is 8 or 17 hex chars — AWS resource ids are never a length in between.

package/src/single-tenancy.js

@@ -1,9 +1,16 @@
 /**
- * The single AWS region Builder's PrivateLink infrastructure runs in. Keep in
- * sync with the `aws` provider region in packages/terraform/main.tf — an Endpoint
- * Service in another region is unreachable by our interface endpoints.
+ * The region Builder's PrivateLink interface endpoints run in. Keep in sync with
+ * the `aws` provider region in packages/terraform/main.tf. A customer's Endpoint
+ * Service in another region is still reachable via cross-region PrivateLink (the
+ * endpoint names it through `service_region`); this constant is only the
+ * *consumer* region where our endpoints and their pinned IPs live.
  */
 export const BUILDER_AWS_REGION = "us-east-1";
+/**
+ * AWS region id (e.g. `us-east-1`, `eu-west-2`, `ap-southeast-3`). Used to
+ * validate a config's declared service region for cross-region PrivateLink.
+ */
+export const AWS_REGION_RE = /^[a-z]{2}-[a-z]+-\d$/;
 /**
  * AWS-generated VPC Endpoint Service name: `com.amazonaws.vpce.<region>.vpce-svc-<id>`.
  * The id is 8 or 17 hex chars — AWS resource ids are never a length in between.