@builder.io/ai-utils 0.11.4 → 0.11.6

package/package.json

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

package/src/codegen.d.ts

@@ -30,7 +30,7 @@ export interface CustomInstruction {
 }
 export type CodeGenFramework = "react" | "html" | "mitosis" | "react-native" | "angular" | "vue" | "svelte" | "qwik" | "solid" | "marko" | "swiftui" | "jetpack-compose" | "flutter";
 export type CodeGenStyleLibrary = "tailwind" | "tailwind-precise" | "emotion" | "styled-components" | "styled-jsx" | "react-native" | undefined;
-export type CompletionStopReason = "max_tokens" | "stop_sequence" | "tool_use" | "end_turn" | "content_filter" | "error" | "aborted" | "pause_turn" | "refusal" | null;
+export type CompletionStopReason = "max_tokens" | "stop_sequence" | "tool_use" | "end_turn" | "content_filter" | "error" | "aborted" | "pause_turn" | "refusal" | "model_context_window_exceeded" | null;
 export interface ViewPathToolInput {
     file_path: string;
     view_range?: [number, number];
@@ -167,6 +167,9 @@ export interface SetImportantFilesToolInput {
         limit?: number;
     }[];
 }
+export interface ExitPlanModeToolInput {
+    plan: string;
+}
 export interface CodeGenToolMap {
     view_path: ViewPathToolInput;
     glob_search: GlobSearchToolInput;
@@ -205,21 +208,30 @@ export interface CodeGenToolMap {
     LS: ListDirToolInput;
     WebFetch: WebFetchToolInput;
     SetImportantFiles: SetImportantFilesToolInput;
+    ExitPlanMode: ExitPlanModeToolInput;
 }
 export type CodeGenTools = keyof CodeGenToolMap;
 export type AllCodeGenTools = CodeGenTools | "web_search";
+export type SessionMode = "planning" | "normal";
 export type CodeGenMode = "quality" | "quality-v3" | "quality-v4" | "quality-v4-agent";
 export type BaseCodeGenPosition = "fusion" | "editor-ai" | "repo-indexing" | "cli" | "create-app-firebase" | "create-app-lovable" | "builder-code-panel";
 export type CodeGenPosition = BaseCodeGenPosition | `${BaseCodeGenPosition}-agent`;
 export interface RepoIndexingConfig {
     designSystems: string[];
 }
+export interface LocalMCPTools {
+    name: string;
+    description?: string;
+    inputSchema?: any;
+    serverName: string;
+}
 export type CodeGenCategory = `repair-${string}` | `user-normal` | `user-figma` | `user-pdf` | `user-image` | `background-${string}` | `indexing-${string}`;
 export interface CodeGenInputOptions {
     position: string;
     eventName?: string;
     sessionId: string;
     codeGenMode?: CodeGenMode;
+    sessionMode?: SessionMode;
     url?: string;
     diffActions?: boolean;
     planningPrompt?: boolean;
@@ -253,12 +265,7 @@ export interface CodeGenInputOptions {
      * Local MCP tool definitions from stdio servers (CLI-side only)
      * These tools will be executed on the client side and passed through from the server
      */
-    localMCPTools?: Array<{
-        name: string;
-        description?: string;
-        inputSchema?: any;
-        serverName: string;
-    }>;
+    localMCPTools?: LocalMCPTools[];
     maxAgentLoops?: number;
     maxAgentTiming?: number;
     /**
@@ -488,6 +495,7 @@ export interface GenerateCompletionStepWaitForInput {
     type: "wait-for-input";
     state: GenerateCompletionState;
     suggestion?: SuggestedAction;
+    sessionMode: SessionMode;
 }
 export type GenerateCompletionStepBuilderAction = GenerateCompletionStepBuilderActionRefresh | GenerateCompletionStepBuilderActionOpenPath | GenerateCompletionStepBuilderActionMCPConnect;
 export interface GenerateCompletionStepBuilderActionRefresh {
@@ -575,6 +583,7 @@ export interface GenerateCompletionStepSession {
     id: string;
     turns: number;
     lastCompletionId: string | undefined;
+    sessionMode: SessionMode;
 }
 export interface GenerateCompletionStepServerToolResult {
     type: "server_tool_result";
@@ -608,48 +617,42 @@ export interface ApplyActionsResult {
     content?: string;
     oldContent?: string;
 }
-export interface UserSourceBuilder {
+export type UserSourcePermission = "editCode" | "modifyMcpServers" | "modifyProjectSettings" | "createBranches" | "sendPullRequests" | "view";
+export interface UserSourceBase {
+    role: "user" | "agent";
+    principals?: string[];
+    permissions?: UserSourcePermission[];
+}
+export interface UserSourceBuilder extends UserSourceBase {
     source: "builder.io";
     userId?: string;
     userName?: string;
     userEmail?: string;
-    role: "user" | "agent";
     photoURL?: string;
-    principals?: string[];
 }
-export interface UserSourceGithub {
+export interface UserSourceGithub extends UserSourceBase {
     source: "github";
     userName: string;
     userEmail?: string;
     link?: string;
-    role: "user" | "agent";
-    principals?: string[];
 }
-export interface UserSourceGitlab {
+export interface UserSourceGitlab extends UserSourceBase {
     source: "gitlab";
     userName: string;
     link?: string;
-    role: "user" | "agent";
-    principals?: string[];
 }
-export interface UserSourceAzure {
+export interface UserSourceAzure extends UserSourceBase {
     source: "azure";
     userName: string;
     link?: string;
-    role: "user" | "agent";
-    principals?: string[];
 }
-export interface UserSourceBitbucket {
+export interface UserSourceBitbucket extends UserSourceBase {
     source: "bitbucket";
     userName: string;
     link?: string;
-    role: "user" | "agent";
-    principals?: string[];
 }
-export interface UserSourceAgent {
+export interface UserSourceAgent extends UserSourceBase {
     source: "agent";
-    role: "agent" | "user";
-    principals?: string[];
 }
 export type UserSource = UserSourceBuilder | UserSourceGithub | UserSourceGitlab | UserSourceAzure | UserSourceBitbucket | UserSourceAgent;
 export interface GenerateUserMessage {
@@ -671,6 +674,7 @@ export interface GenerateUserMessage {
     metadata?: Record<string, any>;
     autoPush?: "force-push" | "merge-push" | "ff-push" | "none";
     enabledMCPs?: string[];
+    sessionMode?: SessionMode;
     /** @deprecated */
     repair?: boolean;
 }
@@ -720,6 +724,7 @@ export interface GetSessionTurnsResult {
     createdUnixTime: number | undefined;
     updatedUnixTime: number | undefined;
     canLoadMore: boolean;
+    sessionMode?: SessionMode;
 }
 export interface CodegenFeedback {
     id: string;

package/src/messages.d.ts

@@ -25,6 +25,12 @@ export interface ContentMessageItemDocument {
     ephemeral?: boolean;
     title?: string;
 }
+export interface ContentMessageItemVideo {
+    type: "video";
+    source: VideoUrlSource;
+    cache?: boolean;
+    ephemeral?: boolean;
+}
 export interface DocumentBase64Source {
     type: "base64";
     media_type: "application/pdf";
@@ -61,6 +67,11 @@ export interface ImageUrlSource {
     type: "url";
     url: string;
 }
+export interface VideoUrlSource {
+    type: "url";
+    url: string;
+    media_type?: "video/mp4" | "video/mov" | "video/mpeg" | "video/mpg" | "video/avi" | "video/wmv" | "video/webm" | "video/flv";
+}
 export interface ContentMessageItemThinking {
     type: "thinking";
     thinking: string;
@@ -130,7 +141,7 @@ export type ServerToolUseContentUnion = ServerToolUseContent[] | ServerToolUseCo
 export interface ContentMessageItemServerToolUse {
     type: "server_tool_use";
     id: string;
-    name: "web_search" | "code_execution";
+    name: "web_search" | "code_execution" | "web_fetch" | "bash_code_execution" | "text_editor_code_execution";
     input: unknown;
     completion?: string;
     content?: any;
@@ -180,7 +191,7 @@ export interface ContentMessageItemCodeExecutionToolResult {
     content: any;
     cache?: boolean;
 }
-export type ContentMessageItem = ContentMessageItemText | ContentMessageItemImage | ContentMessageItemDocument | ContentMessageItemThinking | ContentMessageItemRedactedThinking | ContentMessageItemToolUse | ContentMessageItemToolResult | ContentMessageItemWebSearchToolResult | ContentMessageItemServerToolUse | ContentMessageItemMCPToolUse | ContentMessageItemMCPToolResult | ContentMessageItemContainerUpload | ContentMessageItemCodeExecutionToolResult;
+export type ContentMessageItem = ContentMessageItemText | ContentMessageItemImage | ContentMessageItemDocument | ContentMessageItemVideo | ContentMessageItemThinking | ContentMessageItemRedactedThinking | ContentMessageItemToolUse | ContentMessageItemToolResult | ContentMessageItemWebSearchToolResult | ContentMessageItemServerToolUse | ContentMessageItemMCPToolUse | ContentMessageItemMCPToolResult | ContentMessageItemContainerUpload | ContentMessageItemCodeExecutionToolResult;
 export type ContentMessage = ContentMessageItem[];
 export interface SystemMessageParam {
     /**
@@ -198,7 +209,7 @@ export interface UserMessageParam {
     /**
      * The contents of the user message.
      */
-    content: string | (ContentMessageItemText | ContentMessageItemImage | ContentMessageItemDocument | ContentMessageItemToolResult)[];
+    content: string | (ContentMessageItemText | ContentMessageItemImage | ContentMessageItemDocument | ContentMessageItemVideo | ContentMessageItemToolResult)[];
     responseId?: string;
     /**
      * The role of the messages author, in this case `user`.