@builder.io/ai-utils 0.27.4 → 0.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.27.4",
+  "version": "0.29.0",
   "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;
@@ -1150,7 +1154,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;
@@ -1576,15 +1580,20 @@ export interface EnvironmentVariable {
 }
 export interface FileOverride {
     /**
-     * Absolute path where the file should be written in the container.
-     * Example: "/app/.env", "/etc/config/app.conf"
+     * Path where the file should be written.
+     * Supports absolute paths ("/app/.env"), tilde ("~/.npmrc"), and relative paths ("./config.json").
      */
     path: string;
     /**
-     * Content to write to the file.
-     * Can be plain text or binary content (base64 encoded if needed).
+     * Plain text content to write to the file.
+     * Mutually exclusive with `base64`.
      */
-    content: string;
+    content?: string;
+    /**
+     * Base64-encoded binary content to write to the file.
+     * Mutually exclusive with `content`.
+     */
+    base64?: string;
 }
 export interface MCPServerDefinition {
     command: string;
@@ -2066,6 +2075,7 @@ export interface ConfigureDevOrchestratorUpdates {
     validateCommand: boolean;
     hosts: boolean;
     env: boolean;
+    fileOverrides: boolean;
     setupResult: SetupCommandResult | undefined;
     devResult: DevCommandResult | undefined;
     validateResult: ValidateCommandResult | undefined;
@@ -2083,6 +2093,7 @@ export interface ConfigureDevOrchestratorOpts {
     forceDevCommand?: boolean;
     autoDetectDevServer?: boolean;
     autoDetectDevServerPatterns?: string[];
+    fileOverrides?: FileOverride[];
 }
 export interface LanguageInfo {
     color: string;

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,12 +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

@@ -779,6 +779,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 {
 }