@x1a0f3n9/dsh-tool-present 0.1.5-rc.4 → 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:
4
- # pnpm run verify-translation-pairing --write packages/fs/tool-present/README.md
5
- README.md: 93003711545f678336a02c9bf8589176f844af65
6
- README.zh.md: 161efcc3931fbf57175064ccf1179b195320d4b9
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
+ # pnpm run verify-translation-pairing --write packages/deliverables/tool-present/README.md
5
+ /:
6
+ en: 77fa72665646fedb
7
+ zh: 2d360098a76804c8
8
+ /x1a0f3n9-dsh-tool-present:
9
+ en: 87c527d4e133400c
10
+ zh: 683f7cfaae5f81e5
11
+ /x1a0f3n9-dsh-tool-present/summary:
12
+ en: 79708e6e895b94d0
13
+ zh: c98dc1ac9316eb50
14
+ /x1a0f3n9-dsh-tool-present/table-of-contents:
15
+ en: d152484eb41ac6b4
16
+ zh: 09388d293f9be9cb
17
+ /x1a0f3n9-dsh-tool-present/use-this-package:
18
+ en: f2726b49d9f4d5b3
19
+ zh: 10428317260e5cf1
20
+ /x1a0f3n9-dsh-tool-present/understand-the-implementation:
21
+ en: 159f6961c4582e8f
22
+ zh: af4cc40de153d758
23
+ /x1a0f3n9-dsh-tool-present/further-exploration:
24
+ en: 66269384f8c0d0f7
25
+ zh: b3d694d2f0ae588a
26
+ /x1a0f3n9-dsh-tool-present/model-experience:
27
+ en: 215e7ba838619b7b
28
+ zh: a311da3843709f90
29
+ /x1a0f3n9-dsh-tool-present/model-experience/present:
30
+ en: 695c689adf61838a
31
+ zh: 695c689adf61838a
32
+ /x1a0f3n9-dsh-tool-present/model-experience/present/what-the-model-sees:
33
+ en: 3dcc5c0e182a3032
34
+ zh: 646f27cd4038017e
35
+ /x1a0f3n9-dsh-tool-present/model-experience/present/token-effect:
36
+ en: fbe1ca0b530500a0
37
+ zh: e198e106b85714b6
38
+ /x1a0f3n9-dsh-tool-present/model-experience/present/kv-cache-effect:
39
+ en: c5e95beba09dce3c
40
+ zh: 50f71fac2592f652
41
+ /x1a0f3n9-dsh-tool-present/known-limitations-and-deferred-work:
42
+ en: 918d8b8f09063e68
43
+ zh: 48591e5324a462c4
44
+ /x1a0f3n9-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 existing files accessible through the Session filesystem as final deliverables. When a file you create or update is an output the user asked to receive, you must call present after writing it and before your final response, including files created through Bash or code execution. Mentioning its path in your reply does not replace this 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 existing files accessible through the Session filesystem as final deliverables. When a file you create or update is an output the user asked to receive, you must call present after writing it and before your final response, including files created through Bash or code execution. Mentioning its path in your reply does not replace this 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 existing files accessible through the Session filesystem as final deliverables. When a file you create or update is an output the user asked to receive, you must call present after writing it and before your final response, including files created through Bash or code execution. Mentioning its path in your reply does not replace this 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,13 +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 existing files accessible through the Session filesystem as final deliverables. '
25
- + 'When a file you create or update is an output the user asked to receive, you must call present after writing it and before your final response, including files created through Bash or code execution. '
26
- + 'Mentioning its path in your reply does not replace this call. The files must already exist. '
27
- + '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.',
28
27
  parameters: {
29
28
  files: {
30
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.',
31
32
  items: {
32
33
  type: 'object', additionalProperties: false,
33
34
  properties: {
package/package.json CHANGED
@@ -1,14 +1,14 @@
1
1
  {
2
2
  "name": "@x1a0f3n9/dsh-tool-present",
3
3
  "description": "Explicit workspace file delivery declarations for the DeepSeek Harness",
4
- "version": "0.1.5-rc.4",
4
+ "version": "0.1.7-rc.2",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
8
8
  "repository": {
9
9
  "type": "git",
10
10
  "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
11
- "directory": "packages/fs/tool-present"
11
+ "directory": "packages/deliverables/tool-present"
12
12
  },
13
13
  "type": "module",
14
14
  "main": "lib/index.js",
@@ -32,29 +32,29 @@
32
32
  "lib/types/**/*.d.ts"
33
33
  ],
34
34
  "dependencies": {
35
- "@deepseek-ai/schemastery": "^3.18.2"
35
+ "@deepseek-ai/schemastery": "~3.18.4"
36
36
  },
37
37
  "peerDependencies": {
38
- "@deepseek-ai/cordis": "^4.0.2",
39
- "@x1a0f3n9/dsh-agent": "^0.1.5-rc.4",
40
- "@x1a0f3n9/dsh-fs": "^0.1.5-rc.4",
41
- "@x1a0f3n9/dsh-llm": "^0.1.5-rc.4",
42
- "@x1a0f3n9/dsh-session": "^0.1.5-rc.4",
43
- "@x1a0f3n9/dsh-session-projection": "^0.1.5-rc.4",
44
- "@x1a0f3n9/dsh-tools": "^0.1.5-rc.4"
38
+ "@deepseek-ai/cordis": "~4.0.4",
39
+ "@x1a0f3n9/dsh-agent": "0.1.7-rc.2",
40
+ "@x1a0f3n9/dsh-fs": "0.1.7-rc.2",
41
+ "@x1a0f3n9/dsh-llm": "0.1.7-rc.2",
42
+ "@x1a0f3n9/dsh-session": "0.1.7-rc.2",
43
+ "@x1a0f3n9/dsh-session-projection": "0.1.7-rc.2",
44
+ "@x1a0f3n9/dsh-tools": "0.1.7-rc.2"
45
45
  },
46
46
  "devDependencies": {
47
- "@deepseek-ai/cordis": "^4.0.2",
48
- "@x1a0f3n9/dsh-agent": "^0.1.5-rc.4",
49
- "@x1a0f3n9/dsh-fs": "^0.1.5-rc.4",
50
- "@x1a0f3n9/dsh-llm": "^0.1.5-rc.4",
51
- "@x1a0f3n9/dsh-session": "^0.1.5-rc.4",
52
- "@x1a0f3n9/dsh-session-projection": "^0.1.5-rc.4",
53
- "@x1a0f3n9/dsh-tools": "^0.1.5-rc.4",
54
- "@x1a0f3n9/dsh-agent-loop": "^0.1.5-rc.4",
55
- "@x1a0f3n9/dsh-agent-loop-testkit": "^0.1.5-rc.4",
56
- "@x1a0f3n9/dsh-fs-local": "^0.1.5-rc.4",
57
- "@x1a0f3n9/dsh-system-prompt": "^0.1.5-rc.4",
58
- "@x1a0f3n9/dsh-scope": "^0.1.5-rc.4"
47
+ "@deepseek-ai/cordis": "~4.0.4",
48
+ "@x1a0f3n9/dsh-agent": "0.1.7-rc.2",
49
+ "@x1a0f3n9/dsh-fs": "0.1.7-rc.2",
50
+ "@x1a0f3n9/dsh-llm": "0.1.7-rc.2",
51
+ "@x1a0f3n9/dsh-session": "0.1.7-rc.2",
52
+ "@x1a0f3n9/dsh-session-projection": "0.1.7-rc.2",
53
+ "@x1a0f3n9/dsh-tools": "0.1.7-rc.2",
54
+ "@x1a0f3n9/dsh-agent-loop": "0.1.7-rc.2",
55
+ "@x1a0f3n9/dsh-agent-loop-testkit": "0.1.7-rc.2",
56
+ "@x1a0f3n9/dsh-fs-local": "0.1.7-rc.2",
57
+ "@x1a0f3n9/dsh-system-prompt": "0.1.7-rc.2",
58
+ "@x1a0f3n9/dsh-scope": "0.1.7-rc.2"
59
59
  }
60
60
  }