@amalgm/core 0.1.0 → 0.1.1

package/PURPOSE.md

@@ -72,6 +72,12 @@ source until each module is cut over.
 10. **Amalgm's own surfaces use this SDK.** A private shortcut in the CLI,
     gateway, or runtime means the SDK is incomplete — fix the SDK, not the
     caller.
+11. **The local rail is ordered truth, not durable history.** Every published
+    state event receives one monotonic sequence, reconnects replay only a
+    bounded retained tail, and a missing tail requires a fresh snapshot.
+12. **A snapshot names its resume point.** Resource readers share one
+    per-attempt context and a snapshot is stable only when its sequence is
+    unchanged across the read; a racing write causes a complete retry.
 
 ## Five surfaces, one behavior
 

package/dist/transport/index.d.ts

@@ -16,6 +16,7 @@
 export * from './auth.js';
 export * from './routing.js';
 export * from './shipped-routes.js';
+export * from './state/index.js';
 export * from './admission.js';
 export * from './ingress.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/transport/index.js

@@ -16,6 +16,7 @@
 export * from './auth.js';
 export * from './routing.js';
 export * from './shipped-routes.js';
+export * from './state/index.js';
 export * from './admission.js';
 export * from './ingress.js';
 //# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/transport/state/api.d.ts

@@ -0,0 +1,3 @@
+import { StateRail } from './rail.js';
+export declare function createStateApi(rail: StateRail): (request: Request) => Promise<Response>;
+//# sourceMappingURL=api.d.ts.map

package/dist/transport/state/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/transport/state/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAKtC,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAqBvF"}

package/dist/transport/state/api.js

@@ -0,0 +1,106 @@
+import { StateRail } from './rail.js';
+const JSON_HEADERS = { 'content-type': 'application/json', 'cache-control': 'no-store' };
+const encoder = new TextEncoder();
+export function createStateApi(rail) {
+    return async (request) => {
+        const url = new URL(request.url);
+        if (request.method === 'GET' && url.pathname === '/state') {
+            return json(200, { service: 'state', seq: rail.currentSeq(), resources: rail.resources.names() });
+        }
+        if (request.method === 'GET' && url.pathname === '/state/resources') {
+            return json(200, { resources: rail.resources.names(), defaults: rail.resources.defaults() });
+        }
+        if (request.method === 'GET' && url.pathname === '/state/snapshot') {
+            return json(200, await rail.snapshot(url.searchParams.get('resources') ?? undefined));
+        }
+        if (request.method === 'GET' && url.pathname === '/state/events') {
+            const result = rail.eventsAfter(url.searchParams.get('after'), url.searchParams.get('limit'));
+            return json(result.reset ? 409 : 200, result);
+        }
+        if (request.method === 'GET' && url.pathname === '/state/stream') {
+            return stateStream(rail, request, url.searchParams);
+        }
+        return json(404, { error: 'not found' });
+    };
+}
+function json(status, body) {
+    return new Response(JSON.stringify(body), { status, headers: JSON_HEADERS });
+}
+function stateStream(rail, request, query) {
+    let unsubscribe = () => { };
+    const body = new ReadableStream({
+        start(controller) {
+            let open = true;
+            let held = query.get('bootstrap') === '1' ? [] : null;
+            const send = (text) => {
+                if (open)
+                    controller.enqueue(encoder.encode(text));
+            };
+            const close = () => {
+                if (!open)
+                    return;
+                open = false;
+                unsubscribe();
+                controller.close();
+            };
+            const eventFrame = (event) => `id: ${event.seq}\nevent: state\ndata: ${JSON.stringify(event)}\n\n`;
+            send(': local-live-store connected\n\n');
+            let floor = Math.max(0, Number(query.get('after')) || 0);
+            unsubscribe = rail.subscribe((event) => {
+                if (held)
+                    held.push(event);
+                else if (event.seq > floor)
+                    send(eventFrame(event));
+            });
+            request.signal.addEventListener('abort', close, { once: true });
+            void (async () => {
+                if (held) {
+                    try {
+                        const snapshot = await rail.snapshot(query.get('resources') ?? undefined);
+                        floor = snapshot.seq;
+                        send(`event: snapshot\ndata: ${JSON.stringify(snapshot)}\n\n`);
+                        const buffered = held;
+                        held = null;
+                        for (const event of buffered)
+                            if (event.seq > floor)
+                                send(eventFrame(event));
+                    }
+                    catch (error) {
+                        send(`event: error\ndata: ${JSON.stringify({
+                            status: 500,
+                            error: error instanceof Error ? error.message : 'internal error',
+                        })}\n\n`);
+                        close();
+                    }
+                    return;
+                }
+                const replay = rail.eventsAfter(floor, 1001);
+                if (replay.reset || replay.events.length > 1000) {
+                    send(`event: reset\ndata: ${JSON.stringify(replay.reset ? replay : {
+                        code: 'state_replay_too_large',
+                        message: 'Too many missed events to replay; fetch a fresh snapshot.',
+                        after: floor,
+                        reset: true,
+                    })}\n\n`);
+                    close();
+                    return;
+                }
+                for (const event of replay.events)
+                    send(eventFrame(event));
+            })();
+        },
+        cancel() {
+            unsubscribe();
+        },
+    });
+    return new Response(body, {
+        status: 200,
+        headers: {
+            'content-type': 'text/event-stream; charset=utf-8',
+            'cache-control': 'no-cache, no-transform',
+            connection: 'keep-alive',
+            'x-accel-buffering': 'no',
+        },
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/transport/state/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/transport/state/api.ts"],"names":[],"mappings":"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"}

package/dist/transport/state/index.d.ts

@@ -0,0 +1,7 @@
+export { createStateApi } from './api.js';
+export { MemoryStateEventStore } from './memory-store.js';
+export { StateRail } from './rail.js';
+export type { StateRailOptions } from './rail.js';
+export { StateResourceRegistry } from './registry.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,mBAAmB,YAAY,CAAC"}

package/dist/transport/state/index.js

@@ -0,0 +1,5 @@
+export { createStateApi } from './api.js';
+export { MemoryStateEventStore } from './memory-store.js';
+export { StateRail } from './rail.js';
+export { StateResourceRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/transport/state/memory-store.d.ts

@@ -0,0 +1,16 @@
+import type { StateEvent, StateEventInput, StateEventStore } from './types.js';
+/** A bounded host adapter useful for embedded runtimes and tests. */
+export declare class MemoryStateEventStore implements StateEventStore {
+    #private;
+    constructor(options?: {
+        maxEvents?: number;
+    });
+    currentSeq(): number;
+    append(input: StateEventInput, ts: string): StateEvent;
+    listAfter(after: number, limit: number): readonly StateEvent[];
+    bounds(): {
+        minSeq: number;
+        maxSeq: number;
+    };
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/transport/state/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../src/transport/state/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/E,qEAAqE;AACrE,qBAAa,qBAAsB,YAAW,eAAe;;gBAK/C,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAIhD,UAAU,IAAI,MAAM;IAIpB,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU;IAStD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE;IAI9D,MAAM,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAM7C"}

package/dist/transport/state/memory-store.js

@@ -0,0 +1,30 @@
+/** A bounded host adapter useful for embedded runtimes and tests. */
+export class MemoryStateEventStore {
+    #events = [];
+    #maxEvents;
+    #seq = 0;
+    constructor(options = {}) {
+        this.#maxEvents = Math.max(1, Math.floor(options.maxEvents ?? 5000));
+    }
+    currentSeq() {
+        return this.#seq;
+    }
+    append(input, ts) {
+        const event = { seq: ++this.#seq, ts, ...input };
+        this.#events.push(event);
+        if (this.#events.length > this.#maxEvents) {
+            this.#events.splice(0, this.#events.length - this.#maxEvents);
+        }
+        return event;
+    }
+    listAfter(after, limit) {
+        return this.#events.filter((event) => event.seq > after).slice(0, limit);
+    }
+    bounds() {
+        return {
+            minSeq: this.#events[0]?.seq ?? 0,
+            maxSeq: this.#events.at(-1)?.seq ?? 0,
+        };
+    }
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/transport/state/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../../../src/transport/state/memory-store.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,OAAO,qBAAqB;IACvB,OAAO,GAAiB,EAAE,CAAC;IAC3B,UAAU,CAAS;IAC5B,IAAI,GAAG,CAAC,CAAC;IAET,YAAY,UAAkC,EAAE;QAC9C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,KAAsB,EAAE,EAAU;QACvC,MAAM,KAAK,GAAe,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,CAAC,KAAa,EAAE,KAAa;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM;QACJ,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;YACjC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;SACtC,CAAC;IACJ,CAAC;CACF"}

package/dist/transport/state/rail.d.ts

@@ -0,0 +1,27 @@
+import { StateResourceRegistry } from './registry.js';
+import type { StateEvent, StateEventInput, StateEventStore, StateResourceSpec, StateSnapshot } from './types.js';
+export interface StateRailOptions {
+    readonly store: StateEventStore;
+    readonly now?: () => Date;
+}
+export declare class StateRail {
+    #private;
+    readonly resources: StateResourceRegistry;
+    constructor(options: StateRailOptions);
+    currentSeq(): number;
+    registerResource(name: string, spec: StateResourceSpec): void;
+    registerResourcePrefix(prefix: string, spec: StateResourceSpec): void;
+    append(input: StateEventInput): StateEvent;
+    eventsAfter(afterInput: unknown, limitInput?: unknown): {
+        readonly events: readonly StateEvent[];
+        readonly seq: number;
+        readonly reset?: true;
+        readonly code?: 'state_event_gap';
+        readonly message?: string;
+        readonly minSeq?: number;
+        readonly maxSeq?: number;
+    };
+    snapshot(resourcesInput?: string | readonly string[]): Promise<StateSnapshot>;
+    subscribe(listener: (event: StateEvent) => void): () => void;
+}
+//# sourceMappingURL=rail.d.ts.map

package/dist/transport/state/rail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rail.d.ts","sourceRoot":"","sources":["../../../src/transport/state/rail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,qBAAa,SAAS;;IACpB,QAAQ,CAAC,SAAS,wBAA+B;gBAKrC,OAAO,EAAE,gBAAgB;IAKrC,UAAU,IAAI,MAAM;IAIpB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAI7D,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAIrE,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU;IAS1C,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,GAAE,OAAc,GAAG;QAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;QACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;QAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B;IAeK,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBnF,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;CAI7D"}

package/dist/transport/state/rail.js

@@ -0,0 +1,79 @@
+import { StateResourceRegistry } from './registry.js';
+export class StateRail {
+    resources = new StateResourceRegistry();
+    #store;
+    #now;
+    #listeners = new Set();
+    constructor(options) {
+        this.#store = options.store;
+        this.#now = options.now ?? (() => new Date());
+    }
+    currentSeq() {
+        return this.#store.currentSeq();
+    }
+    registerResource(name, spec) {
+        this.resources.register(name, spec);
+    }
+    registerResourcePrefix(prefix, spec) {
+        this.resources.registerPrefix(prefix, spec);
+    }
+    append(input) {
+        if (!input || typeof input.resource !== 'string' || typeof input.op !== 'string') {
+            throw new Error('state event requires resource and op');
+        }
+        const event = this.#store.append(input, this.#now().toISOString());
+        for (const listener of this.#listeners)
+            listener(event);
+        return event;
+    }
+    eventsAfter(afterInput, limitInput = 1000) {
+        const after = nonNegativeInteger(afterInput, 0);
+        const limit = Math.min(nonNegativeInteger(limitInput, 1000), 5000);
+        const { minSeq, maxSeq } = this.#store.bounds();
+        if (after > 0 && minSeq > after + 1) {
+            return {
+                events: [], seq: after, reset: true, code: 'state_event_gap',
+                message: 'State event history has been compacted; fetch a fresh snapshot.',
+                minSeq, maxSeq,
+            };
+        }
+        const events = this.#store.listAfter(after, Math.max(1, limit));
+        return { events, seq: events.at(-1)?.seq ?? after };
+    }
+    async snapshot(resourcesInput) {
+        const resources = normalizeResources(resourcesInput, this.resources.defaults());
+        let last = null;
+        for (let attempt = 0; attempt < 3; attempt += 1) {
+            const before = this.currentSeq();
+            const context = {};
+            const data = {};
+            for (const resource of resources) {
+                const spec = this.resources.spec(resource);
+                if (!spec)
+                    continue;
+                const value = await spec.read(context, resource);
+                if (value !== undefined)
+                    data[resource] = value;
+            }
+            const after = this.currentSeq();
+            if (before === after)
+                return { seq: after, stable: true, resources: data };
+            last = { seq: before, stable: false, resources: data };
+        }
+        return last;
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+}
+function nonNegativeInteger(value, fallback) {
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed >= 0 ? parsed : fallback;
+}
+function normalizeResources(input, defaults) {
+    const values = Array.isArray(input) ? input : input ? String(input).split(',') : defaults;
+    const clean = values.map((value) => String(value ?? '').trim()).filter(Boolean);
+    return clean.length > 0 ? [...new Set(clean)] : defaults;
+}
+//# sourceMappingURL=rail.js.map

package/dist/transport/state/rail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rail.js","sourceRoot":"","sources":["../../../src/transport/state/rail.ts"],"names":[],"mappings":"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"}

package/dist/transport/state/registry.d.ts

@@ -0,0 +1,11 @@
+import type { StateResourceSpec } from './types.js';
+export declare class StateResourceRegistry {
+    #private;
+    register(name: string, spec: StateResourceSpec): void;
+    registerPrefix(prefix: string, spec: StateResourceSpec): void;
+    unregister(name: string): boolean;
+    spec(name: string): Required<StateResourceSpec> | undefined;
+    names(): string[];
+    defaults(): string[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/transport/state/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/transport/state/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,qBAAa,qBAAqB;;IAIhC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAMrD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAM7D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,iBAAiB,CAAC,GAAG,SAAS;IAS3D,KAAK,IAAI,MAAM,EAAE;IAIjB,QAAQ,IAAI,MAAM,EAAE;CAcrB"}

package/dist/transport/state/registry.js

@@ -0,0 +1,46 @@
+export class StateResourceRegistry {
+    #resources = new Map();
+    #prefixes = new Map();
+    register(name, spec) {
+        this.#assert(name, spec);
+        if (this.#resources.has(name))
+            throw new Error(`resource "${name}" is already registered`);
+        this.#resources.set(name, { snapshotDefault: false, ...spec });
+    }
+    registerPrefix(prefix, spec) {
+        this.#assert(prefix, spec);
+        if (this.#prefixes.has(prefix))
+            throw new Error(`resource prefix "${prefix}" is already registered`);
+        this.#prefixes.set(prefix, { snapshotDefault: false, ...spec });
+    }
+    unregister(name) {
+        return this.#resources.delete(name);
+    }
+    spec(name) {
+        const direct = this.#resources.get(name);
+        if (direct)
+            return direct;
+        for (const [prefix, spec] of this.#prefixes) {
+            if (name.startsWith(prefix))
+                return spec;
+        }
+        return undefined;
+    }
+    names() {
+        return [...this.#resources.keys()];
+    }
+    defaults() {
+        return [...this.#resources]
+            .filter(([, spec]) => spec.snapshotDefault)
+            .map(([name]) => name);
+    }
+    #assert(name, spec) {
+        if (!name || typeof name !== 'string') {
+            throw new Error('registerResource requires a non-empty string name');
+        }
+        if (!spec || typeof spec.read !== 'function') {
+            throw new Error(`resource "${name}" requires a read() function`);
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/transport/state/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/transport/state/registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAqB;IACvB,UAAU,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC5D,SAAS,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEpE,QAAQ,CAAC,IAAY,EAAE,IAAuB;QAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,yBAAyB,CAAC,CAAC;QAC3F,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,cAAc,CAAC,MAAc,EAAE,IAAuB;QACpD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,yBAAyB,CAAC,CAAC;QACrG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,IAAY;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC3C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;aACxB,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,IAAY,EAAE,IAAuB;QAC3C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,8BAA8B,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF"}

package/dist/transport/state/types.d.ts

@@ -0,0 +1,37 @@
+/** Engine reference: runtime/scripts/amalgm-mcp/state/{events,registry,snapshot}.js. */
+export interface StateEventInput {
+    readonly resource: string;
+    readonly op: string;
+    readonly id?: string;
+    readonly value?: unknown;
+    readonly patch?: unknown;
+    readonly clientMutationId?: string;
+    readonly mutationId?: string;
+    readonly sharedResourceId?: string;
+    readonly source?: string;
+    readonly version?: number;
+}
+export interface StateEvent extends StateEventInput {
+    readonly seq: number;
+    readonly ts: string;
+}
+export interface StateEventStore {
+    currentSeq(): number;
+    append(input: StateEventInput, ts: string): StateEvent;
+    listAfter(after: number, limit: number): readonly StateEvent[];
+    bounds(): {
+        readonly minSeq: number;
+        readonly maxSeq: number;
+    };
+}
+export type StateResourceReader = (context: Record<string, unknown>, resource: string) => unknown | Promise<unknown>;
+export interface StateResourceSpec {
+    readonly read: StateResourceReader;
+    readonly snapshotDefault?: boolean;
+}
+export interface StateSnapshot {
+    readonly seq: number;
+    readonly stable: boolean;
+    readonly resources: Readonly<Record<string, unknown>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/state/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/transport/state/types.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,IAAI,MAAM,CAAC;IACrB,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC;IACvD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAAC;IAC/D,MAAM,IAAI;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,KACb,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD"}

package/dist/transport/state/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/transport/state/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "The Amalgm kernel SDK — identity, transport, supervision, and host capability contracts behind host-injected adapters.",
   "type": "module",
   "license": "UNLICENSED",
@@ -24,6 +24,10 @@
       "types": "./dist/transport/index.d.ts",
       "default": "./dist/transport/index.js"
     },
+    "./state": {
+      "types": "./dist/transport/state/index.d.ts",
+      "default": "./dist/transport/state/index.js"
+    },
     "./supervision": {
       "types": "./dist/supervision/index.d.ts",
       "default": "./dist/supervision/index.js"