@deepseek-ai/dsh-sdk-minimal 0.1.5-rc.2 → 0.1.6-alpha.2

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.
Files changed (5) hide show
  1. package/README.i18n.yaml +2 -2
  2. package/README.md +7 -5
  3. package/README.zh.md +12 -10
  4. package/cordis.patch.yml +3 -0
  5. package/package.json +28 -27
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 run verify-translation-pairing --write packages/bundle/sdk-minimal/README.md
5
- README.md: e67b1eb0637f870f47bd97ecff7133242e2f2210
6
- README.zh.md: 077d3ac0f603ce6781476b4850306d8f8486f82a
5
+ README.md: 2632bf9bd949bb37a01b963f13fb96f341eaea28
6
+ README.zh.md: 7aa26c9e895dea4b11d06416f5eca815ef187655
package/README.md CHANGED
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "Standalone single-tool SDK profile for users who need a minimal cross-platform coding agent without the shared base bundle."
2
+ description: "Standalone SDK profile with one default shell tool for users who need a minimal cross-platform coding agent without the shared base bundle."
3
3
  kind: "package-bundle"
4
4
  ---
5
5
 
@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
9
9
 
10
10
  ## Summary
11
11
 
12
- Use `dsh --profile sdk-minimal` when an SDK client needs a small, explicit coding-agent runtime. The profile advertises only a platform-selected persistent shell, persists sessions as uncompressed JSONL, and selects the model from the SDK initialization request. It supplies a complete Cordis tree and deliberately excludes `dsh-base`, Web, settings, managed credentials, telemetry, compaction, filesystem tools, workspace instructions, skills, jobs, and subagents. Its danger-full-access policy lets the shell modify any path available to the process, so use it only with an isolated workspace.
12
+ Use `dsh --profile sdk-minimal` when an SDK client needs a small, explicit coding-agent runtime. By default, the profile advertises only a platform-selected persistent shell, persists sessions as uncompressed JSONL, and selects the model from the SDK initialization request. It supplies a complete Cordis tree and deliberately excludes `dsh-base`, Web, settings, managed credentials, telemetry, compaction, filesystem tools, workspace instructions, skills, jobs, and subagents. Its danger-full-access policy lets the shell modify any path available to the process, so use it only with an isolated workspace.
13
13
 
14
14
  ## Table of Contents
15
15
 
@@ -38,6 +38,8 @@ Use `dsh plugin --profile sdk-minimal` to manage persistent external dependencie
38
38
 
39
39
  The profile mounts exactly one persistent shell stack: Bash on Linux and macOS, or PowerShell on Windows. Both stacks use a 300-second timeout and one owner-scoped terminal; the other platform's rows remain disabled.
40
40
 
41
+ Like every shipped profile, it mounts [MCP resources](../../mcp/mcp-resources/README.md) once. Configure only [MCP client entries](../../mcp/mcp-client/README.md) to add servers. Clients mounted by another provider also count as configured. With no server configured in the caller's scope, MCP contributes no prompt text or tools and the default remains one shell tool.
42
+
41
43
  -----
42
44
 
43
45
  <a id="understand-the-implementation"></a>
@@ -46,7 +48,7 @@ The profile mounts exactly one persistent shell stack: Bash on Linux and macOS,
46
48
  <details>
47
49
  <summary>Implementation internals — click to expand</summary>
48
50
 
49
- The bundle's single insert is the complete application tree: SDK stdio startup and JSON-RPC serving, one environment-configured DeepSeek adapter, the explicit agent core, local subprocess execution, a platform-selected persistent shell PTY, and uncompressed JSONL persistence under `$DSH_HOME/sessions`. It does not inherit another bundle, so every extra row is an explicit profile change.
51
+ The bundle's single insert is the complete application tree: SDK stdio startup and JSON-RPC serving, one environment-configured DeepSeek adapter, the explicit agent core, conditional MCP resource tools, local subprocess execution, a platform-selected persistent shell PTY, and uncompressed JSONL persistence under `$DSH_HOME/sessions`. It does not inherit another bundle, so every extra row is an explicit profile change.
50
52
 
51
53
  ### Source map
52
54
 
@@ -77,11 +79,11 @@ The bundle's single insert is the complete application tree: SDK stdio startup a
77
79
 
78
80
  #### What the model sees
79
81
 
80
- The system prompt is `DSH_SYSTEM_PROMPT` or `You are a helpful software engineer assistant.`. The only advertised tool is owner-scoped persistent `bash` on Linux/macOS or `pwsh` on Windows; runtime context, filesystem tools, workspace instructions, skills, jobs controls, compaction, and Harness identity are absent.
82
+ The system prompt is `DSH_SYSTEM_PROMPT` or `You are a helpful software engineer assistant.`. With no MCP server configured, the only advertised tool is owner-scoped persistent `bash` on Linux/macOS or `pwsh` on Windows; runtime context, filesystem tools, workspace instructions, skills, jobs controls, compaction, and Harness identity are absent.
81
83
 
82
84
  #### Token effect
83
85
 
84
- One stable persona plus one tool schema. Tool results and ordinary conversation history grow with the session.
86
+ By default, one stable persona plus one tool schema. Configured MCP servers add their tools, shared resource tools, and available server instructions. Tool results and ordinary conversation history grow with the session.
85
87
 
86
88
  #### KV Cache effect
87
89
 
package/README.zh.md CHANGED
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "供需要不含共享 base bundle 的极简跨平台 coding agent 的用户使用的独立单工具 SDK profile。"
2
+ description: "供需要不含共享 base bundle 的极简跨平台 coding agent（编程智能体）的用户使用的独立 SDK profile，默认提供一个 shell 工具。"
3
3
  kind: "package-bundle"
4
4
  ---
5
5
 
@@ -9,7 +9,7 @@ kind: "package-bundle"
9
9
 
10
10
  ## 概述
11
11
 
12
- 当 SDK 客户端需要小型、显式的 coding agent 运行时时，请使用 `dsh --profile sdk-minimal`。该 profile 只公布按平台选择的持久 shell，把会话持久化为未压缩 JSONL，并从 SDK 初始化请求选择模型。它提供完整 Cordis 配置树，并刻意排除 `dsh-base`、Web、settings、托管凭据、遥测、compaction、文件系统工具、workspace 指令、skills、jobs 与 subagent。其 danger-full-access 策略允许 shell 修改进程可访问的任何路径，因此只能配合隔离 workspace 使用。
12
+ 当 SDK 客户端需要小型、显式的 coding agent 运行时时，请使用 `dsh --profile sdk-minimal`。该 profile 默认只公布按平台选择的持久 shell，把会话持久化为未压缩 JSONL，并从 SDK 初始化请求选择模型。它提供完整 Cordis 配置树，并刻意排除 `dsh-base`、Web、settings、托管凭据、遥测、压缩（compaction）、文件系统工具、workspace 指令、skill（技能）、jobs 与 subagent。其 danger-full-access 策略允许 shell 修改进程可访问的任何路径，因此只能配合隔离 workspace 使用。
13
13
 
14
14
  ## 目录
15
15
 
@@ -32,12 +32,14 @@ export DSH_HOME=/absolute/path/to/example-dsh-home
32
32
  dsh --profile sdk-minimal
33
33
  ```
34
34
 
35
- `DSH_CONTEXT_WINDOW` 为不在适配器建议目录中的模型设置后备容量。`DSH_SYSTEM_PROMPT` 替换默认 persona。SDK 初始化请求是唯一模型选择，并覆盖环境默认值。
35
+ `DSH_CONTEXT_WINDOW` 为不在适配器建议目录中的模型设置后备容量。`DSH_SYSTEM_PROMPT` 替换默认 persona。SDK 初始化请求是唯一的模型选择依据，并覆盖环境默认值。
36
36
 
37
- 使用 `dsh plugin --profile sdk-minimal` 管理持久外部依赖。Profile、home 与有序 `--patch` 文件可以在完整默认配置树上替换配置项或插入 bundle。随附模板只在启动时应用 patch。
37
+ 使用 `dsh plugin --profile sdk-minimal` 管理持久外部依赖。Profile、home 与有序 `--patch` 文件可以替换完整默认配置树中的配置项，或在该配置树上方插入 bundle。随附模板只在启动时应用 patch。
38
38
 
39
39
  该 profile 只挂载一套持久 shell：Linux 和 macOS 使用 Bash，Windows 使用 PowerShell。两套配置都使用 300 秒超时与一个 agent 自有终端；另一平台的配置项保持禁用。
40
40
 
41
+ 与其他随附 profile 一样，它统一挂载 [MCP 资源](../../mcp/mcp-resources/README.zh.md)一次。只需配置 [MCP 客户端条目](../../mcp/mcp-client/README.zh.md)即可添加服务器。其他提供方挂载的客户端也属于已配置状态。调用方作用域中未配置服务器时，MCP 不贡献提示词文本或工具，默认仍只有一个 shell 工具。
42
+
41
43
  -----
42
44
 
43
45
  <a id="understand-the-implementation"></a>
@@ -46,7 +48,7 @@ dsh --profile sdk-minimal
46
48
  <details>
47
49
  <summary>实现细节——点击展开</summary>
48
50
 
49
- 该 bundle 的单个 insert 就是完整应用配置树：SDK stdio 启动与 JSON-RPC 服务、一个由环境配置的 DeepSeek 适配器、显式 agent 核心、本地子进程执行、按平台选择的持久 shell PTY，以及位于 `$DSH_HOME/sessions` 的未压缩 JSONL 持久化。它不继承其他 bundle，因此每个额外配置项都是显式 profile 变更。
51
+ 该 bundle 的单个 insert 就是完整应用配置树：SDK stdio 启动与 JSON-RPC 服务、一个由环境配置的 DeepSeek 适配器、显式 agent 核心、按配置启用的 MCP 资源工具、本地子进程执行、按平台选择的持久 shell PTY，以及位于 `$DSH_HOME/sessions` 的未压缩 JSONL 持久化。它不继承其他 bundle，因此每个额外配置项都是显式 profile 变更。
50
52
 
51
53
  ### 源码地图
52
54
 
@@ -54,7 +56,7 @@ dsh --profile sdk-minimal
54
56
  |---|---|
55
57
  | [`cordis.patch.yml`](cordis.patch.yml) | 完整独立 profile 配置树及其环境默认值 |
56
58
  | [`src/index.ts`](src/index.ts) | Bundle 包入口 |
57
- | — | 不发布运行时不变式伴生入口；本包只是静态 patch 列表载体，插入的各行分别拥有自己的运行时关系和不变式。 |
59
+ | — | 不发布运行时不变式伴生项；本包只是静态 patch 列表载体，插入的各行分别拥有自己的运行时关系和不变式伴生项。 |
58
60
  | [`tests/sdk-minimal.spec.ts`](tests/sdk-minimal.spec.ts) | 精确组合、profile 名称与平台选择检查 |
59
61
 
60
62
  </details>
@@ -64,7 +66,7 @@ dsh --profile sdk-minimal
64
66
  <a id="further-exploration"></a>
65
67
  ## 进一步探索
66
68
 
67
- - [Python SDK 示例](../../../python/sdk/examples/README.zh.md)——从 Python 针对显式 Harness home 启动本 profile。
69
+ - [Python SDK 示例](../../../python/sdk/examples/README.zh.md)——从 Python 启动本 profile，并使用明确指定的 Harness home。
68
70
  - [SDK 应用 bundle](../sdk-app/README.zh.md)——完整与极简 SDK profile 复用的 JSON-RPC 应用层。
69
71
  - [Base bundle](../base/README.zh.md)——本 profile 刻意省略的完整产品基础。
70
72
 
@@ -77,11 +79,11 @@ dsh --profile sdk-minimal
77
79
 
78
80
  #### 模型看到的内容
79
81
 
80
- 系统提示词取 `DSH_SYSTEM_PROMPT`，未设置时使用 `You are a helpful software engineer assistant.`。对外公布的唯一工具是 Linux/macOS 上 agent 所有的持久 `bash` 或 Windows 上的 `pwsh`；运行时上下文、文件系统工具、workspace 指令、skills、jobs 控制、compaction 与 Harness 身份均不存在。
82
+ 系统提示词取 `DSH_SYSTEM_PROMPT`，未设置时使用 `You are a helpful software engineer assistant.`。未配置 MCP 服务器时，对外公布的唯一工具是 Linux/macOS 上 agent 所有的持久 `bash` 或 Windows 上的 `pwsh`；运行时上下文、文件系统工具、workspace 指令、skill、jobs 控制、压缩与 Harness 身份均不存在。
81
83
 
82
84
  #### Token 影响
83
85
 
84
- 一个稳定 persona 加一个工具 schema。工具结果与普通对话历史随会话增长。
86
+ 默认是一个稳定 persona 加一个工具 schema。已配置 MCP 服务器会添加自己的工具、共享资源工具及可用的服务器指令。工具结果与普通对话历史随会话增长。
85
87
 
86
88
  #### KV Cache 影响
87
89
 
@@ -91,7 +93,7 @@ dsh --profile sdk-minimal
91
93
 
92
94
  <a id="known-limitations-and-deferred-work"></a>
93
95
 
94
- - **该组合刻意省略共享产品服务** — 需要 settings、托管凭据、权限策略预设、遥测、Web 工具或完整默认工具清单时，请选择 `dsh --profile sdk`。
96
+ - **该组合刻意省略共享产品服务** — 需要 settings、托管凭据、策略预设、遥测、Web 工具或完整默认工具清单时，请选择 `dsh --profile sdk`。
95
97
  - **用户 patch 可以扩展配置树并破坏 stdout** — profile 自定义属于受信任的应用组合；向 stdout 写入普通文本的插件会破坏 JSON-RPC 分帧。
96
98
 
97
99
  <a id="dev-note"></a>
package/cordis.patch.yml CHANGED
@@ -91,6 +91,9 @@
91
91
  - id: tools
92
92
  name: '@deepseek-ai/dsh-tools'
93
93
 
94
+ - id: mcp-resources
95
+ name: '@deepseek-ai/dsh-mcp-resources'
96
+
94
97
  - id: agent
95
98
  name: '@deepseek-ai/dsh-agent'
96
99
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-sdk-minimal",
3
3
  "description": "The standalone minimal SDK profile bundle: JSON-RPC, one DeepSeek adapter, persistent shell, and JSONL sessions",
4
- "version": "0.1.5-rc.2",
4
+ "version": "0.1.6-alpha.2",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -34,33 +34,34 @@
34
34
  }
35
35
  },
36
36
  "dependencies": {
37
- "@deepseek-ai/dsh-agent-loop": "^0.1.5-rc.2",
38
37
  "@deepseek-ai/cordis-plugin-timer": "^1.1.4",
39
- "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.5-rc.2",
40
- "@deepseek-ai/dsh-jobs-local": "^0.1.5-rc.2",
41
- "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
42
- "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
43
- "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
44
- "@deepseek-ai/dsh-llm-deepseek": "^0.1.5-rc.2",
45
- "@deepseek-ai/dsh-llm-retry": "^0.1.5-rc.2",
46
- "@deepseek-ai/dsh-plugin-package-inventory-deepseek": "^0.1.5-rc.2",
47
- "@deepseek-ai/dsh-sandbox-local": "^0.1.5-rc.2",
48
- "@deepseek-ai/dsh-scope": "^0.1.5-rc.2",
49
- "@deepseek-ai/dsh-sdk-app": "^0.1.5-rc.2",
50
- "@deepseek-ai/dsh-sandbox-policy": "^0.1.5-rc.2",
51
- "@deepseek-ai/dsh-sdk-jsonrpc-server": "^0.1.5-rc.2",
52
- "@deepseek-ai/dsh-session-log-deepseek": "^0.1.5-rc.2",
53
- "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.5-rc.2",
54
- "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.2",
55
- "@deepseek-ai/dsh-session-title": "^0.1.5-rc.2",
56
- "@deepseek-ai/dsh-subprocess-local": "^0.1.5-rc.2",
57
- "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.2",
58
- "@deepseek-ai/dsh-terminal": "^0.1.5-rc.2",
59
- "@deepseek-ai/dsh-terminal-bash": "^0.1.5-rc.2",
60
- "@deepseek-ai/dsh-tool-bash-persistent": "^0.1.5-rc.2",
61
- "@deepseek-ai/dsh-tool-pwsh-persistent": "^0.1.5-rc.2",
62
- "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
63
- "@deepseek-ai/dsh-session": "^0.1.5-rc.2"
38
+ "@deepseek-ai/dsh-agent-loop": "^0.1.6-alpha.2",
39
+ "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
40
+ "@deepseek-ai/dsh-deepseek-llm-api-extensions": "^0.1.6-alpha.2",
41
+ "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.2",
42
+ "@deepseek-ai/dsh-jobs-local": "^0.1.6-alpha.2",
43
+ "@deepseek-ai/dsh-llm": "^0.1.6-alpha.2",
44
+ "@deepseek-ai/dsh-llm-deepseek": "^0.1.6-alpha.2",
45
+ "@deepseek-ai/dsh-llm-retry": "^0.1.6-alpha.2",
46
+ "@deepseek-ai/dsh-mcp-resources": "^0.1.6-alpha.2",
47
+ "@deepseek-ai/dsh-plugin-package-inventory-deepseek": "^0.1.6-alpha.2",
48
+ "@deepseek-ai/dsh-sandbox-local": "^0.1.6-alpha.2",
49
+ "@deepseek-ai/dsh-sandbox-policy": "^0.1.6-alpha.2",
50
+ "@deepseek-ai/dsh-scope": "^0.1.6-alpha.2",
51
+ "@deepseek-ai/dsh-sdk-app": "^0.1.6-alpha.2",
52
+ "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
53
+ "@deepseek-ai/dsh-session-log-deepseek": "^0.1.6-alpha.2",
54
+ "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.6-alpha.2",
55
+ "@deepseek-ai/dsh-session-projection": "^0.1.6-alpha.2",
56
+ "@deepseek-ai/dsh-session-title": "^0.1.6-alpha.2",
57
+ "@deepseek-ai/dsh-subprocess-local": "^0.1.6-alpha.2",
58
+ "@deepseek-ai/dsh-system-prompt": "^0.1.6-alpha.2",
59
+ "@deepseek-ai/dsh-sdk-jsonrpc-server": "^0.1.6-alpha.2",
60
+ "@deepseek-ai/dsh-tool-bash-persistent": "^0.1.6-alpha.2",
61
+ "@deepseek-ai/dsh-tool-pwsh-persistent": "^0.1.6-alpha.2",
62
+ "@deepseek-ai/dsh-tools": "^0.1.6-alpha.2",
63
+ "@deepseek-ai/dsh-terminal-bash": "^0.1.6-alpha.2",
64
+ "@deepseek-ai/dsh-terminal": "^0.1.6-alpha.2"
64
65
  },
65
66
  "peerDependencies": {
66
67
  "@deepseek-ai/cordis": "^4.0.2"