@dsh-cc/acp 0.9.5-rc.1 → 0.9.6-rc.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 +2 -2
- package/README.md +21 -0
- package/README.zh.md +21 -0
- package/package.json +3 -3
package/README.i18n.yaml
CHANGED
|
@@ -2,5 +2,5 @@
|
|
|
2
2
|
# side as of the last confirmed-consistent state. Both languages carry equal authority;
|
|
3
3
|
# after editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm check:readme --write
|
|
5
|
-
README.md:
|
|
6
|
-
README.zh.md:
|
|
5
|
+
README.md: 8e9e0bbc0e33198eb3329ff273fb375e82fda8ae
|
|
6
|
+
README.zh.md: deb5c3e60dceb617abae1ceb4f3b05275dd37d52
|
package/README.md
CHANGED
|
@@ -3,3 +3,24 @@
|
|
|
3
3
|
English | [中文](README.zh.md)
|
|
4
4
|
|
|
5
5
|
Agent Client Protocol (ACP, v1) server that lets an ACP client (e.g. Zed) drive dsh-cc agents over JSON-RPC on stdio. This package is a verbatim vendor of `@deepseek-ai/dsh-acp` (`packages/acp/acp`, deepseek-harness, MIT — see `LICENSE-harness`), pinned at `2f97f60455605e915b8176d9170cae337bfedcc6` (@deepseek-ai/dsh-acp 0.2.2-rc.1); every ported file carries a provenance header and CC-specific divergences must be recorded in `DIVERGENCE.md`. The vendoring and extension plan is described in `docs/plans/2026-10-09-acp-m2-own-plugin.md`.
|
|
6
|
+
|
|
7
|
+
## Configuration
|
|
8
|
+
|
|
9
|
+
`Config` (`src/index.ts:105`) has four keys: `provider`, `model`, `presetId`, and `sessionListPageSize`.
|
|
10
|
+
|
|
11
|
+
| Key | Default | Meaning |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `provider` | none | Provider route used for each agent the server creates. |
|
|
14
|
+
| `model` | none | Model name used for each agent the server creates. |
|
|
15
|
+
| `presetId` | `'cc'` | Agent preset composed into every fresh session. |
|
|
16
|
+
| `sessionListPageSize` | `100` | Maximum session summaries in one `session/list` page. |
|
|
17
|
+
|
|
18
|
+
The plugin's identity is `name = 'acp-cc'` with `inject = ['agents', 'llm', 'sessionPersistence', 'sessions']` (`src/index.ts:70,79`).
|
|
19
|
+
|
|
20
|
+
## Shipped features
|
|
21
|
+
|
|
22
|
+
- **MCP server passthrough.** `mountAcpMcpServers` (`src/mcp.ts`) turns a session's standard `mcpServers` declarations into Agent-scoped DSH MCP clients, supporting the stdio and HTTP transports and rejecting any other transport, a duplicate name, a relative stdio `command`, or a non-HTTP URL with `AcpMcpConfigError` before the agent is published.
|
|
23
|
+
- **Per-use preset roster resolution.** `presetRosterResolver` (`src/preset-roster.ts`) resolves the agent-preset roster at each use, behind a loader-settlement gate, so an asynchronously mounting registry is observed at its final state and a registry restart does not re-apply this plugin.
|
|
24
|
+
- **Model control.** `AcpModelControl` (`src/model-control.ts`) projects the session's provider/model selection and the provider's reasoning efforts onto ACP config options, and a client change applies from the agent's next model step.
|
|
25
|
+
- **Session-list paging.** `session/list` returns at most `sessionListPageSize` summaries per request with an opaque keyset `nextCursor`.
|
|
26
|
+
- **Committed-update projection.** `src/updates.ts` projects committed session events onto ACP updates, with assistant blocks becoming thought and message chunks plus an optional usage update, and one tool call becoming a `tool_call` then `tool_call_update` lifecycle.
|
package/README.zh.md
CHANGED
|
@@ -3,3 +3,24 @@
|
|
|
3
3
|
[English](README.md) | 中文
|
|
4
4
|
|
|
5
5
|
Agent Client Protocol(ACP,v1)服务器,让 ACP 客户端(如 Zed)通过 stdio 上的 JSON-RPC 驱动 dsh-cc agent。本包是 `@deepseek-ai/dsh-acp`(deepseek-harness 的 `packages/acp/acp`,MIT — 见 `LICENSE-harness`)的逐字 vendor,固定于 `2f97f60455605e915b8176d9170cae337bfedcc6`(@deepseek-ai/dsh-acp 0.2.2-rc.1);每个移植文件都带出处头,CC 侧的分歧必须记录在 `DIVERGENCE.md`。vendor 与扩展计划见 `docs/plans/2026-10-09-acp-m2-own-plugin.md`。
|
|
6
|
+
|
|
7
|
+
## 配置
|
|
8
|
+
|
|
9
|
+
`Config`(`src/index.ts:105`)有四个键:`provider`、`model`、`presetId`、`sessionListPageSize`。
|
|
10
|
+
|
|
11
|
+
| 键 | 默认值 | 含义 |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `provider` | 无 | 服务器为每个新建 agent 使用的 provider 路由。 |
|
|
14
|
+
| `model` | 无 | 服务器为每个新建 agent 使用的模型名。 |
|
|
15
|
+
| `presetId` | `'cc'` | 每个新会话都会合成的 agent preset。 |
|
|
16
|
+
| `sessionListPageSize` | `100` | 单次 `session/list` 分页返回的会话摘要上限。 |
|
|
17
|
+
|
|
18
|
+
插件的身份为 `name = 'acp-cc'`,`inject = ['agents', 'llm', 'sessionPersistence', 'sessions']`(`src/index.ts:70,79`)。
|
|
19
|
+
|
|
20
|
+
## 已交付特性
|
|
21
|
+
|
|
22
|
+
- **MCP server 透传。** `mountAcpMcpServers`(`src/mcp.ts`)把会话的标准 `mcpServers` 声明转为 Agent scope 的 DSH MCP 客户端,支持 stdio 与 HTTP 两种 transport;其它 transport、重名、相对的 stdio `command`、非 HTTP URL 都会在 agent 发布前以 `AcpMcpConfigError` 拒绝。
|
|
23
|
+
- **按使用解析 preset roster。** `presetRosterResolver`(`src/preset-roster.ts`)在每次使用时才解析 agent preset 注册表,并位于 loader 结算门之后,因此能观测到异步挂载的注册表的最终状态,注册表重启也不会重新 apply 本插件。
|
|
24
|
+
- **模型控制。** `AcpModelControl`(`src/model-control.ts`)把会话的 provider/model 选择与该 provider 的 reasoning effort 投影为 ACP config option,客户端改动从 agent 的下一次模型步生效。
|
|
25
|
+
- **会话列表分页。** `session/list` 每次请求最多返回 `sessionListPageSize` 条摘要,并带不透明的 keyset `nextCursor`。
|
|
26
|
+
- **已提交更新投影。** `src/updates.ts` 把已提交的会话事件投影为 ACP update:assistant block 变为 thought 与 message chunk(可附带一条 usage 更新),一次工具调用则变为 `tool_call` 到 `tool_call_update` 的生命周期。
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dsh-cc/acp",
|
|
3
3
|
"description": "Agent Client Protocol server for driving dsh-cc agents over JSON-RPC stdio (vendored from @deepseek-ai/dsh-acp)",
|
|
4
|
-
"version": "0.9.
|
|
4
|
+
"version": "0.9.6-rc.1",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
7
7
|
"url": "git+https://github.com/dsh-cc/dsh-cc.git",
|
|
@@ -25,8 +25,8 @@
|
|
|
25
25
|
"license": "Apache-2.0",
|
|
26
26
|
"dependencies": {
|
|
27
27
|
"@agentclientprotocol/sdk": "1.4.0",
|
|
28
|
-
"@dsh-cc/moa": "^0.9.
|
|
29
|
-
"@dsh-cc/version-info": "^0.9.
|
|
28
|
+
"@dsh-cc/moa": "^0.9.6-rc.1",
|
|
29
|
+
"@dsh-cc/version-info": "^0.9.6-rc.1"
|
|
30
30
|
},
|
|
31
31
|
"peerDependencies": {
|
|
32
32
|
"@deepseek-ai/cordis": ">=0.2.0-rc.2",
|