@deepseek-ai/dsh-session-format-v0-to-v1 0.1.3-alpha.2

package/lib/types/codec.d.ts

@@ -0,0 +1,39 @@
+import type { SessionFormatEventRun, SessionFormatHeader, SessionFormatJsonObject, SessionFormatMigrationContext, SessionFormatRecovery } from '@deepseek-ai/dsh-session-format';
+/** A released packed Assistant row retained until v1-to-v2 embeds its compact stream. */
+export interface ReleasedAssistantChunkRun extends SessionFormatEventRun {
+    readonly runType: 'released-assistant-chunks';
+    readonly turn: number;
+    readonly step: number;
+    readonly lastSeq: number;
+    readonly lastTime: number;
+    readonly stream: SessionFormatJsonObject;
+}
+/**
+ * Test whether a compact migration item is a released packed Assistant row.
+ * @param run - compact migration item to classify.
+ * @returns whether the item carries the released Assistant chunk representation.
+ */
+export declare function isReleasedAssistantChunkRun(run: SessionFormatEventRun): run is ReleasedAssistantChunkRun;
+/** Frozen physical JSON codec for the released v0 layout. */
+export declare const releasedV0SessionFormatCodec: Readonly<{
+    version: 0 | 1;
+    decodeHeader: (value: unknown) => SessionFormatHeader;
+    createDecoder(headerValue: unknown, recovery: SessionFormatRecovery): {
+        header: SessionFormatHeader;
+        headerInheritedEventCount: number;
+        decodeRow: (rowValue: unknown, context: SessionFormatMigrationContext) => void;
+        finish(_context: SessionFormatMigrationContext): number;
+    };
+}>;
+/** Frozen physical JSON codec for the shared-layout released v1 format. */
+export declare const releasedV1SessionFormatCodec: Readonly<{
+    version: 0 | 1;
+    decodeHeader: (value: unknown) => SessionFormatHeader;
+    createDecoder(headerValue: unknown, recovery: SessionFormatRecovery): {
+        header: SessionFormatHeader;
+        headerInheritedEventCount: number;
+        decodeRow: (rowValue: unknown, context: SessionFormatMigrationContext) => void;
+        finish(_context: SessionFormatMigrationContext): number;
+    };
+}>;
+//# sourceMappingURL=codec.d.ts.map

package/lib/types/dispositions.d.ts

@@ -0,0 +1,26 @@
+/** Exact top-level payload disposition frozen for every released-v0 event type. */
+export interface ReleasedV0PayloadDisposition {
+    readonly required: readonly string[];
+    readonly optional: readonly string[];
+    /** JSON members whose nested representation is intentionally owner-opaque. */
+    readonly opaque: readonly string[];
+}
+/**
+ * Freeze one exact released payload-member disposition for adjacent format validators.
+ * @param required - members that must be present.
+ * @param optional - additional admitted members.
+ * @param opaque - members retained as lossless JSON without nested semantic inspection.
+ * @returns the detached frozen disposition.
+ */
+export declare function defineReleasedPayloadDisposition(required: readonly string[], optional?: readonly string[], opaque?: readonly string[]): ReleasedV0PayloadDisposition;
+/**
+ * Frozen released-v0 event and payload-member inventory.
+ * Every listed member is preserved by the identity edge. Members in `opaque`
+ * remain lossless JSON without nested Session-sequence interpretation. Nested
+ * merge-extensible discriminants validate known variants and preserve
+ * unknown variants as owner-opaque JSON.
+ */
+export declare const RELEASED_V0_EVENT_DISPOSITIONS: Readonly<Record<string, ReleasedV0PayloadDisposition>>;
+/** Stable sorted released-v0 event inventory. */
+export declare const RELEASED_V0_EVENT_TYPES: readonly string[];
+//# sourceMappingURL=dispositions.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,8 @@
+/** Frozen released-v0 physical codec and identity migration into shared-layout v1. */
+export * from './codec.ts';
+export * from './dispositions.ts';
+export * from './migration.ts';
+export { assertReleasedPayloadSemantics } from './payload-validation.ts';
+export { assertReleasedArtifactRelationships } from './relationships.ts';
+export { assertReleasedSurfaceMetadata, assertReleasedEventPayload, assertReleasedV1Header, restoreReleasedV1Artifact, } from './validation.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/migration.d.ts

@@ -0,0 +1,3 @@
+/** Identity format edge that promotes released v0 into released v1. */
+export declare const sessionFormatV0ToV1: import("@deepseek-ai/dsh-session-format").SessionFormatMigration;
+//# sourceMappingURL=migration.d.ts.map

package/lib/types/payload-validation.d.ts

@@ -0,0 +1,8 @@
+import type { SessionFormatEvent } from '@deepseek-ai/dsh-session-format';
+/**
+ * Validate nested released payload semantics for one known event.
+ * @param event - known event with exact top-level members.
+ * @param version - source or current payload generation.
+ */
+export declare function assertReleasedPayloadSemantics(event: SessionFormatEvent, version: number): void;
+//# sourceMappingURL=payload-validation.d.ts.map

package/lib/types/relationships.d.ts

@@ -0,0 +1,17 @@
+import type { SessionFormatArtifact } from '@deepseek-ai/dsh-session-format';
+/** Relationship roles added by a later format while reusing the released validator. */
+export interface ReleasedRelationshipExtensions {
+    /** Event types that must occur inside the current open step. */
+    readonly stepEvents?: ReadonlySet<string>;
+    /** Title-request model input was source-validated and preserved across sequence remapping. */
+    readonly preservedSourceTitleRequestText?: true;
+    /** Admit the released resume pattern whose next-turn inbox insert omitted the prior turn/end. */
+    readonly legacyInterruptedTurnRestart?: true;
+}
+/**
+ * Validate cross-event relationships required to construct one current Session safely.
+ * @param artifact - complete normalized v0 or exact current v1 artifact.
+ * @param extensions - later-generation event roles interpreted by the calling format owner.
+ */
+export declare function assertReleasedArtifactRelationships(artifact: SessionFormatArtifact, extensions?: ReleasedRelationshipExtensions): void;
+//# sourceMappingURL=relationships.d.ts.map

package/lib/types/testing/restore.d.ts

@@ -0,0 +1,18 @@
+import type { SessionFormatArtifact, SessionFormatRecovery } from '@deepseek-ai/dsh-session-format';
+/**
+ * Restore released v0 rows through the production decoder and v0-to-v1 stage.
+ * @param header - released v0 physical header.
+ * @param rows - released v0 physical rows.
+ * @param recovery - strict or recoverable row policy.
+ * @returns the transformed released v1 artifact.
+ */
+export declare function restoreV0ToV1(header: unknown, rows: readonly unknown[], recovery?: SessionFormatRecovery): SessionFormatArtifact;
+/**
+ * Restore released v1 rows through the production decoder and current collector.
+ * @param header - released v1 physical header.
+ * @param rows - released v1 physical rows.
+ * @param recovery - strict or recoverable row policy.
+ * @returns the restored released v1 artifact.
+ */
+export declare function restoreV1(header: unknown, rows: readonly unknown[], recovery?: SessionFormatRecovery): SessionFormatArtifact;
+//# sourceMappingURL=restore.d.ts.map

package/lib/types/testing/validation.d.ts

@@ -0,0 +1,27 @@
+import type { SessionFormatArtifact } from '@deepseek-ai/dsh-session-format';
+/**
+ * Validate one decoded released-v0 source artifact in tests.
+ * @param artifact - released-v0 source artifact.
+ */
+export declare function assertReleasedV0SourceArtifact(artifact: SessionFormatArtifact): void;
+/**
+ * Validate normalized v0 output before the identity header bump in tests.
+ * @param artifact - normalized v0 artifact.
+ */
+export declare function assertNormalizedReleasedV0Artifact(artifact: SessionFormatArtifact): void;
+/**
+ * Validate v1 input accepted by the v1-to-v2 migration in tests.
+ * @param artifact - v1 migration source artifact.
+ */
+export declare function assertReleasedV1MigrationSource(artifact: SessionFormatArtifact): void;
+/**
+ * Validate the exact released-v1 logical artifact in tests.
+ * @param artifact - released-v1 logical artifact.
+ */
+export declare function assertReleasedV1Artifact(artifact: SessionFormatArtifact): void;
+/**
+ * Validate released-v1 physical decoding without interpreting event vocabulary in tests.
+ * @param artifact - released-v1 physical artifact.
+ */
+export declare function assertReleasedV1PhysicalArtifact(artifact: SessionFormatArtifact): void;
+//# sourceMappingURL=validation.d.ts.map

package/lib/types/validation-helpers.d.ts

@@ -0,0 +1,17 @@
+import type { SessionFormatJsonValue } from '@deepseek-ai/dsh-session-format';
+/**
+ * Require one plain JSON object.
+ * @param value - candidate JSON value.
+ * @param label - diagnostic subject.
+ * @returns validated object record.
+ */
+export declare function releasedV0Record(value: unknown, label: string): Record<string, SessionFormatJsonValue>;
+/**
+ * Require every named member and no member outside the optional list.
+ * @param record - candidate object.
+ * @param required - members that must exist.
+ * @param optional - additional admitted members.
+ * @param label - diagnostic subject.
+ */
+export declare function assertReleasedV0Keys(record: Readonly<Record<string, unknown>>, required: readonly string[], optional: readonly string[] | undefined, label: string): void;
+//# sourceMappingURL=validation-helpers.d.ts.map

package/lib/types/validation.d.ts

@@ -0,0 +1,43 @@
+import type { SessionFormatArtifact, SessionFormatEvent, SessionFormatHeader, SessionFormatJsonValue } from '@deepseek-ai/dsh-session-format';
+/**
+ * Validate the logical header shared by released v0 and v1.
+ * @param header - detached logical header.
+ * @param version - exact expected generation.
+ */
+export declare function assertReleasedSessionFormatHeader(header: SessionFormatHeader, version: 0 | 1): void;
+/**
+ * Validate one released-v1 logical header.
+ * @param header - detached logical header.
+ */
+export declare function assertReleasedV1Header(header: SessionFormatHeader): void;
+/**
+ * Restore v1 against the installed build's ordinary event vocabulary without freezing payload additions.
+ * @param artifact - vocabulary-neutral released-v1 physical decode.
+ * @param knownEventTypes - event types understood by the installed current Session package.
+ * @returns the same validated detached artifact.
+ */
+export declare function restoreReleasedV1Artifact(artifact: SessionFormatArtifact, knownEventTypes: ReadonlySet<string>): SessionFormatArtifact;
+/**
+ * Validate released-v0/v1 artifact coordinates under an explicit vocabulary policy.
+ * @param artifact - logical artifact to validate.
+ * @param allowLegacySteering - whether to accept the retired steering event name.
+ * @param knownEventTypes - installed event vocabulary, when vocabulary-aware.
+ * @param vocabularyNeutral - whether unknown event types remain opaque.
+ * @param frozenEnvelope - whether event envelopes must already be frozen.
+ */
+export declare function assertReleasedArtifactCoordinates(artifact: SessionFormatArtifact, allowLegacySteering: boolean, knownEventTypes?: ReadonlySet<string>, vocabularyNeutral?: boolean, frozenEnvelope?: boolean): void;
+/**
+ * Validate shared-layout surface references for one released generation.
+ * @param record - exact event envelope.
+ * @param seq - event position used for earlier-reference checks.
+ * @param type - surface event type used in diagnostics.
+ * @param assistantSources - whether this generation admits empty Assistant chunk provenance.
+ */
+export declare function assertReleasedSurfaceMetadata(record: Record<string, SessionFormatJsonValue>, seq: number, type: string, assistantSources: 'allow-empty-assistant' | 'forbid-assistant'): void;
+/**
+ * Validate one exact known payload after legacy normalization.
+ * @param event - known event to validate.
+ * @param version - payload generation controlling versioned members.
+ */
+export declare function assertReleasedEventPayload(event: SessionFormatEvent, version: 0 | 1): void;
+//# sourceMappingURL=validation.d.ts.map

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@deepseek-ai/dsh-session-format-v0-to-v1",
+  "description": "Frozen released-v0 Session codec and identity migration to v1",
+  "version": "0.1.3-alpha.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/session/session-format-v0-to-v1"
+  },
+  "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": 0,
+      "to": 1,
+      "export": ".",
+      "migration": "sessionFormatV0ToV1",
+      "sourceCodec": "releasedV0SessionFormatCodec",
+      "targetCodec": "releasedV1SessionFormatCodec",
+      "targetHeaderValidator": "assertReleasedV1Header",
+      "targetRestorer": "restoreReleasedV1Artifact"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-session-format": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-util-values": "^0.1.3-alpha.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2"
+  }
+}