@sadhaka/loom-engine 0.10.0

package/dist/director/mock-director-bridge.d.ts

@@ -0,0 +1,18 @@
+import type { DirectorEvent } from './event-envelope.js';
+import { type IDirectorBridge, type DirectorBridgeStatus, type DirectorBridgeStats } from './director-bridge.js';
+export declare class MockDirectorBridge implements IDirectorBridge {
+    private queue;
+    private statusValue;
+    private statsValue;
+    start(): void;
+    stop(): void;
+    status(): DirectorBridgeStatus;
+    isConnected(): boolean;
+    getLastEventId(): number;
+    pollEvents(): DirectorEvent[];
+    stats(): Readonly<DirectorBridgeStats>;
+    enqueue(event: DirectorEvent): void;
+    enqueueAll(events: ReadonlyArray<DirectorEvent>): void;
+    pending(): number;
+}
+//# sourceMappingURL=mock-director-bridge.d.ts.map

package/dist/director/mock-director-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-director-bridge.d.ts","sourceRoot":"","sources":["../../src/director/mock-director-bridge.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,UAAU,CAOhB;IAEF,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,MAAM,IAAI,oBAAoB;IAI9B,WAAW,IAAI,OAAO;IAItB,cAAc,IAAI,MAAM;IAIxB,UAAU,IAAI,aAAa,EAAE;IAO7B,KAAK,IAAI,QAAQ,CAAC,mBAAmB,CAAC;IAStC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAWnC,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,IAAI;IAQtD,OAAO,IAAI,MAAM;CAGlB"}

package/dist/director/mock-director-bridge.js

@@ -0,0 +1,75 @@
+// MockDirectorBridge - in-memory event source for tests + offline demos.
+//
+// Tests inject envelopes via enqueue() and let DirectorSystem drain
+// them. The demo can also use this when running without a backend
+// connection (e.g. open file:// or no auth). pollEvents() drains the
+// queue in FIFO order.
+//
+// Tracks lastEventId so the bridge contract is satisfied (gap detection
+// in DirectorSystem reads lastEventId after each poll). Does not
+// reconnect, does not validate envelopes - that's parseEnvelope's job
+// upstream of enqueue().
+export class MockDirectorBridge {
+    queue = [];
+    statusValue = 'idle';
+    statsValue = {
+        eventsReceived: 0,
+        reconnects: 0,
+        lastEventId: 0,
+        outOfOrderEvents: 0,
+        serverDropsP1: 0,
+        serverDropsP2: 0,
+    };
+    start() {
+        this.statusValue = 'connected';
+    }
+    stop() {
+        this.statusValue = 'closed';
+    }
+    status() {
+        return this.statusValue;
+    }
+    isConnected() {
+        return this.statusValue === 'connected';
+    }
+    getLastEventId() {
+        return this.statsValue.lastEventId;
+    }
+    pollEvents() {
+        if (this.queue.length === 0)
+            return [];
+        const out = this.queue;
+        this.queue = [];
+        return out;
+    }
+    stats() {
+        return this.statsValue;
+    }
+    // ----- Mock-only injection helpers -----
+    // Enqueue an envelope as if it came from the server. Out-of-order
+    // injection is allowed; the consumer's gap detection logic should
+    // handle it.
+    enqueue(event) {
+        this.queue.push(event);
+        this.statsValue.eventsReceived++;
+        if (event.id > this.statsValue.lastEventId) {
+            this.statsValue.lastEventId = event.id;
+        }
+        else {
+            this.statsValue.outOfOrderEvents++;
+        }
+    }
+    // Convenience: enqueue a batch in order.
+    enqueueAll(events) {
+        for (let i = 0; i < events.length; i++) {
+            const e = events[i];
+            if (e)
+                this.enqueue(e);
+        }
+    }
+    // Inspect-only: how many events are buffered waiting for a poll.
+    pending() {
+        return this.queue.length;
+    }
+}
+//# sourceMappingURL=mock-director-bridge.js.map

package/dist/director/mock-director-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-director-bridge.js","sourceRoot":"","sources":["../../src/director/mock-director-bridge.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,oEAAoE;AACpE,kEAAkE;AAClE,qEAAqE;AACrE,uBAAuB;AACvB,EAAE;AACF,wEAAwE;AACxE,iEAAiE;AACjE,sEAAsE;AACtE,yBAAyB;AASzB,MAAM,OAAO,kBAAkB;IACrB,KAAK,GAAoB,EAAE,CAAC;IAC5B,WAAW,GAAyB,MAAM,CAAC;IAC3C,UAAU,GAAwB;QACxC,cAAc,EAAE,CAAC;QACjB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,gBAAgB,EAAE,CAAC;QACnB,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,CAAC;KACjB,CAAC;IAEF,KAAK;QACH,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,IAAI;QACF,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC;IAC1C,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;IACrC,CAAC;IAED,UAAU;QACR,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,0CAA0C;IAE1C,kEAAkE;IAClE,kEAAkE;IAClE,aAAa;IACb,OAAO,CAAC,KAAoB;QAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,CAAC,UAAU,CAAC,WAAW,GAAG,KAAK,CAAC,EAAE,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,UAAU,CAAC,MAAoC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;CACF"}

package/dist/director/snapshot-recovery.d.ts

@@ -0,0 +1,37 @@
+import type { World } from '../world.js';
+import type { EventEnvelope } from './event-envelope.js';
+export interface SnapshotResponse {
+    ok: boolean;
+    character_id: string;
+    tail_id: number;
+    snapshot: {
+        knot_context: EventEnvelope<'knot.context'> | null;
+        ve_budget: EventEnvelope<'ve.budget.update'> | null;
+        scene: EventEnvelope<'scene.transition'> | null;
+        active_encounter: EventEnvelope<'encounter.spawn'> | null;
+    };
+    ts: number;
+}
+export declare class SnapshotFetchError extends Error {
+    readonly kind: 'network' | 'http' | 'parse' | 'invalid';
+    readonly status: number;
+    readonly url: string;
+    constructor(kind: SnapshotFetchError['kind'], url: string, message: string, status?: number);
+}
+export interface SnapshotRecoveryOptions {
+    baseUrl: string;
+    characterId: string;
+    fetchImpl?: typeof fetch;
+}
+export declare class SnapshotRecoveryHelper {
+    private readonly baseUrl;
+    private readonly characterId;
+    private readonly fetchImpl;
+    constructor(opts: SnapshotRecoveryOptions);
+    fetchSnapshot(): Promise<SnapshotResponse>;
+    applySnapshot(world: World, snapshot: SnapshotResponse): void;
+    recover(world: World): Promise<number>;
+    private buildUrl;
+    private validateResponse;
+}
+//# sourceMappingURL=snapshot-recovery.d.ts.map

package/dist/director/snapshot-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-recovery.d.ts","sourceRoot":"","sources":["../../src/director/snapshot-recovery.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAiBzC,OAAO,KAAK,EACV,aAAa,EAKd,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;QACnD,SAAS,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;QACpD,KAAK,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;QAChD,gBAAgB,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;KAC3D,CAAC;IACF,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBACT,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU;CAO/F;AAED,MAAM,WAAW,uBAAuB;IAGtC,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,MAAM,CAAC;IAEpB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAaD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,IAAI,EAAE,uBAAuB;IAenC,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAsBhD,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IA0DvD,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ5C,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,gBAAgB;CAsBzB"}

package/dist/director/snapshot-recovery.js

@@ -0,0 +1,180 @@
+// SnapshotRecoveryHelper - the renderer-side counterpart to backend
+// Phase 6.5's GET /api/v1/loom/director/state endpoint.
+//
+// When the SSEDirectorBridge surfaces a `system.snapshot.required`
+// event (gap exceeds REPLAY_MAX_EVENTS or oldest retained id older
+// than client's last_known_id), the application:
+//
+//   1. Stops the current bridge.
+//   2. Calls SnapshotRecoveryHelper.recover(world).
+//   3. Receives the snapshot's tail_id back.
+//   4. Constructs a new SSEDirectorBridge with
+//      initialLastEventId = tail_id so any replayed events <=
+//      tail_id are silently deduped.
+//   5. Starts the new bridge; live events resume from > tail_id.
+//
+// The helper itself is stateless. fetchSnapshot is async (network
+// IO); applySnapshot is sync (pure resource mutation). recover is
+// the convenience that chains both.
+//
+// Per LOOM-DIRECTOR-PROTOCOL.md §3.11 + §13 LOCKED invariants, the
+// renderer never decides palette / VE tier / zone / encounter -
+// the snapshot endpoint is authoritative; the helper simply applies
+// what the server returned.
+import { RESOURCE_KNOT_CONTEXT } from './director-bridge.js';
+import { RESOURCE_VEIL_BUDGET, } from '../resources.js';
+import { RESOURCE_DIRECTOR_LOG, } from './director-system.js';
+import { RESOURCE_ZONE_STATE, beginTransition, } from '../zone/zone-state.js';
+export class SnapshotFetchError extends Error {
+    kind;
+    status;
+    url;
+    constructor(kind, url, message, status = 0) {
+        super('SnapshotFetchError[' + kind + '] ' + url + ': ' + message);
+        this.name = 'SnapshotFetchError';
+        this.kind = kind;
+        this.url = url;
+        this.status = status;
+    }
+}
+// Tier-to-scalar table mirrors DirectorSystem so applying a
+// snapshot's ve.budget produces the same engine state as a live
+// ve.budget.update event would.
+const PARTICLE_BUDGET_BASE = 4096;
+const SHADER_BUDGET_BASE = 8;
+const TIER_SCALARS = {
+    green: { particle: 1.0, audio: 1.0, shader: 1.0 },
+    amber: { particle: 0.5, audio: 0.7, shader: 0.5 },
+    red: { particle: 0.05, audio: 0.4, shader: 0.0 },
+};
+export class SnapshotRecoveryHelper {
+    baseUrl;
+    characterId;
+    fetchImpl;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl;
+        this.characterId = opts.characterId;
+        if (opts.fetchImpl) {
+            this.fetchImpl = opts.fetchImpl;
+        }
+        else {
+            if (typeof fetch === 'undefined') {
+                throw new Error('SnapshotRecoveryHelper: fetch is unavailable. Pass options.fetchImpl in non-DOM contexts.');
+            }
+            this.fetchImpl = fetch;
+        }
+    }
+    // Fetch + parse the snapshot. Throws SnapshotFetchError on any
+    // failure (network, non-2xx HTTP, JSON parse, shape validation).
+    async fetchSnapshot() {
+        const url = this.buildUrl();
+        let resp;
+        try {
+            resp = await this.fetchImpl(url, { credentials: 'include' });
+        }
+        catch (err) {
+            throw new SnapshotFetchError('network', url, err instanceof Error ? err.message : String(err));
+        }
+        if (!resp.ok) {
+            throw new SnapshotFetchError('http', url, 'HTTP ' + resp.status + ' ' + resp.statusText, resp.status);
+        }
+        let raw;
+        try {
+            raw = await resp.json();
+        }
+        catch (err) {
+            throw new SnapshotFetchError('parse', url, err instanceof Error ? err.message : String(err));
+        }
+        return this.validateResponse(raw, url);
+    }
+    // Apply the snapshot to the world's engine resources. Pure (no
+    // network I/O). Idempotent - reapplying the same snapshot is safe.
+    applySnapshot(world, snapshot) {
+        const knotCtx = world.resources.get(RESOURCE_KNOT_CONTEXT);
+        const budget = world.resources.get(RESOURCE_VEIL_BUDGET);
+        const log = world.resources.get(RESOURCE_DIRECTOR_LOG);
+        const zone = world.resources.get(RESOURCE_ZONE_STATE);
+        const nowMs = typeof performance !== 'undefined' ? performance.now() : 0;
+        // knot_context: apply palette + mood with a short fade so the
+        // visual snap-in isn't jarring.
+        if (knotCtx && snapshot.snapshot.knot_context) {
+            const d = snapshot.snapshot.knot_context.data;
+            knotCtx.knot = d.knot;
+            knotCtx.mood = d.mood;
+            // Use a short fade (200ms) regardless of the original event's
+            // fade_ms because we're snapping, not transitioning.
+            knotCtx.beginFade(d.palette, 200, nowMs);
+            if (log)
+                log.lastKnot = d.knot;
+        }
+        // ve_budget: apply tier + scalar like DirectorSystem does.
+        if (budget && snapshot.snapshot.ve_budget) {
+            const d = snapshot.snapshot.ve_budget.data;
+            const scalars = TIER_SCALARS[d.tier];
+            budget.particleBudget = Math.round(PARTICLE_BUDGET_BASE * scalars.particle);
+            budget.audioBudget = scalars.audio;
+            budget.shaderBudget = Math.round(SHADER_BUDGET_BASE * scalars.shader);
+            budget.eventBudget = d.encounter_budget_ve;
+            if (log)
+                log.lastTier = d.tier;
+        }
+        // scene: apply zone transition. If the snapshot's scene says
+        // we're in zone X but our state says Y, snap to X without a
+        // long fade.
+        if (zone && snapshot.snapshot.scene) {
+            const d = snapshot.snapshot.scene.data;
+            const target = d.to_zone;
+            // 1ms fade = effectively instant; engine clamps to 1 frame.
+            beginTransition(zone, target, 'instant', 1, nowMs);
+        }
+        // active_encounter: set encounter id + narrator line if present.
+        if (log && snapshot.snapshot.active_encounter) {
+            const d = snapshot.snapshot.active_encounter.data;
+            log.activeEncounterId = d.encounter_id;
+            if (d.narrator_line) {
+                log.lastNarratorLine = d.narrator_line;
+                log.lastNarratorTtlMs = 0;
+            }
+        }
+        else if (log) {
+            // No active encounter in the snapshot - clear if we had one.
+            log.activeEncounterId = null;
+        }
+    }
+    // Convenience: fetch + apply + return the tail_id. Application
+    // uses the tail_id when constructing the replacement bridge so
+    // duplicate replayed events are silently deduped.
+    async recover(world) {
+        const snap = await this.fetchSnapshot();
+        this.applySnapshot(world, snap);
+        return snap.tail_id;
+    }
+    // ----- Private helpers -----
+    buildUrl() {
+        const sep = this.baseUrl.includes('?') ? '&' : '?';
+        return this.baseUrl + sep + 'character_id=' + encodeURIComponent(this.characterId);
+    }
+    validateResponse(raw, url) {
+        if (!raw || typeof raw !== 'object') {
+            throw new SnapshotFetchError('invalid', url, 'response is not an object');
+        }
+        const r = raw;
+        if (r['ok'] !== true) {
+            throw new SnapshotFetchError('invalid', url, 'response.ok is not true');
+        }
+        if (typeof r['character_id'] !== 'string') {
+            throw new SnapshotFetchError('invalid', url, 'character_id missing or not a string');
+        }
+        if (typeof r['tail_id'] !== 'number' || r['tail_id'] < 0) {
+            throw new SnapshotFetchError('invalid', url, 'tail_id missing or negative');
+        }
+        if (!r['snapshot'] || typeof r['snapshot'] !== 'object') {
+            throw new SnapshotFetchError('invalid', url, 'snapshot field missing');
+        }
+        // The snapshot.* envelopes are validated lazily on apply; full
+        // shape validation here would duplicate parseEnvelope. Trust
+        // the server for v1.
+        return r;
+    }
+}
+//# sourceMappingURL=snapshot-recovery.js.map

package/dist/director/snapshot-recovery.js.map

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

package/dist/director/sse-director-bridge.d.ts

@@ -0,0 +1,42 @@
+import type { DirectorEvent } from './event-envelope.js';
+import { type IDirectorBridge, type DirectorBridgeStatus, type DirectorBridgeStats } from './director-bridge.js';
+export interface SSEDirectorBridgeOptions {
+    baseUrl: string;
+    characterId: string;
+    fps?: number;
+    dropP2?: boolean;
+    eventSourceFactory?: (url: string) => EventSource;
+    initialLastEventId?: number;
+}
+export declare class SSEDirectorBridge implements IDirectorBridge {
+    private readonly baseUrl;
+    private readonly characterId;
+    private readonly fps;
+    private readonly dropP2;
+    private readonly eventSourceFactory;
+    private es;
+    private queue;
+    private statusValue;
+    private statsValue;
+    private reorderBuffer;
+    private reorderTimeoutHandle;
+    private static readonly REORDER_BUFFER_MAX;
+    private static readonly REORDER_TIMEOUT_MS;
+    constructor(opts: SSEDirectorBridgeOptions);
+    start(): void;
+    stop(): void;
+    status(): DirectorBridgeStatus;
+    isConnected(): boolean;
+    getLastEventId(): number;
+    pollEvents(): DirectorEvent[];
+    stats(): Readonly<DirectorBridgeStats>;
+    private buildUrl;
+    private openConnection;
+    private closeConnection;
+    private handleRaw;
+    private armReorderTimeout;
+    private drainReorderBuffer;
+    private flushReorderBufferAsIs;
+    private clearReorderBuffer;
+}
+//# sourceMappingURL=sse-director-bridge.d.ts.map

package/dist/director/sse-director-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-director-bridge.d.ts","sourceRoot":"","sources":["../../src/director/sse-director-bridge.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,wBAAwB;IAKvC,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,MAAM,CAAC;IAEpB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,MAAM,CAAC,EAAE,OAAO,CAAC;IAGjB,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,CAAC;IAOlD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,iBAAkB,YAAW,eAAe;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA+B;IAElE,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,UAAU,CAOhB;IAIF,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,oBAAoB,CAA8C;IAC1E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAM;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;gBAErC,IAAI,EAAE,wBAAwB;IAmB1C,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IAMZ,MAAM,IAAI,oBAAoB;IAI9B,WAAW,IAAI,OAAO;IAItB,cAAc,IAAI,MAAM;IAIxB,UAAU,IAAI,aAAa,EAAE;IAO7B,KAAK,IAAI,QAAQ,CAAC,mBAAmB,CAAC;IAMtC,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,cAAc;IA4DtB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,SAAS;IAyDjB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;IAe1B,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,kBAAkB;CAO3B"}

package/dist/director/sse-director-bridge.js

@@ -0,0 +1,280 @@
+// SSEDirectorBridge - real EventSource subscription to the backend's
+// /api/v1/loom/director/events endpoint.
+//
+// Per LOOM-DIRECTOR-PROTOCOL.md Section 2: SSE primary, native
+// EventSource auto-reconnect with Last-Event-ID, JSON payload per
+// frame. The renderer never decides palette or VE tier (Section 5.1,
+// 6.5); it just receives events and feeds them to DirectorSystem.
+//
+// Reconnect strategy (Section 4):
+//   - EventSource handles transport-layer reconnect on its own with
+//     exponential backoff. We just observe via onerror/onopen.
+//   - On a clean reconnect with Last-Event-ID set automatically by
+//     the browser, server replays the gap and emits
+//     system.replay.complete.
+//   - On a hard gap (system.snapshot.required), bridge stops; the
+//     consumer is responsible for fetching /state and constructing
+//     a fresh bridge with the new tail id.
+//
+// Browser-only. Constructor throws if EventSource is undefined (Node
+// test environment). Tests use MockDirectorBridge instead.
+import { parseEnvelopeJson } from './event-envelope.js';
+export class SSEDirectorBridge {
+    baseUrl;
+    characterId;
+    fps;
+    dropP2;
+    eventSourceFactory;
+    es = null;
+    queue = [];
+    statusValue = 'idle';
+    statsValue = {
+        eventsReceived: 0,
+        reconnects: 0,
+        lastEventId: 0,
+        outOfOrderEvents: 0,
+        serverDropsP1: 0,
+        serverDropsP2: 0,
+    };
+    // Reorder buffer (Section 4.2). Max 32 entries; drained when the
+    // missing id arrives or after a 500ms timeout that triggers reconnect.
+    reorderBuffer = new Map();
+    reorderTimeoutHandle = null;
+    static REORDER_BUFFER_MAX = 32;
+    static REORDER_TIMEOUT_MS = 500;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl;
+        this.characterId = opts.characterId;
+        this.fps = opts.fps ?? 60;
+        this.dropP2 = opts.dropP2 ?? true;
+        if (typeof opts.initialLastEventId === 'number' && opts.initialLastEventId > 0) {
+            this.statsValue.lastEventId = opts.initialLastEventId;
+        }
+        if (opts.eventSourceFactory) {
+            this.eventSourceFactory = opts.eventSourceFactory;
+        }
+        else {
+            if (typeof EventSource === 'undefined') {
+                throw new Error('SSEDirectorBridge: EventSource is not available in this environment. Use MockDirectorBridge for tests.');
+            }
+            const ESCtor = EventSource;
+            this.eventSourceFactory = (u) => new ESCtor(u, { withCredentials: true });
+        }
+    }
+    start() {
+        if (this.es)
+            return;
+        this.statusValue = 'connecting';
+        this.openConnection();
+    }
+    stop() {
+        this.statusValue = 'closed';
+        this.closeConnection();
+        this.clearReorderBuffer();
+    }
+    status() {
+        return this.statusValue;
+    }
+    isConnected() {
+        return this.statusValue === 'connected';
+    }
+    getLastEventId() {
+        return this.statsValue.lastEventId;
+    }
+    pollEvents() {
+        if (this.queue.length === 0)
+            return [];
+        const out = this.queue;
+        this.queue = [];
+        return out;
+    }
+    stats() {
+        return this.statsValue;
+    }
+    // ----- Internal -----
+    buildUrl() {
+        const sep = this.baseUrl.includes('?') ? '&' : '?';
+        return (this.baseUrl +
+            sep +
+            'character_id=' + encodeURIComponent(this.characterId) +
+            '&fps=' + this.fps +
+            '&drop_p2=' + (this.dropP2 ? 'true' : 'false'));
+    }
+    openConnection() {
+        const url = this.buildUrl();
+        let es;
+        try {
+            es = this.eventSourceFactory(url);
+        }
+        catch (err) {
+            this.statusValue = 'closed';
+            throw err;
+        }
+        this.es = es;
+        es.onopen = () => {
+            this.statusValue = 'connected';
+        };
+        es.onerror = () => {
+            // EventSource handles its own retry. We just track the state
+            // change so consumers can render a 'reconnecting' indicator.
+            // If readyState is CLOSED, we're done; otherwise reconnect is
+            // in progress.
+            const closed = es.readyState === 2; // EventSource.CLOSED
+            if (closed) {
+                this.statusValue = 'closed';
+                this.closeConnection();
+                return;
+            }
+            this.statusValue = 'reconnecting';
+            this.statsValue.reconnects++;
+        };
+        // The default 'message' event captures frames with no event: line.
+        // The backend uses event: <type> for everything per spec, so we
+        // route on the 'event' name. Subscribing to a few key types
+        // explicitly keeps EventSource from coalescing them under 'message'.
+        es.onmessage = (e) => {
+            this.handleRaw(e);
+        };
+        // Subscribe to all known event types so EventSource fires the
+        // type-specific listener, not just onmessage. This makes the SSE
+        // 'event:' line meaningful.
+        const knownTypes = [
+            'encounter.spawn',
+            'encounter.tick',
+            'encounter.end',
+            'encounter.loot',
+            'knot.context',
+            've.budget.update',
+            'scene.transition',
+            'narrator.line',
+            'system.heartbeat',
+            'system.replay.complete',
+            'system.snapshot.required',
+        ];
+        for (let i = 0; i < knownTypes.length; i++) {
+            const t = knownTypes[i];
+            if (!t)
+                continue;
+            es.addEventListener(t, (e) => {
+                this.handleRaw(e);
+            });
+        }
+    }
+    closeConnection() {
+        if (!this.es)
+            return;
+        try {
+            this.es.close();
+        }
+        catch { /* ignore */ }
+        this.es = null;
+    }
+    handleRaw(e) {
+        const dataStr = typeof e.data === 'string' ? e.data : '';
+        const ev = parseEnvelopeJson(dataStr);
+        if (!ev) {
+            // Malformed envelope - log + drop. EventSource will keep flowing.
+            // In v1 we don't kill the stream on a single bad payload.
+            return;
+        }
+        this.statsValue.eventsReceived++;
+        // System events drive bridge behaviour even if the consumer
+        // hasn't drained yet.
+        if (ev.type === 'system.heartbeat') {
+            this.statsValue.serverDropsP1 = ev.data.drops_p1;
+            this.statsValue.serverDropsP2 = ev.data.drops_p2;
+            // Heartbeats are still surfaced to the consumer (it may want to
+            // log / display drop counters) but they don't gate the gap-
+            // detection logic - just stash and pass through.
+        }
+        if (ev.type === 'system.snapshot.required') {
+            this.statusValue = 'snapshot-required';
+            // Surface to the consumer + close. The application layer must
+            // fetch /state and build a fresh bridge.
+            this.queue.push(ev);
+            this.closeConnection();
+            return;
+        }
+        const expected = this.statsValue.lastEventId + 1;
+        if (ev.id === expected) {
+            // In-order. Push + drain any reorder buffer entries that now
+            // contiguously follow.
+            this.statsValue.lastEventId = ev.id;
+            this.queue.push(ev);
+            this.drainReorderBuffer();
+        }
+        else if (ev.id > expected) {
+            // Future event - hold in reorder buffer up to REORDER_BUFFER_MAX.
+            // Reset the timeout so the buffer fires eventually.
+            this.statsValue.outOfOrderEvents++;
+            if (this.reorderBuffer.size < SSEDirectorBridge.REORDER_BUFFER_MAX) {
+                this.reorderBuffer.set(ev.id, ev);
+                this.armReorderTimeout();
+            }
+            else {
+                // Buffer full - hard gap. Force-flush the buffer in id order
+                // and accept the gap. Consumer's gap detection should treat
+                // this like a missed range.
+                this.flushReorderBufferAsIs();
+                this.statsValue.lastEventId = ev.id;
+                this.queue.push(ev);
+            }
+        }
+        else {
+            // Past event (lastEventId already advanced beyond this). Likely
+            // a duplicate from EventSource's at-least-once delivery during
+            // reconnect; drop silently.
+        }
+    }
+    armReorderTimeout() {
+        if (this.reorderTimeoutHandle !== null)
+            return;
+        this.reorderTimeoutHandle = setTimeout(() => {
+            this.reorderTimeoutHandle = null;
+            // Timeout: flush whatever's in the buffer in id order. The
+            // missing ids are skipped; consumer's lastEventId advances.
+            this.flushReorderBufferAsIs();
+        }, SSEDirectorBridge.REORDER_TIMEOUT_MS);
+    }
+    drainReorderBuffer() {
+        while (true) {
+            const next = this.statsValue.lastEventId + 1;
+            const ev = this.reorderBuffer.get(next);
+            if (!ev)
+                break;
+            this.reorderBuffer.delete(next);
+            this.statsValue.lastEventId = next;
+            this.queue.push(ev);
+        }
+        if (this.reorderBuffer.size === 0 && this.reorderTimeoutHandle !== null) {
+            clearTimeout(this.reorderTimeoutHandle);
+            this.reorderTimeoutHandle = null;
+        }
+    }
+    flushReorderBufferAsIs() {
+        if (this.reorderBuffer.size === 0)
+            return;
+        const ids = Array.from(this.reorderBuffer.keys()).sort((a, b) => a - b);
+        for (const id of ids) {
+            const ev = this.reorderBuffer.get(id);
+            if (!ev)
+                continue;
+            this.queue.push(ev);
+            if (id > this.statsValue.lastEventId)
+                this.statsValue.lastEventId = id;
+        }
+        this.reorderBuffer.clear();
+        if (this.reorderTimeoutHandle !== null) {
+            clearTimeout(this.reorderTimeoutHandle);
+            this.reorderTimeoutHandle = null;
+        }
+    }
+    clearReorderBuffer() {
+        this.reorderBuffer.clear();
+        if (this.reorderTimeoutHandle !== null) {
+            clearTimeout(this.reorderTimeoutHandle);
+            this.reorderTimeoutHandle = null;
+        }
+    }
+}
+//# sourceMappingURL=sse-director-bridge.js.map