arkruntime 0.1.0__py3-none-any.whl

arkruntime/types/session/managed_agents_user_tool_result_event_params.py

@@ -0,0 +1,44 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import List, Literal, Optional
+
+from arkruntime._models import BaseModel
+
+from .managed_agents_tool_result_content_block import (
+    ManagedAgentsToolResultContentBlock,
+)
+
+
+class ManagedAgentsUserToolResultEventParams(BaseModel):
+    """
+    `user.tool_result`：客户端侧执行完 MCP / local tool 后回报结果。
+    `tool_use_id` 关联此前 agent.tool_use；`is_error=true` 表示工具失败。
+    """
+
+    tool_use_id: str
+    """
+    关联的 tool_use_id。
+    """
+    content: Optional[List[ManagedAgentsToolResultContentBlock]] = None
+    """
+    工具输出的多模态 block 列表。
+    """
+    is_error: Optional[bool] = None
+    """
+    工具是否失败。
+    """
+    session_id: Optional[str] = None
+    """
+    目标 session id。
+    """
+    session_thread_id: Optional[str] = None
+    """
+    目标 session_thread_id。
+    """
+    type: Literal["user.tool_result"]

arkruntime/types/session/plain_text_document_source.py

@@ -0,0 +1,27 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Literal
+
+from arkruntime._models import BaseModel
+
+
+class PlainTextDocumentSource(BaseModel):
+    """
+    纯文本文档；`media_type` 必须为 `text/plain`；`data` 是原文。
+    """
+
+    data: str
+    """
+    文档原文。
+    """
+    media_type: str
+    """
+    MIME 类型，固定 `text/plain`。
+    """
+    type: Literal["text"]

arkruntime/types/session/search_result_citations.py

@@ -0,0 +1,20 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from arkruntime._models import BaseModel
+
+
+class SearchResultCitations(BaseModel):
+    """
+    搜索结果 citation 控制——是否在最终回答中显式标注引用。
+    """
+
+    enabled: bool
+    """
+    是否启用 citation。
+    """

arkruntime/types/session/search_result_content.py

@@ -0,0 +1,20 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from arkruntime._models import BaseModel
+
+
+class SearchResultContent(BaseModel):
+    """
+    搜索结果内的纯文本片段。
+    """
+
+    text: str
+    """
+    文本内容。
+    """

arkruntime/types/session/send_session_events_request.py

@@ -0,0 +1,24 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import List
+
+from arkruntime._models import BaseModel
+
+from .managed_agents_event_params import ManagedAgentsEventParams
+
+
+class SendSessionEventsRequest(BaseModel):
+    """
+    SendSessionEvents 请求体。
+    """
+
+    events: List[ManagedAgentsEventParams]
+    """
+    事件列表；按 `type` 路由到具体事件类型。
+    """

arkruntime/types/session/send_session_events_response.py

@@ -0,0 +1,22 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Optional
+
+from arkruntime._models import BaseModel
+
+
+class SendSessionEventsResponse(BaseModel):
+    """
+    SendSessionEvents 响应体（回执）。
+    """
+
+    success: Optional[bool] = None
+    """
+    是否成功接收（server 决定语义）。
+    """

arkruntime/types/session/session.py

@@ -0,0 +1,80 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Dict, List, Literal, Optional
+
+from arkruntime._models import BaseModel
+
+from .session_resource import SessionResource
+from .session_status import SessionStatus
+from .session_usage import SessionUsage
+from .tag import Tag
+
+
+class Session(BaseModel):
+    """
+    一次 Agent 会话。
+
+    `agent` 字段是创建时刻的 Agent 快照（同 `Ark.Agent` 命名空间下 Agent 的
+    wire shape）。为保持本模块自足，此处用 `Record<unknown>` 承载；SDK 侧
+    需要强类型时可自行反序列化到 agent 包的 `Agent`。
+    """
+
+    id: str
+    """
+    Session ID。
+    """
+    type: Literal["session"]
+    """
+    固定 `"session"`。
+    """
+    status: SessionStatus
+    """
+    会话运行状态。
+    """
+    environment_id: str
+    """
+    关联的 Environment ID。
+    """
+    agent: Dict[str, object]
+    """
+    Agent 快照。反映创建瞬间的 Agent wire 形态；shape 与 Ark.Agent 的
+    Agent 一致。
+    """
+    created_at: str
+    """
+    RFC 3339 时间。
+    """
+    updated_at: str
+    """
+    RFC 3339 时间。
+    """
+    archived_at: Optional[str] = None
+    """
+    归档时间（RFC 3339）；未归档时缺省。
+    """
+    title: Optional[str] = None
+    """
+    会话人类可读标题。
+    """
+    resources: Optional[List[SessionResource]] = None
+    """
+    挂载资源列表。
+    """
+    vault_ids: Optional[List[str]] = None
+    """
+    会话可访问的 Vault ID 列表。
+    """
+    usage: Optional[SessionUsage] = None
+    """
+    累计 token / 缓存用量。
+    """
+    tags: Optional[List[Tag]] = None
+    """
+    资源标签。
+    """

arkruntime/types/session/session_resource.py

@@ -0,0 +1,70 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from typing import Optional
+
+from arkruntime._models import BaseModel
+
+from .session_resource_access import SessionResourceAccess
+from .session_resource_type import SessionResourceType
+
+
+class SessionResource(BaseModel):
+    """
+    会话挂载的资源。按 `type` 决定字段：
+    - `file` → `file_id`
+    - `memory_store` → `memory_store_id` + `access`
+    - `tos` → `tos_bucket` + `tos_key` + 可选 `tos_region`
+
+    `mount_path` 描述在 sandbox 中的挂载点，各类型都可用。
+    """
+
+    id: Optional[str] = None
+    """
+    SessionResource ID。
+    """
+    type: SessionResourceType
+    """
+    资源类型。
+    """
+    file_id: Optional[str] = None
+    """
+    `file` 类型：已注册的文件 ID。
+    """
+    memory_store_id: Optional[str] = None
+    """
+    `memory_store` 类型：挂载的 MemoryStore ID。
+    """
+    access: Optional[SessionResourceAccess] = None
+    """
+    `memory_store` 类型：访问权限。
+    """
+    mount_path: Optional[str] = None
+    """
+    在 sandbox 中的挂载路径。
+    """
+    created_at: Optional[str] = None
+    """
+    RFC 3339 时间。
+    """
+    updated_at: Optional[str] = None
+    """
+    RFC 3339 时间。
+    """
+    tos_bucket: Optional[str] = None
+    """
+    `tos` 类型：TOS bucket。
+    """
+    tos_key: Optional[str] = None
+    """
+    `tos` 类型：TOS 对象 key。
+    """
+    tos_region: Optional[str] = None
+    """
+    `tos` 类型：TOS 区域，可选。
+    """

arkruntime/types/session/session_resource_access.py

@@ -0,0 +1,18 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from enum import Enum
+
+
+class SessionResourceAccess(str, Enum):
+    """
+    MemoryStore 挂载访问权限。
+    """
+
+    read_only = "read_only"
+    read_write = "read_write"

arkruntime/types/session/session_resource_type.py

@@ -0,0 +1,19 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from enum import Enum
+
+
+class SessionResourceType(str, Enum):
+    """
+    SessionResource 子类型。
+    """
+
+    file = "file"
+    memory_store = "memory_store"
+    tos = "tos"

arkruntime/types/session/session_status.py

@@ -0,0 +1,20 @@
+# Generated by datamodel-code-generator from ark-apis typespec/openapi.
+# DO NOT EDIT — regenerate with `make gen-py-<api>` in ark-apis.
+#
+# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates.
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+from enum import Enum
+
+
+class SessionStatus(str, Enum):
+    """
+    Session runtime 状态。
+    """
+
+    idle = "idle"
+    running = "running"
+    terminated = "terminated"
+    rescheduling = "rescheduling"