@deepseek-ai/dsh-session-stats 0.1.2-rc.1 → 0.1.5-alpha.1

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/session/session-stats/README.md
-README.md: 829c90ed12ea17b1d03be56f94dcb818df66c03a
-README.zh.md: 6ce49ec864644c2cf2d0693daf2574cee771a732
+README.md: 6585b0af7d3385ad6bf9186a3f246f76dadf824e
+README.zh.md: 99652be5dba2a9d34216b4306eae7bd343040d96

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-`dsh-session-stats` serves whole-log conversation figures — turn and step counts plus LLM, tool, first-token, and decode wall times — as the `sessionStats` projection unit. Clients read the figures from the registry's snapshot and change feed, and paging or compaction cannot change them because they fold from the complete durable log. Choose it in compositions that already mount the projection registry, such as the web chat bundle whose stats strip is the reference consumer; assemblies without the registry are unaffected and their consumers fall back to window-scoped counting. Setup and field semantics come first; the fold internals live in a collapsible developer section below.
+This package gives clients whole-session turn and step counts plus LLM, tool, first-token, and decode wall times through the public `sessionStats` value. The figures come from the complete durable log, so paging and compaction do not change them. Use it when a client must display consistent conversation statistics across reloads and reduced history. When whole-session statistics are unavailable, clients can use window-scoped counting instead.
 
 ## Table of Contents
 

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-`dsh-session-stats` 提供全日志会话数字——轮/步计数以及 LLM、工具、首 token、解码墙钟时间——以 `sessionStats` 投影单元的形式对外提供。客户端从注册表的快照与变更流中读取数字，且由于它们从完整持久日志折叠而来，分页或压缩都无法改变它们。在已挂载投影注册表的组合中选择它，例如 Web 聊天包（其统计条是参考消费者）；没有注册表的装配不受影响，其消费者回退到窗口口径计数。设置与字段语义在前；折叠内部细节放在下方可折叠的开发者章节中。
+本包通过公开的 `sessionStats` 值，为客户端提供全会话轮次与步骤计数，以及 LLM、工具、首 token 和解码墙钟时间。这些数字来自完整的持久日志，因此分页与压缩不会改变它们。当客户端必须在重新加载或缩减历史记录后显示一致的会话统计时，请使用本包。全会话统计不可用时，客户端可改用窗口口径计数。
 
 ## 目录
 

package/lib/index.js

@@ -1,8 +1,9 @@
 import { z } from "zod";
+import { assistantStreamFirstTokenTime } from "@deepseek-ai/dsh-llm";
 //#region lib/types/projection.js
 /**
 * The `sessionStats` projection unit: a pure fold of step boundaries, stream
-* chunks, tool pairs, and assembled assistant messages into whole-log counts
+* embedded streams, tool pairs, and assembled assistant messages into whole-log counts
 * and wall times.
 *
 * `step/end` — not `assistant/message` — is the counted step event because it
@@ -24,15 +25,6 @@ import { z } from "zod";
 *
 * @module @deepseek-ai/dsh-session-stats/projection
 */
-/** Whether a stream chunk carries a non-empty first-token delta. */
-function isTokenDelta(chunk) {
-	switch (chunk.type) {
-		case "text-delta":
-		case "reasoning-delta": return chunk.text !== "";
-		case "tool-call-delta": return chunk.argumentsDelta !== "" || chunk.name !== void 0;
-		default: return false;
-	}
-}
 const sessionStatsSchema = z.object({
 	turns: z.number().int().nonnegative(),
 	steps: z.number().int().nonnegative(),
@@ -99,32 +91,34 @@ const sessionStatsProjectionDefinition = {
 					firstTokenTime: null
 				}
 			};
-			case "assistant/chunk": {
+			case "assistant/attempt": {
 				const open = state.openStep;
 				if (open === null || open.turn !== event.data.turn || open.step !== event.data.step) return state;
-				if (open.firstTokenTime !== null || !isTokenDelta(event.data.chunk)) return state;
+				const first = assistantStreamFirstTokenTime(event.data.stream) ?? null;
+				if (open.firstTokenTime !== null || first === null) return state;
 				return {
 					...state,
 					openStep: {
 						...open,
-						firstTokenTime: event.time
+						firstTokenTime: first
 					}
 				};
 			}
 			case "assistant/message": {
 				const open = state.openStep;
 				if (open === null || open.turn !== event.data.turn || open.step !== event.data.step) return state;
+				const firstToken = open.firstTokenTime ?? assistantStreamFirstTokenTime(event.data.stream) ?? null;
 				const next = {
 					...state,
 					llmMs: state.llmMs + Math.max(0, event.time - open.startTime),
 					openStep: null
 				};
-				if (open.firstTokenTime !== null) {
-					next.ttftMs += Math.max(0, open.firstTokenTime - open.startTime);
+				if (firstToken !== null) {
+					next.ttftMs += Math.max(0, firstToken - open.startTime);
 					next.ttftSteps += 1;
 					const outputTokens = usageOutputTokens(event.data.usage);
 					if (outputTokens !== null) {
-						next.decodeMs += Math.max(0, event.time - open.firstTokenTime);
+						next.decodeMs += Math.max(0, event.time - firstToken);
 						next.decodeTokens += outputTokens;
 					}
 				}

package/lib/types/projection.d.ts

@@ -1,6 +1,6 @@
 /**
  * The `sessionStats` projection unit: a pure fold of step boundaries, stream
- * chunks, tool pairs, and assembled assistant messages into whole-log counts
+ * embedded streams, tool pairs, and assembled assistant messages into whole-log counts
  * and wall times.
  *
  * `step/end` — not `assistant/message` — is the counted step event because it

package/lib/types/projection.js

@@ -1,6 +1,6 @@
 /**
  * The `sessionStats` projection unit: a pure fold of step boundaries, stream
- * chunks, tool pairs, and assembled assistant messages into whole-log counts
+ * embedded streams, tool pairs, and assembled assistant messages into whole-log counts
  * and wall times.
  *
  * `step/end` — not `assistant/message` — is the counted step event because it
@@ -23,19 +23,7 @@
  * @module @deepseek-ai/dsh-session-stats/projection
  */
 import { z } from 'zod';
-/* jscpd:ignore-start -- Session Stats owns its whole-log timing projection independently. */
-/** Whether a stream chunk carries a non-empty first-token delta. */
-function isTokenDelta(chunk) {
-    switch (chunk.type) {
-        case 'text-delta':
-        case 'reasoning-delta':
-            return chunk.text !== '';
-        case 'tool-call-delta':
-            return chunk.argumentsDelta !== '' || chunk.name !== undefined;
-        default:
-            return false;
-    }
-}
+import { assistantStreamFirstTokenTime } from '@deepseek-ai/dsh-llm';
 const sessionStatsSchema = z.object({
     turns: z.number().int().nonnegative(),
     steps: z.number().int().nonnegative(),
@@ -100,18 +88,20 @@ export const sessionStatsProjectionDefinition = {
                     ...state,
                     openStep: { turn: event.data.turn, step: event.data.step, startTime: event.time, firstTokenTime: null },
                 };
-            case 'assistant/chunk': {
+            case 'assistant/attempt': {
                 const open = state.openStep;
                 if (open === null || open.turn !== event.data.turn || open.step !== event.data.step)
                     return state;
-                if (open.firstTokenTime !== null || !isTokenDelta(event.data.chunk))
+                const first = assistantStreamFirstTokenTime(event.data.stream) ?? null;
+                if (open.firstTokenTime !== null || first === null)
                     return state;
-                return { ...state, openStep: { ...open, firstTokenTime: event.time } };
+                return { ...state, openStep: { ...open, firstTokenTime: first } };
             }
             case 'assistant/message': {
                 const open = state.openStep;
                 if (open === null || open.turn !== event.data.turn || open.step !== event.data.step)
                     return state;
+                const firstToken = open.firstTokenTime ?? assistantStreamFirstTokenTime(event.data.stream) ?? null;
                 // One assembled message per step: closing the boundary means a
                 // defensive duplicate cannot accrue twice.
                 const next = {
@@ -119,12 +109,12 @@ export const sessionStatsProjectionDefinition = {
                     llmMs: state.llmMs + Math.max(0, event.time - open.startTime),
                     openStep: null,
                 };
-                if (open.firstTokenTime !== null) {
-                    next.ttftMs += Math.max(0, open.firstTokenTime - open.startTime);
+                if (firstToken !== null) {
+                    next.ttftMs += Math.max(0, firstToken - open.startTime);
                     next.ttftSteps += 1;
                     const outputTokens = usageOutputTokens(event.data.usage);
                     if (outputTokens !== null) {
-                        next.decodeMs += Math.max(0, event.time - open.firstTokenTime);
+                        next.decodeMs += Math.max(0, event.time - firstToken);
                         next.decodeTokens += outputTokens;
                     }
                 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-stats",
   "description": "Whole-log conversation counts and wall times projection (sessionStats) for the DeepSeek Harness",
-  "version": "0.1.2-rc.1",
+  "version": "0.1.5-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -36,20 +36,20 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session-projection": "^0.1.2-rc.1",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1"
   },
   "dependencies": {
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",
-    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session-projection": "^0.1.2-rc.1",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.3"
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.2"
   }
 }