@builder.io/ai-utils 0.28.0 → 0.29.1

package/package.json

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

package/src/claw.d.ts

@@ -40,5 +40,6 @@ export interface ParsedChannelId {
  * Examples:
  *   "slack/thread/T01234/C56789/1234567890.123456" → { platform: "slack", type: "thread", ids: ["T01234", "C56789", "1234567890.123456"] }
  *   "jira/comment/cloud-id/PROJ-123" → { platform: "jira", type: "comment", ids: ["cloud-id", "PROJ-123"] }
+ *   "builder/branch/proj-id/my-branch" → { platform: "builder", type: "branch", ids: ["proj-id", "my-branch"] }
  */
 export declare function parseChannelId(channelId: string): ParsedChannelId;

package/src/claw.js

@@ -5,6 +5,7 @@
  * Examples:
  *   "slack/thread/T01234/C56789/1234567890.123456" → { platform: "slack", type: "thread", ids: ["T01234", "C56789", "1234567890.123456"] }
  *   "jira/comment/cloud-id/PROJ-123" → { platform: "jira", type: "comment", ids: ["cloud-id", "PROJ-123"] }
+ *   "builder/branch/proj-id/my-branch" → { platform: "builder", type: "branch", ids: ["proj-id", "my-branch"] }
  */
 export function parseChannelId(channelId) {
     const parts = channelId.split("/");

package/src/codegen.d.ts

@@ -325,6 +325,8 @@ export interface ExitToolInput {
     isMicrofrontend?: boolean;
     setupNeedsCredentials?: boolean;
     devServerNeedsCredentials?: boolean;
+    /** A human-readable description of what the project is about (not tech specs), used by fusion to route requests to the right project */
+    projectDescription?: string;
 }
 /**
  * Configuration proposed by the configuration agent, stored in Firebase
@@ -412,6 +414,7 @@ export interface ProposedConfig {
     isMicrofrontend?: boolean;
     setupNeedsCredentials?: boolean;
     devServerNeedsCredentials?: boolean;
+    projectDescription?: string;
     cost?: number;
     durationMs?: number;
 }
@@ -444,6 +447,7 @@ export interface ProposeConfigParams {
     isMicrofrontend?: boolean;
     setupNeedsCredentials?: boolean;
     devServerNeedsCredentials?: boolean;
+    projectDescription?: string;
 }
 export interface VerifySetupCommandToolInput {
     command: string;
@@ -481,7 +485,7 @@ export interface SetEnvVariableToolInput {
 export interface SendMessageToolInput {
     channelId: string;
     markdown: string;
-    status: "starting" | "question" | "done:success" | "done:error";
+    status: "starting" | "question" | "will-follow-up" | "done:success" | "done:error";
 }
 export interface SpawnBranchToolInput {
     projectId: string;
@@ -489,12 +493,6 @@ export interface SpawnBranchToolInput {
     builderUserId?: string;
     hidden?: boolean;
 }
-export interface SendMessageToBranchToolInput {
-    projectId: string;
-    branchName: string;
-    message: string;
-    builderUserId?: string;
-}
 export interface ReadBranchToolInput {
     projectId: string;
     branchName: string;
@@ -602,7 +600,6 @@ export interface CodeGenToolMap {
     SetEnvVariable: SetEnvVariableToolInput;
     SendMessage: SendMessageToolInput;
     SpawnBranch: SpawnBranchToolInput;
-    SendMessageToBranch: SendMessageToBranchToolInput;
     ReadBranch: ReadBranchToolInput;
     RunningAgents: RunningAgentsToolInput;
 }
@@ -1150,7 +1147,7 @@ export interface UserSourceBase {
 }
 /** All integration sources: Slack, Teams, Jira, Linear, and git providers (GitHub, GitLab, Azure, Bitbucket). */
 export interface UserSourceOther extends UserSourceBase {
-    source: "slack" | "teams" | "jira" | "linear" | "github" | "gitlab" | "azure" | "bitbucket";
+    source: "slack" | "telegram" | "teams" | "jira" | "linear" | "github" | "gitlab" | "azure" | "bitbucket";
     /** User ID from the external platform (Slack user ID, GitHub user id, etc.) */
     userId?: string;
     userName?: string;
@@ -1170,6 +1167,9 @@ export interface UserSourceBuilder extends UserSourceBase {
 }
 export interface UserSourceAgent extends UserSourceBase {
     source: "agent";
+    userId?: string;
+    userName?: string;
+    userEmail?: string;
 }
 export type UserSource = UserSourceOther | UserSourceBuilder | UserSourceAgent;
 export type AutoPushMode = "force-push" | "merge-push" | "ff-push" | "safe-push" | "none";

package/src/events.d.ts

@@ -1,7 +1,8 @@
 import type { BuilderContent, BuilderElement } from "@builder.io/sdk";
 import type { AssistantMessage, AssistantMessageAction } from "./messages.js";
 import type { AssistantSettings } from "./settings.js";
-import type { ExitState } from "./codegen.js";
+import type { ExitState, UserSource } from "./codegen.js";
+import type { FileUpload } from "./messages.js";
 export type BuilderAssistantEventHandler = (ev: BuilderAssistantEvent) => void;
 export type BuilderAssistantEvent = AssistantCompletionResultEvent | AssistantErrorEvent | AssistantStreamErrorEvent | AppCloseEvent | AppMessagesClickEvent | AppMessagesGenerationEvent | AppMessageEditCustomInstructionsEvent | AppPromptAbortEvent | AppPromptFocusEvent | AppPromptSubmitEvent | AppReadyEvent | AppSettingsSetEvent | AppThreadNewEvent | AssistantStatsEvent | AssistantThemeEvent | BuilderEditorAuthEvent | BuilderEditorStateEvent | ContentUpdateEvent | ContentApplySnapshotEvent | ModelUndoEvent | ModelRedoEvent | ResultEvent | ThreadCreatedEvent | ThreadMessageCompletedEvent | ThreadMessageCreatedEvent | ThreadMessageDeltaEvent | ThreadMessageFeedbackEvent | ThreadRunStepCreatedEvent | ThreadRunStepDeltaEvent | AppAcceptChangeEvent | AppAcceptRejectEvent | AssistantTrackEvent | AssistantEditorAuthMessage | AppAttachmentTemplateEvent | AppPasteSmartExportEvent | ThreadMessageRetryEvent | AppFigmaImportEvent | AppWebImportEvent | AppMcpServersEvent | AssistantContentInitialEvent | ThreadMessageSummaryEvent | ThreadMessageSummaryCodegenDeltaEvent | ThreadMessageThinkingDeltaEvent | AssistantHeartbeatEvent | ShowUpgradeDialogEvent | AssistantFusionSuggestionEvent | AppNavigateToFusionEvent | ModelPermissionRequiredEvent | ModelPermissionResponseEvent;
 export interface AssistantCompletionResultEvent {
@@ -527,14 +528,24 @@ export type ClawMessageSentV1 = FusionEventVariant<"claw.message.sent", {
     senderId?: string;
     correlationId?: string;
     channelId?: string;
+    dmId?: string;
     senderDisplayName?: string;
+    userSource?: UserSource;
     /** Optional context to include alongside the message (e.g. Slack thread history). */
     messageContext?: string;
+    /** File attachments (images, PDFs, etc.) to include with the message. */
+    attachments?: FileUpload[];
 }, {}, 1>;
 export declare const ClawMessageSentV1: {
     eventName: "claw.message.sent";
     version: "1";
 };
+export interface SendMessageToOrgAgentInput {
+    content: string;
+    channelId?: string;
+    senderDisplayName?: string;
+    messageContext?: string;
+}
 export type FusionEvent = AiTaskCompletedEvent | AiTaskFailedEvent | GitPrCreatedEvent | ClientDevtoolsSessionStartedEvent | FusionProjectCreatedV1 | SetupAgentCompletedV1 | ForceSetupAgentV1 | ClawMessageSentV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";

package/src/messages.d.ts

@@ -32,6 +32,15 @@ export interface ContentMessageItemVideo {
     cache?: boolean;
     ephemeral?: boolean;
 }
+export interface ContentMessageItemResource {
+    type: "resource";
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+        blob?: string;
+    };
+}
 export interface DocumentBase64Source {
     type: "base64";
     media_type: "application/pdf";
@@ -53,7 +62,7 @@ export interface ContentMessageItemToolResult {
     tool_name?: string;
     tool_input?: string;
     title?: string;
-    content: string | (ContentMessageItemText | ContentMessageItemImage)[];
+    content: string | (ContentMessageItemText | ContentMessageItemImage | ContentMessageItemResource)[];
     is_error?: boolean;
     cache?: boolean;
     ephemeral?: boolean;
@@ -195,7 +204,7 @@ export interface ContentMessageItemCodeExecutionToolResult {
     content: any;
     cache?: boolean;
 }
-export type ContentMessageItem = ContentMessageItemText | ContentMessageItemImage | ContentMessageItemDocument | ContentMessageItemVideo | ContentMessageItemThinking | ContentMessageItemRedactedThinking | ContentMessageItemToolUse | ContentMessageItemToolResult | ContentMessageItemWebSearchToolResult | ContentMessageItemServerToolUse | ContentMessageItemMCPToolUse | ContentMessageItemMCPToolResult | ContentMessageItemContainerUpload | ContentMessageItemCodeExecutionToolResult;
+export type ContentMessageItem = ContentMessageItemText | ContentMessageItemImage | ContentMessageItemResource | ContentMessageItemDocument | ContentMessageItemVideo | ContentMessageItemThinking | ContentMessageItemRedactedThinking | ContentMessageItemToolUse | ContentMessageItemToolResult | ContentMessageItemWebSearchToolResult | ContentMessageItemServerToolUse | ContentMessageItemMCPToolUse | ContentMessageItemMCPToolResult | ContentMessageItemContainerUpload | ContentMessageItemCodeExecutionToolResult;
 export type ContentMessage = ContentMessageItem[];
 export interface SystemMessageParam {
     /**

package/src/projects.d.ts

@@ -374,6 +374,7 @@ export interface PrInfo {
     prNumber: number;
     prUrl: string;
     status: PRStatus;
+    updatedAt: number;
 }
 /**
  * Metadata stored in branches for integration tracking and PR description generation.
@@ -423,6 +424,7 @@ export interface BranchSharedData {
     prUrl?: string | null;
     prInfoByFolder?: Record<string, PrInfo> | null;
     prStatus?: PRStatus;
+    prStatusUpdatedAt?: number | null;
     machineId?: string | null;
     lastMachineIdRemovedAt?: number | null;
     volumeId?: string | null;
@@ -779,6 +781,8 @@ export interface CreateBranchOptions {
     type?: BranchType;
     /** Optional suffix to append to generated branch names (e.g., model short name for parallel branches) */
     branchNameSuffix?: string;
+    /** Additional metadata to store on the branch (e.g., Slack thread origin) */
+    metadata?: Record<string, unknown>;
 }
 interface BaseCreateBranchMessage {
 }