@pellux/goodvibes-sdk 0.25.1 → 0.25.3

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

@@ -1,133 +0,0 @@
-/**
- * Compatibility Contracts — Module barrel and factory
- *
- * Entry point for the schema versioning, validation, and migration
- * infrastructure. Use `createContractRegistry()` to obtain a fully
- * initialized registry with all domain contracts registered.
- *
- * Usage:
- * ```ts
- * import { createContractRegistry } from './contracts/index.js';
- * const { registry, contracts } = createContractRegistry();
- * const result = contracts.get('runtimeState')?.validate(rawData);
- * ```
- *
- * @module contracts
- */
-export { MigrationRegistry } from './migrations/index.js';
-export * from './types.js';
-export * from './version.js';
-export * from './validators/index.js';
-import { MigrationRegistry } from './migrations/index.js';
-import { SCHEMA_VERSIONS, MIN_SUPPORTED_VERSIONS } from './version.js';
-import { getRuntimeStateMigrationSteps, getEventEnvelopeMigrationSteps, getSessionMigrationSteps, getPluginManifestMigrationSteps, getTaskRecordMigrationSteps, } from './migrations/schemas.js';
-import { validateRuntimeState } from './validators/runtime-state.js';
-import { validateEventEnvelope } from './validators/event-envelope.js';
-import { validateSession } from './validators/session.js';
-/**
- * Creates a fully initialized contract registry with all domain migration
- * steps registered and SchemaContract instances built for each domain.
- *
- * Each SchemaContract provides:
- * - `validate(data)` — runtime shape validation returning a ValidationResult
- * - `migrate(data, fromVersion)` — migration chain execution via MigrationRegistry
- *
- * @returns An object containing:
- *   - `registry` — the MigrationRegistry with all steps registered
- *   - `contracts` — a Map of contract name → SchemaContract
- */
-export function createContractRegistry() {
-    const registry = new MigrationRegistry();
-    // Register all domain migration steps
-    for (const step of getRuntimeStateMigrationSteps()) {
-        registry.register('runtimeState', step);
-    }
-    for (const step of getEventEnvelopeMigrationSteps()) {
-        registry.register('eventEnvelope', step);
-    }
-    for (const step of getSessionMigrationSteps()) {
-        registry.register('session', step);
-    }
-    for (const step of getPluginManifestMigrationSteps()) {
-        registry.register('pluginManifest', step);
-    }
-    for (const step of getTaskRecordMigrationSteps()) {
-        registry.register('taskRecord', step);
-    }
-    const contracts = new Map();
-    // runtimeState contract
-    contracts.set('runtimeState', {
-        name: 'runtimeState',
-        currentVersion: SCHEMA_VERSIONS.runtimeState,
-        minSupportedVersion: MIN_SUPPORTED_VERSIONS.runtimeState,
-        validate: validateRuntimeState,
-        migrate: (data, fromVersion) => registry.migrate('runtimeState', data, fromVersion),
-    });
-    // eventEnvelope contract
-    contracts.set('eventEnvelope', {
-        name: 'eventEnvelope',
-        currentVersion: SCHEMA_VERSIONS.eventEnvelope,
-        minSupportedVersion: MIN_SUPPORTED_VERSIONS.eventEnvelope,
-        validate: validateEventEnvelope,
-        migrate: (data, fromVersion) => registry.migrate('eventEnvelope', data, fromVersion),
-    });
-    // session contract
-    contracts.set('session', {
-        name: 'session',
-        currentVersion: SCHEMA_VERSIONS.session,
-        minSupportedVersion: MIN_SUPPORTED_VERSIONS.session,
-        validate: validateSession,
-        migrate: (data, fromVersion) => registry.migrate('session', data, fromVersion),
-    });
-    // pluginManifest contract
-    contracts.set('pluginManifest', {
-        name: 'pluginManifest',
-        currentVersion: SCHEMA_VERSIONS.pluginManifest,
-        minSupportedVersion: MIN_SUPPORTED_VERSIONS.pluginManifest,
-        validate: (data) => {
-            const errors = [];
-            if (data === null || typeof data !== 'object' || Array.isArray(data)) {
-                errors.push({ path: '', message: 'pluginManifest must be a non-null object', expected: 'object', actual: data === null ? 'null' : Array.isArray(data) ? 'array' : typeof data });
-                return { valid: false, errors };
-            }
-            const record = data;
-            if (typeof record['name'] !== 'string' || record['name'].length === 0) {
-                errors.push({ path: 'name', message: "Field 'name' must be a non-empty string", expected: 'non-empty string', actual: typeof record['name'] });
-            }
-            if (typeof record['version'] !== 'string' || record['version'].length === 0) {
-                errors.push({ path: 'version', message: "Field 'version' must be a non-empty string", expected: 'non-empty string', actual: typeof record['version'] });
-            }
-            if (!Array.isArray(record['capabilities'])) {
-                errors.push({ path: 'capabilities', message: "Field 'capabilities' must be an array", expected: 'array', actual: typeof record['capabilities'] });
-            }
-            return { valid: errors.length === 0, errors, version: SCHEMA_VERSIONS.pluginManifest };
-        },
-        migrate: (data, fromVersion) => registry.migrate('pluginManifest', data, fromVersion),
-    });
-    // taskRecord contract
-    contracts.set('taskRecord', {
-        name: 'taskRecord',
-        currentVersion: SCHEMA_VERSIONS.taskRecord,
-        minSupportedVersion: MIN_SUPPORTED_VERSIONS.taskRecord,
-        validate: (data) => {
-            const errors = [];
-            if (data === null || typeof data !== 'object' || Array.isArray(data)) {
-                errors.push({ path: '', message: 'taskRecord must be a non-null object', expected: 'object', actual: data === null ? 'null' : Array.isArray(data) ? 'array' : typeof data });
-                return { valid: false, errors };
-            }
-            const record = data;
-            if (typeof record['id'] !== 'string' || record['id'].length === 0) {
-                errors.push({ path: 'id', message: "Field 'id' must be a non-empty string", expected: 'non-empty string', actual: typeof record['id'] });
-            }
-            if (typeof record['type'] !== 'string' || record['type'].length === 0) {
-                errors.push({ path: 'type', message: "Field 'type' must be a non-empty string", expected: 'non-empty string', actual: typeof record['type'] });
-            }
-            if (typeof record['status'] !== 'string' || record['status'].length === 0) {
-                errors.push({ path: 'status', message: "Field 'status' must be a non-empty string", expected: 'non-empty string', actual: typeof record['status'] });
-            }
-            return { valid: errors.length === 0, errors, version: SCHEMA_VERSIONS.taskRecord };
-        },
-        migrate: (data, fromVersion) => registry.migrate('taskRecord', data, fromVersion),
-    });
-    return { registry, contracts };
-}

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

@@ -1,75 +0,0 @@
-/**
- * Compatibility Contracts — Migration Registry
- *
- * The MigrationRegistry holds all registered schema migration steps and
- * provides path resolution and ordered execution for any version pair.
- *
- * @module contracts/migrations
- */
-import { type MigrationStep, type MigrationResult, type SchemaVersion } from '../types.js';
-/**
- * Central registry for all schema migration steps.
- *
- * Migrations are registered per contract name and resolved as an ordered
- * chain from a given source version to the current target version.
- * All migration functions must be pure (no mutations, no side effects).
- */
-export declare class MigrationRegistry {
-    private readonly steps;
-    /**
-     * Registers a migration step for a given contract.
-     *
-     * Steps are stored in insertion order and sorted at resolution time.
-     * Duplicate from→to pairs for the same contract are not permitted.
-     *
-     * @param contract - The contract name (e.g. 'runtimeState').
-     * @param step - The migration step to register.
-     * @throws If a step with the same from→to is already registered.
-     */
-    register(contract: string, step: MigrationStep): void;
-    /**
-     * Returns true if any migration path exists from `fromVersion` toward
-     * a higher version for the given contract.
-     *
-     * @param contract - The contract name.
-     * @param fromVersion - The source schema version to migrate from.
-     */
-    canMigrate(contract: string, fromVersion: SchemaVersion): boolean;
-    /**
-     * Resolves an ordered chain of migration steps from `from` to `to`.
-     *
-     * Uses a greedy forward walk: at each version, finds the step that advances
-     * closest to the target. Throws if no complete path exists.
-     *
-     * @param contract - The contract name.
-     * @param from - The starting schema version.
-     * @param to - The target schema version.
-     * @returns Ordered array of MigrationSteps forming the complete path.
-     * @throws If no migration path exists between the two versions.
-     */
-    getMigrationPath(contract: string, from: SchemaVersion, to: SchemaVersion): MigrationStep[];
-    /**
-     * Migrates data from `fromVersion` to the latest version reachable via
-     * registered steps for the given contract.
-     *
-     * If `fromVersion` already matches the end of the migration chain,
-     * the data is returned as-is without transformation.
-     *
-     * @param contract - The contract name.
-     * @param data - The raw data to migrate.
-     * @param fromVersion - The schema version of the incoming data.
-     * @returns The migrated data and the version it was migrated to.
-     * @throws If the migration path is incomplete or a step throws.
-     */
-    migrate(contract: string, data: unknown, fromVersion: SchemaVersion): MigrationResult;
-    /**
-     * Resolves the highest version reachable from `fromVersion` by following
-     * the chain of registered steps.
-     */
-    private _resolveLatestVersion;
-    /**
-     * Returns all registered contract names.
-     */
-    contractNames(): string[];
-}
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/contracts/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,EAInB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAE5D;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAiBrD;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,GAAG,OAAO;IAKjE;;;;;;;;;;;OAWG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,aAAa,EACnB,EAAE,EAAE,aAAa,GAChB,aAAa,EAAE;IAqDlB;;;;;;;;;;;;OAYG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,aAAa,GACzB,eAAe;IAiBlB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;CAG1B"}

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

@@ -1,158 +0,0 @@
-/**
- * Compatibility Contracts — Migration Registry
- *
- * The MigrationRegistry holds all registered schema migration steps and
- * provides path resolution and ordered execution for any version pair.
- *
- * @module contracts/migrations
- */
-import { compareVersions, versionsEqual, versionToString, } from '../types.js';
-/**
- * Central registry for all schema migration steps.
- *
- * Migrations are registered per contract name and resolved as an ordered
- * chain from a given source version to the current target version.
- * All migration functions must be pure (no mutations, no side effects).
- */
-export class MigrationRegistry {
-    steps = new Map();
-    /**
-     * Registers a migration step for a given contract.
-     *
-     * Steps are stored in insertion order and sorted at resolution time.
-     * Duplicate from→to pairs for the same contract are not permitted.
-     *
-     * @param contract - The contract name (e.g. 'runtimeState').
-     * @param step - The migration step to register.
-     * @throws If a step with the same from→to is already registered.
-     */
-    register(contract, step) {
-        if (!this.steps.has(contract)) {
-            this.steps.set(contract, []);
-        }
-        const existing = this.steps.get(contract);
-        const duplicate = existing.find((s) => versionsEqual(s.from, step.from) && versionsEqual(s.to, step.to));
-        if (duplicate) {
-            throw new Error(`Duplicate migration step for contract '${contract}': ` +
-                `${versionToString(step.from)} → ${versionToString(step.to)}`);
-        }
-        existing.push(step);
-    }
-    /**
-     * Returns true if any migration path exists from `fromVersion` toward
-     * a higher version for the given contract.
-     *
-     * @param contract - The contract name.
-     * @param fromVersion - The source schema version to migrate from.
-     */
-    canMigrate(contract, fromVersion) {
-        const steps = this.steps.get(contract) ?? [];
-        return steps.some((s) => versionsEqual(s.from, fromVersion));
-    }
-    /**
-     * Resolves an ordered chain of migration steps from `from` to `to`.
-     *
-     * Uses a greedy forward walk: at each version, finds the step that advances
-     * closest to the target. Throws if no complete path exists.
-     *
-     * @param contract - The contract name.
-     * @param from - The starting schema version.
-     * @param to - The target schema version.
-     * @returns Ordered array of MigrationSteps forming the complete path.
-     * @throws If no migration path exists between the two versions.
-     */
-    getMigrationPath(contract, from, to) {
-        if (versionsEqual(from, to))
-            return [];
-        if (compareVersions(from, to) > 0) {
-            throw new Error(`Downgrade migration is not supported for contract '${contract}': ` +
-                `cannot migrate from ${versionToString(from)} to ${versionToString(to)}`);
-        }
-        const allSteps = this.steps.get(contract) ?? [];
-        const path = [];
-        let current = from;
-        while (!versionsEqual(current, to)) {
-            // Find all steps that start from the current version
-            const candidates = allSteps.filter((s) => versionsEqual(s.from, current));
-            if (candidates.length === 0) {
-                throw new Error(`No migration step found for contract '${contract}' ` +
-                    `at version ${versionToString(current)} (target: ${versionToString(to)})`);
-            }
-            // Pick the step that advances closest to the target without overshooting
-            const step = candidates.reduce((best, candidate) => {
-                const cmpBest = compareVersions(best.to, to);
-                const cmpCandidate = compareVersions(candidate.to, to);
-                // Prefer steps that don't overshoot; among those, prefer the one closest to target
-                if (cmpBest > 0 && cmpCandidate <= 0)
-                    return candidate;
-                if (cmpCandidate > 0 && cmpBest <= 0)
-                    return best;
-                return compareVersions(candidate.to, best.to) > 0 ? candidate : best;
-            });
-            if (compareVersions(step.to, current) <= 0) {
-                throw new Error(`Migration step for contract '${contract}' does not advance version: ` +
-                    `${versionToString(step.from)} → ${versionToString(step.to)}`);
-            }
-            path.push(step);
-            current = step.to;
-            if (path.length > 100) {
-                throw new Error(`Migration path for contract '${contract}' exceeded 100 steps — possible cycle detected`);
-            }
-        }
-        return path;
-    }
-    /**
-     * Migrates data from `fromVersion` to the latest version reachable via
-     * registered steps for the given contract.
-     *
-     * If `fromVersion` already matches the end of the migration chain,
-     * the data is returned as-is without transformation.
-     *
-     * @param contract - The contract name.
-     * @param data - The raw data to migrate.
-     * @param fromVersion - The schema version of the incoming data.
-     * @returns The migrated data and the version it was migrated to.
-     * @throws If the migration path is incomplete or a step throws.
-     */
-    migrate(contract, data, fromVersion) {
-        // Find the highest reachable version from this starting point
-        const targetVersion = this._resolveLatestVersion(contract, fromVersion);
-        if (versionsEqual(fromVersion, targetVersion)) {
-            return { data, version: fromVersion };
-        }
-        const path = this.getMigrationPath(contract, fromVersion, targetVersion);
-        let current = data;
-        for (const step of path) {
-            current = step.migrate(current);
-        }
-        return { data: current, version: targetVersion };
-    }
-    /**
-     * Resolves the highest version reachable from `fromVersion` by following
-     * the chain of registered steps.
-     */
-    _resolveLatestVersion(contract, fromVersion) {
-        const allSteps = this.steps.get(contract) ?? [];
-        let current = fromVersion;
-        const visited = new Set();
-        while (true) {
-            const key = versionToString(current);
-            if (visited.has(key))
-                break;
-            visited.add(key);
-            const next = allSteps
-                .filter((s) => versionsEqual(s.from, current))
-                .sort((a, b) => compareVersions(b.to, a.to))[0];
-            if (!next)
-                break;
-            current = next.to;
-        }
-        return current;
-    }
-    /**
-     * Returns all registered contract names.
-     */
-    contractNames() {
-        return [...this.steps.keys()];
-    }
-}

package/dist/_internal/platform/runtime/contracts/migrations/schemas.d.ts

@@ -1,57 +0,0 @@
-/**
- * Compatibility Contracts — Consolidated Migration Schemas
- *
- * All domain migration steps in one place. Each schema section:
- *   - Declares a private `_STEPS` array (MigrationStep[])
- *   - Exports a `_VERSION` constant (re-exported from SCHEMA_VERSIONS)
- *   - Exports a `get…MigrationSteps()` function for the contract registry
- *
- * Previously split across 5 stub files; consolidated here for DRY.
- * Split back out if any individual contract accumulates > 10 migration steps.
- *
- * All migration functions must be pure — no mutations, no side effects.
- *
- * @module contracts/migrations/schemas
- */
-import type { MigrationStep } from '../types.js';
-/** The current EventEnvelope schema version (re-exported for convenience). */
-export declare const EVENT_ENVELOPE_VERSION: {
-    readonly major: 1;
-    readonly minor: 1;
-    readonly patch: 0;
-};
-/** Returns all EventEnvelope migration steps. Used by the contract registry. */
-export declare function getEventEnvelopeMigrationSteps(): MigrationStep[];
-/** The current PluginManifest schema version (re-exported for convenience). */
-export declare const PLUGIN_MANIFEST_VERSION: {
-    readonly major: 1;
-    readonly minor: 0;
-    readonly patch: 0;
-};
-/** Returns all PluginManifest migration steps. Used by the contract registry. */
-export declare function getPluginManifestMigrationSteps(): MigrationStep[];
-/** The current RuntimeState schema version (re-exported for convenience). */
-export declare const RUNTIME_STATE_VERSION: {
-    readonly major: 1;
-    readonly minor: 0;
-    readonly patch: 0;
-};
-/** Returns all RuntimeState migration steps. Used by the contract registry. */
-export declare function getRuntimeStateMigrationSteps(): MigrationStep[];
-/** The current Session schema version (re-exported for convenience). */
-export declare const SESSION_VERSION: {
-    readonly major: 1;
-    readonly minor: 0;
-    readonly patch: 0;
-};
-/** Returns all Session migration steps. Used by the contract registry. */
-export declare function getSessionMigrationSteps(): MigrationStep[];
-/** The current TaskRecord schema version (re-exported for convenience). */
-export declare const TASK_RECORD_VERSION: {
-    readonly major: 1;
-    readonly minor: 0;
-    readonly patch: 0;
-};
-/** Returns all TaskRecord migration steps. Used by the contract registry. */
-export declare function getTaskRecordMigrationSteps(): MigrationStep[];
-//# sourceMappingURL=schemas.d.ts.map

package/dist/_internal/platform/runtime/contracts/migrations/schemas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../../src/_internal/platform/runtime/contracts/migrations/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2BjD,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB;;;;CAAgC,CAAC;AAEpE,gFAAgF;AAChF,wBAAgB,8BAA8B,IAAI,aAAa,EAAE,CAEhE;AA0BD,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB;;;;CAAiC,CAAC;AAEtE,iFAAiF;AACjF,wBAAgB,+BAA+B,IAAI,aAAa,EAAE,CAEjE;AA0BD,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB;;;;CAA+B,CAAC;AAElE,+EAA+E;AAC/E,wBAAgB,6BAA6B,IAAI,aAAa,EAAE,CAE/D;AA2BD,wEAAwE;AACxE,eAAO,MAAM,eAAe;;;;CAA0B,CAAC;AAEvD,0EAA0E;AAC1E,wBAAgB,wBAAwB,IAAI,aAAa,EAAE,CAE1D;AA0BD,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB;;;;CAA6B,CAAC;AAE9D,6EAA6E;AAC7E,wBAAgB,2BAA2B,IAAI,aAAa,EAAE,CAE7D"}

package/dist/_internal/platform/runtime/contracts/migrations/schemas.js

@@ -1,157 +0,0 @@
-/**
- * Compatibility Contracts — Consolidated Migration Schemas
- *
- * All domain migration steps in one place. Each schema section:
- *   - Declares a private `_STEPS` array (MigrationStep[])
- *   - Exports a `_VERSION` constant (re-exported from SCHEMA_VERSIONS)
- *   - Exports a `get…MigrationSteps()` function for the contract registry
- *
- * Previously split across 5 stub files; consolidated here for DRY.
- * Split back out if any individual contract accumulates > 10 migration steps.
- *
- * All migration functions must be pure — no mutations, no side effects.
- *
- * @module contracts/migrations/schemas
- */
-import { SCHEMA_VERSIONS } from '../version.js';
-// ─── EventEnvelope ────────────────────────────────────────────────────────────
-/**
- * All registered EventEnvelope migration steps.
- *
- * Currently empty — the schema is at its initial version (1.0.0).
- * Future steps must be appended here and registered via the contract registry.
- *
- * Example: if `agentId` becomes required in v1.1.0, a migration step would
- * backfill it with a sentinel value for older persisted envelopes.
- */
-const EVENT_ENVELOPE_STEPS = [
-// Example structure for future use:
-// {
-//   from: { major: 1, minor: 0, patch: 0 },
-//   to: { major: 1, minor: 1, patch: 0 },
-//   description: 'Backfill missing agentId with null sentinel',
-//   migrate: (data: unknown): unknown => {
-//     const d = data as Record<string, unknown>;
-//     return { ...d, agentId: d['agentId'] ?? null };
-//   },
-// },
-];
-/** The current EventEnvelope schema version (re-exported for convenience). */
-export const EVENT_ENVELOPE_VERSION = SCHEMA_VERSIONS.eventEnvelope;
-/** Returns all EventEnvelope migration steps. Used by the contract registry. */
-export function getEventEnvelopeMigrationSteps() {
-    return EVENT_ENVELOPE_STEPS;
-}
-// ─── PluginManifest ───────────────────────────────────────────────────────────
-/**
- * All registered PluginManifest migration steps.
- *
- * Currently empty — the schema is at its initial version (1.0.0).
- * Future steps must be appended here and registered via the contract registry.
- *
- * Example: if `capabilities` becomes an explicit array in v1.1.0, a migration
- * step would synthesize it from `registerCommand`/`registerTool` declarations.
- */
-const PLUGIN_MANIFEST_STEPS = [
-// Example structure for future use:
-// {
-//   from: { major: 1, minor: 0, patch: 0 },
-//   to: { major: 1, minor: 1, patch: 0 },
-//   description: 'Add capabilities array to plugin manifest',
-//   migrate: (data: unknown): unknown => {
-//     const d = data as Record<string, unknown>;
-//     return { ...d, capabilities: d['capabilities'] ?? [] };
-//   },
-// },
-];
-/** The current PluginManifest schema version (re-exported for convenience). */
-export const PLUGIN_MANIFEST_VERSION = SCHEMA_VERSIONS.pluginManifest;
-/** Returns all PluginManifest migration steps. Used by the contract registry. */
-export function getPluginManifestMigrationSteps() {
-    return PLUGIN_MANIFEST_STEPS;
-}
-// ─── RuntimeState ─────────────────────────────────────────────────────────────
-/**
- * All registered RuntimeState migration steps.
- *
- * Currently empty — the schema is at its initial version (1.0.0).
- * Future steps must be appended here and registered via the contract registry.
- *
- * Example: if `uiSettings` is added in v1.1.0, a step would backfill it with
- * default values for existing persisted snapshots.
- */
-const RUNTIME_STATE_STEPS = [
-// Example structure for future use:
-// {
-//   from: { major: 1, minor: 0, patch: 0 },
-//   to: { major: 1, minor: 1, patch: 0 },
-//   description: 'Add optional uiSettings field with defaults',
-//   migrate: (data: unknown): unknown => {
-//     const d = data as Record<string, unknown>;
-//     return { ...d, uiSettings: d['uiSettings'] ?? { theme: 'dark' } };
-//   },
-// },
-];
-/** The current RuntimeState schema version (re-exported for convenience). */
-export const RUNTIME_STATE_VERSION = SCHEMA_VERSIONS.runtimeState;
-/** Returns all RuntimeState migration steps. Used by the contract registry. */
-export function getRuntimeStateMigrationSteps() {
-    return RUNTIME_STATE_STEPS;
-}
-// ─── Session ──────────────────────────────────────────────────────────────────
-/**
- * All registered Session migration steps.
- *
- * Currently empty — the schema is at its initial version (1.0.0).
- * Future steps must be appended here and registered via the contract registry.
- *
- * Example: if session files gain a `tags` array in v1.1.0, a migration step
- * would backfill it as an empty array for existing sessions.
- */
-const SESSION_STEPS = [
-// Example structure for future use:
-// {
-//   from: { major: 1, minor: 0, patch: 0 },
-//   to: { major: 1, minor: 1, patch: 0 },
-//   description: 'Add empty tags array to session meta',
-//   migrate: (data: unknown): unknown => {
-//     const d = data as Record<string, unknown>;
-//     const meta = d['meta'] as Record<string, unknown>;
-//     return { ...d, meta: { ...meta, tags: meta['tags'] ?? [] } };
-//   },
-// },
-];
-/** The current Session schema version (re-exported for convenience). */
-export const SESSION_VERSION = SCHEMA_VERSIONS.session;
-/** Returns all Session migration steps. Used by the contract registry. */
-export function getSessionMigrationSteps() {
-    return SESSION_STEPS;
-}
-// ─── TaskRecord ───────────────────────────────────────────────────────────────
-/**
- * All registered TaskRecord migration steps.
- *
- * Currently empty — the schema is at its initial version (1.0.0).
- * Future steps must be appended here and registered via the contract registry.
- *
- * Example: if `metadata` map is added to RuntimeTask in v1.1.0, a migration
- * step would backfill it as an empty object for existing persisted records.
- */
-const TASK_RECORD_STEPS = [
-// Example structure for future use:
-// {
-//   from: { major: 1, minor: 0, patch: 0 },
-//   to: { major: 1, minor: 1, patch: 0 },
-//   description: 'Add metadata object to task records',
-//   migrate: (data: unknown): unknown => {
-//     const d = data as Record<string, unknown>;
-//     return { ...d, metadata: d['metadata'] ?? {} };
-//   },
-// },
-];
-/** The current TaskRecord schema version (re-exported for convenience). */
-export const TASK_RECORD_VERSION = SCHEMA_VERSIONS.taskRecord;
-/** Returns all TaskRecord migration steps. Used by the contract registry. */
-export function getTaskRecordMigrationSteps() {
-    return TASK_RECORD_STEPS;
-}