@builder.io/ai-utils 0.53.0 → 0.54.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/codegen.d.ts

@@ -828,7 +828,13 @@ export interface GetLastBrowserTestToolInput {
 export type CodeGenTools = keyof CodeGenToolMap;
 export type AllCodeGenTools = CodeGenTools | "web_search";
 export type SessionMode = "planning" | "normal" | "auto-planning" | "deep-research";
-export type CodeGenMode = "quality" | "quality-v3" | "quality-v4" | "quality-v4-agent";
+export type CodeGenMode = "quality" | "quality-v3" | "quality-v4"
+/**
+ * @deprecated Use `quality-v4` instead. Kept for backwards compatibility
+ * with older dev-tools clients in the wild that may still request this mode
+ * for sub-agents. New code should not produce this value.
+ */
+ | "quality-v4-agent";
 export type QueueMode = "next-turn" | "until-idle";
 export declare const BASE_CODEGEN_POSITIONS: readonly ["fusion", "editor-ai", "repo-indexing", "cli", "create-app-firebase", "create-app-lovable", "builder-code-panel", "setup-project", "code-review-orchestrator", "project-configuration", "org-agent", "browser-testing", "projects-scheduler-memory-extraction", "builder-code", "unknown", "dsi-mcp"];
 export type BaseCodeGenPosition = (typeof BASE_CODEGEN_POSITIONS)[number];
@@ -946,10 +952,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 */
@@ -2536,8 +2545,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/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;