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

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

@@ -1,4 +1,160 @@
 {
+  "RunBudgetOwner": {
+    "type": "object",
+    "properties": {
+      "workflow_id": {
+        "type": "string",
+        "minLength": 1
+      },
+      "first_run_id": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "required": [
+      "workflow_id",
+      "first_run_id"
+    ],
+    "additionalProperties": false
+  },
+  "RunBudgetUsage": {
+    "type": "object",
+    "properties": {
+      "input": {
+        "type": "number",
+        "minimum": 0
+      },
+      "cached_input": {
+        "type": "number",
+        "minimum": 0
+      },
+      "output": {
+        "type": "number",
+        "minimum": 0
+      }
+    },
+    "required": [
+      "input",
+      "cached_input",
+      "output"
+    ],
+    "additionalProperties": false
+  },
+  "ReadRunBudgetUsagePayload": {
+    "type": "object",
+    "properties": {
+      "account_id": {
+        "type": "string",
+        "minLength": 1
+      },
+      "project_id": {
+        "type": "string",
+        "minLength": 1
+      },
+      "agent_run_id": {
+        "type": "string",
+        "minLength": 1
+      },
+      "owner": {
+        "$ref": "#/components/schemas/RunBudgetOwner"
+      },
+      "require_estimates": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "account_id",
+      "project_id",
+      "agent_run_id",
+      "owner"
+    ],
+    "additionalProperties": false
+  },
+  "RunBudgetTotals": {
+    "type": "object",
+    "properties": {
+      "measured": {
+        "$ref": "#/components/schemas/RunBudgetUsage"
+      },
+      "unpriced": {
+        "$ref": "#/components/schemas/RunBudgetUsage"
+      },
+      "reported_nano_usd": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "estimated_nano_usd": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "unmeasured_calls": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      },
+      "missing_usage_calls": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "required": [
+      "measured",
+      "unpriced",
+      "reported_nano_usd",
+      "estimated_nano_usd",
+      "unmeasured_calls",
+      "missing_usage_calls"
+    ],
+    "additionalProperties": false
+  },
+  "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": {
@@ -1050,6 +1206,8 @@
     "enum": [
       "document",
       "collection",
+      "agent_run",
+      "shared_content",
       "task"
     ]
   },
@@ -1066,7 +1224,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 +1235,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 +1301,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 +1351,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 +1448,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 +3130,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 +3654,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 +3942,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 +3976,9 @@
         "type": "string",
         "const": "openai-thinking"
       },
+      "image_generation": {
+        "$ref": "#/components/schemas/OpenAiImageGenerationOptions"
+      },
       "max_tokens": {
         "type": "number"
       },
@@ -3816,6 +4003,14 @@
       "reasoning_effort": {
         "$ref": "#/components/schemas/ReasoningEffort"
       },
+      "reasoning_context": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "current_turn",
+          "all_turns"
+        ]
+      },
       "image_detail": {
         "type": "string",
         "enum": [
@@ -3840,6 +4035,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 +4144,9 @@
         "type": "string",
         "const": "openai-text"
       },
+      "image_generation": {
+        "$ref": "#/components/schemas/OpenAiImageGenerationOptions"
+      },
       "max_tokens": {
         "type": "number"
       },
@@ -4096,13 +4384,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 +4398,8 @@
           "low",
           "medium",
           "high",
+          "xhigh",
+          "max",
           "auto"
         ]
       },
@@ -4128,6 +4418,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 +4714,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 +4737,13 @@
           "5m",
           "1h"
         ]
+      },
+      "speed": {
+        "type": "string",
+        "enum": [
+          "standard",
+          "fast"
+        ]
       }
     },
     "additionalProperties": false
@@ -4570,6 +4900,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 +4958,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 +5466,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 +5547,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 +5615,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 +5740,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 +5842,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 +7908,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 +9024,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 +9092,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 +10071,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 +10179,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "store_media_results": {
         "type": "boolean"
       },
@@ -9808,6 +10688,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "store_media_results": {
         "type": "boolean"
       },
@@ -9918,6 +10808,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "store_media_results": {
         "type": "boolean"
       },
@@ -10076,6 +10976,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 +11118,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "prompts": {
         "type": "array",
         "items": {
@@ -10304,6 +11221,16 @@
       "model_options": {
         "$ref": "#/components/schemas/ModelOptions"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "prompts": {
         "type": "array",
         "items": {
@@ -10405,6 +11332,12 @@
       },
       "model_source": {
         "$ref": "#/components/schemas/ModelSource"
+      },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
+      "model_options": {
+        "$ref": "#/components/schemas/ModelOptions"
       }
     },
     "required": [
@@ -11479,6 +12412,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 +12807,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -12011,6 +12951,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -12790,6 +13733,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -12944,6 +13890,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -13080,6 +14029,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -13233,6 +14185,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -13386,6 +14341,9 @@
       "config": {
         "$ref": "#/components/schemas/InteractionExecutionConfiguration"
       },
+      "inference_profile": {
+        "$ref": "#/components/schemas/InferenceProfileSnapshot"
+      },
       "error": {
         "$ref": "#/components/schemas/InteractionExecutionError"
       },
@@ -13490,6 +14448,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 +14598,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 +14627,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 +14991,19 @@
       "environment_id": {
         "type": "string"
       },
+      "inference_profile": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/InferenceProfileId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "inherit_model_config": {
+        "type": "boolean"
+      },
       "model_id": {
         "type": "string"
       },
@@ -15380,6 +16363,26 @@
           }
         ]
       },
+      "principal_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "actor_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
       "details.pipeline": {
         "anyOf": [
           {
@@ -15437,7 +16440,9 @@
     "type": "string",
     "enum": [
       "resource_id",
-      "request_id"
+      "request_id",
+      "principal_id",
+      "actor_id"
     ]
   },
   "AuditAggregationOperation": {
@@ -15467,6 +16472,8 @@
       "event_category",
       "provider",
       "project_id",
+      "principal_id",
+      "actor_id",
       "details.pipeline",
       "details.verdict",
       "details.workflow_type",
@@ -15819,6 +16826,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 +17129,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 +19297,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": [
@@ -27650,6 +28683,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 +28833,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 +29135,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": {
@@ -28274,6 +29323,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": {
@@ -28446,6 +29503,12 @@
           "type": "string"
         }
       },
+      "shared": {
+        "type": "boolean"
+      },
+      "shared_root": {
+        "type": "boolean"
+      },
       "inherited_properties": {
         "type": "array",
         "items": {
@@ -30685,6 +31748,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 +31774,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 +31929,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 +32064,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 +33825,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 +33925,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 +34078,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 +34372,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 +34648,7 @@
     ],
     "description": "Why the run was rated the way it was."
   },
-  "AgentRunJudgeResult": {
+  "AgentRunLlmEvaluationResult": {
     "type": "object",
     "properties": {
       "rev": {
@@ -33403,7 +34657,7 @@
         "maximum": 9007199254740991
       },
       "gate": {
-        "$ref": "#/components/schemas/JudgeGateReason"
+        "$ref": "#/components/schemas/EvaluationGateReason"
       },
       "sample_rate": {
         "type": "number"
@@ -33412,10 +34666,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 +34680,7 @@
       "prompt_version": {
         "type": "string"
       },
-      "turns_judged": {
+      "turns_evaluated": {
         "type": "array",
         "items": {
           "type": "integer",
@@ -33434,7 +34688,7 @@
           "maximum": 9007199254740991
         }
       },
-      "judged_at": {
+      "evaluated_at": {
         "type": "string",
         "format": "date-time"
       }
@@ -33446,42 +34700,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 +34755,8 @@
       "feedback_counts": {
         "$ref": "#/components/schemas/AgentRunFeedbackCounts"
       },
-      "judge": {
-        "$ref": "#/components/schemas/AgentRunJudgeResult"
+      "llm_evaluation": {
+        "$ref": "#/components/schemas/AgentRunLlmEvaluationResult"
       },
       "severity": {
         "$ref": "#/components/schemas/EvaluationSeverity"
@@ -33813,6 +35069,10 @@
         },
         "description": "Lessons learned from the conversation (extracted at completion)"
       },
+      "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."
@@ -34087,6 +35347,10 @@
         },
         "description": "Lessons learned from the conversation (extracted at completion)"
       },
+      "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."
@@ -34158,6 +35422,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 +35546,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 +36303,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 +36341,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 +36991,9 @@
           "errorType": {
             "type": "string"
           },
+          "executionRunId": {
+            "type": "string"
+          },
           "nestedInteractionId": {
             "type": "string"
           },
@@ -36454,7 +37737,7 @@
           },
           "eventType": {
             "type": "string",
-            "const": "turn_judgement"
+            "const": "turn_llm_evaluation"
           },
           "evaluationRev": {
             "type": "integer",
@@ -36470,7 +37753,7 @@
             "maximum": 9007199254740991
           },
           "gate": {
-            "$ref": "#/components/schemas/JudgeGateReason"
+            "$ref": "#/components/schemas/EvaluationGateReason"
           },
           "sampleRate": {
             "type": "number"
@@ -36479,10 +37762,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 +39523,9 @@
       "checkpoint_tokens": {
         "type": "number"
       },
+      "budget": {
+        "$ref": "#/components/schemas/AgentBudgetConfiguration"
+      },
       "version": {
         "type": "number"
       },
@@ -41222,9 +42508,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",
@@ -41441,6 +42729,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 +42752,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 +43039,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 +43158,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": [