dsh-plugin-guide 0.3.33 → 0.3.36

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

@@ -0,0 +1,231 @@
+{
+  "formatVersion": 2,
+  "roots": [
+    {
+      "key": "event:web/deepseek-search-llm-request",
+      "kind": "event",
+      "event": "web/deepseek-search-llm-request",
+      "surface": false,
+      "digest": "0c556c9b9f2a96238a6b9bbb99e748206cbff2ed6203041c9571f04ae5802f52",
+      "schema": {
+        "root": 0,
+        "nodes": [
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "data",
+                "type": 1,
+                "optional": false
+              },
+              {
+                "name": "ignorable",
+                "type": 17,
+                "optional": true
+              },
+              {
+                "name": "seq",
+                "type": 4,
+                "optional": false
+              },
+              {
+                "name": "time",
+                "type": 4,
+                "optional": false
+              },
+              {
+                "name": "type",
+                "type": 18,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "apiVersion",
+                "type": 2,
+                "optional": false
+              },
+              {
+                "name": "body",
+                "type": 3,
+                "optional": false
+              },
+              {
+                "name": "endpoint",
+                "type": 2,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "primitive",
+            "type": "string"
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "max_tokens",
+                "type": 4,
+                "optional": false
+              },
+              {
+                "name": "messages",
+                "type": 5,
+                "optional": false
+              },
+              {
+                "name": "model",
+                "type": 2,
+                "optional": false
+              },
+              {
+                "name": "thinking",
+                "type": 11,
+                "optional": true
+              },
+              {
+                "name": "tools",
+                "type": 13,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "primitive",
+            "type": "number"
+          },
+          {
+            "kind": "tuple",
+            "elements": [
+              {
+                "type": 6,
+                "optional": false,
+                "rest": false
+              }
+            ]
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "content",
+                "type": 7,
+                "optional": false
+              },
+              {
+                "name": "role",
+                "type": 10,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "tuple",
+            "elements": [
+              {
+                "type": 8,
+                "optional": false,
+                "rest": false
+              }
+            ]
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "text",
+                "type": 2,
+                "optional": false
+              },
+              {
+                "name": "type",
+                "type": 9,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "literal",
+            "value": "text"
+          },
+          {
+            "kind": "literal",
+            "value": "user"
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "type",
+                "type": 12,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "literal",
+            "value": "disabled"
+          },
+          {
+            "kind": "tuple",
+            "elements": [
+              {
+                "type": 14,
+                "optional": false,
+                "rest": false
+              }
+            ]
+          },
+          {
+            "kind": "object",
+            "properties": [
+              {
+                "name": "max_uses",
+                "type": 4,
+                "optional": false
+              },
+              {
+                "name": "name",
+                "type": 15,
+                "optional": false
+              },
+              {
+                "name": "type",
+                "type": 16,
+                "optional": false
+              }
+            ],
+            "indices": []
+          },
+          {
+            "kind": "literal",
+            "value": "web_search"
+          },
+          {
+            "kind": "literal",
+            "value": "web_search_20250305"
+          },
+          {
+            "kind": "literal",
+            "value": true
+          },
+          {
+            "kind": "literal",
+            "value": "web/deepseek-search-llm-request"
+          }
+        ]
+      }
+    }
+  ],
+  "types": []
+}

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

@@ -0,0 +1,48 @@
+---
+description: "记录持久化类型更改及其兼容性确认。"
+kind: persistence-change
+---
+
+# 2026-10-13-deepseek-search-thinking
+
+[English](2026-10-13-deepseek-search-thinking.md) | 中文
+
+## 概述
+
+为记录的 DeepSeek 搜索请求体新增可选成员 `thinking`，记录辅助搜索回合关闭了思考模式。
+
+## 目录
+
+- [声明](#declaration)
+- [兼容性](#compatibility)
+- [验证](#verification)
+- [开发备注](#dev-note)
+
+<a id="declaration"></a>
+## 声明
+
+```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>
+## 兼容性
+
+已有记录仍然有效：缺失表示请求省略了该字段，由 DeepSeek 使用默认值。该事件仅用于日志；没有读取方为行为回放或解释请求体，提供方在每个新请求中写入该成员。
+
+<a id="verification"></a>
+## 验证
+
+pnpm exec vitest run packages/web/web-search-deepseek/tests/deepseek.spec.ts：59 个测试通过。
+
+<a id="dev-note"></a>
+## 开发备注
+
+无。

package/references/official-docs/docs/persistence-changes/2026-10-13-user-rpc-principal.i18n.yaml

@@ -0,0 +1,28 @@
+# Bilingual-pair consistency record for 2026-10-13-user-rpc-principal.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-user-rpc-principal.md
+/:
+  en: 3d5a424ae7d7e46b
+  zh: c22a8e4a62d8cc1a
+/2026-10-13-user-rpc-principal:
+  en: c8b8c9fe1f1fb295
+  zh: 6775ad8687023eb9
+/2026-10-13-user-rpc-principal/summary:
+  en: 9fd17b8ef1f569d2
+  zh: d1e9679296ce47a0
+/2026-10-13-user-rpc-principal/table-of-contents:
+  en: 6cf314a069ceb451
+  zh: 9adff678e9ecab3b
+/2026-10-13-user-rpc-principal/declaration:
+  en: 6907136f28e48c90
+  zh: 02f8298485f3d8e7
+/2026-10-13-user-rpc-principal/compatibility:
+  en: ae44b935893f7eaa
+  zh: 686893a2a812570d
+/2026-10-13-user-rpc-principal/verification:
+  en: 53e8380b9c0c63a9
+  zh: 3adac787e267570d
+/2026-10-13-user-rpc-principal/dev-note:
+  en: b75c8458928b72b9
+  zh: 003ba4e17b4b5269

package/references/official-docs/docs/persistence-changes/2026-10-13-user-rpc-principal.md

@@ -0,0 +1,60 @@
+---
+description: "Records a persistence type transition and its compatibility acknowledgement."
+kind: persistence-change
+---
+
+# 2026-10-13-user-rpc-principal
+
+English | [中文](2026-10-13-user-rpc-principal.zh.md)
+
+## Summary
+
+Adds an optional principal to the user-rpc message source for prompts submitted by a caller other than the owner.
+
+## 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-user-rpc-principal
+baseline: false
+changes:
+  - root: "event:agent/inbox/spliced"
+    previous: "2026-10-05-working-directory-attribution"
+    after: "0755b7d1128319ba2e389619cbbf2c961ad648882b4e91da7f3e9582cc8a2034"
+    decision: same-version
+  - root: "event:developer/message"
+    previous: "2026-10-05-working-directory-attribution"
+    after: "97e0162f983c27456ec71269fb4976b1851588b8c1aeac5d071d43e11f95e03c"
+    decision: same-version
+  - root: "event:session/title-llm-request"
+    previous: "2026-10-07-title-reasoning-effort"
+    after: "79a4c87f8bfb4d6d05cd9952b99210d6a7db3b478c4a01d94b4c50602308c056"
+    decision: same-version
+  - root: "event:user/message"
+    previous: "2026-10-05-working-directory-attribution"
+    after: "2ae8594a998c9862a597129e782277bcc518266712a703b5c3161bdf552d13b8"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## Compatibility
+
+Owner prompts omit the field, so their sources and every existing Session log are unchanged; an absent principal means the owner. A reader that predates the field ignores it and treats the message as an ordinary user message, because the kind stays 'user'. A current reader of an older log finds no principal and treats every message as the owner's. The field is not part of any model request: provider adapters read only the model-visible message content. SESSION_FORMAT_VERSION does not change.
+
+<a id="verification"></a>
+## Verification
+
+pnpm exec vitest run packages/api/session-controller/tests/remote-access.host.spec.ts packages/subagent/subagent/tests/control.spec.ts packages/api/session-controller/tests/session-cold.host.spec.ts: non-owner prompts persist source.principal in agent/inbox/spliced, owner and existing time-zone sources stay byte-identical; all tests passed.
+
+<a id="dev-note"></a>
+## Dev Note
+
+None.