@builder.io/ai-utils 0.65.0 → 0.66.1

package/package.json

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

package/src/codegen.d.ts

@@ -2,7 +2,8 @@ import { z } from "zod";
 import type { Options as PrettierOptions } from "prettier";
 import type { Attachment, ContentMessageItemToolResult } from "./messages";
 import type { BuilderContent } from "./completion";
-import type { ForcedBackup, SetupDependency, GitDiagnostics } from "./projects";
+import { type EnvironmentVariable, type SetupDependency } from "./common-schemas";
+import type { ForcedBackup, GitDiagnostics } from "./projects";
 import type { Feature } from "./features";
 import type { CpuKind, BranchType } from "./projects";
 export declare const GitSnapshotSchema: z.ZodString;
@@ -816,14 +817,6 @@ export declare const ExitToolInputSchema: z.ZodObject<{
     projectDescription: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ExitToolInput = z.infer<typeof ExitToolInputSchema>;
-export declare const EnvironmentVariableSchema: z.ZodObject<{
-    key: z.ZodString;
-    value: z.ZodString;
-    isSecret: z.ZodBoolean;
-    placeholder: z.ZodOptional<z.ZodBoolean>;
-    explanation: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type EnvironmentVariable = z.infer<typeof EnvironmentVariableSchema>;
 export declare const ProposedConfigSchema: z.ZodObject<{
     id: z.ZodString;
     projectId: z.ZodString;

package/src/codegen.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { AttachmentSchema, ContentMessageItemToolResultSchema, } from "./messages";
 import { UserContextSchema } from "./mapping";
-import { SetupDependencySchema } from "./projects";
+import { EnvironmentVariableSchema, SetupDependencySchema, } from "./common-schemas";
 export const GitSnapshotSchema = z.string().meta({
     title: "GitSnapshot",
     description: "Multi-repo git snapshot. Format: 'folder:hash,folder:hash' " +
@@ -906,19 +906,6 @@ const ProposedQuestionSchema = z.object({
         .meta({ description: "Placeholder text for text-type questions" }),
     options: z.array(LabelOptionSchema).optional(),
 });
-export const EnvironmentVariableSchema = z
-    .object({
-    key: z.string(),
-    value: z.string(),
-    isSecret: z.boolean(),
-    placeholder: z.boolean().optional().meta({
-        description: "If true, indicates this is a placeholder value that needs user replacement",
-    }),
-    explanation: z.string().optional().meta({
-        description: "Explanation of why this env var is needed and what value the user should provide",
-    }),
-})
-    .meta({ title: "EnvironmentVariable" });
 const ProposedConfigurationSchema = z.object({
     setupCommand: z.object({
         value: z.string().optional(),

package/src/common-schemas.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export declare const EnvironmentVariableSchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodString;
+    isSecret: z.ZodBoolean;
+    placeholder: z.ZodOptional<z.ZodBoolean>;
+    explanation: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EnvironmentVariable = z.infer<typeof EnvironmentVariableSchema>;
+export declare const SetupMiseDependencySchema: z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodLiteral<"mise">;
+    tool: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SetupMiseDependency = z.infer<typeof SetupMiseDependencySchema>;
+export declare const SetupScriptDependencySchema: z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodLiteral<"script">;
+    name: z.ZodString;
+    script: z.ZodString;
+}, z.core.$strip>;
+export type SetupScriptDependency = z.infer<typeof SetupScriptDependencySchema>;
+export declare const SetupDependencySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodLiteral<"mise">;
+    tool: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodLiteral<"script">;
+    name: z.ZodString;
+    script: z.ZodString;
+}, z.core.$strip>], "type">;
+export type SetupDependency = z.infer<typeof SetupDependencySchema>;

package/src/common-schemas.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+// ============================================================================
+// Shared leaf schemas
+//
+// These schemas defined here to break runtime dependency cycle which would
+// surface as "Cannot access '<Schema>' before initialization" depending on
+// evaluation order. Keep this module dependency-free (zod only).
+// ============================================================================
+export const EnvironmentVariableSchema = z
+    .object({
+    key: z.string(),
+    value: z.string(),
+    isSecret: z.boolean(),
+    placeholder: z.boolean().optional().meta({
+        description: "If true, indicates this is a placeholder value that needs user replacement",
+    }),
+    explanation: z.string().optional().meta({
+        description: "Explanation of why this env var is needed and what value the user should provide",
+    }),
+})
+    .meta({ title: "EnvironmentVariable" });
+export const SetupMiseDependencySchema = z
+    .object({
+    key: z.string(),
+    type: z.literal("mise"),
+    tool: z.string(),
+    version: z.string().optional(),
+})
+    .meta({ title: "SetupMiseDependency" });
+export const SetupScriptDependencySchema = z
+    .object({
+    key: z.string(),
+    type: z.literal("script"),
+    name: z.string(),
+    script: z.string(),
+})
+    .meta({ title: "SetupScriptDependency" });
+export const SetupDependencySchema = z
+    .discriminatedUnion("type", [
+    SetupMiseDependencySchema,
+    SetupScriptDependencySchema,
+])
+    .meta({ title: "SetupDependency" });

package/src/connectivity/browser.d.ts

@@ -1,7 +1,7 @@
 export type { Source, TestId, Test, RunChecksInput, ProgressEvent, CheckResult, CheckReport, ConnectivityErrorCode, CheckType, Recommendation, LikelyCause, ConnectivityStatus, AnalysisResult, AnalyzeConnectivityInput, } from "./types.js";
 export { runChecks } from "./run-checks.browser.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";
+export { BUILDER_TARGETS, DEFAULT_PORTS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, resolveTarget, extractHostname, extractPort, } from "./targets.js";
 export { isBrowser, isNode, getCheckTypeForTestId, isCheckAvailable, getUnavailabilityReason, } from "./environment.js";
 export { httpCheck } from "./checks/http-check.js";
 export type { HttpCheckOptions } from "./checks/http-check.js";

package/src/connectivity/browser.js

@@ -1,5 +1,5 @@
 export { runChecks } from "./run-checks.browser.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";
+export { BUILDER_TARGETS, DEFAULT_PORTS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, resolveTarget, extractHostname, extractPort, } from "./targets.js";
 export { isBrowser, isNode, getCheckTypeForTestId, isCheckAvailable, getUnavailabilityReason, } from "./environment.js";
 export { httpCheck } from "./checks/http-check.js";

package/src/connectivity/environment.js

@@ -7,8 +7,7 @@ export function isNode() {
         process.versions.node != null);
 }
 export function getCheckTypeForTestId(testId) {
-    if (testId === "health.builderio.xyz:ws" ||
-        testId === "health.builderio.dev:ws") {
+    if (testId === "builderio.xyz:ws" || testId === "builderio.dev:ws") {
         return "websocket";
     }
     if (testId.startsWith("git-host:")) {

package/src/connectivity/node.d.ts

@@ -1,7 +1,7 @@
 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";
+export { BUILDER_TARGETS, DEFAULT_PORTS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, resolveTarget, extractHostname, extractPort, } from "./targets.js";
 export { isBrowser, isNode, getCheckTypeForTestId, isCheckAvailable, getUnavailabilityReason, } from "./environment.js";
 export { httpCheck } from "./checks/http-check.js";
 export type { HttpCheckOptions } from "./checks/http-check.js";

package/src/connectivity/node.js

@@ -1,6 +1,6 @@
 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";
+export { BUILDER_TARGETS, DEFAULT_PORTS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, resolveTarget, extractHostname, extractPort, } from "./targets.js";
 export { isBrowser, isNode, getCheckTypeForTestId, isCheckAvailable, getUnavailabilityReason, } from "./environment.js";
 export { httpCheck } from "./checks/http-check.js";
 export { dnsCheck } from "./checks/dns-check.js";

package/src/connectivity/targets.d.ts

@@ -1,5 +1,17 @@
-import type { TestId } from "./types.js";
+import type { Test, TestId } from "./types.js";
 export declare const BUILDER_TARGETS: Record<string, string>;
+/**
+ * Canonical ordered list of Builder-service connectivity tests, matching what
+ * the Builder app's ConnectivityService runs locally. Includes the four kube
+ * domain health probes (HTTP + WebSocket) for both *.builderio.xyz and
+ * *.builderio.dev.
+ */
+export declare const DEFAULT_LOCAL_BUILDER_TESTS: Test[];
+/**
+ * Human-readable display names for Builder service testIds. Used by CLI and
+ * UI surfaces to show friendly labels instead of raw testId strings.
+ */
+export declare const BUILDER_TEST_DISPLAY_NAMES: Partial<Record<TestId, string>>;
 export declare const DEFAULT_PORTS: Record<string, number>;
 export declare function resolveTarget(testId: TestId, gitHost?: string): string;
 export declare function extractHostname(target: string): string;

package/src/connectivity/targets.js

@@ -3,12 +3,41 @@ export const BUILDER_TARGETS = {
     "builder.codes": "https://test.projects.builder.codes/proxy-health",
     "api.builder.io": "https://api.builder.io/codegen/health",
     "cdn.builder.io": "https://cdn.builder.io/api/v1/image/assets/TEMP/75a212ab82b6175c9862b125e0e23db8d369a58a?width=100",
-    "health.builderio.xyz": "https://health.builderio.xyz/health",
-    "health.builderio.xyz:ws": "wss://health.builderio.xyz/ws",
-    "health.builderio.dev": "https://health.builderio.dev/health",
-    "health.builderio.dev:ws": "wss://health.builderio.dev/ws",
+    // Health subdomains — dedicated endpoints for VPN/firewall diagnostics.
+    // The testId omits the "health." prefix for readability; the URL still
+    // targets health.builderio.* so wildcard allowlists are verified.
+    "builderio.xyz": "https://health.builderio.xyz/health",
+    "builderio.xyz:ws": "wss://health.builderio.xyz/ws",
+    "builderio.dev": "https://health.builderio.dev/health",
+    "builderio.dev:ws": "wss://health.builderio.dev/ws",
     "fly.dev": "https://fly.dev",
 };
+/**
+ * Canonical ordered list of Builder-service connectivity tests, matching what
+ * the Builder app's ConnectivityService runs locally. Includes the four kube
+ * domain health probes (HTTP + WebSocket) for both *.builderio.xyz and
+ * *.builderio.dev.
+ */
+export const DEFAULT_LOCAL_BUILDER_TESTS = [
+    { source: "local", testId: "builder.io" },
+    { source: "local", testId: "builder.codes" },
+    { source: "local", testId: "api.builder.io" },
+    { source: "local", testId: "cdn.builder.io" },
+    { source: "local", testId: "builderio.xyz" },
+    { source: "local", testId: "builderio.xyz:ws" },
+    { source: "local", testId: "builderio.dev" },
+    { source: "local", testId: "builderio.dev:ws" },
+];
+/**
+ * Human-readable display names for Builder service testIds. Used by CLI and
+ * UI surfaces to show friendly labels instead of raw testId strings.
+ */
+export const BUILDER_TEST_DISPLAY_NAMES = {
+    "builderio.xyz": "*.builderio.xyz",
+    "builderio.xyz:ws": "*.builderio.xyz (WebSocket)",
+    "builderio.dev": "*.builderio.dev",
+    "builderio.dev:ws": "*.builderio.dev (WebSocket)",
+};
 export const DEFAULT_PORTS = {
     http: 443,
     https: 443,

package/src/connectivity/targets.spec.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { extractPort, extractExplicitPort } from "./targets";
+import { extractPort, extractExplicitPort, BUILDER_TARGETS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, } from "./targets";
 describe("extractPort", () => {
     it("returns explicit port from URL", () => {
         expect(extractPort("https://git.amazon.com:2222", 443)).toBe(2222);
@@ -43,3 +43,36 @@ describe("extractExplicitPort", () => {
         expect(extractExplicitPort("not-a-url", 22)).toBe(22);
     });
 });
+describe("DEFAULT_LOCAL_BUILDER_TESTS", () => {
+    const KUBE_IDS = [
+        "builderio.xyz",
+        "builderio.xyz:ws",
+        "builderio.dev",
+        "builderio.dev:ws",
+    ];
+    it("includes all four kube domain test IDs", () => {
+        const ids = DEFAULT_LOCAL_BUILDER_TESTS.map((t) => t.testId);
+        for (const id of KUBE_IDS) {
+            expect(ids).toContain(id);
+        }
+    });
+    it("all tests have source=local", () => {
+        for (const t of DEFAULT_LOCAL_BUILDER_TESTS) {
+            expect(t.source).toBe("local");
+        }
+    });
+    it("kube testIds resolve to health subdomain URLs (testId omits health. prefix; URL does not)", () => {
+        expect(BUILDER_TARGETS["builderio.xyz"]).toBe("https://health.builderio.xyz/health");
+        expect(BUILDER_TARGETS["builderio.xyz:ws"]).toBe("wss://health.builderio.xyz/ws");
+        expect(BUILDER_TARGETS["builderio.dev"]).toBe("https://health.builderio.dev/health");
+        expect(BUILDER_TARGETS["builderio.dev:ws"]).toBe("wss://health.builderio.dev/ws");
+    });
+});
+describe("BUILDER_TEST_DISPLAY_NAMES", () => {
+    it("maps all four kube testIds to user-friendly labels", () => {
+        expect(BUILDER_TEST_DISPLAY_NAMES["builderio.xyz"]).toBe("*.builderio.xyz");
+        expect(BUILDER_TEST_DISPLAY_NAMES["builderio.xyz:ws"]).toBe("*.builderio.xyz (WebSocket)");
+        expect(BUILDER_TEST_DISPLAY_NAMES["builderio.dev"]).toBe("*.builderio.dev");
+        expect(BUILDER_TEST_DISPLAY_NAMES["builderio.dev:ws"]).toBe("*.builderio.dev (WebSocket)");
+    });
+});

package/src/connectivity/types.d.ts

@@ -1,5 +1,5 @@
 export type Source = "local" | "cloud" | "static-ip";
-export type TestId = "builder.io" | "builder.codes" | "api.builder.io" | "cdn.builder.io" | "health.builderio.xyz" | "health.builderio.xyz:ws" | "health.builderio.dev" | "health.builderio.dev:ws" | "fly.dev" | "git-host:http" | "git-host:dns" | "git-host:tcp" | "git-host:tls" | "git-host:ssh";
+export type TestId = "builder.io" | "builder.codes" | "api.builder.io" | "cdn.builder.io" | "builderio.xyz" | "builderio.xyz:ws" | "builderio.dev" | "builderio.dev:ws" | "fly.dev" | "git-host:http" | "git-host:dns" | "git-host:tcp" | "git-host:tls" | "git-host:ssh";
 export interface Test {
     source: Source;
     testId: TestId;

package/src/index.d.ts

@@ -3,6 +3,7 @@ export * from "./events.js";
 export * from "./messages.js";
 export * from "./settings.js";
 export * from "./mapping.js";
+export * from "./common-schemas.js";
 export * from "./codegen.js";
 export * from "./diff-hunks.js";
 export * from "./projects.js";

package/src/index.js

@@ -3,6 +3,7 @@ export * from "./events.js";
 export * from "./messages.js";
 export * from "./settings.js";
 export * from "./mapping.js";
+export * from "./common-schemas.js";
 export * from "./codegen.js";
 export * from "./diff-hunks.js";
 export * from "./projects.js";

package/src/organization.d.ts

@@ -1,4 +1,5 @@
-import type { EnvironmentVariable, PrivacyMode, ReviewEffort } from "./codegen";
+import type { PrivacyMode, ReviewEffort } from "./codegen";
+import type { EnvironmentVariable } from "./common-schemas";
 export interface GithubEnterpriseSetupValue {
     host: string;
     clientId: string;

package/src/projects.d.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import type { ConnectivityErrorCode, CheckType, LikelyCause } from "./connectivity/types.js";
-import type { FileOverride, EnvironmentVariable, LaunchServerState, LaunchServerStatus, BranchBackup, CommitMode, CustomInstruction, CustomAgentDefinition, GitSnapshot, AutoPushMode, GenerateUserMessage, CodeGenToolMap, GenerateCompletionStep, ReviewEffort } from "./codegen";
+import { type EnvironmentVariable, type SetupDependency } from "./common-schemas";
+import type { FileOverride, LaunchServerState, LaunchServerStatus, BranchBackup, CommitMode, CustomInstruction, CustomAgentDefinition, GitSnapshot, AutoPushMode, GenerateUserMessage, CodeGenToolMap, GenerateCompletionStep, ReviewEffort } from "./codegen";
 import type { FallbackTokensPrivate } from "./organization";
 /**
  * Temporary type for date fields during migration.
@@ -328,32 +329,6 @@ export type ShutdownResponse = {
 export type ShutdownResponseSerialized = Omit<ShutdownResponse, "error"> & {
     error?: string;
 };
-export declare const SetupMiseDependencySchema: z.ZodObject<{
-    key: z.ZodString;
-    type: z.ZodLiteral<"mise">;
-    tool: z.ZodString;
-    version: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type SetupMiseDependency = z.infer<typeof SetupMiseDependencySchema>;
-export declare const SetupScriptDependencySchema: z.ZodObject<{
-    key: z.ZodString;
-    type: z.ZodLiteral<"script">;
-    name: z.ZodString;
-    script: z.ZodString;
-}, z.core.$strip>;
-export type SetupScriptDependency = z.infer<typeof SetupScriptDependencySchema>;
-export declare const SetupDependencySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    key: z.ZodString;
-    type: z.ZodLiteral<"mise">;
-    tool: z.ZodString;
-    version: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    key: z.ZodString;
-    type: z.ZodLiteral<"script">;
-    name: z.ZodString;
-    script: z.ZodString;
-}, z.core.$strip>], "type">;
-export type SetupDependency = z.infer<typeof SetupDependencySchema>;
 export type FusionExecutionEnvironment = "containerized" | "container-less" | "cloud" | "cloud-v2";
 export type AgentType = "setup-project" | "project-configuration" | "org-agent" | "code-review-orchestrator" | "design-system-indexer" | "builder-publish-integration";
 export interface PartialBranchData {
@@ -889,6 +864,8 @@ export interface Project {
     userInitiatedAutoSetup?: boolean;
     /** When true, automatically apply verified setup configuration when the setup agent completes */
     autoApplySetup?: boolean;
+    /** Settings related to Fusion fist class hosting */
+    hosting?: ProjectHosting;
 }
 /**
  * Get the state of a branch, checking `state` first and falling back to `deleted` for backwards compatibility.
@@ -1235,4 +1212,106 @@ export interface ShouldDeletePodResponse {
     reason: "branch_inactive" | "force_delete_flag" | "project_not_found" | "branch_not_found" | "ok" | "error";
     error?: string;
 }
+/**
+ * Deploy lifecycle status:
+ * - queued     - inital state although we don't currently queue deploys per se
+ * - building   — deploy pod is running `npm run build`
+ * - uploading  — build succeeded; artifacts being uploaded to GCS (transient,
+ *                between `client.devtools.build.completed` and `client.devtools.build.uploaded`)
+ * - deploying  — queue handler is pushing artifacts to Netlify + updating Envoy HTTPRoute
+ * - live       — terminal: site is serving traffic
+ * - failed     — terminal: see `error` for the one-line reason
+ */
+export declare const DeployStatusSchema: z.ZodEnum<{
+    building: "building";
+    deploying: "deploying";
+    failed: "failed";
+    live: "live";
+    queued: "queued";
+    uploading: "uploading";
+}>;
+export type DeployStatus = z.infer<typeof DeployStatusSchema>;
+export declare const ProjectHostingBuildConfigSchema: z.ZodObject<{
+    buildCommand: z.ZodOptional<z.ZodString>;
+    nodeVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProjectHostingBuildConfig = z.infer<typeof ProjectHostingBuildConfigSchema>;
+/**
+ * Hosting configuration for a project, stored at `projects/{projectId}.hosting`.
+ */
+export declare const ProjectHostingSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    slug: z.ZodOptional<z.ZodString>;
+    netlifySiteId: z.ZodOptional<z.ZodString>;
+    netlifySiteName: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    buildConfig: z.ZodOptional<z.ZodObject<{
+        buildCommand: z.ZodOptional<z.ZodString>;
+        nodeVersion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    environment: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+        isSecret: z.ZodBoolean;
+        placeholder: z.ZodOptional<z.ZodBoolean>;
+        explanation: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    lastDeployId: z.ZodOptional<z.ZodString>;
+    lastDeployAt: z.ZodOptional<z.ZodNumber>;
+    lastDeployStatus: z.ZodOptional<z.ZodEnum<{
+        building: "building";
+        deploying: "deploying";
+        failed: "failed";
+        live: "live";
+        queued: "queued";
+        uploading: "uploading";
+    }>>;
+    customDomain: z.ZodOptional<z.ZodString>;
+    customDomainVerified: z.ZodOptional<z.ZodBoolean>;
+    autoDeploy: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ProjectHosting = z.infer<typeof ProjectHostingSchema>;
+/**
+ * A single deploy record, stored at `deploys/{deployId}`. The Deploy.id is the document key.
+ */
+export declare const DeploySchema: z.ZodObject<{
+    id: z.ZodString;
+    projectId: z.ZodString;
+    ownerId: z.ZodString;
+    checkoutBranch: z.ZodOptional<z.ZodString>;
+    deployBranchId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        building: "building";
+        deploying: "deploying";
+        failed: "failed";
+        live: "live";
+        queued: "queued";
+        uploading: "uploading";
+    }>;
+    netlifyDeployId: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+    triggeredBy: z.ZodString;
+}, z.core.$strip>;
+export type Deploy = z.infer<typeof DeploySchema>;
+/**
+ * Permanent slug reservation, stored at `hosting-slugs/{slug}` (slug is the document key).
+ *
+ * Created on first publish via the atomic Firestore transaction in
+ * `POST /projects/hosting/reserve-slug`. Never deleted (URL hijacking protection).
+ *
+ * "Is this URL currently live?" is NOT a property of this doc. It's answered by the
+ * presence of the per-slug `HTTPRoute` in Envoy Gateway (the source of truth for routing)
+ * and/or by `project.hosting.netlifySiteId` (set on publish, cleared on unpublish). The
+ * slug doc exists purely to enforce uniqueness and own the permanent reservation.
+ */
+export declare const HostingSlugSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    ownerId: z.ZodString;
+    createdAt: z.ZodNumber;
+    createdBy: z.ZodString;
+}, z.core.$strip>;
+export type HostingSlug = z.infer<typeof HostingSlugSchema>;
 export {};

package/src/projects.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { EnvironmentVariableSchema, } from "./common-schemas";
 /**
  * Detect git provider from a repository URL (HTTPS or SSH).
  * Used by both error diagnostics and connectivity checks for consistent provider labeling.
@@ -37,28 +38,6 @@ export const STARTER_REPO = "BuilderIO/fusion-starter";
 export const DSI_PREVIEW_REPO = "BuilderIO/dsi-starter";
 export const EXAMPLE_OR_STARTER_REPOS = [...EXAMPLE_REPOS, STARTER_REPO];
 export const EXAMPLE_OR_STARTER_REPOS_URLS = EXAMPLE_OR_STARTER_REPOS.map((repo) => `https://github.com/${repo}`);
-export const SetupMiseDependencySchema = z
-    .object({
-    key: z.string(),
-    type: z.literal("mise"),
-    tool: z.string(),
-    version: z.string().optional(),
-})
-    .meta({ title: "SetupMiseDependency" });
-export const SetupScriptDependencySchema = z
-    .object({
-    key: z.string(),
-    type: z.literal("script"),
-    name: z.string(),
-    script: z.string(),
-})
-    .meta({ title: "SetupScriptDependency" });
-export const SetupDependencySchema = z
-    .discriminatedUnion("type", [
-    SetupMiseDependencySchema,
-    SetupScriptDependencySchema,
-])
-    .meta({ title: "SetupDependency" });
 export const checkIsNewBranch = (branch) => {
     return "projectId" in branch;
 };
@@ -185,3 +164,124 @@ export function parseExitPlanMode(chunk) {
     }
     return null;
 }
+// ============================================================================
+// First-class Hosting
+// ============================================================================
+/**
+ * Deploy lifecycle status:
+ * - queued     - inital state although we don't currently queue deploys per se
+ * - building   — deploy pod is running `npm run build`
+ * - uploading  — build succeeded; artifacts being uploaded to GCS (transient,
+ *                between `client.devtools.build.completed` and `client.devtools.build.uploaded`)
+ * - deploying  — queue handler is pushing artifacts to Netlify + updating Envoy HTTPRoute
+ * - live       — terminal: site is serving traffic
+ * - failed     — terminal: see `error` for the one-line reason
+ */
+export const DeployStatusSchema = z.enum([
+    "queued",
+    "building",
+    "uploading",
+    "deploying",
+    "live",
+    "failed",
+]);
+export const ProjectHostingBuildConfigSchema = z.object({
+    buildCommand: z.string().optional(),
+    nodeVersion: z.string().optional(),
+});
+/**
+ * Hosting configuration for a project, stored at `projects/{projectId}.hosting`.
+ */
+export const ProjectHostingSchema = z.object({
+    enabled: z.boolean().optional().meta({
+        description: "Whether hosting is enabled for this project or not.",
+    }),
+    slug: z.string().optional().meta({
+        description: 'e.g. "my-cool-app" — set once on first publish, immutable',
+    }),
+    netlifySiteId: z.string().optional().meta({
+        description: "Netlify site ID for management API calls; cleared on unpublish, set again on re-publish",
+    }),
+    netlifySiteName: z.string().optional().meta({
+        description: "<name> in <name>.netlify.app — the upstream the HTTPRoute filter rewrites Host to; cleared on unpublish",
+    }),
+    url: z.string().optional().meta({
+        description: '"https://my-cool-app.builder.cloud" — derived from slug',
+    }),
+    buildConfig: ProjectHostingBuildConfigSchema.optional(),
+    /**
+     * Hosting-build environment variables. Separate from `project.settings.environmentVariables`
+     * (which feeds the dev pod) so users can set different values for dev vs production —
+     * mirrors the Vercel/Netlify split between development and production env scopes.
+     *
+     * Reuses `EnvironmentVariableSchema`, including the `isSecret: boolean` flag. Stored in
+     * plaintext in Firestore, masked on the read path before responses leave ai-services
+     * (see "Secret handling" in the hosting spec).
+     */
+    environment: z.array(EnvironmentVariableSchema).optional().meta({
+        description: "Production environment variables set when we deploy",
+    }),
+    lastDeployId: z.string().optional(),
+    lastDeployAt: z.number().optional(),
+    lastDeployStatus: DeployStatusSchema.optional(),
+    customDomain: z.string().optional(),
+    customDomainVerified: z.boolean().optional(),
+    autoDeploy: z
+        .boolean()
+        .optional()
+        .meta({ description: "auto-deploy on push/merge" }),
+});
+/**
+ * A single deploy record, stored at `deploys/{deployId}`. The Deploy.id is the document key.
+ */
+export const DeploySchema = z.object({
+    id: z.string(),
+    projectId: z.string(),
+    ownerId: z.string(),
+    checkoutBranch: z
+        .string()
+        .optional()
+        .meta({
+        description: 'The git ref that was deployed (always "main" in v0/v1; the feature branch ' +
+            "for row 2 in v2). This is the value passed as `checkoutBranch` when the " +
+            "deploy pod was created.",
+    }),
+    deployBranchId: z
+        .string()
+        .optional()
+        .meta({
+        description: 'ID of the ephemeral hidden deploy branch (`type: "deploy"`) that ran the ' +
+            "build. Cleared after the pod terminates so historical Deploy docs don't " +
+            "hold references to garbage-collected branch state.",
+    }),
+    status: DeployStatusSchema,
+    netlifyDeployId: z.string().optional(),
+    url: z.string().optional(),
+    error: z.string().optional().meta({
+        description: "Single human-readable line on failure; raw build logs not surfaced in v0",
+    }),
+    createdAt: z.number(),
+    completedAt: z.number().optional(),
+    triggeredBy: z.string().meta({
+        description: 'user ID for manual publish, or "auto-deploy" (v1)',
+    }),
+});
+/**
+ * Permanent slug reservation, stored at `hosting-slugs/{slug}` (slug is the document key).
+ *
+ * Created on first publish via the atomic Firestore transaction in
+ * `POST /projects/hosting/reserve-slug`. Never deleted (URL hijacking protection).
+ *
+ * "Is this URL currently live?" is NOT a property of this doc. It's answered by the
+ * presence of the per-slug `HTTPRoute` in Envoy Gateway (the source of truth for routing)
+ * and/or by `project.hosting.netlifySiteId` (set on publish, cleared on unpublish). The
+ * slug doc exists purely to enforce uniqueness and own the permanent reservation.
+ */
+export const HostingSlugSchema = z.object({
+    projectId: z.string(),
+    ownerId: z.string(),
+    createdAt: z.number(),
+    createdBy: z.string().meta({
+        description: "user ID of the user who first clicked Publish on the project",
+    }),
+});