@builder.io/ai-utils 0.103.0 → 0.106.0

package/package.json

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

package/src/codegen.d.ts

@@ -2317,7 +2317,9 @@ export declare const PublishAgentMessageRequestSchema: z.ZodObject<{
         tag: z.ZodOptional<z.ZodString>;
         ephemeral: z.ZodOptional<z.ZodBoolean>;
     }, 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<{
@@ -4324,6 +4326,12 @@ export interface WorkspaceFolder {
     templateRepoUrl?: string;
     repoName?: string;
     resetGit?: boolean;
+    /**
+     * The project's configured base/default branch (e.g. "main", "master"),
+     * distinct from `branchName` (the feature branch this folder checks out).
+     * Used when seeding or checking the base branch on the real remote.
+     */
+    mainBranchName?: string;
     branchName?: string;
     backupMetadata?: BackupMetadata;
     initializationCommand?: string;
@@ -4675,7 +4683,7 @@ export interface LoadHistoryResult {
     updatedUnixTime: number;
     turns: CodegenTurn[];
 }
-export type InitStateStep = "initial" | "init" | "validation" | "check-directories" | "create-directories" | "configure-git-repos" | "check-existing-git" | "update-remote-url" | "clone-repo" | "apply-partial-backup" | "configure-git-user" | "stash-changes" | "collect-repo-info" | "init-success" | "init-command" | "init-failed" | "snapshot-git-sync" | "snapshot-backup-restore" | "git-corruption-recovery";
+export type InitStateStep = "initial" | "init" | "validation" | "check-directories" | "create-directories" | "configure-git-repos" | "check-existing-git" | "update-remote-url" | "clone-repo" | "apply-partial-backup" | "configure-git-user" | "stash-changes" | "collect-repo-info" | "init-success" | "init-command" | "init-failed" | "snapshot-git-sync" | "snapshot-backup-restore" | "git-corruption-recovery" | "seed-base-branch";
 export interface InitStatusLog {
     id: number;
     timestamp: string;
@@ -5130,6 +5138,35 @@ export type MessageUpdateOptions = {
     type: "delete";
     idempotencyKey: string;
 };
+/**
+ * Args for the `writeFile` launch-server RPC.
+ *
+ * A named-args object because the RPC applies arguments by position and the
+ * container's pinned `dev-tools` rarely matches the caller's, so new fields
+ * have to be additive rather than order-sensitive.
+ */
+export interface WriteFileOptions {
+    /** Workspace-relative, e.g. `docs/NOTES.md`. */
+    path: string;
+    contents: string;
+}
+/**
+ * Discriminated rather than a nullable path, so a caller that gates behaviour
+ * on the write can tell a refusal from a write that never happened, instead of
+ * reading `null` as both.
+ *
+ * Gate on `success`, not on parsing `error`. Only an ACL denial is reported
+ * distinctly; a blocked `package.json`, a path outside the workspace and a
+ * filesystem error all share one generic message, their reason reaching only
+ * Sentry.
+ */
+export type WriteFileResult = {
+    success: true;
+    path: string;
+} | {
+    success: false;
+    error: string;
+};
 export interface LaunchInitializeSessionOptions {
     sessionId?: string;
     customInstructions?: CustomInstruction[];

package/src/codegen.js

@@ -1818,9 +1818,15 @@ export const PublishAgentMessageRequestSchema = z
     attachments: z.array(AttachmentSchema).optional(),
     toolResults: z.array(ContentMessageItemToolResultSchema).optional(),
     systemReminders: z.array(SystemReminderSchema).optional(),
+    requireConfirmation: z.boolean().optional().meta({
+        description: "Ask before high-impact MCP tool calls; the turn emits confirmation_required and waits.",
+    }),
     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/design-systems.d.ts

@@ -266,3 +266,13 @@ export declare const listPublicSourceFilesQuerySchema: z.ZodObject<{
     ref: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ListPublicSourceFilesQuery = z.infer<typeof listPublicSourceFilesQuerySchema>;
+export type DSITier = "free" | "pro" | "team" | "enterprise";
+export interface DSITierLimitResponse {
+    tier: DSITier;
+    /** Whether this org can index via the web (Figma/.md) flow at its tier. */
+    enabled: boolean;
+    /** Every active design system the org has, regardless of how it was created. */
+    current: number;
+    /** `null` is unlimited. */
+    max: number | null;
+}

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

@@ -23,5 +23,6 @@ export * from "./design-systems.js";
 export * from "./editor-ai.js";
 export * from "./realtime.js";
 export * from "./embeddings.js";
+export * from "./system-one.js";
 export * from "./mcp-servers.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";

package/src/index.js

@@ -23,5 +23,6 @@ export * from "./design-systems.js";
 export * from "./editor-ai.js";
 export * from "./realtime.js";
 export * from "./embeddings.js";
+export * from "./system-one.js";
 export * from "./mcp-servers.js";
 export { connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, } from "./connectivity/error-codes.js";