pyproject.toml

[build-system]
requires = ["setuptools>=45", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "ksadk"
version = "0.8.0"
description = "KsADK Agent Runtime Platform - unified runtime, debugging, deployment and observability for AI agents"
readme = "README.md"
requires-python = ">=3.10"
license = "Apache-2.0"
authors = [
    {name = "KsADK Team", email = "xiayu@kingsoft.com"}
]
keywords = ["agent", "langchain", "langgraph", "deepagents", "adk", "faas", "kingsoft cloud", "ai", "llm"]
classifiers = [
    "Development Status :: 3 - Alpha",
    "Intended Audience :: Developers",
    "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",
    "Topic :: Scientific/Engineering :: Artificial Intelligence",
]
dependencies = [
    # CLI
    "click>=8.0.0",
    # 配置
    "pyyaml>=6.0.0",
    "packaging>=23.0",
    "python-dotenv>=1.0.0",
    "pydantic>=2.0.0,<3.0.0",
    "jsonschema>=4.0.0,<5.0.0",
    "questionary>=2.0.0",
    # TUI 交互界面（prompt_toolkit 全屏布局 + rich 单次渲染依赖）
    "prompt_toolkit>=3.0.0",
    "rich>=13.0.0",
    # API 服务 (run/web 命令)
    "fastapi>=0.100.0,<1.0.0",
    "uvicorn>=0.23.0",
    "python-multipart>=0.0.9,<1.0.0",
    "python-socks>=2.7.1,<3.0.0",
    # RuntimeLocalA2AExternalTransport pins the verified httpx/httpcore direct-pool ABI.
    "httpx>=0.28.1,<0.29.0",
    "httpcore>=1.0.9,<1.1.0",
    # A2A wire 1.0 清洁重写基线 (goal-00): 首期精确锁定 1.1.0。
    # 旧 0.3.x 与 wire 1.0 API 不兼容，不能与 KsADK 0.8 共用一个环境。
    "a2a-sdk[fastapi,postgresql]==1.1.0",
    # A2UI:官方 Python 包(ag-ui-a2ui-toolkit 等)当前仍对齐 v0.9,v1.0(2026-06 Candidate)
    # 尚未进包。B 方案:守 G0.2 冻结 schema,前端已加 v1.0 消息名兼容层(createSurface/
    # updateComponents/deleteSurface),待官方包跟进 v1.0 后整体切换、撤自研 ksadk/a2ui/。
    # 详见 docs/a2ui-v1-alignment-proposal.md。
    "a2ui-core==0.1.1",
    "httpx-sse>=0.4.0",
    "sse-starlette>=2.1.0",
    # HTTP 请求 + AWS 签名
    "requests>=2.28.0",
    "requests-aws4auth>=1.2.0",
    # AICP SDK for default knowledge-base and long-term-memory tools
    "kingsoftcloud-sdk-python>=1.5.8.94",
    "cryptography>=44.0.0",
    "websockets>=12.0,<16.0",
    "qrcode>=7.4.0",
    # 生产多副本共享会话后端
    "asyncpg>=0.30.0,<1.0.0",
    # ADK / SQLAlchemy async session backend 依赖
    "greenlet>=1.0.0",
    # KS3 上传 (build --push)
    "ks3sdk>=1.15.0",
    # ========= 附件处理（默认安装，hosted/local 统一能力） =========
    "pypdf>=6.0.0",
    "beautifulsoup4>=4.12.0",
    "rapidocr-onnxruntime>=1.2.0",
    # ========= 核心框架依赖 (默认安装) =========
    # LangChain
    "langchain>=1.3.14,<2.0.0",
    "langchain-openai>=1.4.0,<2.0.0",
    "langchain-core>=1.5.0,<2.0.0",
    # LangGraph - 使用兼容的版本范围
    "langgraph>=1.2.0,<1.3.0",
    # ========= 可观测性 (默认安装) =========
    # goal-00: 由 ==1.37.0 放宽到 [1.39, 1.41.1],取 adk 1.34.x(otel<=1.41.1)与
    # adk 2.x(otel 1.39~1.42.1)的交集,使默认即可解析到 adk 2.x(支持 2.x)。
    "opentelemetry-api>=1.39.0,<=1.41.1",
    "opentelemetry-sdk>=1.39.0,<=1.41.1",
    "opentelemetry-exporter-otlp>=1.39.0,<=1.41.1",
]

[project.optional-dependencies]
# Google ADK 支持 (goal-00: 1.34.x 为最低锚点,<3.0 上界;1.x/2.x 差异经 ksadk.compat.adk_compat 收口)
adk = [
    "google-adk>=1.34.0,<3.0.0",
    "litellm>=1.0.0; platform_system != 'Windows' or python_version < '3.13'",
    "json_repair>=0.25.0",  # 用于修复大模型输出的非法 JSON
]
# LangChain 支持
langchain = [
    "langchain>=1.3.14,<2.0.0",
    "langchain-openai>=1.4.0,<2.0.0",
    "langchain-core>=1.5.0,<2.0.0",
]
# LangGraph 支持
langgraph = [
    "langgraph>=1.2.0,<1.3.0",
    "langgraph-checkpoint-sqlite>=2.0.0",
    "langchain>=1.3.14,<2.0.0",
    "langchain-openai>=1.4.0,<2.0.0",
    "protobuf>=6.32.1",
]
# DeepAgents 支持（基于 LangGraph）
deepagents = [
    "deepagents>=0.6.2,<1.0.0; python_version >= '3.11'",
    "langgraph>=1.2.0,<1.3.0",
    "langchain>=1.3.14,<2.0.0",
    "langchain-openai>=1.4.0,<2.0.0",
]
# A2A 协议集成 (goal-00: 与主依赖一致精确锁定 wire 1.0 SDK)
a2a = [
    "a2a-sdk[fastapi,postgresql]==1.1.0",
]
# 可观测性
tracing = [
    "openinference-instrumentation-langchain>=0.1.0",
    "langfuse>=3.0.0",
]
# 知识库 & 记忆库支持
kb = []
# Skill Runtime E2B backend
skills = [
    "e2b>=2.15.3,<2.25.0",
]
# Codex Runtime (goal-09): OpenAI 官方 openai-codex SDK,自带 pin 版 CLI 二进制。
# 可选 extra,不进默认依赖(二进制几十 MB);缺依赖时 CodexRuntime 显式报错。
codex = [
    "openai-codex==0.144.4",
]
# Official AG-UI transport. Optional until Hosted UI selects it from bootstrap.
agui = [
    "ag-ui-protocol==0.1.19",
    "ag-ui-langgraph[fastapi]==0.0.42",
    "copilotkit==0.1.94",
]
# 开发依赖
dev = [
    "pytest>=7.0.0",
    "pytest-asyncio>=0.21.0",
    "fastmcp>=2.0.0",
    "build>=1.0.0",
    "twine>=5.0.0",
    "black>=22.0.0",
    "ruff>=0.1.0",
    "mypy>=1.0.0",
    "types-PyYAML>=6.0.0",
    "types-protobuf>=6.32.0",
    "types-python-dateutil>=2.9.0",
    "types-qrcode>=8.2.0",
    "types-requests>=2.32.0",
]
# 全部依赖
all = [
    "ksadk[a2a,adk,agui,langchain,langgraph,deepagents,kb,skills,tracing,dev]",
]

[project.scripts]
agentengine = "ksadk.cli:main"
ksadk = "ksadk.cli:main"

[project.urls]
Homepage = "https://github.com/kingsoftcloud/ksadk-python"
Repository = "https://github.com/kingsoftcloud/ksadk-python"
Documentation = "https://kingsoftcloud.github.io/ksadk-python/"

[tool.setuptools.packages.find]
where = ["."]
include = ["ksadk*", "ksadk_runtime_common*"]
exclude = ["ksadk.server.web-ui*"]

[tool.setuptools.package-data]
ksadk = ["server/static/**/*"]
ksadk_runtime_common = ["schemas/*.json"]

[tool.black]
line-length = 100
target-version = ['py310']

[tool.ruff]
line-length = 100

[tool.ruff.lint]
select = ["E", "F", "W", "I"]

[tool.mypy]
python_version = "3.10"
warn_return_any = true
warn_unused_configs = true

[tool.pytest.ini_options]
testpaths = ["tests"]
python_files = ["test_*.py"]
asyncio_mode = "auto"