ksadk 0.5.0__tar.gz

ksadk-0.5.0/MANIFEST.in

@@ -0,0 +1,2 @@
+prune ksadk/server/web-ui/node_modules
+recursive-exclude ksadk/server/web-ui/node_modules *

ksadk-0.5.0/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: ksadk
+Version: 0.5.0
+Summary: Kingsoft Cloud Agent Development Kit - 支持 LangChain/LangGraph/DeepAgents/ADK/OpenClaw/Hermes 的本地运行与云端部署
+Author-email: KsADK Team <xiayu@kingsoft.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/kingsoftcloud/ksadk-python
+Project-URL: Repository, https://github.com/kingsoftcloud/ksadk-python
+Project-URL: Documentation, https://ksadk.kingsoft.com/docs
+Keywords: agent,langchain,langgraph,deepagents,adk,faas,kingsoft cloud,ai,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pydantic<3.0.0,>=2.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: textual>=0.50.0
+Requires-Dist: fastapi<0.124.0,>=0.100.0
+Requires-Dist: uvicorn>=0.23.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: a2a-sdk>=0.3.22
+Requires-Dist: httpx-sse>=0.4.0
+Requires-Dist: sse-starlette>=2.1.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: requests-aws4auth>=1.2.0
+Requires-Dist: cryptography>=44.0.0
+Requires-Dist: websockets<16.0,>=12.0
+Requires-Dist: qrcode>=7.4.0
+Requires-Dist: ks3sdk>=1.15.0
+Requires-Dist: pypdf>=6.0.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: rapidocr-onnxruntime>=1.2.0
+Requires-Dist: langchain<2.0.0,>=0.3.0
+Requires-Dist: langchain-openai<2.0.0,>=0.2.0
+Requires-Dist: langchain-core<2.0.0,>=0.3.0
+Requires-Dist: langgraph<2.0.0,>=0.2.0
+Requires-Dist: opentelemetry-api==1.37.0
+Requires-Dist: opentelemetry-sdk==1.37.0
+Requires-Dist: opentelemetry-exporter-otlp==1.37.0
+Provides-Extra: adk
+Requires-Dist: google-adk>=1.0.0; extra == "adk"
+Requires-Dist: litellm>=1.0.0; extra == "adk"
+Requires-Dist: json_repair>=0.25.0; extra == "adk"
+Provides-Extra: langchain
+Requires-Dist: langchain>=0.3.0; extra == "langchain"
+Requires-Dist: langchain-openai>=0.2.0; extra == "langchain"
+Requires-Dist: langchain-core>=0.3.0; extra == "langchain"
+Provides-Extra: langgraph
+Requires-Dist: langgraph>=0.2.0; extra == "langgraph"
+Requires-Dist: langchain>=0.3.0; extra == "langgraph"
+Requires-Dist: langchain-openai>=0.2.0; extra == "langgraph"
+Requires-Dist: protobuf>=6.32.1; extra == "langgraph"
+Provides-Extra: deepagents
+Requires-Dist: deepagents>=0.3.0; python_version >= "3.11" and extra == "deepagents"
+Requires-Dist: langgraph>=0.2.0; extra == "deepagents"
+Requires-Dist: langchain>=0.3.0; extra == "deepagents"
+Requires-Dist: langchain-openai>=0.2.0; extra == "deepagents"
+Provides-Extra: a2a
+Requires-Dist: a2a-sdk[http-server]>=0.3.22; extra == "a2a"
+Provides-Extra: tracing
+Requires-Dist: openinference-instrumentation-langchain>=0.1.0; extra == "tracing"
+Provides-Extra: kb
+Requires-Dist: kingsoftcloud-sdk-python>=1.5.8.71; extra == "kb"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: ksadk[a2a,adk,deepagents,dev,kb,langchain,langgraph,tracing]; extra == "all"
+
+# ksadk (AgentEngine CLI)
+
+`ksadk` 是金山云 Agent 开发与部署工具链，统一提供本地调试、构建部署、远端资源管理，以及平台级 KB/LTM、MCP、OpenClaw、Hermes 接入能力。
+
+当前版本：`0.5.0`
+
+## 0.5.0 亮点
+
+- `Hermes` 正式进入 ksadk 主线，新增独立资源组、共享 runtime 镜像和原生远程 TUI。
+- OpenClaw 新增用户自定义镜像模板，适合直接打包给业务或客户做二次定制。
+- `agentengine openclaw deploy` 新增 `--env KEY=VALUE` 透传，可把业务自定义环境变量直接注入容器。
+- 新增 `agentengine openclaw repair` 与 `agentengine openclaw gateway doctor --fix`，补齐控制面修复入口。
+
+## 安装
+
+```bash
+pip install -U ksadk
+```
+
+可选依赖：
+
+```bash
+pip install "ksadk[langgraph]"
+pip install "ksadk[langchain]"
+pip install "ksadk[deepagents]"
+pip install "ksadk[adk]"
+pip install "ksadk[kb]"
+```
+
+命令入口等价：
+
+```bash
+agentengine --help
+ksadk --help
+```
+
+## 最快路径
+
+### 1. 本地运行
+
+```bash
+agentengine init my_agent -f langgraph
+cd my_agent
+agentengine config
+agentengine run -i
+# 或
+agentengine web --port 8080
+```
+
+### 2. 一键部署代码框架
+
+```bash
+export KSYUN_ACCESS_KEY=your-ak
+export KSYUN_SECRET_KEY=your-sk
+export KSYUN_ACCOUNT_ID=your-account-id
+export KSYUN_REGION=cn-beijing-6
+
+agentengine launch . --target serverless
+```
+
+### 3. Hermes 云端托管
+
+```bash
+export KSYUN_ACCESS_KEY=your-ak
+export KSYUN_SECRET_KEY=your-sk
+export KSYUN_ACCOUNT_ID=your-account-id
+export KSYUN_REGION=pre-online
+export OPENAI_API_KEY=your-model-key
+export OPENAI_BASE_URL=http://kspmas.ksyun.com/v1
+export OPENAI_MODEL_NAME=glm-5.1
+
+agentengine init demo-hermes -f hermes
+cd demo-hermes
+agentengine hermes deploy --name demo-hermes
+agentengine invoke demo-hermes
+```
+
+说明：
+
+- `agentengine hermes deploy` 默认使用共享 Hermes runtime 镜像，不走本地 build/push。
+- 如果注入的是 `kspmas.ksyun.com` 公网模型地址，CLI 会在云端 runtime 配置里自动改写为 `kspmas-internal.sdns.ksyun.com`，避免预发 / 线上 Pod 访问公网网关超时。
+- `agentengine invoke <hermes-agent>` 默认进入 Hermes 原生远程 TUI；浏览器聊天页请用 `agentengine hermes open --chat`。
+
+### 4. 打开云端 UI
+
+```bash
+agentengine dashboard open
+# 或显式指定 Agent
+agentengine dashboard open --agent ar-xxxx
+```
+
+## 主文档
+
+- [使用文档](./docs/ksadk_usage_guide.md)
+- [技术文档](./docs/ksadk_technical_design.md)
+
+## 专题参考
+
+- [DeepAgents 框架参考](./docs/deepagents.md)
+- [KB / LTM 示例参考](./docs/knowledge_base_and_memory_examples.md)
+- [ADK 记忆能力专项参考](./docs/memory_usage_guide.md)
+- [OpenClaw 一键部署与接入参考](./docs/openclaw_client_one_click_deploy.md)
+- [OpenClaw 用户自定义镜像模板参考](./deploy/openclaw-user-template/README.md)
+- [Hermes Agent 本地安装、云端部署与远程 TUI 参考](./docs/hermes-agent-v2026.4.13_本地安装配置与ksadk接入流程.md)
+- [Hermes Runtime 共享镜像与运行时约定](./deploy/hermes/README.md)
+- [Runner Approval 架构草案](./docs/Runner_Approval_Architecture.md)
+
+## 说明
+
+- `README` 现在只保留入口信息，不再承载完整命令说明。
+- 完整 CLI 路径、环境变量、KB/LTM、MCP、OpenClaw、Hermes、JSON 输出等说明统一收口到 [使用文档](./docs/ksadk_usage_guide.md)。
+- 当前实现设计、核心子系统、关键调用链和与 `agentengine-server` 的边界统一收口到 [技术文档](./docs/ksadk_technical_design.md)。

ksadk-0.5.0/README.md

@@ -0,0 +1,112 @@
+# ksadk (AgentEngine CLI)
+
+`ksadk` 是金山云 Agent 开发与部署工具链，统一提供本地调试、构建部署、远端资源管理，以及平台级 KB/LTM、MCP、OpenClaw、Hermes 接入能力。
+
+当前版本：`0.5.0`
+
+## 0.5.0 亮点
+
+- `Hermes` 正式进入 ksadk 主线，新增独立资源组、共享 runtime 镜像和原生远程 TUI。
+- OpenClaw 新增用户自定义镜像模板，适合直接打包给业务或客户做二次定制。
+- `agentengine openclaw deploy` 新增 `--env KEY=VALUE` 透传，可把业务自定义环境变量直接注入容器。
+- 新增 `agentengine openclaw repair` 与 `agentengine openclaw gateway doctor --fix`，补齐控制面修复入口。
+
+## 安装
+
+```bash
+pip install -U ksadk
+```
+
+可选依赖：
+
+```bash
+pip install "ksadk[langgraph]"
+pip install "ksadk[langchain]"
+pip install "ksadk[deepagents]"
+pip install "ksadk[adk]"
+pip install "ksadk[kb]"
+```
+
+命令入口等价：
+
+```bash
+agentengine --help
+ksadk --help
+```
+
+## 最快路径
+
+### 1. 本地运行
+
+```bash
+agentengine init my_agent -f langgraph
+cd my_agent
+agentengine config
+agentengine run -i
+# 或
+agentengine web --port 8080
+```
+
+### 2. 一键部署代码框架
+
+```bash
+export KSYUN_ACCESS_KEY=your-ak
+export KSYUN_SECRET_KEY=your-sk
+export KSYUN_ACCOUNT_ID=your-account-id
+export KSYUN_REGION=cn-beijing-6
+
+agentengine launch . --target serverless
+```
+
+### 3. Hermes 云端托管
+
+```bash
+export KSYUN_ACCESS_KEY=your-ak
+export KSYUN_SECRET_KEY=your-sk
+export KSYUN_ACCOUNT_ID=your-account-id
+export KSYUN_REGION=pre-online
+export OPENAI_API_KEY=your-model-key
+export OPENAI_BASE_URL=http://kspmas.ksyun.com/v1
+export OPENAI_MODEL_NAME=glm-5.1
+
+agentengine init demo-hermes -f hermes
+cd demo-hermes
+agentengine hermes deploy --name demo-hermes
+agentengine invoke demo-hermes
+```
+
+说明：
+
+- `agentengine hermes deploy` 默认使用共享 Hermes runtime 镜像，不走本地 build/push。
+- 如果注入的是 `kspmas.ksyun.com` 公网模型地址，CLI 会在云端 runtime 配置里自动改写为 `kspmas-internal.sdns.ksyun.com`，避免预发 / 线上 Pod 访问公网网关超时。
+- `agentengine invoke <hermes-agent>` 默认进入 Hermes 原生远程 TUI；浏览器聊天页请用 `agentengine hermes open --chat`。
+
+### 4. 打开云端 UI
+
+```bash
+agentengine dashboard open
+# 或显式指定 Agent
+agentengine dashboard open --agent ar-xxxx
+```
+
+## 主文档
+
+- [使用文档](./docs/ksadk_usage_guide.md)
+- [技术文档](./docs/ksadk_technical_design.md)
+
+## 专题参考
+
+- [DeepAgents 框架参考](./docs/deepagents.md)
+- [KB / LTM 示例参考](./docs/knowledge_base_and_memory_examples.md)
+- [ADK 记忆能力专项参考](./docs/memory_usage_guide.md)
+- [OpenClaw 一键部署与接入参考](./docs/openclaw_client_one_click_deploy.md)
+- [OpenClaw 用户自定义镜像模板参考](./deploy/openclaw-user-template/README.md)
+- [Hermes Agent 本地安装、云端部署与远程 TUI 参考](./docs/hermes-agent-v2026.4.13_本地安装配置与ksadk接入流程.md)
+- [Hermes Runtime 共享镜像与运行时约定](./deploy/hermes/README.md)
+- [Runner Approval 架构草案](./docs/Runner_Approval_Architecture.md)
+
+## 说明
+
+- `README` 现在只保留入口信息，不再承载完整命令说明。
+- 完整 CLI 路径、环境变量、KB/LTM、MCP、OpenClaw、Hermes、JSON 输出等说明统一收口到 [使用文档](./docs/ksadk_usage_guide.md)。
+- 当前实现设计、核心子系统、关键调用链和与 `agentengine-server` 的边界统一收口到 [技术文档](./docs/ksadk_technical_design.md)。

ksadk-0.5.0/ksadk/__init__.py

@@ -0,0 +1,12 @@
+"""
+KsADK: Kingsoft Cloud Agent Development Kit
+
+支持 LangChain / LangGraph / Google ADK 多框架的本地运行与云端部署
+"""
+
+from ksadk.version import VERSION
+
+__version__ = VERSION
+__author__ = "KsADK Team"
+
+__all__ = ["VERSION"]

ksadk-0.5.0/ksadk/__main__.py

@@ -0,0 +1,4 @@
+from ksadk.cli import main
+
+if __name__ == "__main__":
+    main()

ksadk-0.5.0/ksadk/a2a/__init__.py

@@ -0,0 +1,15 @@
+"""A2A protocol helpers for KsADK runners and remote agents."""
+
+from ksadk.a2a.card_builder import AgentCardBuilder
+from ksadk.a2a.client import RemoteA2AAgent, RemoteA2AClient
+from ksadk.a2a.executor import KsAgentExecutor
+from ksadk.a2a.server import KsA2AServer, to_a2a
+
+__all__ = [
+    "AgentCardBuilder",
+    "KsA2AServer",
+    "KsAgentExecutor",
+    "RemoteA2AAgent",
+    "RemoteA2AClient",
+    "to_a2a",
+]

ksadk-0.5.0/ksadk/a2a/card_builder.py

@@ -0,0 +1,64 @@
+"""Helpers for building A2A agent cards."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+from a2a.types import AgentCapabilities, AgentCard, AgentSkill
+
+_DEFAULT_IO_MODES = ["text/plain"]
+
+
+class AgentCardBuilder:
+    """Build an A2A AgentCard for a KsADK runner."""
+
+    def __init__(
+        self,
+        name: str,
+        url: str,
+        description: str = "",
+        skills: Sequence[str] | None = None,
+        version: str = "1.0.0",
+    ) -> None:
+        self.name = name
+        self.url = url.rstrip("/") or url
+        self.description = description or f"{name} agent powered by ksadk"
+        self.skills = list(skills or [])
+        self.version = version
+
+    def build(self) -> AgentCard:
+        """Create the final A2A agent card."""
+        return AgentCard(
+            name=self.name,
+            description=self.description,
+            url=self.url,
+            version=self.version,
+            capabilities=AgentCapabilities(
+                streaming=True,
+                push_notifications=False,
+            ),
+            default_input_modes=list(_DEFAULT_IO_MODES),
+            default_output_modes=list(_DEFAULT_IO_MODES),
+            skills=self._build_skills(),
+        )
+
+    def _build_skills(self) -> list[AgentSkill]:
+        if not self.skills:
+            return [
+                AgentSkill(
+                    id="general",
+                    name="General",
+                    description="General purpose agent powered by ksadk",
+                    tags=["general"],
+                )
+            ]
+
+        return [
+            AgentSkill(
+                id=skill,
+                name=skill.replace("_", " ").title(),
+                description=f"Skill: {skill}",
+                tags=[skill],
+            )
+            for skill in self.skills
+        ]