@pellux/goodvibes-sdk 0.25.1 → 0.25.3

package/dist/_internal/platform/runtime/contracts/types.d.ts

@@ -1,123 +0,0 @@
-/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
-/**
- * Compatibility Contracts — Core Types
- *
- * Defines the foundational types used by the schema versioning and migration
- * infrastructure across all runtime domains.
- *
- * @module contracts/types
- */
-/**
- * A semantic version identifier for a schema.
- *
- * Follows major.minor.patch semantics:
- * - major: breaking change, requires explicit migration
- * - minor: additive change, backward-compatible
- * - patch: non-structural fix, always backward-compatible
- */
-export interface SchemaVersion {
-    readonly major: number;
-    readonly minor: number;
-    readonly patch: number;
-}
-/**
- * The result of a schema validation operation.
- */
-export interface ValidationResult {
-    /** Whether the data is valid against the expected schema. */
-    readonly valid: boolean;
-    /** Structured list of validation errors (empty when valid). */
-    readonly errors: ValidationError[];
-    /** The detected schema version, if parseable. */
-    readonly version?: SchemaVersion;
-}
-/**
- * A single validation failure with path and diagnostic context.
- */
-export interface ValidationError {
-    /** Dot-delimited path to the invalid field (e.g. 'envelope.sessionId'). */
-    readonly path: string;
-    /** Human-readable description of the failure. */
-    readonly message: string;
-    /** Description of the expected type or value. */
-    readonly expected?: string;
-    /** Description of the actual type or value found. */
-    readonly actual?: string;
-}
-/**
- * A pure transformation function that migrates data from one schema version
- * to the next. Must not mutate the input — return a new object.
- *
- * The `unknown` input/output types are intentional: migration functions operate
- * on raw persisted data whose shape may predate current TypeScript interfaces.
- */
-export type MigrationFn = (data: unknown) => unknown;
-/**
- * Describes a single step in a migration chain, moving data from `from` to `to`.
- *
- * All steps must be registered in the MigrationRegistry before use.
- */
-export interface MigrationStep {
-    /** Source schema version this step migrates from. */
-    readonly from: SchemaVersion;
-    /** Target schema version this step migrates to. */
-    readonly to: SchemaVersion;
-    /** Pure transformation function. Must not mutate input. */
-    readonly migrate: MigrationFn;
-    /** Human-readable description of what this migration changes. */
-    readonly description: string;
-}
-/**
- * The result of a migration operation, containing the transformed data
- * and the version it was migrated to.
- */
-export interface MigrationResult {
-    /** The migrated data at the target schema version. */
-    readonly data: unknown;
-    /** The schema version of the migrated data. */
-    readonly version: SchemaVersion;
-}
-/**
- * A schema contract defines the versioning, validation, and migration
- * interface for a single domain schema (e.g. RuntimeState, EventEnvelope).
- */
-export interface SchemaContract {
-    /** Unique name identifying this contract (e.g. 'runtimeState'). */
-    readonly name: string;
-    /** The current schema version emitted by this runtime. */
-    readonly currentVersion: SchemaVersion;
-    /** The oldest schema version this runtime can still migrate from. */
-    readonly minSupportedVersion: SchemaVersion;
-    /**
-     * Validates that the given data matches the expected schema shape.
-     * Performs runtime type checks — not just TypeScript type narrowing.
-     */
-    validate: (data: unknown) => ValidationResult;
-    /**
-     * Migrates data from an older schema version to the current version.
-     * Returns a MigrationResult with the migrated data and target version,
-     * or throws if migration is not possible.
-     */
-    migrate: (data: unknown, fromVersion: SchemaVersion) => MigrationResult;
-}
-/**
- * Compares two SchemaVersions. Returns:
- * - negative if a < b
- * - 0 if a === b
- * - positive if a > b
- */
-export declare function compareVersions(a: SchemaVersion, b: SchemaVersion): number;
-/**
- * Returns true if the two SchemaVersions are equal.
- */
-export declare function versionsEqual(a: SchemaVersion, b: SchemaVersion): boolean;
-/**
- * Serializes a SchemaVersion to a canonical string (e.g. '1.0.0').
- */
-export declare function versionToString(v: SchemaVersion): string;
-/**
- * Parses a version string (e.g. '1.2.3') into a SchemaVersion.
- * Throws if the string is not a valid semver triple.
- */
-export declare function parseVersion(raw: string): SchemaVersion;
-//# sourceMappingURL=types.d.ts.map

package/dist/_internal/platform/runtime/contracts/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/contracts/types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC;IAC5C;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,gBAAgB,CAAC;IAC9C;;;;OAIG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,KAAK,eAAe,CAAC;CACzE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAI1E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAUvD"}

package/dist/_internal/platform/runtime/contracts/types.js

@@ -1,41 +0,0 @@
-/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
-/**
- * Compares two SchemaVersions. Returns:
- * - negative if a < b
- * - 0 if a === b
- * - positive if a > b
- */
-export function compareVersions(a, b) {
-    if (a.major !== b.major)
-        return a.major - b.major;
-    if (a.minor !== b.minor)
-        return a.minor - b.minor;
-    return a.patch - b.patch;
-}
-/**
- * Returns true if the two SchemaVersions are equal.
- */
-export function versionsEqual(a, b) {
-    return a.major === b.major && a.minor === b.minor && a.patch === b.patch;
-}
-/**
- * Serializes a SchemaVersion to a canonical string (e.g. '1.0.0').
- */
-export function versionToString(v) {
-    return `${v.major}.${v.minor}.${v.patch}`;
-}
-/**
- * Parses a version string (e.g. '1.2.3') into a SchemaVersion.
- * Throws if the string is not a valid semver triple.
- */
-export function parseVersion(raw) {
-    const parts = raw.split('.');
-    if (parts.length !== 3) {
-        throw new Error(`Invalid schema version string: '${raw}' (expected 'major.minor.patch')`);
-    }
-    const [major, minor, patch] = parts.map(Number);
-    if (!Number.isInteger(major) || !Number.isInteger(minor) || !Number.isInteger(patch)) {
-        throw new Error(`Non-integer component in schema version: '${raw}'`);
-    }
-    return { major, minor, patch };
-}

package/dist/_internal/platform/runtime/contracts/validators/event-envelope.d.ts

@@ -1,24 +0,0 @@
-/**
- * Compatibility Contracts — EventEnvelope Validator
- *
- * Performs runtime shape validation for the RuntimeEventEnvelope persistence schema.
- * Returns a structured ValidationResult rather than throwing.
- *
- * @module contracts/validators/event-envelope
- */
-import type { ValidationResult } from '../types.js';
-/**
- * Validates that `data` conforms to the expected RuntimeEventEnvelope persistence shape.
- *
- * Checks:
- * - `data` is a non-null object
- * - `type`, `traceId`, `sessionId`, `source` are non-empty strings
- * - `ts` is a finite number (Unix ms timestamp)
- * - `payload` is present and is a non-null object
- * - `version` (if present) has numeric `major`, `minor`, `patch` fields
- *
- * @param data - The raw persisted data to validate.
- * @returns A ValidationResult with structured errors if any field is invalid.
- */
-export declare function validateEventEnvelope(data: unknown): ValidationResult;
-//# sourceMappingURL=event-envelope.d.ts.map

package/dist/_internal/platform/runtime/contracts/validators/event-envelope.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-envelope.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/contracts/validators/event-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAkC,MAAM,aAAa,CAAC;AAOpF;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAgFrE"}

package/dist/_internal/platform/runtime/contracts/validators/event-envelope.js

@@ -1,104 +0,0 @@
-/**
- * Compatibility Contracts — EventEnvelope Validator
- *
- * Performs runtime shape validation for the RuntimeEventEnvelope persistence schema.
- * Returns a structured ValidationResult rather than throwing.
- *
- * @module contracts/validators/event-envelope
- */
-/**
- * Required fields for a persisted RuntimeEventEnvelope.
- */
-const REQUIRED_STRING_FIELDS = ['type', 'traceId', 'sessionId', 'source'];
-/**
- * Validates that `data` conforms to the expected RuntimeEventEnvelope persistence shape.
- *
- * Checks:
- * - `data` is a non-null object
- * - `type`, `traceId`, `sessionId`, `source` are non-empty strings
- * - `ts` is a finite number (Unix ms timestamp)
- * - `payload` is present and is a non-null object
- * - `version` (if present) has numeric `major`, `minor`, `patch` fields
- *
- * @param data - The raw persisted data to validate.
- * @returns A ValidationResult with structured errors if any field is invalid.
- */
-export function validateEventEnvelope(data) {
-    const errors = [];
-    if (data === null || typeof data !== 'object') {
-        errors.push({
-            path: '',
-            message: 'EventEnvelope must be a non-null object',
-            expected: 'object',
-            actual: data === null ? 'null' : typeof data,
-        });
-        return { valid: false, errors };
-    }
-    const record = data;
-    // Validate required string fields
-    for (const field of REQUIRED_STRING_FIELDS) {
-        const value = record[field];
-        if (typeof value !== 'string' || value.length === 0) {
-            errors.push({
-                path: field,
-                message: `Field '${field}' must be a non-empty string`,
-                expected: 'non-empty string',
-                actual: value === undefined ? 'undefined' : value === null ? 'null' : typeof value,
-            });
-        }
-    }
-    // Validate ts: finite number
-    const tsRaw = record['ts'];
-    if (typeof tsRaw !== 'number' || !Number.isFinite(tsRaw)) {
-        errors.push({
-            path: 'ts',
-            message: "Field 'ts' must be a finite number (Unix ms timestamp)",
-            expected: 'finite number',
-            actual: tsRaw === undefined ? 'undefined' : tsRaw === null ? 'null' : typeof tsRaw,
-        });
-    }
-    // Validate payload: non-null object
-    const payloadRaw = record['payload'];
-    if (payloadRaw === undefined || payloadRaw === null || typeof payloadRaw !== 'object') {
-        errors.push({
-            path: 'payload',
-            message: "Field 'payload' must be a non-null object",
-            expected: 'object',
-            actual: payloadRaw === undefined ? 'undefined' : payloadRaw === null ? 'null' : typeof payloadRaw,
-        });
-    }
-    // Detect version if present
-    let detectedVersion;
-    const versionRaw = record['version'];
-    if (versionRaw !== undefined && versionRaw !== null && typeof versionRaw === 'object') {
-        const v = versionRaw;
-        const allNumeric = typeof v['major'] === 'number' &&
-            typeof v['minor'] === 'number' &&
-            typeof v['patch'] === 'number';
-        if (allNumeric) {
-            detectedVersion = {
-                major: v['major'],
-                minor: v['minor'],
-                patch: v['patch'],
-            };
-        }
-        else {
-            errors.push({
-                path: 'version',
-                message: "Field 'version' must have numeric major, minor, patch components",
-                expected: '{ major: number, minor: number, patch: number }',
-                actual: (() => { try {
-                    return JSON.stringify(versionRaw);
-                }
-                catch {
-                    return String(versionRaw);
-                } })(),
-            });
-        }
-    }
-    return {
-        valid: errors.length === 0,
-        errors,
-        version: detectedVersion,
-    };
-}

package/dist/_internal/platform/runtime/contracts/validators/index.d.ts

@@ -1,11 +0,0 @@
-/**
- * Compatibility Contracts — Validators barrel
- *
- * Re-exports all runtime shape validators for the contract registry.
- *
- * @module contracts/validators
- */
-export { validateRuntimeState } from './runtime-state.js';
-export { validateEventEnvelope } from './event-envelope.js';
-export { validateSession } from './session.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/runtime/contracts/validators/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/contracts/validators/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/_internal/platform/runtime/contracts/validators/index.js

@@ -1,10 +0,0 @@
-/**
- * Compatibility Contracts — Validators barrel
- *
- * Re-exports all runtime shape validators for the contract registry.
- *
- * @module contracts/validators
- */
-export { validateRuntimeState } from './runtime-state.js';
-export { validateEventEnvelope } from './event-envelope.js';
-export { validateSession } from './session.js';

package/dist/_internal/platform/runtime/contracts/validators/runtime-state.d.ts

@@ -1,23 +0,0 @@
-/**
- * Compatibility Contracts — RuntimeState Validator
- *
- * Performs runtime shape validation for the top-level RuntimeState snapshot schema.
- * Returns a structured ValidationResult rather than throwing.
- *
- * @module contracts/validators/runtime-state
- */
-import type { ValidationResult } from '../types.js';
-/**
- * Validates that `data` conforms to the expected RuntimeState snapshot shape.
- *
- * Checks:
- * - `data` is a non-null object
- * - `version` is present and has numeric `major`, `minor`, `patch` fields
- * - `domains` is present and is a non-null object
- *
- * @param data - The raw persisted data to validate.
- * @returns A ValidationResult with `valid: true` if the shape is correct,
- *   or `valid: false` with a list of errors if any required field is missing or malformed.
- */
-export declare function validateRuntimeState(data: unknown): ValidationResult;
-//# sourceMappingURL=runtime-state.d.ts.map

package/dist/_internal/platform/runtime/contracts/validators/runtime-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime-state.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/contracts/validators/runtime-state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAkC,MAAM,aAAa,CAAC;AAQpF;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAgFpE"}

package/dist/_internal/platform/runtime/contracts/validators/runtime-state.js

@@ -1,101 +0,0 @@
-/**
- * Compatibility Contracts — RuntimeState Validator
- *
- * Performs runtime shape validation for the top-level RuntimeState snapshot schema.
- * Returns a structured ValidationResult rather than throwing.
- *
- * @module contracts/validators/runtime-state
- */
-/**
- * Expected top-level field names for a RuntimeState snapshot.
- * Validated as required string/object fields at the top level.
- */
-const REQUIRED_FIELDS = ['version', 'domains'];
-/**
- * Validates that `data` conforms to the expected RuntimeState snapshot shape.
- *
- * Checks:
- * - `data` is a non-null object
- * - `version` is present and has numeric `major`, `minor`, `patch` fields
- * - `domains` is present and is a non-null object
- *
- * @param data - The raw persisted data to validate.
- * @returns A ValidationResult with `valid: true` if the shape is correct,
- *   or `valid: false` with a list of errors if any required field is missing or malformed.
- */
-export function validateRuntimeState(data) {
-    const errors = [];
-    if (data === null || typeof data !== 'object') {
-        errors.push({
-            path: '',
-            message: 'RuntimeState must be a non-null object',
-            expected: 'object',
-            actual: data === null ? 'null' : typeof data,
-        });
-        return { valid: false, errors };
-    }
-    const record = data;
-    // Check all required top-level fields are present
-    for (const field of REQUIRED_FIELDS) {
-        if (!(field in record)) {
-            errors.push({
-                path: field,
-                message: `Missing required field '${field}'`,
-                expected: 'present',
-                actual: 'undefined',
-            });
-        }
-    }
-    // Validate version shape: { major: number, minor: number, patch: number }
-    let detectedVersion;
-    const versionRaw = record['version'];
-    if (versionRaw !== undefined) {
-        if (versionRaw === null || typeof versionRaw !== 'object') {
-            errors.push({
-                path: 'version',
-                message: 'Field \'version\' must be a non-null object',
-                expected: '{ major: number, minor: number, patch: number }',
-                actual: versionRaw === null ? 'null' : typeof versionRaw,
-            });
-        }
-        else {
-            const v = versionRaw;
-            const vErrors = [];
-            for (const component of ['major', 'minor', 'patch']) {
-                if (typeof v[component] !== 'number') {
-                    vErrors.push({
-                        path: `version.${component}`,
-                        message: `Field 'version.${component}' must be a number`,
-                        expected: 'number',
-                        actual: v[component] === null ? 'null' : typeof v[component],
-                    });
-                }
-            }
-            errors.push(...vErrors);
-            if (vErrors.length === 0) {
-                detectedVersion = {
-                    major: v['major'],
-                    minor: v['minor'],
-                    patch: v['patch'],
-                };
-            }
-        }
-    }
-    // Validate domains is a non-null object
-    const domainsRaw = record['domains'];
-    if (domainsRaw !== undefined) {
-        if (domainsRaw === null || typeof domainsRaw !== 'object' || Array.isArray(domainsRaw)) {
-            errors.push({
-                path: 'domains',
-                message: "Field 'domains' must be a non-null, non-array object",
-                expected: 'object',
-                actual: domainsRaw === null ? 'null' : Array.isArray(domainsRaw) ? 'array' : typeof domainsRaw,
-            });
-        }
-    }
-    return {
-        valid: errors.length === 0,
-        errors,
-        version: detectedVersion,
-    };
-}

package/dist/_internal/platform/runtime/contracts/validators/session.d.ts

@@ -1,24 +0,0 @@
-/**
- * Compatibility Contracts — Session Validator
- *
- * Performs runtime shape validation for the session persistence format
- * (messages array + meta object). Returns a structured ValidationResult.
- *
- * @module contracts/validators/session
- */
-import type { ValidationResult } from '../types.js';
-/**
- * Validates that `data` conforms to the expected session persistence shape.
- *
- * Checks:
- * - `data` is a non-null object
- * - `sessionId` is a non-empty string
- * - `messages` is an array (contents are not deeply validated)
- * - `meta` is a non-null, non-array object
- * - `meta.version` (if present) has numeric `major`, `minor`, `patch` fields
- *
- * @param data - The raw persisted data to validate.
- * @returns A ValidationResult with structured errors if any field is invalid.
- */
-export declare function validateSession(data: unknown): ValidationResult;
-//# sourceMappingURL=session.d.ts.map

package/dist/_internal/platform/runtime/contracts/validators/session.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/contracts/validators/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAkC,MAAM,aAAa,CAAC;AAEpF;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAmF/D"}

package/dist/_internal/platform/runtime/contracts/validators/session.js

@@ -1,103 +0,0 @@
-/**
- * Compatibility Contracts — Session Validator
- *
- * Performs runtime shape validation for the session persistence format
- * (messages array + meta object). Returns a structured ValidationResult.
- *
- * @module contracts/validators/session
- */
-/**
- * Validates that `data` conforms to the expected session persistence shape.
- *
- * Checks:
- * - `data` is a non-null object
- * - `sessionId` is a non-empty string
- * - `messages` is an array (contents are not deeply validated)
- * - `meta` is a non-null, non-array object
- * - `meta.version` (if present) has numeric `major`, `minor`, `patch` fields
- *
- * @param data - The raw persisted data to validate.
- * @returns A ValidationResult with structured errors if any field is invalid.
- */
-export function validateSession(data) {
-    const errors = [];
-    if (data === null || typeof data !== 'object') {
-        errors.push({
-            path: '',
-            message: 'Session must be a non-null object',
-            expected: 'object',
-            actual: data === null ? 'null' : typeof data,
-        });
-        return { valid: false, errors };
-    }
-    const record = data;
-    // Validate sessionId: non-empty string
-    const sessionIdRaw = record['sessionId'];
-    if (typeof sessionIdRaw !== 'string' || sessionIdRaw.length === 0) {
-        errors.push({
-            path: 'sessionId',
-            message: "Field 'sessionId' must be a non-empty string",
-            expected: 'non-empty string',
-            actual: sessionIdRaw === undefined ? 'undefined' : sessionIdRaw === null ? 'null' : typeof sessionIdRaw,
-        });
-    }
-    // Validate messages: array
-    const messagesRaw = record['messages'];
-    if (!Array.isArray(messagesRaw)) {
-        errors.push({
-            path: 'messages',
-            message: "Field 'messages' must be an array",
-            expected: 'array',
-            actual: messagesRaw === undefined ? 'undefined' : messagesRaw === null ? 'null' : typeof messagesRaw,
-        });
-    }
-    // Validate meta: non-null, non-array object
-    const metaRaw = record['meta'];
-    if (metaRaw === undefined || metaRaw === null || typeof metaRaw !== 'object' || Array.isArray(metaRaw)) {
-        errors.push({
-            path: 'meta',
-            message: "Field 'meta' must be a non-null, non-array object",
-            expected: 'object',
-            actual: metaRaw === undefined ? 'undefined' : metaRaw === null ? 'null' : Array.isArray(metaRaw) ? 'array' : typeof metaRaw,
-        });
-    }
-    // Detect version from meta.version if present
-    let detectedVersion;
-    if (metaRaw !== undefined && metaRaw !== null && typeof metaRaw === 'object' && !Array.isArray(metaRaw)) {
-        const meta = metaRaw;
-        const versionRaw = meta['version'];
-        if (versionRaw !== undefined && versionRaw !== null && typeof versionRaw === 'object') {
-            const v = versionRaw;
-            const allNumeric = typeof v['major'] === 'number' &&
-                typeof v['minor'] === 'number' &&
-                typeof v['patch'] === 'number';
-            if (allNumeric) {
-                detectedVersion = {
-                    major: v['major'],
-                    minor: v['minor'],
-                    patch: v['patch'],
-                };
-            }
-            else {
-                let actualStr;
-                try {
-                    actualStr = JSON.stringify(versionRaw);
-                }
-                catch {
-                    actualStr = String(versionRaw);
-                }
-                errors.push({
-                    path: 'meta.version',
-                    message: "Field 'meta.version' must have numeric major, minor, patch components",
-                    expected: '{ major: number, minor: number, patch: number }',
-                    actual: actualStr,
-                });
-            }
-        }
-    }
-    return {
-        valid: errors.length === 0,
-        errors,
-        version: detectedVersion,
-    };
-}

package/dist/_internal/platform/runtime/contracts/version.d.ts

@@ -1,84 +0,0 @@
-/**
- * Compatibility Contracts — Current Schema Versions
- *
- * Declares the authoritative current schema version for each versioned domain.
- * Bump these when making structural changes to the corresponding schema.
- *
- * @module contracts/version
- */
-/**
- * Current schema versions for all versioned runtime domains.
- *
- * Rules for bumping:
- * - Bump `major` when the change is breaking (requires migration)
- * - Bump `minor` when adding optional fields (additive, backward-compatible)
- * - Bump `patch` for non-structural documentation or annotation changes
- */
-export declare const SCHEMA_VERSIONS: {
-    /** Top-level RuntimeState snapshot schema. */
-    readonly runtimeState: {
-        readonly major: 1;
-        readonly minor: 0;
-        readonly patch: 0;
-    };
-    /** RuntimeEventEnvelope schema for event persistence and replay. */
-    readonly eventEnvelope: {
-        readonly major: 1;
-        readonly minor: 1;
-        readonly patch: 0;
-    };
-    /** Session persistence format (messages + meta). */
-    readonly session: {
-        readonly major: 1;
-        readonly minor: 0;
-        readonly patch: 0;
-    };
-    /** Plugin manifest and capability descriptor schema. */
-    readonly pluginManifest: {
-        readonly major: 1;
-        readonly minor: 0;
-        readonly patch: 0;
-    };
-    /** RuntimeTask record schema used in task domain persistence. */
-    readonly taskRecord: {
-        readonly major: 1;
-        readonly minor: 0;
-        readonly patch: 0;
-    };
-};
-/**
- * The minimum schema version supported for migration for each domain.
- *
- * Data older than this version cannot be migrated and must be discarded
- * or re-initialized. This is updated when old migration steps are pruned.
- */
-export declare const MIN_SUPPORTED_VERSIONS: {
-    readonly runtimeState: {
-        readonly major: 1;
-        readonly minor: 0;
-        readonly patch: 0;
-    };
-    readonly eventEnvelope: {
-        readonly major: 1;
-        readonly minor: 0;
-        readonly patch: 0;
-    };
-    readonly session: {
-        readonly major: 1;
-        readonly minor: 0;
-        readonly patch: 0;
-    };
-    readonly pluginManifest: {
-        readonly major: 1;
-        readonly minor: 0;
-        readonly patch: 0;
-    };
-    readonly taskRecord: {
-        readonly major: 1;
-        readonly minor: 0;
-        readonly patch: 0;
-    };
-};
-/** Union of all known contract names. */
-export type ContractName = keyof typeof SCHEMA_VERSIONS;
-//# sourceMappingURL=version.d.ts.map