@deepseek-ai/dsh-client-connection 0.1.2-alpha.3 → 0.1.2-alpha.4

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/connection/README.md
-README.md: ee0566bf811a0bad32f7d59b4c8849e26efea613
-README.zh.md: 48425a428247b7749bf0dd75f592b5f7e4088ef2
+README.md: 54acac0ed815ea24a4a30a80d0b13eb6ceda6b47
+README.zh.md: 46c7d0b20e3b7a27db963866949d01f1ee96781a

package/README.md

@@ -72,3 +72,5 @@ None; this package neither assembles nor sends a provider request.
 None.
 
 </details>
+
+**Runtime invariant:** No companion is published. Browser-session verification reads the credential record asynchronously at the request that authorizes work, while the credentials companion owns record commit-event lifetime. Stream/reconnect sequencing and rpcId round-trip discipline are exercised directly by behavior specs, and route register/dispose symmetry is audited by the webserver companion.

package/README.zh.md

@@ -72,3 +72,5 @@ API Gateway Client 把内部 `$events` logical stream 注册为唯一 generation
 无。
 
 </details>
+
+**运行时不变式：** 不发布伴生入口。授权请求会异步读取 credential 权威记录，commit-event 生命周期由 credentials 伴生入口负责；流、重连、rpcId 与路由释放关系由行为测试及 webserver 不变式覆盖。

package/lib/client.js

@@ -269,14 +269,14 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region ../../util/brand/lib/index.js
 		/**
-		* Duplicate-install-safe nominal string helpers.
+		* Duplicate-install-safe nominal primitive helpers.
 		*
-		* A brand makes structurally-identical strings non-interchangeable at the type
-		* level: a `SessionId` cannot be passed where a `ToolCallId` is expected, even
-		* though both are plain strings at runtime. Comparison, logging, and
-		* serialization all behave as ordinary strings.
+		* A brand makes structurally identical strings or numbers non-interchangeable
+		* at the type level: a `SessionId` cannot be passed where a `ToolCallId` is
+		* expected, and an event sequence cannot be passed as a log offset. Comparison,
+		* logging, and serialization retain the underlying primitive behavior.
 		*
-		* This package owns no concrete id and keeps no runtime identity or mutable
+		* This package owns no concrete domain value and keeps no runtime identity or mutable
 		* state, so independently installed copies produce interchangeable values.
 		*
 		* @module @deepseek-ai/dsh-brand
@@ -289,6 +289,14 @@ window.__ModuleLoader__.load({
 		function brandString(value) {
 			return value;
 		}
+		/**
+		* Apply a compile-time number brand without changing the value.
+		* @param value - number admitted by the domain that owns the target brand.
+		* @returns the same number with the requested compile-time brand.
+		*/
+		function brandNumber(value) {
+			return value;
+		}
 		//#endregion
 		//#region ../../util/values/lib/index.js
 		/**
@@ -401,6 +409,26 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region ../../core/session/lib/types/types.js
+		/**
+		* Admit a numeric value as an existing Session event position.
+		* @param value - non-negative safe integer admitted by the owning log operation.
+		* @returns the same number with the Session-sequence brand.
+		*/
+		function SessionSeq(value) {
+			if (!Number.isSafeInteger(value) || value < 0 || Object.is(value, -0)) throw new TypeError(`SessionSeq must be a non-negative safe integer, got ${String(value)}`);
+			return brandNumber(value);
+		}
+		/**
+		* Admit a numeric value as a Session log offset.
+		* @param value - non-negative safe integer used as a gap or prefix length.
+		* @returns the same number with the Session-log-offset brand.
+		*/
+		function SessionLogOffset(value) {
+			if (!Number.isSafeInteger(value) || value < 0 || Object.is(value, -0)) throw new TypeError(`SessionLogOffset must be a non-negative safe integer, got ${String(value)}`);
+			return brandNumber(value);
+		}
+		//#endregion
 		//#region ../../core/session/lib/types/chunk-rows.js
 		/**
 		* Lossless row packing for `assistant/chunk` delta runs. Providers stream
@@ -411,7 +439,7 @@ window.__ModuleLoader__.load({
 		* `tool-call-chunks` — and expands rows back to the exact original events.
 		*
 		* Packed rows are an encoding vocabulary, NOT session events: they never enter
-		* `Session.events`, have no `SessionEventMap` entry, and use bare (slash-less)
+		* `Session.snapshotEvents()`, have no `SessionEventMap` entry, and use bare (slash-less)
 		* type tags so a reader cannot confuse them with the event taxonomy
 		* (precedent: the JSONL header line's `session` tag). Persistence and bounded
 		* history transport both use the codec. The encoder whitelists exact shapes —
@@ -459,7 +487,7 @@ window.__ModuleLoader__.load({
 				"time",
 				"data"
 			])) return void 0;
-			if (!Number.isSafeInteger(event.seq) || event.seq < 0 || !Number.isSafeInteger(event.time)) return void 0;
+			if (!Number.isSafeInteger(event.seq) || event.seq < 0 || Object.is(event.seq, -0) || !Number.isSafeInteger(event.time)) return void 0;
 			const data = event.data;
 			if (!isRecord$1(data) || !hasExactKeys(data, [
 				"turn",
@@ -647,7 +675,7 @@ window.__ModuleLoader__.load({
 		}
 		/** Whether a runtime value is a non-negative safe event sequence. */
 		function isEventSeq(value) {
-			return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+			return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 && !Object.is(value, -0);
 		}
 		/** Whether a runtime value is the exact positional-replacement shape. */
 		function isReplaceOp(value) {
@@ -798,7 +826,7 @@ window.__ModuleLoader__.load({
 			const state = createFoldState();
 			const replacements = [];
 			for (const [index, event] of events.entries()) {
-				const replacement = applySurfaceEvent(state, event, index, events, 0);
+				const replacement = applySurfaceEvent(state, event, SessionSeq(index), events, SessionLogOffset(0));
 				if (replacement !== void 0) replacements.push(replacement);
 			}
 			return {
@@ -2628,7 +2656,7 @@ window.__ModuleLoader__.load({
 			const append = (id, e) => {
 				const log = logOf(id);
 				const event = {
-					seq: log.length,
+					seq: SessionSeq(log.length),
 					time: Date.now(),
 					...e
 				};
@@ -3563,7 +3591,7 @@ window.__ModuleLoader__.load({
 					log.push({
 						type: "user/message",
 						surfaceOp: "append",
-						seq: log.length,
+						seq: SessionSeq(log.length),
 						time: Date.now(),
 						data: userMessage(text(msg))
 					});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-connection",
   "description": "Authenticated RPC transport, generation lifecycle, and browser fixture",
-  "version": "0.1.2-alpha.3",
+  "version": "0.1.2-alpha.4",
   "publishConfig": {
     "access": "public"
   },
@@ -18,10 +18,6 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./client": {
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
@@ -39,12 +35,11 @@
   "license": "MIT",
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-credentials": "^0.1.2-alpha.4",
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/client.js",
     "lib/types/**/*.d.ts"
   ],
@@ -53,16 +48,15 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-commands": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-host-directory-picker": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-tool-todo": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-util-values": "^0.1.2-alpha.3"
+    "@deepseek-ai/dsh-attachment": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-commands": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-host-directory-picker": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-tool-todo": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-util-values": "^0.1.2-alpha.4"
   }
 }

package/lib/invariant.js

@@ -1,27 +0,0 @@
-//#region lib/types/invariant.js
-/**
-* Package-owned invariant companion for `@deepseek-ai/dsh-client-connection`.
-* @module @deepseek-ai/dsh-client-connection/invariant
-*/
-const PACKAGE_NAME = "@deepseek-ai/dsh-client-connection";
-/** Cordis companion plugin name. */
-const name = "client-connection-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: browser-session verification reads the credential
-* record asynchronously at the request that authorizes work, while the
-* credentials companion owns record commit-event lifetime. Stream/reconnect
-* sequencing and rpcId round-trip discipline are exercised directly by
-* behavior specs, and route register/dispose symmetry is
-* audited by the webserver companion.
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@deepseek-ai/dsh-client-connection`.
- * @module @deepseek-ai/dsh-client-connection/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "client-connection-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map