arkruntime 0.1.0__py3-none-any.whl

arkruntime/types/vault/credential_networking.py

@@ -0,0 +1,29 @@
+# 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 .credential_networking_type import CredentialNetworkingType
+from .limited_credential_networking import LimitedCredentialNetworking
+
+
+class CredentialNetworking(BaseModel):
+    """
+    environment_variable 凭证注入时的网络策略。
+    """
+
+    type: CredentialNetworkingType
+    """
+    网络策略类型。
+    """
+    limited: Optional[LimitedCredentialNetworking] = None
+    """
+    `limited` 策略下的白名单。
+    """

arkruntime/types/vault/credential_networking_type.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 CredentialNetworkingType(str, Enum):
+    """
+    environment_variable 凭证的注入网络策略。
+    """
+
+    unrestricted = "unrestricted"
+    limited = "limited"

arkruntime/types/vault/credential_validation.py

@@ -0,0 +1,54 @@
+# 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
+
+from .mcp_probe import MCPProbe
+from .refresh_object import RefreshObject
+from .validation_status import ValidationStatus
+
+
+class CredentialValidation(BaseModel):
+    """
+    ValidateCredential 接口响应：对 MCP server 做一次 live probe 的结果。
+    """
+
+    type: Literal["vault_credential_validation"]
+    """
+    固定 `"vault_credential_validation"`。
+    """
+    credential_id: str
+    """
+    被校验的 Credential ID。
+    """
+    vault_id: str
+    """
+    归属的 Vault ID。
+    """
+    validated_at: str
+    """
+    校验时间（RFC 3339）。
+    """
+    status: ValidationStatus
+    """
+    整体校验状态。
+    """
+    has_refresh_token: bool
+    """
+    是否配置了可用的 refresh token。
+    """
+    mcp_probe: MCPProbe
+    """
+    一次 MCP live probe 的抓包结果。
+    """
+    refresh: RefreshObject
+    """
+    refresh token 兑换的抓包结果。
+    """

arkruntime/types/vault/delete_credential_response.py

@@ -0,0 +1,26 @@
+# 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 DeleteCredentialResponse(BaseModel):
+    """
+    Delete Credential 响应体。
+    """
+
+    id: str
+    """
+    被删除的 Credential ID。
+    """
+    type: Literal["vault_credential_deleted"]
+    """
+    固定 `"vault_credential_deleted"`。
+    """

arkruntime/types/vault/delete_vault_response.py

@@ -0,0 +1,26 @@
+# 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 DeleteVaultResponse(BaseModel):
+    """
+    Delete Vault 响应体。
+    """
+
+    id: str
+    """
+    被删除的 Vault ID。
+    """
+    type: Literal["vault_deleted"]
+    """
+    固定 `"vault_deleted"`。
+    """

arkruntime/types/vault/limited_credential_networking.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 List
+
+from arkruntime._models import BaseModel
+
+
+class LimitedCredentialNetworking(BaseModel):
+    """
+    environment_variable 凭证的白名单出网网络配置。
+    """
+
+    allowed_hosts: List[str]
+    """
+    允许出网的域名列表。
+    """

arkruntime/types/vault/list_credentials_response.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 List, Optional
+
+from arkruntime._models import BaseModel
+
+from .credential import Credential
+
+
+class ListCredentialsResponse(BaseModel):
+    """
+    List Credentials 响应体。
+
+    注意：wire 上字段名是 `credentials`（与 vault / session 的 `data` 不一致），
+    以 stg 实际形态为准。
+    """
+
+    credentials: List[Credential]
+    """
+    本页 Credential 列表。
+    """
+    next_page: Optional[str] = None
+    """
+    下一页 cursor；已列尽时为空或缺省。
+    """
+    total: Optional[int] = None
+    """
+    命中总条数（可选）。
+    """

arkruntime/types/vault/list_vaults_response.py

@@ -0,0 +1,32 @@
+# 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, Optional
+
+from arkruntime._models import BaseModel
+
+from .vault import Vault
+
+
+class ListVaultsResponse(BaseModel):
+    """
+    List Vaults 响应体。
+    """
+
+    data: List[Vault]
+    """
+    本页 Vault 列表。
+    """
+    next_page: Optional[str] = None
+    """
+    下一页 cursor；已列尽时为空或缺省。
+    """
+    total: Optional[int] = None
+    """
+    命中总条数（可选）。
+    """

arkruntime/types/vault/mcp_probe.py

@@ -0,0 +1,26 @@
+# 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
+
+from .refresh_http_response import RefreshHTTPResponse
+
+
+class MCPProbe(BaseModel):
+    """
+    凭证 validate 探测中捕获的 MCP 请求 / 响应对。
+    """
+
+    http_response: RefreshHTTPResponse
+    """
+    探测过程中失败的那一步捕获到的 HTTP 响应。
+    """
+    method: str
+    """
+    触发的 MCP 方法名。
+    """

arkruntime/types/vault/mcpo_auth_refresh.py

@@ -0,0 +1,45 @@
+# 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 .token_endpoint_auth import TokenEndpointAuth
+
+
+class MCPOAuthRefresh(BaseModel):
+    """
+    MCP OAuth 凭证的 refresh 配置。
+    `refresh_token` 是 write-only：写入接受，响应永不返回。
+    """
+
+    client_id: Optional[str] = None
+    """
+    OAuth client id。
+    """
+    refresh_token: Optional[str] = None
+    """
+    OAuth refresh token（write-only）。
+    """
+    token_endpoint: Optional[str] = None
+    """
+    OAuth token endpoint URL。
+    """
+    token_endpoint_auth: Optional[TokenEndpointAuth] = None
+    """
+    token endpoint 的鉴权配置。
+    """
+    resource: Optional[str] = None
+    """
+    OAuth resource indicator（RFC 8707），可选。
+    """
+    scope: Optional[str] = None
+    """
+    空格分隔的 OAuth scope 列表，可选。
+    """

arkruntime/types/vault/refresh_http_response.py

@@ -0,0 +1,32 @@
+# 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 RefreshHTTPResponse(BaseModel):
+    """
+    凭证 validate 探测过程中捕获的一次 HTTP 响应。
+    """
+
+    body: str
+    """
+    响应体（可能被截断）。
+    """
+    body_truncated: bool
+    """
+    响应体是否已被截断。
+    """
+    content_type: str
+    """
+    Content-Type 头。
+    """
+    status_code: int
+    """
+    HTTP 状态码。
+    """

arkruntime/types/vault/refresh_object.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 arkruntime._models import BaseModel
+
+from .refresh_http_response import RefreshHTTPResponse
+from .refresh_status import RefreshStatus
+
+
+class RefreshObject(BaseModel):
+    """
+    凭证 validate 中尝试 refresh token 兑换的结果。
+    """
+
+    http_response: RefreshHTTPResponse
+    """
+    refresh 请求的 HTTP 响应。
+    """
+    status: RefreshStatus
+    """
+    refresh 结果状态。
+    """

arkruntime/types/vault/refresh_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 RefreshStatus(str, Enum):
+    """
+    ValidateCredential 接口的 refresh 结果状态。
+    """
+
+    succeeded = "succeeded"
+    failed = "failed"
+    connect_error = "connect_error"
+    no_refresh_token = "no_refresh_token"

arkruntime/types/vault/token_endpoint_auth.py

@@ -0,0 +1,29 @@
+# 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 .token_endpoint_auth_type import TokenEndpointAuthType
+
+
+class TokenEndpointAuth(BaseModel):
+    """
+    OAuth token endpoint 的客户端鉴权配置。
+    `client_secret` 是 write-only：写入接受，响应永不返回。
+    """
+
+    type: TokenEndpointAuthType
+    """
+    鉴权方式。
+    """
+    client_secret: Optional[str] = None
+    """
+    OAuth client secret（write-only）。
+    """

arkruntime/types/vault/token_endpoint_auth_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 TokenEndpointAuthType(str, Enum):
+    """
+    OAuth token endpoint 客户端鉴权方式。
+    """
+
+    none = "none"
+    client_secret_basic = "client_secret_basic"
+    client_secret_post = "client_secret_post"

arkruntime/types/vault/update_credential_request.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 Dict, Optional
+
+from arkruntime._models import BaseModel
+
+from .credential_auth import CredentialAuth
+
+
+class UpdateCredentialRequest(BaseModel):
+    """
+    更新 Credential 的请求体。
+
+    `auth` 仅可更新可变字段；`mcp_server_url` / `secret_name` 创建后不可改。
+    `display_name` / `metadata` 为 patch 语义。
+    """
+
+    auth: Optional[CredentialAuth] = None
+    """
+    鉴权细节（部分可变字段）。
+    """
+    display_name: Optional[str] = None
+    """
+    人类可读名称。
+    """
+    metadata: Optional[Dict[str, str]] = None
+    """
+    用户自定义键值对元数据（patch）。
+    """

arkruntime/types/vault/update_vault_request.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 Dict, Optional
+
+from arkruntime._models import BaseModel
+
+
+class UpdateVaultRequest(BaseModel):
+    """
+    更新 Vault 的请求体。语义：`display_name` / `metadata` 至少给一个；
+    `metadata` 走 patch。
+    """
+
+    display_name: Optional[str] = None
+    """
+    人类可读名称。
+    """
+    metadata: Optional[Dict[str, str]] = None
+    """
+    用户自定义键值对元数据（patch）。
+    """

arkruntime/types/vault/validation_status.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 ValidationStatus(str, Enum):
+    """
+    ValidateCredential 接口的整体校验状态。
+    """
+
+    valid = "valid"
+    invalid = "invalid"
+    unknown = "unknown"

arkruntime/types/vault/vault.py

@@ -0,0 +1,42 @@
+# 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, Literal, Optional
+
+from arkruntime._models import BaseModel
+
+
+class Vault(BaseModel):
+    """
+    凭证的逻辑容器。
+    """
+
+    id: str
+    """
+    Vault ID。
+    """
+    type: Literal["vault"]
+    """
+    固定 `"vault"`。
+    """
+    display_name: str
+    """
+    人类可读名称，1–255 字符。
+    """
+    metadata: Optional[Dict[str, str]] = None
+    """
+    用户自定义键值对元数据。
+    """
+    created_at: str
+    """
+    RFC 3339 时间。
+    """
+    updated_at: str
+    """
+    RFC 3339 时间。
+    """