@builder.io/ai-utils 0.100.2 → 0.103.0

package/package.json

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

package/src/codegen.d.ts

@@ -4542,6 +4542,11 @@ export interface FusionConfig {
     /** If true, nuke and re-clone the git repo during init, overwriting the existing repo */
     rebuildGit?: boolean;
     mode?: Mode;
+    /**
+     * Combines with the backup modes: try to repair a corrupt git object database
+     * before backing up, instead of failing on the first unreadable object.
+     */
+    attemptCorruptGitRecovery?: boolean;
     autoDetectDevServer?: boolean;
     autoDetectDevServerPatterns?: string[];
     /**
@@ -4670,7 +4675,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";
+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 interface InitStatusLog {
     id: number;
     timestamp: string;

package/src/events.d.ts

@@ -16,6 +16,7 @@ export interface AssistantCompletionResultEvent {
     resolveId?: string;
 }
 export interface AssistantError {
+    code?: string;
     message: string;
     status?: number;
     actions?: AssistantMessageAction[];

package/src/index.d.ts

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

package/src/index.js

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

package/src/mcp-servers.d.ts

@@ -0,0 +1,55 @@
+import { z } from "zod";
+export declare const McpServerRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    ownerId: z.ZodString;
+    type: z.ZodLiteral<"url">;
+    url: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    clientName: z.ZodOptional<z.ZodString>;
+    createDate: z.ZodNumber;
+    updatedAt: z.ZodOptional<z.ZodNumber>;
+    tokenExpiresAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    requiresOAuth: z.ZodOptional<z.ZodBoolean>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    isBuiltinConfiguration: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type McpServerRecord = z.infer<typeof McpServerRecordSchema>;
+export declare const McpServersListResponseSchema: z.ZodObject<{
+    servers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        ownerId: z.ZodString;
+        type: z.ZodLiteral<"url">;
+        url: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+        clientName: z.ZodOptional<z.ZodString>;
+        createDate: z.ZodNumber;
+        updatedAt: z.ZodOptional<z.ZodNumber>;
+        tokenExpiresAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        requiresOAuth: z.ZodOptional<z.ZodBoolean>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+        isBuiltinConfiguration: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type McpServersListResponse = z.infer<typeof McpServersListResponseSchema>;
+export declare const McpServersDeleteRequestSchema: z.ZodObject<{
+    serverIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    serverUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type McpServersDeleteRequest = z.infer<typeof McpServersDeleteRequestSchema>;
+export declare const McpServersDeleteResponseSchema: z.ZodObject<{
+    deletedServerIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type McpServersDeleteResponse = z.infer<typeof McpServersDeleteResponseSchema>;
+export declare const McpServersDisableRequestSchema: z.ZodObject<{
+    serverIds: z.ZodArray<z.ZodString>;
+    disabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type McpServersDisableRequest = z.infer<typeof McpServersDisableRequestSchema>;
+export declare const McpServersDisableResponseSchema: z.ZodObject<{
+    updatedServerIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type McpServersDisableResponse = z.infer<typeof McpServersDisableResponseSchema>;

package/src/mcp-servers.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+// Deliberately excludes authorizationToken, refreshToken, tokenType, and oauthMetadata:
+// this is a general-purpose management API any org member can call, so credentials
+// that could be replayed against the third-party server never leave the backend.
+export const McpServerRecordSchema = z
+    .object({
+    id: z.string(),
+    ownerId: z.string(),
+    type: z.literal("url"),
+    url: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    provider: z.string().optional(),
+    clientName: z.string().optional(),
+    createDate: z.number(),
+    updatedAt: z.number().optional(),
+    tokenExpiresAt: z.number().nullish(),
+    requiresOAuth: z.boolean().optional(),
+    disabled: z.boolean().optional(),
+    isBuiltinConfiguration: z.boolean().optional(),
+})
+    .meta({ title: "McpServerRecord" });
+export const McpServersListResponseSchema = z
+    .object({
+    servers: z.array(McpServerRecordSchema),
+})
+    .meta({ title: "McpServersListResponse" });
+// `serverUrl` mirrors the legacy disconnect-by-url Firestore query.
+export const McpServersDeleteRequestSchema = z
+    .object({
+    serverIds: z.array(z.string()).optional(),
+    serverUrl: z.string().optional(),
+})
+    .meta({ title: "McpServersDeleteRequest" });
+export const McpServersDeleteResponseSchema = z
+    .object({
+    deletedServerIds: z.array(z.string()),
+})
+    .meta({ title: "McpServersDeleteResponse" });
+export const McpServersDisableRequestSchema = z
+    .object({
+    serverIds: z.array(z.string()).min(1),
+    disabled: z.boolean(),
+})
+    .meta({ title: "McpServersDisableRequest" });
+export const McpServersDisableResponseSchema = z
+    .object({
+    updatedServerIds: z.array(z.string()),
+})
+    .meta({ title: "McpServersDisableResponse" });

package/src/projects.d.ts

@@ -334,6 +334,23 @@ export interface CodegenSetLastCommit {
     lastCommitHash: GitSnapshot;
     clearSecondaryVolumeId: boolean;
 }
+/**
+ * A run that ended on an unreadable git object database.
+ *
+ * Reported by the container rather than inferred by the service: a backup-mode
+ * launch is only ever observed as a machine that started and exited, so from
+ * the outside a corrupt repo and a clean backup look the same.
+ */
+export declare const GitCorruptionReportSchema: z.ZodObject<{
+    at: z.ZodNumber;
+    error: z.ZodString;
+    repoPath: z.ZodOptional<z.ZodString>;
+    emptyObjects: z.ZodOptional<z.ZodNumber>;
+    recoveryAttempted: z.ZodOptional<z.ZodBoolean>;
+    recoveryRefetched: z.ZodOptional<z.ZodBoolean>;
+    devToolsVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GitCorruptionReport = z.infer<typeof GitCorruptionReportSchema>;
 export interface CodegenRuntimeStatus {
     projectId: string;
     branchName: string;
@@ -341,6 +358,7 @@ export interface CodegenRuntimeStatus {
     clearSecondaryVolumeId?: boolean;
     lastServerState?: LaunchServerState;
     lastServerVersion?: string;
+    gitCorruption?: GitCorruptionReport;
 }
 export interface BackupGitRepoResultValid {
     success: true;
@@ -587,6 +605,12 @@ export interface BranchSharedData {
     lastServerState?: LaunchServerState | null;
     lastServerStateDate?: number | null;
     lastServerVersion?: string | null;
+    /**
+     * Last run that died on a corrupt git object database, cleared the next time
+     * the branch initializes cleanly. A volume in this state can never produce a
+     * deletion-safe backup, so the cleanup cron will never reclaim it.
+     */
+    gitCorruption?: GitCorruptionReport | null;
     name?: string;
     hidden?: boolean;
     createdBy?: string;
@@ -2413,6 +2437,9 @@ export interface MemorySummary extends Pick<MemoryData, (typeof MEMORY_SUMMARY_F
 export interface GetProjectMemoriesResult {
     memories: MemorySummary[];
 }
+export interface GetFusionPrivateKeyResult {
+    id: string;
+}
 interface BaseSendMessageMessage {
 }
 export interface ValidatingBranchMessage extends BaseSendMessageMessage {
@@ -2602,6 +2629,8 @@ export declare const ProjectHostingSchema: z.ZodObject<{
         skip: "skip";
     }>>;
     configUpdatedAt: z.ZodOptional<z.ZodNumber>;
+    originLockPendingAt: z.ZodOptional<z.ZodString>;
+    originLockedAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ProjectHosting = z.infer<typeof ProjectHostingSchema>;
 /**
@@ -3177,6 +3206,7 @@ export declare const DeploySchema: z.ZodObject<{
         uploading: "uploading";
     }>;
     netlifyDeployId: z.ZodOptional<z.ZodString>;
+    netlifyOriginLockCodeSha: z.ZodOptional<z.ZodString>;
     url: z.ZodOptional<z.ZodString>;
     migrationApplied: z.ZodOptional<z.ZodBoolean>;
     error: z.ZodOptional<z.ZodString>;
@@ -3414,6 +3444,14 @@ export declare const ReserveSlugResponseSchema: z.ZodObject<{
     slug: z.ZodString;
 }, z.core.$strip>;
 export type ReserveSlugResponse = z.infer<typeof ReserveSlugResponseSchema>;
+export declare const CheckOrgSuffixAvailableRequestSchema: z.ZodObject<{
+    suffix: z.ZodString;
+}, z.core.$strip>;
+export type CheckOrgSuffixAvailableRequest = z.infer<typeof CheckOrgSuffixAvailableRequestSchema>;
+export declare const CheckOrgSuffixAvailableResponseSchema: z.ZodObject<{
+    available: z.ZodBoolean;
+}, z.core.$strip>;
+export type CheckOrgSuffixAvailableResponse = z.infer<typeof CheckOrgSuffixAvailableResponseSchema>;
 export declare const GoldenSnapshotRefreshRequestSchema: z.ZodObject<{
     sourceCommitSha: z.ZodString;
 }, z.core.$strict>;
@@ -4406,6 +4444,8 @@ export declare const ProjectTemplateSchema: z.ZodObject<{
             skip: "skip";
         }>>;
         configUpdatedAt: z.ZodOptional<z.ZodNumber>;
+        originLockPendingAt: z.ZodOptional<z.ZodString>;
+        originLockedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ProjectTemplate = z.infer<typeof ProjectTemplateSchema>;

package/src/projects.js

@@ -107,6 +107,23 @@ export const EXAMPLE_OR_STARTER_REPOS = [
     AGENT_NATIVE_STARTER_REPO,
 ];
 export const EXAMPLE_OR_STARTER_REPOS_URLS = EXAMPLE_OR_STARTER_REPOS.map((repo) => `https://github.com/${repo}`);
+/**
+ * A run that ended on an unreadable git object database.
+ *
+ * Reported by the container rather than inferred by the service: a backup-mode
+ * launch is only ever observed as a machine that started and exited, so from
+ * the outside a corrupt repo and a clean backup look the same.
+ */
+export const GitCorruptionReportSchema = z.object({
+    /** When the run failed — not when the objects were damaged. */
+    at: z.number(),
+    error: z.string().max(2000),
+    repoPath: z.string().max(500).optional(),
+    emptyObjects: z.number().int().nonnegative().max(1000000).optional(),
+    recoveryAttempted: z.boolean().optional(),
+    recoveryRefetched: z.boolean().optional(),
+    devToolsVersion: z.string().max(100).optional(),
+});
 /** Fields shared by every {@link ProjectSkill} variant. */
 const ProjectSkillBaseShape = {
     key: z.string().meta({
@@ -1256,6 +1273,12 @@ export const ProjectHostingSchema = z.object({
     configUpdatedAt: z.number().optional().meta({
         description: "Epoch ms of the last change to a hosting field that requires a redeploy. Compare against `lastDeployAt`.",
     }),
+    originLockPendingAt: z.string().optional().meta({
+        description: "ISO timestamp when origin-lock activation began. Route reconcilers preserve the header until activation completes.",
+    }),
+    originLockedAt: z.string().optional().meta({
+        description: "ISO timestamp of the first successful origin-locked deploy. Absent means activation has not completed.",
+    }),
 });
 /**
  * Mask of the hosting sub-fields a client may write via `PATCH`. Everything
@@ -1450,6 +1473,9 @@ export const DeploySchema = z.object({
     }),
     status: DeployStatusSchema,
     netlifyDeployId: z.string().optional(),
+    netlifyOriginLockCodeSha: z.string().optional().meta({
+        description: "Origin-lock edge-function SHA declared when the persisted Netlify deploy was created.",
+    }),
     url: z.string().optional(),
     migrationApplied: z.boolean().optional().meta({
         description: "Whether Drizzle migrations were applied during this deploy. Absent when no migration ran.",
@@ -1778,6 +1804,12 @@ export const ReserveSlugRequestSchema = z.object({
 export const ReserveSlugResponseSchema = z.object({
     slug: z.string(),
 });
+export const CheckOrgSuffixAvailableRequestSchema = z.object({
+    suffix: z.string().min(1),
+});
+export const CheckOrgSuffixAvailableResponseSchema = z.object({
+    available: z.boolean(),
+});
 const gitCommitHashSchema = z
     .string()
     .regex(/^[0-9a-f]{7,40}$/i, "Must be a valid git commit hash (7–40 hex chars)");

package/src/publish-agent.js

@@ -18,6 +18,16 @@ export const PUBLISH_AGENT_SKILLS_INFO = [
         name: "create-page",
         description: "Create a new page in the Builder CMS space. Use when the user asks to create, add, or scaffold a new page.",
     },
+    {
+        id: "publish-agent-skill-scaffold-site",
+        name: "scaffold-site",
+        description: "Plan and scaffold a site's information architecture from a CSV, sitemap, or existing-site URL, with a review step before implementation.",
+    },
+    {
+        id: "publish-agent-skill-import-records",
+        name: "import-records",
+        description: "Import records from an attached CSV into an existing Builder model, with column mapping and a row preview before execution.",
+    },
 ];
 export const PublishAgentSessionCursorSchema = z
     .object({