@pellux/goodvibes-sdk 0.25.1 → 0.25.2

package/dist/_internal/daemon/telemetry-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-routes.d.ts","sourceRoot":"","sources":["../../../src/_internal/daemon/telemetry-routes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telemetry-routes.d.ts","sourceRoot":"","sources":["../../../src/_internal/daemon/telemetry-routes.ts"],"names":[],"mappings":"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"}

package/dist/_internal/daemon/telemetry-routes.js

@@ -1,4 +1,5 @@
 import { buildMissingScopeBody } from './http-policy.js';
+import { decodeOtlpProtobuf } from './otlp-protobuf.js';
 import { DaemonErrorCategory } from '../errors/index.js';
 function parseNumber(value) {
     if (value === null || value.trim().length === 0)
@@ -45,10 +46,9 @@ function buildFilter(url) {
 // ---------------------------------------------------------------------------
 /** Max ingest payload (4 MiB) — reject larger bodies with 413 */
 const OTLP_INGEST_MAX_BODY_BYTES = 4 * 1024 * 1024;
-/** Accepted content-types for OTLP/HTTP — JSON only; protobuf returns 415 */
-const OTLP_ACCEPTED_CONTENT_TYPES = [
-    'application/json',
-];
+/** Accepted content-types for OTLP/HTTP ingest. */
+const OTLP_JSON_CONTENT_TYPE = 'application/json';
+const OTLP_PROTOBUF_CONTENT_TYPES = new Set(['application/x-protobuf', 'application/protobuf']);
 const OTLP_PARTIAL_SUCCESS_KEYS = {
     logs: 'partialSuccess',
     traces: 'partialSuccess',
@@ -58,18 +58,19 @@ const OTLP_PARTIAL_SUCCESS_KEYS = {
  * Validate and parse an OTLP HTTP ingest request body.
  * Returns a parsed JSON Record on success, or a Response (error) on failure.
  *
- * Protocol: OTLP/HTTP spec §4.2 — only application/json is accepted in this
- * release. application/x-protobuf returns 415; protobuf decoding is planned
- * for a future release.
+ * Protocol: OTLP/HTTP spec §4.2 — supports JSON and binary protobuf service
+ * requests for logs, traces, and metrics.
  */
-async function parseOtlpBody(req) {
+async function parseOtlpBody(req, kind) {
     const contentType = (req.headers.get('content-type') ?? '').toLowerCase().split(';')[0].trim();
-    if (!OTLP_ACCEPTED_CONTENT_TYPES.some((ct) => contentType === ct)) {
+    const acceptsJson = contentType === OTLP_JSON_CONTENT_TYPE;
+    const acceptsProtobuf = OTLP_PROTOBUF_CONTENT_TYPES.has(contentType);
+    if (!acceptsJson && !acceptsProtobuf) {
         return Response.json({
             error: `Unsupported Content-Type '${contentType}' for OTLP ingest`,
             code: 'UNSUPPORTED_MEDIA_TYPE',
             category: DaemonErrorCategory.BAD_REQUEST,
-            hint: `Use 'application/json'. Protobuf decoding is not implemented in this release — planned for a future release.`,
+            hint: `Use '${OTLP_JSON_CONTENT_TYPE}' or 'application/x-protobuf'.`,
         }, { status: 415 });
     }
     const raw = await req.arrayBuffer();
@@ -80,6 +81,14 @@ async function parseOtlpBody(req) {
             category: DaemonErrorCategory.BAD_REQUEST,
         }, { status: 413 });
     }
+    if (acceptsProtobuf) {
+        try {
+            return decodeOtlpProtobuf(kind, new Uint8Array(raw));
+        }
+        catch {
+            return Response.json({ error: 'OTLP ingest body is not valid protobuf', code: 'INVALID_PAYLOAD', category: DaemonErrorCategory.BAD_REQUEST }, { status: 400 });
+        }
+    }
     try {
         const text = new TextDecoder().decode(raw);
         const parsed = JSON.parse(text);
@@ -289,7 +298,7 @@ export function createDaemonTelemetryRouteHandlers(context) {
             if (!auth) {
                 return Response.json({ error: 'Authentication required for OTLP ingest', code: 'AUTH_REQUIRED', category: DaemonErrorCategory.AUTHENTICATION, status: 401 }, { status: 401 });
             }
-            const bodyOrErr = await parseOtlpBody(req);
+            const bodyOrErr = await parseOtlpBody(req, 'logs');
             if (bodyOrErr instanceof Response)
                 return bodyOrErr;
             context.ingestSink?.ingestLogs(bodyOrErr);
@@ -300,7 +309,7 @@ export function createDaemonTelemetryRouteHandlers(context) {
             if (!auth) {
                 return Response.json({ error: 'Authentication required for OTLP ingest', code: 'AUTH_REQUIRED', category: DaemonErrorCategory.AUTHENTICATION, status: 401 }, { status: 401 });
             }
-            const bodyOrErr = await parseOtlpBody(req);
+            const bodyOrErr = await parseOtlpBody(req, 'traces');
             if (bodyOrErr instanceof Response)
                 return bodyOrErr;
             context.ingestSink?.ingestTraces(bodyOrErr);
@@ -311,7 +320,7 @@ export function createDaemonTelemetryRouteHandlers(context) {
             if (!auth) {
                 return Response.json({ error: 'Authentication required for OTLP ingest', code: 'AUTH_REQUIRED', category: DaemonErrorCategory.AUTHENTICATION, status: 401 }, { status: 401 });
             }
-            const bodyOrErr = await parseOtlpBody(req);
+            const bodyOrErr = await parseOtlpBody(req, 'metrics');
             if (bodyOrErr instanceof Response)
                 return bodyOrErr;
             context.ingestSink?.ingestMetrics(bodyOrErr);

package/dist/_internal/platform/version.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.25.1';
+let version = '0.25.2';
 try {
     const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', '..', 'package.json'), 'utf-8'));
     version = pkg.version ?? version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-sdk",
-  "version": "0.25.1",
+  "version": "0.25.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mgd34msu/goodvibes-sdk.git"

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

@@ -1,40 +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 type { SchemaContract } from './types.js';
-import type { ContractName } from './version.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 declare function createContractRegistry(): {
-    registry: MigrationRegistry;
-    contracts: Map<ContractName, SchemaContract>;
-};
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAYjD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;CAC9C,CAsGA"}

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"}