chore: sync from ark-apis 644ae285bd

.github/workflows/ci.yml

@@ -21,6 +21,30 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  minimum-python-import:
+    name: Import on Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.8", "3.9"]
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package
+        run: python -m pip install --disable-pip-version-check --quiet .
+
+      - name: Import package
+        run: python -c "import arkruntime"
+
   python-ci:
     name: Python CI
     runs-on: ubuntu-latest

VERSION

@@ -1 +1 @@
-0.3.0
+0.4.0

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "arkruntime"
-version = "0.3.0"
+version = "0.4.0"
 description = "Ark runtime SDK for Python"
 readme = "README.md"
 requires-python = ">=3.8"

src/arkruntime/types/chat/chat_completion_content_part.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .chat_completion_content_part_audio import ChatCompletionContentPartAudio
 from .chat_completion_content_part_file import ChatCompletionContentPartFile

src/arkruntime/types/chat/chat_completion_content_part_param.py

@@ -6,7 +6,9 @@
 
 from __future__ import annotations
 
-from typing import TypeAlias, Union
+from typing import Union
+
+from typing_extensions import TypeAlias
 
 from .chat_completion_content_part_audio_param import (
     ChatCompletionContentPartAudioParam,

src/arkruntime/types/chat/chat_completion_message_content_param.py

@@ -6,7 +6,9 @@
 
 from __future__ import annotations
 
-from typing import List, TypeAlias, Union
+from typing import List, Union
+
+from typing_extensions import TypeAlias
 
 from .chat_completion_content_part_param import ChatCompletionContentPartParam
 

src/arkruntime/types/chat/chat_completion_request_message.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .chat_completion_request_assistant_message import (
     ChatCompletionRequestAssistantMessage,

src/arkruntime/types/chat/chat_completion_request_message_param.py

@@ -6,7 +6,9 @@
 
 from __future__ import annotations
 
-from typing import TypeAlias, Union
+from typing import Union
+
+from typing_extensions import TypeAlias
 
 from .chat_completion_request_assistant_message_param import (
     ChatCompletionRequestAssistantMessageParam,

src/arkruntime/types/chat/chat_completion_response_format_json_schema.py

@@ -6,7 +6,9 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Dict, Optional
+from typing import Dict, Optional
+
+from typing_extensions import Annotated
 
 from arkruntime._models import BaseModel
 from pydantic import Field

src/arkruntime/types/chat/chat_completion_stop_param.py

@@ -6,6 +6,8 @@
 
 from __future__ import annotations
 
-from typing import List, TypeAlias, Union
+from typing import List, Union
+
+from typing_extensions import TypeAlias
 
 ChatCompletionStopParam: TypeAlias = Union[str, List[str]]

src/arkruntime/types/chat/chat_completion_tool_choice_param.py

@@ -6,7 +6,9 @@
 
 from __future__ import annotations
 
-from typing import TypeAlias, Union
+from typing import Union
+
+from typing_extensions import TypeAlias
 
 from .chat_completion_named_tool_choice_param import ChatCompletionNamedToolChoiceParam
 from .tool_choice_mode import ToolChoiceMode

src/arkruntime/types/chat/tool_type_param.py

@@ -6,6 +6,8 @@
 
 from __future__ import annotations
 
-from typing import Literal, TypeAlias
+from typing import Literal
+
+from typing_extensions import TypeAlias
 
 ToolTypeParam: TypeAlias = Literal["function"]

src/arkruntime/types/content_generation/tool_type_param.py

@@ -6,6 +6,8 @@
 
 from __future__ import annotations
 
-from typing import Literal, TypeAlias
+from typing import Literal
+
+from typing_extensions import TypeAlias
 
 ToolTypeParam: TypeAlias = Literal["web_search"]

src/arkruntime/types/embedding/embedding_input_param.py

@@ -6,7 +6,9 @@
 
 from __future__ import annotations
 
-from typing import List, TypeAlias, Union
+from typing import List, Union
+
+from typing_extensions import TypeAlias
 
 EmbeddingInputParam: TypeAlias = Union[str, List[str]]
 """

src/arkruntime/types/images/tool_type_param.py

@@ -6,6 +6,8 @@
 
 from __future__ import annotations
 
-from typing import Literal, TypeAlias
+from typing import Literal
+
+from typing_extensions import TypeAlias
 
 ToolTypeParam: TypeAlias = Literal["web_search"]

src/arkruntime/types/messages/__init__.py

@@ -38,6 +38,9 @@
 from .messages_context_management_edit import MessagesContextManagementEdit
 from .messages_context_management_keep import MessagesContextManagementKeep
 from .messages_context_management_keep_all import MessagesContextManagementKeepAll
+from .messages_context_management_keep_parameter import (
+    MessagesContextManagementKeepParameter,
+)
 from .messages_context_management_keep_thinking_turns import (
     MessagesContextManagementKeepThinkingTurns,
 )
@@ -142,6 +145,7 @@
     "MessagesContextManagementEdit",
     "MessagesContextManagementKeep",
     "MessagesContextManagementKeepAll",
+    "MessagesContextManagementKeepParameter",
     "MessagesContextManagementKeepThinkingTurns",
     "MessagesContextManagementKeepToolUses",
     "MessagesDocumentSourceType",

src/arkruntime/types/messages/content_block_start_content_block.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .messages_response_content_part_server_tool_use import (
     MessagesResponseContentPartServerToolUse,

src/arkruntime/types/messages/messages_content_part.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .messages_content_part_document import MessagesContentPartDocument
 from .messages_content_part_image import MessagesContentPartImage

src/arkruntime/types/messages/messages_context_management_edit.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .messages_context_management_clear_thinking import (
     MessagesContextManagementClearThinking,

src/arkruntime/types/messages/messages_context_management_keep.py

@@ -10,23 +10,14 @@
 
 from typing_extensions import TypeAliasType
 
-from .messages_context_management_keep_all import MessagesContextManagementKeepAll
-from .messages_context_management_keep_thinking_turns import (
-    MessagesContextManagementKeepThinkingTurns,
-)
-from .messages_context_management_keep_tool_uses import (
-    MessagesContextManagementKeepToolUses,
+from .messages_context_management_keep_parameter import (
+    MessagesContextManagementKeepParameter,
 )
 
 MessagesContextManagementKeep = TypeAliasType(
     "MessagesContextManagementKeep",
-    Union[
-        Literal["all"],
-        MessagesContextManagementKeepAll,
-        MessagesContextManagementKeepThinkingTurns,
-        MessagesContextManagementKeepToolUses,
-    ],
+    Union[Literal["all"], MessagesContextManagementKeepParameter],
 )
 """
-What context to retain while applying a context-management edit.
+A literal retention mode or a typed retention parameter.
 """

src/arkruntime/types/messages/messages_context_management_keep_parameter.py

@@ -0,0 +1,35 @@
+# 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 Union
+
+from pydantic import Field
+from typing_extensions import Annotated, TypeAliasType
+
+from .messages_context_management_keep_all import MessagesContextManagementKeepAll
+from .messages_context_management_keep_thinking_turns import (
+    MessagesContextManagementKeepThinkingTurns,
+)
+from .messages_context_management_keep_tool_uses import (
+    MessagesContextManagementKeepToolUses,
+)
+
+MessagesContextManagementKeepParameter = TypeAliasType(
+    "MessagesContextManagementKeepParameter",
+    Annotated[
+        Union[
+            MessagesContextManagementKeepAll,
+            MessagesContextManagementKeepThinkingTurns,
+            MessagesContextManagementKeepToolUses,
+        ],
+        Field(discriminator="type"),
+    ],
+)
+"""
+What context to retain while applying a context-management edit.
+"""

src/arkruntime/types/messages/messages_output_format.py

@@ -6,7 +6,9 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Dict, Optional
+from typing import Dict, Optional
+
+from typing_extensions import Annotated
 
 from arkruntime._models import BaseModel
 from pydantic import Field

src/arkruntime/types/messages/messages_response_content_block_delta.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .messages_response_content_block_delta_signature import (
     MessagesResponseContentBlockDeltaSignature,

src/arkruntime/types/messages/messages_response_content_part.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .messages_response_content_part_server_tool_use import (
     MessagesResponseContentPartServerToolUse,

src/arkruntime/types/messages/messages_stream_event.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .content_block_start import ContentBlockStart
 from .messages_error_response import MessagesErrorResponse

src/arkruntime/types/messages/messages_tool_choice.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .messages_tool_choice_any import MessagesToolChoiceAny
 from .messages_tool_choice_auto import MessagesToolChoiceAuto

src/arkruntime/types/messages/messages_tool_result_content_part.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .messages_content_part_image import MessagesContentPartImage
 from .messages_content_part_text import MessagesContentPartText

src/arkruntime/types/responses/annotation.py

@@ -6,10 +6,10 @@
 
 from __future__ import annotations
 
-from typing import Annotated, Union
+from typing import Union
 
 from pydantic import Field
-from typing_extensions import TypeAliasType
+from typing_extensions import Annotated, TypeAliasType
 
 from .doc_citation import DocCitation
 from .url_citation import UrlCitation

src/arkruntime/types/responses/annotation_param.py

@@ -6,7 +6,9 @@
 
 from __future__ import annotations
 
-from typing import TypeAlias, Union
+from typing import Union
+
+from typing_extensions import TypeAlias
 
 from .doc_citation_param import DocCitationParam
 from .url_citation_param import UrlCitationParam