Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 0 additions & 12 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,18 +41,6 @@ agentengine web . --no-open

<p align="center"><img alt="Real local Web UI demo" src="docs-site/public/assets/ksadk-local-debugging-demo.gif" width="860" /></p>

## 0.8.0 Review Candidate

`0.8.0` is an in-review candidate branch, not a published PyPI or npm release. It brings RuntimeEvent, AG-UI/A2UI, A2A, Harness, and CodexRuntime into one runtime boundary while retaining the `/v1/responses` and `/v1/chat/completions` compatibility surfaces.

- **Hosted UI:** AG-UI/A2UI is capability-selected; the established Responses transport remains the fallback when it is unavailable.
- **Event diagnosis:** `ksadk replay <session-id>` reads persisted RuntimeEvent history and can narrow investigation with `--after-seq-id` / `--before-seq-id`. It never runs a model, tool, or approval side effect again.
- **Managed A2A (experimental):** AgentEngine composes trusted ingress through its Gateway and Space-scoped outbound clients. The first external-Agent release supports only `external_public`, governed by `Network.EnablePublicAccess` and a constrained NAT transport; `external_vpc` is not yet available.
- **Codex Managed Runtime (new):** use an `agentengine.yaml` without `agent.py` to debug Codex natively on macOS, Windows, and Linux. Direct deployment sends an inline manifest rather than a KS3 code archive; the cloud selects a pinned Linux Runtime image.
- **Framework migration:** Prefer LangGraph, Google ADK, or the `RuntimeAdapter` contract for new integrations. Legacy LangChain continuity/HITL is not a `0.8` compatibility commitment.

Read the [Codex Managed Runtime guide](https://kingsoftcloud.github.io/ksadk-python/en/docs/framework/guides/managed-runtime/), the [Hosted UI and event replay guide](https://kingsoftcloud.github.io/ksadk-python/en/docs/framework/guides/hosted-ui-events/), the [managed A2A Runtime guide](https://kingsoftcloud.github.io/ksadk-python/en/docs/framework/guides/a2a-runtime/), the [HarnessApp guide](https://kingsoftcloud.github.io/ksadk-python/en/docs/framework/guides/harness-app/), and the [0.8.0 changelog](CHANGELOG.md).

## Why KsADK

Most agent frameworks solve how to build agents. KsADK solves how to run, debug, deploy, and observe them.
Expand Down
12 changes: 0 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,18 +41,6 @@ agentengine web . --no-open

<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif"><img alt="KsADK 真实本地 Web UI 演示" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif" width="860" /></a></p>

## 0.8.0 评审候选

`0.8.0` 是正在评审的候选分支,不是已发布的 PyPI/npm 版本。它把 RuntimeEvent、AG-UI/A2UI、A2A、Harness 和 CodexRuntime 统一到同一运行时边界,同时保持 `/v1/responses` 和 `/v1/chat/completions` 兼容入口可用。

- **Hosted UI**:AG-UI/A2UI 通过能力协商启用;不能协商时继续使用既有 Responses transport。
- **事件诊断**:`ksadk replay <session-id>` 只读回放新 RuntimeEvent 历史,可用事件序号(`seq_id`)窗口缩小排查范围,不会再次执行模型、工具或审批副作用。
- **托管 A2A(实验性)**:AgentEngine 通过 Gateway 装配可信入站和 Space-scoped 出站 client。首期 external Agent 仅支持 `external_public`;它受 `Network.EnablePublicAccess` 控制并使用受限 NAT transport,`external_vpc` 尚不可用。
- **Codex Managed Runtime(新增)**:使用无 `agent.py` 的 `agentengine.yaml` 在 macOS、Windows 和 Linux 原生调试 Codex;直接部署发送内联 manifest,不上传 KS3 代码包,云端选择锁定的 Linux Runtime 镜像。
- **框架迁移**:新接入优先使用 LangGraph、Google ADK 或 `RuntimeAdapter`。旧 LangChain 连续性 / HITL 路径不属于 `0.8` 兼容性承诺。

详见[Codex Managed Runtime 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/managed-runtime/)、[Hosted UI 与事件回放指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/hosted-ui-events/)、[托管 A2A Runtime 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/a2a-runtime/)、[HarnessApp 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/harness-app/)和 [0.8.0 更新日志](CHANGELOG.md)。

## 为什么需要 KsADK

大多数 Agent 框架解决“如何开发 Agent”。KsADK 解决“如何运行、调试、部署和观测 Agent”。
Expand Down
12 changes: 0 additions & 12 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,18 +41,6 @@ agentengine web . --no-open

<p align="center"><img alt="KsADK 真实本地 Web UI 演示" src="docs-site/public/assets/ksadk-local-debugging-demo.gif" width="860" /></p>

## 0.8.0 评审候选

`0.8.0` 是正在评审的候选分支,不是已发布的 PyPI/npm 版本。它把 RuntimeEvent、AG-UI/A2UI、A2A、Harness 和 CodexRuntime 统一到同一运行时边界,同时保持 `/v1/responses` 和 `/v1/chat/completions` 兼容入口可用。

- **Hosted UI**:AG-UI/A2UI 通过能力协商启用;不能协商时继续使用既有 Responses transport。
- **事件诊断**:`ksadk replay <session-id>` 只读回放新 RuntimeEvent 历史,可用 `--after-seq-id` / `--before-seq-id` 缩小排查窗口,不会再次执行模型、工具或审批副作用。
- **托管 A2A(实验性)**:AgentEngine 通过 Gateway 装配可信入站和 Space-scoped 出站 client。首期 external Agent 仅支持 `external_public`;它受 `Network.EnablePublicAccess` 控制并使用受限 NAT transport,`external_vpc` 尚不可用。
- **Codex Managed Runtime(新增)**:使用无 `agent.py` 的 `agentengine.yaml` 在 macOS、Windows 和 Linux 原生调试 Codex;直接部署发送内联 manifest,不上传 KS3 代码包,云端选择锁定的 Linux Runtime 镜像。
- **框架迁移**:新接入优先使用 LangGraph、Google ADK 或 `RuntimeAdapter`。旧 LangChain 连续性 / HITL 路径不属于 `0.8` 兼容性承诺。

详见[Codex Managed Runtime 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/managed-runtime/)、[Hosted UI 与事件回放指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/hosted-ui-events/)、[托管 A2A Runtime 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/a2a-runtime/)、[HarnessApp 指南](https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/harness-app/)和 [0.8.0 更新日志](CHANGELOG.md)。

## 为什么需要 KsADK

大多数 Agent 框架解决“如何开发 Agent”。KsADK 解决“如何运行、调试、部署和观测 Agent”。
Expand Down
12 changes: 6 additions & 6 deletions tests/test_public_release_positioning.py
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,6 @@
f"{DOCS_ROOT_URL}cn/docs/framework/guides/observability-tracing/",
f"{DOCS_ROOT_URL}cn/docs/framework/guides/cloud-deployment/",
f"{DOCS_ROOT_URL}cn/docs/framework/guides/hosted-ui-events/",
f"{DOCS_ROOT_URL}cn/docs/framework/guides/a2a-runtime/",
f"{DOCS_ROOT_URL}cn/docs/framework/guides/managed-runtime/",
f"{DOCS_ROOT_URL}cn/docs/framework/guides/harness-app/",
}
EN_DOC_URLS = {
f"{DOCS_ROOT_URL}en/docs/framework/getting-started/quickstart/",
Expand All @@ -30,9 +27,6 @@
f"{DOCS_ROOT_URL}en/docs/framework/guides/observability-tracing/",
f"{DOCS_ROOT_URL}en/docs/framework/guides/cloud-deployment/",
f"{DOCS_ROOT_URL}en/docs/framework/guides/hosted-ui-events/",
f"{DOCS_ROOT_URL}en/docs/framework/guides/a2a-runtime/",
f"{DOCS_ROOT_URL}en/docs/framework/guides/managed-runtime/",
f"{DOCS_ROOT_URL}en/docs/framework/guides/harness-app/",
}

_DOCS_LINK_PATTERN = re.compile(
Expand Down Expand Up @@ -105,6 +99,8 @@ def test_public_readme_positions_ksadk_as_runtime_platform():
assert "当前版本:" not in readme
assert "发布版本:" not in readme
assert "## 0.6." not in readme
assert "0.8.0" not in readme
assert "评审候选" not in readme


def test_public_readme_language_variants_keep_homepage_shape():
Expand All @@ -120,6 +116,8 @@ def test_public_readme_language_variants_keep_homepage_shape():
assert "ksadk-runtime-architecture.png" in text
assert "发布版本:" not in text
assert "## 0.6." not in text
assert "0.8.0" not in text
assert "评审候选" not in text

assert "Kingsoft Cloud Agent Development Kit" in en_readme
assert "ksadk-runtime-platform-hero-wide.png" in en_readme
Expand All @@ -129,6 +127,8 @@ def test_public_readme_language_variants_keep_homepage_shape():
assert "ksadk-runtime-architecture.png" not in en_readme
assert "发布版本:" not in en_readme
assert "## 0.6." not in en_readme
assert "0.8.0" not in en_readme
assert "Review Candidate" not in en_readme

assert _github_pages_urls(root_readme) == {DOCS_ROOT_URL, *ZH_DOC_URLS}
assert _github_pages_urls(zh_readme) == {DOCS_ROOT_URL, *ZH_DOC_URLS}
Expand Down
Loading