chore(sdk): sync generated SDK (v1.2.3)

openapi.json

@@ -4524,7 +4524,7 @@
             },
             "type": "array",
             "title": "Environments",
-            "description": "Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none)."
+            "description": "Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools."
           },
           "model": {
             "anyOf": [
@@ -9057,6 +9057,12 @@
             ],
             "title": "Session Id",
             "description": "Connect to an existing workstation session by id instead of starting a new one."
+          },
+          "lazy": {
+            "type": "boolean",
+            "title": "Lazy",
+            "description": "Provision on the agent's first use instead of at startup. Cloud workstations only.",
+            "default": false
           }
         },
         "type": "object",

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hai-agents"
-version = "1.2.2"
+version = "1.2.3"
 description = "Python SDK for H Company's Agents API: autonomous agents powered by Holo."
 requires-python = ">=3.10"
 readme = "README.md"

src/hai_agents/agents/client.py

@@ -126,7 +126,7 @@ def create_agent(
             What the agent does. Parent agents read this to decide when to delegate to it.
 
         environments : typing.Sequence[AgentEnvironmentsItem]
-            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none).
+            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools.
 
         model : typing.Optional[str]
             Model that serves the agent. Defaults to the platform model if omitted.
@@ -254,7 +254,7 @@ def update_agent(
             What the agent does. Parent agents read this to decide when to delegate to it.
 
         environments : typing.Sequence[AgentEnvironmentsItem]
-            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none).
+            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools.
 
         model : typing.Optional[str]
             Model that serves the agent. Defaults to the platform model if omitted.
@@ -531,7 +531,7 @@ async def create_agent(
             What the agent does. Parent agents read this to decide when to delegate to it.
 
         environments : typing.Sequence[AgentEnvironmentsItem]
-            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none).
+            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools.
 
         model : typing.Optional[str]
             Model that serves the agent. Defaults to the platform model if omitted.
@@ -675,7 +675,7 @@ async def update_agent(
             What the agent does. Parent agents read this to decide when to delegate to it.
 
         environments : typing.Sequence[AgentEnvironmentsItem]
-            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none).
+            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools.
 
         model : typing.Optional[str]
             Model that serves the agent. Defaults to the platform model if omitted.

src/hai_agents/agents/raw_client.py

@@ -147,7 +147,7 @@ def create_agent(
             What the agent does. Parent agents read this to decide when to delegate to it.
 
         environments : typing.Sequence[AgentEnvironmentsItem]
-            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none).
+            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools.
 
         model : typing.Optional[str]
             Model that serves the agent. Defaults to the platform model if omitted.
@@ -332,7 +332,7 @@ def update_agent(
             What the agent does. Parent agents read this to decide when to delegate to it.
 
         environments : typing.Sequence[AgentEnvironmentsItem]
-            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none).
+            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools.
 
         model : typing.Optional[str]
             Model that serves the agent. Defaults to the platform model if omitted.
@@ -696,7 +696,7 @@ async def create_agent(
             What the agent does. Parent agents read this to decide when to delegate to it.
 
         environments : typing.Sequence[AgentEnvironmentsItem]
-            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none).
+            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools.
 
         model : typing.Optional[str]
             Model that serves the agent. Defaults to the platform model if omitted.
@@ -881,7 +881,7 @@ async def update_agent(
             What the agent does. Parent agents read this to decide when to delegate to it.
 
         environments : typing.Sequence[AgentEnvironmentsItem]
-            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none).
+            Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools.
 
         model : typing.Optional[str]
             Model that serves the agent. Defaults to the platform model if omitted.

src/hai_agents/core/client_wrapper.py

@@ -29,9 +29,9 @@ def get_headers(self) -> typing.Dict[str, str]:
         import platform
 
         headers: typing.Dict[str, str] = {
-            "User-Agent": "hai_agents/1.2.2",
+            "User-Agent": "hai_agents/1.2.3",
             "X-HCompany-Client-Name": "hai_agents",
-            "X-HCompany-Client-Version": "1.2.2",
+            "X-HCompany-Client-Version": "1.2.3",
             "X-HCompany-Client-Type": "sdk",
             "X-HCompany-Language": "Python",
             "X-HCompany-Runtime": f"python/{platform.python_version()}",

src/hai_agents/environments/types/create_environment_request.py

@@ -78,6 +78,7 @@ class CreateEnvironmentRequest_Workstation(UniversalBaseModel):
     id: str
     host: typing.Optional[WorkstationHost] = None
     session_id: typing.Optional[str] = None
+    lazy: typing.Optional[bool] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

src/hai_agents/environments/types/update_environment_request_body.py

@@ -78,6 +78,7 @@ class UpdateEnvironmentRequestBody_Workstation(UniversalBaseModel):
     id: str
     host: typing.Optional[WorkstationHost] = None
     session_id: typing.Optional[str] = None
+    lazy: typing.Optional[bool] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

src/hai_agents/types/agent.py

@@ -29,7 +29,7 @@ class Agent(UniversalBaseModel):
 
     environments: typing.List[AgentEnvironmentsItem] = pydantic.Field()
     """
-    Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents (a pure orchestrator owns none).
+    Environments the agent runs in. Each entry is a registered environment's id or an inline definition. At most one per kind. Required unless the agent delegates to subagents or uses client-executed custom tools.
     """
 
     model: typing.Optional[str] = pydantic.Field(default=None)

src/hai_agents/types/environment.py

@@ -78,6 +78,7 @@ class Environment_Workstation(UniversalBaseModel):
     id: str
     host: typing.Optional[WorkstationHost] = None
     session_id: typing.Optional[str] = None
+    lazy: typing.Optional[bool] = None
 
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2

src/hai_agents/types/workstation.py

@@ -27,6 +27,11 @@ class Workstation(UniversalBaseModel):
     Connect to an existing workstation session by id instead of starting a new one.
     """
 
+    lazy: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Provision on the agent's first use instead of at startup. Cloud workstations only.
+    """
+
     if IS_PYDANTIC_V2:
         model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
     else: