tansr-sdk 0.1.0__tar.gz

tansr_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tansr (tansr.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tansr_sdk-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include src *.py *.typed

tansr_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: tansr-sdk
+Version: 0.1.0
+Summary: Native Python client SDK for the Tansr Serve unified API
+Author: Tansr
+License: MIT License
+        
+        Copyright (c) 2026 Tansr (tansr.com)
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://www.tansr.com/
+Project-URL: Repository, https://github.com/tansrai/tansr-python
+Project-URL: Documentation, https://github.com/tansrai/tansr-python/blob/main/doc/guide.md
+Project-URL: Issues, https://github.com/tansrai/tansr-python/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: !=3.9.0,!=3.9.1,>=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography==45.0.7; python_version < "3.8"
+Requires-Dist: cffi==1.15.1; python_version < "3.8"
+Requires-Dist: pycparser==2.21; python_version < "3.8"
+Requires-Dist: cryptography==47.0.0; python_version >= "3.8" and python_version < "3.9"
+Requires-Dist: cryptography==50.0.2; python_version >= "3.9"
+Dynamic: license-file
+
+# Tansr Python SDK
+
+原生 Python 3.7+ SDK，通过统一 `/api` 连接 Serve。Serve 负责运行、会话、上下文、记忆、权限和工具调度；Python 提供同步与 asyncio 接口、显式业务工具、分块输出和私有本地档案。不捆绑 Node、C++ 或 Rust 运行时。
+
+`0.1.0` 的 SDK 与 Demo 均采用 [MIT 许可证](https://github.com/tansrai/tansr-python/blob/main/LICENSE)。源码渠道为 [tansrai/tansr-python](https://github.com/tansrai/tansr-python)，包渠道为 PyPI 的 [tansr-sdk](https://pypi.org/project/tansr-sdk/) 与 [tansr-sdk-demo](https://pypi.org/project/tansr-sdk-demo/)。已验证环境与适用限制见发行说明。
+
+使用文档：[中文指南](https://github.com/tansrai/tansr-python/blob/main/doc/%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97.md) · [English guide](https://github.com/tansrai/tansr-python/blob/main/doc/guide.md) · [发行说明](https://github.com/tansrai/tansr-python/blob/main/doc/%E5%8F%91%E8%A1%8C%E8%AF%B4%E6%98%8E.md) · [Demo 入口](https://github.com/tansrai/tansr-python/blob/main/demo/README.md)。English readers: version 0.1.0 includes the SDK and separate Demo package, both under the [MIT license](https://github.com/tansrai/tansr-python/blob/main/LICENSE).
+
+| 能力 | 公开入口 |
+| --- | --- |
+| 81 项统一 API、严格 JSON 与错误分类 | `Client`、`AsyncClient` |
+| 会话、事件、权限、提问、输入与检查点 | `SessionClient`、`AsyncSessionClient` |
+| 显式工具、续租、耐久业务回执与独立输出确认 | `ExecutorClient`、`Runner`、`AsyncRunner` |
+| 创建意图、加密档案、耐久 ACK 与材料供给 | `ArchiveClient`、`AsyncArchiveClient`、`FileStore` |
+| 独立 Demo 包 | `tansr-py-chat`、`tansr-py-tools`、`tansr-py-archive` |
+
+嵌入自己的应用只安装 `tansr-sdk`；需要试用三个命令行示例时再安装独立的 `tansr-sdk-demo`。SDK 不依赖 Demo，宿主通过 `AuthToken` provider 接入自己的登录和短期凭据，不必沿用 Demo 的文件布局。同步和异步高层共享同一协议实现；已有 asyncio 应用直接 `await`，不接管宿主事件循环。
+
+在虚拟环境中从 PyPI 按需安装同版包：
+
+```text
+python -m pip install tansr-sdk==0.1.0
+python -m pip install tansr-sdk-demo==0.1.0
+```
+
+离线环境可安装已核验的同版 wheel；以下路径需替换为实际文件：
+
+```text
+python -m pip install /absolute/artifacts/tansr_sdk-0.1.0-py3-none-any.whl /absolute/artifacts/tansr_sdk_demo-0.1.0-py3-none-any.whl
+python -m pip check
+tansr-py-chat --help
+tansr-py-tools --help
+tansr-py-archive --help
+```
+
+Demo 精确依赖 `tansr-sdk==0.1.0`，不复制 SDK。模块入口分别为 `python -m tansr_demo.chat`、`python -m tansr_demo.tools`、`python -m tansr_demo.archive`；另有可执行的 `python -m tansr_demo.async_chat --message ...` asyncio 示例。
+
+接线顺序：先由开发者部署和配置 Serve，再取得本应用/用户的身份与能力，选定会话族并创建或接入会话，最后按需装配终端工具及档案。HTTP 请求提交控制操作，SSE 传输事件；本实现不以 WebSocket 为必需。已有完整 Node/Electron SDK 的运行方式不受此包影响。
+
+`sdk1` 保留原完整会话存储路径；`sdk2-offload-v1` 需要 Serve 的授权 Source 装配，并使用稳定创建意图。两族不得对同一会话随意切换。应用能力、权限、审批和核心工具路由仍由 Serve 决定；Python `Runner` 只执行宿主显式注册的业务工具，不把设备操作回落到 Serve 机器，也不附送通用 Shell。
+
+`ArchiveClient` 提供的是原档案与材料供给高层，不是另一套上下文/记忆管理器。记忆配置、记忆命令与缓存等已有冻结操作可经 `Client.call` 消费；首版未提供独立 `MemoryClient` / `CacheClient`，不会把通用 API 数量宣传为这些高层已经实现。能力范围和恢复处理见双语指南。
+
+连接已有 Serve 前，按指南准备 `TANSR_TOKEN_FILE`、`TANSR_SCOPE_FILE` 与服务地址；档案另需宿主管理的 `TANSR_ARCHIVE_KEY_FILE`。token/scope 共用私有凭据目录，创建意图、journal 和档案文件使用另外的私有状态目录；Demo 拒绝两种目录重合，避免授权回调重入事务锁。凭据不由 Demo 签发，也不打印到日志。恢复必须保留原会话、请求、截止、档案和密钥；本地取消不证明远端撤销，`received` 不代表 `core-consumed`。
+
+运行源码最低支持 CPython 3.7，排除 3.9.0/3.9.1。旧解释器兼容不恢复其上游安全维护。实际依赖锁、平台环境和独立 wheel/sdist 消费方法见 [依赖说明](https://github.com/tansrai/tansr-python/blob/main/requirements/README.md)；SDK 自身的纯 Python wheel 不代表加密依赖没有原生二进制。
+
+默认 HTTP 传输在 HTTPS 的 DNS/连接之前检查 stdlib SSL 运行时；已知受影响 OpenSSL 或未验证的其他 provider 被拒绝为 `unsupported_tls_runtime`，没有绕过开关。Windows 官方 Python 3.7.9 所带 OpenSSL 1.1.1g 因此不能使用默认 HTTPS；回环 HTTP 成功不能替代 TLS 正向证据。
+
+最低 Python 版本与 SSL 安全基线是两个条件。本轮已验证独立 prefix 中的 Anaconda CPython 3.7.9 `h60c2a47_0` + OpenSSL 1.1.1w `h2bbff1b_0`，安装原 SDK wheel 后默认信任 HTTPS 与原传输验收通过；精确包/SHA、安装和子进程运行方式见 [发行说明](https://github.com/tansrai/tansr-python/blob/main/doc/%E5%8F%91%E8%A1%8C%E8%AF%B4%E6%98%8E.md)。这是 legacy 兼容路线，Python 3.7 与 OpenSSL 1.1.1 均已结束维护，不称当前受维护的 TLS 栈。新项目优先选择受维护的解释器；原 1.1.1g 拒绝保持，不关闭验证、不覆盖系统 DLL。
+
+SDK 面向 UAPI r7；操作与 schema 已嵌入运行包，正常运行不读取 `contract/`，也不需要生成器。公开源码检出中的开发检查示例：
+
+```text
+python tools/contract_check.py --mode public
+python tools/generate_api.py --mode public --check
+python -m pytest
+```
+
+公开源码检查使用显式 `public` 模式，并核验仓库中的公开合同清单；缺少或不匹配时检查失败。真实 Serve 验证使用合成身份、平台及模型，不代表已调用付费模型。源码测试、各系统环境、安装消费和正式发布分别记录，适用范围见发行说明。

tansr_sdk-0.1.0/README.md

@@ -0,0 +1,60 @@
+# Tansr Python SDK
+
+原生 Python 3.7+ SDK，通过统一 `/api` 连接 Serve。Serve 负责运行、会话、上下文、记忆、权限和工具调度；Python 提供同步与 asyncio 接口、显式业务工具、分块输出和私有本地档案。不捆绑 Node、C++ 或 Rust 运行时。
+
+`0.1.0` 的 SDK 与 Demo 均采用 [MIT 许可证](https://github.com/tansrai/tansr-python/blob/main/LICENSE)。源码渠道为 [tansrai/tansr-python](https://github.com/tansrai/tansr-python)，包渠道为 PyPI 的 [tansr-sdk](https://pypi.org/project/tansr-sdk/) 与 [tansr-sdk-demo](https://pypi.org/project/tansr-sdk-demo/)。已验证环境与适用限制见发行说明。
+
+使用文档：[中文指南](https://github.com/tansrai/tansr-python/blob/main/doc/%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97.md) · [English guide](https://github.com/tansrai/tansr-python/blob/main/doc/guide.md) · [发行说明](https://github.com/tansrai/tansr-python/blob/main/doc/%E5%8F%91%E8%A1%8C%E8%AF%B4%E6%98%8E.md) · [Demo 入口](https://github.com/tansrai/tansr-python/blob/main/demo/README.md)。English readers: version 0.1.0 includes the SDK and separate Demo package, both under the [MIT license](https://github.com/tansrai/tansr-python/blob/main/LICENSE).
+
+| 能力 | 公开入口 |
+| --- | --- |
+| 81 项统一 API、严格 JSON 与错误分类 | `Client`、`AsyncClient` |
+| 会话、事件、权限、提问、输入与检查点 | `SessionClient`、`AsyncSessionClient` |
+| 显式工具、续租、耐久业务回执与独立输出确认 | `ExecutorClient`、`Runner`、`AsyncRunner` |
+| 创建意图、加密档案、耐久 ACK 与材料供给 | `ArchiveClient`、`AsyncArchiveClient`、`FileStore` |
+| 独立 Demo 包 | `tansr-py-chat`、`tansr-py-tools`、`tansr-py-archive` |
+
+嵌入自己的应用只安装 `tansr-sdk`；需要试用三个命令行示例时再安装独立的 `tansr-sdk-demo`。SDK 不依赖 Demo，宿主通过 `AuthToken` provider 接入自己的登录和短期凭据，不必沿用 Demo 的文件布局。同步和异步高层共享同一协议实现；已有 asyncio 应用直接 `await`，不接管宿主事件循环。
+
+在虚拟环境中从 PyPI 按需安装同版包：
+
+```text
+python -m pip install tansr-sdk==0.1.0
+python -m pip install tansr-sdk-demo==0.1.0
+```
+
+离线环境可安装已核验的同版 wheel；以下路径需替换为实际文件：
+
+```text
+python -m pip install /absolute/artifacts/tansr_sdk-0.1.0-py3-none-any.whl /absolute/artifacts/tansr_sdk_demo-0.1.0-py3-none-any.whl
+python -m pip check
+tansr-py-chat --help
+tansr-py-tools --help
+tansr-py-archive --help
+```
+
+Demo 精确依赖 `tansr-sdk==0.1.0`，不复制 SDK。模块入口分别为 `python -m tansr_demo.chat`、`python -m tansr_demo.tools`、`python -m tansr_demo.archive`；另有可执行的 `python -m tansr_demo.async_chat --message ...` asyncio 示例。
+
+接线顺序：先由开发者部署和配置 Serve，再取得本应用/用户的身份与能力，选定会话族并创建或接入会话，最后按需装配终端工具及档案。HTTP 请求提交控制操作，SSE 传输事件；本实现不以 WebSocket 为必需。已有完整 Node/Electron SDK 的运行方式不受此包影响。
+
+`sdk1` 保留原完整会话存储路径；`sdk2-offload-v1` 需要 Serve 的授权 Source 装配，并使用稳定创建意图。两族不得对同一会话随意切换。应用能力、权限、审批和核心工具路由仍由 Serve 决定；Python `Runner` 只执行宿主显式注册的业务工具，不把设备操作回落到 Serve 机器，也不附送通用 Shell。
+
+`ArchiveClient` 提供的是原档案与材料供给高层，不是另一套上下文/记忆管理器。记忆配置、记忆命令与缓存等已有冻结操作可经 `Client.call` 消费；首版未提供独立 `MemoryClient` / `CacheClient`，不会把通用 API 数量宣传为这些高层已经实现。能力范围和恢复处理见双语指南。
+
+连接已有 Serve 前，按指南准备 `TANSR_TOKEN_FILE`、`TANSR_SCOPE_FILE` 与服务地址；档案另需宿主管理的 `TANSR_ARCHIVE_KEY_FILE`。token/scope 共用私有凭据目录，创建意图、journal 和档案文件使用另外的私有状态目录；Demo 拒绝两种目录重合，避免授权回调重入事务锁。凭据不由 Demo 签发，也不打印到日志。恢复必须保留原会话、请求、截止、档案和密钥；本地取消不证明远端撤销，`received` 不代表 `core-consumed`。
+
+运行源码最低支持 CPython 3.7，排除 3.9.0/3.9.1。旧解释器兼容不恢复其上游安全维护。实际依赖锁、平台环境和独立 wheel/sdist 消费方法见 [依赖说明](https://github.com/tansrai/tansr-python/blob/main/requirements/README.md)；SDK 自身的纯 Python wheel 不代表加密依赖没有原生二进制。
+
+默认 HTTP 传输在 HTTPS 的 DNS/连接之前检查 stdlib SSL 运行时；已知受影响 OpenSSL 或未验证的其他 provider 被拒绝为 `unsupported_tls_runtime`，没有绕过开关。Windows 官方 Python 3.7.9 所带 OpenSSL 1.1.1g 因此不能使用默认 HTTPS；回环 HTTP 成功不能替代 TLS 正向证据。
+
+最低 Python 版本与 SSL 安全基线是两个条件。本轮已验证独立 prefix 中的 Anaconda CPython 3.7.9 `h60c2a47_0` + OpenSSL 1.1.1w `h2bbff1b_0`，安装原 SDK wheel 后默认信任 HTTPS 与原传输验收通过；精确包/SHA、安装和子进程运行方式见 [发行说明](https://github.com/tansrai/tansr-python/blob/main/doc/%E5%8F%91%E8%A1%8C%E8%AF%B4%E6%98%8E.md)。这是 legacy 兼容路线，Python 3.7 与 OpenSSL 1.1.1 均已结束维护，不称当前受维护的 TLS 栈。新项目优先选择受维护的解释器；原 1.1.1g 拒绝保持，不关闭验证、不覆盖系统 DLL。
+
+SDK 面向 UAPI r7；操作与 schema 已嵌入运行包，正常运行不读取 `contract/`，也不需要生成器。公开源码检出中的开发检查示例：
+
+```text
+python tools/contract_check.py --mode public
+python tools/generate_api.py --mode public --check
+python -m pytest
+```
+
+公开源码检查使用显式 `public` 模式，并核验仓库中的公开合同清单；缺少或不匹配时检查失败。真实 Serve 验证使用合成身份、平台及模型，不代表已调用付费模型。源码测试、各系统环境、安装消费和正式发布分别记录，适用范围见发行说明。

tansr_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,72 @@
+[build-system]
+requires = [
+  "setuptools==68.0.0; python_version < '3.8'",
+  "setuptools==75.3.2; python_version == '3.8'",
+  "setuptools==80.9.0; python_version == '3.9'",
+  "setuptools==84.0.0; python_version >= '3.10'",
+  "wheel==0.42.0; python_version < '3.8'",
+  "wheel==0.45.1; python_version == '3.8'",
+  "wheel==0.48.0; python_version >= '3.9'",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tansr-sdk"
+version = "0.1.0"
+description = "Native Python client SDK for the Tansr Serve unified API"
+readme = "README.md"
+requires-python = ">=3.7,!=3.9.0,!=3.9.1"
+license = {file = "LICENSE"}
+authors = [{name = "Tansr"}]
+dependencies = [
+  "cryptography==45.0.7; python_version < '3.8'",
+  "cffi==1.15.1; python_version < '3.8'",
+  "pycparser==2.21; python_version < '3.8'",
+  "cryptography==47.0.0; python_version >= '3.8' and python_version < '3.9'",
+  "cryptography==50.0.2; python_version >= '3.9'",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.7",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://www.tansr.com/"
+Repository = "https://github.com/tansrai/tansr-python"
+Documentation = "https://github.com/tansrai/tansr-python/blob/main/doc/guide.md"
+Issues = "https://github.com/tansrai/tansr-python/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+tansr_sdk = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+addopts = "--strict-markers --strict-config"
+
+[tool.ruff]
+target-version = "py37"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F"]
+
+[tool.mypy]
+files = ["src/tansr_sdk"]
+check_untyped_defs = true
+ignore_missing_imports = true
+no_implicit_optional = true

tansr_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tansr_sdk-0.1.0/src/tansr_sdk/__init__.py

@@ -0,0 +1,8 @@
+"""Tansr 原生 Python 接入层；智能体核心运行在 Serve。"""
+
+from .errors import Error
+from .lifecycle import CancellationToken
+from .api import Client, AsyncClient, AuthToken, CallOptions, ApiResponse
+
+__version__ = "0.1.0"
+__all__ = ["Client", "AsyncClient", "AuthToken", "CallOptions", "ApiResponse", "Error", "CancellationToken"]

tansr_sdk-0.1.0/src/tansr_sdk/_resolver.py

@@ -0,0 +1,205 @@
+"""有界专有 DNS 子进程；绝不把取消误作 getaddrinfo 线程已经结束。"""
+
+import ipaddress
+import json
+import os
+import socket
+import subprocess
+import sys
+import threading
+import time
+from typing import List, Optional, Tuple
+
+from .errors import Error
+from .lifecycle import CancellationToken, now_ms
+
+_MAX_REPLY = 16384
+_MAX_ADDRESSES = 64
+_WORKER = r"""
+import json, socket, sys
+try:
+    host, port = sys.argv[1], int(sys.argv[2])
+    rows = socket.getaddrinfo(host, port, socket.AF_UNSPEC, socket.SOCK_STREAM)
+    unique = []
+    for family, kind, protocol, name, address in rows:
+        if family not in (socket.AF_INET, socket.AF_INET6): continue
+        value = [family, list(address)]
+        if value not in unique: unique.append(value)
+        if len(unique) >= 64: break
+    raw = json.dumps(unique, separators=(',', ':')).encode('ascii')
+    if not unique or len(raw) > 16384: sys.exit(2)
+    sys.stdout.buffer.write(raw)
+except Exception:
+    sys.exit(2)
+"""
+
+
+def _environment() -> dict:
+    # Windows 解释器/系统解析所需变量；不继承 token、代理、PYTHONPATH 等。
+    allowed = {"SYSTEMROOT", "WINDIR", "SYSTEMDRIVE", "COMSPEC"}
+    return {key: value for key, value in os.environ.items() if key.upper() in allowed}
+
+
+def _numeric(host: str, port: int) -> Optional[List[Tuple[int, tuple]]]:
+    try:
+        address = ipaddress.ip_address(host)
+    except ValueError:
+        return None
+    if address.version == 4:
+        return [(socket.AF_INET, (str(address), port))]
+    return [(socket.AF_INET6, (str(address), port, 0, 0))]
+
+
+class Resolver:
+    def __init__(self, max_processes: int = 2) -> None:
+        if isinstance(max_processes, bool) or not isinstance(max_processes, int) or max_processes < 1:
+            raise Error("invalid_argument")
+        self._slots = threading.BoundedSemaphore(max_processes)
+        self._lock = threading.Lock()
+        self._processes = set()  # type: set
+        self._closed = False
+
+    def resolve(self, host: str, port: int, deadline_ms: int, cancel: CancellationToken) -> List[Tuple[int, tuple]]:
+        if not isinstance(host, str) or not host or len(host) > 253:
+            raise Error("invalid_argument")
+        if any(ord(char) < 33 or ord(char) > 126 for char in host):
+            raise Error("invalid_argument")
+        if isinstance(port, bool) or not isinstance(port, int) or not 0 < port < 65536:
+            raise Error("invalid_argument")
+        end = time.monotonic() + max(0, deadline_ms - now_ms()) / 1000.0
+
+        def check() -> None:
+            cancel.check(deadline_ms)
+            if time.monotonic() >= end:
+                raise Error("timeout")
+            with self._lock:
+                if self._closed:
+                    raise Error("closed")
+
+        check()
+        numeric = _numeric(host, port)
+        if numeric is not None:
+            return numeric
+        while not self._slots.acquire(timeout=min(0.025, max(0.001, end - time.monotonic()))):
+            check()
+        process = None
+        reader = None
+        chunks = []  # type: list
+        reader_error = []  # type: list
+        overflow = threading.Event()
+        try:
+            check()
+            executable = os.path.abspath(sys.executable) if sys.executable else ""
+            if not executable or not os.path.isfile(executable) or getattr(sys, "frozen", False):
+                raise Error("unsupported", "Host must provide a cancellable resolver")
+            # -I -S 不装载宿主 site/customize；参数不经 shell 或 pickle。
+            with self._lock:
+                if self._closed:
+                    raise Error("closed")
+                process = subprocess.Popen(
+                    [executable, "-I", "-S", "-c", _WORKER, host, str(port)],
+                    stdin=subprocess.DEVNULL,
+                    stdout=subprocess.PIPE,
+                    stderr=subprocess.DEVNULL,
+                    env=_environment(),
+                    shell=False,
+                    close_fds=True,
+                    creationflags=getattr(subprocess, "CREATE_NO_WINDOW", 0),
+                )
+                self._processes.add(process)
+            stdout = process.stdout
+            if stdout is None:
+                raise Error("network", "DNS reply pipe is not available")
+
+            def read_reply() -> None:
+                try:
+                    data = stdout.read(_MAX_REPLY + 1)
+                    chunks.append(data)
+                    if len(data) > _MAX_REPLY:
+                        overflow.set()
+                        process.kill()
+                except (OSError, ValueError) as exc:
+                    reader_error.append(type(exc).__name__)
+
+            reader = threading.Thread(target=read_reply, name="tansr-dns-reply")
+            try:
+                reader.start()
+            except RuntimeError:
+                raise Error("resource_limit", "Cannot start DNS reply reader") from None
+            while process.poll() is None:
+                check()
+                if overflow.is_set():
+                    raise Error("resource_limit")
+                cancel.wait(min(0.02, max(0.001, end - time.monotonic())))
+            reader.join()
+            check()
+            if overflow.is_set():
+                raise Error("resource_limit")
+            if process.returncode != 0 or reader_error or len(chunks) != 1:
+                raise Error("network", "DNS resolution failed")
+            try:
+                values = json.loads(chunks[0].decode("ascii"))
+                if not isinstance(values, list) or not 1 <= len(values) <= _MAX_ADDRESSES:
+                    raise ValueError()
+                result = []
+                for value in values:
+                    if not isinstance(value, list) or len(value) != 2:
+                        raise ValueError()
+                    family, address = value
+                    if type(family) is not int or family not in (socket.AF_INET, socket.AF_INET6):
+                        raise ValueError()
+                    if not isinstance(address, list) or len(address) != (2 if family == socket.AF_INET else 4):
+                        raise ValueError()
+                    if not isinstance(address[0], str) or type(address[1]) is not int or address[1] != port:
+                        raise ValueError()
+                    parsed = ipaddress.ip_address(address[0])
+                    if parsed.version != (4 if family == socket.AF_INET else 6):
+                        raise ValueError()
+                    if family == socket.AF_INET6 and any(
+                        type(v) is not int or not 0 <= v <= 0xFFFFFFFF for v in address[2:]
+                    ):
+                        raise ValueError()
+                    result.append((family, tuple(address)))
+                return result
+            except (ValueError, TypeError, UnicodeError, OverflowError):
+                raise Error("network", "Invalid DNS resolver reply") from None
+        except Error:
+            raise
+        except (OSError, ValueError):
+            cancel.check(deadline_ms)
+            raise Error("network", "Cannot start DNS resolver") from None
+        finally:
+            if process is not None:
+                if process.poll() is None:
+                    try:
+                        process.kill()
+                    except OSError:
+                        if process.poll() is None:
+                            raise
+                process.wait()
+                if reader is not None and reader.ident is not None:
+                    reader.join()
+                if process.stdout is not None:
+                    process.stdout.close()
+                with self._lock:
+                    self._processes.discard(process)
+            self._slots.release()
+
+    def close(self, timeout: float = 30) -> bool:
+        with self._lock:
+            self._closed = True
+            processes = list(self._processes)
+        for process in processes:
+            if process.poll() is None:
+                try:
+                    process.kill()
+                except OSError:
+                    pass
+        end = time.monotonic() + max(0, timeout)
+        while True:
+            with self._lock:
+                if not self._processes:
+                    return True
+            if time.monotonic() >= end:
+                return False
+            time.sleep(0.005)

tansr_sdk-0.1.0/src/tansr_sdk/api/__init__.py

@@ -0,0 +1,4 @@
+from .types import AuthToken, CallOptions, ApiResponse
+from .client import Client, AsyncClient, EventStream, AsyncEventStream
+
+__all__ = ["AuthToken", "CallOptions", "ApiResponse", "Client", "AsyncClient", "EventStream", "AsyncEventStream"]