managed-agent-sdk 0.0.1__tar.gz

managed_agent_sdk-0.0.1/.gitignore

@@ -0,0 +1,43 @@
+# ── Node ────────────────────────────────
+node_modules/
+dist/
+lib/
+*.tsbuildinfo
+.pnpm-store/
+
+# ── Python ──────────────────────────────
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+.venv/
+venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# ── 测试覆盖率报告 ──────────────────────
+coverage/
+.coverage
+
+# ── 中间结果（脚本临时产物统一落这里）──────
+.scratch/
+
+# ── 本地环境（含真实凭证，永不入仓）──────
+# 两行都需要：`.env.*` 不匹配无后缀的 `.env`
+.env
+.env.*
+# 模板例外 —— 不含真实值，新人靠它起步。
+# 没有这条负例时 .env.example 会被上面一行盖住，
+# 当前它只因「已被跟踪」才幸免，换个仓库或重新 add 就会失效。
+!.env.example
+
+# 发布时注入 npm token 的鉴权文件。
+# 根 .npmrc 只配镜像源、需入库共享，故这里只忽略包目录下的。
+packages/*/.npmrc
+
+# 交付给测试的打包产物（pnpm pack / uv build 的输出）
+dist-release/
+packages/*/*.tgz
+
+.DS_Store

managed_agent_sdk-0.0.1/CHANGELOG.md

@@ -0,0 +1,90 @@
+# 更新日志
+
+managed-agent-sdk（Python）的所有重要更新都会记录在这里。
+
+遵循 [语义化版本](https://semver.org/spec/v2.0.0.html)。
+
+## [0.0.1] - 2026-09-22
+
+首个版本。行为与 Node 版对齐，两侧由一份共享用例（`spec/cases/`）保证一致。
+
+### 运行环境
+
+要求 Python >= 3.10, < 3.15。全异步 API（`async`/`await`），基于 httpx。
+
+### 🎉 新功能
+
+**控制面**（走腾讯云 API，官方 SDK 签名）
+
+- `client.agents` —— Agent 的增删改查、路由权重灰度（`update_routing`）、
+  A2A Inbound 配置
+- `agent.versions` —— 版本创建（含从源版本派生）、查询、修改。
+  `create` / `create_from_source` 恒发 `IsTest: true`，不把「建出 prod 版本」
+  这个选择交给调用方
+- `agent.sessions` / `client.sessions` —— 会话创建、查询、跨版本迁移
+- `agent.external_agents` —— A2A Outbound 的绑定与解绑
+- `client.models` —— 内置模型列表
+
+**数据面**（走 ACP 协议）
+
+- `session.prompt()` 流式对话，支持多模态 image block。返回值是 SDK 收窄过的
+  `PromptResponse`（`managed_agent_sdk.acp_types`），**只有 `stop_reason`** ——
+  上游 `acp.schema.PromptResponse` 还带 `usage` / `_meta`，但服务端实测恒为
+  `None`，透出去会让人以为能从这里读用量。要读用量走 `session.messages()` 的
+  `Message["TokenUsage"]`（与 Node 版 `Pick<…, 'stopReason'>` 对齐）
+- `session.subscribe()` 订阅上游通知、`cancel()` 取消进行中的回合
+- SSE 断线自动重连（连接层状态恢复，**不重放 prompt**）
+- 两段凭证（云 API 密钥 + OneID 换票）由 SDK 内部缝合，调用方无需感知
+- 建连只发 `Authorization: Bearer` + `X-Agent-Session-Id`。网关的 oneid-auth
+  插件按 Bearer 令牌本身本地验签，**不能再带 `X-Auth-Method: oneid`** ——
+  带上会走旧的鉴权分支并被拒（401 `oneid token invalid: not_oneid`）
+- 数据面每次请求（建连 / 重连 / POST / DELETE）前取新鲜 token。OneID token
+  有效期 30 天，长连接会跨过它 —— 只在建连时取一次的话，过期后所有请求都
+  带着废票发。取票走 client 级缓存（提前 5 分钟换新、并发合并），每次调用
+  的开销只是一次判时间
+- 建连遇到 401 / 403 立即失败并抛 `AcpAuthError`，不进重连循环 ——
+  鉴权失败重试改变不了结果，只会把失败拖到握手超时，报出「网络超时」
+  掩盖真实原因。异常带服务端原文与 `request_id`（`x-request-id`），
+  可直接交给服务端排查；其余状态码仍按原重连策略走
+
+**目录资源**
+
+- 连接器（`client.connectors`）、技能（`client.skills`）、专家（`client.experts`）
+- 连接器绑定用 `connector_ids` 声明最终集合，服务端按它全量覆盖；
+  传空列表即解绑全部
+- `ManifestBuilder` —— 类型化构建 manifest，本地校验对齐服务端 v2 白名单
+
+**类型与配置**
+
+- 随包附带 `py.typed`，mypy / pyright 可直接吃到类型
+- `ClientOpts.transport` 可注入自定义 httpx transport（链路追踪 / 代理 /
+  测试替身），只影响数据面；控制面由官方 SDK 发请求，用 `proxy` 配置
+
+### ⚠️ 需要注意的行为
+
+**分页 `limit` 上限统一为 100**，各列表方法一致。超限本地抛
+`ValidationError`，不发请求。
+
+**`offset` 必须是 `limit` 的整数倍**，全部列表方法一致，否则抛
+`ValidationError`：
+
+```python
+await client.agents.list(PageOpts(offset=30, limit=20))  # ValidationError
+await client.agents.list(PageOpts(offset=40, limit=20))  # 正常
+```
+
+省略 `limit` 时按默认的 20 校验边界。
+
+**不做控制面自动重试。** `create_*` 类接口非幂等且服务端不提供 `ClientToken`，
+重试 `create_session` 会重复拉起沙箱并产生真实费用。`CapiError.retryable`
+仅作信息提示，由调用方决定是否重试。
+
+**出参保持云 API 原样**（PascalCase、不翻译枚举、不过滤零值），抓包所见即
+所得，拿着云 API 文档就能对照。入参则提供 snake_case 便利层。
+
+**会话沙箱不会自动回收**，用完请 `await session.disconnect()`。
+
+### 🔧 协议兼容
+
+`Usage.total_tokens` 按 ACP 协议声明是必填字段。本侧走 pydantic 运行时校验，
+已在 `acp/compat.py` 放宽该约束以兼容实际返回（Node 侧无运行时校验，不受影响）。

managed_agent_sdk-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tencent CodeBuddy
+
+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.

managed_agent_sdk-0.0.1/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.5
+Name: managed-agent-sdk
+Version: 0.0.1
+Summary: Managed Agent SDK (Python) — 控制面走腾讯云 API，数据面走 ACP
+Project-URL: Homepage, https://cnb.cool/codebuddy/managed-agent-sdk
+Project-URL: Repository, https://cnb.cool/codebuddy/managed-agent-sdk
+Project-URL: Issues, https://cnb.cool/codebuddy/managed-agent-sdk/-/issues
+Project-URL: Changelog, https://cnb.cool/codebuddy/managed-agent-sdk/-/blob/main/packages/python/CHANGELOG.md
+Author-email: Tencent CodeBuddy <codebuddy@tencent.com>
+License: MIT
+License-File: LICENSE
+Keywords: acp,agent,llm,managed-agent,sandbox
+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.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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: <3.15,>=3.10
+Requires-Dist: agent-client-protocol<0.13,>=0.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.6
+Requires-Dist: tencentcloud-sdk-python-common>=3.0.1000
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: uvicorn>=0.30; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# managed-agent-sdk（Python）
+
+腾讯云 **WorkBuddy 企业版 Managed Agent** 的 Python SDK。
+
+控制面走腾讯云 API（TC3 签名），数据面走 ACP 协议，两段凭证由 SDK 内部缝合。
+
+```bash
+pip install managed-agent-sdk
+```
+
+要求 Python 3.10 ~ 3.14。Node 版见 [`@tencent-ai/managed-agent-sdk`](https://www.npmjs.com/package/@tencent-ai/managed-agent-sdk)，两侧 API 语义一致。
+
+## 凭证
+
+从环境变量读取，或在构造时显式传入：
+
+```bash
+export TENCENTCLOUD_SECRET_ID=你的SecretId
+export TENCENTCLOUD_SECRET_KEY=你的SecretKey
+```
+
+只支持长期密钥，不支持 STS 临时密钥。数据面（ACP）的凭证由 SDK 用这套密钥自动换取并缓存，无需单独配置。
+
+## 快速开始
+
+```python
+import asyncio
+
+from managed_agent_sdk import (
+    CreateAgentOpts,
+    CreateSessionOpts,
+    CreateVersionOpts,
+    ManagedAgentClient,
+    ManifestBuilder,
+)
+
+
+async def main() -> None:
+    async with ManagedAgentClient() as client:
+        # 创建 Agent
+        agent = await client.agents.create(
+            CreateAgentOpts(
+                agent_name="日志分析助手",
+                model="deepseek-v3",
+                manifest=ManifestBuilder().system_prompt("你是日志分析专家").build(),
+            )
+        )
+
+        # 创建版本（manifest 服务端必填）
+        version = await agent.versions.create(
+            CreateVersionOpts(
+                manifest=ManifestBuilder().system_prompt("你是日志分析专家").build(),
+            )
+        )
+
+        # 创建会话（拉起真实沙箱，不会自动回收 —— 尽量复用）
+        session = await agent.sessions.create(
+            CreateSessionOpts(version_id=version.version_id)
+        )
+
+        # 对话
+        res = await session.prompt("分析这份日志")
+        print(res.stop_reason)
+
+        await session.disconnect()
+
+
+asyncio.run(main())
+```
+
+`prompt()` 的返回值只携带 `stop_reason`，回复文本从 `on_chunk` 取 —— 流式内容与终局结果分两条通道，这是 ACP 的协议设计。
+
+## 配置连接器 / 技能 / 专家
+
+三类资源的**配置入口不统一**，这是最容易配错的地方：
+
+| 资源 | 查询 | 配置入口 | 最终落点 |
+| --- | --- | --- | --- |
+| 连接器（MCP） | `client.connectors.list()` | `connector_ids`（Action 入参） | 服务端物化成 manifest 的 `mcp_servers` |
+| 技能 | `client.skills.list()` | `ManifestBuilder.skills()` | manifest 的 `skills` |
+| 专家 | `client.experts.list()` | `ManifestBuilder.experts()` | manifest 的 `experts` |
+
+技能与专家进 manifest，连接器**不进** —— 只把 ID 交给服务端，由它查网关地址后物化。
+自己往 manifest 里写 `mcp_servers` 会与之重复。
+
+```python
+skills = await client.skills.list("BUILTIN", ListSkillsOpts(limit=50))
+connectors = await client.connectors.list_active()
+
+agent = await client.agents.create(
+    CreateAgentOpts(
+        agent_name="运维助手",
+        manifest=(
+            ManifestBuilder()
+            .system_prompt("你是运维专家")
+            .skills([{"type": "builtin", "id": s["SkillId"]} for s in skills.items])
+            .build()
+        ),
+        connector_ids=[c["ConnectorId"] for c in connectors.items],  # 独立入参
+    )
+)
+```
+
+`connector_ids` 是该版本最终要绑的完整集合，服务端按它做全量覆盖 ——
+改绑定直接传新集合，解绑从列表里去掉即可，传 `[]` 解绑全部。
+
+## 两条约定
+
+**入参 snake_case，出参 PascalCase。** 出参原样透传云 API 字段名，便于对照官方文档排查。
+
+**不做控制面自动重试。** `Create*` 类接口非幂等且服务端不提供 `ClientToken`，重试 `sessions.create()` 会重复拉起沙箱并产生真实费用。唯一例外是 ACP 断线重连（`Last-Event-ID` 断点续传，不重放 prompt）。
+
+**会话即沙箱，且不会自动回收。** `sessions.create()` 每次调用都拉起一个真实沙箱。注意 `disconnect()` **只断 ACP 连接，不释放沙箱** —— 服务端既没有销毁会话的接口，也没有空闲超时回收（`IDLE` 只是「上一轮对话结束」的轮次状态，沙箱照常运行）。要复用会话，别在循环里反复新建。
+
+## 文档
+
+完整 API 参考、错误码表、已知问题见
+[Managed Agent SDK 文档](https://cnb.cool/codebuddy/managed-agent-doc/-/blob/main/python/README.md)。

managed_agent_sdk-0.0.1/README.md

@@ -0,0 +1,118 @@
+# managed-agent-sdk（Python）
+
+腾讯云 **WorkBuddy 企业版 Managed Agent** 的 Python SDK。
+
+控制面走腾讯云 API（TC3 签名），数据面走 ACP 协议，两段凭证由 SDK 内部缝合。
+
+```bash
+pip install managed-agent-sdk
+```
+
+要求 Python 3.10 ~ 3.14。Node 版见 [`@tencent-ai/managed-agent-sdk`](https://www.npmjs.com/package/@tencent-ai/managed-agent-sdk)，两侧 API 语义一致。
+
+## 凭证
+
+从环境变量读取，或在构造时显式传入：
+
+```bash
+export TENCENTCLOUD_SECRET_ID=你的SecretId
+export TENCENTCLOUD_SECRET_KEY=你的SecretKey
+```
+
+只支持长期密钥，不支持 STS 临时密钥。数据面（ACP）的凭证由 SDK 用这套密钥自动换取并缓存，无需单独配置。
+
+## 快速开始
+
+```python
+import asyncio
+
+from managed_agent_sdk import (
+    CreateAgentOpts,
+    CreateSessionOpts,
+    CreateVersionOpts,
+    ManagedAgentClient,
+    ManifestBuilder,
+)
+
+
+async def main() -> None:
+    async with ManagedAgentClient() as client:
+        # 创建 Agent
+        agent = await client.agents.create(
+            CreateAgentOpts(
+                agent_name="日志分析助手",
+                model="deepseek-v3",
+                manifest=ManifestBuilder().system_prompt("你是日志分析专家").build(),
+            )
+        )
+
+        # 创建版本（manifest 服务端必填）
+        version = await agent.versions.create(
+            CreateVersionOpts(
+                manifest=ManifestBuilder().system_prompt("你是日志分析专家").build(),
+            )
+        )
+
+        # 创建会话（拉起真实沙箱，不会自动回收 —— 尽量复用）
+        session = await agent.sessions.create(
+            CreateSessionOpts(version_id=version.version_id)
+        )
+
+        # 对话
+        res = await session.prompt("分析这份日志")
+        print(res.stop_reason)
+
+        await session.disconnect()
+
+
+asyncio.run(main())
+```
+
+`prompt()` 的返回值只携带 `stop_reason`，回复文本从 `on_chunk` 取 —— 流式内容与终局结果分两条通道，这是 ACP 的协议设计。
+
+## 配置连接器 / 技能 / 专家
+
+三类资源的**配置入口不统一**，这是最容易配错的地方：
+
+| 资源 | 查询 | 配置入口 | 最终落点 |
+| --- | --- | --- | --- |
+| 连接器（MCP） | `client.connectors.list()` | `connector_ids`（Action 入参） | 服务端物化成 manifest 的 `mcp_servers` |
+| 技能 | `client.skills.list()` | `ManifestBuilder.skills()` | manifest 的 `skills` |
+| 专家 | `client.experts.list()` | `ManifestBuilder.experts()` | manifest 的 `experts` |
+
+技能与专家进 manifest，连接器**不进** —— 只把 ID 交给服务端，由它查网关地址后物化。
+自己往 manifest 里写 `mcp_servers` 会与之重复。
+
+```python
+skills = await client.skills.list("BUILTIN", ListSkillsOpts(limit=50))
+connectors = await client.connectors.list_active()
+
+agent = await client.agents.create(
+    CreateAgentOpts(
+        agent_name="运维助手",
+        manifest=(
+            ManifestBuilder()
+            .system_prompt("你是运维专家")
+            .skills([{"type": "builtin", "id": s["SkillId"]} for s in skills.items])
+            .build()
+        ),
+        connector_ids=[c["ConnectorId"] for c in connectors.items],  # 独立入参
+    )
+)
+```
+
+`connector_ids` 是该版本最终要绑的完整集合，服务端按它做全量覆盖 ——
+改绑定直接传新集合，解绑从列表里去掉即可，传 `[]` 解绑全部。
+
+## 两条约定
+
+**入参 snake_case，出参 PascalCase。** 出参原样透传云 API 字段名，便于对照官方文档排查。
+
+**不做控制面自动重试。** `Create*` 类接口非幂等且服务端不提供 `ClientToken`，重试 `sessions.create()` 会重复拉起沙箱并产生真实费用。唯一例外是 ACP 断线重连（`Last-Event-ID` 断点续传，不重放 prompt）。
+
+**会话即沙箱，且不会自动回收。** `sessions.create()` 每次调用都拉起一个真实沙箱。注意 `disconnect()` **只断 ACP 连接，不释放沙箱** —— 服务端既没有销毁会话的接口，也没有空闲超时回收（`IDLE` 只是「上一轮对话结束」的轮次状态，沙箱照常运行）。要复用会话，别在循环里反复新建。
+
+## 文档
+
+完整 API 参考、错误码表、已知问题见
+[Managed Agent SDK 文档](https://cnb.cool/codebuddy/managed-agent-doc/-/blob/main/python/README.md)。

managed_agent_sdk-0.0.1/pyproject.toml

@@ -0,0 +1,140 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "managed-agent-sdk"
+dynamic = ["version"]
+description = "Managed Agent SDK (Python) — 控制面走腾讯云 API，数据面走 ACP"
+readme = "README.md"
+requires-python = ">=3.10,<3.15"
+license = { text = "MIT" }
+authors = [{ name = "Tencent CodeBuddy", email = "codebuddy@tencent.com" }]
+keywords = [
+    "agent",
+    "acp",
+    "managed-agent",
+    "llm",
+    "sandbox",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "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",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx>=0.27",
+    "pydantic>=2.6",
+    # 锁到次版本：本 SDK 依赖上游的内部结构 —— acp/compat.py 给 pydantic 模型
+    # 打补丁放宽必填字段，set_session_model 直连私有属性
+    # ClientSideConnection._conn 发不带下划线前缀的方法名。0.x 阶段每个次版本
+    # 都可能改这些，放到 <1.0 等于让新用户装到未验证过的组合。
+    # 升级上游时连同 compat.py 一起验证，再手工放宽这里。
+    "agent-client-protocol>=0.12,<0.13",
+    # Managed Agent 控制面走云 API，签名与信封拆解交给官方 SDK
+    "tencentcloud-sdk-python-common>=3.0.1000",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.23",
+    "respx>=0.21",
+    "uvicorn>=0.30",
+    "mypy>=1.10",
+    "ruff>=0.5",
+]
+
+[project.urls]
+Homepage = "https://cnb.cool/codebuddy/managed-agent-sdk"
+Repository = "https://cnb.cool/codebuddy/managed-agent-sdk"
+Issues = "https://cnb.cool/codebuddy/managed-agent-sdk/-/issues"
+Changelog = "https://cnb.cool/codebuddy/managed-agent-sdk/-/blob/main/packages/python/CHANGELOG.md"
+
+# ─── Hatchling ────────────────────────────────
+
+[tool.hatch.version]
+path = "src/managed_agent_sdk/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/managed_agent_sdk"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src/managed_agent_sdk",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "pyproject.toml",
+]
+
+# ─── Ruff ────────────────────────────────────
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src", "e2e"]
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "UP",  # pyupgrade
+    "SIM", # flake8-simplify
+    "RUF", # ruff-specific
+]
+ignore = [
+    "E501",   # line too long — 交给 ruff format
+    "B008",   # function call in default arg — dataclass 经常需要
+    "RUF001", # ambiguous chars in string — 中文文档正常
+    "RUF002", # ambiguous chars in docstring — 中文文档正常
+    "RUF003", # ambiguous chars in comment — 中文注释正常
+    "RUF012", # mutable class attr default — pydantic 模型会为每实例深拷贝默认值，无共享引用风险
+    "RUF022", # `__all__` is not sorted — 语义分组优先
+    "SIM105", # contextlib.suppress — try/except/pass 对热路径更直观
+]
+
+[tool.ruff.lint.per-file-ignores]
+"e2e/**" = ["E402"]  # 联调脚本需在 import 前注入 sys.path
+
+# ─── Mypy ────────────────────────────────────
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+warn_return_any = true
+no_implicit_reexport = false  # __init__.py 里的 re-export 是明确的
+files = ["src/managed_agent_sdk"]
+
+[[tool.mypy.overrides]]
+module = [
+    "acp.*",
+    "agent_client_protocol.*",
+    "httpx",
+    "httpx.*",
+    # 腾讯云官方 SDK 未提供 py.typed
+    "tencentcloud.*",
+]
+ignore_missing_imports = true
+
+# ─── Pytest ──────────────────────────────────
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+python_files = ["*_test.py"]
+pythonpath = ["src"]
+addopts = "-ra -q"