@builder.io/ai-utils 0.85.3 → 0.86.1

package/package.json

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

package/src/codegen.d.ts

@@ -2911,7 +2911,7 @@ export type CodeGenInputOptions = z.infer<typeof CodeGenInputOptionsSchema> & {
      */
     _mcpClientWrapperFactory?: (realClient: any) => any;
 };
-export type CodeGenErrorCodes = "credits-limit-daily" | "credits-limit-monthly" | "credits-limit-user" | "credits-limit-other" | "cli-genetic-error" | "git-update-error" | "prompt-too-long" | "context-too-long" | "abrupt-end" | "unknown" | "failed-recover-state" | "completion-expired" | "ask-to-continue" | "bad-initial-url" | "bad-smart-export-payload" | "invalid-last-message" | "corrupted-session" | "privacy-mode-key-required" | "privacy-mode-key-invalid" | "privacy-mode-key-mismatch" | "cli-network-error" | "invalid-credentials" | "model-restricted-too-large" | "org-no-models-enabled" | "assertion" | "rate-limit" | "unknown-design-system";
+export type CodeGenErrorCodes = "credits-limit-daily" | "credits-limit-monthly" | "credits-limit-user" | "credits-limit-other" | "cli-genetic-error" | "git-update-error" | "prompt-too-long" | "context-too-long" | "abrupt-end" | "unknown" | "failed-recover-state" | "completion-expired" | "ask-to-continue" | "bad-initial-url" | "bad-smart-export-payload" | "invalid-last-message" | "corrupted-session" | "privacy-mode-key-required" | "privacy-mode-key-invalid" | "privacy-mode-key-mismatch" | "privacy-mode-validation-unavailable" | "cli-network-error" | "invalid-credentials" | "model-restricted-too-large" | "org-no-models-enabled" | "assertion" | "rate-limit" | "unknown-design-system";
 export interface CodegenUsage {
     total: number;
     fast: number;
@@ -3845,6 +3845,30 @@ export interface GenerateCodeEventError {
     message: string;
     usage?: CodegenUsage;
 }
+/**
+ * Wire schema for the pre-stream error protocol on `/codegen/completion`:
+ * middlewares that reject a request before the stream starts (credit limits,
+ * privacy mode) respond with an error status whose body is a single
+ * {@link GenerateCodeEventError} JSONL line. Loose so servers can attach
+ * extra fields (e.g. `usageInfo`), and `code` stays an open string so newer
+ * server codes pass through older clients.
+ */
+export declare const GenerateCodeEventErrorBodySchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    stopReason: z.ZodEnum<{
+        error: "error";
+        limit: "limit";
+    }>;
+    code: z.ZodString;
+    id: z.ZodString;
+    message: z.ZodString;
+}, z.core.$loose>;
+/**
+ * Decode a non-OK `/codegen/completion` response body as a structured error
+ * event. Returns undefined for anything else (auth failures, proxy errors,
+ * plain-text bodies), letting transport-level status handling take over.
+ */
+export declare function parseGenerateCodeEventErrorBody(body: string): GenerateCodeEventError | undefined;
 export interface GenerateCodeEventPagination {
     type: "pagination";
     pop: number;

package/src/codegen.js

@@ -2017,6 +2017,37 @@ export const CodegenSettingsRequestSchema = z
     repoHash: z.string().optional(),
 })
     .meta({ title: "CodegenSettingsRequest" });
+/**
+ * Wire schema for the pre-stream error protocol on `/codegen/completion`:
+ * middlewares that reject a request before the stream starts (credit limits,
+ * privacy mode) respond with an error status whose body is a single
+ * {@link GenerateCodeEventError} JSONL line. Loose so servers can attach
+ * extra fields (e.g. `usageInfo`), and `code` stays an open string so newer
+ * server codes pass through older clients.
+ */
+export const GenerateCodeEventErrorBodySchema = z.looseObject({
+    type: z.literal("error"),
+    stopReason: z.enum(["error", "limit"]),
+    code: z.string(),
+    id: z.string(),
+    message: z.string(),
+});
+/**
+ * Decode a non-OK `/codegen/completion` response body as a structured error
+ * event. Returns undefined for anything else (auth failures, proxy errors,
+ * plain-text bodies), letting transport-level status handling take over.
+ */
+export function parseGenerateCodeEventErrorBody(body) {
+    try {
+        const parsed = GenerateCodeEventErrorBodySchema.safeParse(JSON.parse(body.trim().split("\n")[0]));
+        return parsed.success
+            ? parsed.data
+            : undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
 /**
  * Request for generating a commit message via LLM
  */

package/src/codegen.spec.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { DEFAULT_QUEUE_BEHAVIOR, isInterruptSchedule, normalizeQueueMode, } from "./codegen";
+import { DEFAULT_QUEUE_BEHAVIOR, isInterruptSchedule, normalizeQueueMode, parseGenerateCodeEventErrorBody, } from "./codegen";
 describe("normalizeQueueMode", () => {
     it("returns the default behavior when input is undefined", () => {
         expect(normalizeQueueMode(undefined)).toEqual(DEFAULT_QUEUE_BEHAVIOR);
@@ -56,3 +56,38 @@ describe("isInterruptSchedule", () => {
         expect(isInterruptSchedule("until-idle")).toBe(false);
     });
 });
+describe("parseGenerateCodeEventErrorBody", () => {
+    it("decodes a structured error-event body", () => {
+        const body = JSON.stringify({
+            type: "error",
+            stopReason: "error",
+            code: "privacy-mode-key-required",
+            id: "abc",
+            message: "no key",
+        }) + "\n";
+        expect(parseGenerateCodeEventErrorBody(body)).toMatchObject({
+            code: "privacy-mode-key-required",
+            message: "no key",
+        });
+    });
+    it("preserves extra fields like usageInfo and decodes only the first line", () => {
+        const body = JSON.stringify({
+            type: "error",
+            stopReason: "limit",
+            code: "credits-limit-monthly",
+            id: "abc",
+            message: "limit reached",
+            usageInfo: { plan: "free" },
+        }) + "\nnot-json-second-line";
+        expect(parseGenerateCodeEventErrorBody(body)).toMatchObject({
+            code: "credits-limit-monthly",
+            usageInfo: { plan: "free" },
+        });
+    });
+    it("returns undefined for non-event bodies", () => {
+        expect(parseGenerateCodeEventErrorBody("Forbidden")).toBeUndefined();
+        expect(parseGenerateCodeEventErrorBody('{"error":"invalid token"}')).toBeUndefined();
+        expect(parseGenerateCodeEventErrorBody(JSON.stringify({ type: "error", code: 42, message: "bad shape" }))).toBeUndefined();
+        expect(parseGenerateCodeEventErrorBody("")).toBeUndefined();
+    });
+});

package/src/design-systems.d.ts

@@ -11,6 +11,22 @@ export interface FigmaHydrationResponse {
     manifest: import("./events.js").FigmaFrameManifest | null;
     files: FigmaHydrationFile[];
 }
+export declare const figmaDecodeJobStatusParamsSchema: z.ZodObject<{
+    jobId: z.ZodString;
+}, z.core.$strip>;
+export type FigmaDecodeJobStatusParams = z.infer<typeof figmaDecodeJobStatusParamsSchema>;
+export interface FigmaDecodeJobStatusResponse {
+    jobId: string;
+    status: "pending" | "processing" | "complete" | "error";
+    framesProcessed: number;
+    totalFrames: number;
+    branchName: string | null;
+    branchUrl: string | null;
+    error: string | null;
+    partialFailure?: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
 /**
  * Accepts `https://github.com/<owner>/<repo>` (optionally with a trailing
  * `.git` or path segments). Used to gate public-repo inputs before cloning.

package/src/design-systems.js

@@ -1,4 +1,7 @@
 import { z } from "zod";
+export const figmaDecodeJobStatusParamsSchema = z.object({
+    jobId: z.string().min(1),
+});
 /**
  * Accepts `https://github.com/<owner>/<repo>` (optionally with a trailing
  * `.git` or path segments). Used to gate public-repo inputs before cloning.

package/src/events.d.ts

@@ -1316,6 +1316,20 @@ export declare const HostingCustomDomainCertCheckV1: {
     eventName: "hosting.custom-domain.cert-check";
     version: "1";
 };
+export type HostingCustomDomainServingCheckV1 = FusionEventVariant<"hosting.custom-domain.serving-check", {
+    domain: string;
+    projectId: string;
+    certId: string;
+    attemptId: string;
+    startedAtMs: number;
+    timeoutMs: number;
+}, {
+    projectId: string;
+}, 1>;
+export declare const HostingCustomDomainServingCheckV1: {
+    eventName: "hosting.custom-domain.serving-check";
+    version: "1";
+};
 export type HostingCustomDomainDelegationCheckV1 = FusionEventVariant<"hosting.custom-domain.delegation-check", {
     domain: string;
     projectId: string;
@@ -1329,7 +1343,7 @@ 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 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 | HostingCustomDomainServingCheckV1 | HostingCustomDomainDelegationCheckV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -166,6 +166,10 @@ export const HostingCustomDomainCertCheckV1 = {
     eventName: "hosting.custom-domain.cert-check",
     version: "1",
 };
+export const HostingCustomDomainServingCheckV1 = {
+    eventName: "hosting.custom-domain.serving-check",
+    version: "1",
+};
 export const HostingCustomDomainDelegationCheckV1 = {
     eventName: "hosting.custom-domain.delegation-check",
     version: "1",

package/src/projects.d.ts

@@ -1888,6 +1888,9 @@ export declare const HostingDomainSchema: z.ZodObject<{
         dns: "dns";
         https: "https";
     }>>;
+    routeError: z.ZodOptional<z.ZodString>;
+    routeErrorAt: z.ZodOptional<z.ZodNumber>;
+    servingConfirmedAt: z.ZodOptional<z.ZodNumber>;
     createdBy: z.ZodString;
 }, z.core.$strip>;
 export type HostingDomain = z.infer<typeof HostingDomainSchema>;
@@ -1946,6 +1949,22 @@ export declare const RemoveDomainResponseSchema: z.ZodObject<{
     success: z.ZodLiteral<true>;
 }, z.core.$strip>;
 export type RemoveDomainResponse = z.infer<typeof RemoveDomainResponseSchema>;
+export declare const RepairDomainRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    domain: z.ZodString;
+}, z.core.$strip>;
+export type RepairDomainRequest = z.infer<typeof RepairDomainRequestSchema>;
+export declare const RepairDomainResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        active: "active";
+        failed: "failed";
+        pending: "pending";
+        provisioning: "provisioning";
+        verifying: "verifying";
+    }>;
+    routeError: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type RepairDomainResponse = z.infer<typeof RepairDomainResponseSchema>;
 export declare const CloneProjectOptionsSchema: z.ZodObject<{
     sourceProjectId: z.ZodString;
     sourceBranchName: z.ZodDefault<z.ZodString>;

package/src/projects.js

@@ -842,6 +842,15 @@ export const HostingDomainSchema = z.object({
     failedStep: z.enum(["dns", "https"]).optional().meta({
         description: "Which setup step failed, set alongside `status: failed` so the UI can attribute the failure. `dns` = delegation verification, `https` = cert/route provisioning.",
     }),
+    routeError: z.string().optional().meta({
+        description: "Non-fatal health signal on an otherwise verified (`provisioning`/`active`) domain: set when re-creating the Envoy HTTPRoute failed on republish, so the site's cert is valid but the custom domain has no live route (bare 404). `status` stays `active`; this drives a degraded banner + Fix action. Cleared once the route is recreated.",
+    }),
+    routeErrorAt: z.number().optional().meta({
+        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`).",
+    }),
     createdBy: z.string(),
 });
 export const AddDomainRequestSchema = z.object({
@@ -875,6 +884,14 @@ export const RemoveDomainRequestSchema = z.object({
 export const RemoveDomainResponseSchema = z.object({
     success: z.literal(true),
 });
+export const RepairDomainRequestSchema = z.object({
+    projectId: z.string(),
+    domain: z.string(),
+});
+export const RepairDomainResponseSchema = z.object({
+    status: HostingDomainStatusSchema,
+    routeError: z.string().optional(),
+});
 export const CloneProjectOptionsSchema = z.object({
     sourceProjectId: z.string().min(1).meta({
         description: "Project to clone from.",