structifyai 1.175.0__tar.gz → 1.176.0__tar.gz

structifyai-1.176.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.176.0"
+}

{structifyai-1.175.0 → structifyai-1.176.0}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.176.0 (2026-01-21)
+
+Full Changelog: [v1.175.0...v1.176.0](https://github.com/StructifyAI/structify-python/compare/v1.175.0...v1.176.0)
+
+### Features
+
+* Update from Structify backend changes ([df41996](https://github.com/StructifyAI/structify-python/commit/df4199667d0dc6e89a1d8da5293fb336f45f589d))
+* Update from Structify backend changes ([6f4c3f5](https://github.com/StructifyAI/structify-python/commit/6f4c3f54df3480734d5dad65bfa9c8f21c1bd53a))
+* Update from Structify backend changes ([f1f2640](https://github.com/StructifyAI/structify-python/commit/f1f264096432818d5174e4b2230adfb789e3f29f))
+
 ## 1.175.0 (2026-01-21)
 
 Full Changelog: [v1.174.0...v1.175.0](https://github.com/StructifyAI/structify-python/compare/v1.174.0...v1.175.0)

{structifyai-1.175.0 → structifyai-1.176.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: structifyai
-Version: 1.175.0
+Version: 1.176.0
 Summary: The official Python library for the structify API
 Project-URL: Homepage, https://github.com/StructifyAI/structify-python
 Project-URL: Repository, https://github.com/StructifyAI/structify-python

{structifyai-1.175.0 → structifyai-1.176.0}/api.md

@@ -851,7 +851,6 @@ from structify.types import GetSandboxRequest, Sandbox, SandboxListResponse
 
 Methods:
 
-- <code title="post /sandbox/{chat_id}">client.sandbox.<a href="./src/structify/resources/sandbox.py">create</a>(chat_id, \*\*<a href="src/structify/types/sandbox_create_params.py">params</a>) -> <a href="./src/structify/types/sandbox.py">Sandbox</a></code>
 - <code title="get /sandbox/list/{chat_id}">client.sandbox.<a href="./src/structify/resources/sandbox.py">list</a>(chat_id) -> <a href="./src/structify/types/sandbox_list_response.py">SandboxListResponse</a></code>
 - <code title="post /sandbox/live/{chat_id}">client.sandbox.<a href="./src/structify/resources/sandbox.py">get</a>(chat_id, \*\*<a href="src/structify/types/sandbox_get_params.py">params</a>) -> <a href="./src/structify/types/sandbox.py">Sandbox</a></code>
 - <code title="patch /sandbox/{sandbox_id}/status">client.sandbox.<a href="./src/structify/resources/sandbox.py">update_status</a>(sandbox_id, \*\*<a href="src/structify/types/sandbox_update_status_params.py">params</a>) -> <a href="./src/structify/types/sandbox.py">Sandbox</a></code>

{structifyai-1.175.0 → structifyai-1.176.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "structifyai"
-version = "1.175.0"
+version = "1.176.0"
 description = "The official Python library for the structify API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{structifyai-1.175.0 → structifyai-1.176.0}/src/structify/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "structify"
-__version__ = "1.175.0"  # x-release-please-version
+__version__ = "1.176.0"  # x-release-please-version

{structifyai-1.175.0 → structifyai-1.176.0}/src/structify/resources/sandbox.py

@@ -3,11 +3,10 @@
 from __future__ import annotations
 
 from typing import Optional
-from typing_extensions import Literal
 
 import httpx
 
-from ..types import sandbox_get_params, sandbox_create_params, sandbox_update_status_params
+from ..types import sandbox_get_params, sandbox_update_status_params
 from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -45,54 +44,6 @@ class SandboxResource(SyncAPIResource):
         """
         return SandboxResourceWithStreamingResponse(self)
 
-    def create(
-        self,
-        chat_id: str,
-        *,
-        chat_session_id: str,
-        modal_id: str,
-        modal_url: str,
-        status: Literal["alive", "terminated"],
-        latest_node: Optional[str] | Omit = omit,
-        session_id: Optional[str] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> Sandbox:
-        """
-        Args:
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not chat_id:
-            raise ValueError(f"Expected a non-empty value for `chat_id` but received {chat_id!r}")
-        return self._post(
-            f"/sandbox/{chat_id}",
-            body=maybe_transform(
-                {
-                    "chat_session_id": chat_session_id,
-                    "modal_id": modal_id,
-                    "modal_url": modal_url,
-                    "status": status,
-                    "latest_node": latest_node,
-                    "session_id": session_id,
-                },
-                sandbox_create_params.SandboxCreateParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=Sandbox,
-        )
-
     def list(
         self,
         chat_id: str,
@@ -216,54 +167,6 @@ class AsyncSandboxResource(AsyncAPIResource):
         """
         return AsyncSandboxResourceWithStreamingResponse(self)
 
-    async def create(
-        self,
-        chat_id: str,
-        *,
-        chat_session_id: str,
-        modal_id: str,
-        modal_url: str,
-        status: Literal["alive", "terminated"],
-        latest_node: Optional[str] | Omit = omit,
-        session_id: Optional[str] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> Sandbox:
-        """
-        Args:
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not chat_id:
-            raise ValueError(f"Expected a non-empty value for `chat_id` but received {chat_id!r}")
-        return await self._post(
-            f"/sandbox/{chat_id}",
-            body=await async_maybe_transform(
-                {
-                    "chat_session_id": chat_session_id,
-                    "modal_id": modal_id,
-                    "modal_url": modal_url,
-                    "status": status,
-                    "latest_node": latest_node,
-                    "session_id": session_id,
-                },
-                sandbox_create_params.SandboxCreateParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=Sandbox,
-        )
-
     async def list(
         self,
         chat_id: str,
@@ -373,9 +276,6 @@ class SandboxResourceWithRawResponse:
     def __init__(self, sandbox: SandboxResource) -> None:
         self._sandbox = sandbox
 
-        self.create = to_raw_response_wrapper(
-            sandbox.create,
-        )
         self.list = to_raw_response_wrapper(
             sandbox.list,
         )
@@ -391,9 +291,6 @@ class AsyncSandboxResourceWithRawResponse:
     def __init__(self, sandbox: AsyncSandboxResource) -> None:
         self._sandbox = sandbox
 
-        self.create = async_to_raw_response_wrapper(
-            sandbox.create,
-        )
         self.list = async_to_raw_response_wrapper(
             sandbox.list,
         )
@@ -409,9 +306,6 @@ class SandboxResourceWithStreamingResponse:
     def __init__(self, sandbox: SandboxResource) -> None:
         self._sandbox = sandbox
 
-        self.create = to_streamed_response_wrapper(
-            sandbox.create,
-        )
         self.list = to_streamed_response_wrapper(
             sandbox.list,
         )
@@ -427,9 +321,6 @@ class AsyncSandboxResourceWithStreamingResponse:
     def __init__(self, sandbox: AsyncSandboxResource) -> None:
         self._sandbox = sandbox
 
-        self.create = async_to_streamed_response_wrapper(
-            sandbox.create,
-        )
         self.list = async_to_streamed_response_wrapper(
             sandbox.list,
         )

{structifyai-1.175.0 → structifyai-1.176.0}/src/structify/resources/sessions.py

@@ -483,6 +483,7 @@ class SessionsResource(SyncAPIResource):
         self,
         node_id: str,
         *,
+        operation: Literal["tag", "pdf", "web", "match"],
         row_count: int,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -506,7 +507,11 @@ class SessionsResource(SyncAPIResource):
         return self._post(
             f"/sessions/nodes/{node_id}/request_confirmation",
             body=maybe_transform(
-                {"row_count": row_count}, session_request_confirmation_params.SessionRequestConfirmationParams
+                {
+                    "operation": operation,
+                    "row_count": row_count,
+                },
+                session_request_confirmation_params.SessionRequestConfirmationParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -1145,6 +1150,7 @@ class AsyncSessionsResource(AsyncAPIResource):
         self,
         node_id: str,
         *,
+        operation: Literal["tag", "pdf", "web", "match"],
         row_count: int,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -1168,7 +1174,11 @@ class AsyncSessionsResource(AsyncAPIResource):
         return await self._post(
             f"/sessions/nodes/{node_id}/request_confirmation",
             body=await async_maybe_transform(
-                {"row_count": row_count}, session_request_confirmation_params.SessionRequestConfirmationParams
+                {
+                    "operation": operation,
+                    "row_count": row_count,
+                },
+                session_request_confirmation_params.SessionRequestConfirmationParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout

{structifyai-1.175.0 → structifyai-1.176.0}/src/structify/types/__init__.py

@@ -125,7 +125,6 @@ from .knowledge_graph_param import KnowledgeGraphParam as KnowledgeGraphParam
 from .list_members_response import ListMembersResponse as ListMembersResponse
 from .llm_information_store import LlmInformationStore as LlmInformationStore
 from .project_update_params import ProjectUpdateParams as ProjectUpdateParams
-from .sandbox_create_params import SandboxCreateParams as SandboxCreateParams
 from .sandbox_list_response import SandboxListResponse as SandboxListResponse
 from .update_table_response import UpdateTableResponse as UpdateTableResponse
 from .workflow_session_edge import WorkflowSessionEdge as WorkflowSessionEdge

{structifyai-1.175.0 → structifyai-1.176.0}/src/structify/types/admin/admin_sandbox.py

@@ -17,18 +17,22 @@ class AdminSandbox(BaseModel):
 
     created_at: datetime
 
+    provider: Literal["modal", "daytona"]
+
     sandbox_type: SandboxType
 
     status: Literal["alive", "terminated"]
 
     updated_at: datetime
 
+    api_url: Optional[str] = None
+
     chat_session_id: Optional[str] = None
 
     exploration_run_id: Optional[str] = None
 
     latest_node: Optional[str] = None
 
-    modal_id: Optional[str] = None
+    provider_id: Optional[str] = None
 
-    modal_url: Optional[str] = None
+    tunnel_url: Optional[str] = None

{structifyai-1.175.0 → structifyai-1.176.0}/src/structify/types/sandbox.py

@@ -16,14 +16,18 @@ class Sandbox(BaseModel):
 
     created_at: datetime
 
-    modal_id: str
+    provider: Literal["modal", "daytona"]
 
-    modal_url: str
+    provider_id: str
 
     status: Literal["alive", "terminated"]
 
+    tunnel_url: str
+
     updated_at: datetime
 
+    api_url: Optional[str] = None
+
     latest_node: Optional[str] = None
 
     session_id: Optional[str] = None

{structifyai-1.175.0 → structifyai-1.176.0}/src/structify/types/session_request_confirmation_params.py

@@ -2,10 +2,12 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, TypedDict
+from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["SessionRequestConfirmationParams"]
 
 
 class SessionRequestConfirmationParams(TypedDict, total=False):
+    operation: Required[Literal["tag", "pdf", "web", "match"]]
+
     row_count: Required[int]

{structifyai-1.175.0 → structifyai-1.176.0}/src/structify/types/team.py

@@ -21,6 +21,8 @@ class Team(BaseModel):
 
     pipedream_project_id: Optional[str] = None
 
+    sandbox_provider: Optional[str] = None
+
     slack_team_icon: Optional[str] = None
 
     slack_team_id: Optional[str] = None

{structifyai-1.175.0 → structifyai-1.176.0}/tests/api_resources/test_sandbox.py

@@ -9,10 +9,7 @@ import pytest
 
 from structify import Structify, AsyncStructify
 from tests.utils import assert_matches_type
-from structify.types import (
-    Sandbox,
-    SandboxListResponse,
-)
+from structify.types import Sandbox, SandboxListResponse
 
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 
@@ -20,73 +17,6 @@ base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 class TestSandbox:
     parametrize = pytest.mark.parametrize("client", [False, True], indirect=True, ids=["loose", "strict"])
 
-    @parametrize
-    def test_method_create(self, client: Structify) -> None:
-        sandbox = client.sandbox.create(
-            chat_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            modal_id="modal_id",
-            modal_url="modal_url",
-            status="alive",
-        )
-        assert_matches_type(Sandbox, sandbox, path=["response"])
-
-    @parametrize
-    def test_method_create_with_all_params(self, client: Structify) -> None:
-        sandbox = client.sandbox.create(
-            chat_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            modal_id="modal_id",
-            modal_url="modal_url",
-            status="alive",
-            latest_node="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-        )
-        assert_matches_type(Sandbox, sandbox, path=["response"])
-
-    @parametrize
-    def test_raw_response_create(self, client: Structify) -> None:
-        response = client.sandbox.with_raw_response.create(
-            chat_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            modal_id="modal_id",
-            modal_url="modal_url",
-            status="alive",
-        )
-
-        assert response.is_closed is True
-        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
-        sandbox = response.parse()
-        assert_matches_type(Sandbox, sandbox, path=["response"])
-
-    @parametrize
-    def test_streaming_response_create(self, client: Structify) -> None:
-        with client.sandbox.with_streaming_response.create(
-            chat_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            modal_id="modal_id",
-            modal_url="modal_url",
-            status="alive",
-        ) as response:
-            assert not response.is_closed
-            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
-
-            sandbox = response.parse()
-            assert_matches_type(Sandbox, sandbox, path=["response"])
-
-        assert cast(Any, response.is_closed) is True
-
-    @parametrize
-    def test_path_params_create(self, client: Structify) -> None:
-        with pytest.raises(ValueError, match=r"Expected a non-empty value for `chat_id` but received ''"):
-            client.sandbox.with_raw_response.create(
-                chat_id="",
-                chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-                modal_id="modal_id",
-                modal_url="modal_url",
-                status="alive",
-            )
-
     @parametrize
     def test_method_list(self, client: Structify) -> None:
         sandbox = client.sandbox.list(
@@ -219,73 +149,6 @@ class TestAsyncSandbox:
         "async_client", [False, True, {"http_client": "aiohttp"}], indirect=True, ids=["loose", "strict", "aiohttp"]
     )
 
-    @parametrize
-    async def test_method_create(self, async_client: AsyncStructify) -> None:
-        sandbox = await async_client.sandbox.create(
-            chat_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            modal_id="modal_id",
-            modal_url="modal_url",
-            status="alive",
-        )
-        assert_matches_type(Sandbox, sandbox, path=["response"])
-
-    @parametrize
-    async def test_method_create_with_all_params(self, async_client: AsyncStructify) -> None:
-        sandbox = await async_client.sandbox.create(
-            chat_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            modal_id="modal_id",
-            modal_url="modal_url",
-            status="alive",
-            latest_node="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-        )
-        assert_matches_type(Sandbox, sandbox, path=["response"])
-
-    @parametrize
-    async def test_raw_response_create(self, async_client: AsyncStructify) -> None:
-        response = await async_client.sandbox.with_raw_response.create(
-            chat_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            modal_id="modal_id",
-            modal_url="modal_url",
-            status="alive",
-        )
-
-        assert response.is_closed is True
-        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
-        sandbox = await response.parse()
-        assert_matches_type(Sandbox, sandbox, path=["response"])
-
-    @parametrize
-    async def test_streaming_response_create(self, async_client: AsyncStructify) -> None:
-        async with async_client.sandbox.with_streaming_response.create(
-            chat_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            modal_id="modal_id",
-            modal_url="modal_url",
-            status="alive",
-        ) as response:
-            assert not response.is_closed
-            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
-
-            sandbox = await response.parse()
-            assert_matches_type(Sandbox, sandbox, path=["response"])
-
-        assert cast(Any, response.is_closed) is True
-
-    @parametrize
-    async def test_path_params_create(self, async_client: AsyncStructify) -> None:
-        with pytest.raises(ValueError, match=r"Expected a non-empty value for `chat_id` but received ''"):
-            await async_client.sandbox.with_raw_response.create(
-                chat_id="",
-                chat_session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-                modal_id="modal_id",
-                modal_url="modal_url",
-                status="alive",
-            )
-
     @parametrize
     async def test_method_list(self, async_client: AsyncStructify) -> None:
         sandbox = await async_client.sandbox.list(

{structifyai-1.175.0 → structifyai-1.176.0}/tests/api_resources/test_sessions.py

@@ -604,6 +604,7 @@ class TestSessions:
     def test_method_request_confirmation(self, client: Structify) -> None:
         session = client.sessions.request_confirmation(
             node_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            operation="tag",
             row_count=0,
         )
         assert_matches_type(WorkflowSessionNode, session, path=["response"])
@@ -612,6 +613,7 @@ class TestSessions:
     def test_raw_response_request_confirmation(self, client: Structify) -> None:
         response = client.sessions.with_raw_response.request_confirmation(
             node_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            operation="tag",
             row_count=0,
         )
 
@@ -624,6 +626,7 @@ class TestSessions:
     def test_streaming_response_request_confirmation(self, client: Structify) -> None:
         with client.sessions.with_streaming_response.request_confirmation(
             node_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            operation="tag",
             row_count=0,
         ) as response:
             assert not response.is_closed
@@ -639,6 +642,7 @@ class TestSessions:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `node_id` but received ''"):
             client.sessions.with_raw_response.request_confirmation(
                 node_id="",
+                operation="tag",
                 row_count=0,
             )
 
@@ -1521,6 +1525,7 @@ class TestAsyncSessions:
     async def test_method_request_confirmation(self, async_client: AsyncStructify) -> None:
         session = await async_client.sessions.request_confirmation(
             node_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            operation="tag",
             row_count=0,
         )
         assert_matches_type(WorkflowSessionNode, session, path=["response"])
@@ -1529,6 +1534,7 @@ class TestAsyncSessions:
     async def test_raw_response_request_confirmation(self, async_client: AsyncStructify) -> None:
         response = await async_client.sessions.with_raw_response.request_confirmation(
             node_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            operation="tag",
             row_count=0,
         )
 
@@ -1541,6 +1547,7 @@ class TestAsyncSessions:
     async def test_streaming_response_request_confirmation(self, async_client: AsyncStructify) -> None:
         async with async_client.sessions.with_streaming_response.request_confirmation(
             node_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            operation="tag",
             row_count=0,
         ) as response:
             assert not response.is_closed
@@ -1556,6 +1563,7 @@ class TestAsyncSessions:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `node_id` but received ''"):
             await async_client.sessions.with_raw_response.request_confirmation(
                 node_id="",
+                operation="tag",
                 row_count=0,
             )
 

structifyai-1.175.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "1.175.0"
-}

structifyai-1.175.0/src/structify/types/sandbox_create_params.py

@@ -1,22 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from __future__ import annotations
-
-from typing import Optional
-from typing_extensions import Literal, Required, TypedDict
-
-__all__ = ["SandboxCreateParams"]
-
-
-class SandboxCreateParams(TypedDict, total=False):
-    chat_session_id: Required[str]
-
-    modal_id: Required[str]
-
-    modal_url: Required[str]
-
-    status: Required[Literal["alive", "terminated"]]
-
-    latest_node: Optional[str]
-
-    session_id: Optional[str]