From e66b56ad518ba045b9446c33a86b1a41345b464c Mon Sep 17 00:00:00 2001 From: "ark-hand[bot]" Date: Wed, 16 Sep 2026 02:59:24 +0000 Subject: [PATCH] chore: sync from ark-apis a103b7cd7b Auto-generated SDK sync from ark-apis at a103b7cd7b71ec5a1d4377819cccaf1d8e361323. Generated files are overwritten by the sync pipeline and should not be edited by hand. Sync-Source-Commit: d73ec708dfed1ec1b5fa955783a73cfdfc81debf Ark-APIs-Commit: a103b7cd7b71ec5a1d4377819cccaf1d8e361323 Release-Version: 0.9.0 --- VERSION | 2 +- pyproject.toml | 2 +- src/arkruntime/types/session/__init__.py | 24 ++++++ .../types/session/checkpoint_component.py | 50 +++++++++++++ .../session/checkpoint_component_status.py | 20 +++++ .../session/checkpoint_restore_config.py | 33 +++++++++ .../session/checkpoint_session_snapshot.py | 49 ++++++++++++ .../types/session/checkpoint_status.py | 21 ++++++ .../create_session_checkpoint_request.py | 21 ++++++ .../create_session_checkpoint_response.py | 22 ++++++ .../types/session/create_session_request.py | 34 +++++++-- .../delete_session_checkpoint_response.py | 26 +++++++ .../get_session_checkpoint_response.py | 22 ++++++ .../list_session_checkpoints_response.py | 28 +++++++ .../types/session/model_overrides.py | 41 +++++++++- .../types/session/override_token_limits.py | 37 ++++++++++ .../types/session/session_checkpoint.py | 74 +++++++++++++++++++ uv.lock | 2 +- 18 files changed, 498 insertions(+), 10 deletions(-) create mode 100644 src/arkruntime/types/session/checkpoint_component.py create mode 100644 src/arkruntime/types/session/checkpoint_component_status.py create mode 100644 src/arkruntime/types/session/checkpoint_restore_config.py create mode 100644 src/arkruntime/types/session/checkpoint_session_snapshot.py create mode 100644 src/arkruntime/types/session/checkpoint_status.py create mode 100644 src/arkruntime/types/session/create_session_checkpoint_request.py create mode 100644 src/arkruntime/types/session/create_session_checkpoint_response.py create mode 100644 src/arkruntime/types/session/delete_session_checkpoint_response.py create mode 100644 src/arkruntime/types/session/get_session_checkpoint_response.py create mode 100644 src/arkruntime/types/session/list_session_checkpoints_response.py create mode 100644 src/arkruntime/types/session/override_token_limits.py create mode 100644 src/arkruntime/types/session/session_checkpoint.py diff --git a/VERSION b/VERSION index a3df0a6..ac39a10 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.8.0 +0.9.0 diff --git a/pyproject.toml b/pyproject.toml index 8fbfec9..ad1129d 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "arkruntime" -version = "0.8.0" +version = "0.9.0" description = "Ark runtime SDK for Python" readme = "README.md" requires-python = ">=3.8" diff --git a/src/arkruntime/types/session/__init__.py b/src/arkruntime/types/session/__init__.py index d46dfee..e5dd02c 100644 --- a/src/arkruntime/types/session/__init__.py +++ b/src/arkruntime/types/session/__init__.py @@ -12,9 +12,17 @@ from .base64_document_source import Base64DocumentSource from .base64_image_source import Base64ImageSource from .cache_creation import CacheCreation +from .checkpoint_component import CheckpointComponent +from .checkpoint_component_status import CheckpointComponentStatus +from .checkpoint_restore_config import CheckpointRestoreConfig +from .checkpoint_session_snapshot import CheckpointSessionSnapshot +from .checkpoint_status import CheckpointStatus +from .create_session_checkpoint_request import CreateSessionCheckpointRequest +from .create_session_checkpoint_response import CreateSessionCheckpointResponse from .create_session_request import CreateSessionRequest from .create_session_resource_request import CreateSessionResourceRequest from .create_session_upgrade_request import CreateSessionUpgradeRequest +from .delete_session_checkpoint_response import DeleteSessionCheckpointResponse from .delete_session_response import DeleteSessionResponse from .document_source import DocumentSource from .environment_config_override import EnvironmentConfigOverride @@ -25,7 +33,9 @@ from .environment_with_upgrades import EnvironmentWithUpgrades from .file_document_source import FileDocumentSource from .file_image_source import FileImageSource +from .get_session_checkpoint_response import GetSessionCheckpointResponse from .image_source import ImageSource +from .list_session_checkpoints_response import ListSessionCheckpointsResponse from .list_session_events_response_wire import ListSessionEventsResponseWire from .list_session_resources_response import ListSessionResourcesResponse from .list_session_threads_response import ListSessionThreadsResponse @@ -76,12 +86,14 @@ ) from .model_overrides import ModelOverrides from .model_upgrades import ModelUpgrades +from .override_token_limits import OverrideTokenLimits from .plain_text_document_source import PlainTextDocumentSource from .search_result_citations import SearchResultCitations from .search_result_content import SearchResultContent from .send_session_events_request import SendSessionEventsRequest from .send_session_events_response import SendSessionEventsResponse from .session import Session +from .session_checkpoint import SessionCheckpoint from .session_resource import SessionResource from .session_resource_access import SessionResourceAccess from .session_resource_type import SessionResourceType @@ -102,9 +114,17 @@ "Base64DocumentSource", "Base64ImageSource", "CacheCreation", + "CheckpointComponent", + "CheckpointComponentStatus", + "CheckpointRestoreConfig", + "CheckpointSessionSnapshot", + "CheckpointStatus", + "CreateSessionCheckpointRequest", + "CreateSessionCheckpointResponse", "CreateSessionRequest", "CreateSessionResourceRequest", "CreateSessionUpgradeRequest", + "DeleteSessionCheckpointResponse", "DeleteSessionResponse", "DocumentSource", "EnvironmentConfigOverride", @@ -115,7 +135,9 @@ "EnvironmentWithUpgrades", "FileDocumentSource", "FileImageSource", + "GetSessionCheckpointResponse", "ImageSource", + "ListSessionCheckpointsResponse", "ListSessionEventsResponseWire", "ListSessionResourcesResponse", "ListSessionThreadsResponse", @@ -150,12 +172,14 @@ "ManagedAgentsUserToolResultEventParams", "ModelOverrides", "ModelUpgrades", + "OverrideTokenLimits", "PlainTextDocumentSource", "SearchResultCitations", "SearchResultContent", "SendSessionEventsRequest", "SendSessionEventsResponse", "Session", + "SessionCheckpoint", "SessionResource", "SessionResourceAccess", "SessionResourceType", diff --git a/src/arkruntime/types/session/checkpoint_component.py b/src/arkruntime/types/session/checkpoint_component.py new file mode 100644 index 0000000..29ec2a9 --- /dev/null +++ b/src/arkruntime/types/session/checkpoint_component.py @@ -0,0 +1,50 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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 .checkpoint_component_status import CheckpointComponentStatus + + +class CheckpointComponent(BaseModel): + """ + Checkpoint 中单个资源组件的脱敏执行摘要。 + + 不暴露运行时 Snapshot ID、平台 TOS Prefix、Credential 等内部信息。 + """ + + type: str + """ + 组件类型。 + """ + status: CheckpointComponentStatus + """ + 组件快照状态。 + """ + source_resource_id: Optional[str] = None + """ + 源资源 ID。 + """ + object_count: Optional[int] = None + """ + 快照对象数。 + """ + storage_bytes: Optional[int] = None + """ + 快照占用字节数。 + """ + error_code: Optional[str] = None + """ + 失败错误码。 + """ + error_message: Optional[str] = None + """ + 失败错误信息。 + """ diff --git a/src/arkruntime/types/session/checkpoint_component_status.py b/src/arkruntime/types/session/checkpoint_component_status.py new file mode 100644 index 0000000..ce1f74b --- /dev/null +++ b/src/arkruntime/types/session/checkpoint_component_status.py @@ -0,0 +1,20 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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 CheckpointComponentStatus(str, Enum): + """ + 单个 Checkpoint 组件（资源快照分区）的状态。 + """ + + creating = "creating" + ready = "ready" + failed = "failed" + deleted = "deleted" diff --git a/src/arkruntime/types/session/checkpoint_restore_config.py b/src/arkruntime/types/session/checkpoint_restore_config.py new file mode 100644 index 0000000..8ef70c5 --- /dev/null +++ b/src/arkruntime/types/session/checkpoint_restore_config.py @@ -0,0 +1,33 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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 CheckpointRestoreConfig(BaseModel): + """ + 跨账号 Checkpoint 恢复的目标账号侧配置。 + + 是否提供分三种情况： + - 同账号恢复：**必须省略**，携带返回 400； + - 跨账号恢复但 Checkpoint 不含 customer TOS 数据（仅平台托管的 + uploads/outputs/memory 等）：**必须省略**，携带返回 400，错误码 + 消息为 "checkpoint_restore_config is only allowed when the + checkpoint contains customer TOS data"； + - 跨账号恢复且 Checkpoint 包含 customer TOS 数据：**必填** + `tos_bucket`，声明调用方已离线同步好快照的目标账号 TOS 桶； + 省略返回 400。 + + 快照源 prefix、region、mount_path、access 均从 Checkpoint 继承， + 最终 Session 目标 key 由平台生成。 + """ + + tos_bucket: str + """ + 调用方已将 customer TOS 快照同步到的目标账号 TOS 桶。 + """ diff --git a/src/arkruntime/types/session/checkpoint_session_snapshot.py b/src/arkruntime/types/session/checkpoint_session_snapshot.py new file mode 100644 index 0000000..e8bc25a --- /dev/null +++ b/src/arkruntime/types/session/checkpoint_session_snapshot.py @@ -0,0 +1,49 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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, Optional + +from arkruntime._models import BaseModel + +from .session_resource import SessionResource +from .tag import Tag + + +class CheckpointSessionSnapshot(BaseModel): + """ + 创建 Checkpoint 时冻结的用户可见 Session 配置。 + + `agent` / `environment` 反映创建瞬间的 wire 形态（分别与 Ark.Agent 的 + Agent、Ark.Environment 的 Environment 同 shape），为保持本模块自足， + 此处承载为 `Record`。 + """ + + agent: Optional[Dict[str, object]] = None + """ + 冻结的 Agent 快照。 + """ + environment: Optional[Dict[str, object]] = None + """ + 冻结的 Environment 快照。 + """ + resources: Optional[List[SessionResource]] = None + """ + 冻结的挂载资源列表。 + """ + vault_ids: Optional[List[str]] = None + """ + 冻结的可访问 Vault ID 列表。 + """ + title: Optional[str] = None + """ + 冻结的会话标题。 + """ + tags: Optional[List[Tag]] = None + """ + 冻结的资源标签。 + """ diff --git a/src/arkruntime/types/session/checkpoint_status.py b/src/arkruntime/types/session/checkpoint_status.py new file mode 100644 index 0000000..a4aa495 --- /dev/null +++ b/src/arkruntime/types/session/checkpoint_status.py @@ -0,0 +1,21 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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 CheckpointStatus(str, Enum): + """ + Checkpoint 生命周期状态。 + """ + + creating = "creating" + ready = "ready" + failed = "failed" + deleting = "deleting" + deleted = "deleted" diff --git a/src/arkruntime/types/session/create_session_checkpoint_request.py b/src/arkruntime/types/session/create_session_checkpoint_request.py new file mode 100644 index 0000000..b6b17f9 --- /dev/null +++ b/src/arkruntime/types/session/create_session_checkpoint_request.py @@ -0,0 +1,21 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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 CreateSessionCheckpointRequest(BaseModel): + """ + 创建 Session Checkpoint 的请求体。 + """ + + name: str + """ + Checkpoint 名称；由调用方提供，长度 1–128，仅用于展示。 + Checkpoint ID 由平台生成并在响应的 `id` 字段返回。 + """ diff --git a/src/arkruntime/types/session/create_session_checkpoint_response.py b/src/arkruntime/types/session/create_session_checkpoint_response.py new file mode 100644 index 0000000..e867f26 --- /dev/null +++ b/src/arkruntime/types/session/create_session_checkpoint_response.py @@ -0,0 +1,22 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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 + +from .session_checkpoint import SessionCheckpoint + + +class CreateSessionCheckpointResponse(BaseModel): + """ + `POST /sessions/{session_id}/checkpoints` 响应体。 + """ + + checkpoint: SessionCheckpoint + """ + 创建出的 Checkpoint。 + """ diff --git a/src/arkruntime/types/session/create_session_request.py b/src/arkruntime/types/session/create_session_request.py index 0df50ff..88e6ec5 100644 --- a/src/arkruntime/types/session/create_session_request.py +++ b/src/arkruntime/types/session/create_session_request.py @@ -11,6 +11,7 @@ from arkruntime._models import BaseModel from .agent_identifier import AgentIdentifier +from .checkpoint_restore_config import CheckpointRestoreConfig from .environment_with_overrides import EnvironmentWithOverrides from .session_resource import SessionResource from .tag import Tag @@ -25,13 +26,21 @@ class CreateSessionRequest(BaseModel): - AgentRef 对象：`{"type":"agent","id":"agent_...","version":1}` """ - agent: AgentIdentifier + agent: Optional[AgentIdentifier] = None """ - Agent 标识。 + Agent 标识。普通创建必填；携带 `checkpoint_id` 恢复时可省略。 + + 注意两种恢复基线的区别： + - **省略 `agent`**：完整继承 Checkpoint 冻结的 Agent 快照（含其 + system / tools / model 接入配置等全部字段）； + - **显式提供 `agent`**：不是在 Checkpoint 快照上做局部修改，而是按 + Agent 引用重新解析（指定 `version` 取该版本，省略取当前最新版； + 源 Agent 在 Checkpoint 冻结后更新过就会拿到新配置），再在该基线 + 上应用 `agent_with_overrides` 覆写。 """ environment_id: Optional[str] = None """ - 关联的 Environment ID。与 `environment` 二选一。 + 关联的 Environment ID。与 `environment` 二选一；恢复时省略则继承快照。 """ environment: Optional[EnvironmentWithOverrides] = None """ @@ -43,7 +52,8 @@ class CreateSessionRequest(BaseModel): """ resources: Optional[List[SessionResource]] = None """ - 挂载资源列表。 + 挂载资源列表。普通创建可指定；基于 Checkpoint 恢复时**必须省略** + （同账号 / 跨账号都完整继承 Checkpoint 资源，显式传空数组也返回 400）。 """ title: Optional[str] = None """ @@ -51,5 +61,19 @@ class CreateSessionRequest(BaseModel): """ vault_ids: Optional[List[str]] = None """ - 会话可访问的 Vault ID 列表。 + 会话可访问的 Vault ID 列表。基于 Checkpoint 同账号恢复时必须省略并 + 继承快照；跨账号恢复允许显式提供完整替换列表（空数组同样属于覆盖）。 + """ + checkpoint_id: Optional[str] = None + """ + Session Checkpoint ID。省略时为普通创建；传入时以 ready 状态 + Checkpoint 的冻结配置为默认值创建新 Session，未显式提供的字段均从 + 快照继承。Checkpoint 不存在 / 非 ready 返回对应 4xx。 + """ + checkpoint_restore_config: Optional[CheckpointRestoreConfig] = None + """ + 跨账号 customer TOS 恢复配置。**不是所有跨账号恢复都需要**：仅当跨 + 账号恢复且 Checkpoint 含 customer TOS 数据时必填；同账号恢复、以及 + 跨账号但不含 customer TOS 时必须省略，否则返回 400。三分支细则见 + `CheckpointRestoreConfig`。 """ diff --git a/src/arkruntime/types/session/delete_session_checkpoint_response.py b/src/arkruntime/types/session/delete_session_checkpoint_response.py new file mode 100644 index 0000000..a97b2ad --- /dev/null +++ b/src/arkruntime/types/session/delete_session_checkpoint_response.py @@ -0,0 +1,26 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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 + +from .checkpoint_status import CheckpointStatus + + +class DeleteSessionCheckpointResponse(BaseModel): + """ + `DELETE /checkpoints/{checkpoint_id}` 响应体。 + """ + + id: str + """ + 被删除的 Checkpoint ID。 + """ + status: CheckpointStatus + """ + 删除受理后的 Checkpoint 状态（通常为 `"deleting"`）。 + """ diff --git a/src/arkruntime/types/session/get_session_checkpoint_response.py b/src/arkruntime/types/session/get_session_checkpoint_response.py new file mode 100644 index 0000000..78e8b4e --- /dev/null +++ b/src/arkruntime/types/session/get_session_checkpoint_response.py @@ -0,0 +1,22 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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 + +from .session_checkpoint import SessionCheckpoint + + +class GetSessionCheckpointResponse(BaseModel): + """ + `GET /checkpoints/{checkpoint_id}` 响应体。 + """ + + checkpoint: SessionCheckpoint + """ + Checkpoint 对象。 + """ diff --git a/src/arkruntime/types/session/list_session_checkpoints_response.py b/src/arkruntime/types/session/list_session_checkpoints_response.py new file mode 100644 index 0000000..6e38213 --- /dev/null +++ b/src/arkruntime/types/session/list_session_checkpoints_response.py @@ -0,0 +1,28 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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, Optional + +from arkruntime._models import BaseModel + +from .session_checkpoint import SessionCheckpoint + + +class ListSessionCheckpointsResponse(BaseModel): + """ + `GET /checkpoints` 响应体。 + """ + + data: List[SessionCheckpoint] + """ + 本页 Checkpoint 列表。 + """ + next_page: Optional[str] = None + """ + 下一页 cursor；已列尽时为空或缺省。 + """ diff --git a/src/arkruntime/types/session/model_overrides.py b/src/arkruntime/types/session/model_overrides.py index 15916a0..533258a 100644 --- a/src/arkruntime/types/session/model_overrides.py +++ b/src/arkruntime/types/session/model_overrides.py @@ -6,14 +6,16 @@ from __future__ import annotations -from typing import Optional +from typing import Dict, List, Optional from arkruntime._models import BaseModel +from .override_token_limits import OverrideTokenLimits + class ModelOverrides(BaseModel): """ - Session 创建时允许临时覆写的模型运行参数。 + Session 创建时允许临时覆写的模型运行参数与接入配置。 内部字段省略表示继承 base Agent 的对应值。 """ @@ -40,3 +42,38 @@ class ModelOverrides(BaseModel): """ 服务档位。 """ + provider: Optional[str] = None + """ + 模型提供方覆写，例如 `"ark"` 或外接 provider 名。非空才生效，显式传空 + 串返回 400。切到非 ark provider 时，`base_url` 与 `token_limits` 为 + 必填（可继承快照中已有的值，否则返回 400）；ark provider 不允许指定 + `token_limits`。 + """ + protocol: Optional[str] = None + """ + 模型接入协议覆写；取值须命中服务端维护的接入协议白名单，非法值返回 + 400。 + """ + base_url: Optional[str] = None + """ + 自定义模型接入点 base URL。配合非 ark 的 `provider` 使用，把 Session + 快照里冻结的上游替换成当前环境可达的接入点。 + """ + headers: Optional[Dict[str, str]] = None + """ + 自定义模型请求 header（整组覆写），例如 `Authorization` 或 + `X-Trial-Id`；key / value 均为字符串。 + """ + token_limits: Optional[OverrideTokenLimits] = None + """ + 模型 token 限制覆写（整体替换，提供时内部三字段必填且为正数）； + 非 ark provider 可用，ark provider 指定返回 400。 + """ + input_modalities: Optional[List[str]] = None + """ + 底模支持的输入模态列表覆写。取值域：`text` / `image` / `audio` / + `video`（无 `document`；文档在内部归入 image 通道）。 + + 服务端会做归一化：去空白、转小写、元素去重、拒绝空元素，元素长度 + 上限 32，列表长度上限 16，超出返回 400。 + """ diff --git a/src/arkruntime/types/session/override_token_limits.py b/src/arkruntime/types/session/override_token_limits.py new file mode 100644 index 0000000..76ab799 --- /dev/null +++ b/src/arkruntime/types/session/override_token_limits.py @@ -0,0 +1,37 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` in ark-apis. +# +# Copyright (c) 2026 ByteDance Ltd. and/or its affiliates. +# SPDX-License-Identifier: Apache-2.0 + +from __future__ import annotations + +from typing_extensions import Annotated + + +from arkruntime._models import BaseModel +from pydantic import Field + + +class OverrideTokenLimits(BaseModel): + """ + Session 创建期模型覆写使用的 token 限制。 + + **整体替换语义**：省略整个 `token_limits` 对象表示不覆写、继承快照值； + 一旦提供对象，三个字段**全部必填**且为正整数（>= 1），服务端不会与 + 快照中的旧 limits 按字段合并——只传部分字段返回 400 + `model.token_limits.: required`。 + """ + + context_window: Annotated[int, Field(ge=1)] + """ + 模型上下文窗口；正整数。 + """ + max_input_token_length: Annotated[int, Field(ge=1)] + """ + 最大输入 token 长度；正整数。 + """ + max_output_token_length: Annotated[int, Field(ge=1)] + """ + 最大输出 token 长度；正整数。 + """ diff --git a/src/arkruntime/types/session/session_checkpoint.py b/src/arkruntime/types/session/session_checkpoint.py new file mode 100644 index 0000000..ebe778e --- /dev/null +++ b/src/arkruntime/types/session/session_checkpoint.py @@ -0,0 +1,74 @@ +# Generated by datamodel-code-generator from ark-apis typespec/openapi. +# DO NOT EDIT — regenerate with `make gen-py-` 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, Optional + +from arkruntime._models import BaseModel + +from .checkpoint_component import CheckpointComponent +from .checkpoint_session_snapshot import CheckpointSessionSnapshot +from .checkpoint_status import CheckpointStatus + + +class SessionCheckpoint(BaseModel): + """ + Session Checkpoint：某个静止 Session 的可恢复快照。 + + 用于 `POST /sessions` 携带 `checkpoint_id` 创建一个继承冻结配置的新 + Session。是否需要 `checkpoint_restore_config` 只取决于快照是否包含 + customer TOS 数据且跨账号恢复，详见该字段说明。 + """ + + id: str + """ + Checkpoint ID。 + """ + source_session_id: str + """ + 快照来源 Session ID。 + """ + name: str + """ + 调用方创建时给出的 Checkpoint 名称。 + """ + status: CheckpointStatus + """ + Checkpoint 状态。 + """ + error_code: Optional[str] = None + """ + 失败错误码（`status = "failed"` 时存在）。 + """ + error_message: Optional[str] = None + """ + 失败错误信息。 + """ + expires_at: Optional[str] = None + """ + 过期时间（RFC 3339）；过期后不可用于恢复。 + """ + completed_at: Optional[str] = None + """ + 快照完成时间（RFC 3339）。 + """ + created_at: str + """ + 创建时间（RFC 3339）。 + """ + updated_at: str + """ + 最近更新时间（RFC 3339）。 + """ + snapshot: Optional[CheckpointSessionSnapshot] = None + """ + 冻结的用户可见 Session 配置。 + """ + components: Optional[List[CheckpointComponent]] = None + """ + 各资源组件的脱敏执行摘要。 + """ diff --git a/uv.lock b/uv.lock index 601cd1e..efa57ab 100644 --- a/uv.lock +++ b/uv.lock @@ -79,7 +79,7 @@ wheels = [ [[package]] name = "arkruntime" -version = "0.8.0" +version = "0.9.0" source = { editable = "." } dependencies = [ { name = "anyio", version = "4.5.2", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.9'" },