@deepseek-ai/dsh-sdk-protocol 0.1.5-rc.1 → 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/protocol/README.md
|
|
5
5
|
README.md: 7cc6a28ac4424927613da6e64e4508e25659ab1f
|
|
6
|
-
README.zh.md:
|
|
6
|
+
README.zh.md: 69b85d6ca7858c826bed6269adcfb98fc2593543
|
package/README.zh.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "面向客户端与服务端实现者的 SDK
|
|
2
|
+
description: "面向客户端与服务端实现者的 SDK 协议格式（wire format）说明：Harness 运行时与其 SDK 客户端之间使用的按换行分帧 JSON-RPC 传输，以及具名的请求、结果与通知类型。"
|
|
3
3
|
kind: "package-library"
|
|
4
4
|
---
|
|
5
5
|
|
|
@@ -25,7 +25,7 @@ kind: "package-library"
|
|
|
25
25
|
<a id="use-this-package"></a>
|
|
26
26
|
## 使用本包
|
|
27
27
|
|
|
28
|
-
当你构建或调试 SDK
|
|
28
|
+
当你构建或调试 SDK 协议端——服务插件、客户端库或使用该协议的自定义工具——时使用本包。它为你提供一个在调用方持有的字节流上承载 JSON-RPC 2.0 的传输，以及每个 SDK 方法与通知的类型化结构。
|
|
29
29
|
|
|
30
30
|
### 分帧与传输
|
|
31
31
|
|
|
@@ -41,7 +41,7 @@ kind: "package-library"
|
|
|
41
41
|
| client→server | `session/prompt` | `SessionPromptParams` → `SessionPromptResult`（持久入队回执） |
|
|
42
42
|
| client→server | `shutdown` | 无参数 → `{}` |
|
|
43
43
|
| server→client | `session.event` | `SessionEventNotification`（运行时内每个会话，不过滤） |
|
|
44
|
-
| server→client | `session.status` | `SessionStatusNotification`（整个 agent
|
|
44
|
+
| server→client | `session.status` | `SessionStatusNotification`（整个 agent（智能体）的 `running`/`idle` 转换） |
|
|
45
45
|
| server→client | `subagent.started` | `SubagentStartedNotification` |
|
|
46
46
|
| server→client | `subagent.finished` | `SubagentFinishedNotification`（仅进程内运行） |
|
|
47
47
|
|
|
@@ -63,7 +63,7 @@ kind: "package-library"
|
|
|
63
63
|
|
|
64
64
|
### 设计理念
|
|
65
65
|
|
|
66
|
-
|
|
66
|
+
本包采用一种职责分离设计：两个协议端共用一个按换行分帧的传输类，并以具名类型索引协议方法。包根是唯一的导入面——源模块不支持深层导入。它是没有插件、配置或注册的纯库；服务插件与客户端负责其周围的一切行为。
|
|
67
67
|
|
|
68
68
|
### 源码地图
|
|
69
69
|
|
|
@@ -72,7 +72,7 @@ kind: "package-library"
|
|
|
72
72
|
| [`src/transport.ts`](src/transport.ts) | `JsonRpcLineTransport`：行分帧、请求/响应/通知分发、错误映射、挂起请求记账 |
|
|
73
73
|
| [`src/types.ts`](src/types.ts) | 具名请求/结果与通知载荷类型，按方法索引 |
|
|
74
74
|
| [`src/index.ts`](src/index.ts) | 消费方接口：传输与具名协议类型 |
|
|
75
|
-
| — |
|
|
75
|
+
| — | 不发布运行时不变式伴生入口；这是一个由传输类和类型声明组成的纯协议库，自身没有事件流或可变数据关系；两个协议端各自负责其协议行为。 |
|
|
76
76
|
|
|
77
77
|
### 帧分发
|
|
78
78
|
|
|
@@ -89,7 +89,7 @@ kind: "package-library"
|
|
|
89
89
|
|
|
90
90
|
- [JSON-RPC 服务插件](../server/README.zh.md) — 通过 stdio 服务该协议的运行时插件。
|
|
91
91
|
- [TypeScript SDK 客户端](../client/README.zh.md) — 驱动该协议的客户端。
|
|
92
|
-
- [Python SDK](../../../python/README.zh.md) — 复现这些结构的 Python
|
|
92
|
+
- [Python SDK](../../../python/README.zh.md) — 复现这些结构的 Python 对应实现。
|
|
93
93
|
- [SDK 应用组合包](../../bundle/sdk-app/README.zh.md) — 启动服务器的 `dsh --profile sdk` 应用。
|
|
94
94
|
|
|
95
95
|
-----
|
|
@@ -112,7 +112,7 @@ kind: "package-library"
|
|
|
112
112
|
|
|
113
113
|
- **无协议版本协商**——握手只携带 `serverInfo.version`（`0.0.1`，客户端不校验）；处于预发布阶段，无兼容承诺。
|
|
114
114
|
- **无取消与会话关闭方法**——客户端放弃轮次的方式是关闭运行时进程；见 [JSON-RPC 服务插件](../server/README.zh.md)。
|
|
115
|
-
- **server→client
|
|
115
|
+
- **server→client 请求是未使用的能力**——传输层支持，但服务器从不发送；Python SDK 的应答接口为未来审批流程预留。
|
|
116
116
|
|
|
117
117
|
<a id="dev-note"></a>
|
|
118
118
|
### 开发备注
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deepseek-ai/dsh-sdk-protocol",
|
|
3
3
|
"description": "Shared wire protocol for the DeepSeek Harness SDK runtime: the newline-delimited JSON-RPC stdio transport and the named request, result, and notification types spoken between the runtime server and SDK clients",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.6-alpha.1",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public"
|
|
7
7
|
},
|
|
@@ -26,15 +26,15 @@
|
|
|
26
26
|
],
|
|
27
27
|
"license": "MIT",
|
|
28
28
|
"peerDependencies": {
|
|
29
|
-
"@deepseek-ai/dsh-llm": "^0.1.
|
|
30
|
-
"@deepseek-ai/dsh-subagent": "^0.1.
|
|
31
|
-
"@deepseek-ai/
|
|
32
|
-
"@deepseek-ai/
|
|
29
|
+
"@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
|
|
30
|
+
"@deepseek-ai/dsh-subagent": "^0.1.6-alpha.1",
|
|
31
|
+
"@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
|
|
32
|
+
"@deepseek-ai/cordis": "^4.0.2"
|
|
33
33
|
},
|
|
34
34
|
"devDependencies": {
|
|
35
|
-
"@deepseek-ai/dsh-llm": "^0.1.
|
|
36
|
-
"@deepseek-ai/dsh-session": "^0.1.
|
|
37
|
-
"@deepseek-ai/dsh-subagent": "^0.1.
|
|
35
|
+
"@deepseek-ai/dsh-llm": "^0.1.6-alpha.1",
|
|
36
|
+
"@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
|
|
37
|
+
"@deepseek-ai/dsh-subagent": "^0.1.6-alpha.1",
|
|
38
38
|
"@deepseek-ai/cordis": "^4.0.2"
|
|
39
39
|
}
|
|
40
40
|
}
|