@sadhaka/loom-engine 0.13.0 → 0.14.0

package/dist/director/ai/plugin.js

@@ -0,0 +1,32 @@
+// IAIPlugin - server-side plugin SPI for the Director.
+//
+// Per LOOM-DIRECTOR-PROTOCOL-V2 Section 5: the engine no longer
+// hardcodes a single Anthropic flow. Consumers register any number of
+// IAIPlugin implementations against the AIPluginRegistry, and the
+// runtime dispatches lifecycle hooks (tick, peer join/leave, zone
+// enter, player action). Each hook returns EmittedEvents - either
+// per-character v1 envelopes, v2 zone events, or both.
+//
+// This module is server-only. The browser bundle never imports it.
+// It is exposed only via the `@sadhaka/loom-engine/server` entry
+// point so consumers can wire LLM-backed plugins (Anthropic, OpenAI,
+// local models, deterministic state machines, ...) on the Node side
+// while the browser engine stays small.
+//
+// `ZoneEvent` (LOOM-DIRECTOR-PROTOCOL-V2 §3) is defined in
+// `src/director/zone/zone-event-envelope.ts` (Track A, merged into
+// 0.14.0 alongside this module). The registry carries zone events
+// opaquely - it never dereferences fields beyond the discriminated
+// union - so the only consumer of the strict type is plugin authors
+// constructing ZoneEvent values in their hook returns.
+//
+// Spec invariants preserved:
+//   - All hooks are async; they return EmittedEvents.
+//   - Hooks not implemented by a plugin are simply omitted; the
+//     registry checks `typeof plugin.onX === 'function'` before call.
+//   - Plugins are pure-ish: given a context, they return events.
+//     State mutation is the engine's job (open question 8.2 resolved).
+//   - Plugin-direct event emission outside its returned EmittedEvents
+//     is not supported; the registry is the single funnel.
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/director/ai/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/director/ai/plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,EAAE;AACF,gEAAgE;AAChE,sEAAsE;AACtE,kEAAkE;AAClE,kEAAkE;AAClE,kEAAkE;AAClE,uDAAuD;AACvD,EAAE;AACF,mEAAmE;AACnE,iEAAiE;AACjE,qEAAqE;AACrE,oEAAoE;AACpE,wCAAwC;AACxC,EAAE;AACF,2DAA2D;AAC3D,mEAAmE;AACnE,kEAAkE;AAClE,mEAAmE;AACnE,oEAAoE;AACpE,uDAAuD;AACvD,EAAE;AACF,6BAA6B;AAC7B,sDAAsD;AACtD,gEAAgE;AAChE,sEAAsE;AACtE,iEAAiE;AACjE,uEAAuE;AACvE,sEAAsE;AACtE,2DAA2D"}

package/dist/director/index.d.ts

@@ -0,0 +1,27 @@
+export type { EventEnvelope, DirectorEvent, DirectorEventType, DirectorEventDataMap, EventPriority, EncounterSpawnData, EncounterTickData, EncounterEndData, EncounterLootData, KnotContextData, KnotPaletteHex, KnotMood, VeBudgetUpdateData, VeilTier, SceneTransitionData, SceneTransitionKind, NarratorLineData, NarratorVoice, SystemHeartbeatData, SystemReplayCompleteData, SystemSnapshotRequiredData, MobSpec, BossSpec, DropSpec, } from './event-envelope.js';
+export { parseEnvelope, parseEnvelopeJson, priorityFor, EventEnvelopeParseError, } from './event-envelope.js';
+export type { IDirectorBridge, DirectorBridgeStatus, DirectorBridgeStats, } from './director-bridge.js';
+export { RESOURCE_DIRECTOR_BRIDGE, RESOURCE_KNOT_CONTEXT, } from './director-bridge.js';
+export { MockDirectorBridge } from './mock-director-bridge.js';
+export type { SSEDirectorBridgeOptions } from './sse-director-bridge.js';
+export { SSEDirectorBridge } from './sse-director-bridge.js';
+export type { KnotPaletteRgba } from './knot-context-resource.js';
+export { KnotContextResource } from './knot-context-resource.js';
+export type { DirectorEventLog } from './director-system.js';
+export { DirectorSystem, RESOURCE_DIRECTOR_LOG, createDirectorEventLog, } from './director-system.js';
+export type { DirectorEncounterSystemOptions } from './director-encounter-system.js';
+export { DirectorEncounterSystem } from './director-encounter-system.js';
+export type { ZoneEventEnvelope, ZoneEvent, ZoneEventType, ZoneEventDataMap, ZoneBossSpec, ZoneBossSpawnData, ZoneBossTickData, ZoneBossEndData, ZoneBossOutcome, ZoneBossHit, ZoneNarratorData, ZoneKnotData, ZoneStateData, ZoneSnapshotData, ZoneStateChange, } from './zone/zone-event-envelope.js';
+export { parseZoneEnvelope, parseZoneEnvelopeJson, priorityFor as zonePriorityFor, ZoneEventEnvelopeParseError, } from './zone/zone-event-envelope.js';
+export type { IZoneEventBridge, ZoneEventBridgeStatus, ZoneEventBridgeStats, } from './zone/zone-event-bridge.js';
+export { RESOURCE_ZONE_EVENT_BRIDGE } from './zone/zone-event-bridge.js';
+export { MockZoneBridge } from './zone/mock-zone-bridge.js';
+export type { SSEZoneBridgeOptions, SSEZoneBridgeEventSource, } from './zone/sse-zone-bridge.js';
+export { SSEZoneBridge } from './zone/sse-zone-bridge.js';
+export type { ZoneEventLog, ZoneEventLogEntry, } from './zone/zone-event-log.js';
+export { RESOURCE_ZONE_EVENT_LOG, ZONE_RING_SIZE, createZoneEventLog, getOrCreateZoneEntry, pushZoneEvent, } from './zone/zone-event-log.js';
+export type { DirectorZoneStateResource } from './zone/zone-state-resource.js';
+export { RESOURCE_DIRECTOR_ZONE_STATE, createDirectorZoneStateResource, getOrCreateZoneStateMap, applyZoneStateChanges, replaceZoneStateFromSnapshot, } from './zone/zone-state-resource.js';
+export type { ZoneEventSystemOptions } from './zone/zone-event-system.js';
+export { ZoneEventSystem } from './zone/zone-event-system.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/director/index.ts"],"names":[],"mappings":"AAaA,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,QAAQ,EACR,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,OAAO,EACP,QAAQ,EACR,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,IAAI,eAAe,EAC9B,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/director/index.js

@@ -0,0 +1,26 @@
+// Director module barrel - re-exports the v1 (Phase 6) surface plus
+// the v2 (Phase 16) zone-event surface.
+//
+// v1 lives at the top level of src/director/. v2 lives under
+// src/director/zone/. Track B's AI Plugin SPI lives under
+// src/director/ai/ and is re-exported via @sadhaka/loom-engine/server,
+// not from here. We do not pull AI plugin types into this barrel so
+// the browser bundle stays small.
+//
+// Engine-level public re-exports happen in ../index.ts. Internal
+// callers can import from this barrel for convenience.
+export { parseEnvelope, parseEnvelopeJson, priorityFor, EventEnvelopeParseError, } from './event-envelope.js';
+export { RESOURCE_DIRECTOR_BRIDGE, RESOURCE_KNOT_CONTEXT, } from './director-bridge.js';
+export { MockDirectorBridge } from './mock-director-bridge.js';
+export { SSEDirectorBridge } from './sse-director-bridge.js';
+export { KnotContextResource } from './knot-context-resource.js';
+export { DirectorSystem, RESOURCE_DIRECTOR_LOG, createDirectorEventLog, } from './director-system.js';
+export { DirectorEncounterSystem } from './director-encounter-system.js';
+export { parseZoneEnvelope, parseZoneEnvelopeJson, priorityFor as zonePriorityFor, ZoneEventEnvelopeParseError, } from './zone/zone-event-envelope.js';
+export { RESOURCE_ZONE_EVENT_BRIDGE } from './zone/zone-event-bridge.js';
+export { MockZoneBridge } from './zone/mock-zone-bridge.js';
+export { SSEZoneBridge } from './zone/sse-zone-bridge.js';
+export { RESOURCE_ZONE_EVENT_LOG, ZONE_RING_SIZE, createZoneEventLog, getOrCreateZoneEntry, pushZoneEvent, } from './zone/zone-event-log.js';
+export { RESOURCE_DIRECTOR_ZONE_STATE, createDirectorZoneStateResource, getOrCreateZoneStateMap, applyZoneStateChanges, replaceZoneStateFromSnapshot, } from './zone/zone-state-resource.js';
+export { ZoneEventSystem } from './zone/zone-event-system.js';
+//# sourceMappingURL=index.js.map

package/dist/director/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/director/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,wCAAwC;AACxC,EAAE;AACF,6DAA6D;AAC7D,0DAA0D;AAC1D,uEAAuE;AACvE,oEAAoE;AACpE,kCAAkC;AAClC,EAAE;AACF,iEAAiE;AACjE,uDAAuD;AA6BvD,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAoBzE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,IAAI,eAAe,EAC9B,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAK5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK1D,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GACd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAC/B,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { ZoneEvent } from './zone-event-envelope.js';
+import { type IZoneEventBridge, type ZoneEventBridgeStatus, type ZoneEventBridgeStats } from './zone-event-bridge.js';
+export declare class MockZoneBridge implements IZoneEventBridge {
+    private queue;
+    private statusValue;
+    private readonly lastEventIdByZone;
+    private readonly statsValue;
+    start(): void;
+    stop(): void;
+    status(): ZoneEventBridgeStatus;
+    isConnected(): boolean;
+    getLastEventId(zone: string): number;
+    pollEvents(): ZoneEvent[];
+    stats(): Readonly<ZoneEventBridgeStats>;
+    enqueueIncoming(event: ZoneEvent): void;
+    enqueueIncomingJson(json: string): boolean;
+    enqueueAll(events: ReadonlyArray<ZoneEvent>): void;
+    bumpReconnect(): void;
+    setServerDrops(p1: number, p2: number): void;
+    pending(): number;
+}
+//# sourceMappingURL=mock-zone-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock-zone-bridge.d.ts","sourceRoot":"","sources":["../../../src/director/zone/mock-zone-bridge.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,cAAe,YAAW,gBAAgB;IACrD,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAYzB;IAEF,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI;IAIZ,MAAM,IAAI,qBAAqB;IAI/B,WAAW,IAAI,OAAO;IAItB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,UAAU,IAAI,SAAS,EAAE;IAOzB,KAAK,IAAI,QAAQ,CAAC,oBAAoB,CAAC;IAmBvC,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAavC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ1C,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,IAAI;IAQlD,aAAa,IAAI,IAAI;IAKrB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAM5C,OAAO,IAAI,MAAM;CAGlB"}

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

@@ -0,0 +1,107 @@
+// MockZoneBridge - in-memory v2 zone-event source for tests + offline
+// demos.
+//
+// Tests inject envelopes via enqueueIncoming() and let ZoneEventSystem
+// drain them. The demo path can also use this when running without a
+// backend connection. pollEvents() drains the queue in FIFO order.
+//
+// Tracks per-zone lastEventId so the IZoneEventBridge contract is
+// satisfied. Does not reconnect, does not validate envelopes when fed
+// objects directly - that's parseZoneEnvelope's job upstream of
+// enqueueIncoming(). enqueueIncomingJson() is a convenience that runs
+// the parser first and silently drops malformed payloads (mirrors how
+// SSEZoneBridge would handle a bad frame).
+import { parseZoneEnvelopeJson } from './zone-event-envelope.js';
+export class MockZoneBridge {
+    queue = [];
+    statusValue = 'idle';
+    lastEventIdByZone = new Map();
+    statsValue = {
+        eventsReceived: 0,
+        reconnects: 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(zone) {
+        return this.lastEventIdByZone.get(zone) ?? 0;
+    }
+    pollEvents() {
+        if (this.queue.length === 0)
+            return [];
+        const out = this.queue;
+        this.queue = [];
+        return out;
+    }
+    stats() {
+        // Allocate the read-only view fresh each call so mutations after
+        // the call don't leak through. lastEventIdByZone is wrapped in a
+        // shallow clone; spec calls this rare so cost is fine.
+        return {
+            eventsReceived: this.statsValue.eventsReceived,
+            reconnects: this.statsValue.reconnects,
+            outOfOrderEvents: this.statsValue.outOfOrderEvents,
+            serverDropsP1: this.statsValue.serverDropsP1,
+            serverDropsP2: this.statsValue.serverDropsP2,
+            lastEventIdByZone: new Map(this.lastEventIdByZone),
+        };
+    }
+    // ----- Mock-only injection helpers -----
+    // Enqueue a parsed envelope as if the server pushed it. Out-of-order
+    // injection is allowed; the consumer's per-zone gap detection should
+    // handle it.
+    enqueueIncoming(event) {
+        this.queue.push(event);
+        this.statsValue.eventsReceived++;
+        const prev = this.lastEventIdByZone.get(event.zone_id) ?? 0;
+        if (event.id > prev) {
+            this.lastEventIdByZone.set(event.zone_id, event.id);
+        }
+        else {
+            this.statsValue.outOfOrderEvents++;
+        }
+    }
+    // Convenience: enqueue from a JSON string. Silently drops malformed
+    // payloads, matching the SSE bridge's parse-error behaviour.
+    enqueueIncomingJson(json) {
+        const ev = parseZoneEnvelopeJson(json);
+        if (!ev)
+            return false;
+        this.enqueueIncoming(ev);
+        return true;
+    }
+    // Convenience: bulk enqueue.
+    enqueueAll(events) {
+        for (let i = 0; i < events.length; i++) {
+            const e = events[i];
+            if (e)
+                this.enqueueIncoming(e);
+        }
+    }
+    // Mock-only: simulate the server crediting a reconnect.
+    bumpReconnect() {
+        this.statsValue.reconnects++;
+    }
+    // Mock-only: simulate server-side drop counters from a heartbeat.
+    setServerDrops(p1, p2) {
+        this.statsValue.serverDropsP1 = p1;
+        this.statsValue.serverDropsP2 = p2;
+    }
+    // Inspect-only: how many events are buffered waiting for a poll.
+    pending() {
+        return this.queue.length;
+    }
+}
+//# sourceMappingURL=mock-zone-bridge.js.map

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

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

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

@@ -0,0 +1,40 @@
+import type { ZoneEvent } from './zone-event-envelope.js';
+import { type IZoneEventBridge, type ZoneEventBridgeStatus, type ZoneEventBridgeStats } from './zone-event-bridge.js';
+export interface SSEZoneBridgeEventSource {
+    readonly readyState: number;
+    addEventListener(type: string, listener: (event: {
+        data?: unknown;
+    }) => void): void;
+    removeEventListener?(type: string, listener: (event: {
+        data?: unknown;
+    }) => void): void;
+}
+export interface SSEZoneBridgeOptions {
+    eventSource: SSEZoneBridgeEventSource;
+    characterId: string;
+    currentZone: () => string;
+    eventName?: string;
+    filterAtReceive?: boolean;
+}
+export declare class SSEZoneBridge implements IZoneEventBridge {
+    private readonly es;
+    private readonly characterId;
+    private readonly currentZone;
+    private readonly eventName;
+    private readonly filterAtReceive;
+    private listener;
+    private queue;
+    private statusValue;
+    private readonly lastEventIdByZone;
+    private readonly statsValue;
+    constructor(opts: SSEZoneBridgeOptions);
+    start(): void;
+    stop(): void;
+    status(): ZoneEventBridgeStatus;
+    isConnected(): boolean;
+    getLastEventId(zone: string): number;
+    pollEvents(): ZoneEvent[];
+    stats(): Readonly<ZoneEventBridgeStats>;
+    private handleRaw;
+}
+//# sourceMappingURL=sse-zone-bridge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sse-zone-bridge.d.ts","sourceRoot":"","sources":["../../../src/director/zone/sse-zone-bridge.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAC5C,IAAI,CAAC;IACR,mBAAmB,CAAC,CAClB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAC5C,IAAI,CAAC;CAGT;AAED,MAAM,WAAW,oBAAoB;IAInC,WAAW,EAAE,wBAAwB,CAAC;IAItC,WAAW,EAAE,MAAM,CAAC;IAMpB,WAAW,EAAE,MAAM,MAAM,CAAC;IAG1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAInB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAOD,qBAAa,aAAc,YAAW,gBAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAE1C,OAAO,CAAC,QAAQ,CAAsD;IACtE,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkC;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAYzB;gBAEU,IAAI,EAAE,oBAAoB;IAWtC,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;IAQZ,MAAM,IAAI,qBAAqB;IAe/B,WAAW,IAAI,OAAO;IAItB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIpC,UAAU,IAAI,SAAS,EAAE;IAOzB,KAAK,IAAI,QAAQ,CAAC,oBAAoB,CAAC;IAavC,OAAO,CAAC,SAAS;CA6BlB"}

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

@@ -0,0 +1,164 @@
+// SSEZoneBridge - multiplexes v2 zone-event frames onto an EXISTING
+// presence EventSource (per LOOM-DIRECTOR-PROTOCOL-V2 §2 + §4.2).
+//
+// CRITICAL: this bridge does NOT open its own EventSource. The
+// presence transport (15.x SSEMultiplayerBridge) already has a live
+// connection per peer; we just attach a listener for SSE frames whose
+// `event:` line is `zone.event`. Per spec §1.1: "Transport reuses
+// presence SSE. Same channel as 15.x presence updates, multiplexed by
+// event topic. No second EventSource per peer."
+//
+// Wire shape per frame:
+//   event: zone.event
+//   data: <ZoneEventEnvelope JSON>
+//
+// Local-zone filter: the system layer (ZoneEventSystem) is the
+// authoritative filter on "is this event for the local player's
+// zone". The bridge buffers ALL zone events it receives so the system
+// can log other-zone events for diagnostics if it chooses, then drop
+// them before applying. The currentZone() callback is provided so the
+// bridge can additionally short-circuit obvious-other-zone events at
+// receive time when stats matter (e.g. a high-volume foreign zone).
+// The default behaviour is to keep everything and let the system
+// decide.
+//
+// Browser-only (constructor accepts EventSource which is a DOM API).
+// In Node tests we exercise this via an injected fake EventSource
+// (pattern parallel to SSEDirectorBridge.eventSourceFactory).
+import { parseZoneEnvelopeJson } from './zone-event-envelope.js';
+// SSE EventSource readyState constants. Mirrored locally to avoid
+// pulling DOM types into the engine's strict Node test config.
+const ES_OPEN = 1;
+const ES_CLOSED = 2;
+export class SSEZoneBridge {
+    es;
+    characterId;
+    currentZone;
+    eventName;
+    filterAtReceive;
+    listener = null;
+    queue = [];
+    statusValue = 'idle';
+    lastEventIdByZone = new Map();
+    statsValue = {
+        eventsReceived: 0,
+        reconnects: 0,
+        outOfOrderEvents: 0,
+        serverDropsP1: 0,
+        serverDropsP2: 0,
+    };
+    constructor(opts) {
+        this.es = opts.eventSource;
+        this.characterId = opts.characterId;
+        this.currentZone = opts.currentZone;
+        this.eventName = opts.eventName ?? 'zone.event';
+        this.filterAtReceive = opts.filterAtReceive ?? false;
+        // characterId is currently used for diagnostics only - reserved
+        // for future emitter_id-based UX hooks (e.g. local-cause cues).
+        void this.characterId;
+    }
+    start() {
+        if (this.listener)
+            return;
+        this.listener = (e) => { this.handleRaw(e); };
+        this.es.addEventListener(this.eventName, this.listener);
+        // The presence EventSource owns connect lifecycle. We mirror its
+        // current readyState so consumers can reason about isConnected().
+        if (this.es.readyState === ES_OPEN) {
+            this.statusValue = 'connected';
+        }
+        else if (this.es.readyState === ES_CLOSED) {
+            this.statusValue = 'closed';
+        }
+        else {
+            this.statusValue = 'connecting';
+        }
+    }
+    stop() {
+        this.statusValue = 'closed';
+        if (this.listener && this.es.removeEventListener) {
+            this.es.removeEventListener(this.eventName, this.listener);
+        }
+        this.listener = null;
+    }
+    status() {
+        // Refresh from the underlying ES if we're attached - the presence
+        // layer handles reconnects, so our cached status can lag.
+        if (this.listener) {
+            if (this.es.readyState === ES_OPEN) {
+                if (this.statusValue === 'connecting' || this.statusValue === 'reconnecting') {
+                    this.statusValue = 'connected';
+                }
+            }
+            else if (this.es.readyState === ES_CLOSED) {
+                this.statusValue = 'closed';
+            }
+        }
+        return this.statusValue;
+    }
+    isConnected() {
+        return this.status() === 'connected';
+    }
+    getLastEventId(zone) {
+        return this.lastEventIdByZone.get(zone) ?? 0;
+    }
+    pollEvents() {
+        if (this.queue.length === 0)
+            return [];
+        const out = this.queue;
+        this.queue = [];
+        return out;
+    }
+    stats() {
+        return {
+            eventsReceived: this.statsValue.eventsReceived,
+            reconnects: this.statsValue.reconnects,
+            outOfOrderEvents: this.statsValue.outOfOrderEvents,
+            serverDropsP1: this.statsValue.serverDropsP1,
+            serverDropsP2: this.statsValue.serverDropsP2,
+            lastEventIdByZone: new Map(this.lastEventIdByZone),
+        };
+    }
+    // ----- Internal -----
+    handleRaw(e) {
+        const dataStr = typeof e.data === 'string' ? e.data : '';
+        const ev = parseZoneEnvelopeJson(dataStr);
+        if (!ev) {
+            // Malformed envelope - drop. The presence layer's EventSource
+            // keeps flowing; one bad frame doesn't kill the channel.
+            return;
+        }
+        if (this.filterAtReceive) {
+            // Optional optimization: drop foreign-zone events before they
+            // hit the queue. The system would have done it anyway.
+            const localZone = safeCurrentZone(this.currentZone);
+            if (localZone && ev.zone_id !== localZone) {
+                // Still track the highest id for that foreign zone so the
+                // bridge's per-zone last-id map is honest about what arrived.
+                const prev = this.lastEventIdByZone.get(ev.zone_id) ?? 0;
+                if (ev.id > prev)
+                    this.lastEventIdByZone.set(ev.zone_id, ev.id);
+                return;
+            }
+        }
+        this.statsValue.eventsReceived++;
+        const prev = this.lastEventIdByZone.get(ev.zone_id) ?? 0;
+        if (ev.id > prev) {
+            this.lastEventIdByZone.set(ev.zone_id, ev.id);
+        }
+        else {
+            this.statsValue.outOfOrderEvents++;
+        }
+        this.queue.push(ev);
+    }
+}
+function safeCurrentZone(fn) {
+    try {
+        const z = fn();
+        return typeof z === 'string' && z.length > 0 ? z : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=sse-zone-bridge.js.map

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

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

package/dist/director/zone/zone-event-bridge.d.ts

@@ -0,0 +1,21 @@
+import type { ZoneEvent } from './zone-event-envelope.js';
+export type ZoneEventBridgeStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'snapshot-required' | 'closed';
+export interface ZoneEventBridgeStats {
+    eventsReceived: number;
+    reconnects: number;
+    outOfOrderEvents: number;
+    serverDropsP1: number;
+    serverDropsP2: number;
+    lastEventIdByZone: ReadonlyMap<string, number>;
+}
+export interface IZoneEventBridge {
+    start(): void;
+    stop(): void;
+    status(): ZoneEventBridgeStatus;
+    isConnected(): boolean;
+    getLastEventId(zone: string): number;
+    pollEvents(): ZoneEvent[];
+    stats(): Readonly<ZoneEventBridgeStats>;
+}
+export declare const RESOURCE_ZONE_EVENT_BRIDGE = "zone_event_bridge";
+//# sourceMappingURL=zone-event-bridge.d.ts.map

package/dist/director/zone/zone-event-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-event-bridge.d.ts","sourceRoot":"","sources":["../../../src/director/zone/zone-event-bridge.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,YAAY,GACZ,WAAW,GACX,cAAc,GACd,mBAAmB,GACnB,QAAQ,CAAC;AAEb,MAAM,WAAW,oBAAoB;IAEnC,cAAc,EAAE,MAAM,CAAC;IAEvB,UAAU,EAAE,MAAM,CAAC;IAEnB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IAGtB,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,IAAI,qBAAqB,CAAC;IAChC,WAAW,IAAI,OAAO,CAAC;IAEvB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAErC,UAAU,IAAI,SAAS,EAAE,CAAC;IAC1B,KAAK,IAAI,QAAQ,CAAC,oBAAoB,CAAC,CAAC;CACzC;AAGD,eAAO,MAAM,0BAA0B,sBAAsB,CAAC"}

package/dist/director/zone/zone-event-bridge.js

@@ -0,0 +1,24 @@
+// IZoneEventBridge - abstraction over the v2 zone-event source.
+//
+// Concrete implementations:
+//   MockZoneBridge - in-process. enqueueIncoming(event) simulates
+//                    server pushes for tests + offline demo.
+//   SSEZoneBridge  - multiplexes onto an EXISTING presence
+//                    EventSource. Listens for SSE frames whose
+//                    `event:` line is `zone.event` (per spec §2.1).
+//
+// The ZoneEventSystem (PHASE_INPUT, AFTER DirectorSystem and
+// PeerPresenceSystem) calls pollEvents() once per tick to drain queued
+// events. Bridges buffer events between polls so the system's per-tick
+// read is bounded.
+//
+// Per-zone monotonic id semantics (spec §8.1):
+//   - Each zone has its own id sequence starting at 1.
+//   - getLastEventId(zone) returns the highest id observed for that
+//     zone, or 0 if no events seen.
+//   - Out-of-order events are tracked in stats, but bridge-level
+//     reorder buffering lives in concrete impls (the contract here is
+//     the polled queue is best-effort ordered).
+// Resource keys.
+export const RESOURCE_ZONE_EVENT_BRIDGE = 'zone_event_bridge';
+//# sourceMappingURL=zone-event-bridge.js.map

package/dist/director/zone/zone-event-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zone-event-bridge.js","sourceRoot":"","sources":["../../../src/director/zone/zone-event-bridge.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,4BAA4B;AAC5B,kEAAkE;AAClE,6DAA6D;AAC7D,2DAA2D;AAC3D,+DAA+D;AAC/D,oEAAoE;AACpE,EAAE;AACF,6DAA6D;AAC7D,uEAAuE;AACvE,uEAAuE;AACvE,mBAAmB;AACnB,EAAE;AACF,+CAA+C;AAC/C,uDAAuD;AACvD,oEAAoE;AACpE,oCAAoC;AACpC,iEAAiE;AACjE,sEAAsE;AACtE,gDAAgD;AAwChD,iBAAiB;AACjB,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC"}

package/dist/director/zone/zone-event-envelope.d.ts

@@ -0,0 +1,90 @@
+import type { DropSpec, EventPriority, KnotMood, KnotPaletteHex, NarratorVoice } from '../event-envelope.js';
+export interface ZoneEventEnvelope<T extends ZoneEventType = ZoneEventType> {
+    id: number;
+    ts: number;
+    type: T;
+    zone_id: string;
+    emitter_id: string | null;
+    priority?: EventPriority;
+    data: ZoneEventDataMap[T];
+}
+export interface ZoneBossSpec {
+    boss_id: string;
+    type: string;
+    name: string;
+    hp_max: number;
+    hp_current: number;
+    dmg: number;
+    x: number;
+    y: number;
+    knot_flavor: string;
+}
+export interface ZoneBossSpawnData {
+    boss: ZoneBossSpec;
+    narrator_line: string | null;
+}
+export interface ZoneBossHit {
+    from_character_id: string;
+    amount: number;
+    ts_ms: number;
+}
+export interface ZoneBossTickData {
+    boss_id: string;
+    hp_current: number;
+    x: number;
+    y: number;
+    recent_hits: ReadonlyArray<ZoneBossHit>;
+}
+export type ZoneBossOutcome = 'killed' | 'despawned' | 'fled';
+export interface ZoneBossEndData {
+    boss_id: string;
+    outcome: ZoneBossOutcome;
+    killer_character_id: string | null;
+    loot: ReadonlyArray<DropSpec>;
+    duration_ms: number;
+}
+export interface ZoneNarratorData {
+    line: string;
+    voice: NarratorVoice;
+    ttl_ms: number;
+}
+export interface ZoneKnotData {
+    knot: string;
+    palette: KnotPaletteHex;
+    mood: KnotMood;
+    fade_ms: number;
+}
+export interface ZoneStateChange {
+    key: string;
+    value: unknown;
+}
+export interface ZoneStateData {
+    changes: ReadonlyArray<ZoneStateChange>;
+}
+export interface ZoneSnapshotData {
+    active_boss: ZoneBossSpec | null;
+    knot: ZoneKnotData | null;
+    state: ReadonlyArray<ZoneStateChange>;
+    last_event_id: number;
+}
+export type ZoneEventType = 'zone.boss.spawn' | 'zone.boss.tick' | 'zone.boss.end' | 'zone.narrator' | 'zone.knot' | 'zone.state' | 'zone.snapshot';
+export interface ZoneEventDataMap {
+    'zone.boss.spawn': ZoneBossSpawnData;
+    'zone.boss.tick': ZoneBossTickData;
+    'zone.boss.end': ZoneBossEndData;
+    'zone.narrator': ZoneNarratorData;
+    'zone.knot': ZoneKnotData;
+    'zone.state': ZoneStateData;
+    'zone.snapshot': ZoneSnapshotData;
+}
+export type ZoneEvent = {
+    [K in ZoneEventType]: ZoneEventEnvelope<K>;
+}[ZoneEventType];
+export declare function priorityFor(type: ZoneEventType): EventPriority;
+export declare class ZoneEventEnvelopeParseError extends Error {
+    readonly raw: unknown;
+    constructor(message: string, raw: unknown);
+}
+export declare function parseZoneEnvelope(raw: unknown): ZoneEvent;
+export declare function parseZoneEnvelopeJson(json: string): ZoneEvent | null;
+//# sourceMappingURL=zone-event-envelope.d.ts.map

package/dist/director/zone/zone-event-envelope.d.ts.map

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