@vertesia/common 1.5.0 → 1.5.1

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

@@ -1,4 +1,18 @@
 {
+    "AccountApiVersionPolicy": {
+        "type": "object",
+        "properties": {
+            "default_api_version": {
+                "type": "number",
+                "enum": [
+                    20250925,
+                    20260210,
+                    20260319,
+                    20260803
+                ]
+            }
+        }
+    },
     "AccountType": {
         "type": "string",
         "enum": [
@@ -538,6 +552,16 @@
     "PrincipalIdentity": {
         "type": "object",
         "properties": {
+            "kind": {
+                "type": "string",
+                "enum": [
+                    "user",
+                    "apikey"
+                ]
+            },
+            "id": {
+                "type": "string"
+            },
             "clearance": {
                 "type": "number"
             },
@@ -559,20 +583,18 @@
             "properties": {
                 "type": "object",
                 "additionalProperties": true
-            },
-            "id": {
-                "type": "string"
             }
         },
         "required": [
+            "kind",
+            "id",
             "clearance",
             "compartments",
             "tags",
-            "properties",
-            "id"
+            "properties"
         ],
         "additionalProperties": false,
-        "description": "Response shape of the `/iam/users/identity` endpoint: the current principal's  {@link  PrincipalContext }  plus its id. Distinct from `PrincipalContext` itself because the id is identity metadata, not a merged BLP field — adding it to `PrincipalContext` would unintentionally expose `$principal.id` to PrincipalSet rule evaluation."
+        "description": "Response shape of the `/iam/users/identity` endpoint: the current principal's full ABAC context — its `kind` (always `user` here), `id`, and the merged BLP attributes a rule can reference through `$principal.*`."
     },
     "SignupData": {
         "type": "object",
@@ -1225,6 +1247,7 @@
         "enum": [
             "owner",
             "admin",
+            "app_admin",
             "manager",
             "developer",
             "application",
@@ -2198,7 +2221,7 @@
             "type"
         ],
         "additionalProperties": false,
-        "description": "Explicit search mapping for one content-object property.\n\nChanging a mapping requires a full reindex. Existing Elasticsearch fields cannot change type in place."
+        "description": "Explicit search mapping for one content-object property.\n\nChanging a mapping requires a full reindex. Existing Elasticsearch fields cannot change type in place. A `nested` mapping accepts no scalar options; declare its searchable child fields as separate mappings below its path."
     },
     "ProjectSearchPropertyType": {
         "type": "string",
@@ -2209,9 +2232,10 @@
             "long",
             "double",
             "date",
-            "geo_point"
+            "geo_point",
+            "nested"
         ],
-        "description": "Elasticsearch field types that may be explicitly assigned to content-object properties. Paths are relative to the object's `properties` field."
+        "description": "Elasticsearch field types that may be explicitly assigned to content-object properties. Declare nested object-array paths with type `nested` and their children as separate dotted paths. Paths are relative to the object's `properties` field."
     },
     "ProjectIndexingConfiguration": {
         "type": "object",
@@ -2417,9 +2441,6 @@
                 "type": "boolean"
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "AzureFoundryChatOptions": {
@@ -2465,9 +2486,6 @@
                 "type": "boolean"
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "ImagenOptions": {
@@ -2488,7 +2506,8 @@
                 "enum": [
                     "dont_allow",
                     "allow_adults",
-                    "allow_all"
+                    "allow_all",
+                    "allow_adult"
                 ]
             },
             "safety_setting": {
@@ -2568,9 +2587,6 @@
                 ]
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "ImagenTaskType": {
@@ -2631,6 +2647,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"
             },
@@ -2648,9 +2672,6 @@
                 ]
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "VertexAIGeminiOptions": {
@@ -2764,9 +2785,6 @@
                 "type": "number"
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "ThinkingLevel": {
@@ -2818,9 +2836,6 @@
                 ]
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "VertexAIGrokOptions": {
@@ -2846,9 +2861,6 @@
                 }
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "NovaCanvasOptions": {
@@ -2920,7 +2932,6 @@
             }
         },
         "required": [
-            "_option_id",
             "taskType"
         ],
         "additionalProperties": false
@@ -2956,9 +2967,6 @@
                 "description": "Provider-defined processing tier. Unknown non-empty values are preserved for forward compatibility."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockNovaOptions": {
@@ -2977,6 +2985,9 @@
             "top_p": {
                 "type": "number"
             },
+            "top_k": {
+                "type": "number"
+            },
             "stop_sequence": {
                 "type": "array",
                 "items": {
@@ -2992,9 +3003,6 @@
                 "description": "Provider-defined processing tier. Unknown non-empty values are preserved for forward compatibility."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockMistralOptions": {
@@ -3013,6 +3021,9 @@
             "top_p": {
                 "type": "number"
             },
+            "top_k": {
+                "type": "number"
+            },
             "stop_sequence": {
                 "type": "array",
                 "items": {
@@ -3028,9 +3039,6 @@
                 "description": "Provider-defined processing tier. Unknown non-empty values are preserved for forward compatibility."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockAI21Options": {
@@ -3049,6 +3057,12 @@
             "top_p": {
                 "type": "number"
             },
+            "presence_penalty": {
+                "type": "number"
+            },
+            "frequency_penalty": {
+                "type": "number"
+            },
             "stop_sequence": {
                 "type": "array",
                 "items": {
@@ -3064,9 +3078,6 @@
                 "description": "Provider-defined processing tier. Unknown non-empty values are preserved for forward compatibility."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockCohereCommandOptions": {
@@ -3085,6 +3096,15 @@
             "top_p": {
                 "type": "number"
             },
+            "top_k": {
+                "type": "number"
+            },
+            "presence_penalty": {
+                "type": "number"
+            },
+            "frequency_penalty": {
+                "type": "number"
+            },
             "stop_sequence": {
                 "type": "array",
                 "items": {
@@ -3100,9 +3120,6 @@
                 "description": "Provider-defined processing tier. Unknown non-empty values are preserved for forward compatibility."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockClaudeOptions": {
@@ -3130,6 +3147,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"
             },
@@ -3162,9 +3187,6 @@
                 "description": "Provider-defined processing tier. Unknown non-empty values are preserved for forward compatibility."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockPalmyraOptions": {
@@ -3207,9 +3229,6 @@
                 "description": "Provider-defined processing tier. Unknown non-empty values are preserved for forward compatibility."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockGptOssOptions": {
@@ -3254,9 +3273,6 @@
                 "description": "Provider-defined processing tier. Unknown non-empty values are preserved for forward compatibility."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "TwelvelabsPegasusOptions": {
@@ -3278,9 +3294,6 @@
                 "description": "Provider-defined processing tier. Unknown non-empty values are preserved for forward compatibility."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockMantleResponsesOptions": {
@@ -3306,7 +3319,8 @@
                     "low",
                     "medium",
                     "high",
-                    "xhigh"
+                    "xhigh",
+                    "max"
                 ]
             },
             "reasoning_effort": {
@@ -3316,7 +3330,8 @@
                     "low",
                     "medium",
                     "high",
-                    "xhigh"
+                    "xhigh",
+                    "max"
                 ]
             },
             "verbosity": {
@@ -3339,9 +3354,6 @@
                 "type": "boolean"
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockMantleChatCompletionsOptions": {
@@ -3386,9 +3398,6 @@
                 "type": "boolean"
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "BedrockMantleClaudeOptions": {
@@ -3426,6 +3435,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"
             },
@@ -3443,9 +3460,6 @@
                 ]
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "OpenAiThinkingOptions": {
@@ -3470,6 +3484,14 @@
             "reasoning_effort": {
                 "$ref": "#/components/schemas/ReasoningEffort"
             },
+            "reasoning_context": {
+                "type": "string",
+                "enum": [
+                    "auto",
+                    "current_turn",
+                    "all_turns"
+                ]
+            },
             "image_detail": {
                 "type": "string",
                 "enum": [
@@ -3492,9 +3514,6 @@
                 "description": "Additional provider-specific fields merged into the OpenAI-compatible request body."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "ReasoningEffort": {
@@ -3565,9 +3584,6 @@
                 "description": "Additional provider-specific fields merged into the OpenAI-compatible request body."
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "OpenAiDalleOptions": {
@@ -3612,9 +3628,6 @@
                 "type": "number"
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "OpenAiGptImageOptions": {
@@ -3659,9 +3672,6 @@
                 ]
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "XAIGrokImageOptions": {
@@ -3717,9 +3727,6 @@
                 "maximum": 10
             }
         },
-        "required": [
-            "_option_id"
-        ],
         "additionalProperties": false
     },
     "GroqOptions": {
@@ -3760,7 +3767,6 @@
             }
         },
         "required": [
-            "_option_id",
             "reasoning_format"
         ],
         "additionalProperties": false
@@ -3828,13 +3834,72 @@
                 "type": "boolean"
             }
         },
-        "required": [
-            "_option_id"
-        ],
+        "additionalProperties": false
+    },
+    "AnthropicClaudeOptions": {
+        "type": "object",
+        "properties": {
+            "_option_id": {
+                "type": "string",
+                "const": "anthropic-claude"
+            },
+            "max_tokens": {
+                "type": "number"
+            },
+            "temperature": {
+                "type": "number"
+            },
+            "top_p": {
+                "type": "number"
+            },
+            "top_k": {
+                "type": "number"
+            },
+            "stop_sequence": {
+                "type": "array",
+                "items": {
+                    "type": "string"
+                }
+            },
+            "effort": {
+                "type": "string",
+                "enum": [
+                    "low",
+                    "medium",
+                    "high",
+                    "xhigh",
+                    "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"
+            },
+            "include_thoughts": {
+                "type": "boolean"
+            },
+            "cache_enabled": {
+                "type": "boolean"
+            },
+            "cache_ttl": {
+                "type": "string",
+                "enum": [
+                    "5m",
+                    "1h"
+                ]
+            }
+        },
         "additionalProperties": false
     },
     "ModelOptions": {
-        "oneOf": [
+        "anyOf": [
             {
                 "$ref": "#/components/schemas/TextFallbackOptions"
             },
@@ -3915,44 +3980,12 @@
             },
             {
                 "$ref": "#/components/schemas/MistralTextOptions"
+            },
+            {
+                "$ref": "#/components/schemas/AnthropicClaudeOptions"
             }
         ],
-        "discriminator": {
-            "propertyName": "_option_id",
-            "mapping": {
-                "text-fallback": "#/components/schemas/TextFallbackOptions",
-                "azure-foundry-chat": "#/components/schemas/AzureFoundryChatOptions",
-                "vertexai-imagen": "#/components/schemas/ImagenOptions",
-                "vertexai-claude": "#/components/schemas/VertexAIClaudeOptions",
-                "vertexai-gemini": "#/components/schemas/VertexAIGeminiOptions",
-                "vertexai-gemini-omni-video": "#/components/schemas/VertexAIGeminiOmniVideoOptions",
-                "vertexai-grok": "#/components/schemas/VertexAIGrokOptions",
-                "bedrock-nova-canvas": "#/components/schemas/NovaCanvasOptions",
-                "bedrock-converse": "#/components/schemas/BedrockConverseOptions",
-                "bedrock-nova": "#/components/schemas/BedrockNovaOptions",
-                "bedrock-mistral": "#/components/schemas/BedrockMistralOptions",
-                "bedrock-ai21": "#/components/schemas/BedrockAI21Options",
-                "bedrock-cohere-command": "#/components/schemas/BedrockCohereCommandOptions",
-                "bedrock-claude": "#/components/schemas/BedrockClaudeOptions",
-                "bedrock-palmyra": "#/components/schemas/BedrockPalmyraOptions",
-                "bedrock-gpt-oss": "#/components/schemas/BedrockGptOssOptions",
-                "bedrock-twelvelabs-pegasus": "#/components/schemas/TwelvelabsPegasusOptions",
-                "bedrock-mantle-responses": "#/components/schemas/BedrockMantleResponsesOptions",
-                "bedrock-mantle-chat-completions": "#/components/schemas/BedrockMantleChatCompletionsOptions",
-                "bedrock-mantle-claude": "#/components/schemas/BedrockMantleClaudeOptions",
-                "openai-thinking": "#/components/schemas/OpenAiThinkingOptions",
-                "openai-text": "#/components/schemas/OpenAiTextOptions",
-                "openai-dalle": "#/components/schemas/OpenAiDalleOptions",
-                "openai-gpt-image": "#/components/schemas/OpenAiGptImageOptions",
-                "xai-grok-image": "#/components/schemas/XAIGrokImageOptions",
-                "groq-deepseek-thinking": "#/components/schemas/GroqOptions",
-                "mistral-text": "#/components/schemas/MistralTextOptions"
-            }
-        },
-        "type": "object",
-        "required": [
-            "_option_id"
-        ]
+        "type": "object"
     },
     "HttpTimeoutOptions": {
         "type": "object",
@@ -4011,6 +4044,10 @@
             "model": {
                 "type": "string"
             },
+            "inherit_model_config": {
+                "type": "boolean",
+                "description": "Treat environment and model as inherited fallbacks after interaction settings, before project defaults."
+            },
             "do_validate": {
                 "type": "boolean"
             },
@@ -4643,13 +4680,9 @@
                 "description": "Project defaults and caps for browser_use agent workstreams."
             },
             "pdf_template_object_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ],
                 "description": "Object ID of a content object containing a custom LaTeX template (.latex file) to use as the branded PDF template. When set, \"Export as Branded PDF\" uses this template instead of the built-in Vertesia default template. `null` clears it."
             }
@@ -4834,13 +4867,9 @@
                 "description": "Project defaults and caps for browser_use agent workstreams."
             },
             "pdf_template_object_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ],
                 "description": "Object ID of a content object containing a custom LaTeX template (.latex file) to use as the branded PDF template. When set, \"Export as Branded PDF\" uses this template instead of the built-in Vertesia default template. `null` clears it."
             }
@@ -4916,11 +4945,12 @@
     "ToolCollectionAuthType": {
         "type": "string",
         "enum": [
+            "none",
             "oauth",
             "api_key",
             "other"
         ],
-        "description": "Authentication type for tool collections.\n- 'oauth': the runtime resolves a per-user or per-project OAuth access token\n- 'api_key': a static key held in the project's secret store is sent as the RFC 6750 bearer token (`Authorization: Bearer <key>`)"
+        "description": "Authentication type for tool collections.\n- 'none': connect directly without credentials for MCP collections; does not disable authentication for Vertesia SDK collections\n- 'oauth': the runtime resolves a per-user or per-project OAuth access token\n- 'api_key': a static key held in the project's secret store is sent as the RFC 6750 bearer token (`Authorization: Bearer <key>`)\n- 'other' or omitted: use the legacy provider connection-details flow for MCP collections"
     },
     "MCPOAuthConfig": {
         "type": "object",
@@ -9219,6 +9249,9 @@
     "InteractionForkPayload": {
         "type": "object",
         "properties": {
+            "newName": {
+                "type": "string"
+            },
             "keepTags": {
                 "type": "boolean"
             },
@@ -9328,6 +9361,10 @@
             "model": {
                 "type": "string"
             },
+            "inherit_model_config": {
+                "type": "boolean",
+                "description": "Treat environment and model as inherited fallbacks after interaction settings, before project defaults."
+            },
             "hasImage": {
                 "type": "boolean"
             },
@@ -13216,13 +13253,9 @@
                     "type": "object",
                     "properties": {
                         "_id": {
-                            "anyOf": [
-                                {
-                                    "type": "string"
-                                },
-                                {
-                                    "type": "null"
-                                }
+                            "type": [
+                                "string",
+                                "null"
                             ]
                         },
                         "count": {
@@ -13251,13 +13284,9 @@
                     "type": "object",
                     "properties": {
                         "_id": {
-                            "anyOf": [
-                                {
-                                    "type": "string"
-                                },
-                                {
-                                    "type": "null"
-                                }
+                            "type": [
+                                "string",
+                                "null"
                             ]
                         },
                         "count": {
@@ -13286,13 +13315,9 @@
                     "type": "object",
                     "properties": {
                         "_id": {
-                            "anyOf": [
-                                {
-                                    "type": "string"
-                                },
-                                {
-                                    "type": "null"
-                                }
+                            "type": [
+                                "string",
+                                "null"
                             ]
                         },
                         "count": {
@@ -13321,13 +13346,9 @@
                     "type": "object",
                     "properties": {
                         "_id": {
-                            "anyOf": [
-                                {
-                                    "type": "string"
-                                },
-                                {
-                                    "type": "null"
-                                }
+                            "type": [
+                                "string",
+                                "null"
                             ]
                         },
                         "count": {
@@ -13356,13 +13377,9 @@
                     "type": "object",
                     "properties": {
                         "_id": {
-                            "anyOf": [
-                                {
-                                    "type": "string"
-                                },
-                                {
-                                    "type": "null"
-                                }
+                            "type": [
+                                "string",
+                                "null"
                             ]
                         },
                         "count": {
@@ -13681,6 +13698,9 @@
     "PromptTemplateForkPayload": {
         "type": "object",
         "properties": {
+            "newName": {
+                "type": "string"
+            },
             "keepTags": {
                 "type": "boolean"
             },
@@ -14284,13 +14304,9 @@
                 "description": "Whether a key is stored for this collection."
             },
             "hint": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ],
                 "description": "Last few characters of the stored key, for display only. Null when unset."
             }
@@ -14360,113 +14376,69 @@
         "type": "object",
         "properties": {
             "time": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "action": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "resource_type": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "event_category": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "provider": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "project_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "details.pipeline": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "details.verdict": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "details.workflow_type": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "details.rule_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "model": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             }
         },
@@ -14626,13 +14598,9 @@
                 "$ref": "#/components/schemas/EventCategory"
             },
             "source": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "root_event_id": {
@@ -14678,33 +14646,21 @@
                 "type": "boolean"
             },
             "principal_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "principal_type": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "effective_principal_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "roles": {
@@ -14714,63 +14670,39 @@
                 }
             },
             "account_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "project_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "tenant_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "account_name": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "project_name": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "provider": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ],
                 "description": "Provider type for billable/provider-backed events, e.g. vertexai, bedrock."
             },
@@ -15160,6 +15092,10 @@
             "model": {
                 "type": "string"
             },
+            "inherit_model_config": {
+                "type": "boolean",
+                "description": "Treat environment and model as inherited fallbacks after interaction settings, before project defaults."
+            },
             "do_validate": {
                 "type": "boolean"
             },
@@ -16896,33 +16832,21 @@
                 "type": "string"
             },
             "account_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "project_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "tenant_id": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             }
         },
@@ -20143,6 +20067,10 @@
                 "type": "boolean",
                 "description": "When true, this item is excluded from the Composite App dashboard cards"
             },
+            "openInAppPortal": {
+                "type": "boolean",
+                "description": "When true, this item navigates to the App Portal form of the URL (`/apps/<appName><route>`) instead of the Composite App form (`/app/<appName><route>`), so the app is opened standalone rather than inside the Composite App shell."
+            },
             "permissions": {
                 "$ref": "#/components/schemas/CompositeAppNavItemPermissions",
                 "description": "Optional access control settings for this nav item"
@@ -23598,6 +23526,9 @@
         "properties": {
             "bucket": {
                 "type": "string"
+            },
+            "location": {
+                "type": "string"
             }
         },
         "required": [
@@ -24093,13 +24024,9 @@
                 "$ref": "#/components/schemas/DurableTaskStatus"
             },
             "assignee": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "null"
                 ]
             },
             "fields": {
@@ -27267,13 +27194,9 @@
                 "$ref": "#/components/schemas/StringArrayMap"
             },
             "sensitivity": {
-                "anyOf": [
-                    {
-                        "type": "number"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "number",
+                    "null"
                 ]
             },
             "compartments": {
@@ -31699,6 +31622,10 @@
                     "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": [
@@ -35387,19 +35314,11 @@
                 ]
             },
             "value": {
-                "anyOf": [
-                    {
-                        "type": "string"
-                    },
-                    {
-                        "type": "boolean"
-                    },
-                    {
-                        "type": "number"
-                    },
-                    {
-                        "type": "null"
-                    }
+                "type": [
+                    "string",
+                    "boolean",
+                    "number",
+                    "null"
                 ]
             },
             "members": {
@@ -40503,6 +40422,71 @@
         ],
         "additionalProperties": false
     },
+    "EmbeddingBatchRunSummary": {
+        "type": "object",
+        "properties": {
+            "id": {
+                "type": "string"
+            },
+            "state": {
+                "type": "string",
+                "enum": [
+                    "preparing",
+                    "submitted",
+                    "running",
+                    "applying",
+                    "completed",
+                    "completed_with_errors",
+                    "cancelled",
+                    "stale",
+                    "failed"
+                ]
+            },
+            "model": {
+                "type": "string"
+            },
+            "created_at": {
+                "type": "string",
+                "format": "date-time"
+            },
+            "completed_at": {
+                "type": "string",
+                "format": "date-time"
+            },
+            "applied": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "skipped": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "failed": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "stale": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            }
+        },
+        "required": [
+            "id",
+            "state",
+            "model",
+            "created_at",
+            "applied",
+            "skipped",
+            "failed",
+            "stale"
+        ],
+        "additionalProperties": false,
+        "description": "Latest batch run for this embedding type, without provider payloads or input content."
+    },
     "EmbeddingsStatusResponse": {
         "type": "object",
         "properties": {
@@ -40512,6 +40496,9 @@
             "embeddingRunsInProgress": {
                 "type": "number"
             },
+            "latestBatchRun": {
+                "$ref": "#/components/schemas/EmbeddingBatchRunSummary"
+            },
             "totalIndexableObjects": {
                 "type": "number"
             },
@@ -40555,6 +40542,21 @@
         ],
         "additionalProperties": false
     },
+    "RecalculateEmbeddingsQuery": {
+        "type": "object",
+        "properties": {
+            "mode": {
+                "type": "string",
+                "const": "sync",
+                "description": "Force synchronous per-object recalculation. When omitted, batch inference is used when supported."
+            },
+            "force": {
+                "type": "boolean",
+                "description": "Recalculate all eligible objects, including current embeddings. Token limits still apply; existing renditions are reused."
+            }
+        },
+        "additionalProperties": false
+    },
     "ProjectConfigurationEmbeddingEnablePayload": {
         "type": "object",
         "properties": {
@@ -40573,6 +40575,530 @@
         ],
         "additionalProperties": false
     },
+    "EmbeddingBatchProviderState": {
+        "type": "string",
+        "enum": [
+            "pending",
+            "running",
+            "succeeded",
+            "failed",
+            "cancelled",
+            "paused"
+        ]
+    },
+    "EmbeddingBatchCapabilityRequest": {
+        "type": "object",
+        "properties": {
+            "embedding_type": {
+                "$ref": "#/components/schemas/SupportedEmbeddingTypes"
+            }
+        },
+        "required": [
+            "embedding_type"
+        ]
+    },
+    "EmbeddingBatchCapabilityResponse": {
+        "type": "object",
+        "properties": {
+            "eligible": {
+                "type": "boolean"
+            },
+            "reason": {
+                "type": "string"
+            },
+            "environment": {
+                "type": "string"
+            },
+            "provider": {
+                "type": "string"
+            },
+            "model": {
+                "type": "string"
+            },
+            "dimensions": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+            },
+            "max_tokens": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+            },
+            "location": {
+                "type": "string"
+            },
+            "input_format": {
+                "type": "string"
+            },
+            "max_rows": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+            },
+            "artifact_uri": {
+                "type": "string"
+            }
+        },
+        "required": [
+            "eligible"
+        ]
+    },
+    "EmbeddingBatchCreateRequest": {
+        "type": "object",
+        "properties": {
+            "embedding_type": {
+                "$ref": "#/components/schemas/SupportedEmbeddingTypes"
+            },
+            "model": {
+                "type": "string"
+            },
+            "dimensions": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+            },
+            "display_name": {
+                "type": "string"
+            },
+            "input_uri": {
+                "type": "string"
+            },
+            "output_uri": {
+                "type": "string"
+            }
+        },
+        "required": [
+            "embedding_type",
+            "model",
+            "dimensions",
+            "display_name",
+            "input_uri",
+            "output_uri"
+        ]
+    },
+    "EmbeddingBatchJobRequest": {
+        "type": "object",
+        "properties": {
+            "embedding_type": {
+                "$ref": "#/components/schemas/SupportedEmbeddingTypes"
+            },
+            "model": {
+                "type": "string"
+            },
+            "name": {
+                "type": "string"
+            },
+            "include_output_artifacts": {
+                "type": "boolean",
+                "description": "On get, resolve terminal result artifacts for application. Omit for lightweight status polling."
+            }
+        },
+        "required": [
+            "embedding_type",
+            "model",
+            "name"
+        ]
+    },
+    "EmbeddingBatchJobResponse": {
+        "type": "object",
+        "properties": {
+            "name": {
+                "type": "string"
+            },
+            "display_name": {
+                "type": "string"
+            },
+            "state": {
+                "type": "string",
+                "enum": [
+                    "pending",
+                    "running",
+                    "succeeded",
+                    "failed",
+                    "cancelled",
+                    "paused"
+                ]
+            },
+            "model": {
+                "type": "string"
+            },
+            "input_uri": {
+                "type": "string"
+            },
+            "output_uri": {
+                "type": "string"
+            },
+            "output_artifacts": {
+                "type": "array",
+                "items": {
+                    "type": "string"
+                },
+                "description": "Terminal job result artifacts in application storage, including partial results. Never provider file IDs."
+            },
+            "error_message": {
+                "type": "string"
+            }
+        },
+        "required": [
+            "name",
+            "state"
+        ]
+    },
+    "EmbeddingBatchRunState": {
+        "type": "string",
+        "enum": [
+            "preparing",
+            "submitted",
+            "running",
+            "applying",
+            "completed",
+            "completed_with_errors",
+            "cancelled",
+            "stale",
+            "failed"
+        ]
+    },
+    "EmbeddingBatchSubjob": {
+        "type": "object",
+        "properties": {
+            "index": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "display_name": {
+                "type": "string"
+            },
+            "input_uri": {
+                "type": "string"
+            },
+            "output_uri": {
+                "type": "string"
+            },
+            "row_count": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "provider_name": {
+                "type": "string"
+            },
+            "state": {
+                "type": "string",
+                "enum": [
+                    "pending",
+                    "running",
+                    "succeeded",
+                    "failed",
+                    "cancelled",
+                    "paused"
+                ]
+            }
+        },
+        "required": [
+            "index",
+            "display_name",
+            "input_uri",
+            "output_uri",
+            "row_count"
+        ]
+    },
+    "EmbeddingBatchPrepareRequest": {
+        "type": "object",
+        "properties": {
+            "run_id": {
+                "type": "string"
+            },
+            "embedding_type": {
+                "$ref": "#/components/schemas/SupportedEmbeddingTypes"
+            },
+            "capability": {
+                "$ref": "#/components/schemas/EmbeddingBatchCapabilityResponse"
+            }
+        },
+        "required": [
+            "run_id",
+            "embedding_type",
+            "capability"
+        ]
+    },
+    "EmbeddingBatchPrepareResponse": {
+        "type": "object",
+        "properties": {
+            "run_id": {
+                "type": "string"
+            },
+            "row_count": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "subjobs": {
+                "type": "array",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "index": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "display_name": {
+                            "type": "string"
+                        },
+                        "input_uri": {
+                            "type": "string"
+                        },
+                        "output_uri": {
+                            "type": "string"
+                        },
+                        "row_count": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "provider_name": {
+                            "type": "string"
+                        },
+                        "state": {
+                            "type": "string",
+                            "enum": [
+                                "pending",
+                                "running",
+                                "succeeded",
+                                "failed",
+                                "cancelled",
+                                "paused"
+                            ]
+                        }
+                    },
+                    "required": [
+                        "index",
+                        "display_name",
+                        "input_uri",
+                        "output_uri",
+                        "row_count"
+                    ],
+                    "additionalProperties": false
+                }
+            }
+        },
+        "required": [
+            "run_id",
+            "row_count",
+            "subjobs"
+        ]
+    },
+    "EmbeddingBatchRenditionPageRequest": {
+        "type": "object",
+        "properties": {
+            "run_id": {
+                "type": "string"
+            }
+        },
+        "required": [
+            "run_id"
+        ]
+    },
+    "EmbeddingBatchRenditionPageResponse": {
+        "type": "object",
+        "properties": {
+            "status": {
+                "type": "string",
+                "enum": [
+                    "running",
+                    "page_completed",
+                    "completed"
+                ]
+            },
+            "page_index": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "page_scanned": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "page_ready": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "page_generated": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "page_failed": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "running": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            }
+        },
+        "required": [
+            "status",
+            "page_index",
+            "page_scanned",
+            "page_ready",
+            "page_generated",
+            "page_failed",
+            "running"
+        ]
+    },
+    "EmbeddingBatchUpdateRequest": {
+        "type": "object",
+        "properties": {
+            "run_id": {
+                "type": "string"
+            },
+            "state": {
+                "type": "string",
+                "enum": [
+                    "preparing",
+                    "submitted",
+                    "running",
+                    "applying",
+                    "completed",
+                    "completed_with_errors",
+                    "cancelled",
+                    "stale",
+                    "failed"
+                ]
+            },
+            "subjobs": {
+                "type": "array",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "index": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "display_name": {
+                            "type": "string"
+                        },
+                        "input_uri": {
+                            "type": "string"
+                        },
+                        "output_uri": {
+                            "type": "string"
+                        },
+                        "row_count": {
+                            "type": "integer",
+                            "minimum": 0,
+                            "maximum": 9007199254740991
+                        },
+                        "provider_name": {
+                            "type": "string"
+                        },
+                        "state": {
+                            "type": "string",
+                            "enum": [
+                                "pending",
+                                "running",
+                                "succeeded",
+                                "failed",
+                                "cancelled",
+                                "paused"
+                            ]
+                        }
+                    },
+                    "required": [
+                        "index",
+                        "display_name",
+                        "input_uri",
+                        "output_uri",
+                        "row_count"
+                    ],
+                    "additionalProperties": false
+                }
+            },
+            "error_code": {
+                "type": "string"
+            },
+            "error_message": {
+                "type": "string"
+            }
+        },
+        "required": [
+            "run_id",
+            "state"
+        ]
+    },
+    "EmbeddingBatchApplyRequest": {
+        "type": "object",
+        "properties": {
+            "run_id": {
+                "type": "string"
+            }
+        },
+        "required": [
+            "run_id"
+        ]
+    },
+    "EmbeddingBatchApplyResponse": {
+        "type": "object",
+        "properties": {
+            "state": {
+                "type": "string",
+                "enum": [
+                    "preparing",
+                    "submitted",
+                    "running",
+                    "applying",
+                    "completed",
+                    "completed_with_errors",
+                    "cancelled",
+                    "stale",
+                    "failed"
+                ]
+            },
+            "succeeded": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "failed": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "stale": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "applied": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
+            },
+            "failure_counts": {
+                "type": "object",
+                "additionalProperties": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "maximum": 9007199254740991
+                }
+            }
+        },
+        "required": [
+            "state",
+            "succeeded",
+            "failed",
+            "stale",
+            "applied"
+        ]
+    },
     "GenericCommandResponse": {
         "type": "object",
         "properties": {