@builder.io/ai-utils 0.52.0 → 0.53.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.52.0",
+  "version": "0.53.1",
   "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;
@@ -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;
@@ -928,10 +946,13 @@ export interface CodeGenInputOptions {
      * @internal - Set by middleware, not by clients
      */
     branchAgentTypeChecked?: boolean;
+    /** Immediate parent session id when this completion runs inside a sub-agent. */
+    parentSessionId?: string;
     /**
-     * The parent session ID, used to roll up sub-agent costs into the parent session's extraCost.
+     * Root session of the agent tree. Sub-agents inherit this from their parent
+     * so cost rolls up to the root in one hop, regardless of nesting depth.
      */
-    parentSessionId?: string;
+    mainSessionId?: string;
     /** @deprecated */
     prevId?: string;
     /** @deprecated */
@@ -2077,6 +2098,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 +2107,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 +2153,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;
@@ -2507,8 +2539,16 @@ export interface SessionData {
     cost: number;
     /** Cost from tools (e.g. WebSearch LLM calls) and sub-agent roll-ups. Total session cost = cost + extraCost. */
     extraCost?: number;
-    /** If set, this session is a sub-agent of the given parent session. Used to avoid double-counting in aggregations. */
+    /** Immediate parent when this session is a sub-agent. */
     parentSessionId?: string;
+    /**
+     * Root of the agent tree this session belongs to. Sub-agents inherit
+     * `mainSessionId` from their parent so cost can roll up directly to the
+     * top in one hop, regardless of nesting depth.
+     */
+    mainSessionId?: string;
+    /** Agent role (e.g. "code-review-orchestrator", "browser-testing"). */
+    position?: string;
     /** Credits from tools (e.g. WebSearch LLM calls) and sub-agent roll-ups. Total session credits = per-completion tokenCreditsUsed + extraCreditsConsumed. */
     extraCreditsConsumed?: number;
     totalCompletions: number;

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

@@ -367,6 +367,13 @@ export interface PartialBranchData {
     type?: BranchType | null;
     /** Auto-assigned category based on the user prompt (feature, fix, research, other) */
     category?: BranchCategory | null;
+    /**
+     * Optional short words derived from the user prompt, used opportunistically
+     * by `generateBranchName` to make the auto-generated branch name human-readable
+     * (e.g. ["add", "user", "settings"] → "add-user-settings-x1y2z3a4"). A random
+     * suffix is appended to prevent collisions. Ignored when `name` is provided.
+     */
+    nameWords?: string[];
     cloneFrom?: {
         projectId: string;
         branchName: string;