@builder.io/ai-utils 0.76.2 → 0.77.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.76.2",
+  "version": "0.77.0",
   "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<{
@@ -836,6 +837,8 @@ export declare const ProposedConfigSchema: z.ZodObject<{
     createdAt: z.ZodNumber;
     updatedAt: z.ZodNumber;
     ownerId: z.ZodString;
+    userInitiated: z.ZodBoolean;
+    autoApply: z.ZodBoolean;
     state: z.ZodEnum<{
         "code-change-required": "code-change-required";
         "empty-project": "empty-project";
@@ -1380,6 +1383,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 +1419,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 +1970,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 +1990,7 @@ export declare const CodeGenToolsSchema: z.ZodEnum<{
     DevServerLogs: "DevServerLogs";
     DevServerRestart: "DevServerRestart";
     Edit: "Edit";
+    EnableDatabase: "EnableDatabase";
     EnsurePR: "EnsurePR";
     EnterPlanMode: "EnterPlanMode";
     EscalateToPlanner: "EscalateToPlanner";
@@ -2700,6 +2714,7 @@ export declare const CodeGenInputOptionsSchema: z.ZodObject<{
         DevServerLogs: "DevServerLogs";
         DevServerRestart: "DevServerRestart";
         Edit: "Edit";
+        EnableDatabase: "EnableDatabase";
         EnsurePR: "EnsurePR";
         EnterPlanMode: "EnterPlanMode";
         EscalateToPlanner: "EscalateToPlanner";
@@ -2884,7 +2899,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" | "privacy-mode-key-mismatch" | "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;
@@ -3687,6 +3702,25 @@ export interface GetSessionTurnsResult {
     sessionMode?: SessionMode;
     hasPlanToApply?: boolean;
     metadata?: Record<string, any>;
+    /** SHA-256(JWK) of the key this session is encrypted with. Presence ⟹ private. */
+    encryptKeyHash?: string;
+    /** Org requires new sessions to be private; derived per-request, not stored. */
+    privacyModeRequired?: boolean;
+}
+/**
+ * Body for `POST /codegen/settings`. All context is optional; the server
+ * resolves settings for the narrowest scope it can, falling back to org.
+ */
+export declare const CodegenSettingsRequestSchema: z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodString>;
+    projectName: z.ZodOptional<z.ZodString>;
+    branchName: z.ZodOptional<z.ZodString>;
+    repoHash: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CodegenSettingsRequest = z.infer<typeof CodegenSettingsRequestSchema>;
+/** Load-independent client settings. v1 carries only the privacy gate. */
+export interface CodegenSettingsResult {
+    privacyModeRequired?: boolean;
 }
 export interface CodegenFeedback {
     id: string;
@@ -4774,5 +4808,10 @@ export interface SessionData {
     numUserMessages: number;
     numNormalUserMessages: number;
     metadata?: Record<string, any>;
+    /**
+     * SHA-256(JWK) of the encryption key this session is encrypted with.
+     * Presence makes the session private (sticky — no downgrade to plaintext).
+     */
+    encryptKeyHash?: string;
 }
 export {};

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.",
@@ -1022,6 +1025,8 @@ export const ProposedConfigSchema = z
     createdAt: z.number(),
     updatedAt: z.number(),
     ownerId: z.string(),
+    userInitiated: z.boolean(),
+    autoApply: z.boolean(),
     state: ExitStateSchema.meta({
         description: "Configuration state from Exit tool",
     }),
@@ -1482,6 +1487,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 +1579,7 @@ export const CodeGenToolMapSchema = z.object({
     PullPrototype: PullPrototypeToolInputSchema,
     ConnectMCP: ConnectMCPToolInputSchema,
     EnsurePR: EnsurePRToolInputSchema,
+    EnableDatabase: EnableDatabaseToolInputSchema,
     GenerateDesignSystemAgentMd: GenerateDesignSystemAgentMdInputSchema,
 });
 export const CodeGenToolsSchema = CodeGenToolMapSchema.keyof().meta({
@@ -1957,6 +1978,18 @@ export const GenerateUserMessageSchema = z
     }),
 })
     .meta({ title: "GenerateUserMessage" });
+/**
+ * Body for `POST /codegen/settings`. All context is optional; the server
+ * resolves settings for the narrowest scope it can, falling back to org.
+ */
+export const CodegenSettingsRequestSchema = z
+    .object({
+    sessionId: z.string().optional(),
+    projectName: z.string().optional(),
+    branchName: z.string().optional(),
+    repoHash: z.string().optional(),
+})
+    .meta({ title: "CodegenSettingsRequest" });
 /**
  * Request for generating a commit message via LLM
  */

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

@@ -229,6 +229,7 @@ export type GitConfigs = Record<string, GitConfig>;
 export declare const EXAMPLE_REPOS: string[];
 export declare const STARTER_REPO = "BuilderIO/fusion-starter";
 export declare const DSI_PREVIEW_REPO = "BuilderIO/dsi-starter";
+export declare const AGENT_NATIVE_STARTER_REPO = "BuilderIO/builder-agent-native-starter";
 export declare const EXAMPLE_OR_STARTER_REPOS: string[];
 export declare const EXAMPLE_OR_STARTER_REPOS_URLS: string[];
 export interface GitBackupUploadUrlResult {
@@ -1028,6 +1029,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;
@@ -1606,4 +1609,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

@@ -36,10 +36,12 @@ export const EXAMPLE_REPOS = [
 ];
 export const STARTER_REPO = "BuilderIO/fusion-starter";
 export const DSI_PREVIEW_REPO = "BuilderIO/dsi-starter";
+export const AGENT_NATIVE_STARTER_REPO = "BuilderIO/builder-agent-native-starter";
 export const EXAMPLE_OR_STARTER_REPOS = [
     ...EXAMPLE_REPOS,
     STARTER_REPO,
     DSI_PREVIEW_REPO,
+    AGENT_NATIVE_STARTER_REPO,
 ];
 export const EXAMPLE_OR_STARTER_REPOS_URLS = EXAMPLE_OR_STARTER_REPOS.map((repo) => `https://github.com/${repo}`);
 export const checkIsNewBranch = (branch) => {
@@ -507,3 +509,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.",
+    }),
+});