@deepseek-ai/dsh-session-telemetry 0.1.6-alpha.1 → 0.1.7-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-telemetry/README.md
-README.md: ba503adf55409ada47dc89b68ee37029ab0381d6
-README.zh.md: 5e7237ddac46f4eaab2850186153158e3d36b99a
+README.md: c7d76686415ee4874e29ec191d8456c31a3019f4
+README.zh.md: 2e9bc7e6619f30d18660ef2a11ab703b02647aa3

package/README.md

@@ -78,7 +78,7 @@ Live capture registers Session events, flush hints, shutdown markers, and agent/
 
 ### The handoff cursor
 
-A module-scope `WeakMap<Session, seq>` records the highest sequence handed off, not delivered. Re-adopting the same object resumes after that cursor. Capture normally starts at `firstLiveSeq`; explicit `includeHistory: true` starts an unhanded object at seq 0, including restored or fork history. The backend owns capture authorization. Stored history does not itself authorize capture; the OTel backend waits for new explicit feedback. Receivers deduplicate repeated records by `(session.id, session.format_version, event.seq)`.
+A module-scope `WeakMap<Session, seq>` records the highest sequence handed off, not delivered. Re-adopting the same object resumes after that cursor. Capture starts at `firstLifecycleSeq`: a new fork includes its child-owned marker and closers, while a restored Session excludes its stored prefix, including prior child turns; explicit `includeHistory: true` starts an unhanded object at seq 0, including restored or fork history. The backend owns capture authorization. Stored history does not itself authorize capture; the OTel backend waits for new explicit feedback. Receivers deduplicate repeated records by `(session.id, session.format_version, event.seq)`.
 
 </details>
 

package/README.zh.md

@@ -78,7 +78,7 @@ seam 建立在一个边界之上：harness 的职责止于 `emit()`。完整事
 
 ### handoff 游标
 
-模块作用域的 `WeakMap<Session, seq>` 记录已交接而非已投递的最高序号。重新收养同一对象时从该游标之后继续。捕获通常从 `firstLiveSeq` 开始；显式 `includeHistory: true` 从未交接对象的 seq 0 开始，包含恢复或 fork 历史。后端负责捕获授权。存储的历史本身不授权捕获；OTel 后端等待新的显式反馈。接收方按 `(session.id, session.format_version, event.seq)` 对重复记录去重。
+模块级 `WeakMap<Session, seq>` 记录已经移交的最高序号，而不是已送达的最高序号。再次接管同一对象时从该游标之后继续。采集从 `firstLifecycleSeq` 开始：新 fork 包含子会话自有的标记与 fork 结束事件；恢复的 Session 排除已存储前缀，包括先前的子会话轮次。显式 `includeHistory: true` 会让尚未移交的对象从 seq 0 开始，包括恢复或 fork 历史。Backend 负责采集授权；已有存储历史本身不构成授权，OTel backend 等待新的显式反馈。接收方通过 `(session.id, session.format_version, event.seq)` 对重复记录去重。
 
 </details>
 

package/lib/index.js

@@ -111,7 +111,8 @@ var SessionTelemetryCoordinator = class {
 	* @param throughSeq - optional last sequence included in this capture.
 	*/
 	captureSession(session, throughSeq) {
-		const cursor = handoffCursor.get(session) ?? (this.options.includeHistory === true || session.firstLiveSeq === 0 ? -1 : SessionSeq(session.firstLiveSeq - 1));
+		const start = session.firstLifecycleSeq;
+		const cursor = handoffCursor.get(session) ?? (this.options.includeHistory === true || start === 0 ? -1 : SessionSeq(start - 1));
 		for (const event of session.snapshotEvents(SessionLogOffset(cursor + 1))) {
 			if (throughSeq !== void 0 && event.seq > throughSeq) break;
 			this.contain(() => {
@@ -121,9 +122,9 @@ var SessionTelemetryCoordinator = class {
 	}
 	/**
 	* Adopt a session and replay after its handoff cursor, then follow live events.
-	* New objects include inherited and restored history only with includeHistory;
-	* otherwise replay starts at the constructor boundary. Re-adopting the same
-	* object resumes after its cursor.
+	* New fork objects include child-owned seed markers and closers. Restored
+	* objects start after the stored prefix, including restored forks. includeHistory starts either object at seq 0;
+	* re-adopting the same object resumes after its cursor.
 	* @param session - the live session to adopt; a second adoption is a no-op.
 	*/
 	adopt(session) {
@@ -214,7 +215,7 @@ function shutdownRecord(session) {
 /** Map an event's own outcome flag to the pre-baked alerting severity. */
 function severityOf(event) {
 	switch (event.type) {
-		case "tool/result": return event.data.message.content[0].isError === true ? "error" : "info";
+		case "tool/result": return event.data.message.isError === true ? "error" : "info";
 		case "turn/end": return event.data.reason.kind === "error" ? "error" : "info";
 		default: return "info";
 	}

package/lib/types/coordinator.d.ts

@@ -22,7 +22,7 @@ export type SessionTelemetryCapture = 'live' | 'on-demand';
 export interface SessionTelemetryCaptureOptions {
     /** Follow live events, or wait for explicit capture; defaults to live. */
     capture?: SessionTelemetryCapture;
-    /** Include stored history before this lifecycle; defaults to false. */
+    /** Include inherited fork history and stored history from earlier lifecycles; defaults to false. */
     includeHistory?: boolean;
 }
 /**
@@ -69,9 +69,9 @@ export declare class SessionTelemetryCoordinator {
     captureSession(session: Session, throughSeq?: SessionSeqType): void;
     /**
      * Adopt a session and replay after its handoff cursor, then follow live events.
-     * New objects include inherited and restored history only with includeHistory;
-     * otherwise replay starts at the constructor boundary. Re-adopting the same
-     * object resumes after its cursor.
+     * New fork objects include child-owned seed markers and closers. Restored
+     * objects start after the stored prefix, including restored forks. includeHistory starts either object at seq 0;
+     * re-adopting the same object resumes after its cursor.
      * @param session - the live session to adopt; a second adoption is a no-op.
      */
     private adopt;

package/lib/types/index.d.ts

@@ -43,7 +43,7 @@ declare module '@deepseek-ai/cordis' {
 /**
  * Severity of a telemetry record, pre-mapped at capture so a receiver can
  * alert with zero configuration: `error` for events whose own outcome flag
- * says so (the tool-result block's `isError`, `turn/end` error reasons) and for
+ * says so (the tool message's `isError`, `turn/end` error reasons) and for
  * `agent-error` operational records. Captured events otherwise default to
  * `info`; `warn` remains available to `session-telemetry/record` policies and
  * backends.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-telemetry",
   "description": "SessionTelemetryBackend seam for the DeepSeek Harness: session-event capture, projection, redaction, and handoff to a reporting backend",
-  "version": "0.1.6-alpha.1",
+  "version": "0.1.7-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -27,13 +27,13 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-agent": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.3"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-agent": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.3"
   }
 }