@builder.io/ai-utils 0.76.1 → 0.76.4

package/package.json

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

package/src/codegen.d.ts

@@ -203,6 +203,7 @@ export type GrepSearchToolInput = z.infer<typeof GrepSearchToolInputSchema>;
 export declare const SkillToolInputSchema: z.ZodObject<{
     skill: z.ZodString;
     args: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    userInvoked: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
 }, z.core.$strip>;
 export type SkillToolInput = z.infer<typeof SkillToolInputSchema>;
 export declare const GetRuleToolInputSchema: z.ZodObject<{
@@ -1380,6 +1381,12 @@ export declare const EnsurePRToolInputSchema: z.ZodObject<{
     draft: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type EnsurePRToolInput = z.infer<typeof EnsurePRToolInputSchema>;
+export declare const EnableDatabaseToolInputSchema: z.ZodObject<{
+    purpose: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EnableDatabaseToolInput = z.infer<typeof EnableDatabaseToolInputSchema>;
+/** Non-technical line surfaced in the run summary after EnableDatabase succeeds. */
+export declare function formatDatabaseEnabledUserSummary(purpose?: string): string;
 export declare const ConnectMCPToolInputSchema: z.ZodObject<{
     name: z.ZodString;
     url: z.ZodOptional<z.ZodString>;
@@ -1410,6 +1417,7 @@ export declare const CodeGenToolMapSchema: z.ZodObject<{
     Skill: z.ZodObject<{
         skill: z.ZodString;
         args: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        userInvoked: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     }, z.core.$strip>;
     GetStyleInspiration: z.ZodObject<{
         url: z.ZodString;
@@ -1960,6 +1968,9 @@ export declare const CodeGenToolMapSchema: z.ZodObject<{
         builder_user_id: z.ZodOptional<z.ZodString>;
         draft: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
+    EnableDatabase: z.ZodObject<{
+        purpose: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
     GenerateDesignSystemAgentMd: z.ZodObject<{}, z.core.$strip>;
 }, z.core.$strip>;
 export type CodeGenToolMap = z.infer<typeof CodeGenToolMapSchema>;
@@ -1977,6 +1988,7 @@ export declare const CodeGenToolsSchema: z.ZodEnum<{
     DevServerLogs: "DevServerLogs";
     DevServerRestart: "DevServerRestart";
     Edit: "Edit";
+    EnableDatabase: "EnableDatabase";
     EnsurePR: "EnsurePR";
     EnterPlanMode: "EnterPlanMode";
     EscalateToPlanner: "EscalateToPlanner";
@@ -2700,6 +2712,7 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
         DevServerLogs: "DevServerLogs";
         DevServerRestart: "DevServerRestart";
         Edit: "Edit";
+        EnableDatabase: "EnableDatabase";
         EnsurePR: "EnsurePR";
         EnterPlanMode: "EnterPlanMode";
         EscalateToPlanner: "EscalateToPlanner";
@@ -2884,7 +2897,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" | "cli-network-error" | "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" | "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;
@@ -3967,6 +3980,7 @@ export interface WorkspaceFolder {
     backupMetadata?: BackupMetadata;
     initializationCommand?: string;
     recommendedRoot?: string;
+    authHeader?: string;
 }
 export interface WorkspaceConfiguration {
     agentsMD?: string;

package/src/codegen.js

@@ -157,6 +157,9 @@ export const SkillToolInputSchema = z
     args: z.string().nullish().meta({
         description: "Optional invocation arguments; forwarded with the skill body in the tool result.",
     }),
+    userInvoked: z.boolean().nullish().meta({
+        description: "Set to true when the user explicitly mentioned or requested this skill by name in their message (including slash commands). Set to false or omit when invoking proactively based on context.",
+    }),
 })
     .meta({ title: "SkillToolInput" });
 export const GetRuleToolInputSchema = z
@@ -433,7 +436,7 @@ export const AskUserQuestionSchema = z
         description: 'Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".',
     }),
     options: z.array(AskUserQuestionOptionSchema).min(2).max(4).meta({
-        description: "The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.",
+        description: "The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). Provide only concrete, substantive choices. Do NOT add a free-form / catch-all option such as 'Other', 'Custom', 'Something else', 'Let me specify', 'None of these', etc. — the UI always appends an implicit 'Other' option that lets the user type a custom answer, so adding your own would create a duplicate that cannot accept input.",
     }),
     multiSelect: z.boolean().optional().meta({
         description: "Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.",
@@ -1482,6 +1485,21 @@ export const EnsurePRToolInputSchema = z
     }),
 })
     .meta({ title: "EnsurePRToolInput" });
+export const EnableDatabaseToolInputSchema = z
+    .object({
+    purpose: z.string().optional().meta({
+        description: "Brief non-technical note about what data will be stored (e.g. 'contact form submissions'). Used in the user-facing summary.",
+    }),
+})
+    .meta({ title: "EnableDatabaseToolInput" });
+/** Non-technical line surfaced in the run summary after EnableDatabase succeeds. */
+export function formatDatabaseEnabledUserSummary(purpose) {
+    const trimmed = purpose === null || purpose === void 0 ? void 0 : purpose.trim();
+    if (trimmed) {
+        return `Spun up a database to store ${trimmed}.`;
+    }
+    return "Spun up a database for this project.";
+}
 export const ConnectMCPToolInputSchema = z
     .object({
     name: z.string().meta({
@@ -1559,6 +1577,7 @@ export const CodeGenToolMapSchema = z.object({
     PullPrototype: PullPrototypeToolInputSchema,
     ConnectMCP: ConnectMCPToolInputSchema,
     EnsurePR: EnsurePRToolInputSchema,
+    EnableDatabase: EnableDatabaseToolInputSchema,
     GenerateDesignSystemAgentMd: GenerateDesignSystemAgentMdInputSchema,
 });
 export const CodeGenToolsSchema = CodeGenToolMapSchema.keyof().meta({

package/src/events.d.ts

@@ -1253,7 +1253,18 @@ export declare const ClientDevtoolsBuildFailedV1: {
     eventName: "client.devtools.build.failed";
     version: "1";
 };
-export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | 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;
+export type McpPrototypePulledV1 = FusionEventVariant<"mcp.prototype.pulled", {
+    projectId: string;
+    branchName: string;
+    prototypeUrl: string;
+}, {
+    projectId: string;
+}, 1>;
+export declare const McpPrototypePulledV1: {
+    eventName: "mcp.prototype.pulled";
+    version: "1";
+};
+export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | 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 interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -154,3 +154,7 @@ export const ClientDevtoolsBuildFailedV1 = {
     eventName: "client.devtools.build.failed",
     version: "1",
 };
+export const McpPrototypePulledV1 = {
+    eventName: "mcp.prototype.pulled",
+    version: "1",
+};

package/src/projects.d.ts

@@ -223,6 +223,7 @@ export interface GitConfig {
     url: string;
     provider: GitProvider | "unknown";
     token: string | undefined;
+    authHeader?: string;
 }
 export type GitConfigs = Record<string, GitConfig>;
 export declare const EXAMPLE_REPOS: string[];
@@ -1027,6 +1028,8 @@ export interface CreateProjectOptions {
     autoApplySetup?: boolean;
     templateId?: string;
     useInternalHost?: boolean;
+    /** Store branches in the standalone `branches` collection vs embedded in the project doc. */
+    useBranchesCollection?: boolean;
 }
 export interface BuilderMyContext {
     success: boolean;
@@ -1605,4 +1608,23 @@ export declare const GetDeploysResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type GetDeploysResponse = z.infer<typeof GetDeploysResponseSchema>;
+export declare const CloneProjectOptionsSchema: z.ZodObject<{
+    sourceProjectId: z.ZodString;
+    sourceBranchName: z.ZodDefault<z.ZodString>;
+    newProjectName: z.ZodOptional<z.ZodString>;
+    intent: z.ZodEnum<{
+        clone: "clone";
+        duplicate: "duplicate";
+    }>;
+    userEmail: z.ZodOptional<z.ZodString>;
+    useKube: z.ZodDefault<z.ZodBoolean>;
+    useBranchesCollection: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CloneProjectOptions = z.infer<typeof CloneProjectOptionsSchema>;
+export declare const DuplicateBranchOptionsSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    sourceBranchName: z.ZodString;
+    friendlyName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DuplicateBranchOptions = z.infer<typeof DuplicateBranchOptionsSchema>;
 export {};

package/src/projects.js

@@ -507,3 +507,49 @@ export const GetDeploysRequestSchema = z.object({
 export const GetDeploysResponseSchema = z.object({
     deploys: z.array(DeployListItemSchema),
 });
+export const CloneProjectOptionsSchema = z.object({
+    sourceProjectId: z.string().min(1).meta({
+        description: "Project to clone from.",
+    }),
+    sourceBranchName: z.string().min(1).default("main").meta({
+        description: "Branch to seed the clone's branch from.",
+    }),
+    newProjectName: z.string().min(1).max(200).optional().meta({
+        description: 'Name for the new project. Defaults to "{source} (cloned)" for clones.',
+    }),
+    intent: z.enum(["clone", "duplicate"]).meta({
+        description: '"clone": public example/starter → caller\'s space (always full backup, ' +
+            'isExample, name suffixed). "duplicate": copy one of the caller\'s own ' +
+            "projects. Required.",
+    }),
+    userEmail: z
+        .string()
+        .optional()
+        .meta({
+        description: "Attributes the new project to a concrete user when the request has no " +
+            "user session (e.g. API-key auth). Resolved to a user id that must " +
+            "belong to the caller's org; without it a no-session request can't be " +
+            "attributed and project creation fails with 401.",
+    }),
+    useKube: z.boolean().default(false).meta({
+        description: "Whether to provision on cloud-v2 (Kubernetes). Defaults to false.",
+    }),
+    useBranchesCollection: z
+        .boolean()
+        .default(false)
+        .meta({
+        description: "Whether the new project stores branches in the standalone `branches` " +
+            "collection rather than embedded in the project doc. Defaults to false.",
+    }),
+});
+export const DuplicateBranchOptionsSchema = z.object({
+    projectId: z.string().min(1).meta({
+        description: "Project that owns the branch being duplicated.",
+    }),
+    sourceBranchName: z.string().min(1).meta({
+        description: "Branch to duplicate.",
+    }),
+    friendlyName: z.string().max(200).optional().meta({
+        description: "Optional friendly (display) name for the new branch.",
+    }),
+});