@x1a0f3n9/dsh-tool-skill 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.
Files changed (5) hide show
  1. package/README.i18n.yaml +135 -5
  2. package/README.md +1 -1
  3. package/README.zh.md +1 -1
  4. package/lib/index.js +4 -2
  5. package/package.json +16 -16
package/README.i18n.yaml CHANGED
@@ -1,6 +1,136 @@
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/skill/tool-skill/README.md
5
- README.md: eeee637c25bc38138deaf907e6bf73202f408b96
6
- README.zh.md: f2c1adf49a838e84fd488f0cb803d3aa30f8b8ca
5
+ /:
6
+ en: e1bb629bc25d7d51
7
+ zh: 0018e221e28ddcff
8
+ /x1a0f3n9-dsh-tool-skill:
9
+ en: fc4f8f50246a8ba8
10
+ zh: ff228fafb8b81720
11
+ /x1a0f3n9-dsh-tool-skill/summary:
12
+ en: 399399741476179c
13
+ zh: 074ec6657481d320
14
+ /x1a0f3n9-dsh-tool-skill/table-of-contents:
15
+ en: d152484eb41ac6b4
16
+ zh: 09388d293f9be9cb
17
+ /x1a0f3n9-dsh-tool-skill/use-this-package:
18
+ en: 5c21d1ba71c1c3e1
19
+ zh: 3e2505d4625b57b4
20
+ /x1a0f3n9-dsh-tool-skill/use-this-package/when-to-choose-it:
21
+ en: b7d33bd969826ee3
22
+ zh: 4e155a0f14b41541
23
+ /x1a0f3n9-dsh-tool-skill/use-this-package/mount-and-configure:
24
+ en: 440b17442e431e27
25
+ zh: f8e6d8ef9a954e86
26
+ /x1a0f3n9-dsh-tool-skill/use-this-package/what-the-model-gets:
27
+ en: cf02796bd3f8877e
28
+ zh: 81b93b1eb7f74690
29
+ /x1a0f3n9-dsh-tool-skill/use-this-package/observable-success-and-failures:
30
+ en: 813f1a7ab04d283e
31
+ zh: 4adfcffcbb131d54
32
+ /x1a0f3n9-dsh-tool-skill/understand-the-implementation:
33
+ en: 1aa627255c35178f
34
+ zh: 44d8633ea56765d3
35
+ /x1a0f3n9-dsh-tool-skill/understand-the-implementation/design-concept:
36
+ en: ee4380c98437d699
37
+ zh: 25f35ec8c8c47c00
38
+ /x1a0f3n9-dsh-tool-skill/understand-the-implementation/source-map:
39
+ en: 9a8fa8b8305ef86a
40
+ zh: f80fbdfb2a8f1818
41
+ /x1a0f3n9-dsh-tool-skill/understand-the-implementation/catalog-lifecycle:
42
+ en: b4e19723b4f1f8d4
43
+ zh: be3c88571cb5ba91
44
+ /x1a0f3n9-dsh-tool-skill/understand-the-implementation/invocation-boundary:
45
+ en: bb8543ea29cbc451
46
+ zh: b1124fa489bf9ea4
47
+ /x1a0f3n9-dsh-tool-skill/further-exploration:
48
+ en: c4797732cde7d1f5
49
+ zh: daabfd858cceb271
50
+ /x1a0f3n9-dsh-tool-skill/model-experience:
51
+ en: 215e7ba838619b7b
52
+ zh: a311da3843709f90
53
+ /x1a0f3n9-dsh-tool-skill/model-experience/session-catalog:
54
+ en: ed929c61dd301a56
55
+ zh: 376c8d69b6fa7df6
56
+ /x1a0f3n9-dsh-tool-skill/model-experience/session-catalog/what-the-model-sees:
57
+ en: 7a72af69a2e0c8ee
58
+ zh: b625a7359d6c04d0
59
+ /x1a0f3n9-dsh-tool-skill/model-experience/session-catalog/what-the-model-sees/skill-catalog-template:
60
+ en: 8ca9241e26124ce3
61
+ zh: d083f87eaae40e15
62
+ /x1a0f3n9-dsh-tool-skill/model-experience/session-catalog/token-effect:
63
+ en: c05d3d46e5139c4d
64
+ zh: 8acfa475cddaeb18
65
+ /x1a0f3n9-dsh-tool-skill/model-experience/session-catalog/kv-cache-effect:
66
+ en: e6e6758c96527e19
67
+ zh: 8f95e36da658c95a
68
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-schema:
69
+ en: e4c7376d4f29dbd5
70
+ zh: 6b7a9eaf69c9ea53
71
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-schema/what-the-model-sees:
72
+ en: ddb8043726aba539
73
+ zh: 6c76beea062921ea
74
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-schema/token-effect:
75
+ en: 4a8881f7a361cb7f
76
+ zh: cba76f0578a36953
77
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-schema/kv-cache-effect:
78
+ en: 77f9b9513ed7692d
79
+ zh: 249f6b975a2db718
80
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-result:
81
+ en: f8ffc2b983f05ffc
82
+ zh: 8573891441963be4
83
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-result/what-the-model-sees:
84
+ en: a1bc95abf3a7493c
85
+ zh: e3d200040493c0a7
86
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-result/what-the-model-sees/skill-result-template:
87
+ en: 66220f8d7628e5cc
88
+ zh: d8469e173485a5ca
89
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-result/what-the-model-sees/provider-managed-resource-guidance:
90
+ en: 80107e79cb15b0d0
91
+ zh: c53f14bb87aa8395
92
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-result/what-the-model-sees/directory-resource-guidance:
93
+ en: 9a060c44c0d00e06
94
+ zh: 13ccf1d8b8e3d865
95
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-result/what-the-model-sees/url-resource-guidance:
96
+ en: 6f4bc625155f73e3
97
+ zh: 4bc8641df028caed
98
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-result/what-the-model-sees/opaque-resource-guidance:
99
+ en: 958b9c46d9785397
100
+ zh: 34f053e4ab8296c2
101
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-result/token-effect:
102
+ en: 8604cca6caa413a0
103
+ zh: 1b0412b8008e76c8
104
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-result/kv-cache-effect:
105
+ en: f5d5f97a153f7c70
106
+ zh: bee82b41983a66a0
107
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-errors:
108
+ en: 2d4f2c8605eccab3
109
+ zh: 67f1f0218f73c6bf
110
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-errors/what-the-model-sees:
111
+ en: 3e70742d93164968
112
+ zh: 63fd2159c9cc5c8c
113
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-errors/token-effect:
114
+ en: 681cadd5be7b8ac1
115
+ zh: 5e169acfd30b2931
116
+ /x1a0f3n9-dsh-tool-skill/model-experience/tool-errors/kv-cache-effect:
117
+ en: f5d5f97a153f7c70
118
+ zh: bee82b41983a66a0
119
+ /x1a0f3n9-dsh-tool-skill/model-experience/user-explicit-invocation-injection:
120
+ en: 657124bac34aba61
121
+ zh: 00aae3514ab12676
122
+ /x1a0f3n9-dsh-tool-skill/model-experience/user-explicit-invocation-injection/what-the-model-sees:
123
+ en: f9c7b7c6cb042d2f
124
+ zh: ba3372515505f413
125
+ /x1a0f3n9-dsh-tool-skill/model-experience/user-explicit-invocation-injection/token-effect:
126
+ en: d1068ea431fb768f
127
+ zh: acacd161731c27c6
128
+ /x1a0f3n9-dsh-tool-skill/model-experience/user-explicit-invocation-injection/kv-cache-effect:
129
+ en: 127c0139472bfaab
130
+ zh: 805dc2f730c47f40
131
+ /x1a0f3n9-dsh-tool-skill/known-limitations-and-deferred-work:
132
+ en: 6017a1dc04618288
133
+ zh: d613164f0e9258f9
134
+ /x1a0f3n9-dsh-tool-skill/known-limitations-and-deferred-work/dev-note:
135
+ en: e67f633dc6fe7773
136
+ zh: 3bb0c20c93f16f98
package/README.md CHANGED
@@ -81,7 +81,7 @@ The package is built on two ideas. First, the catalog is a durable projection, d
81
81
 
82
82
  ### Catalog lifecycle
83
83
 
84
- At each eligible `agent/pre-step`, the plugin snapshots the calling session's skill catalog, applies exact `skill` tool visibility, filters to model-invocable skills, and compares a digest of the entries against the newest visible `skill-catalog` message in the session log. When the digest changed, it hands the `enter` decision a durable user-role message containing the complete replacement catalog; an empty replacement explicitly retires earlier names. An incomplete provider snapshot emits nothing and preserves the last-good view for the next pre-step. The visibility check compares against the exact tool definition this plugin registered, so a scoped same-name shadow removes both the schema and its guidance; the plugin works mounted globally or inside one agent's composition.
84
+ At each eligible `agent/pre-step`, the plugin snapshots the calling session's skill catalog, applies exact `skill` tool visibility, filters to model-invocable skills, and compares a digest of the entries against the newest visible `skill-catalog` message in the live RAM window (`liveBaseSeq` and later). A catalog that remains only in a released prefix is unseen, so the next eligible pre-step may append a replacement rather than fail the step. When the digest changed, it hands the `enter` decision a durable user-role message containing the complete replacement catalog; an empty replacement explicitly retires earlier names. An incomplete provider snapshot emits nothing and preserves the last-good view for the next pre-step. The visibility check compares against the exact tool definition this plugin registered, so a scoped same-name shadow removes both the schema and its guidance; the plugin works mounted globally or inside one agent's composition.
85
85
 
86
86
  ### Invocation boundary
87
87
 
package/README.zh.md CHANGED
@@ -81,7 +81,7 @@ agent 可以在会话期间发现并加载 skill。在首次请求前，如果
81
81
 
82
82
  ### 目录生命周期
83
83
 
84
- 在每次符合条件的 `agent/pre-step`，插件都会快照调用会话的 skill 目录，应用 `skill` 工具的精确可见性，过滤出模型可调用的 skill，并把条目 digest 与会话日志中最新可见的 `skill-catalog` 消息做比较。digest 变化时，它把包含完整替换目录的持久用户角色消息交给 `enter` 决策；空替换会显式停用较早的名称。提供方快照不完整时不发送任何内容，并为下一次 pre-step 保留最后一份可用视图。可见性检查针对本插件所注册的精确工具定义，因此作用域内同名的遮蔽项会同时移除 schema 及其指引；该插件既可全局挂载，也可挂在单个 agent 的组合内。
84
+ 在每次符合条件的 `agent/pre-step`，插件都会快照调用会话的 skill 目录，应用 `skill` 工具的精确可见性，过滤出模型可调用的 skill，并把条目 digest 与存活 RAM 窗口（`liveBaseSeq` 及之后）中最新可见的 `skill-catalog` 消息做比较。只留在已释放前缀里的目录视为未见过，因此下一次符合条件的 pre-step 可能追加一份替换，而不是让本步失败。digest 变化时，它把包含完整替换目录的持久用户角色消息交给 `enter` 决策；空替换会显式停用较早的名称。提供方快照不完整时不发送任何内容，并为下一次 pre-step 保留最后一份可用视图。可见性检查针对本插件所注册的精确工具定义，因此作用域内同名的遮蔽项会同时移除 schema 及其指引；该插件既可全局挂载，也可挂在单个 agent 的组合内。
85
85
 
86
86
  ### 调用边界
87
87
 
package/lib/index.js CHANGED
@@ -58,7 +58,7 @@ function apply(ctx, config = {}) {
58
58
  assertPositiveInteger("catalogDescriptionMaxLength", catalogDescriptionMaxLength, 3);
59
59
  const skillTool = defineTool({
60
60
  name: "skill",
61
- description: "Load the full instructions for an available skill. Call this with the exact skill name from the session skill catalog before acting on a task that names or clearly matches that skill.",
61
+ description: "Load the full instructions for a skill. Call it before acting on a task that names or clearly matches a skill in the session skill catalog.",
62
62
  parameters: { name: {
63
63
  type: "string",
64
64
  required: true,
@@ -328,10 +328,12 @@ function readCatalogEntries(source) {
328
328
  }
329
329
  return readable;
330
330
  }
331
+ /** Newest live-window catalog only; seqs before liveBaseSeq are a released prefix, not a hole. */
331
332
  function catalogHistory(agent) {
332
333
  const visible = new Set(agent.session.surface.nodes);
333
334
  let published = false;
334
- for (let index = agent.session.seq - 1; index >= 0; index -= 1) {
335
+ const liveBase = agent.session.liveBaseSeq;
336
+ for (let index = agent.session.seq - 1; index >= liveBase; index -= 1) {
335
337
  const event = agent.session.eventAt(SessionSeq(index));
336
338
  if (event === void 0) throw new Error(`skill catalog cannot read seq ${String(index)} below the current Session length`);
337
339
  if (event.type !== "user/message" || event.data.source.kind !== "skill-catalog") continue;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@x1a0f3n9/dsh-tool-skill",
3
3
  "description": "Model-facing skill loading tool 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
  },
@@ -27,24 +27,24 @@
27
27
  ],
28
28
  "license": "MIT",
29
29
  "peerDependencies": {
30
- "@x1a0f3n9/dsh-agent": "^0.1.5-rc.4",
31
- "@x1a0f3n9/dsh-llm": "^0.1.5-rc.4",
32
- "@x1a0f3n9/dsh-skill": "^0.1.5-rc.4",
33
- "@x1a0f3n9/dsh-tools": "^0.1.5-rc.4",
34
- "@deepseek-ai/cordis": "^4.0.2"
30
+ "@x1a0f3n9/dsh-agent": "0.1.7-rc.2",
31
+ "@x1a0f3n9/dsh-llm": "0.1.7-rc.2",
32
+ "@x1a0f3n9/dsh-skill": "0.1.7-rc.2",
33
+ "@x1a0f3n9/dsh-tools": "0.1.7-rc.2",
34
+ "@deepseek-ai/cordis": "~4.0.4"
35
35
  },
36
36
  "dependencies": {
37
- "@deepseek-ai/schemastery": "^3.18.2"
37
+ "@deepseek-ai/schemastery": "~3.18.4"
38
38
  },
39
39
  "devDependencies": {
40
- "@x1a0f3n9/dsh-agent": "^0.1.5-rc.4",
41
- "@x1a0f3n9/dsh-agent-loop-testkit": "^0.1.5-rc.4",
42
- "@x1a0f3n9/dsh-llm": "^0.1.5-rc.4",
43
- "@x1a0f3n9/dsh-scope": "^0.1.5-rc.4",
44
- "@x1a0f3n9/dsh-session": "^0.1.5-rc.4",
45
- "@x1a0f3n9/dsh-skill": "^0.1.5-rc.4",
46
- "@x1a0f3n9/dsh-skill-filesystem": "^0.1.5-rc.4",
47
- "@x1a0f3n9/dsh-tools": "^0.1.5-rc.4",
48
- "@deepseek-ai/cordis": "^4.0.2"
40
+ "@x1a0f3n9/dsh-agent": "0.1.7-rc.2",
41
+ "@x1a0f3n9/dsh-agent-loop-testkit": "0.1.7-rc.2",
42
+ "@x1a0f3n9/dsh-llm": "0.1.7-rc.2",
43
+ "@x1a0f3n9/dsh-scope": "0.1.7-rc.2",
44
+ "@x1a0f3n9/dsh-session": "0.1.7-rc.2",
45
+ "@x1a0f3n9/dsh-skill": "0.1.7-rc.2",
46
+ "@x1a0f3n9/dsh-skill-filesystem": "0.1.7-rc.2",
47
+ "@x1a0f3n9/dsh-tools": "0.1.7-rc.2",
48
+ "@deepseek-ai/cordis": "~4.0.4"
49
49
  }
50
50
  }