@builder.io/ai-utils 0.33.1 → 0.35.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.33.1",
+  "version": "0.35.0",
   "description": "Builder.io AI utils",
   "type": "module",
   "main": "src/index.js",

package/src/codegen.d.ts

@@ -1713,7 +1713,11 @@ export interface FusionConfig {
     proxyDefaultOrigin?: string;
     setupDependencies?: SetupDependency[];
     projectId?: string;
+    /** Human-readable project name (e.g. "My App") */
+    projectName?: string;
     branchName?: string;
+    /** Human-readable branch name, AI-generated or user-set (e.g. "Add dark mode") */
+    branchFriendlyName?: string;
     sessionId?: string;
     browserAutomationInstructions?: string;
     /** Whether this branch is for a code review - affects enabled agents and tools */

package/src/connectivity/targets.js

@@ -4,6 +4,7 @@ export const BUILDER_TARGETS = {
     "api.builder.io": "https://api.builder.io/codegen/health",
     "cdn.builder.io": "https://cdn.builder.io/api/v1/image/assets/TEMP/75a212ab82b6175c9862b125e0e23db8d369a58a?width=100",
     "builderio.xyz": "https://builderio.xyz/health",
+    "health.builderio.xyz": "https://health.builderio.xyz/health",
     "fly.dev": "https://fly.dev",
 };
 export const DEFAULT_PORTS = {

package/src/connectivity/types.d.ts

@@ -1,5 +1,5 @@
 export type Source = "local" | "cloud" | "static-ip";
-export type TestId = "builder.io" | "builder.codes" | "api.builder.io" | "cdn.builder.io" | "builderio.xyz" | "fly.dev" | "git-host:http" | "git-host:dns" | "git-host:tcp" | "git-host:tls" | "git-host:ssh";
+export type TestId = "builder.io" | "builder.codes" | "api.builder.io" | "cdn.builder.io" | "builderio.xyz" | "health.builderio.xyz" | "fly.dev" | "git-host:http" | "git-host:dns" | "git-host:tcp" | "git-host:tls" | "git-host:ssh";
 export interface Test {
     source: Source;
     testId: TestId;

package/src/events.d.ts

@@ -544,6 +544,13 @@ export type ClawMessageSentV1 = FusionEventVariant<"claw.message.sent", {
     messageContext?: string;
     /** File attachments (images, PDFs, etc.) to include with the message. */
     attachments?: FileUpload[];
+    /**
+     * When true, automatically create the org agent project if it doesn't exist.
+     * Set to true for human-initiated flows (Slack, Telegram, inbox).
+     * Set to false for system/worker flows that should not trigger project creation.
+     * Defaults to false.
+     */
+    autoCreateProject?: boolean;
 }, {}, 1>;
 export declare const ClawMessageSentV1: {
     eventName: "claw.message.sent";
@@ -591,6 +598,13 @@ export declare const CodegenUserPromptV1: {
     eventName: "codegen.user.prompt";
     version: "1";
 };
+export type GitWebhooksRegisterV1 = FusionEventVariant<"git.webhooks.register", {
+    projectId: string;
+}, {}, 1>;
+export declare const GitWebhooksRegisterV1: {
+    eventName: "git.webhooks.register";
+    version: "1";
+};
 export interface SendMessageToOrgAgentInput {
     agentBranchName?: string;
     agentProjectId?: string;
@@ -603,8 +617,15 @@ export interface SendMessageToOrgAgentInput {
     dmId?: string;
     userSource?: UserSource;
     attachments?: FileUpload[];
+    /**
+     * When true, automatically create the org agent project if it doesn't exist.
+     * Set to true for human-initiated flows (Slack, Telegram, inbox).
+     * Set to false for system/worker flows that should not trigger project creation.
+     * Defaults to false.
+     */
+    autoCreateProject?: boolean;
 }
-export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | GitPrCreatedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1;
+export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | GitPrCreatedEvent | ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -42,3 +42,7 @@ export const CodegenUserPromptV1 = {
     eventName: "codegen.user.prompt",
     version: "1",
 };
+export const GitWebhooksRegisterV1 = {
+    eventName: "git.webhooks.register",
+    version: "1",
+};

package/src/messages.d.ts

@@ -154,6 +154,7 @@ export interface ContentMessageItemServerToolUse {
     id: string;
     name: "web_search" | "code_execution" | "web_fetch" | "bash_code_execution" | "text_editor_code_execution" | "tool_search_tool_regex" | "tool_search_tool_bm25";
     input: unknown;
+    caller?: any;
     completion?: string;
     content?: any;
     cache?: boolean;
@@ -177,6 +178,7 @@ export interface ContentMessageItemWebSearchToolResult {
     content: ServerToolUseContent[] | ServerToolUseContentError;
     tool_use_id: string;
     type: "web_search_tool_result";
+    caller?: any;
     cache?: boolean;
 }
 export interface ContentMessageItemMCPToolUse {

package/src/projects.d.ts

@@ -363,6 +363,8 @@ export interface PartialBranchData {
     isFork?: boolean | null;
     /** Whether this branch is for a code review - affects enabled agents and tools*/
     type?: BranchType | null;
+    /** Auto-assigned category based on the user prompt (feature, fix, research, other) */
+    category?: BranchCategory | null;
     cloneFrom?: {
         projectId: string;
         branchName: string;
@@ -420,6 +422,8 @@ export interface OrgAgentConfig {
     longLived: boolean;
 }
 export type BranchType = "code-review" | "setup-project" | "org-agent" | "default";
+/** Category of work a branch represents, auto-assigned during prompt analysis. */
+export type BranchCategory = "feature" | "fix" | "research" | "other";
 export interface BranchSharedData {
     appName?: string | null;
     prNumber?: number | null;
@@ -489,6 +493,8 @@ export interface BranchSharedData {
     screenshots?: Record<string, string>;
     /** Whether this branch is for a code review - affects enabled agents and tools */
     type?: BranchType | null;
+    /** Auto-assigned category based on the user prompt (feature, fix, research, other) */
+    category?: BranchCategory | null;
     agentType?: AgentType | null;
     /** ID of the last PR review — doubles as the vcpCodeGenEvents completion ID for feedback */
     lastReviewId?: string | null;
@@ -808,6 +814,7 @@ export interface SettingUpContainerMessage extends BaseCreateBranchMessage {
     branchName: string;
     branchFriendlyName: string | undefined;
     branchDescription: string | undefined;
+    branchCategory: BranchCategory | undefined;
 }
 export interface ContainerReadyMessage extends BaseCreateBranchMessage {
     type: "container-ready";