@builder.io/ai-utils 0.83.0 → 0.84.0-dev.202607212345.137e4170f

package/src/design-systems.js

@@ -1,45 +1,19 @@
 import { z } from "zod";
 /**
  * Accepts `https://github.com/<owner>/<repo>` (optionally with a trailing
- * `.git` or path segments). Used to gate the public-repo input on the
- * `/design-systems/v1/generate` endpoint.
+ * `.git` or path segments). Used to gate public-repo inputs before cloning.
  */
 export const GITHUB_REPO_URL_REGEX = /^https:\/\/github\.com\/[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+(?:\.git)?\/?$/;
 export const GENERATE_DESIGN_SYSTEM_MAX_FILE_BYTES = 2 * 1024 * 1024 * 1024;
 export const GENERATE_DESIGN_SYSTEM_MAX_ATTACHMENTS = 50;
 export const GENERATE_DESIGN_SYSTEM_MIN_ATTACHMENTS = 0;
-export const generateDesignSystemBodySchema = z.object({
-    projectName: z.string().trim().min(1).max(200).optional(),
-    devToolsVersion: z.string().trim().min(1).max(64).optional(),
-    selection: z
-        .preprocess((v) => {
-        if (typeof v !== "string")
-            return v;
-        const trimmed = v.trim();
-        if (!trimmed)
-            return undefined;
-        try {
-            return JSON.parse(trimmed);
-        }
-        catch (_a) {
-            return v;
-        }
-    }, z.record(z.string(), z.array(z.string().min(1)).max(10000)))
-        .optional(),
-    githubRepoUrl: z
-        .string()
-        .trim()
-        .regex(GITHUB_REPO_URL_REGEX, "must be a public github.com repo URL")
-        .optional(),
-    connectedProjectId: z.string().trim().min(1).max(128).optional(),
-});
 /**
  * Signed-URL upload flow.
  *
  * Clients no longer post `.fig` bytes through the service (Cloud Run caps
  * request bodies at 32 MiB). Instead they call `upload/start` to get a
  * temporary signed resumable-upload URL per attachment, stream the bytes
- * directly to GCS, then call `/generate` with the returned upload tokens.
+ * directly to GCS, then call `/index` with the returned upload tokens.
  * See `tech-specs/signed-url-figma-upload`.
  */
 /** A single attachment the client declares when starting an upload. */
@@ -61,7 +35,7 @@ export const uploadStartBodySchema = z.object({
 });
 /**
  * Claims encoded inside a signed `uploadToken`. Bound to the GCS object at
- * `upload/start` and verified at `/generate`, so a client cannot point the
+ * `upload/start` and verified at `/index`, so a client cannot point the
  * decode worker at an object it did not upload.
  */
 export const uploadTokenPayloadSchema = z.object({
@@ -73,15 +47,93 @@ export const uploadTokenPayloadSchema = z.object({
     idx: z.number().int().nonnegative(),
     declaredSize: z.number().int().nonnegative().optional(),
 });
-/**
- * Request body for the signed-URL variant of `POST /design-systems/v1/generate`.
- * Same non-file fields as the legacy multipart form, plus the `uploads`
- * tokens returned by `upload/start` (one per attachment).
- */
-export const generateDesignSystemRequestSchema = z.object({
-    ...generateDesignSystemBodySchema.shape,
-    uploads: z
-        .array(z.string().min(1))
-        .min(GENERATE_DESIGN_SYSTEM_MIN_ATTACHMENTS)
+export const indexDesignSystemScopeSchema = z.enum([
+    "space",
+    "organization",
+    "global",
+]);
+export const fullLibrarySourceKindSchema = z.enum([
+    "connected-repo",
+    "public-repo",
+    "package",
+]);
+const connectedRepoSourceSchema = z.object({
+    kind: z.literal("connected-repo"),
+    fusionProjectId: z.string().min(1),
+    include: z.array(z.string()).optional(),
+    exclude: z.array(z.string()).optional(),
+    instructions: z.string().optional(),
+});
+const publicRepoSourceSchema = z.object({
+    kind: z.literal("public-repo"),
+    repoUrl: z.string().url(),
+    include: z.array(z.string()).optional(),
+    exclude: z.array(z.string()).optional(),
+    instructions: z.string().optional(),
+});
+const packageSourceSchema = z.object({
+    kind: z.literal("package"),
+    package: z.string().min(1),
+    registry: z.string().optional(),
+    token: z.string().optional(),
+    instructions: z.string().optional(),
+});
+export const fullLibrarySourceSchema = z.discriminatedUnion("kind", [
+    connectedRepoSourceSchema,
+    publicRepoSourceSchema,
+    packageSourceSchema,
+]);
+export const fileSourceSchema = z.object({
+    kind: z.literal("file"),
+    uploadToken: z.string().min(1).optional(),
+    uploadGcsPath: z.string().min(1).optional(),
+    /** Optional map of filename → page/frame GUIDs to restrict Figma indexing. */
+    selection: z.record(z.string(), z.array(z.string().min(1))).optional(),
+    instructions: z.string().optional(),
+});
+export const designSystemSourceSchema = z
+    .discriminatedUnion("kind", [
+    connectedRepoSourceSchema,
+    publicRepoSourceSchema,
+    packageSourceSchema,
+    fileSourceSchema,
+])
+    .refine((s) => s.kind !== "file" || !!s.uploadToken || !!s.uploadGcsPath, {
+    message: "File sources require either uploadToken or uploadGcsPath.",
+});
+export const resolvePackageOptionsSchema = z.object({
+    /** Package name, optionally with an embedded version ("@ionic/core@7.0.0"). */
+    package: z.string().min(1),
+    registry: z.string().optional(),
+    token: z.string().optional(),
+    specifier: z.string().optional(),
+});
+export const indexDesignSystemBodySchema = z.object({
+    designSystemName: z.string().optional(),
+    scope: indexDesignSystemScopeSchema.optional(),
+    sources: z
+        .array(designSystemSourceSchema)
+        .min(1)
         .max(GENERATE_DESIGN_SYSTEM_MAX_ATTACHMENTS),
 });
+export const sourceFileEntrySchema = z.object({
+    name: z.string(),
+    /** Repo-relative path (POSIX separators). */
+    path: z.string(),
+    type: z.enum(["dir", "file"]),
+});
+export const listSourceFilesQuerySchema = z.object({
+    projectId: z.string().min(1),
+    /** Directory to list, repo-relative. Empty/omitted → repo root. */
+    path: z.string().optional(),
+    /** Git ref (branch or sha). Omitted → the repo's default branch. */
+    ref: z.string().optional(),
+});
+export const listPublicSourceFilesQuerySchema = z.object({
+    /** Full repo URL (e.g. https://github.com/owner/repo). GitHub only. */
+    repoUrl: z.string().url(),
+    /** Directory to list, repo-relative. Empty/omitted → repo root. */
+    path: z.string().optional(),
+    /** Git ref (branch or sha). Omitted → the repo's default branch. */
+    ref: z.string().optional(),
+});

package/src/events.d.ts

@@ -1071,6 +1071,8 @@ export type FigmaDecodeJobV1 = FusionEventVariant<"figma.decode.job", {
      * file-local, so they must be scoped per attachment.
      */
     selection?: Record<string, string[]>;
+    /** Freeform notes to guide indexing, forwarded to the indexer agent. */
+    instructions?: string;
 }, {}, 1>;
 export declare const FigmaDecodeJobV1: {
     eventName: "figma.decode.job";
@@ -1157,6 +1159,8 @@ export interface FigmaFrameManifest {
     githubRepo?: FigmaGithubRepoSource;
     /** True if one or more frame chunk uploads failed; some frames may be missing. */
     partialFailure?: boolean;
+    /** Freeform notes from the caller to guide indexing. */
+    instructions?: string;
 }
 export type PrReviewRequestedV1 = FusionEventVariant<"pr.review.requested", {
     repoFullName: string;
@@ -1296,7 +1300,34 @@ export declare const McpPrototypePulledV1: {
     eventName: "mcp.prototype.pulled";
     version: "1";
 };
-export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | ClientDevtoolsBuildMigratedV1 | ClientDevtoolsBuildCompletedV1 | ClientDevtoolsBuildUploadedV1 | ClientDevtoolsBuildFailedV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionGitHubExternalPrV1 | BotMentionGitHubInternalPrV1 | BotMentionGitLabPrV1 | BotMentionBitbucketPrV1 | BotMentionAzurePrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1 | McpPrototypePulledV1;
+export type HostingCustomDomainCertCheckV1 = FusionEventVariant<"hosting.custom-domain.cert-check", {
+    domain: string;
+    projectId: string;
+    certId: string;
+    attemptId: string;
+    startedAtMs: number;
+    timeoutMs: number;
+}, {
+    projectId: string;
+}, 1>;
+export declare const HostingCustomDomainCertCheckV1: {
+    eventName: "hosting.custom-domain.cert-check";
+    version: "1";
+};
+export type HostingCustomDomainDelegationCheckV1 = FusionEventVariant<"hosting.custom-domain.delegation-check", {
+    domain: string;
+    projectId: string;
+    attemptId: string;
+    startedAtMs: number;
+    timeoutMs: number;
+}, {
+    projectId: string;
+}, 1>;
+export declare const HostingCustomDomainDelegationCheckV1: {
+    eventName: "hosting.custom-domain.delegation-check";
+    version: "1";
+};
+export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | ClientDevtoolsBuildMigratedV1 | ClientDevtoolsBuildCompletedV1 | ClientDevtoolsBuildUploadedV1 | ClientDevtoolsBuildFailedV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionGitHubExternalPrV1 | BotMentionGitHubInternalPrV1 | BotMentionGitLabPrV1 | BotMentionBitbucketPrV1 | BotMentionAzurePrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1 | McpPrototypePulledV1 | HostingCustomDomainCertCheckV1 | HostingCustomDomainDelegationCheckV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -162,3 +162,11 @@ export const McpPrototypePulledV1 = {
     eventName: "mcp.prototype.pulled",
     version: "1",
 };
+export const HostingCustomDomainCertCheckV1 = {
+    eventName: "hosting.custom-domain.cert-check",
+    version: "1",
+};
+export const HostingCustomDomainDelegationCheckV1 = {
+    eventName: "hosting.custom-domain.delegation-check",
+    version: "1",
+};

package/src/perf-report.d.ts

@@ -0,0 +1,116 @@
+import { z } from "zod";
+export declare const CURRENT_PERF_REPORT_SCHEMA_VERSION = 1;
+export declare const PerfIncidentTypeSchema: z.ZodEnum<{
+    hang: "hang";
+    "memory-pressure": "memory-pressure";
+    "recovered-hang": "recovered-hang";
+    "recovered-unclean-exit": "recovered-unclean-exit";
+    "renderer-crash": "renderer-crash";
+}>;
+export type PerfIncidentType = z.infer<typeof PerfIncidentTypeSchema>;
+export declare const PerfProcessSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        browser: "browser";
+        child: "child";
+        gpu: "gpu";
+        renderer: "renderer";
+        utility: "utility";
+    }>;
+    pid: z.ZodNumber;
+    memoryKb: z.ZodNumber;
+    cpuPercent: z.ZodNumber;
+    tabId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PerfProcess = z.infer<typeof PerfProcessSchema>;
+export declare const PerfTabSchema: z.ZodObject<{
+    tabId: z.ZodString;
+    route: z.ZodOptional<z.ZodString>;
+    feature: z.ZodOptional<z.ZodString>;
+    jsHeapUsedKb: z.ZodOptional<z.ZodNumber>;
+    jsHeapLimitKb: z.ZodOptional<z.ZodNumber>;
+    subsystems: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    livenessLatencyMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PerfTab = z.infer<typeof PerfTabSchema>;
+export declare const PerfSampleSchema: z.ZodObject<{
+    t: z.ZodNumber;
+    desktopFootprintKb: z.ZodNumber;
+    freeMemoryKb: z.ZodNumber;
+    perTabHeapKb: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+export type PerfSample = z.infer<typeof PerfSampleSchema>;
+export declare const PerfReportSchema: z.ZodObject<{
+    schemaVersion: z.ZodNumber;
+    incidentType: z.ZodEnum<{
+        hang: "hang";
+        "memory-pressure": "memory-pressure";
+        "recovered-hang": "recovered-hang";
+        "recovered-unclean-exit": "recovered-unclean-exit";
+        "renderer-crash": "renderer-crash";
+    }>;
+    sessionId: z.ZodString;
+    deviceId: z.ZodString;
+    appVersion: z.ZodString;
+    platform: z.ZodEnum<{
+        darwin: "darwin";
+        linux: "linux";
+        win32: "win32";
+    }>;
+    channel: z.ZodEnum<{
+        alpha: "alpha";
+        stable: "stable";
+    }>;
+    timestamp: z.ZodNumber;
+    machine: z.ZodObject<{
+        totalMemoryKb: z.ZodNumber;
+        freeMemoryKb: z.ZodNumber;
+        desktopFootprintKb: z.ZodNumber;
+    }, z.core.$strip>;
+    processes: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            browser: "browser";
+            child: "child";
+            gpu: "gpu";
+            renderer: "renderer";
+            utility: "utility";
+        }>;
+        pid: z.ZodNumber;
+        memoryKb: z.ZodNumber;
+        cpuPercent: z.ZodNumber;
+        tabId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    tabs: z.ZodArray<z.ZodObject<{
+        tabId: z.ZodString;
+        route: z.ZodOptional<z.ZodString>;
+        feature: z.ZodOptional<z.ZodString>;
+        jsHeapUsedKb: z.ZodOptional<z.ZodNumber>;
+        jsHeapLimitKb: z.ZodOptional<z.ZodNumber>;
+        subsystems: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        livenessLatencyMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    crash: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodString;
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        oom: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    hang: z.ZodOptional<z.ZodObject<{
+        startedAt: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        recovered: z.ZodBoolean;
+        surface: z.ZodString;
+    }, z.core.$strip>>;
+    samples: z.ZodArray<z.ZodObject<{
+        t: z.ZodNumber;
+        desktopFootprintKb: z.ZodNumber;
+        freeMemoryKb: z.ZodNumber;
+        perTabHeapKb: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PerfReport = z.infer<typeof PerfReportSchema>;
+/**
+ * Collapses opaque identifiers out of a route/URL so a report can't carry a
+ * project/space id. Keeps the structural shape (which screen was open) while
+ * masking the specific resource.
+ */
+export declare function redactPerfRoute(route: string | undefined): string | undefined;
+export declare function redactPerfReport(report: PerfReport): PerfReport;

package/src/perf-report.js

@@ -0,0 +1,122 @@
+import { z } from "zod";
+// ============================================================================
+// Desktop performance & crash monitoring wire contract.
+//
+// Canonical schema. The Electron desktop app lives in a separate workspace and
+// cannot import this file, so it keeps a hand-mirrored TypeScript type in
+// code/packages/electron-app/src/perf-report.types.ts. Keep the two in sync and
+// bump CURRENT_PERF_REPORT_SCHEMA_VERSION on any breaking shape change.
+// ============================================================================
+export const CURRENT_PERF_REPORT_SCHEMA_VERSION = 1;
+export const PerfIncidentTypeSchema = z.enum([
+    "renderer-crash",
+    "hang",
+    "recovered-hang",
+    "memory-pressure",
+    "recovered-unclean-exit",
+]);
+export const PerfProcessSchema = z.object({
+    kind: z.enum(["browser", "renderer", "gpu", "utility", "child"]),
+    pid: z.number(),
+    memoryKb: z.number(),
+    cpuPercent: z.number(),
+    tabId: z.string().optional(),
+});
+export const PerfTabSchema = z.object({
+    tabId: z.string(),
+    route: z.string().optional(),
+    feature: z.string().optional(),
+    jsHeapUsedKb: z.number().optional(),
+    jsHeapLimitKb: z.number().optional(),
+    subsystems: z.record(z.string(), z.number()),
+    livenessLatencyMs: z.number().optional(),
+});
+export const PerfSampleSchema = z.object({
+    t: z.number(),
+    desktopFootprintKb: z.number(),
+    freeMemoryKb: z.number(),
+    perTabHeapKb: z.record(z.string(), z.number()),
+});
+export const PerfReportSchema = z.object({
+    schemaVersion: z.number(),
+    incidentType: PerfIncidentTypeSchema,
+    sessionId: z.string(),
+    deviceId: z.string(),
+    appVersion: z.string(),
+    platform: z.enum(["darwin", "win32", "linux"]),
+    channel: z.enum(["stable", "alpha"]),
+    timestamp: z.number(),
+    machine: z.object({
+        totalMemoryKb: z.number(),
+        freeMemoryKb: z.number(),
+        desktopFootprintKb: z.number(),
+    }),
+    processes: z.array(PerfProcessSchema),
+    tabs: z.array(PerfTabSchema),
+    crash: z
+        .object({
+        reason: z.string(),
+        exitCode: z.number().optional(),
+        oom: z.boolean().optional(),
+    })
+        .optional(),
+    hang: z
+        .object({
+        startedAt: z.number(),
+        durationMs: z.number(),
+        recovered: z.boolean(),
+        surface: z.string(),
+    })
+        .optional(),
+    samples: z.array(PerfSampleSchema),
+});
+// ---------------------------------------------------------------------------
+// Route/URL redaction. The desktop client redacts before sending; this runs
+// again at ingest (defense in depth) because the service cannot import the
+// renderer's redactSnapshot helper across the workspace boundary.
+// ---------------------------------------------------------------------------
+const PROJECT_ID_SEGMENTS = new Set([
+    "projects",
+    "content",
+    "fusion",
+    "space",
+    "org",
+    "organization",
+]);
+/**
+ * Collapses opaque identifiers out of a route/URL so a report can't carry a
+ * project/space id. Keeps the structural shape (which screen was open) while
+ * masking the specific resource.
+ */
+export function redactPerfRoute(route) {
+    if (!route) {
+        return route;
+    }
+    const [pathPart] = route.split("?");
+    const segments = pathPart.split("/");
+    const redacted = segments.map((segment, index) => {
+        var _a;
+        if (!segment) {
+            return segment;
+        }
+        const previous = (_a = segments[index - 1]) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+        if (previous && PROJECT_ID_SEGMENTS.has(previous)) {
+            return ":id";
+        }
+        // Bare id-looking segments (uuids, long hex/base62 tokens).
+        if (/^[0-9a-f]{16,}$/i.test(segment) || /^[0-9a-z]{20,}$/i.test(segment)) {
+            return ":id";
+        }
+        return segment;
+    });
+    return redacted.join("/");
+}
+export function redactPerfReport(report) {
+    return {
+        ...report,
+        tabs: report.tabs.map((tab) => ({
+            ...tab,
+            route: redactPerfRoute(tab.route),
+        })),
+    };
+}

package/src/projects.d.ts

@@ -229,6 +229,7 @@ export type GitConfigs = Record<string, GitConfig>;
 export declare const EXAMPLE_REPOS: string[];
 export declare const STARTER_REPO = "BuilderIO/fusion-starter";
 export declare const DSI_PREVIEW_REPO = "BuilderIO/dsi-starter";
+export declare const DSI_PLACEHOLDER_REPO = "BuilderIO/dsi-placeholder";
 export declare const AGENT_NATIVE_STARTER_REPO = "BuilderIO/builder-agent-native-starter";
 export declare const EXAMPLE_OR_STARTER_REPOS: string[];
 export declare const EXAMPLE_OR_STARTER_REPOS_URLS: string[];
@@ -378,7 +379,7 @@ export interface ProjectSkillUrl extends ProjectSkillBase {
 }
 export type ProjectSkill = ProjectSkillSource | ProjectSkillNpm | ProjectSkillGithub | ProjectSkillUrl;
 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 type AgentType = "setup-project" | "project-configuration" | "org-agent" | "code-review-orchestrator" | "design-system-indexer" | "repo-indexer" | "builder-publish-integration";
 export interface PartialBranchData {
     name?: string;
     createdBy: string;
@@ -489,7 +490,7 @@ export interface OrgAgentConfig {
 }
 export type BranchType = "code-review" | "setup-project"
 /** Hidden branch the webapp creates when the user picks manual setup. */
- | "manual-setup" | "org-agent" | "snapshot-build" | "design-system-indexing" | "deploy" | "default";
+ | "manual-setup" | "org-agent" | "snapshot-build" | "design-system-indexing" | "repo-indexing" | "deploy" | "default";
 /** Category of work a branch represents, auto-assigned during prompt analysis. */
 export type BranchCategory = "feature" | "fix" | "research" | "other";
 export interface BranchSharedData {
@@ -1489,9 +1490,8 @@ export declare const ProjectHostingSchema: z.ZodObject<{
         uploading: "uploading";
     }>>;
     publishedCommit: z.ZodOptional<z.ZodString>;
-    customDomain: z.ZodOptional<z.ZodString>;
-    customDomainVerified: z.ZodOptional<z.ZodBoolean>;
     autoDeploy: z.ZodOptional<z.ZodBoolean>;
+    domainIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type ProjectHosting = z.infer<typeof ProjectHostingSchema>;
 /**
@@ -1710,6 +1710,113 @@ export declare const GetDeploysResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type GetDeploysResponse = z.infer<typeof GetDeploysResponseSchema>;
+export declare const HostingDomainStatusSchema: z.ZodEnum<{
+    active: "active";
+    failed: "failed";
+    pending: "pending";
+    provisioning: "provisioning";
+    verifying: "verifying";
+}>;
+export type HostingDomainStatus = z.infer<typeof HostingDomainStatusSchema>;
+export declare const HostingDomainKindSchema: z.ZodEnum<{
+    apex: "apex";
+    subdomain: "subdomain";
+}>;
+export type HostingDomainKind = z.infer<typeof HostingDomainKindSchema>;
+/**
+ * Custom domain record, stored at `hosting-domains/{domain}`.
+ * The normalized domain is the doc key — global uniqueness comes for free.
+ * This doc is both the record AND the claim for the domain.
+ */
+export declare const HostingDomainSchema: z.ZodObject<{
+    domain: z.ZodString;
+    kind: z.ZodEnum<{
+        apex: "apex";
+        subdomain: "subdomain";
+    }>;
+    projectId: z.ZodString;
+    ownerId: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        failed: "failed";
+        pending: "pending";
+        provisioning: "provisioning";
+        verifying: "verifying";
+    }>;
+    dnsAuthId: z.ZodString;
+    delegationTarget: z.ZodString;
+    trafficTarget: z.ZodOptional<z.ZodString>;
+    certId: z.ZodOptional<z.ZodString>;
+    certMapEntryName: z.ZodOptional<z.ZodString>;
+    httpRouteName: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    pendingSince: z.ZodNumber;
+    verifyingSince: z.ZodOptional<z.ZodNumber>;
+    attemptId: z.ZodOptional<z.ZodString>;
+    verifiedAt: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    failedStep: z.ZodOptional<z.ZodEnum<{
+        dns: "dns";
+        https: "https";
+    }>>;
+    createdBy: z.ZodString;
+}, z.core.$strip>;
+export type HostingDomain = z.infer<typeof HostingDomainSchema>;
+export declare const AddDomainRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    domain: z.ZodString;
+}, z.core.$strip>;
+export type AddDomainRequest = z.infer<typeof AddDomainRequestSchema>;
+export declare const AddDomainResponseSchema: z.ZodObject<{
+    domain: z.ZodString;
+    kind: z.ZodEnum<{
+        apex: "apex";
+        subdomain: "subdomain";
+    }>;
+    records: z.ZodObject<{
+        traffic: z.ZodObject<{
+            recordType: z.ZodEnum<{
+                A: "A";
+                CNAME: "CNAME";
+            }>;
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>;
+        validation: z.ZodObject<{
+            recordType: z.ZodEnum<{
+                A: "A";
+                CNAME: "CNAME";
+            }>;
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AddDomainResponse = z.infer<typeof AddDomainResponseSchema>;
+export declare const VerifyDomainRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    domain: z.ZodString;
+}, z.core.$strip>;
+export type VerifyDomainRequest = z.infer<typeof VerifyDomainRequestSchema>;
+export declare const VerifyDomainResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        active: "active";
+        failed: "failed";
+        pending: "pending";
+        provisioning: "provisioning";
+        verifying: "verifying";
+    }>;
+}, z.core.$strip>;
+export type VerifyDomainResponse = z.infer<typeof VerifyDomainResponseSchema>;
+export declare const RemoveDomainRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    domain: z.ZodString;
+}, z.core.$strip>;
+export type RemoveDomainRequest = z.infer<typeof RemoveDomainRequestSchema>;
+export declare const RemoveDomainResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export type RemoveDomainResponse = z.infer<typeof RemoveDomainResponseSchema>;
 export declare const CloneProjectOptionsSchema: z.ZodObject<{
     sourceProjectId: z.ZodString;
     sourceBranchName: z.ZodDefault<z.ZodString>;