From 5b9536e1aee493ff861f7147d0962e8bcb1d58cc Mon Sep 17 00:00:00 2001
From: Gracjan Sadowicz <gracjan@ravendb.net>
Date: Tue, 27 Jan 2026 16:36:32 +0100
Subject: [PATCH] RDBC-1012 Implement AiAgentToolQueryOptions

---
 .../ai/agents/ai_agent_configuration.py       | 29 ++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/ravendb/documents/operations/ai/agents/ai_agent_configuration.py b/ravendb/documents/operations/ai/agents/ai_agent_configuration.py
index b460987b..07b1d6d4 100644
--- a/ravendb/documents/operations/ai/agents/ai_agent_configuration.py
+++ b/ravendb/documents/operations/ai/agents/ai_agent_configuration.py
@@ -60,21 +60,27 @@ def __init__(
         query: str = None,
         parameters_sample_object: str = None,
         parameters_schema: str = None,
+        options: AiAgentToolQueryOptions = None,
     ):
         self.name = name
         self.description = description
         self.query = query
         self.parameters_sample_object: Optional[str] = parameters_sample_object
         self.parameters_schema: Optional[str] = parameters_schema
+        self.options = options
 
     def to_json(self) -> Dict[str, Any]:
-        return {
+        json_dict = {
             "Name": self.name,
             "Description": self.description,
             "Query": self.query,
             "ParametersSampleObject": self.parameters_sample_object,
             "ParametersSchema": self.parameters_schema,
         }
+        if self.options:
+            json_dict["Options"] = self.options.to_json()
+
+        return json_dict
 
     @classmethod
     def from_json(cls, json_dict: Dict[str, Any]) -> AiAgentToolQuery:
@@ -86,6 +92,8 @@ def from_json(cls, json_dict: Dict[str, Any]) -> AiAgentToolQuery:
             "ParametersSampleObject"
         )
         instance.parameters_schema = json_dict.get("parametersSchema") or json_dict.get("ParametersSchema")
+        if options := json_dict.get("Options"):
+            instance.options = AiAgentToolQueryOptions.from_json(options)
         return instance
 
 
@@ -384,3 +392,22 @@ def from_json(cls, json_dict: Dict[str, Any]) -> AiAgentConfiguration:
             "MaxModelIterationsPerCall"
         )
         return instance
+
+
+class AiAgentToolQueryOptions:
+    def __init__(self, allow_model_queries: bool = None, add_to_initial_context: bool = None):
+        self.allow_model_queries = allow_model_queries
+        self.add_to_initial_context = add_to_initial_context
+
+    def to_json(self) -> Dict[str, Any]:
+        return {
+            "AllowModelQueries": self.allow_model_queries,
+            "AddToInitialContext": self.add_to_initial_context,
+        }
+
+    @classmethod
+    def from_json(cls, json_dict: Dict[str, Any]) -> AiAgentToolQueryOptions:
+        return cls(
+            allow_model_queries=json_dict["AllowModelQueries"],
+            add_to_initial_context=json_dict["AddToInitialContext"],
+        )