@deepseek-ai/dsh-session-format-v2-to-v3 0.1.5-alpha.1

package/lib/types/codec.d.ts

@@ -0,0 +1,43 @@
+/** V3 framing with hard structural admission and recoverable canonical event validation. */
+import type { SessionFormatEvent, SessionFormatHeader } from '@deepseek-ai/dsh-session-format';
+/** V3 codec validates structural rows before recovery and logical envelopes after provenance decoding. */
+export declare const releasedV3SessionFormatCodec: Readonly<{
+    version: number;
+    decodeHeader(value: unknown): {
+        version: number;
+        id: string;
+        createdAt: number;
+        cwd?: string;
+        parentSession?: string;
+        isSeeded: boolean;
+        origin?: "subagent";
+        delegationDepth: number;
+        agentPreset?: string;
+    };
+    createDecoder(value: unknown, recovery: import("@deepseek-ai/dsh-session-format").SessionFormatRecovery): {
+        header: {
+            version: number;
+            id: string;
+            createdAt: number;
+            cwd?: string;
+            parentSession?: string;
+            isSeeded: boolean;
+            origin?: "subagent";
+            delegationDepth: number;
+            agentPreset?: string;
+        };
+        decodeRow(row: unknown, context: import("@deepseek-ai/dsh-session-format").SessionFormatMigrationContext): void;
+        finish(context: import("@deepseek-ai/dsh-session-format").SessionFormatMigrationContext): number;
+    };
+    encodeHeader(header: SessionFormatHeader, inheritedEventCount: number): {
+        version: number;
+    };
+    encodeEvent(event: SessionFormatEvent): import("@deepseek-ai/dsh-session-format").SessionFormatJsonObject;
+}>;
+/**
+ * Validate owned V3 admission rules before a scanner or codec can discard a recoverable tail.
+ * This checks only identified structural payloads; physical provenance still belongs to decoding.
+ * @param row - parsed physical row, before envelope or compressed-range decoding.
+ */
+export declare function assertV3RowAdmission(row: unknown): void;
+//# sourceMappingURL=codec.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,6 @@
+/** Released-V2 codec and streaming system, canonical-envelope, and PTC migration into V3. */
+export { releasedV2SessionFormatCodec } from '@deepseek-ai/dsh-session-format-v1-to-v2';
+export * from './codec.ts';
+export * from './migration.ts';
+export * from './validation.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/migration.d.ts

@@ -0,0 +1,4 @@
+/** Streaming system-prompt promotion followed by canonical V3 envelope conversion. */
+/** Promote system prompts, remap audited references, and canonicalize envelopes and PTC vocabulary. */
+export declare const sessionFormatV2ToV3: import("@deepseek-ai/dsh-session-format").SessionFormatMigration;
+//# sourceMappingURL=migration.d.ts.map

package/lib/types/payload.d.ts

@@ -0,0 +1,51 @@
+/** Audited V2 migration admission and V3 payload validation, independent of installed core Session types. */
+import type { SessionFormatEvent, SessionFormatJsonObject, SessionFormatJsonValue } from '@deepseek-ai/dsh-session-format';
+/** Audited surface event names; all other admitted events are log-only. */
+export declare const SURFACE_TYPES: ReadonlySet<string>;
+/**
+ * Require a JSON object at the durable input boundary.
+ * @param value - decoded value.
+ * @param label - diagnostic subject.
+ * @returns the narrowed object.
+ */
+export declare function record(value: SessionFormatJsonValue | undefined, label: string): SessionFormatJsonObject;
+/**
+ * Reject missing and unaudited members rather than guessing whether they contain coordinates.
+ * @param value - decoded record.
+ * @param required - required member names.
+ * @param optional - additional admitted names.
+ * @param label - diagnostic subject.
+ */
+export declare function keys(value: SessionFormatJsonObject, required: readonly string[], optional: readonly string[], label: string): void;
+/**
+ * Validate classified payloads before migration, or native V3 system/header payloads.
+ * @param event - decoded logical event.
+ * @param version - source or target generation.
+ */
+export declare function assertEvent(event: SessionFormatEvent, version: 2 | 3): void;
+/**
+ * Recognize stable generated repair IDs without interpreting their historical suffix as a current coordinate.
+ * @param id - durable message identity.
+ * @param callId - advertised tool identity.
+ * @returns whether the identity has the canonical historical repair form.
+ */
+export declare function isRepairIdentity(id: SessionFormatJsonValue | undefined, callId: SessionFormatJsonValue | undefined): callId is string;
+/**
+ * Reject V3 structural payload violations even beyond a recoverable physical-row failure.
+ * @param value - raw physical row; ordinary rows retain the frozen decoder's recovery policy.
+ */
+export declare function assertV3StructuralRow(value: unknown): void;
+/**
+ * Validate one canonical V3 event without interpreting plugin-owned payloads or log relationships.
+ * Unclassified metadata is deferred to vocabulary-aware restoration; unknown required types must not become recoverable corruption.
+ * @param event - decoded logical event.
+ * @param knownEventTypes - additional installed event types whose envelopes are interpreted.
+ */
+export declare function assertV3Event(event: SessionFormatEvent, knownEventTypes?: ReadonlySet<string>): void;
+/**
+ * Canonicalize structurally transformed events without changing their target coordinates.
+ * @param event - transformed event using released replacement names and target coordinates.
+ * @returns a V3 event sharing all unchanged payloads and reference values.
+ */
+export declare function canonicalizeTransformedEvent(event: SessionFormatEvent): SessionFormatEvent;
+//# sourceMappingURL=payload.d.ts.map

package/lib/types/references.d.ts

@@ -0,0 +1,11 @@
+/** Explicit local-coordinate remapping; captured generations and owner-local counters remain opaque. */
+import type { SessionFormatEvent } from '@deepseek-ai/dsh-session-format';
+/**
+ * Remap only audited same-artifact references, preserving IDs and embedded model input.
+ * @param event - validated source event.
+ * @param seq - output event position.
+ * @param mapping - earlier source positions mapped to output positions.
+ * @returns the event in target coordinates.
+ */
+export declare function remapEvent(event: SessionFormatEvent, seq: number, mapping: readonly number[]): SessionFormatEvent;
+//# sourceMappingURL=references.d.ts.map

package/lib/types/validation.d.ts

@@ -0,0 +1,21 @@
+/** Native V3 system-head validation with a private view for frozen non-system relationships. */
+import type { SessionFormatArtifact, SessionFormatEvent, SessionFormatHeader } from '@deepseek-ai/dsh-session-format';
+/**
+ * Validate v3 logical metadata with the released-v2 fields.
+ * @param header - decoded v3 Session header.
+ */
+export declare function assertReleasedV3Header(header: SessionFormatHeader): void;
+/**
+ * Validate system ownership, protected-head operations, ordinary relationships, and inherited cut.
+ * The private relationship view never escapes; the returned artifact and its messages are unchanged.
+ * @param artifact - detached v3 artifact.
+ * @param knownEventTypes - event types understood by the installed Session package.
+ * @returns the same validated artifact.
+ */
+export declare function restoreReleasedV3Artifact(artifact: SessionFormatArtifact, knownEventTypes: ReadonlySet<string>): SessionFormatArtifact;
+/**
+ * Refuse required predecessor PTC tags without interpreting native extension payloads.
+ * @param event - event envelope whose type and ignorable admission markers are available.
+ */
+export declare function assertV3EventAdmission(event: SessionFormatEvent): void;
+//# sourceMappingURL=validation.d.ts.map

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@deepseek-ai/dsh-session-format-v2-to-v3",
+  "description": "Streaming system-prompt, canonical-envelope and PTC migration into V3",
+  "version": "0.1.5-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/session/session-format-v2-to-v3"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "sessionFormatMigration": {
+      "from": 2,
+      "to": 3,
+      "export": ".",
+      "migration": "sessionFormatV2ToV3",
+      "sourceCodec": "releasedV2SessionFormatCodec",
+      "targetCodec": "releasedV3SessionFormatCodec",
+      "targetHeaderValidator": "assertReleasedV3Header",
+      "targetRestorer": "restoreReleasedV3Artifact"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-session-format-v0-to-v1": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-format-v1-to-v2": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-format": "^0.1.5-alpha.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  }
+}