@deepseek-ai/dsh-tool-present 0.1.7-alpha.2 → 0.1.7-rc.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.
package/README.i18n.yaml CHANGED
@@ -1,6 +1,46 @@
1
- # Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
2
- # side as of the last confirmed-consistent state. Both languages carry equal authority;
3
- # after editing either side, bring the other along and re-record with:
1
+ # Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
2
+ # section, a hash of its English and Chinese blocks outside code blocks and generated regions.
3
+ # After editing either side, bring the other along and re-record with:
4
4
  # pnpm run verify-translation-pairing --write packages/deliverables/tool-present/README.md
5
- README.md: a7eb9e7cf9060472258666de186a7ecefe7aa407
6
- README.zh.md: 5ba4ab5f100517708d80e4860d9e5eed0f43a801
5
+ /:
6
+ en: 77fa72665646fedb
7
+ zh: 2d360098a76804c8
8
+ /deepseek-ai-dsh-tool-present:
9
+ en: 7a9bcbc94c211b65
10
+ zh: 5e53b10028b5d918
11
+ /deepseek-ai-dsh-tool-present/summary:
12
+ en: 79708e6e895b94d0
13
+ zh: c98dc1ac9316eb50
14
+ /deepseek-ai-dsh-tool-present/table-of-contents:
15
+ en: d152484eb41ac6b4
16
+ zh: 09388d293f9be9cb
17
+ /deepseek-ai-dsh-tool-present/use-this-package:
18
+ en: f2726b49d9f4d5b3
19
+ zh: 10428317260e5cf1
20
+ /deepseek-ai-dsh-tool-present/understand-the-implementation:
21
+ en: 159f6961c4582e8f
22
+ zh: af4cc40de153d758
23
+ /deepseek-ai-dsh-tool-present/further-exploration:
24
+ en: 66269384f8c0d0f7
25
+ zh: b3d694d2f0ae588a
26
+ /deepseek-ai-dsh-tool-present/model-experience:
27
+ en: 215e7ba838619b7b
28
+ zh: a311da3843709f90
29
+ /deepseek-ai-dsh-tool-present/model-experience/present:
30
+ en: 695c689adf61838a
31
+ zh: 695c689adf61838a
32
+ /deepseek-ai-dsh-tool-present/model-experience/present/what-the-model-sees:
33
+ en: 3dcc5c0e182a3032
34
+ zh: 646f27cd4038017e
35
+ /deepseek-ai-dsh-tool-present/model-experience/present/token-effect:
36
+ en: fbe1ca0b530500a0
37
+ zh: e198e106b85714b6
38
+ /deepseek-ai-dsh-tool-present/model-experience/present/kv-cache-effect:
39
+ en: c5e95beba09dce3c
40
+ zh: 50f71fac2592f652
41
+ /deepseek-ai-dsh-tool-present/known-limitations-and-deferred-work:
42
+ en: 918d8b8f09063e68
43
+ zh: 48591e5324a462c4
44
+ /deepseek-ai-dsh-tool-present/known-limitations-and-deferred-work/dev-note:
45
+ en: e67f633dc6fe7773
46
+ zh: 3bb0c20c93f16f98
package/README.md CHANGED
@@ -73,7 +73,7 @@ The pure `./types` entry declares `PresentedFile` and the Session event without
73
73
 
74
74
  #### What the model sees
75
75
 
76
- The [present schema](../../../docs/tool-catalog.md#present) asks for existing accessible files: “Declare selected existing files accessible through the Session filesystem as final deliverables. Use present when the user needs a separate file deliverable, especially Office documents, spreadsheets, and slide decks. Prefer showing results in your final response when that is sufficient; creating or editing a file does not by itself require present. Usually select the 1-2 most important deliverables; include more when needed, but at most 4 files in a single present call. The files must already exist. The user opens the current source files; their contents are not copied or preserved.” Results report `Presented <path>` for each file; the program result and durable event contain paths and optional descriptions.
76
+ The [present schema](../../../docs/tool-catalog.md#present) asks for existing accessible files: “Declare existing files as final deliverables for the user. Use it when the user needs a separate file, especially Office documents, spreadsheets, and slide decks; prefer your final response when that suffices. The user opens the current files; their contents are not copied.” The `files` parameter asks for the 1-2 most important deliverables and at most 4 per call. Results report `Presented <path>` for each file; the program result and durable event contain paths and optional descriptions.
77
77
 
78
78
  #### Token effect
79
79
 
package/README.zh.md CHANGED
@@ -73,7 +73,7 @@ kind: "package-reference"
73
73
 
74
74
  #### 模型看到的内容
75
75
 
76
- [present schema](../../../docs/tool-catalog.zh.md#present)要求已有且可访问的文件:“Declare selected existing files accessible through the Session filesystem as final deliverables. Use present when the user needs a separate file deliverable, especially Office documents, spreadsheets, and slide decks. Prefer showing results in your final response when that is sufficient; creating or editing a file does not by itself require present. Usually select the 1-2 most important deliverables; include more when needed, but at most 4 files in a single present call. The files must already exist. The user opens the current source files; their contents are not copied or preserved.” 每个文件的结果为 `Presented <path>`;程序结果和持久事件包含路径及可选说明。
76
+ [present schema](../../../docs/tool-catalog.zh.md#present)要求已有且可访问的文件:“Declare existing files as final deliverables for the user. Use it when the user needs a separate file, especially Office documents, spreadsheets, and slide decks; prefer your final response when that suffices. The user opens the current files; their contents are not copied.” `files` 参数要求选择 1-2 个最重要的交付物,每次调用最多 4 个。每个文件的结果为 `Presented <path>`;程序结果和持久事件包含路径及可选说明。
77
77
 
78
78
  #### Token 影响
79
79
 
package/lib/index.js CHANGED
@@ -22,10 +22,11 @@ function apply(ctx, config) {
22
22
  const pending = /* @__PURE__ */ new WeakMap();
23
23
  ctx.tools.register(defineTool({
24
24
  name: "present",
25
- description: "Declare selected existing files accessible through the Session filesystem as final deliverables. Use present when the user needs a separate file deliverable, especially Office documents, spreadsheets, and slide decks. Prefer showing results in your final response when that is sufficient; creating or editing a file does not by itself require present. Usually select the 1-2 most important deliverables; include more when needed, but at most 4 files in a single present call. The files must already exist. The user opens the current source files; their contents are not copied or preserved.",
25
+ description: "Declare existing files as final deliverables for the user. Use it when the user needs a separate file, especially Office documents, spreadsheets, and slide decks; prefer your final response when that suffices. The user opens the current files; their contents are not copied.",
26
26
  parameters: { files: {
27
27
  type: "array",
28
28
  required: true,
29
+ description: "Usually the 1-2 most important deliverables; at most 4 per call.",
29
30
  items: {
30
31
  type: "object",
31
32
  additionalProperties: false,
@@ -21,14 +21,14 @@ export function apply(ctx, config) {
21
21
  const pending = new WeakMap();
22
22
  ctx.tools.register(defineTool({
23
23
  name: 'present',
24
- description: 'Declare selected existing files accessible through the Session filesystem as final deliverables. '
25
- + 'Use present when the user needs a separate file deliverable, especially Office documents, spreadsheets, and slide decks. '
26
- + 'Prefer showing results in your final response when that is sufficient; creating or editing a file does not by itself require present. '
27
- + 'Usually select the 1-2 most important deliverables; include more when needed, but at most 4 files in a single present call. '
28
- + 'The files must already exist. The user opens the current source files; their contents are not copied or preserved.',
24
+ description: 'Declare existing files as final deliverables for the user. '
25
+ + 'Use it when the user needs a separate file, especially Office documents, spreadsheets, and slide decks; '
26
+ + 'prefer your final response when that suffices. The user opens the current files; their contents are not copied.',
29
27
  parameters: {
30
28
  files: {
31
29
  type: 'array', required: true,
30
+ // 4 is the recommended per-call count; `maxFiles` is the enforced ceiling above it.
31
+ description: 'Usually the 1-2 most important deliverables; at most 4 per call.',
32
32
  items: {
33
33
  type: 'object', additionalProperties: false,
34
34
  properties: {
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@deepseek-ai/dsh-tool-present",
3
3
  "description": "Explicit workspace file delivery declarations for the DeepSeek Harness",
4
- "version": "0.1.7-alpha.2",
4
+ "version": "0.1.7-rc.2",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
@@ -36,25 +36,25 @@
36
36
  },
37
37
  "peerDependencies": {
38
38
  "@deepseek-ai/cordis": "~4.0.4",
39
- "@deepseek-ai/dsh-fs": "0.1.7-alpha.2",
40
- "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
41
- "@deepseek-ai/dsh-llm": "0.1.7-alpha.2",
42
- "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
43
- "@deepseek-ai/dsh-tools": "0.1.7-alpha.2",
44
- "@deepseek-ai/dsh-session-projection": "0.1.7-alpha.2"
39
+ "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
40
+ "@deepseek-ai/dsh-fs": "0.1.7-rc.2",
41
+ "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
42
+ "@deepseek-ai/dsh-session": "0.1.7-rc.2",
43
+ "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
44
+ "@deepseek-ai/dsh-session-projection": "0.1.7-rc.2"
45
45
  },
46
46
  "devDependencies": {
47
47
  "@deepseek-ai/cordis": "~4.0.4",
48
- "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
49
- "@deepseek-ai/dsh-llm": "0.1.7-alpha.2",
50
- "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
51
- "@deepseek-ai/dsh-fs": "0.1.7-alpha.2",
52
- "@deepseek-ai/dsh-session-projection": "0.1.7-alpha.2",
53
- "@deepseek-ai/dsh-agent-loop": "0.1.7-alpha.2",
54
- "@deepseek-ai/dsh-tools": "0.1.7-alpha.2",
55
- "@deepseek-ai/dsh-agent-loop-testkit": "0.1.7-alpha.2",
56
- "@deepseek-ai/dsh-fs-local": "0.1.7-alpha.2",
57
- "@deepseek-ai/dsh-system-prompt": "0.1.7-alpha.2",
58
- "@deepseek-ai/dsh-scope": "0.1.7-alpha.2"
48
+ "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
49
+ "@deepseek-ai/dsh-fs": "0.1.7-rc.2",
50
+ "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
51
+ "@deepseek-ai/dsh-session": "0.1.7-rc.2",
52
+ "@deepseek-ai/dsh-session-projection": "0.1.7-rc.2",
53
+ "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
54
+ "@deepseek-ai/dsh-agent-loop": "0.1.7-rc.2",
55
+ "@deepseek-ai/dsh-agent-loop-testkit": "0.1.7-rc.2",
56
+ "@deepseek-ai/dsh-fs-local": "0.1.7-rc.2",
57
+ "@deepseek-ai/dsh-scope": "0.1.7-rc.2",
58
+ "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.2"
59
59
  }
60
60
  }