@builder.io/ai-utils 0.105.0 → 0.107.0

package/src/projects.js

@@ -399,6 +399,14 @@ export const ShapeSessionSchema = z.object({
     assembledAt: z.string().optional(),
     resolvedAt: z.string().optional(),
 });
+/**
+ * Stored shape of the top-level `shapeSessions/{projectId}` Firestore
+ * collection: a `ShapeSession` plus the `projectId` it belongs to, since the
+ * doc ID alone isn't visible once the doc is loaded into memory.
+ */
+export const ShapeSessionDocSchema = ShapeSessionSchema.extend({
+    projectId: z.string(),
+});
 export const InitialPromptSchema = z.object({
     id: z.string(),
     projectId: z.string(),
@@ -769,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({
@@ -896,9 +907,6 @@ export const ProjectSettingsSchema = z
     })
         .optional()
         .meta({ description: "Password-protect the preview URL." }),
-    shapeSession: ShapeSessionSchema.optional().meta({
-        description: "@internal Guided-onboarding questionnaire issued for this project.",
-    }),
 })
     .meta({ title: "ProjectSettings" });
 /**
@@ -922,7 +930,6 @@ const INTERNAL_PROJECT_SETTINGS_MASK = {
     commitInstructions: true,
     skipCommandSecurity: true,
     autoCloseBranchOnMerge: true,
-    shapeSession: true,
 };
 /**
  * Runtime schema for the client-writable subset of {@link Project.settings},
@@ -2018,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(),
 });
@@ -2311,3 +2324,41 @@ export const CreateProjectTemplateFromProjectOptionsSchema = z
 export const CreateProjectTemplateFromProjectResponseSchema = z.object({
     template: ProjectTemplateSchema.pick({ id: true, name: true }),
 });
+export const ListProjectTemplatesOptionsSchema = z.object({
+    id: z.string().min(1).optional(),
+});
+export const ListProjectTemplatesResponseSchema = z.object({
+    templates: z.array(ProjectTemplateSchema),
+});
+export const UpdateProjectTemplateOptionsSchema = z.object({
+    id: z.string().min(1),
+    updates: ProjectTemplateOverridesSchema,
+});
+export const UpdateProjectTemplateResponseSchema = z.object({
+    template: ProjectTemplateSchema,
+});
+export const DeleteProjectTemplateOptionsSchema = z.object({
+    id: z.string().min(1),
+});
+export const DeleteProjectTemplateResponseSchema = z.object({
+    deleted: z.boolean(),
+});
+export const ReorderProjectTemplatesOptionsSchema = z.object({
+    orders: z
+        .array(z.object({ id: z.string().min(1), order: z.number().int() }))
+        .min(1),
+});
+export const ReorderProjectTemplatesResponseSchema = z.object({
+    updatedIds: z.array(z.string()),
+});
+/**
+ * `id` is omitted when a built-in (non-Firestore-backed) template becomes the
+ * org default, so this just needs to clear `isDefault` on the owner's stored
+ * templates without pointing it at a new one.
+ */
+export const SetDefaultProjectTemplateOptionsSchema = z.object({
+    id: z.string().min(1).optional(),
+});
+export const SetDefaultProjectTemplateResponseSchema = z.object({
+    defaultId: z.string().nullable(),
+});

package/src/projects.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { AGENT_NATIVE_STARTER_REPO, getAgentNativeRootPackageJsonWriteError, getManagedDatabasePackageJsonError, getProjectState, GetShapeQuestionnaireOptionsSchema, InitialPromptSchema, isProjectDeleted, matchesAgentNativeStarter, ProjectHostingExternalSchema, ProjectHostingSchema, ProjectSettingsExternalSchema, ProjectSettingsSchema, ProjectTemplateOverridesSchema, ShapeSessionSchema, SubmitShapeAnswersOptionsSchema, } from "./projects";
+import { AGENT_NATIVE_STARTER_REPO, getAgentNativeRootPackageJsonWriteError, getManagedDatabasePackageJsonError, getProjectState, GetShapeQuestionnaireOptionsSchema, InitialPromptSchema, isProjectDeleted, matchesAgentNativeStarter, ProjectHostingExternalSchema, ProjectHostingSchema, ProjectSettingsExternalSchema, ProjectTemplateOverridesSchema, ShapeSessionSchema, SubmitShapeAnswersOptionsSchema, } from "./projects";
 describe("project hosting schemas", () => {
     it("accepts the canonical published branch route", () => {
         expect(ProjectHostingSchema.parse({ publishedBranchId: "branch-live" })).toEqual({ publishedBranchId: "branch-live" });
@@ -55,9 +55,6 @@ describe("guided onboarding project settings", () => {
     };
     it("parses a snapshotted questionnaire session", () => {
         expect(ShapeSessionSchema.parse(shapeSession)).toEqual(shapeSession);
-        expect(ProjectSettingsSchema.parse({ shapeSession })).toEqual({
-            shapeSession,
-        });
     });
     it("requires a dated catalog version", () => {
         expect(() => ShapeSessionSchema.parse({

package/src/realtime.d.ts

@@ -1,7 +1,8 @@
 import { z } from "zod";
 export declare const BUILDER_REALTIME_MODEL: "gpt-live-1";
 export declare const BUILDER_REALTIME_LEGACY_MODEL: "gpt-realtime-2.1";
-export declare const BUILDER_REALTIME_DELEGATED_MODEL: "gpt-5.6-luna";
+export declare const BUILDER_REALTIME_DELEGATED_MODEL: "gpt-6-luna";
+export declare const BUILDER_REALTIME_DELEGATED_MODEL_LEGACY: "gpt-5.6-luna";
 export declare const BUILDER_REALTIME_MAX_SDP_LENGTH = 256000;
 export declare const BUILDER_REALTIME_MAX_SESSION_BYTES = 64000;
 export declare const OpenAIRealtimeFunctionToolSchema: z.ZodObject<{
@@ -153,7 +154,7 @@ export declare const OpenAILiveSessionConfigSchema: z.ZodObject<{
     delegation: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
         type: z.ZodLiteral<"responses">;
         responses: z.ZodObject<{
-            model: z.ZodLiteral<"gpt-5.6-luna">;
+            model: z.ZodUnion<readonly [z.ZodLiteral<"gpt-6-luna">, z.ZodLiteral<"gpt-5.6-luna">]>;
             instructions: z.ZodOptional<z.ZodString>;
             tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
                 type: z.ZodLiteral<"function">;
@@ -212,7 +213,7 @@ export declare const BuilderRealtimeSessionRequestSchema: z.ZodObject<{
         delegation: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
             type: z.ZodLiteral<"responses">;
             responses: z.ZodObject<{
-                model: z.ZodLiteral<"gpt-5.6-luna">;
+                model: z.ZodUnion<readonly [z.ZodLiteral<"gpt-6-luna">, z.ZodLiteral<"gpt-5.6-luna">]>;
                 instructions: z.ZodOptional<z.ZodString>;
                 tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
                     type: z.ZodLiteral<"function">;

package/src/realtime.js

@@ -1,7 +1,8 @@
 import { z } from "zod";
 export const BUILDER_REALTIME_MODEL = "gpt-live-1";
 export const BUILDER_REALTIME_LEGACY_MODEL = "gpt-realtime-2.1";
-export const BUILDER_REALTIME_DELEGATED_MODEL = "gpt-5.6-luna";
+export const BUILDER_REALTIME_DELEGATED_MODEL = "gpt-6-luna";
+export const BUILDER_REALTIME_DELEGATED_MODEL_LEGACY = "gpt-5.6-luna";
 export const BUILDER_REALTIME_MAX_SDP_LENGTH = 256000;
 export const BUILDER_REALTIME_MAX_SESSION_BYTES = 64000;
 const utf8ByteLength = (value) => new TextEncoder().encode(value).length;
@@ -154,8 +155,16 @@ const OpenAILiveToolSchema = z.union([
     OpenAIRealtimeFunctionToolSchema,
     z.object({ type: z.literal("web_search") }),
 ]);
+const RealtimeDelegatedModelSchema = z
+    .union([
+    z.literal(BUILDER_REALTIME_DELEGATED_MODEL),
+    z.literal(BUILDER_REALTIME_DELEGATED_MODEL_LEGACY),
+])
+    .overwrite((model) => model === BUILDER_REALTIME_DELEGATED_MODEL_LEGACY
+    ? BUILDER_REALTIME_DELEGATED_MODEL
+    : model);
 const OpenAILiveResponsesDelegationSchema = z.object({
-    model: z.literal(BUILDER_REALTIME_DELEGATED_MODEL),
+    model: RealtimeDelegatedModelSchema,
     instructions: z.string().max(32000).optional(),
     tools: z.array(OpenAILiveToolSchema).max(32).optional(),
     tool_choice: z

package/src/realtime.spec.js

@@ -17,7 +17,7 @@ describe("BuilderRealtimeSessionRequestSchema", () => {
                 delegation: {
                     type: "responses",
                     responses: {
-                        model: "gpt-5.6-luna",
+                        model: "gpt-6-luna",
                         tools: [
                             {
                                 type: "function",
@@ -32,12 +32,25 @@ describe("BuilderRealtimeSessionRequestSchema", () => {
             },
         });
         expect(result.session).toMatchObject({
+            model: "gpt-live-1",
+            delegation: {
+                type: "responses",
+                responses: { model: "gpt-6-luna" },
+            },
+        });
+    });
+    it("normalizes the legacy delegated model name", () => {
+        const result = OpenAILiveSessionConfigSchema.parse({
             model: "gpt-live-1",
             delegation: {
                 type: "responses",
                 responses: { model: "gpt-5.6-luna" },
             },
         });
+        expect(result.delegation).toEqual({
+            type: "responses",
+            responses: { model: "gpt-6-luna" },
+        });
     });
     it("accepts a bounded audio session with tools", () => {
         var _a;

package/src/repo-indexing.d.ts

@@ -149,6 +149,10 @@ export interface DesignSystem {
      * have no code to detect from, and whenever the agent couldn't tell.
      */
     framework?: DesignSystemFramework;
+    /**
+     * @deprecated Prefer checking DisplayDesignSystem.docCount instead of relying on
+     * "in-progress" or "completed".
+     */
     status: "in-progress" | "completed" | "failed";
     scope: DesignSystemScope;
     deprecated: boolean;

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.

package/src/system-one.d.ts

@@ -1,5 +1,9 @@
 import { z } from "zod";
 export declare const SYSTEM_ONE_DEFAULT_MODEL = "jev-latest";
+export declare const SystemOneAvailabilityResponseSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type SystemOneAvailabilityResponse = z.infer<typeof SystemOneAvailabilityResponseSchema>;
 export declare const SystemOneRequestSchema: z.ZodObject<{
     state: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodUnknown>]>;
     model: z.ZodDefault<z.ZodString>;

package/src/system-one.js

@@ -1,5 +1,12 @@
 import { z } from "zod";
 export const SYSTEM_ONE_DEFAULT_MODEL = "jev-latest";
+export const SystemOneAvailabilityResponseSchema = z
+    .object({
+    enabled: z.boolean(),
+})
+    .meta({
+    description: "Response for GET /agent-native/jev/v1/status.",
+});
 const SystemOneValueSchema = z.union([
     z.string(),
     z.record(z.string(), z.unknown()),

package/src/system-one.spec.js

@@ -1,6 +1,10 @@
 import { describe, expect, it } from "vitest";
-import { SYSTEM_ONE_DEFAULT_MODEL, SystemOneRequestSchema, SystemOneResponseSchema, } from "./system-one";
+import { SYSTEM_ONE_DEFAULT_MODEL, SystemOneAvailabilityResponseSchema, SystemOneRequestSchema, SystemOneResponseSchema, } from "./system-one";
 describe("System One schemas", () => {
+    it("validates Builder availability responses", () => {
+        expect(SystemOneAvailabilityResponseSchema.parse({ enabled: true })).toEqual({ enabled: true });
+        expect(() => SystemOneAvailabilityResponseSchema.parse({ enabled: "true" })).toThrow();
+    });
     it("defaults the model and validates each question type", () => {
         const request = SystemOneRequestSchema.parse({
             state: { ticket: "export failed" },