@deepseek-ai/dsh-sdk-client 0.1.5-rc.2 → 0.1.6-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.i18n.yaml +1 -1
- package/README.zh.md +7 -7
- package/package.json +8 -8
package/README.i18n.yaml
CHANGED
|
@@ -3,4 +3,4 @@
|
|
|
3
3
|
# after editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write packages/sdk/client/README.md
|
|
5
5
|
README.md: bfbd522d120fb0a0123c0496394973e531a9ba6f
|
|
6
|
-
README.zh.md:
|
|
6
|
+
README.zh.md: ec54e8ae0e864378abd48d8af9b5db6b96418fe5
|
package/README.zh.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "面向以子进程方式启动 DeepSeek Harness 运行时、并通过 stdio JSON-RPC 驱动 agent
|
|
2
|
+
description: "面向以子进程方式启动 DeepSeek Harness 运行时、并通过 stdio JSON-RPC 驱动 agent（智能体）轮次的调用方的 TypeScript SDK 客户端：DeepSeekHarness 运行 API 与低层 HarnessClient。"
|
|
3
3
|
kind: "package-library"
|
|
4
4
|
---
|
|
5
5
|
|
|
@@ -71,12 +71,12 @@ console.log(result.finalResponse)
|
|
|
71
71
|
|
|
72
72
|
| 文件 | 职责 |
|
|
73
73
|
|---|---|
|
|
74
|
-
| [`src/api.ts`](src/api.ts) | `DeepSeekHarness` + `HarnessSession
|
|
74
|
+
| [`src/api.ts`](src/api.ts) | `DeepSeekHarness` + `HarnessSession`：自有运行、从回执到 idle 的收集、`finalResponse` |
|
|
75
75
|
| [`src/client.ts`](src/client.ts) | `HarnessClient`：spawn、握手、请求、订阅扇出、类型化错误 |
|
|
76
76
|
| [`src/dispose.ts`](src/dispose.ts) | 私有关闭阶梯：stdin EOF → SIGTERM → SIGKILL 直到真正退出 |
|
|
77
77
|
| [`src/types.ts`](src/types.ts) | 启动与超时选项、通知结构、`RunResult` |
|
|
78
78
|
| [`src/index.ts`](src/index.ts) | 消费方接口：两层客户端与面向调用方的类型 |
|
|
79
|
-
| — |
|
|
79
|
+
| — | 不发布运行时不变式伴生入口；本客户端库运行在任何 harness 上下文之外（其对端是独立运行时进程）；运行时自身的包负责维护事件流关系。 |
|
|
80
80
|
|
|
81
81
|
### 自有活动流程
|
|
82
82
|
|
|
@@ -95,8 +95,8 @@ console.log(result.finalResponse)
|
|
|
95
95
|
|
|
96
96
|
当客户端约定不够用时阅读以下页面。它们从协议格式进入服务插件与使用本客户端的应用。
|
|
97
97
|
|
|
98
|
-
- [SDK 协议格式](../protocol/README.zh.md)
|
|
99
|
-
- [JSON-RPC 服务插件](../server/README.zh.md)
|
|
98
|
+
- [SDK 协议格式](../protocol/README.zh.md)——本客户端使用的 JSON-RPC 方法与载荷结构。
|
|
99
|
+
- [JSON-RPC 服务插件](../server/README.zh.md)——服务本客户端的运行时插件。
|
|
100
100
|
- [Python SDK](../../../python/README.zh.md) — 共享同一运行时对端与协议的设计孪生。
|
|
101
101
|
- [SDK subagent 后端](../../subagent/subagent-dsh-sdk/README.zh.md) — harness 内部消费本客户端的例子。
|
|
102
102
|
- [SDK 应用组合包](../../bundle/sdk-app/README.zh.md) — 本客户端启动的 `dsh --profile sdk` 运行时应用。
|
|
@@ -110,7 +110,7 @@ console.log(result.finalResponse)
|
|
|
110
110
|
|
|
111
111
|
#### KV Cache 影响
|
|
112
112
|
|
|
113
|
-
|
|
113
|
+
客户端进程中无影响。子进程的 profile、patch、提供方、模型与历史决定缓存复用。
|
|
114
114
|
|
|
115
115
|
## 已知限制与延期工作
|
|
116
116
|
|
|
@@ -121,7 +121,7 @@ client 进程中无影响。子进程的 profile、patch、provider、model 与
|
|
|
121
121
|
|
|
122
122
|
- **无捆绑运行时解析**——客户端解析同版本 `@deepseek-ai/dsh` 包（或调用方提供的 `dshBin`）；打包可执行文件的发现留在 Python 侧，直到出现 TypeScript 发行版消费方。
|
|
123
123
|
- **无轮次中取消**——协议层没有提示词取消方法；放弃轮次意味着关闭运行时（见[协议限制](../protocol/README.zh.md#known-limitations-and-deferred-work)）。
|
|
124
|
-
- **没有逐提示词结果**——低层 `prompt()` 只返回入队回执；高层 `run()`
|
|
124
|
+
- **没有逐提示词结果**——低层 `prompt()` 只返回入队回执；高层 `run()` 负责从回执到 idle 的收集，放弃该过程意味着关闭运行时。
|
|
125
125
|
- **客户端→服务端通知与服务端→客户端请求**在协议两端都未实现；传输层为未来审批流程保留了承载能力。
|
|
126
126
|
|
|
127
127
|
<a id="dev-note"></a>
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deepseek-ai/dsh-sdk-client",
|
|
3
3
|
"description": "TypeScript client SDK for driving a DeepSeek Harness runtime subprocess over stdio JSON-RPC: the DeepSeekHarness high-level turns API and the lower-level HarnessClient",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.6-alpha.1",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
7
7
|
},
|
|
@@ -26,18 +26,18 @@
|
|
|
26
26
|
],
|
|
27
27
|
"license": "MIT",
|
|
28
28
|
"dependencies": {
|
|
29
|
-
"@deepseek-ai/dsh": "0.1.
|
|
29
|
+
"@deepseek-ai/dsh": "0.1.6-alpha.1"
|
|
30
30
|
},
|
|
31
31
|
"peerDependencies": {
|
|
32
|
-
"@deepseek-ai/dsh-
|
|
33
|
-
"@deepseek-ai/dsh-
|
|
34
|
-
"@deepseek-ai/dsh-
|
|
32
|
+
"@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
|
|
33
|
+
"@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
|
|
34
|
+
"@deepseek-ai/dsh-sdk-protocol": "^0.1.6-alpha.1",
|
|
35
35
|
"@deepseek-ai/cordis": "^4.0.2"
|
|
36
36
|
},
|
|
37
37
|
"devDependencies": {
|
|
38
|
-
"@deepseek-ai/dsh-llm": "^0.1.
|
|
39
|
-
"@deepseek-ai/dsh-sdk-protocol": "^0.1.
|
|
40
|
-
"@deepseek-ai/dsh-session": "^0.1.
|
|
38
|
+
"@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
|
|
39
|
+
"@deepseek-ai/dsh-sdk-protocol": "^0.1.6-alpha.1",
|
|
40
|
+
"@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
|
|
41
41
|
"@deepseek-ai/cordis": "^4.0.2"
|
|
42
42
|
}
|
|
43
43
|
}
|