@builder.io/ai-utils 0.53.0 → 0.53.1

package/package.json

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

package/src/codegen.d.ts

@@ -946,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 */
@@ -2536,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/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;