feat(sdk): support compact through unified query input

This commit is contained in:
LogosVeritas committed 2026-10-25 21:55:27 +08:00
1 parent 04b3164a27
commit 5cdd2aebed
48 files changed
+3011 -99

No files matched your search

+7 -4
View File
@@ -3,11 +3,14 @@
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write python/sdk/examples/README.md
/python-sdk-example:
en: d9dfc996ea2ace40
zh: 33de241bad6c4ee1
en: c97ffc5ce0f7db05
zh: bdd91202075498a3
/python-sdk-example/run-the-minimal-agent:
en: f0d785582fe72a91
zh: ee563fb17c775ed3
en: 4b79fd6576e2759d
zh: 6258540acaf4bc37
/python-sdk-example/compact-a-full-sdk-session:
en: 0bada22014bf5e6c
zh: 4308ea1a14b48f57
/python-sdk-example/add-plugins:
en: 5e1e30dac13f6c9e
zh: 0af98ebb75c88f43
+14 -1
View File
@@ -2,7 +2,7 @@
English | [中文](README.zh.md)
Runnable Python SDK example over the sole application launcher, `dsh --profile sdk-minimal`. The Python client owns JSON-RPC stdio; the profile owns the agent composition, persistence, execution policy, and plugins.
Runnable Python SDK examples over the sole application launcher, `dsh`. The Python client owns JSON-RPC stdio; the selected profile owns the agent composition, persistence, execution policy, and plugins.
## Run the minimal agent
@@ -29,6 +29,19 @@ The bundle does not include `dsh-base`, so every additional row is an explicit p
The persistent PTY can modify any path available to the runtime process, so use a disposable checkout or container.
<a id="compact-a-full-sdk-session"></a>
## Compact a full SDK Session
The [compaction example](compact.py) uses the full `sdk` profile. It reads `README.md` from the selected workspace into a `Session.query()` prompt, sends `/compact` through the same method, then asks a follow-up using the retained context. Each query is paired with `Session.receive_response()`. It uses the same model credentials and `DSH_MODEL` default as the minimal example, and requires an explicit home:
```sh
python python/sdk/examples/compact.py \
--dsh-home /absolute/path/to/compact-dsh-home \
--workspace /absolute/path/to/disposable-workspace
```
The script consumes notifications and prints the command id and outcome separately from the model's responses. A failed turn or command stops the example. See [Query and response](../README.md#query-and-response) for completion and error behavior; `minimal.py` retains its `run()` entry and does not enable command execution.
## Add plugins
Use the runtime wheel's `dsh` command against the same explicit home for persistent profile changes:
+14 -1
View File
@@ -2,7 +2,7 @@
[English](README.md) | 中文
基于唯一应用启动器 `dsh --profile sdk-minimal` 的可运行 Python SDK 示例。Python 客户端负责 JSON-RPC stdio;profile 负责 agent(智能体)组合、持久化、执行策略与插件。
基于唯一应用启动器 `dsh` 的可运行 Python SDK 示例。Python 客户端负责 JSON-RPC stdio;所选 profile 负责 agent(智能体)组合、持久化、执行策略与插件。
## 运行极简 agent
@@ -29,6 +29,19 @@ python python/sdk/examples/minimal.py \
持久 PTY 可以修改运行时进程可访问的任何路径,因此只应在一次性 checkout 或容器中使用。
<a id="compact-a-full-sdk-session"></a>
## 压缩完整 SDK Session
[压缩示例](compact.py)使用完整 `sdk` profile。它将所选工作区的 `README.md` 读入 `Session.query()` 输入,通过同一方法发送 `/compact`,随后使用保留的上下文继续提问。每次 query 都配对调用 `Session.receive_response()`。模型凭据和 `DSH_MODEL` 默认值与极简示例一致,并且要求显式指定 home:
```sh
python python/sdk/examples/compact.py \
--dsh-home /absolute/path/to/compact-dsh-home \
--workspace /absolute/path/to/disposable-workspace
```
脚本消费通知,并将命令 id 和结果与模型回复分开打印。轮次或命令失败时,示例会停止。完成和错误行为见[查询与接收](../README.zh.md#query-and-response);`minimal.py` 保留其 `run()` 入口,不启用命令执行。
## 添加插件
对同一个显式 home 使用运行时 wheel 包提供的 `dsh` 命令,以进行持久 profile 变更:
+65
View File
@@ -0,0 +1,65 @@
#!/usr/bin/env python3
"""Compact a full SDK Session and continue with its retained context."""
from __future__ import annotations
import argparse
import os
from pathlib import Path
from deepseek_harness import CommandExecution, DeepSeekHarness, RunResult, Session
def receive(session: Session) -> None:
"""Consume notifications and print the query's command or activity result."""
for result in session.receive_response():
if isinstance(result, RunResult):
if result.finish_reason != "completed":
raise RuntimeError(f"Agent turn ended with {result.finish_reason}: {result.final_response}")
print(result.final_response)
elif isinstance(result, CommandExecution):
print(f"Command {result.command_id}: {result.result.kind}")
if result.result.kind == "error":
raise RuntimeError(result.result.text)
if result.result.text is not None:
print(result.result.text)
def main() -> None:
"""Create conversation history, compact it, and ask a follow-up question."""
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--dsh-home", required=True, type=Path)
parser.add_argument("--workspace", type=Path, default=Path.cwd())
parser.add_argument("--session-id")
parser.add_argument("--provider", default="deepseek-official")
parser.add_argument("--model", default=os.environ.get("DSH_MODEL", "deepseek-v4-flash"))
parser.add_argument("--max-tokens", type=int)
args = parser.parse_args()
workspace = args.workspace.resolve()
readme = workspace / "README.md"
if not readme.is_file():
parser.error("--workspace must contain README.md to provide conversation history")
with DeepSeekHarness(
dsh_home=str(args.dsh_home.resolve()),
cwd=str(workspace),
profile="sdk",
provider=args.provider,
model=args.model,
max_tokens=args.max_tokens,
) as harness:
session = harness.start_session(args.session_id)
session.query(
"Read this project README and summarize its purpose and development commands without using tools.\n\n"
+ readme.read_text(encoding="utf-8")
)
receive(session)
session.query("/compact")
receive(session)
session.query("What are the project's purpose and development commands? Use the earlier README without tools.")
receive(session)
if __name__ == "__main__":
main()