dsh-primer 0.4.4 → 0.4.6

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

@@ -1,231 +1,28 @@
 {
   "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"
-          }
-        ]
-      }
-    }
+    {"key":"event:web/deepseek-search-llm-request","kind":"event","event":"web/deepseek-search-llm-request","surface":false,"digest":"0c556c9b9f2a96238a6b9bbb99e748206cbff2ed6203041c9571f04ae5802f52"}
   ],
-  "types": []
+  "types": [],
+  "nodes": {
+    "0116b1f89c05221d": {"kind":"literal","value":"web_search_20250305"},
+    "0657d3ca5ac4e7bf": {"kind":"primitive","type":"number"},
+    "0b9b8facbe2c1977": {"kind":"literal","value":"disabled"},
+    "0c556c9b9f2a9623": {"kind":"object","properties":[{"name":"data","type":"abd6ca62a5ab1665","optional":false},{"name":"ignorable","type":"dacf3d5f3e4ff619","optional":true},{"name":"seq","type":"0657d3ca5ac4e7bf","optional":false},{"name":"time","type":"0657d3ca5ac4e7bf","optional":false},{"name":"type","type":"6f611bed14b21065","optional":false}],"indices":[]},
+    "2d11ca7b0d4493e2": {"kind":"object","properties":[{"name":"max_uses","type":"0657d3ca5ac4e7bf","optional":false},{"name":"name","type":"935c8d486292b13c","optional":false},{"name":"type","type":"0116b1f89c05221d","optional":false}],"indices":[]},
+    "37ff65426bcf130f": {"kind":"object","properties":[{"name":"type","type":"0b9b8facbe2c1977","optional":false}],"indices":[]},
+    "4aed17ec726b5397": {"kind":"tuple","elements":[{"type":"2d11ca7b0d4493e2","optional":false,"rest":false}]},
+    "4cd48f3e5108bd6e": {"kind":"primitive","type":"string"},
+    "4e44c9118152f682": {"kind":"literal","value":"text"},
+    "4e88776858652856": {"kind":"object","properties":[{"name":"text","type":"4cd48f3e5108bd6e","optional":false},{"name":"type","type":"4e44c9118152f682","optional":false}],"indices":[]},
+    "68f44f59e91c4139": {"kind":"literal","value":"user"},
+    "6f611bed14b21065": {"kind":"literal","value":"web/deepseek-search-llm-request"},
+    "8f6d609794bf5afc": {"kind":"tuple","elements":[{"type":"4e88776858652856","optional":false,"rest":false}]},
+    "935c8d486292b13c": {"kind":"literal","value":"web_search"},
+    "9a2a9029f8d7ede0": {"kind":"object","properties":[{"name":"content","type":"8f6d609794bf5afc","optional":false},{"name":"role","type":"68f44f59e91c4139","optional":false}],"indices":[]},
+    "9c001ecb5e1d3c38": {"kind":"object","properties":[{"name":"max_tokens","type":"0657d3ca5ac4e7bf","optional":false},{"name":"messages","type":"b993441f8ce7d27b","optional":false},{"name":"model","type":"4cd48f3e5108bd6e","optional":false},{"name":"thinking","type":"37ff65426bcf130f","optional":true},{"name":"tools","type":"4aed17ec726b5397","optional":false}],"indices":[]},
+    "abd6ca62a5ab1665": {"kind":"object","properties":[{"name":"apiVersion","type":"4cd48f3e5108bd6e","optional":false},{"name":"body","type":"9c001ecb5e1d3c38","optional":false},{"name":"endpoint","type":"4cd48f3e5108bd6e","optional":false}],"indices":[]},
+    "b993441f8ce7d27b": {"kind":"tuple","elements":[{"type":"9a2a9029f8d7ede0","optional":false,"rest":false}]},
+    "dacf3d5f3e4ff619": {"kind":"literal","value":true}
+  }
 }

package/references/official-docs/docs/persistence-changes/2026-10-13-liveshare-share-viewer-principal.i18n.yaml

@@ -0,0 +1,28 @@
+# Bilingual-pair consistency record for 2026-10-13-liveshare-share-viewer-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-liveshare-share-viewer-principal.md
+/:
+  en: 3d5a424ae7d7e46b
+  zh: c22a8e4a62d8cc1a
+/2026-10-13-liveshare-share-viewer-principal:
+  en: 9b8097ab5922733e
+  zh: e52f33004c75f18f
+/2026-10-13-liveshare-share-viewer-principal/summary:
+  en: 32551ff4ee358694
+  zh: f6cfc403bed4f780
+/2026-10-13-liveshare-share-viewer-principal/table-of-contents:
+  en: 6cf314a069ceb451
+  zh: 9adff678e9ecab3b
+/2026-10-13-liveshare-share-viewer-principal/declaration:
+  en: 6907136f28e48c90
+  zh: 02f8298485f3d8e7
+/2026-10-13-liveshare-share-viewer-principal/compatibility:
+  en: 3c4faef3cc5010bb
+  zh: 051485cd767ec6bc
+/2026-10-13-liveshare-share-viewer-principal/verification:
+  en: 427079a2393d0ffe
+  zh: 17249b4e0fc0faeb
+/2026-10-13-liveshare-share-viewer-principal/dev-note:
+  en: b75c8458928b72b9
+  zh: 003ba4e17b4b5269

package/references/official-docs/docs/persistence-changes/2026-10-13-liveshare-share-viewer-principal.md

@@ -0,0 +1,60 @@
+---
+description: "Records a persistence type transition and its compatibility acknowledgement."
+kind: persistence-change
+---
+
+# 2026-10-13-liveshare-share-viewer-principal
+
+English | [中文](2026-10-13-liveshare-share-viewer-principal.zh.md)
+
+## Summary
+
+Adds the LiveShare share-viewer principal, including the Relay-asserted display name when available, to the user-rpc message source of prompts a share reader submits.
+
+## 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-liveshare-share-viewer-principal
+baseline: false
+changes:
+  - root: "event:agent/inbox/spliced"
+    previous: "2026-10-25-skill-catalog-incomplete"
+    after: "cdf988172b589b230f2bce868489def1bb575eb0501076ac757a8f369ac5c64e"
+    decision: same-version
+  - root: "event:developer/message"
+    previous: "2026-10-25-skill-catalog-incomplete"
+    after: "70d2acdec1ebcfea56d02f7233ebb9ec0f7f494447fb952884c22c3afdc01d6f"
+    decision: same-version
+  - root: "event:session/title-llm-request"
+    previous: "2026-10-25-skill-catalog-incomplete"
+    after: "2e505098f9209e52eebd577f1a6f9d4e773ec4d78987aff28a7c786442b9f54c"
+    decision: same-version
+  - root: "event:user/message"
+    previous: "2026-10-25-skill-catalog-incomplete"
+    after: "5bb231bc5afdb532a6898a20604e76bf0c1db438bfcdc17d4847dceaddc02451"
+    decision: same-version
+```
+
+<a id="compatibility"></a>
+## Compatibility
+
+The share-viewer variant is written only for a prompt that a LiveShare share reader's Peer submits; owner prompts still omit principal, so their sources and every existing Session log are unchanged. The value carries the share id and the Relay-asserted provider, tenant, and subject ids. It also carries an optional display name when the Relay asserts one, for attribution only; credentials and avatars are never persisted, and authorization still uses the identity triple. Readers that do not know the optional field keep showing the durable subject id. The LiveShare host consumes it in two places: the `agent/pre-step` admission check re-reads the Relay's grant for every entering message whose principal is a share viewer, and rejects the step when that grant no longer holds; the same step records, in memory for that turn only, that the running turn was viewer-started, which confines that turn to the shared tool surface and leaves an owner-started turn on the Session's native tools. That marker is never appended to the Session log and is recomputed from the next admitted step. A build without LiveShare keeps the message an ordinary user message because the kind stays 'user', and a principal kind this package does not drive is left to whoever drives it. A current reader of an older log finds no share-viewer principal and admits those prompts as ordinary input, as before. The field is not part of any model request. SESSION_FORMAT_VERSION does not change.
+
+<a id="verification"></a>
+## Verification
+
+pnpm exec vitest run packages/experimental/liveshare/tests/relay-target-admission.host.spec.ts packages/experimental/liveshare/tests/relay-pre-step-admission.host.spec.ts packages/experimental/liveshare/tests/share-host-listeners.spec.ts packages/experimental/liveshare packages/experimental/liveshare-protocol: a share reader's prompt persists source.principal in agent/inbox/spliced, recovered reader input is refused at the `agent/pre-step` admission check, an admitted one enters the model, and a principal this package does not drive is left alone; the optional displayName is persisted for attribution, accepted only as a non-empty string, and missing or malformed values fall back to the subject id; 35 tests passed plus the two-package LiveShare and protocol suites.
+
+<a id="dev-note"></a>
+## Dev Note
+
+None.