@builder.io/ai-utils 0.51.0 → 0.53.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.51.0",
+  "version": "0.53.0",
   "description": "Builder.io AI utils",
   "files": [
     "src"
@@ -21,5 +21,8 @@
       "types": "./src/connectivity/browser.d.ts",
       "import": "./src/connectivity/browser.js"
     }
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
   }
 }

package/src/codegen.d.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import type { Attachment, ContentMessageItemToolResult } from "./messages";
 import type { BuilderContent } from "./completion";
 import type { Options as PrettierOptions } from "prettier";
@@ -36,7 +37,13 @@ export interface CustomInstruction {
     userInvocable?: boolean;
 }
 /** Reasoning effort level for LLM completions. */
-export type ReasoningEffort = "low" | "medium" | "high" | "minimal";
+export declare const ReasoningEffortSchema: z.ZodEnum<{
+    low: "low";
+    medium: "medium";
+    high: "high";
+    minimal: "minimal";
+}>;
+export type ReasoningEffort = z.infer<typeof ReasoningEffortSchema>;
 export interface CustomAgentInfo {
     name: string;
     description?: string;
@@ -448,7 +455,7 @@ export interface UpdateSetupValueToolInput {
     };
     reason: string;
 }
-export type ExitState = "verified" | "no-frontend" | "empty-project" | "mobile-project" | "user-question" | "code-change-required" | "other" | "started";
+export type ExitState = "verified" | "no-frontend" | "empty-project" | "mobile-project" | "user-question" | "code-change-required" | "other" | "started" | "failed";
 export interface ExitToolInput {
     state: ExitState;
     summary: string;
@@ -652,6 +659,16 @@ export interface SendMessageToolInput {
      * Default to false (text) for all text-originated messages.
      */
     voice_response?: boolean;
+    /**
+     * Builder.io user ID this message is from / should be attributed to. Only
+     * allowed when channel_id is 'builder/branch/{project_id}/{branch_name}'.
+     * When set, the message is delivered to the target branch as coming from
+     * this user (role 'user') instead of from the agent. Use whenever the
+     * message represents user feedback/intent that should be assigned to
+     * someone — even if it was composed, summarized, or merged from multiple
+     * people.
+     */
+    from_user_id?: string;
 }
 export interface SpawnBranchToolInput {
     project_id: string;
@@ -662,6 +679,7 @@ export interface SpawnBranchToolInput {
     session_mode?: "normal" | "planning" | "deep-research";
     model?: "auto" | "opus" | "sonnet" | "haiku";
     attachment_urls?: string[];
+    git_base_branch?: string;
 }
 export interface CreateProjectToolInput {
     repo_url: string;
@@ -2077,6 +2095,7 @@ export interface InitState {
     }[];
 }
 export type LaunchServerState = "initial" | "init-running" | "init-complete" | "ready" | "active-session" | "init-error" | "session-error" | "error" | "closing";
+export type LaunchServerPhase = "state-created" | "server-starting" | "server-error" | "server-listening" | "dev-server-configured" | "dev-server-error" | "setup-command-waiting" | "setup-command-error" | "launch-server-setup" | "websocket-ready" | "state-ready" | "editor-url-building" | "editor-url-ready" | "editor-ready" | "launch-error";
 export interface LaunchServerStatus {
     status: "ok";
     state: LaunchServerState;
@@ -2085,12 +2104,17 @@ export interface LaunchServerStatus {
     isFinalState: boolean;
     httpServerState?: HttpServerState;
     editorReady: boolean;
+    editorReadyAt?: number;
+    editorReadySource?: string;
     initState?: InitState;
     initStatusLogs?: InitStatusLog[];
     errorMessage?: string;
     devToolsVersion: string;
     lastRequestTime: number;
     startTime: number;
+    processId: number;
+    launchPhase?: LaunchServerPhase;
+    launchPhaseUpdatedAt?: number;
     machine?: MachineConfig;
     projectId?: string;
     detectedServerUrl?: string;
@@ -2126,12 +2150,17 @@ export interface FusionStatus {
     setupState: SetupCommandState | undefined;
     devState: DevCommandState | undefined;
     editorReady: boolean;
+    editorReadyAt: number | undefined;
+    editorReadySource: string | undefined;
     httpServerState: HttpServerState | undefined;
     initState: InitState | undefined;
     errorMessage: string | undefined;
     devToolsVersion: string;
     idleTime: number;
     upTime: number;
+    processId: number;
+    launchPhase: LaunchServerPhase | undefined;
+    launchPhaseUpdatedAt: number | undefined;
     machine: MachineConfig | undefined;
     projectId: string | undefined;
     detectedServerUrl: string | undefined;

package/src/codegen.js

@@ -1,3 +1,8 @@
+import { z } from "zod";
+/** Reasoning effort level for LLM completions. */
+export const ReasoningEffortSchema = z
+    .enum(["low", "medium", "high", "minimal"])
+    .meta({ title: "ReasoningEffort" });
 export const BASE_CODEGEN_POSITIONS = [
     "fusion",
     "editor-ai",

package/src/organization.d.ts

@@ -84,6 +84,8 @@ interface OrganizationSettings {
     fusionShareableUrlSuffix?: string;
     autoDetectDevServerPatterns?: string[];
     environmentVariables?: EnvironmentVariable[];
+    projectsUseGithubServerToken?: boolean;
+    prAuthoringMode?: "" | "prefer-user" | "always-bot" | "always-user";
     fusionPrLabel?: string;
     fusionPrQuietMode?: boolean;
     runInPty?: boolean;

package/src/projects.d.ts

@@ -371,6 +371,13 @@ export interface PartialBranchData {
         projectId: string;
         branchName: string;
     };
+    /**
+     * Pre-generated sessionId. internal use only. When provided, the branch will use this sessionId
+     * instead of generating a new one. Allows callers (e.g. setup-agent spawner)
+     * to bootstrap a ProposedConfig doc keyed by sessionId before the branch
+     * record is fully created.
+     */
+    sessionId?: string;
 }
 export type EntityState = "active" | "deleted" | "archived";
 /**
@@ -724,6 +731,8 @@ export interface Project {
     useBranchesCollection?: boolean;
     /** When true, the project is in code-only mode */
     codeOnlyMode?: boolean;
+    /** When true, analysis detected a mobile-only app (no usable web dev server path) */
+    mobileOnlyDetected?: boolean;
     /** When true, this project is an org-level Claw agent */
     isOrgAgent?: boolean;
     /** Configuration for the org agent */
@@ -854,6 +863,17 @@ export interface CreateBranchOptions {
         branchName: string;
         url: string;
     }) => Promise<void> | void;
+    /**
+     * INTERNAL ONLY. Pre-generated sessionId used by trusted callers
+     * (e.g. setup-agent spawner) to bootstrap a ProposedConfig doc keyed by
+     * sessionId before the branch record exists.
+     *
+     * SECURITY: Must be stripped from any user-facing HTTP request body — this
+     * value becomes a Firestore document ID and accepting it from untrusted
+     * input enables cross-user ProposedConfig corruption via
+     * `.set(..., { merge: true })`.
+     */
+    sessionId?: string;
 }
 interface BaseCreateBranchMessage {
 }