@deepseek-ai/dsh-session-turn-outline 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/session/session-turn-outline/README.md
-README.md: e02345d01ed4d31a3e20fd3e28d5b90d451618bb
-README.zh.md: d60e70e4b6f72da076f8fca6c9942815448f92e4
+README.md: 55d99579368d8db1e8cd2c0a571b44739e6006c4
+README.zh.md: 80e4436729b3f9943052e750ab441eeb404ddc4c

package/README.md

@@ -71,6 +71,7 @@ The unit is a pure fold over committed session events. `turn/start` — not the
 | [`src/index.ts`](src/index.ts) | Plugin entry: `inject`, unit registration on the mounting fiber |
 | [`src/projection.ts`](src/projection.ts) | The fold: entry append, preview fill, wire view |
 | [`src/types.ts`](src/types.ts) | One home of the `turnOutline` projection-key declaration and entry types |
+| — | No runtime invariant companion is published: the package owns one pure projection fold, `session-projection` schema-validates its served values, and re-folding the same log would duplicate the implementation instead of comparing independently maintained observations; session and agent-loop own turn-boundary ordering. |
 
 ### Fold rules
 

package/README.zh.md

@@ -71,6 +71,7 @@ wire 值是按 `turn` 严格递增的完整条目数组（整值规则）：消
 | [`src/index.ts`](src/index.ts) | 插件入口：`inject`、在挂载 fiber 上注册单元 |
 | [`src/projection.ts`](src/projection.ts) | 折叠：条目追加、预览填充、wire 视图 |
 | [`src/types.ts`](src/types.ts) | `turnOutline` 投影键声明与条目类型的唯一归属 |
+| — | 不发布运行时不变式伴生入口：本包仅拥有一个纯投影折叠，`session-projection` 会对其对外值执行 schema 校验；用同一实现重新折叠同一日志只会复制实现，无法比较独立维护的观测，而轮次边界顺序由 session 与 agent-loop 负责。 |
 
 ### 折叠规则
 

package/lib/index.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { SessionSeq } from "@deepseek-ai/dsh-session";
 //#region lib/types/projection.js
 /**
 * The `turnOutline` projection unit: a pure fold of `turn/start` boundaries,
@@ -48,7 +49,7 @@ function preview(content, limit) {
 }
 const turnOutlineEntriesSchema = z.array(z.object({
 	turn: z.number().int().nonnegative(),
-	seq: z.number().int().nonnegative(),
+	seq: z.number().int().nonnegative().transform(SessionSeq),
 	prompt: z.string().max(PROMPT_PREVIEW_LIMIT),
 	response: z.string().max(RESPONSE_PREVIEW_LIMIT)
 }).strict()).superRefine((turns, context) => {

package/lib/types/projection.d.ts

@@ -19,7 +19,7 @@
  * @module @deepseek-ai/dsh-session-turn-outline/projection
  */
 import { z } from 'zod';
-import type { SessionEvent } from '@deepseek-ai/dsh-session';
+import { type SessionEvent } from '@deepseek-ai/dsh-session';
 import type { TurnOutlineEntry, TurnOutlineState } from './types.ts';
 /** The `turnOutline` unit registered on `ctx.sessionProjections` (exported for the unit spec). */
 export declare const turnOutlineProjectionDefinition: {

package/lib/types/projection.js

@@ -19,6 +19,7 @@
  * @module @deepseek-ai/dsh-session-turn-outline/projection
  */
 import { z } from 'zod';
+import { SessionSeq } from '@deepseek-ai/dsh-session';
 /** Prompt budget: one rail-card line (13px over ~276px), ASCII worst case included. */
 const PROMPT_PREVIEW_LIMIT = 50;
 /** Response budget: three rail-card lines (12px over ~276px). */
@@ -52,7 +53,7 @@ function preview(content, limit) {
 }
 const turnOutlineEntriesSchema = z.array(z.object({
     turn: z.number().int().nonnegative(),
-    seq: z.number().int().nonnegative(),
+    seq: z.number().int().nonnegative().transform(SessionSeq),
     prompt: z.string().max(PROMPT_PREVIEW_LIMIT),
     response: z.string().max(RESPONSE_PREVIEW_LIMIT),
 }).strict()).superRefine((turns, context) => {

package/lib/types/types.d.ts

@@ -6,13 +6,14 @@
  *
  * @module @deepseek-ai/dsh-session-turn-outline/types
  */
+import type { SessionSeq } from '@deepseek-ai/dsh-session/types';
 export {};
 /** One started turn's outline facts, independent of what a client has paged in. */
 export interface TurnOutlineEntry {
     /** Host-assigned turn number (the `turn/start` payload). */
     readonly turn: number;
     /** The turn's `turn/start` event seq — paging a window back through this seq loads the whole turn. */
-    readonly seq: number;
+    readonly seq: SessionSeq;
     /** Bounded first-human-prompt preview (one rail-card line); `''` until an eligible prompt lands. */
     readonly prompt: string;
     /** Bounded final-response preview (up to three rail-card lines); `''` until the turn ends with assistant text. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-turn-outline",
   "description": "Whole-log turn outline projection (turnOutline) for the DeepSeek Harness",
-  "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"
-    },
     "./types": {
       "types": "./lib/types/types.d.ts",
       "default": "./lib/types/types.js"
@@ -35,28 +31,25 @@
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/types/**/*.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.3"
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.4"
   },
   "dependencies": {
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
     "@deepseek-ai/cordis-plugin-include": "^1.0.7",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.3",
+    "@deepseek-ai/cordis": "^4.0.2",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3"
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.4",
+    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.4"
   }
 }

package/lib/invariant.js

@@ -1,28 +0,0 @@
-//#region lib/types/invariant.js
-/**
-* Package-owned invariant companion for `@deepseek-ai/dsh-session-turn-outline`.
-* @module @deepseek-ai/dsh-session-turn-outline/invariant
-*/
-const PACKAGE_NAME = "@deepseek-ai/dsh-session-turn-outline";
-/** Cordis companion plugin name. */
-const name = "session-turn-outline-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: the package owns a single pure projection fold whose
-* wire payload is schema-validated by the projection registry at every
-* snapshot and change-feed emission (including the strictly-increasing turn
-* order the fold maintains), and the event relations the fold relies on
-* (host-assigned monotonic turn numbers on `turn/start`, the turn's prompt
-* `user/message` logged after its boundary) are owned and runtime-checked by
-* dsh-agent-loop and the session surface, not here.
-*/
-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-session-turn-outline`.
- * @module @deepseek-ai/dsh-session-turn-outline/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "session-turn-outline-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

package/lib/types/invariant.js

@@ -1,27 +0,0 @@
-/**
- * Package-owned invariant companion for `@deepseek-ai/dsh-session-turn-outline`.
- * @module @deepseek-ai/dsh-session-turn-outline/invariant
- */
-const PACKAGE_NAME = '@deepseek-ai/dsh-session-turn-outline';
-/** Cordis companion plugin name. */
-export const name = 'session-turn-outline-invariant';
-/** Service required before the companion can reserve package ownership. */
-export const inject = ['invariants'];
-/**
- * No runtime invariant: the package owns a single pure projection fold whose
- * wire payload is schema-validated by the projection registry at every
- * snapshot and change-feed emission (including the strictly-increasing turn
- * order the fold maintains), and the event relations the fold relies on
- * (host-assigned monotonic turn numbers on `turn/start`, the turn's prompt
- * `user/message` logged after its boundary) are owned and runtime-checked by
- * dsh-agent-loop and the session surface, not here.
- */
-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.
- */
-export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-/* jscpd:ignore-end */
-//# sourceMappingURL=invariant.js.map