dsh-plugin-guide 0.3.33 → 0.3.36

package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.i18n.yaml

@@ -0,0 +1,28 @@
+# Bilingual-pair consistency record for 2026-09-30-job-session-lifecycle.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write docs/persistence-changes/2026-09-30-job-session-lifecycle.md
+/:
+  en: 3d5a424ae7d7e46b
+  zh: c22a8e4a62d8cc1a
+/2026-09-30-job-session-lifecycle:
+  en: 9be8dc8cb5ce646a
+  zh: 6ce0040813c36e92
+/2026-09-30-job-session-lifecycle/summary:
+  en: 7d98020db3395e2e
+  zh: abe692ef42327e49
+/2026-09-30-job-session-lifecycle/table-of-contents:
+  en: 6cf314a069ceb451
+  zh: 9adff678e9ecab3b
+/2026-09-30-job-session-lifecycle/declaration:
+  en: 6907136f28e48c90
+  zh: 02f8298485f3d8e7
+/2026-09-30-job-session-lifecycle/compatibility:
+  en: 546fe003ad5293b6
+  zh: 86d78c9704a03718
+/2026-09-30-job-session-lifecycle/verification:
+  en: e9660a31a43378fc
+  zh: e97fbe31ff47ea2e
+/2026-09-30-job-session-lifecycle/dev-note:
+  en: b75c8458928b72b9
+  zh: 003ba4e17b4b5269

package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.md

@@ -0,0 +1,52 @@
+---
+description: "Records a persistence type transition and its compatibility acknowledgement."
+kind: persistence-change
+---
+
+# 2026-09-30-job-session-lifecycle
+
+English | [中文](2026-09-30-job-session-lifecycle.zh.md)
+
+## Summary
+
+Records owned job registration and settlement with one unique JobId, original timestamps, creating tool calls, and producer completion reports.
+
+## Table of Contents
+
+- [Declaration](#declaration)
+- [Compatibility](#compatibility)
+- [Verification](#verification)
+- [Dev Note](#dev-note)
+
+<a id="declaration"></a>
+## Declaration
+
+```yaml persistence-change
+schemaVersion: 1
+id: 2026-09-30-job-session-lifecycle
+baseline: false
+changes:
+  - root: "event:job/registered"
+    previous: null
+    after: "f5520c1d261ca86ea03735799c311a0a9ede8babb588cf0a65422576d2ee0ad1"
+    decision: same-version
+  - root: "event:job/settled"
+    previous: null
+    after: "edd37b1e4974af648633014435572089b1e8fb71910468a0767a7e28fdd22abf"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## Compatibility
+
+Adds required job event kinds without changing the Session envelope. New JobIds use a kind-prefixed UUID for both live controls and durable pairing; historical sessions receive no fabricated job history. Older builds reject unknown required events. producerReported describes completion-promise fulfillment, not verified resource release.
+
+<a id="verification"></a>
+## Verification
+
+Registry and snapshot-normalizer tests cover causal order and unique JobIds. CLI and SDK snapshots verify registration, settlement, and notices during execution; the [job lifecycle contract](../subsystems/jobs.md#session-lifecycle-records) allows incomplete terminal history during application teardown.
+
+<a id="dev-note"></a>
+## Dev Note
+
+None.

package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.schema.json

@@ -0,0 +1,297 @@
+{
+  "formatVersion": 2,
+  "roots": [
+    {
+      "key": "event:job/registered",
+      "kind": "event",
+      "event": "job/registered",
+      "surface": false,
+      "digest": "f5520c1d261ca86ea03735799c311a0a9ede8babb588cf0a65422576d2ee0ad1",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "data",
+                "type": 1,
+                "optional": false
+              },
+              {
+                "name": "ignorable",
+                "type": 5,
+                "optional": true
+              },
+              {
+                "name": "seq",
+                "type": 3,
+                "optional": false
+              },
+              {
+                "name": "time",
+                "type": 3,
+                "optional": false
+              },
+              {
+                "name": "type",
+                "type": 6,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "jobId",
+                "type": 2,
+                "optional": false
+              },
+              {
+                "name": "kind",
+                "type": 2,
+                "optional": false
+              },
+              {
+                "name": "label",
+                "type": 2,
+                "optional": false
+              },
+              {
+                "name": "owner",
+                "type": 2,
+                "optional": false
+              },
+              {
+                "name": "startedAt",
+                "type": 3,
+                "optional": false
+              },
+              {
+                "name": "toolCall",
+                "type": 4,
+                "optional": true
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "primitive",
+            "type": "string"
+          },
+          {
+            "kind": "primitive",
+            "type": "number"
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "callId",
+                "type": 2,
+                "optional": false
+              },
+              {
+                "name": "rootCallId",
+                "type": 2,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "literal",
+            "value": true
+          },
+          {
+            "kind": "literal",
+            "value": "job/registered"
+          }
+        ]
+      }
+    },
+    {
+      "key": "event:job/settled",
+      "kind": "event",
+      "event": "job/settled",
+      "surface": false,
+      "digest": "edd37b1e4974af648633014435572089b1e8fb71910468a0767a7e28fdd22abf",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "data",
+                "type": 1,
+                "optional": false
+              },
+              {
+                "name": "ignorable",
+                "type": 14,
+                "optional": true
+              },
+              {
+                "name": "seq",
+                "type": 7,
+                "optional": false
+              },
+              {
+                "name": "time",
+                "type": 7,
+                "optional": false
+              },
+              {
+                "name": "type",
+                "type": 15,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "cause",
+                "type": 2,
+                "optional": false
+              },
+              {
+                "name": "detail",
+                "type": 6,
+                "optional": true
+              },
+              {
+                "name": "finishedAt",
+                "type": 7,
+                "optional": false
+              },
+              {
+                "name": "jobId",
+                "type": 6,
+                "optional": false
+              },
+              {
+                "name": "kind",
+                "type": 6,
+                "optional": false
+              },
+              {
+                "name": "label",
+                "type": 6,
+                "optional": false
+              },
+              {
+                "name": "owner",
+                "type": 6,
+                "optional": false
+              },
+              {
+                "name": "producerReported",
+                "type": 8,
+                "optional": false
+              },
+              {
+                "name": "startedAt",
+                "type": 7,
+                "optional": false
+              },
+              {
+                "name": "status",
+                "type": 9,
+                "optional": false
+              },
+              {
+                "name": "toolCall",
+                "type": 13,
+                "optional": true
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "union",
+            "types": [
+              3,
+              4,
+              5
+            ]
+          },
+          {
+            "kind": "literal",
+            "value": "producer"
+          },
+          {
+            "kind": "literal",
+            "value": "teardown"
+          },
+          {
+            "kind": "literal",
+            "value": "kill"
+          },
+          {
+            "kind": "primitive",
+            "type": "string"
+          },
+          {
+            "kind": "primitive",
+            "type": "number"
+          },
+          {
+            "kind": "primitive",
+            "type": "boolean"
+          },
+          {
+            "kind": "union",
+            "types": [
+              10,
+              11,
+              12
+            ]
+          },
+          {
+            "kind": "literal",
+            "value": "completed"
+          },
+          {
+            "kind": "literal",
+            "value": "failed"
+          },
+          {
+            "kind": "literal",
+            "value": "killed"
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "callId",
+                "type": 6,
+                "optional": false
+              },
+              {
+                "name": "rootCallId",
+                "type": 6,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "literal",
+            "value": true
+          },
+          {
+            "kind": "literal",
+            "value": "job/settled"
+          }
+        ]
+      }
+    }
+  ],
+  "types": []
+}

package/references/official-docs/docs/persistence-changes/2026-09-30-job-session-lifecycle.zh.md

@@ -0,0 +1,52 @@
+---
+description: "记录持久化类型更改及其兼容性确认。"
+kind: persistence-change
+---
+
+# 2026-09-30-job-session-lifecycle
+
+[English](2026-09-30-job-session-lifecycle.md) | 中文
+
+## 概述
+
+以唯一 JobId 将有所有者 job 的注册与结算记录为 Session 事件，包含原始时间戳、创建工具调用和生产方完成报告。
+
+## 目录
+
+- [声明](#declaration)
+- [兼容性](#compatibility)
+- [验证](#verification)
+- [开发备注](#dev-note)
+
+<a id="declaration"></a>
+## 声明
+
+```yaml persistence-change
+schemaVersion: 1
+id: 2026-09-30-job-session-lifecycle
+baseline: false
+changes:
+  - root: "event:job/registered"
+    previous: null
+    after: "f5520c1d261ca86ea03735799c311a0a9ede8babb588cf0a65422576d2ee0ad1"
+    decision: same-version
+  - root: "event:job/settled"
+    previous: null
+    after: "edd37b1e4974af648633014435572089b1e8fb71910468a0767a7e28fdd22abf"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## 兼容性
+
+增加必需的 job 事件类型，不改变 Session 封装。新 JobId 用带 kind 前缀的 UUID 同时进行运行期控制与持久化配对；不为历史会话补造 job 事件。旧构建拒绝未知的必需事件。producerReported 表示完成 promise 兑现，不确认资源已释放。
+
+<a id="verification"></a>
+## 验证
+
+注册表和快照归一化测试覆盖因果顺序与唯一 JobId。CLI 和 SDK 快照验证运行中的注册、结算和通知；[job 生命周期约定](../subsystems/jobs.zh.md#session-lifecycle-records)允许应用销毁时留下不完整的终态历史。
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。

package/references/official-docs/docs/persistence-changes/2026-10-13-deepseek-search-thinking.i18n.yaml

@@ -0,0 +1,28 @@
+# Bilingual-pair consistency record for 2026-10-13-deepseek-search-thinking.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write docs/persistence-changes/2026-10-13-deepseek-search-thinking.md
+/:
+  en: 3d5a424ae7d7e46b
+  zh: c22a8e4a62d8cc1a
+/2026-10-13-deepseek-search-thinking:
+  en: 033d5d72a19a029b
+  zh: 334111dcdead54d8
+/2026-10-13-deepseek-search-thinking/summary:
+  en: 398b25bff3dd0fd8
+  zh: fef39218a015d80b
+/2026-10-13-deepseek-search-thinking/table-of-contents:
+  en: 6cf314a069ceb451
+  zh: 9adff678e9ecab3b
+/2026-10-13-deepseek-search-thinking/declaration:
+  en: 6907136f28e48c90
+  zh: 02f8298485f3d8e7
+/2026-10-13-deepseek-search-thinking/compatibility:
+  en: 2729e86f71451364
+  zh: af19f76f7fee238b
+/2026-10-13-deepseek-search-thinking/verification:
+  en: ce8adf6d438b6b22
+  zh: 6c4a421051c99dce
+/2026-10-13-deepseek-search-thinking/dev-note:
+  en: b75c8458928b72b9
+  zh: 003ba4e17b4b5269

package/references/official-docs/docs/persistence-changes/2026-10-13-deepseek-search-thinking.md

@@ -0,0 +1,48 @@
+---
+description: "Records a persistence type transition and its compatibility acknowledgement."
+kind: persistence-change
+---
+
+# 2026-10-13-deepseek-search-thinking
+
+English | [中文](2026-10-13-deepseek-search-thinking.zh.md)
+
+## Summary
+
+Adds the optional `thinking` member to the logged DeepSeek search request body, recording that the auxiliary search turn disables thinking.
+
+## Table of Contents
+
+- [Declaration](#declaration)
+- [Compatibility](#compatibility)
+- [Verification](#verification)
+- [Dev Note](#dev-note)
+
+<a id="declaration"></a>
+## Declaration
+
+```yaml persistence-change
+schemaVersion: 1
+id: 2026-10-13-deepseek-search-thinking
+baseline: false
+changes:
+  - root: "event:web/deepseek-search-llm-request"
+    previous: "2026-09-11-initial"
+    after: "0c556c9b9f2a96238a6b9bbb99e748206cbff2ed6203041c9571f04ae5802f52"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## Compatibility
+
+Existing records remain valid: absence means the request omitted the field and DeepSeek applied its default. The event is log-only; no reader replays or interprets the body for behavior, and the provider writes the member on every new request.
+
+<a id="verification"></a>
+## Verification
+
+pnpm exec vitest run packages/web/web-search-deepseek/tests/deepseek.spec.ts: 59 tests passed.
+
+<a id="dev-note"></a>
+## Dev Note
+
+None.