feat: Define auth secrets and inject them into the environment.

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 14
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-d45cb71aa9505f79b4ad42f50c3528e028508a941068c137393cbf2f54a8dd20.yml
-openapi_spec_hash: 2816d2eedf7d73fdde8a3fbb7bc96336
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-d57dae004e23149ddae4bd26e3ba05c2378d2c1070df0f303b19e45111c780d5.yml
+openapi_spec_hash: 6a15b456e6520a79981fafed3b0c94b9
 config_hash: 40327fb76b7cce7b97f23de9b8d48efb

src/oz_agent_sdk/types/ambient_agent_config.py

@@ -17,6 +17,15 @@ class Harness(BaseModel):
     Default (nil/empty) uses Warp's built-in harness.
     """
 
+    auth_secret_name: Optional[str] = None
+    """Name of a managed secret to use as the authentication credential for the
+    harness.
+
+    The secret must exist within the caller's personal or team scope. The
+    environment variable injected into the agent is determined by the secret type
+    (e.g. ANTHROPIC_API_KEY for anthropic_api_key secrets).
+    """
+
     type: Optional[Literal["oz", "claude"]] = None
     """The harness type identifier.
 

src/oz_agent_sdk/types/ambient_agent_config_param.py

@@ -16,6 +16,15 @@ class Harness(TypedDict, total=False):
     Default (nil/empty) uses Warp's built-in harness.
     """
 
+    auth_secret_name: str
+    """Name of a managed secret to use as the authentication credential for the
+    harness.
+
+    The secret must exist within the caller's personal or team scope. The
+    environment variable injected into the agent is determined by the secret type
+    (e.g. ANTHROPIC_API_KEY for anthropic_api_key secrets).
+    """
+
     type: Literal["oz", "claude"]
     """The harness type identifier.
 

tests/api_resources/agent/test_schedules.py

@@ -40,7 +40,10 @@ def test_method_create_with_all_params(self, client: OzAPI) -> None:
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
-                "harness": {"type": "oz"},
+                "harness": {
+                    "auth_secret_name": "auth_secret_name",
+                    "type": "oz",
+                },
                 "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
@@ -156,7 +159,10 @@ def test_method_update_with_all_params(self, client: OzAPI) -> None:
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
-                "harness": {"type": "oz"},
+                "harness": {
+                    "auth_secret_name": "auth_secret_name",
+                    "type": "oz",
+                },
                 "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
@@ -399,7 +405,10 @@ async def test_method_create_with_all_params(self, async_client: AsyncOzAPI) ->
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
-                "harness": {"type": "oz"},
+                "harness": {
+                    "auth_secret_name": "auth_secret_name",
+                    "type": "oz",
+                },
                 "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
@@ -515,7 +524,10 @@ async def test_method_update_with_all_params(self, async_client: AsyncOzAPI) ->
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
-                "harness": {"type": "oz"},
+                "harness": {
+                    "auth_secret_name": "auth_secret_name",
+                    "type": "oz",
+                },
                 "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {

tests/api_resources/test_agent.py

@@ -123,7 +123,10 @@ def test_method_run_with_all_params(self, client: OzAPI) -> None:
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
-                "harness": {"type": "oz"},
+                "harness": {
+                    "auth_secret_name": "auth_secret_name",
+                    "type": "oz",
+                },
                 "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
@@ -280,7 +283,10 @@ async def test_method_run_with_all_params(self, async_client: AsyncOzAPI) -> Non
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
-                "harness": {"type": "oz"},
+                "harness": {
+                    "auth_secret_name": "auth_secret_name",
+                    "type": "oz",
+                },
                 "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {