@builder.io/ai-utils 0.105.0 → 0.107.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.105.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>;
@@ -2319,6 +2328,7 @@ export declare const PublishAgentMessageRequestSchema: z.ZodObject<{
     }, z.core.$strip>]>>>;
     requireConfirmation: z.ZodOptional<z.ZodBoolean>;
     skippedMCPs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    customInstructions: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type PublishAgentMessageRequest = z.infer<typeof PublishAgentMessageRequestSchema>;
 export declare const RepoIndexingConfigSchema: z.ZodObject<{
@@ -4496,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" }),
@@ -1824,6 +1837,9 @@ export const PublishAgentMessageRequestSchema = z
     skippedMCPs: z.array(z.string()).optional().meta({
         description: "Per-message denylist of MCP server ids to skip, e.g. a 'disable for this session' UI toggle.",
     }),
+    customInstructions: z.string().max(100000).optional().meta({
+        description: "The organization's Publish Agent instructions, applied as an always-on rule. Send on every request, including tool-result continuations.",
+    }),
 })
     .refine(({ message, toolResults }) => Boolean(message) || Boolean(toolResults === null || toolResults === void 0 ? void 0 : toolResults.length), {
     path: ["message"],

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/events.d.ts

@@ -943,6 +943,45 @@ export declare const FusionContainerFailedV1: {
     eventName: "fusion.container.failed";
     version: "1";
 };
+/**
+ * Why the preview never came up. A closed set so the funnel can group by it;
+ * the detail belongs in the container's logs.
+ */
+export type FusionPreviewFailureReason = "http-4xx" | "http-5xx" | "unreachable" | "dev-command-failed";
+/**
+ * The first moment the user has something to look at. Deliberately not a reuse
+ * of `FusionContainerStartedV1`, which only means the box booted: conflating
+ * the two makes preview failure unmeasurable, since a container that serves
+ * nothing looks identical to a healthy one.
+ */
+export type FusionPreviewReadyV1 = FusionEventVariant<"fusion.preview.ready", {
+    projectId: string;
+    branchName: string;
+    /** ms from the dev server being started to its first successful response. */
+    durationMs?: number;
+}, {
+    projectId: string;
+    branchName: string;
+}, 1>;
+export declare const FusionPreviewReadyV1: {
+    eventName: "fusion.preview.ready";
+    version: "1";
+};
+/** The counterpart to {@link FusionPreviewReadyV1}: the preview never came up. */
+export type FusionPreviewFailedV1 = FusionEventVariant<"fusion.preview.failed", {
+    projectId: string;
+    branchName: string;
+    reason: FusionPreviewFailureReason;
+    /** ms from the dev server being started to the failure being called. */
+    durationMs?: number;
+}, {
+    projectId: string;
+    branchName: string;
+}, 1>;
+export declare const FusionPreviewFailedV1: {
+    eventName: "fusion.preview.failed";
+    version: "1";
+};
 export type FusionBranchFailedV1 = FusionEventVariant<"fusion.branch.failed", {
     projectId: string;
     branchName?: string;
@@ -1460,7 +1499,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 | FusionShapeIssuedV1 | FusionShapeAssembledV1 | FusionShapeResolvedV1 | FusionShapeQuestionAnsweredV1 | FusionShapeQuestionSkippedV1 | 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 | ProjectSnapshotGoldenWatchdogV1 | ProjectSnapshotGoldenRetryV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1 | McpPrototypePulledV1 | HostingCustomDomainCertCheckV1 | HostingCustomDomainServingCheckV1 | HostingCustomDomainDelegationCheckV1;
+export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | ClientDevtoolsBuildMigratedV1 | ClientDevtoolsBuildCompletedV1 | ClientDevtoolsBuildUploadedV1 | ClientDevtoolsBuildFailedV1 | FusionProjectCreatedV1 | FusionShapeIssuedV1 | FusionShapeAssembledV1 | FusionShapeResolvedV1 | FusionShapeQuestionAnsweredV1 | FusionShapeQuestionSkippedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionPreviewReadyV1 | FusionPreviewFailedV1 | FusionBranchFailedV1 | BotMentionGitHubExternalPrV1 | BotMentionGitHubInternalPrV1 | BotMentionGitLabPrV1 | BotMentionBitbucketPrV1 | BotMentionAzurePrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotGoldenWatchdogV1 | ProjectSnapshotGoldenRetryV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1 | McpPrototypePulledV1 | HostingCustomDomainCertCheckV1 | HostingCustomDomainServingCheckV1 | HostingCustomDomainDelegationCheckV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -106,6 +106,14 @@ export const FusionContainerFailedV1 = {
     eventName: "fusion.container.failed",
     version: "1",
 };
+export const FusionPreviewReadyV1 = {
+    eventName: "fusion.preview.ready",
+    version: "1",
+};
+export const FusionPreviewFailedV1 = {
+    eventName: "fusion.preview.failed",
+    version: "1",
+};
 export const FusionBranchFailedV1 = {
     eventName: "fusion.branch.failed",
     version: "1",

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;