@vertesia/common 1.6.0-dev.20260923.085325Z → 1.6.0-dev.20261008.064737Z

package/src/api-contract/components.generated.json

@@ -1,4 +1,49 @@
 {
+  "RunBudgetCapability": {
+    "type": "object",
+    "properties": {
+      "supported": {
+        "type": "boolean"
+      },
+      "source": {
+        "type": "string",
+        "enum": [
+          "provider",
+          "estimate",
+          "unavailable"
+        ]
+      },
+      "reason": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "supported",
+      "source"
+    ],
+    "additionalProperties": false
+  },
+  "RunBudgetCapabilityQuery": {
+    "type": "object",
+    "properties": {
+      "check_model": {
+        "type": "boolean",
+        "description": "False checks only whether estimates are enabled, without consulting model prices."
+      },
+      "model": {
+        "type": "string",
+        "minLength": 1
+      },
+      "service_tier": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "model"
+    ],
+    "additionalProperties": false,
+    "description": "Selected model and requested serving tier for run budget admission."
+  },
   "CreateDelegationGrantPayload": {
     "type": "object",
     "properties": {
@@ -126,20 +171,6 @@
       "$ref": "#/components/schemas/DelegationGrant"
     }
   },
-  "AccountApiVersionPolicy": {
-    "type": "object",
-    "properties": {
-      "default_api_version": {
-        "type": "number",
-        "enum": [
-          20250925,
-          20260210,
-          20260319,
-          20260803
-        ]
-      }
-    }
-  },
   "AccountType": {
     "type": "string",
     "enum": [
@@ -1050,6 +1081,8 @@
     "enum": [
       "document",
       "collection",
+      "agent_run",
+      "shared_content",
       "task"
     ]
   },
@@ -1066,7 +1099,7 @@
       },
       "scope": {
         "$ref": "#/components/schemas/AbacScope",
-        "description": "Kind of object the `resource_props` matches. Used to disambiguate which partition's roles apply (e.g. content roles vs task roles) and to form the JWT `content_security` key prefix (`{scope}:{verb}`). Absent → `'document'` (default; emits bare `read`/`write`/`delete` keys for backward compatibility)."
+        "description": "Kind of object the `resource_props` matches. Used to disambiguate which partition's roles apply (e.g. content roles vs agent-run roles) and to form the JWT `content_security` key prefix (`{scope}:{verb}`). Absent → `'document'` (default; emits bare `read`/`write`/`delete` keys for backward compatibility)."
       }
     },
     "additionalProperties": false,
@@ -1077,7 +1110,7 @@
     "properties": {
       "role": {
         "type": "string",
-        "description": "Role name. Typed as `string` because role names now span multiple partitions: `SystemRoles` enum values for system-domain roles, and bare strings for ABAC-domain roles (e.g. `'content:reader'`, `'content:writer'`, `'content:manager'`). Mongoose schema validates the value against the registered role catalog via `getAllRoleNames()`."
+        "description": "Role name. Typed as `string` because role names now span multiple partitions: `SystemRoles` enum values for system-domain roles, and bare strings for ABAC-domain roles (e.g. `'content:reader'`, `'content:writer'`, `'content:manager'`, `'agent_runs:reader'`). Mongoose schema validates the value against the registered role catalog via `getAllRoleNames()`."
       },
       "resource_type": {
         "$ref": "#/components/schemas/AccessControlResourceType"
@@ -1143,7 +1176,7 @@
     "properties": {
       "role": {
         "type": "string",
-        "description": "Role name. Typed as `string` because role names now span multiple partitions: `SystemRoles` enum values for system-domain roles, and bare strings for ABAC-domain roles (e.g. `'content:reader'`, `'content:writer'`, `'content:manager'`). Mongoose schema validates the value against the registered role catalog via `getAllRoleNames()`."
+        "description": "Role name. Typed as `string` because role names now span multiple partitions: `SystemRoles` enum values for system-domain roles, and bare strings for ABAC-domain roles (e.g. `'content:reader'`, `'content:writer'`, `'content:manager'`, `'agent_runs:reader'`). Mongoose schema validates the value against the registered role catalog via `getAllRoleNames()`."
       },
       "resource_type": {
         "$ref": "#/components/schemas/AccessControlResourceType"
@@ -1193,7 +1226,7 @@
     "properties": {
       "role": {
         "type": "string",
-        "description": "Role name. Typed as `string` because role names now span multiple partitions: `SystemRoles` enum values for system-domain roles, and bare strings for ABAC-domain roles (e.g. `'content:reader'`, `'content:writer'`, `'content:manager'`). Mongoose schema validates the value against the registered role catalog via `getAllRoleNames()`."
+        "description": "Role name. Typed as `string` because role names now span multiple partitions: `SystemRoles` enum values for system-domain roles, and bare strings for ABAC-domain roles (e.g. `'content:reader'`, `'content:writer'`, `'content:manager'`, `'agent_runs:reader'`). Mongoose schema validates the value against the registered role catalog via `getAllRoleNames()`."
       },
       "resource_type": {
         "$ref": "#/components/schemas/AccessControlResourceType"
@@ -1290,9 +1323,11 @@
     "enum": [
       "system",
       "content",
+      "agent_runs",
+      "shared_content",
       "tasks"
     ],
-    "description": "Logical grouping of roles by the service area that owns them. One domain may declare roles applicable to multiple scopes (e.g. the `content` domain owns roles applicable to both `document` and `collection` scopes). The `system` domain owns the built-in foundational roles (currently exposed as `SystemRoles`) — registered first so domain partitions cannot shadow them."
+    "description": "Logical grouping of roles by the service area that owns them. One domain may declare roles applicable to multiple scopes (e.g. the `content` domain owns roles applicable to both `document` and `collection` scopes, while `agent_runs` owns the `agent_run` scope). The `system` domain owns the built-in foundational roles (currently exposed as `SystemRoles`) — registered first so domain partitions cannot shadow them."
   },
   "RoleDefinitionArray": {
     "type": "array",
@@ -2970,6 +3005,14 @@
           "max"
         ]
       },
+      "thinking_mode": {
+        "type": "string",
+        "enum": [
+          "adaptive",
+          "between_tools"
+        ],
+        "description": "Thinking mode override. Sonnet 5.5 supports between_tools at low, medium, or high effort. It omits display and budget fields; keep effort fixed during the conversation. When unset, existing model-specific thinking behavior is preserved."
+      },
       "thinking_budget_tokens": {
         "type": "number"
       },
@@ -3486,6 +3529,14 @@
       "top_k": {
         "type": "number"
       },
+      "thinking_mode": {
+        "type": "string",
+        "enum": [
+          "adaptive",
+          "between_tools"
+        ],
+        "description": "Thinking mode override. Sonnet 5.5 supports between_tools at low, medium, or high effort. It omits display and budget fields; keep effort fixed during the conversation. When unset, existing model-specific thinking behavior is preserved."
+      },
       "thinking_budget_tokens": {
         "type": "number"
       },
@@ -3766,6 +3817,14 @@
           "max"
         ]
       },
+      "thinking_mode": {
+        "type": "string",
+        "enum": [
+          "adaptive",
+          "between_tools"
+        ],
+        "description": "Thinking mode override. Sonnet 5.5 supports between_tools at low, medium, or high effort. It omits display and budget fields; keep effort fixed during the conversation. When unset, existing model-specific thinking behavior is preserved."
+      },
       "thinking_budget_tokens": {
         "type": "number"
       },
@@ -3792,6 +3851,9 @@
         "type": "string",
         "const": "openai-thinking"
       },
+      "image_generation": {
+        "$ref": "#/components/schemas/OpenAiImageGenerationOptions"
+      },
       "max_tokens": {
         "type": "number"
       },
@@ -3816,6 +3878,14 @@
       "reasoning_effort": {
         "$ref": "#/components/schemas/ReasoningEffort"
       },
+      "reasoning_context": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "current_turn",
+          "all_turns"
+        ]
+      },
       "image_detail": {
         "type": "string",
         "enum": [
@@ -3840,6 +3910,96 @@
     },
     "additionalProperties": false
   },
+  "OpenAiImageGenerationOptions": {
+    "type": "object",
+    "properties": {
+      "model": {
+        "type": "string"
+      },
+      "force": {
+        "type": "boolean"
+      },
+      "action": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "generate",
+          "edit"
+        ]
+      },
+      "size": {
+        "type": "string"
+      },
+      "quality": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "low",
+          "medium",
+          "high",
+          "xhigh",
+          "max"
+        ]
+      },
+      "background": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "opaque",
+          "transparent"
+        ]
+      },
+      "output_format": {
+        "type": "string",
+        "enum": [
+          "png",
+          "jpeg",
+          "webp"
+        ]
+      },
+      "output_compression": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 100
+      },
+      "moderation": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "low"
+        ]
+      },
+      "input_fidelity": {
+        "type": "string",
+        "enum": [
+          "low",
+          "high"
+        ]
+      },
+      "partial_images": {
+        "type": "number"
+      },
+      "input_image_mask": {
+        "$ref": "#/components/schemas/OpenAiImageGenerationMask"
+      }
+    },
+    "required": [
+      "model"
+    ],
+    "additionalProperties": false
+  },
+  "OpenAiImageGenerationMask": {
+    "type": "object",
+    "properties": {
+      "file_id": {
+        "type": "string"
+      },
+      "image_url": {
+        "type": "string"
+      }
+    },
+    "additionalProperties": false
+  },
   "ReasoningEffort": {
     "type": "string",
     "enum": [
@@ -3859,6 +4019,9 @@
         "type": "string",
         "const": "openai-text"
       },
+      "image_generation": {
+        "$ref": "#/components/schemas/OpenAiImageGenerationOptions"
+      },
       "max_tokens": {
         "type": "number"
       },
@@ -4096,13 +4259,13 @@
         "const": "openai-gpt-image"
       },
       "size": {
-        "type": "string",
-        "enum": [
-          "1024x1024",
-          "1024x1536",
-          "1536x1024",
-          "auto"
-        ]
+        "type": "string"
+      },
+      "width": {
+        "type": "number"
+      },
+      "height": {
+        "type": "number"
       },
       "image_quality": {
         "type": "string",
@@ -4110,6 +4273,8 @@
           "low",
           "medium",
           "high",
+          "xhigh",
+          "max",
           "auto"
         ]
       },
@@ -4128,6 +4293,31 @@
           "webp",
           "jpeg"
         ]
+      },
+      "n": {
+        "type": "number"
+      },
+      "output_compression": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 100
+      },
+      "moderation": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "low"
+        ]
+      },
+      "input_fidelity": {
+        "type": "string",
+        "enum": [
+          "low",
+          "high"
+        ]
+      },
+      "partial_images": {
+        "type": "number"
       }
     },
     "additionalProperties": false
@@ -4399,6 +4589,14 @@
           "max"
         ]
       },
+      "thinking_mode": {
+        "type": "string",
+        "enum": [
+          "adaptive",
+          "between_tools"
+        ],
+        "description": "Thinking mode override. Sonnet 5.5 supports between_tools at low, medium, or high effort. It omits display and budget fields; keep effort fixed during the conversation. When unset, existing model-specific thinking behavior is preserved."
+      },
       "thinking_budget_tokens": {
         "type": "number"
       },
@@ -4414,6 +4612,13 @@
           "5m",
           "1h"
         ]
+      },
+      "speed": {
+        "type": "string",
+        "enum": [
+          "standard",
+          "fast"
+        ]
       }
     },
     "additionalProperties": false
@@ -4570,6 +4775,21 @@
       "id": {
         "type": "string"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Select a project inference profile. Null bypasses profile defaults."
+      },
+      "inherit_model_config": {
+        "type": "boolean",
+        "description": "Treat the supplied environment, model and inference_profile as the caller's settings, inherited as a fallback: the interaction's bound or attached profile, or its own model, replaces them."
+      },
       "environment": {
         "type": "string"
       },
@@ -4613,6 +4833,11 @@
     },
     "additionalProperties": false
   },
+  "InferenceProfileId": {
+    "type": "string",
+    "pattern": "^[a-fA-F0-9]{24}$",
+    "description": "MongoDB ObjectId of the inference profile."
+  },
   "RunDataStorageLevel": {
     "type": "string",
     "enum": [
@@ -5116,12 +5341,68 @@
     },
     "additionalProperties": false
   },
+  "ProjectInferenceProfiles": {
+    "type": "object",
+    "properties": {
+      "default_profile": {
+        "$ref": "#/components/schemas/InferenceProfileId"
+      },
+      "modality": {
+        "type": "object",
+        "properties": {
+          "image": {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          "video": {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          }
+        },
+        "additionalProperties": false
+      },
+      "system": {
+        "type": "object",
+        "properties": {
+          "content_type": {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          "intake": {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          "analysis": {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          "agent": {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          "non_applicable": {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "additionalProperties": false,
+    "description": "Project defaults reference profile MongoDB IDs. Profile definitions are managed through the inference profiles API."
+  },
   "AgentProjectConfiguration": {
     "type": "object",
     "properties": {
+      "evaluation_policy": {
+        "type": "string",
+        "enum": [
+          "disabled",
+          "opt_in",
+          "always_on"
+        ],
+        "description": "LLM evaluation policy. Defaults to always_on when omitted. disabled prevents evaluation even when requested; opt_in requires evaluate=true on the run; always_on evaluates every eligible run without sampling. Deterministic diagnostics are unaffected."
+      },
       "checkpoint": {
         "$ref": "#/components/schemas/AgentCheckpointConfiguration",
         "description": "Conversation checkpoint (context compaction) tuning."
+      },
+      "budget": {
+        "$ref": "#/components/schemas/AgentBudgetConfiguration",
+        "description": "Default token budget for agent runs in this project. Field-wise overridden by the interaction's `agent_runner_options.budget` and the per-run `budget`."
       }
     },
     "additionalProperties": false,
@@ -5141,6 +5422,61 @@
     },
     "additionalProperties": false
   },
+  "AgentBudgetConfiguration": {
+    "type": "object",
+    "properties": {
+      "mode": {
+        "type": "string",
+        "enum": [
+          "token",
+          "dollar"
+        ],
+        "description": "Run budget mode. An omitted mode preserves weighted-token budgeting."
+      },
+      "limit_usd": {
+        "type": "number",
+        "exclusiveMinimum": 0,
+        "maximum": 9007199.25474099,
+        "description": "Soft USD allowance for priced model calls; dollar mode also requires limit_tokens for unpriced calls."
+      },
+      "reminder_at_remaining_fractions": {
+        "type": "array",
+        "items": {
+          "type": "number",
+          "exclusiveMinimum": 0,
+          "exclusiveMaximum": 1
+        }
+      },
+      "limit_tokens": {
+        "type": "number",
+        "description": "Weighted token budget shared by the run and every subagent workstream it launches. When the run and its workstreams together use this many weighted tokens, the agent gets one final turn without tools to summarize its work, and the run ends. This is a soft limit, not a spending cap: workstreams running concurrently and the final summary turns can go over it. Unset or <=0 means no budget."
+      },
+      "reminder_at_remaining_tokens": {
+        "type": "array",
+        "items": {
+          "type": "number"
+        },
+        "description": "Remaining-budget thresholds, in weighted tokens, at which the agent is told how much budget is left. Each threshold is delivered once per context window (again after a checkpoint). Values outside (0, limit_tokens) are ignored. Unset means reminders at 25% and 10% remaining."
+      },
+      "output_token_weight": {
+        "type": "number",
+        "minimum": 0,
+        "description": "Weight applied to output tokens, reasoning included, when charging the budget. Default 5."
+      },
+      "input_token_weight": {
+        "type": "number",
+        "minimum": 0,
+        "description": "Weight applied to input tokens not read from the prompt cache. Default 1."
+      },
+      "cached_input_token_weight": {
+        "type": "number",
+        "minimum": 0,
+        "description": "Weight applied to input tokens read from the prompt cache. Default 0.1, so a long conversation that mostly re-reads cached context is charged a tenth of the uncached rate for it."
+      }
+    },
+    "additionalProperties": false,
+    "description": "Weighted token budget for an agent run and its subagent workstreams. A call is charged output × output_token_weight + uncached input × input_token_weight + cached input × cached_input_token_weight."
+  },
   "ProjectConfiguration": {
     "type": "object",
     "properties": {
@@ -5154,7 +5490,12 @@
         "type": "string"
       },
       "defaults": {
-        "$ref": "#/components/schemas/ProjectModelDefaults"
+        "deprecated": true,
+        "$ref": "#/components/schemas/ProjectModelDefaults",
+        "description": "Legacy model defaults, replaced by inference profile assignments after migration."
+      },
+      "inference": {
+        "$ref": "#/components/schemas/ProjectInferenceProfiles"
       },
       "default_visibility": {
         "$ref": "#/components/schemas/ResourceVisibility"
@@ -5274,6 +5615,18 @@
           "type": "string"
         }
       },
+      "annotations": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Classification annotations"
+      },
+      "last_activity_at": {
+        "type": "string",
+        "format": "date-time",
+        "description": "When the project last saw activity. Not yet populated."
+      },
       "created_by": {
         "type": "string"
       },
@@ -5364,7 +5717,12 @@
         "type": "string"
       },
       "defaults": {
-        "$ref": "#/components/schemas/ProjectModelDefaults"
+        "deprecated": true,
+        "$ref": "#/components/schemas/ProjectModelDefaults",
+        "description": "Legacy model defaults, replaced by inference profile assignments after migration."
+      },
+      "inference": {
+        "$ref": "#/components/schemas/ProjectInferenceProfiles"
       },
       "default_visibility": {
         "$ref": "#/components/schemas/ResourceVisibility"
@@ -7425,9 +7783,6 @@
   "ExecutionEnvironmentSettings": {
     "type": "object",
     "properties": {
-      "bucket_access_principal": {
-        "type": "string"
-      },
       "default_headers": {
         "$ref": "#/components/schemas/StringValueMap",
         "description": "Custom HTTP headers sent by OpenAI-compatible environments."
@@ -8544,8 +8899,20 @@
         "type": "number",
         "description": "Number of input tokens written to prompt cache."
       },
+      "prompt_cache_write_1h": {
+        "type": "number",
+        "description": "Of `prompt_cache_write`, the tokens written with a one-hour cache lifetime, when the provider reports it. The remainder used the default (five-minute) lifetime."
+      },
       "prompt_new": {
         "type": "number"
+      },
+      "result_image": {
+        "type": "number",
+        "description": "Of `result`, the tokens of generated images, when the provider reports them. Image output is priced separately from text output."
+      },
+      "provider_cost_usd": {
+        "type": "number",
+        "description": "Amount the provider reported charging for this request, in USD, when the provider returns it (e.g. OpenRouter). Absent for bring-your-own-key requests."
       }
     },
     "additionalProperties": false
@@ -8600,6 +8967,380 @@
     ],
     "additionalProperties": false
   },
+  "UpdateInteractionConfigurationPayload": {
+    "type": "object",
+    "properties": {
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "budget": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/AgentBudgetConfiguration"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Project-scoped agent budget override. Null restores the code-defined or project default; omission preserves the saved budget."
+      }
+    },
+    "required": [
+      "inference_profile"
+    ],
+    "additionalProperties": false
+  },
+  "InteractionConfigurationRecord": {
+    "type": "object",
+    "properties": {
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "budget": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/AgentBudgetConfiguration"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Project-scoped agent budget override. Null restores the code-defined or project default; omission preserves the saved budget."
+      },
+      "id": {
+        "type": "string",
+        "pattern": "^[a-fA-F0-9]{24}$"
+      },
+      "project": {
+        "type": "string"
+      },
+      "interaction": {
+        "type": "string"
+      },
+      "created_at": {
+        "type": "string",
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+      },
+      "updated_at": {
+        "type": "string",
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+      }
+    },
+    "required": [
+      "inference_profile",
+      "id",
+      "project",
+      "interaction",
+      "created_at",
+      "updated_at"
+    ],
+    "additionalProperties": false
+  },
+  "InteractionConfigurationResult": {
+    "type": "object",
+    "properties": {
+      "configuration": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InteractionConfigurationRecord"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "configuration"
+    ],
+    "additionalProperties": false
+  },
+  "InferenceProfileName": {
+    "type": "string",
+    "minLength": 1,
+    "maxLength": 80,
+    "pattern": "\\S",
+    "description": "Editable display name, independent of the stable profile ID."
+  },
+  "CreateInferenceProfilePayload": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "$ref": "#/components/schemas/InferenceProfileName"
+      },
+      "description": {
+        "type": "string",
+        "maxLength": 1000
+      },
+      "environment": {
+        "type": "string",
+        "pattern": "^[a-fA-F0-9]{24}$"
+      },
+      "model": {
+        "type": "string",
+        "minLength": 1
+      },
+      "model_options": {
+        "$ref": "#/components/schemas/ModelOptions"
+      }
+    },
+    "required": [
+      "name",
+      "environment"
+    ],
+    "additionalProperties": false,
+    "description": "Create a profile in the current project. The server assigns its MongoDB ID."
+  },
+  "UpdateInferenceProfilePayload": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "$ref": "#/components/schemas/InferenceProfileName"
+      },
+      "description": {
+        "type": "string",
+        "maxLength": 1000
+      },
+      "environment": {
+        "type": "string",
+        "pattern": "^[a-fA-F0-9]{24}$"
+      },
+      "model": {
+        "type": "string",
+        "minLength": 1
+      },
+      "model_options": {
+        "$ref": "#/components/schemas/ModelOptions"
+      }
+    },
+    "required": [
+      "name",
+      "environment"
+    ],
+    "additionalProperties": false,
+    "description": "Replace editable profile fields, preserving its ID and references."
+  },
+  "InferenceProfileRecord": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "$ref": "#/components/schemas/InferenceProfileName"
+      },
+      "description": {
+        "type": "string",
+        "maxLength": 1000
+      },
+      "environment": {
+        "type": "string",
+        "pattern": "^[a-fA-F0-9]{24}$"
+      },
+      "model": {
+        "type": "string",
+        "minLength": 1
+      },
+      "model_options": {
+        "$ref": "#/components/schemas/ModelOptions"
+      },
+      "id": {
+        "type": "string",
+        "pattern": "^[a-fA-F0-9]{24}$"
+      },
+      "project": {
+        "type": "string"
+      },
+      "created_at": {
+        "type": "string",
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+      },
+      "updated_at": {
+        "type": "string",
+        "format": "date-time",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
+      }
+    },
+    "required": [
+      "name",
+      "environment",
+      "id",
+      "project",
+      "created_at",
+      "updated_at"
+    ],
+    "additionalProperties": false,
+    "description": "A project-scoped inference profile stored as a MongoDB document."
+  },
+  "InferenceProfileUsageEntry": {
+    "type": "object",
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "kind": {
+        "type": "string",
+        "enum": [
+          "stored",
+          "system",
+          "app"
+        ]
+      },
+      "version": {
+        "type": "number"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "id",
+      "name",
+      "kind"
+    ]
+  },
+  "InferenceProfileUsage": {
+    "type": "object",
+    "properties": {
+      "interactions": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/InferenceProfileUsageEntry"
+        }
+      },
+      "total": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "defaults": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Project default slots directly referencing this profile."
+      }
+    },
+    "required": [
+      "interactions",
+      "total",
+      "defaults"
+    ],
+    "description": "Persisted direct assignments; runtime overrides and inherited usage are not enumerated."
+  },
+  "InferenceProfileUsageQuery": {
+    "type": "object",
+    "properties": {
+      "search": {
+        "type": "string",
+        "maxLength": 200
+      },
+      "kind": {
+        "type": "string",
+        "enum": [
+          "stored",
+          "system",
+          "app"
+        ]
+      },
+      "offset": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "limit": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 100
+      }
+    }
+  },
+  "InferenceProfileRecordArray": {
+    "type": "array",
+    "items": {
+      "$ref": "#/components/schemas/InferenceProfileRecord"
+    }
+  },
+  "InferenceProfile": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "$ref": "#/components/schemas/InferenceProfileName",
+        "description": "Editable display name."
+      },
+      "description": {
+        "type": "string",
+        "maxLength": 1000
+      },
+      "environment": {
+        "type": "string",
+        "pattern": "^[a-fA-F0-9]{24}$"
+      },
+      "model": {
+        "type": "string",
+        "minLength": 1
+      },
+      "model_options": {
+        "$ref": "#/components/schemas/ModelOptions"
+      }
+    },
+    "required": [
+      "environment"
+    ],
+    "additionalProperties": false,
+    "description": "A reusable environment, model and inference parameter preset. Credentials remain in the environment."
+  },
+  "InferenceProfileSnapshot": {
+    "type": "object",
+    "properties": {
+      "id": {
+        "$ref": "#/components/schemas/InferenceProfileId"
+      },
+      "name": {
+        "$ref": "#/components/schemas/InferenceProfileName"
+      },
+      "revision": {
+        "type": "string"
+      },
+      "source": {
+        "type": "string",
+        "enum": [
+          "request",
+          "binding",
+          "interaction",
+          "project"
+        ]
+      },
+      "profile": {
+        "$ref": "#/components/schemas/InferenceProfile"
+      }
+    },
+    "required": [
+      "name",
+      "revision",
+      "source",
+      "profile"
+    ],
+    "additionalProperties": false,
+    "description": "The selected profile and content revision at execution creation. Effective overrides are recorded in the execution config."
+  },
   "InteractionStatus": {
     "type": "string",
     "enum": [
@@ -9205,6 +9946,10 @@
       "checkpoint": {
         "$ref": "#/components/schemas/AgentCheckpointConfiguration",
         "description": "Per-agent context checkpoint configuration. Field-wise it overrides the project's `configuration.agent.checkpoint`; a per-run `checkpoint_tokens` override still wins over both."
+      },
+      "budget": {
+        "$ref": "#/components/schemas/AgentBudgetConfiguration",
+        "description": "Per-agent token budget. Field-wise it overrides the project's `configuration.agent.budget`; the per-run `budget` wins over both."
       }
     },
     "additionalProperties": false,
@@ -9309,6 +10054,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "store_media_results": {
         "type": "boolean"
       },
@@ -9808,6 +10563,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "store_media_results": {
         "type": "boolean"
       },
@@ -9918,6 +10683,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "store_media_results": {
         "type": "boolean"
       },
@@ -10076,6 +10851,13 @@
       "model": {
         "type": "string"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileId"
+      },
+      "inherit_model_config": {
+        "type": "boolean",
+        "description": "Treat the supplied environment, model and inference_profile as the caller's settings, inherited as a fallback: the interaction's bound or attached profile, or its own model, replaces them."
+      },
       "hasImage": {
         "type": "boolean"
       },
@@ -10211,6 +10993,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "prompts": {
         "type": "array",
         "items": {
@@ -10304,6 +11096,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "prompts": {
         "type": "array",
         "items": {
@@ -10405,6 +11207,12 @@
       },
       "model_source": {
         "$ref": "#/components/schemas/ModelSource"
+      },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
+      "model_options": {
+        "$ref": "#/components/schemas/ModelOptions"
       }
     },
     "required": [
@@ -11479,6 +12287,10 @@
         "type": "number",
         "description": "Project-configured checkpoint hard cap in tokens (cached from project.configuration.agent_checkpoint_tokens at conversation start). The workflow resolves the effective threshold from these, the per-run checkpoint_tokens override, and the model-based default."
       },
+      "budget": {
+        "$ref": "#/components/schemas/AgentBudgetConfiguration",
+        "description": "Project-configured agent token budget (cached from project.configuration.agent.budget at conversation start). The workflow resolves the effective budget field-wise from this, the interaction's agent_runner_options.budget, and the per-run budget override."
+      },
       "user_channels": {
         "type": "array",
         "items": {
@@ -11870,6 +12682,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -12011,6 +12826,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -12790,6 +13608,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -12944,294 +13765,303 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
-      "error": {
-        "$ref": "#/components/schemas/InteractionExecutionError"
-      },
-      "source": {
-        "$ref": "#/components/schemas/RunSource"
-      },
-      "output_modality": {
-        "deprecated": true,
-        "x-deprecated-message": "This is deprecated. Use CompletionResult.type information instead.",
-        "$ref": "#/components/schemas/Modalities",
-        "description": "Deprecated: This is deprecated. Use CompletionResult.type information instead."
-      },
-      "created_by": {
-        "type": "string"
-      },
-      "updated_by": {
-        "type": "string"
-      },
-      "workflow": {
-        "$ref": "#/components/schemas/ExecutionRunWorkflow",
-        "description": "The Vertesia Workflow related to this Interaction Run.\n\nThis is only set when the interaction is executed as part of a workflow."
-      },
-      "account": {
-        "type": "string"
-      },
-      "project": {
-        "type": "string"
-      },
-      "interaction": {
-        "type": "string"
-      }
-    },
-    "additionalProperties": false,
-    "description": "A caller-selected subset of canonical stored run fields. Internal persistence fields are normalized at the API boundary."
-  },
-  "FindRunResultArray": {
-    "type": "array",
-    "items": {
-      "$ref": "#/components/schemas/FindRunResult"
-    }
-  },
-  "PopulatedExecutionRunResult": {
-    "type": "object",
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "parent": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "$ref": "#/components/schemas/ExecutionRun"
-          }
-        ],
-        "description": "Only used by runs that were created by a virtual run to point toward the virtual run parent"
-      },
-      "evaluation": {
-        "type": "object",
-        "properties": {
-          "score": {
-            "type": "number"
-          },
-          "selected": {
-            "type": "boolean"
-          },
-          "scores": {
-            "$ref": "#/components/schemas/NumberValueMap"
-          }
-        },
-        "additionalProperties": false
-      },
-      "result": {
-        "type": "array",
-        "items": {
-          "$ref": "#/components/schemas/CompletionResult"
-        }
-      },
-      "parameters": {
-        "type": "object",
-        "additionalProperties": true,
-        "description": "The parameters used to create the interaction. If the parameters contains the special property \"@memory\" it will be used to locate a memory pack and the other properties will be used as the memory pack mapping."
-      },
-      "tags": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        }
-      },
-      "environment": {
-        "$ref": "#/components/schemas/ExecutionEnvironmentRef",
-        "description": "Environment reference - populated with full object in API responses"
-      },
-      "modelId": {
-        "type": "string"
-      },
-      "result_schema": {
-        "$ref": "#/components/schemas/JSONSchema"
-      },
-      "ttl": {
-        "type": "number"
-      },
-      "status": {
-        "$ref": "#/components/schemas/ExecutionRunStatus"
-      },
-      "finish_reason": {
-        "type": "string"
-      },
-      "prompt": {},
-      "token_use": {
-        "$ref": "#/components/schemas/ExecutionTokenUsage"
-      },
-      "prompt_cache_diagnostics": {
-        "type": "array",
-        "items": {
-          "$ref": "#/components/schemas/PromptCacheDiagnostic"
-        }
-      },
-      "chunks": {
-        "type": "number"
-      },
-      "execution_time": {
-        "type": "number"
-      },
-      "created_at": {
-        "type": "string",
-        "format": "date-time"
-      },
-      "updated_at": {
-        "type": "string",
-        "format": "date-time"
-      },
-      "config": {
-        "$ref": "#/components/schemas/InteractionExecutionConfiguration"
-      },
-      "error": {
-        "$ref": "#/components/schemas/InteractionExecutionError"
-      },
-      "source": {
-        "$ref": "#/components/schemas/RunSource"
-      },
-      "output_modality": {
-        "deprecated": true,
-        "x-deprecated-message": "This is deprecated. Use CompletionResult.type information instead.",
-        "$ref": "#/components/schemas/Modalities",
-        "description": "Deprecated: This is deprecated. Use CompletionResult.type information instead."
-      },
-      "created_by": {
-        "type": "string"
-      },
-      "updated_by": {
-        "type": "string"
-      },
-      "workflow": {
-        "$ref": "#/components/schemas/ExecutionRunWorkflow",
-        "description": "The Vertesia Workflow related to this Interaction Run.\n\nThis is only set when the interaction is executed as part of a workflow."
-      },
-      "account": {
-        "type": "string"
-      },
-      "project": {
-        "type": "string"
-      },
-      "interaction": {
-        "$ref": "#/components/schemas/ExecutionRunInteraction"
-      },
-      "tool_use": {
-        "type": "array",
-        "items": {
-          "$ref": "#/components/schemas/ToolUse"
-        }
-      },
-      "conversation": {},
-      "options": {
-        "$ref": "#/components/schemas/StatelessExecutionOptions"
-      }
-    },
-    "required": [
-      "id",
-      "result",
-      "parameters",
-      "environment",
-      "ttl",
-      "status",
-      "created_at",
-      "updated_at",
-      "config",
-      "source",
-      "created_by",
-      "updated_by",
-      "account",
-      "project"
-    ],
-    "additionalProperties": false,
-    "description": "An execution run with its completion result and its interaction reference populated."
-  },
-  "LegacyExecutionRunResult": {
-    "type": "object",
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "parent": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "$ref": "#/components/schemas/ExecutionRun"
-          }
-        ],
-        "description": "Only used by runs that were created by a virtual run to point toward the virtual run parent"
-      },
-      "evaluation": {
-        "type": "object",
-        "properties": {
-          "score": {
-            "type": "number"
-          },
-          "selected": {
-            "type": "boolean"
-          },
-          "scores": {
-            "$ref": "#/components/schemas/NumberValueMap"
-          }
-        },
-        "additionalProperties": false
-      },
-      "result": {
-        "description": "The completion result collapsed to a single value: the parsed JSON object when the run produced one, the joined text otherwise. Superseded by the `result` array of the current API version."
-      },
-      "parameters": {
-        "type": "object",
-        "additionalProperties": true,
-        "description": "The parameters used to create the interaction. If the parameters contains the special property \"@memory\" it will be used to locate a memory pack and the other properties will be used as the memory pack mapping."
-      },
-      "tags": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        }
-      },
-      "environment": {
-        "$ref": "#/components/schemas/ExecutionEnvironmentRef",
-        "description": "Environment reference - populated with full object in API responses"
-      },
-      "modelId": {
-        "type": "string"
-      },
-      "result_schema": {
-        "$ref": "#/components/schemas/JSONSchema"
-      },
-      "ttl": {
-        "type": "number"
-      },
-      "status": {
-        "$ref": "#/components/schemas/ExecutionRunStatus"
-      },
-      "finish_reason": {
-        "type": "string"
-      },
-      "prompt": {},
-      "token_use": {
-        "$ref": "#/components/schemas/ExecutionTokenUsage"
-      },
-      "prompt_cache_diagnostics": {
-        "type": "array",
-        "items": {
-          "$ref": "#/components/schemas/PromptCacheDiagnostic"
-        }
-      },
-      "chunks": {
-        "type": "number"
-      },
-      "execution_time": {
-        "type": "number"
-      },
-      "created_at": {
-        "type": "string",
-        "format": "date-time"
-      },
-      "updated_at": {
-        "type": "string",
-        "format": "date-time"
-      },
-      "config": {
-        "$ref": "#/components/schemas/InteractionExecutionConfiguration"
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
+      "error": {
+        "$ref": "#/components/schemas/InteractionExecutionError"
+      },
+      "source": {
+        "$ref": "#/components/schemas/RunSource"
+      },
+      "output_modality": {
+        "deprecated": true,
+        "x-deprecated-message": "This is deprecated. Use CompletionResult.type information instead.",
+        "$ref": "#/components/schemas/Modalities",
+        "description": "Deprecated: This is deprecated. Use CompletionResult.type information instead."
+      },
+      "created_by": {
+        "type": "string"
+      },
+      "updated_by": {
+        "type": "string"
+      },
+      "workflow": {
+        "$ref": "#/components/schemas/ExecutionRunWorkflow",
+        "description": "The Vertesia Workflow related to this Interaction Run.\n\nThis is only set when the interaction is executed as part of a workflow."
+      },
+      "account": {
+        "type": "string"
+      },
+      "project": {
+        "type": "string"
+      },
+      "interaction": {
+        "type": "string"
+      }
+    },
+    "additionalProperties": false,
+    "description": "A caller-selected subset of canonical stored run fields. Internal persistence fields are normalized at the API boundary."
+  },
+  "FindRunResultArray": {
+    "type": "array",
+    "items": {
+      "$ref": "#/components/schemas/FindRunResult"
+    }
+  },
+  "PopulatedExecutionRunResult": {
+    "type": "object",
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "parent": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "$ref": "#/components/schemas/ExecutionRun"
+          }
+        ],
+        "description": "Only used by runs that were created by a virtual run to point toward the virtual run parent"
+      },
+      "evaluation": {
+        "type": "object",
+        "properties": {
+          "score": {
+            "type": "number"
+          },
+          "selected": {
+            "type": "boolean"
+          },
+          "scores": {
+            "$ref": "#/components/schemas/NumberValueMap"
+          }
+        },
+        "additionalProperties": false
+      },
+      "result": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/CompletionResult"
+        }
+      },
+      "parameters": {
+        "type": "object",
+        "additionalProperties": true,
+        "description": "The parameters used to create the interaction. If the parameters contains the special property \"@memory\" it will be used to locate a memory pack and the other properties will be used as the memory pack mapping."
+      },
+      "tags": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "environment": {
+        "$ref": "#/components/schemas/ExecutionEnvironmentRef",
+        "description": "Environment reference - populated with full object in API responses"
+      },
+      "modelId": {
+        "type": "string"
+      },
+      "result_schema": {
+        "$ref": "#/components/schemas/JSONSchema"
+      },
+      "ttl": {
+        "type": "number"
+      },
+      "status": {
+        "$ref": "#/components/schemas/ExecutionRunStatus"
+      },
+      "finish_reason": {
+        "type": "string"
+      },
+      "prompt": {},
+      "token_use": {
+        "$ref": "#/components/schemas/ExecutionTokenUsage"
+      },
+      "prompt_cache_diagnostics": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/PromptCacheDiagnostic"
+        }
+      },
+      "chunks": {
+        "type": "number"
+      },
+      "execution_time": {
+        "type": "number"
+      },
+      "created_at": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "updated_at": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "config": {
+        "$ref": "#/components/schemas/InteractionExecutionConfiguration"
+      },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
+      "error": {
+        "$ref": "#/components/schemas/InteractionExecutionError"
+      },
+      "source": {
+        "$ref": "#/components/schemas/RunSource"
+      },
+      "output_modality": {
+        "deprecated": true,
+        "x-deprecated-message": "This is deprecated. Use CompletionResult.type information instead.",
+        "$ref": "#/components/schemas/Modalities",
+        "description": "Deprecated: This is deprecated. Use CompletionResult.type information instead."
+      },
+      "created_by": {
+        "type": "string"
+      },
+      "updated_by": {
+        "type": "string"
+      },
+      "workflow": {
+        "$ref": "#/components/schemas/ExecutionRunWorkflow",
+        "description": "The Vertesia Workflow related to this Interaction Run.\n\nThis is only set when the interaction is executed as part of a workflow."
+      },
+      "account": {
+        "type": "string"
+      },
+      "project": {
+        "type": "string"
+      },
+      "interaction": {
+        "$ref": "#/components/schemas/ExecutionRunInteraction"
+      },
+      "tool_use": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/ToolUse"
+        }
+      },
+      "conversation": {},
+      "options": {
+        "$ref": "#/components/schemas/StatelessExecutionOptions"
+      }
+    },
+    "required": [
+      "id",
+      "result",
+      "parameters",
+      "environment",
+      "ttl",
+      "status",
+      "created_at",
+      "updated_at",
+      "config",
+      "source",
+      "created_by",
+      "updated_by",
+      "account",
+      "project"
+    ],
+    "additionalProperties": false,
+    "description": "An execution run with its completion result and its interaction reference populated."
+  },
+  "LegacyExecutionRunResult": {
+    "type": "object",
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "parent": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "$ref": "#/components/schemas/ExecutionRun"
+          }
+        ],
+        "description": "Only used by runs that were created by a virtual run to point toward the virtual run parent"
+      },
+      "evaluation": {
+        "type": "object",
+        "properties": {
+          "score": {
+            "type": "number"
+          },
+          "selected": {
+            "type": "boolean"
+          },
+          "scores": {
+            "$ref": "#/components/schemas/NumberValueMap"
+          }
+        },
+        "additionalProperties": false
+      },
+      "result": {
+        "description": "The completion result collapsed to a single value: the parsed JSON object when the run produced one, the joined text otherwise. Superseded by the `result` array of the current API version."
+      },
+      "parameters": {
+        "type": "object",
+        "additionalProperties": true,
+        "description": "The parameters used to create the interaction. If the parameters contains the special property \"@memory\" it will be used to locate a memory pack and the other properties will be used as the memory pack mapping."
+      },
+      "tags": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "environment": {
+        "$ref": "#/components/schemas/ExecutionEnvironmentRef",
+        "description": "Environment reference - populated with full object in API responses"
+      },
+      "modelId": {
+        "type": "string"
+      },
+      "result_schema": {
+        "$ref": "#/components/schemas/JSONSchema"
+      },
+      "ttl": {
+        "type": "number"
+      },
+      "status": {
+        "$ref": "#/components/schemas/ExecutionRunStatus"
+      },
+      "finish_reason": {
+        "type": "string"
+      },
+      "prompt": {},
+      "token_use": {
+        "$ref": "#/components/schemas/ExecutionTokenUsage"
+      },
+      "prompt_cache_diagnostics": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/PromptCacheDiagnostic"
+        }
+      },
+      "chunks": {
+        "type": "number"
+      },
+      "execution_time": {
+        "type": "number"
+      },
+      "created_at": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "updated_at": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "config": {
+        "$ref": "#/components/schemas/InteractionExecutionConfiguration"
+      },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
       },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
@@ -13386,6 +14216,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -13490,6 +14323,10 @@
         "type": "boolean",
         "description": "Whether to generate lessons automatically at completion. Defaults to true; conversation content remains searchable when disabled."
       },
+      "evaluate": {
+        "type": "boolean",
+        "description": "Request LLM evaluation when the project evaluation policy is opt_in. Defaults to false. Cannot override disabled or opt out of always_on."
+      },
       "app_version": {
         "type": "string",
         "description": "Immutable app-version target inherited by this conversation execution. The workflow applies it to app-owned resource resolution; callers normally set the x-vertesia-app-version header instead of populating this field directly."
@@ -13636,6 +14473,10 @@
         "$ref": "#/components/schemas/AgentCheckpointConfiguration",
         "description": "Structured per-run checkpoint override. Field-wise it takes precedence over the interaction's `agent_runner_options.checkpoint` and the project's `configuration.agent.checkpoint`. The legacy absolute `checkpoint_tokens` above still wins over everything when set."
       },
+      "budget": {
+        "$ref": "#/components/schemas/AgentBudgetConfiguration",
+        "description": "Per-run token budget override. Field-wise it takes precedence over the interaction's `agent_runner_options.budget` and the project's `configuration.agent.budget`. Subagent workstreams receive the remaining budget of their parent here."
+      },
       "strip_options": {
         "$ref": "#/components/schemas/ConversationStripOptions",
         "description": "Configuration for stripping large data (images, text) from conversation history to prevent JSON serialization issues and reduce storage bloat."
@@ -13661,6 +14502,10 @@
         "additionalProperties": true,
         "description": "Metadata inherited from parent workflow. Used to propagate context (e.g., apiKey, session info) to child workflows/workstreams. When a workstream is spawned, the parent's `data` is preserved here so that child tools can access it via metadata.parent_metadata."
       },
+      "final_verification": {
+        "type": "boolean",
+        "description": "When true, a non-interactive free-form run takes one extra turn after its answer to check that the task is complete. Off by default, and never applied to workstreams: their parent reviews the result and can message the workstream to continue."
+      },
       "non_blocking_subagents": {
         "type": "boolean",
         "description": "When true, subagent/workstream tool calls use fire-and-forget `startChild()` instead of blocking `executeChild()`. The parent continues reasoning while children run, receiving progress/completion via Temporal signals."
@@ -14021,6 +14866,19 @@
       "environment_id": {
         "type": "string"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "inherit_model_config": {
+        "type": "boolean"
+      },
       "model_id": {
         "type": "string"
       },
@@ -15263,26 +16121,53 @@
     "additionalProperties": false,
     "description": "Whether an API key is configured for an MCP tool collection"
   },
-  "AuditMeter": {
+  "AuditAdoptionActiveDays": {
     "type": "object",
     "properties": {
-      "category": {
-        "type": "string"
+      "days": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 367
       },
-      "type": {
-        "type": "string"
+      "users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "required": [
+      "days",
+      "users"
+    ],
+    "additionalProperties": false
+  },
+  "AuditAdoptionBucket": {
+    "type": "object",
+    "properties": {
+      "from": {
+        "type": "string",
+        "format": "date-time"
       },
-      "quantity": {
-        "type": "number"
+      "to": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "partial": {
+        "type": "boolean"
+      },
+      "active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
       }
     },
     "required": [
-      "category",
-      "type",
-      "quantity"
+      "from",
+      "to",
+      "partial",
+      "active_users"
     ],
-    "additionalProperties": false,
-    "description": "Generic metering entry attached to audit events. Used for cost attribution, usage tracking, and billing.\n\nExamples:   { category: \"tokens\", type: \"input\", quantity: 1234 }   { category: \"tokens\", type: \"output\", quantity: 567 }   { category: \"compute\", type: \"duration_ms\", quantity: 2100 }   { category: \"processing\", type: \"pages\", quantity: 12 }"
+    "additionalProperties": false
   },
   "KnownAuditAction": {
     "type": "string",
@@ -15300,6 +16185,8 @@
       "credentials_totp_generation",
       "publish",
       "unpublish",
+      "search",
+      "read",
       "inference",
       "embedding",
       "image_generation",
@@ -15317,6 +16204,492 @@
       "external"
     ]
   },
+  "AuditAction": {
+    "anyOf": [
+      {
+        "$ref": "#/components/schemas/KnownAuditAction"
+      },
+      {
+        "type": "string"
+      }
+    ]
+  },
+  "AuditAdoptionFilter": {
+    "type": "object",
+    "properties": {
+      "actions": {
+        "maxItems": 32,
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditAction"
+        }
+      },
+      "resourceTypes": {
+        "maxItems": 16,
+        "type": "array",
+        "items": {
+          "type": "string",
+          "maxLength": 128
+        }
+      },
+      "eventCategories": {
+        "maxItems": 6,
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/EventCategory"
+        }
+      }
+    },
+    "additionalProperties": false
+  },
+  "AuditAdoptionHistory": {
+    "type": "object",
+    "properties": {
+      "earliest_observed_at": {
+        "anyOf": [
+          {
+            "type": "string",
+            "format": "date-time"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "coverage_from": {
+        "anyOf": [
+          {
+            "type": "string",
+            "format": "date-time",
+            "description": "Authoritative complete-history boundary, if known. Earliest observation is not a coverage boundary."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "completeness": {
+        "type": "string",
+        "enum": [
+          "unknown",
+          "insufficient",
+          "verified"
+        ]
+      },
+      "retention_unavailable_reason": {
+        "anyOf": [
+          {
+            "type": "string",
+            "enum": [
+              "no_previous_users",
+              "insufficient_history"
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "earliest_observed_at",
+      "coverage_from",
+      "completeness",
+      "retention_unavailable_reason"
+    ],
+    "additionalProperties": false
+  },
+  "AuditAdoptionPeriod": {
+    "type": "object",
+    "properties": {
+      "from": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "to": {
+        "type": "string",
+        "format": "date-time"
+      }
+    },
+    "required": [
+      "from",
+      "to"
+    ],
+    "additionalProperties": false
+  },
+  "AuditAdoptionProject": {
+    "type": "object",
+    "properties": {
+      "project_id": {
+        "type": "string"
+      },
+      "project_name": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "active_user_days": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "required": [
+      "project_id",
+      "project_name",
+      "active_users",
+      "active_user_days"
+    ],
+    "additionalProperties": false
+  },
+  "AuditAdoptionQuery": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string"
+      },
+      "from": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Inclusive start; defaults to 30 days before to."
+      },
+      "to": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Exclusive end; defaults to now. Maximum duration: 366 days."
+      },
+      "filter": {
+        "$ref": "#/components/schemas/AuditAdoptionFilter"
+      }
+    },
+    "additionalProperties": false,
+    "description": "Productive direct authenticated user activity, including user OAuth/MCP calls. Scope is enforced by the server."
+  },
+  "AuditAdoptionResponse": {
+    "type": "object",
+    "properties": {
+      "period": {
+        "$ref": "#/components/schemas/AuditAdoptionPeriod"
+      },
+      "previous_period": {
+        "$ref": "#/components/schemas/AuditAdoptionPeriod"
+      },
+      "resolution": {
+        "type": "string",
+        "enum": [
+          "day",
+          "week"
+        ]
+      },
+      "active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "previous_active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "retained_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "observed_retention": {
+        "anyOf": [
+          {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "returning_user_share": {
+        "anyOf": [
+          {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "repeat_user_share": {
+        "anyOf": [
+          {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "median_active_days": {
+        "anyOf": [
+          {
+            "type": "number",
+            "minimum": 0
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "active_projects": {
+        "anyOf": [
+          {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "timeline": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditAdoptionBucket"
+        }
+      },
+      "active_day_distribution": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditAdoptionActiveDays"
+        }
+      },
+      "top_projects": {
+        "maxItems": 10,
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditAdoptionProject"
+        }
+      },
+      "history": {
+        "$ref": "#/components/schemas/AuditAdoptionHistory"
+      }
+    },
+    "required": [
+      "period",
+      "previous_period",
+      "resolution",
+      "active_users",
+      "previous_active_users",
+      "retained_users",
+      "observed_retention",
+      "returning_user_share",
+      "repeat_user_share",
+      "median_active_days",
+      "active_projects",
+      "timeline",
+      "active_day_distribution",
+      "top_projects",
+      "history"
+    ],
+    "additionalProperties": false,
+    "description": "Distinct user adoption sets over two equal-duration half-open periods. Ratios use available audit history, not guaranteed historical coverage. No user identities are returned."
+  },
+  "AuditUsageQuery": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "type": "string"
+      },
+      "from": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Inclusive start; defaults to 30 days before to."
+      },
+      "to": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Exclusive end; defaults to now. Maximum duration: 366 days."
+      },
+      "resolution": {
+        "type": "string",
+        "enum": [
+          "day",
+          "week",
+          "month"
+        ],
+        "description": "UTC calendar buckets. Weeks start Monday. Omitted: daily up to 200 dates, otherwise weekly."
+      }
+    },
+    "additionalProperties": false,
+    "description": "Usage trends for an authorized account or project over a half-open interval of at most 366 days."
+  },
+  "AuditUsageCounts": {
+    "type": "object",
+    "properties": {
+      "active_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "agent_runs": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991,
+        "description": "All audited run creations and marked restarts, including automated runs."
+      },
+      "user_agent_runs": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991,
+        "description": "Run operations initiated directly by authenticated users, including OAuth/MCP."
+      },
+      "automated_agent_runs": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991,
+        "description": "Other run operations, including schedules, delegated agents, services and API keys."
+      },
+      "agent_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991,
+        "description": "Distinct identifiable user initiators or owners of run operations, including scheduled and delegated runs."
+      },
+      "direct_calls": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "direct_call_users": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "content_objects": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "user_content_objects": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "other_content_objects": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "required": [
+      "active_users",
+      "agent_runs",
+      "user_agent_runs",
+      "automated_agent_runs",
+      "agent_users",
+      "direct_calls",
+      "direct_call_users",
+      "content_objects",
+      "user_content_objects",
+      "other_content_objects"
+    ],
+    "additionalProperties": false,
+    "description": "Direct productive users, run initiators/owners, all run operations and standalone inference audit events."
+  },
+  "AuditUsageBucket": {
+    "type": "object",
+    "properties": {
+      "from": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "to": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "partial": {
+        "type": "boolean"
+      },
+      "counts": {
+        "$ref": "#/components/schemas/AuditUsageCounts"
+      }
+    },
+    "required": [
+      "from",
+      "to",
+      "partial",
+      "counts"
+    ],
+    "additionalProperties": false
+  },
+  "AuditUsageResponse": {
+    "type": "object",
+    "properties": {
+      "period": {
+        "$ref": "#/components/schemas/AuditAdoptionPeriod"
+      },
+      "resolution": {
+        "type": "string",
+        "enum": [
+          "day",
+          "week",
+          "month"
+        ]
+      },
+      "totals": {
+        "$ref": "#/components/schemas/AuditUsageCounts"
+      },
+      "timeline": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AuditUsageBucket"
+        }
+      }
+    },
+    "required": [
+      "period",
+      "resolution",
+      "totals",
+      "timeline"
+    ],
+    "additionalProperties": false,
+    "description": "UTC usage trends. Period-wide distinct users are not sums of bucket populations. No user identities are returned."
+  },
+  "AuditMeter": {
+    "type": "object",
+    "properties": {
+      "category": {
+        "type": "string"
+      },
+      "type": {
+        "type": "string"
+      },
+      "quantity": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "category",
+      "type",
+      "quantity"
+    ],
+    "additionalProperties": false,
+    "description": "Generic metering entry attached to audit events. Used for cost attribution, usage tracking, and billing.\n\nExamples:   { category: \"tokens\", type: \"input\", quantity: 1234 }   { category: \"tokens\", type: \"output\", quantity: 567 }   { category: \"compute\", type: \"duration_ms\", quantity: 2100 }   { category: \"processing\", type: \"pages\", quantity: 12 }"
+  },
   "AuditAggregationDimensionMap": {
     "type": "object",
     "properties": {
@@ -15380,6 +16753,37 @@
           }
         ]
       },
+      "principal_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "actor_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "user_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Originating user identity, including delegated and scheduled activity with a recorded user owner. Non-user principals without a user origin are excluded."
+      },
       "details.pipeline": {
         "anyOf": [
           {
@@ -15437,7 +16841,10 @@
     "type": "string",
     "enum": [
       "resource_id",
-      "request_id"
+      "request_id",
+      "principal_id",
+      "actor_id",
+      "user_id"
     ]
   },
   "AuditAggregationOperation": {
@@ -15467,6 +16874,9 @@
       "event_category",
       "provider",
       "project_id",
+      "principal_id",
+      "actor_id",
+      "user_id",
       "details.pipeline",
       "details.verdict",
       "details.workflow_type",
@@ -15483,16 +16893,6 @@
       "rule_id"
     ]
   },
-  "AuditAction": {
-    "anyOf": [
-      {
-        "$ref": "#/components/schemas/KnownAuditAction"
-      },
-      {
-        "type": "string"
-      }
-    ]
-  },
   "AuditAggregationRow": {
     "type": "object",
     "properties": {
@@ -15819,6 +17219,13 @@
           "type": "string"
         }
       },
+      "principalTypes": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Restrict events to top-level actor categories such as user or apikey."
+      },
       "success": {
         "type": "boolean"
       },
@@ -16115,6 +17522,21 @@
       "id": {
         "type": "string"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Select a project inference profile. Null bypasses profile defaults."
+      },
+      "inherit_model_config": {
+        "type": "boolean",
+        "description": "Treat the supplied environment, model and inference_profile as the caller's settings, inherited as a fallback: the interaction's bound or attached profile, or its own model, replaces them."
+      },
       "environment": {
         "type": "string"
       },
@@ -18268,6 +19690,10 @@
       "build_version": {
         "type": "boolean",
         "description": "Create one immutable app version after validation. Defaults to false."
+      },
+      "budget": {
+        "$ref": "#/components/schemas/AgentBudgetConfiguration",
+        "description": "Token budget for the whole task, shared by the App Builder run and every step of its development process. Field-wise it overrides the project's `configuration.agent.budget`; `limit_tokens` <= 0 runs the task without a budget."
       }
     },
     "required": [
@@ -19860,240 +21286,6 @@
       }
     }
   },
-  "EventWebhookSigningSecretRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "project_id"
-    ],
-    "additionalProperties": false
-  },
-  "EventWebhookSigningSecretResponse": {
-    "type": "object",
-    "properties": {
-      "subscription_id": {
-        "type": "string"
-      },
-      "secret": {
-        "type": "string"
-      },
-      "secret_label": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "subscription_id",
-      "secret",
-      "secret_label"
-    ],
-    "additionalProperties": false
-  },
-  "SignEventWebhookRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      },
-      "delivery_id": {
-        "type": "string"
-      },
-      "body": {
-        "type": "string"
-      },
-      "event_id": {
-        "type": "string"
-      },
-      "event_category": {
-        "$ref": "#/components/schemas/EventCategory"
-      },
-      "action": {
-        "type": "string"
-      },
-      "timestamp": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "project_id",
-      "delivery_id",
-      "body",
-      "event_id",
-      "event_category",
-      "action"
-    ],
-    "additionalProperties": false
-  },
-  "SignEventWebhookResponse": {
-    "type": "object",
-    "properties": {
-      "headers": {
-        "type": "object",
-        "additionalProperties": {
-          "type": "string"
-        }
-      },
-      "timestamp": {
-        "type": "number"
-      },
-      "signature": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "headers",
-      "timestamp",
-      "signature"
-    ],
-    "additionalProperties": false
-  },
-  "EventIngestSigningSecretRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "project_id"
-    ],
-    "additionalProperties": false
-  },
-  "EventIngestSigningSecretResponse": {
-    "type": "object",
-    "properties": {
-      "channel_id": {
-        "type": "string"
-      },
-      "secret": {
-        "type": "string"
-      },
-      "secret_label": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "channel_id",
-      "secret",
-      "secret_label"
-    ],
-    "additionalProperties": false
-  },
-  "VerifyEventIngestSignatureRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      },
-      "body": {
-        "type": "string"
-      },
-      "signature_header": {
-        "type": "string"
-      },
-      "algorithm": {
-        "type": "string",
-        "enum": [
-          "sha256",
-          "sha1"
-        ]
-      },
-      "encoding": {
-        "type": "string",
-        "enum": [
-          "hex",
-          "base64"
-        ]
-      },
-      "prefix": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "project_id",
-      "body",
-      "signature_header"
-    ],
-    "additionalProperties": false
-  },
-  "VerifyEventIngestSignatureResponse": {
-    "type": "object",
-    "properties": {
-      "valid": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "valid"
-    ],
-    "additionalProperties": false
-  },
-  "GithubInstallationTokenRequest": {
-    "type": "object",
-    "properties": {
-      "account_id": {
-        "type": "string"
-      },
-      "project_id": {
-        "type": "string"
-      },
-      "installation_id": {
-        "type": "string"
-      },
-      "repo": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "project_id",
-      "installation_id",
-      "repo"
-    ],
-    "additionalProperties": false
-  },
-  "GithubInstallationTokenResponse": {
-    "type": "object",
-    "properties": {
-      "token": {
-        "type": "string"
-      },
-      "expires_at": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "token"
-    ],
-    "additionalProperties": false
-  },
-  "InternalSecretDeleteResponse": {
-    "type": "object",
-    "properties": {
-      "deleted": {
-        "type": "boolean",
-        "const": true
-      }
-    },
-    "required": [
-      "deleted"
-    ],
-    "additionalProperties": false
-  },
   "SupportedIntegrations_ask_user_webhook": {
     "type": "string",
     "const": "ask_user_webhook"
@@ -27650,6 +28842,10 @@
         },
         "description": "Compartments — set directly or inherited from collections (union across collections)."
       },
+      "shared_root": {
+        "type": "boolean",
+        "description": "Explicitly share this document as a root of the project shared space (readable by non-members via matching shared-content ABAC rules). This is the explicit API share flag — the sync never sets it."
+      },
       "inherited_properties": {
         "type": "array",
         "items": {
@@ -27796,6 +28992,10 @@
         },
         "description": "Compartments — set directly or inherited from collections (union across collections)."
       },
+      "shared_root": {
+        "type": "boolean",
+        "description": "Explicitly share this document as a root of the project shared space (readable by non-members via matching shared-content ABAC rules). This is the explicit API share flag — the sync never sets it."
+      },
       "inherited_properties": {
         "type": "array",
         "items": {
@@ -28094,6 +29294,14 @@
         },
         "description": "Compartments — set directly or inherited from collections (union across collections)."
       },
+      "shared": {
+        "type": "boolean",
+        "description": "Effective shared state: true iff the document is a member of an effectively-shared collection (inherited; sync-managed). Combine with shared_root for full readability."
+      },
+      "shared_root": {
+        "type": "boolean",
+        "description": "True iff the document was explicitly shared via the API (a root of the project shared space). Never set by the sync."
+      },
       "inherited_properties": {
         "type": "array",
         "items": {
@@ -28259,8 +29467,189 @@
       "sensitivity": {
         "anyOf": [
           {
-            "type": "number",
-            "description": "BLP sensitivity level — set directly or inherited from collections (max across collections)."
+            "type": "number",
+            "description": "BLP sensitivity level — set directly or inherited from collections (max across collections)."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "compartments": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Compartments — set directly or inherited from collections (union across collections)."
+      },
+      "shared": {
+        "type": "boolean",
+        "description": "Effective shared state: true iff the document is a member of an effectively-shared collection (inherited; sync-managed). Combine with shared_root for full readability."
+      },
+      "shared_root": {
+        "type": "boolean",
+        "description": "True iff the document was explicitly shared via the API (a root of the project shared space). Never set by the sync."
+      },
+      "inherited_properties": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/InheritedPropertyMetadata"
+        }
+      }
+    },
+    "additionalProperties": false
+  },
+  "ProjectedContentObjectApiResponseArray": {
+    "type": "array",
+    "items": {
+      "$ref": "#/components/schemas/ProjectedContentObjectApiResponse"
+    }
+  },
+  "ContentObjectItemApiResponse": {
+    "type": "object",
+    "properties": {
+      "id": {
+        "type": "string",
+        "description": "Unique identifier for the object"
+      },
+      "name": {
+        "type": "string",
+        "description": "Human-readable name or title"
+      },
+      "description": {
+        "type": "string",
+        "description": "Optional detailed description of the object"
+      },
+      "tags": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Optional array of categorization tags"
+      },
+      "updated_by": {
+        "type": "string",
+        "description": "Identifier of the user who last modified the object"
+      },
+      "created_by": {
+        "type": "string",
+        "description": "Identifier of the user who created the object"
+      },
+      "created_at": {
+        "type": "string",
+        "description": "ISO timestamp of when the object was created"
+      },
+      "updated_at": {
+        "type": "string",
+        "description": "ISO timestamp of when the object was last updated"
+      },
+      "parent": {
+        "type": "string"
+      },
+      "location": {
+        "type": "string"
+      },
+      "status": {
+        "$ref": "#/components/schemas/ContentObjectStatus"
+      },
+      "type": {
+        "$ref": "#/components/schemas/ContentObjectApiTypeRef"
+      },
+      "content": {
+        "$ref": "#/components/schemas/ContentSource"
+      },
+      "external_id": {
+        "type": "string"
+      },
+      "properties": {
+        "$ref": "#/components/schemas/JSONObject"
+      },
+      "metadata": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "tokens": {
+        "type": "object",
+        "properties": {
+          "count": {
+            "type": "number"
+          },
+          "encoding": {
+            "type": "string"
+          },
+          "etag": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      },
+      "revision": {
+        "$ref": "#/components/schemas/ContentObjectApiRevision"
+      },
+      "is_deleted": {
+        "type": "boolean"
+      },
+      "is_locked": {
+        "type": "boolean"
+      },
+      "score": {
+        "type": "number"
+      },
+      "user_permissions": {
+        "$ref": "#/components/schemas/ContentObjectUserPermissions"
+      },
+      "searchTypeResult": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "type": {
+              "type": "string"
+            },
+            "score": {
+              "type": "number"
+            },
+            "rank": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "type",
+            "score",
+            "rank"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "text": {
+        "type": "string"
+      },
+      "text_etag": {
+        "type": "string"
+      },
+      "embeddings": {
+        "$ref": "#/components/schemas/EmbeddingMap"
+      },
+      "parts": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      },
+      "parts_etag": {
+        "type": "string"
+      },
+      "transcript": {
+        "type": "object",
+        "additionalProperties": true
+      },
+      "security": {
+        "$ref": "#/components/schemas/StringArrayMap"
+      },
+      "sensitivity": {
+        "anyOf": [
+          {
+            "type": "number"
           },
           {
             "type": "null"
@@ -28271,181 +29660,14 @@
         "type": "array",
         "items": {
           "type": "string"
-        },
-        "description": "Compartments — set directly or inherited from collections (union across collections)."
-      },
-      "inherited_properties": {
-        "type": "array",
-        "items": {
-          "$ref": "#/components/schemas/InheritedPropertyMetadata"
         }
-      }
-    },
-    "additionalProperties": false
-  },
-  "ProjectedContentObjectApiResponseArray": {
-    "type": "array",
-    "items": {
-      "$ref": "#/components/schemas/ProjectedContentObjectApiResponse"
-    }
-  },
-  "ContentObjectItemApiResponse": {
-    "type": "object",
-    "properties": {
-      "id": {
-        "type": "string",
-        "description": "Unique identifier for the object"
-      },
-      "name": {
-        "type": "string",
-        "description": "Human-readable name or title"
-      },
-      "description": {
-        "type": "string",
-        "description": "Optional detailed description of the object"
       },
-      "tags": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "description": "Optional array of categorization tags"
-      },
-      "updated_by": {
-        "type": "string",
-        "description": "Identifier of the user who last modified the object"
-      },
-      "created_by": {
-        "type": "string",
-        "description": "Identifier of the user who created the object"
-      },
-      "created_at": {
-        "type": "string",
-        "description": "ISO timestamp of when the object was created"
-      },
-      "updated_at": {
-        "type": "string",
-        "description": "ISO timestamp of when the object was last updated"
-      },
-      "parent": {
-        "type": "string"
-      },
-      "location": {
-        "type": "string"
-      },
-      "status": {
-        "$ref": "#/components/schemas/ContentObjectStatus"
-      },
-      "type": {
-        "$ref": "#/components/schemas/ContentObjectApiTypeRef"
-      },
-      "content": {
-        "$ref": "#/components/schemas/ContentSource"
-      },
-      "external_id": {
-        "type": "string"
-      },
-      "properties": {
-        "$ref": "#/components/schemas/JSONObject"
-      },
-      "metadata": {
-        "type": "object",
-        "additionalProperties": true
-      },
-      "tokens": {
-        "type": "object",
-        "properties": {
-          "count": {
-            "type": "number"
-          },
-          "encoding": {
-            "type": "string"
-          },
-          "etag": {
-            "type": "string"
-          }
-        },
-        "additionalProperties": false
-      },
-      "revision": {
-        "$ref": "#/components/schemas/ContentObjectApiRevision"
-      },
-      "is_deleted": {
+      "shared": {
         "type": "boolean"
       },
-      "is_locked": {
+      "shared_root": {
         "type": "boolean"
       },
-      "score": {
-        "type": "number"
-      },
-      "user_permissions": {
-        "$ref": "#/components/schemas/ContentObjectUserPermissions"
-      },
-      "searchTypeResult": {
-        "type": "array",
-        "items": {
-          "type": "object",
-          "properties": {
-            "type": {
-              "type": "string"
-            },
-            "score": {
-              "type": "number"
-            },
-            "rank": {
-              "type": "number"
-            }
-          },
-          "required": [
-            "type",
-            "score",
-            "rank"
-          ],
-          "additionalProperties": false
-        }
-      },
-      "text": {
-        "type": "string"
-      },
-      "text_etag": {
-        "type": "string"
-      },
-      "embeddings": {
-        "$ref": "#/components/schemas/EmbeddingMap"
-      },
-      "parts": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        }
-      },
-      "parts_etag": {
-        "type": "string"
-      },
-      "transcript": {
-        "type": "object",
-        "additionalProperties": true
-      },
-      "security": {
-        "$ref": "#/components/schemas/StringArrayMap"
-      },
-      "sensitivity": {
-        "anyOf": [
-          {
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "compartments": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        }
-      },
       "inherited_properties": {
         "type": "array",
         "items": {
@@ -30685,6 +31907,17 @@
   "ProcessRunConfig": {
     "type": "object",
     "properties": {
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Run-level inference profile ID for process LLM nodes and the supervisor. Explicit model settings retain precedence."
+      },
       "environment": {
         "type": "string",
         "description": "Execution environment id used by Process LLM nodes and the supervisor."
@@ -30700,6 +31933,10 @@
         "type": "string",
         "description": "Free-form message from the user when starting a run. Passed to the orchestrator LLM in supervised mode; stored on the run regardless so programmatic runs retain the intent that triggered them."
       },
+      "budget": {
+        "$ref": "#/components/schemas/AgentBudgetConfiguration",
+        "description": "Token budget shared by the whole run: agent nodes, interaction nodes, nested processes and, when the run is managed by an agent run, that agent run. Agent nodes and nested processes start with what is left of it. When it runs out the process stops scheduling nodes and lets running agent nodes write a final summary. A run managed by an interactive agent run then pauses (`budget.awaiting_allocation`) until more budget is added through that agent run, and retries the interrupted node; any other run ends failed with `terminal_reason` `token_budget_exhausted`. This is a soft limit, not a spending cap."
+      },
       "process_workstream_monitor": {
         "type": "object",
         "properties": {
@@ -30851,6 +32088,120 @@
     },
     "additionalProperties": false
   },
+  "ProcessTerminalReason": {
+    "type": "string",
+    "enum": [
+      "token_budget_exhausted"
+    ],
+    "description": "Why a process run ended other than by reaching a final node. `token_budget_exhausted`: the run spent its token budget; it ends with status `failed`."
+  },
+  "ProcessBudgetSummary": {
+    "type": "object",
+    "properties": {
+      "node_id": {
+        "type": "string"
+      },
+      "attempt": {
+        "type": "number"
+      },
+      "status": {
+        "type": "string",
+        "enum": [
+          "token_budget_exhausted",
+          "cancelled_at_deadline"
+        ],
+        "description": "`token_budget_exhausted`: the node ended with a final summary turn. `cancelled_at_deadline`: the node was still running at the wrap-up deadline and was cancelled without a summary."
+      },
+      "summary": {
+        "type": "string",
+        "description": "The node's final summary, truncated to 2,000 characters."
+      },
+      "summary_truncated": {
+        "type": "boolean"
+      },
+      "artifact": {
+        "type": "string",
+        "description": "Path of the node's conversation among the process run's artifacts, which holds the full summary."
+      },
+      "child_run_id": {
+        "type": "string"
+      },
+      "usage_incomplete": {
+        "type": "boolean",
+        "description": "True when the node's final token usage never arrived; the run total counts its last reported usage."
+      }
+    },
+    "required": [
+      "node_id",
+      "attempt",
+      "status"
+    ],
+    "additionalProperties": false
+  },
+  "ProcessBudgetState": {
+    "type": "object",
+    "properties": {
+      "mode": {
+        "type": "string",
+        "enum": [
+          "token",
+          "dollar"
+        ],
+        "description": "Absent on historical token-only status."
+      },
+      "limit_usd": {
+        "type": "number",
+        "minimum": 0
+      },
+      "reported_usd": {
+        "type": "number",
+        "minimum": 0
+      },
+      "estimated_usd": {
+        "type": "number",
+        "minimum": 0
+      },
+      "accounting_status": {
+        "type": "string",
+        "enum": [
+          "current",
+          "incomplete"
+        ]
+      },
+      "unmeasured_calls": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "limit_tokens": {
+        "type": "number"
+      },
+      "used_units": {
+        "type": "number",
+        "description": "Weighted tokens used by the run and everything it launched."
+      },
+      "exhausted": {
+        "type": "boolean"
+      },
+      "awaiting_allocation": {
+        "type": "boolean",
+        "description": "True while the run is paused because its budget ran out, waiting for more budget. Only a run managed by an interactive agent run pauses; the run then shows status `running`."
+      },
+      "summaries": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/ProcessBudgetSummary"
+        },
+        "description": "One entry per node the budget stopped: at most the latest attempt, 50 entries."
+      }
+    },
+    "required": [
+      "limit_tokens",
+      "used_units",
+      "exhausted"
+    ],
+    "additionalProperties": false
+  },
   "ProcessState": {
     "type": "object",
     "properties": {
@@ -30872,6 +32223,13 @@
       },
       "sequence": {
         "type": "number"
+      },
+      "terminal_reason": {
+        "$ref": "#/components/schemas/ProcessTerminalReason"
+      },
+      "budget": {
+        "$ref": "#/components/schemas/ProcessBudgetState",
+        "description": "Run budget status, including dollar consumption when configured."
       }
     },
     "required": [
@@ -32626,6 +33984,10 @@
         },
         "description": "Compartments for member documents"
       },
+      "shared_root": {
+        "type": "boolean",
+        "description": "Explicitly share this collection as a root of the project shared space (listable/readable by non-members via matching shared-content ABAC rules). This is the explicit API share flag — the sync never sets it."
+      },
       "name": {
         "type": "string",
         "description": "Name of the collection"
@@ -32722,6 +34084,10 @@
         },
         "description": "Compartments for member documents"
       },
+      "shared_root": {
+        "type": "boolean",
+        "description": "Explicitly share this collection as a root of the project shared space (listable/readable by non-members via matching shared-content ABAC rules). This is the explicit API share flag — the sync never sets it."
+      },
       "name": {
         "type": "string",
         "description": "Name of the collection"
@@ -32871,12 +34237,24 @@
         },
         "description": "Compartments — propagated to member documents (union across collections)"
       },
+      "shared": {
+        "type": "boolean",
+        "description": "Effective shared state: true iff the collection is a member of an effectively-shared parent collection (inherited; sync-managed). Combine with shared_root for full readability."
+      },
+      "shared_root": {
+        "type": "boolean",
+        "description": "True iff the collection was explicitly shared via the API (a root of the project shared space). Never set by the sync."
+      },
       "shared_properties": {
         "type": "array",
         "items": {
           "type": "string"
         },
         "description": "List of property names from the collection's properties that should be shared with (injected into) member objects. These properties will be propagated to all members of this collection and merged as arrays."
+      },
+      "user_permissions": {
+        "$ref": "#/components/schemas/ContentObjectUserPermissions",
+        "description": "Computed per-request permissions for the current user on this collection. Not stored — computed on the fly from the collection's security field (same semantics as a content object's user_permissions)."
       }
     },
     "required": [
@@ -33153,6 +34531,41 @@
     "additionalProperties": false,
     "description": "Response from signaling an agent workflow."
   },
+  "AllocateAgentRunBudgetPayload": {
+    "anyOf": [
+      {
+        "type": "object",
+        "properties": {
+          "additional_tokens": {
+            "type": "integer",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "description": "Weighted tokens to add to the run allowance."
+          }
+        },
+        "required": [
+          "additional_tokens"
+        ],
+        "additionalProperties": false
+      },
+      {
+        "type": "object",
+        "properties": {
+          "additional_usd": {
+            "type": "number",
+            "exclusiveMinimum": 0,
+            "maximum": 9007199.25474099,
+            "description": "USD to add to the dollar allowance."
+          }
+        },
+        "required": [
+          "additional_usd"
+        ],
+        "additionalProperties": false
+      }
+    ],
+    "description": "Add exactly one allowance: weighted tokens or USD."
+  },
   "AgentRunEvaluationRollup": {
     "type": "object",
     "properties": {
@@ -33394,7 +34807,7 @@
     ],
     "description": "Why the run was rated the way it was."
   },
-  "AgentRunJudgeResult": {
+  "AgentRunLlmEvaluationResult": {
     "type": "object",
     "properties": {
       "rev": {
@@ -33403,7 +34816,7 @@
         "maximum": 9007199254740991
       },
       "gate": {
-        "$ref": "#/components/schemas/JudgeGateReason"
+        "$ref": "#/components/schemas/EvaluationGateReason"
       },
       "sample_rate": {
         "type": "number"
@@ -33412,10 +34825,10 @@
         "type": "number"
       },
       "outcome": {
-        "$ref": "#/components/schemas/JudgeOutcome"
+        "$ref": "#/components/schemas/EvaluationOutcome"
       },
       "verdict": {
-        "$ref": "#/components/schemas/JudgeVerdict"
+        "$ref": "#/components/schemas/EvaluationVerdict"
       },
       "score": {
         "type": "number"
@@ -33426,7 +34839,7 @@
       "prompt_version": {
         "type": "string"
       },
-      "turns_judged": {
+      "turns_evaluated": {
         "type": "array",
         "items": {
           "type": "integer",
@@ -33434,7 +34847,7 @@
           "maximum": 9007199254740991
         }
       },
-      "judged_at": {
+      "evaluated_at": {
         "type": "string",
         "format": "date-time"
       }
@@ -33446,42 +34859,44 @@
       "selected_probability",
       "outcome",
       "prompt_version",
-      "judged_at"
+      "evaluated_at"
     ],
     "additionalProperties": false,
-    "description": "Latest judge result for a run."
+    "description": "Latest LLM evaluation result for a run."
   },
-  "JudgeGateReason": {
+  "EvaluationGateReason": {
     "type": "string",
     "enum": [
       "signal",
-      "sample"
+      "sample",
+      "opt_in",
+      "always_on"
     ],
-    "description": "Why the judge looked at a run."
+    "description": "Why a run was selected for LLM evaluation."
   },
-  "JudgeOutcome": {
+  "EvaluationOutcome": {
     "type": "string",
     "enum": [
-      "judged",
+      "evaluated",
       "skipped_unarchived",
       "failed"
     ],
-    "description": "What a judge run produced."
+    "description": "Outcome of an LLM evaluation run."
   },
-  "JudgeVerdict": {
+  "EvaluationVerdict": {
     "type": "string",
     "enum": [
       "success",
       "partial",
       "failure"
     ],
-    "description": "The judge's reading of a turn."
+    "description": "LLM evaluation verdict for a turn."
   },
   "AgentRunContradictionReason": {
     "type": "string",
     "enum": [
       "feedback_down_on_clean_run",
-      "judge_failure_on_clean_run"
+      "evaluation_failure_on_clean_run"
     ]
   },
   "AgentRunEvaluation": {
@@ -33499,8 +34914,8 @@
       "feedback_counts": {
         "$ref": "#/components/schemas/AgentRunFeedbackCounts"
       },
-      "judge": {
-        "$ref": "#/components/schemas/AgentRunJudgeResult"
+      "llm_evaluation": {
+        "$ref": "#/components/schemas/AgentRunLlmEvaluationResult"
       },
       "severity": {
         "$ref": "#/components/schemas/EvaluationSeverity"
@@ -33813,279 +35228,287 @@
         },
         "description": "Lessons learned from the conversation (extracted at completion)"
       },
-      "evaluation": {
-        "$ref": "#/components/schemas/AgentRunEvaluation",
-        "description": "Evaluation summary of the run."
-      },
-      "feedback": {
-        "type": "array",
-        "items": {
-          "$ref": "#/components/schemas/AgentRunFeedbackEntry"
-        },
-        "description": "Retained user ratings on the run."
-      },
-      "archived_at": {
-        "type": "string",
-        "format": "date-time",
-        "description": "When the last successful archive completed"
-      },
-      "archive_version": {
-        "type": "number",
-        "description": "Archive format version (for forward compatibility)"
-      },
-      "last_archive_error": {
-        "type": "string",
-        "description": "Last archive error message (when archive_state === 'failed')"
-      },
-      "forked_from": {
-        "type": "string",
-        "description": "Source agent run ID when this run was forked (enables message history chaining)"
-      }
-    },
-    "required": [
-      "interaction",
-      "id",
-      "run_kind",
-      "run_type",
-      "account",
-      "project",
-      "status",
-      "started_by",
-      "started_at",
-      "created_at",
-      "updated_at",
-      "interactionRef"
-    ],
-    "additionalProperties": false,
-    "description": "AgentRun — the client-facing stable identity for a running or completed agent.\n\nAll operations use `id` as the sole identifier. Temporal workflow internals are never exposed to clients."
-  },
-  "AgentRun": {
-    "type": "object",
-    "properties": {
-      "interaction": {
-        "type": "string",
-        "description": "Interaction ID or code (e.g. \"sys:generic_question\")."
-      },
-      "data": {
-        "type": "object",
-        "additionalProperties": true,
-        "description": "Input parameters, typed per interaction"
-      },
-      "config": {
-        "$ref": "#/components/schemas/InteractionExecutionConfiguration",
-        "description": "Execution configuration (environment, model, model_options, etc.)"
-      },
-      "interactive": {
+      "evaluate": {
+        "type": "boolean",
+        "description": "Request LLM evaluation when the project evaluation policy is opt_in. Defaults to false. Cannot override disabled or opt out of always_on."
+      },
+      "evaluation": {
+        "$ref": "#/components/schemas/AgentRunEvaluation",
+        "description": "Evaluation summary of the run."
+      },
+      "feedback": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/AgentRunFeedbackEntry"
+        },
+        "description": "Retained user ratings on the run."
+      },
+      "archived_at": {
+        "type": "string",
+        "format": "date-time",
+        "description": "When the last successful archive completed"
+      },
+      "archive_version": {
+        "type": "number",
+        "description": "Archive format version (for forward compatibility)"
+      },
+      "last_archive_error": {
+        "type": "string",
+        "description": "Last archive error message (when archive_state === 'failed')"
+      },
+      "forked_from": {
+        "type": "string",
+        "description": "Source agent run ID when this run was forked (enables message history chaining)"
+      }
+    },
+    "required": [
+      "interaction",
+      "id",
+      "run_kind",
+      "run_type",
+      "account",
+      "project",
+      "status",
+      "started_by",
+      "started_at",
+      "created_at",
+      "updated_at",
+      "interactionRef"
+    ],
+    "additionalProperties": false,
+    "description": "AgentRun — the client-facing stable identity for a running or completed agent.\n\nAll operations use `id` as the sole identifier. Temporal workflow internals are never exposed to clients."
+  },
+  "AgentRun": {
+    "type": "object",
+    "properties": {
+      "interaction": {
+        "type": "string",
+        "description": "Interaction ID or code (e.g. \"sys:generic_question\")."
+      },
+      "data": {
+        "type": "object",
+        "additionalProperties": true,
+        "description": "Input parameters, typed per interaction"
+      },
+      "config": {
+        "$ref": "#/components/schemas/InteractionExecutionConfiguration",
+        "description": "Execution configuration (environment, model, model_options, etc.)"
+      },
+      "interactive": {
+        "type": "boolean",
+        "description": "Whether the agent accepts user input"
+      },
+      "tool_approval_mode": {
+        "$ref": "#/components/schemas/AgentToolApprovalMode",
+        "description": "How side-effecting tool actions are approved for interactive runs."
+      },
+      "tool_names": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Tools configured for this run (+/- syntax supported)"
+      },
+      "initial_skills": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Builtin system skills activated before the first model turn."
+      },
+      "initial_tool_calls": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/InitialToolCall"
+        },
+        "description": "Ordered, bounded hydration/read calls executed before the first model turn."
+      },
+      "excluded_tools": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Hard denylist of tool names: never exposed to the model, refused at execution time."
+      },
+      "collection_id": {
+        "type": "string",
+        "description": "Scoped collection (if any)"
+      },
+      "disabled_mcp_collections": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Denylist of MCP tool-collection ids deactivated for this run. `undefined`/empty means all installed/connected MCP collections are active (back-compat, and new servers stay active by default). Listed collections are excluded even if connected."
+      },
+      "content_type": {
+        "$ref": "#/components/schemas/ContentObjectTypeRef",
+        "description": "Content type linked to this run — defines the schema for `properties`"
+      },
+      "visibility": {
+        "$ref": "#/components/schemas/ConversationVisibility",
+        "description": "Conversation/process visibility"
+      },
+      "tags": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "User-defined or system tags for categorization"
+      },
+      "categories": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Categories for organizing runs"
+      },
+      "properties": {
+        "type": "object",
+        "additionalProperties": true,
+        "description": "Business metadata — typed by the linked content_type schema"
+      },
+      "source": {
+        "$ref": "#/components/schemas/RunSource",
+        "description": "How the run was started"
+      },
+      "schedule_id": {
+        "type": "string",
+        "description": "Schedule ID — set when this run was triggered by a Temporal schedule"
+      },
+      "source_type": {
+        "$ref": "#/components/schemas/AgentRunType",
+        "description": "Replacement for legacy AgentRun.type"
+      },
+      "type": {
+        "deprecated": true,
+        "x-deprecated-message": "Use source_type for creation source and run_type for runtime mode.",
+        "$ref": "#/components/schemas/AgentRunType",
+        "description": "Deprecated: Use source_type for creation source and run_type for runtime mode."
+      },
+      "id": {
+        "type": "string",
+        "description": "The stable identifier used by all client code"
+      },
+      "run_kind": {
+        "type": "string",
+        "const": "agent",
+        "description": "Internal discriminator key"
+      },
+      "parent_run_id": {
+        "type": "string",
+        "description": "Process run this agent belongs to — set when a process agent node recorded this run. Its conversation lives on the parent run under `workstream_id`."
+      },
+      "workstream_id": {
+        "type": "string",
+        "description": "Workstream this run occupies inside its parent run (the process node id)."
+      },
+      "run_type": {
+        "type": "string",
+        "const": "autonomous",
+        "description": "Public-facing runtime mode"
+      },
+      "account": {
+        "type": "string",
+        "description": "Account ID"
+      },
+      "project": {
+        "type": "string",
+        "description": "Project ID"
+      },
+      "workflow_id": {
+        "type": "string",
+        "description": "Temporal workflow ID (stable across continueAsNew)"
+      },
+      "first_workflow_run_id": {
+        "type": "string",
+        "description": "First Temporal workflow run ID (used for Redis channel and artifact resolution)"
+      },
+      "artifacts_path": {
+        "type": "string",
+        "description": "Artifact storage path for this run"
+      },
+      "status": {
+        "$ref": "#/components/schemas/AgentRunStatus",
+        "description": "Current status of the agent run"
+      },
+      "activity_state": {
+        "$ref": "#/components/schemas/ConversationActivityState",
+        "description": "Whether the agent is currently working or idle (waiting for user input)"
+      },
+      "started_by": {
+        "type": "string",
+        "description": "User or service that initiated the run"
+      },
+      "started_at": {
+        "type": "string",
+        "format": "date-time",
+        "description": "When the run started"
+      },
+      "completed_at": {
+        "type": "string",
+        "format": "date-time",
+        "description": "When the run completed (or failed/cancelled)"
+      },
+      "title": {
+        "type": "string",
+        "description": "Conversation title (short, human-readable)"
+      },
+      "event_subscription_id": {
+        "type": "string",
+        "description": "Event subscription ID — set when this run was triggered by the event bus."
+      },
+      "event_ref": {
+        "$ref": "#/components/schemas/EventRef",
+        "description": "Event reference — set when this run was triggered by the event bus."
+      },
+      "archive_state": {
+        "$ref": "#/components/schemas/AgentRunArchiveState",
+        "description": "Archive lifecycle state"
+      },
+      "created_at": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Timestamp when the document was created"
+      },
+      "updated_at": {
+        "type": "string",
+        "format": "date-time",
+        "description": "Timestamp when the document was last updated"
+      },
+      "interaction_name": {
+        "type": "string",
+        "description": "Human-readable interaction name"
+      },
+      "interactionRef": {
+        "$ref": "#/components/schemas/InteractionRef"
+      },
+      "environmentRef": {
+        "$ref": "#/components/schemas/ResourceRef",
+        "description": "Resolved environment reference (name resolved from `config.environment` id). Populated by the list endpoint; may be absent on other endpoints or when the id cannot be resolved, in which case consumers should fall back to `config.environment`."
+      },
+      "topic": {
+        "type": "string",
+        "description": "Conversation topic (longer description from topic analysis)"
+      },
+      "generate_topic": {
+        "type": "boolean",
+        "description": "Whether automatic conversation title/topic generation is enabled for this run."
+      },
+      "generate_lessons": {
+        "type": "boolean",
+        "description": "Whether automatic lessons generation is enabled for this run."
+      },
+      "lessons_learned": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Lessons learned from the conversation (extracted at completion)"
+      },
+      "evaluate": {
         "type": "boolean",
-        "description": "Whether the agent accepts user input"
-      },
-      "tool_approval_mode": {
-        "$ref": "#/components/schemas/AgentToolApprovalMode",
-        "description": "How side-effecting tool actions are approved for interactive runs."
-      },
-      "tool_names": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "description": "Tools configured for this run (+/- syntax supported)"
-      },
-      "initial_skills": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "description": "Builtin system skills activated before the first model turn."
-      },
-      "initial_tool_calls": {
-        "type": "array",
-        "items": {
-          "$ref": "#/components/schemas/InitialToolCall"
-        },
-        "description": "Ordered, bounded hydration/read calls executed before the first model turn."
-      },
-      "excluded_tools": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "description": "Hard denylist of tool names: never exposed to the model, refused at execution time."
-      },
-      "collection_id": {
-        "type": "string",
-        "description": "Scoped collection (if any)"
-      },
-      "disabled_mcp_collections": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "description": "Denylist of MCP tool-collection ids deactivated for this run. `undefined`/empty means all installed/connected MCP collections are active (back-compat, and new servers stay active by default). Listed collections are excluded even if connected."
-      },
-      "content_type": {
-        "$ref": "#/components/schemas/ContentObjectTypeRef",
-        "description": "Content type linked to this run — defines the schema for `properties`"
-      },
-      "visibility": {
-        "$ref": "#/components/schemas/ConversationVisibility",
-        "description": "Conversation/process visibility"
-      },
-      "tags": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "description": "User-defined or system tags for categorization"
-      },
-      "categories": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "description": "Categories for organizing runs"
-      },
-      "properties": {
-        "type": "object",
-        "additionalProperties": true,
-        "description": "Business metadata — typed by the linked content_type schema"
-      },
-      "source": {
-        "$ref": "#/components/schemas/RunSource",
-        "description": "How the run was started"
-      },
-      "schedule_id": {
-        "type": "string",
-        "description": "Schedule ID — set when this run was triggered by a Temporal schedule"
-      },
-      "source_type": {
-        "$ref": "#/components/schemas/AgentRunType",
-        "description": "Replacement for legacy AgentRun.type"
-      },
-      "type": {
-        "deprecated": true,
-        "x-deprecated-message": "Use source_type for creation source and run_type for runtime mode.",
-        "$ref": "#/components/schemas/AgentRunType",
-        "description": "Deprecated: Use source_type for creation source and run_type for runtime mode."
-      },
-      "id": {
-        "type": "string",
-        "description": "The stable identifier used by all client code"
-      },
-      "run_kind": {
-        "type": "string",
-        "const": "agent",
-        "description": "Internal discriminator key"
-      },
-      "parent_run_id": {
-        "type": "string",
-        "description": "Process run this agent belongs to — set when a process agent node recorded this run. Its conversation lives on the parent run under `workstream_id`."
-      },
-      "workstream_id": {
-        "type": "string",
-        "description": "Workstream this run occupies inside its parent run (the process node id)."
-      },
-      "run_type": {
-        "type": "string",
-        "const": "autonomous",
-        "description": "Public-facing runtime mode"
-      },
-      "account": {
-        "type": "string",
-        "description": "Account ID"
-      },
-      "project": {
-        "type": "string",
-        "description": "Project ID"
-      },
-      "workflow_id": {
-        "type": "string",
-        "description": "Temporal workflow ID (stable across continueAsNew)"
-      },
-      "first_workflow_run_id": {
-        "type": "string",
-        "description": "First Temporal workflow run ID (used for Redis channel and artifact resolution)"
-      },
-      "artifacts_path": {
-        "type": "string",
-        "description": "Artifact storage path for this run"
-      },
-      "status": {
-        "$ref": "#/components/schemas/AgentRunStatus",
-        "description": "Current status of the agent run"
-      },
-      "activity_state": {
-        "$ref": "#/components/schemas/ConversationActivityState",
-        "description": "Whether the agent is currently working or idle (waiting for user input)"
-      },
-      "started_by": {
-        "type": "string",
-        "description": "User or service that initiated the run"
-      },
-      "started_at": {
-        "type": "string",
-        "format": "date-time",
-        "description": "When the run started"
-      },
-      "completed_at": {
-        "type": "string",
-        "format": "date-time",
-        "description": "When the run completed (or failed/cancelled)"
-      },
-      "title": {
-        "type": "string",
-        "description": "Conversation title (short, human-readable)"
-      },
-      "event_subscription_id": {
-        "type": "string",
-        "description": "Event subscription ID — set when this run was triggered by the event bus."
-      },
-      "event_ref": {
-        "$ref": "#/components/schemas/EventRef",
-        "description": "Event reference — set when this run was triggered by the event bus."
-      },
-      "archive_state": {
-        "$ref": "#/components/schemas/AgentRunArchiveState",
-        "description": "Archive lifecycle state"
-      },
-      "created_at": {
-        "type": "string",
-        "format": "date-time",
-        "description": "Timestamp when the document was created"
-      },
-      "updated_at": {
-        "type": "string",
-        "format": "date-time",
-        "description": "Timestamp when the document was last updated"
-      },
-      "interaction_name": {
-        "type": "string",
-        "description": "Human-readable interaction name"
-      },
-      "interactionRef": {
-        "$ref": "#/components/schemas/InteractionRef"
-      },
-      "environmentRef": {
-        "$ref": "#/components/schemas/ResourceRef",
-        "description": "Resolved environment reference (name resolved from `config.environment` id). Populated by the list endpoint; may be absent on other endpoints or when the id cannot be resolved, in which case consumers should fall back to `config.environment`."
-      },
-      "topic": {
-        "type": "string",
-        "description": "Conversation topic (longer description from topic analysis)"
-      },
-      "generate_topic": {
-        "type": "boolean",
-        "description": "Whether automatic conversation title/topic generation is enabled for this run."
-      },
-      "generate_lessons": {
-        "type": "boolean",
-        "description": "Whether automatic lessons generation is enabled for this run."
-      },
-      "lessons_learned": {
-        "type": "array",
-        "items": {
-          "type": "string"
-        },
-        "description": "Lessons learned from the conversation (extracted at completion)"
+        "description": "Request LLM evaluation when the project evaluation policy is opt_in. Defaults to false. Cannot override disabled or opt out of always_on."
       },
       "evaluation": {
         "$ref": "#/components/schemas/AgentRunEvaluation",
@@ -34158,6 +35581,10 @@
         "type": "boolean",
         "description": "Whether to generate lessons automatically at completion. Defaults to true; conversation content remains searchable when disabled."
       },
+      "evaluate": {
+        "type": "boolean",
+        "description": "Request LLM evaluation when the project evaluation policy is opt_in. Defaults to false. Cannot override disabled or opt out of always_on."
+      },
       "data": {
         "type": "object",
         "additionalProperties": true,
@@ -34278,10 +35705,18 @@
         "$ref": "#/components/schemas/AgentCheckpointConfiguration",
         "description": "Structured checkpoint override for this run. Field-wise it takes precedence over the interaction's `agent_runner_options.checkpoint` and the project's `configuration.agent.checkpoint`; the legacy `checkpoint_tokens` above still wins over everything when set."
       },
+      "budget": {
+        "$ref": "#/components/schemas/AgentBudgetConfiguration",
+        "description": "Token budget for this run and its subagent workstreams. Field-wise it takes precedence over the interaction's `agent_runner_options.budget` and the project's `configuration.agent.budget`."
+      },
       "max_iterations": {
         "type": "number",
         "description": "Maximum conversation iterations (default: 20)"
       },
+      "final_verification": {
+        "type": "boolean",
+        "description": "When true, a non-interactive free-form run takes one extra turn after its answer to check that the task is complete. Off by default. Not kept on restart or fork."
+      },
       "notify_endpoints": {
         "type": "array",
         "items": {
@@ -35027,7 +36462,7 @@
       },
       "contradicted": {
         "type": "boolean",
-        "description": "Only runs whose feedback or judge contradicts the detectors"
+        "description": "Only runs whose feedback or LLM evaluation contradicts the detectors"
       }
     }
   },
@@ -35065,6 +36500,10 @@
         "type": "boolean",
         "description": "Whether to generate lessons automatically at completion. Defaults to true; conversation content remains searchable when disabled."
       },
+      "evaluate": {
+        "type": "boolean",
+        "description": "Request LLM evaluation when the project evaluation policy is opt_in. Defaults to false. Cannot override disabled or opt out of always_on."
+      },
       "parent_run_id": {
         "type": "string"
       },
@@ -35711,6 +37150,9 @@
           "errorType": {
             "type": "string"
           },
+          "executionRunId": {
+            "type": "string"
+          },
           "nestedInteractionId": {
             "type": "string"
           },
@@ -36454,7 +37896,7 @@
           },
           "eventType": {
             "type": "string",
-            "const": "turn_judgement"
+            "const": "turn_llm_evaluation"
           },
           "evaluationRev": {
             "type": "integer",
@@ -36470,7 +37912,7 @@
             "maximum": 9007199254740991
           },
           "gate": {
-            "$ref": "#/components/schemas/JudgeGateReason"
+            "$ref": "#/components/schemas/EvaluationGateReason"
           },
           "sampleRate": {
             "type": "number"
@@ -36479,10 +37921,10 @@
             "type": "number"
           },
           "outcome": {
-            "$ref": "#/components/schemas/JudgeOutcome"
+            "$ref": "#/components/schemas/EvaluationOutcome"
           },
           "verdict": {
-            "$ref": "#/components/schemas/JudgeVerdict"
+            "$ref": "#/components/schemas/EvaluationVerdict"
           },
           "score": {
             "type": "number"
@@ -38240,6 +39682,9 @@
       "checkpoint_tokens": {
         "type": "number"
       },
+      "budget": {
+        "$ref": "#/components/schemas/AgentBudgetConfiguration"
+      },
       "version": {
         "type": "number"
       },
@@ -41222,9 +42667,11 @@
           "provider",
           "service_tier",
           "interaction",
-          "workflow"
+          "workflow",
+          "agent_run",
+          "workflow_run"
         ],
-        "description": "Group results by this dimension"
+        "description": "Group results by this dimension. `agent_run` groups by root agent run, including the calls of its sub-agents; `workflow_run` groups by Temporal workflow run, which separates each sub-agent."
       },
       "resolution": {
         "type": "string",
@@ -41272,6 +42719,10 @@
         "type": "string",
         "description": "Filter by agent run ID"
       },
+      "agent_only": {
+        "type": "boolean",
+        "description": "Restrict usage to agent runs and their attributed nested/background inference. Excludes standalone interactions and non-agent workflows. Defaults to false."
+      },
       "interaction_id": {
         "type": "string",
         "description": "Filter by interaction id: stored ObjectId or namespaced in-code id"
@@ -41441,6 +42892,12 @@
         "type": "string",
         "description": "Processing tier this price applies to"
       },
+      "min_prompt_tokens": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991,
+        "description": "When set, these prices apply to calls whose prompt (input, cached and cache-write tokens) is longer than this many tokens, in place of the prices without it."
+      },
       "input_price_per_m_tokens": {
         "type": "number"
       },
@@ -41458,8 +42915,10 @@
         "enum": [
           "billing_export",
           "model_pricing_daily",
+          "run_time_estimate",
           "unavailable"
-        ]
+        ],
+        "description": "Where the rates come from. `run_time_estimate` rates are the ones recorded on the calls when their cost was estimated; the others come from the pricing catalog."
       }
     },
     "required": [
@@ -41743,6 +43202,30 @@
               ],
               "additionalProperties": false
             }
+          },
+          "cost_by_source": {
+            "type": "object",
+            "properties": {
+              "provider_billed": {
+                "type": "number",
+                "description": "USD the provider reported billing for the calls."
+              },
+              "run_time_estimate": {
+                "type": "number",
+                "description": "USD estimated from list prices when the calls ran, for calls with no billed amount."
+              },
+              "price_table": {
+                "type": "number",
+                "description": "USD computed from the pricing table, for calls with no cost recorded when they ran."
+              }
+            },
+            "required": [
+              "provider_billed",
+              "run_time_estimate",
+              "price_table"
+            ],
+            "additionalProperties": false,
+            "description": "How the total cost splits by where each call's cost came from."
           }
         },
         "required": [
@@ -41838,6 +43321,30 @@
               ],
               "additionalProperties": false
             }
+          },
+          "cost_by_source": {
+            "type": "object",
+            "properties": {
+              "provider_billed": {
+                "type": "number",
+                "description": "USD the provider reported billing for the calls."
+              },
+              "run_time_estimate": {
+                "type": "number",
+                "description": "USD estimated from list prices when the calls ran, for calls with no billed amount."
+              },
+              "price_table": {
+                "type": "number",
+                "description": "USD computed from the pricing table, for calls with no cost recorded when they ran."
+              }
+            },
+            "required": [
+              "provider_billed",
+              "run_time_estimate",
+              "price_table"
+            ],
+            "additionalProperties": false,
+            "description": "How the total cost splits by where each call's cost came from."
           }
         },
         "required": [