@sadhaka/loom-engine 0.13.0 → 0.15.0

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

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

@@ -0,0 +1,104 @@
+// Zone-event envelope + typed payloads (Phase 16, LOOM-DIRECTOR-PROTOCOL-V2 §3).
+//
+// v2 introduces a parallel event surface scoped per zone instead of per
+// character. The Director emits a zone event, the server fans it out to
+// every peer currently in that zone. v1's character-scoped EventEnvelope
+// in ../event-envelope.ts remains the source of truth for v1 events and
+// is NOT touched by this file.
+//
+// Spec invariants preserved:
+//   - id is monotonic per zone (NOT global). Each zone is its own
+//     append-only log starting at 1.
+//   - emitter_id is the character_id that triggered the event, or null
+//     when the Loom emitted spontaneously (timer, autonomous Director).
+//   - encounter_id is GONE - zone events are zone-scoped, not encounter-
+//     scoped.
+//   - priority field carries v1 §7.2 semantics: P0 always delivered,
+//     P1 dropped first under load, P2 next.
+//   - Reuses v1's DropSpec, NarratorVoice, KnotPaletteHex, KnotMood so
+//     consumer code that already understands v1 needs zero changes for
+//     the overlapping shapes.
+// ----- Priority classes (spec §3.1) -----
+const ZONE_PRIORITY_BY_TYPE = {
+    'zone.boss.spawn': 'P0',
+    'zone.boss.end': 'P0',
+    'zone.snapshot': 'P0',
+    'zone.state': 'P0',
+    'zone.narrator': 'P1',
+    'zone.knot': 'P1',
+    'zone.boss.tick': 'P2',
+};
+export function priorityFor(type) {
+    return ZONE_PRIORITY_BY_TYPE[type];
+}
+// ----- Parsers -----
+export class ZoneEventEnvelopeParseError extends Error {
+    raw;
+    constructor(message, raw) {
+        super('ZoneEventEnvelopeParseError: ' + message);
+        this.raw = raw;
+        this.name = 'ZoneEventEnvelopeParseError';
+    }
+}
+const KNOWN_ZONE_EVENT_TYPES = new Set([
+    'zone.boss.spawn',
+    'zone.boss.tick',
+    'zone.boss.end',
+    'zone.narrator',
+    'zone.knot',
+    'zone.state',
+    'zone.snapshot',
+]);
+// Validate envelope shape only - data payload validation is the caller's
+// responsibility (downstream type narrowing on `event.type` gives full
+// payload typing). Throws on shape errors so the bridge can decide to
+// drop / log / reconnect. Mirrors parseEnvelope() in v1.
+export function parseZoneEnvelope(raw) {
+    if (!raw || typeof raw !== 'object') {
+        throw new ZoneEventEnvelopeParseError('envelope is not an object', raw);
+    }
+    const e = raw;
+    if (typeof e['id'] !== 'number' || e['id'] < 0 || !Number.isFinite(e['id'])) {
+        throw new ZoneEventEnvelopeParseError('id must be a non-negative number', raw);
+    }
+    if (typeof e['ts'] !== 'number') {
+        throw new ZoneEventEnvelopeParseError('ts must be a number', raw);
+    }
+    if (typeof e['type'] !== 'string' || !KNOWN_ZONE_EVENT_TYPES.has(e['type'])) {
+        throw new ZoneEventEnvelopeParseError('unknown zone event type: ' + String(e['type']), raw);
+    }
+    if (typeof e['zone_id'] !== 'string' || e['zone_id'].length === 0) {
+        throw new ZoneEventEnvelopeParseError('zone_id must be a non-empty string', raw);
+    }
+    if (e['emitter_id'] !== null && typeof e['emitter_id'] !== 'string') {
+        throw new ZoneEventEnvelopeParseError('emitter_id must be string or null', raw);
+    }
+    if (e['priority'] !== undefined) {
+        if (e['priority'] !== 'P0' && e['priority'] !== 'P1' && e['priority'] !== 'P2') {
+            throw new ZoneEventEnvelopeParseError('priority must be P0 / P1 / P2 when present, got: ' + String(e['priority']), raw);
+        }
+    }
+    if (!e['data'] || typeof e['data'] !== 'object') {
+        throw new ZoneEventEnvelopeParseError('data must be an object', raw);
+    }
+    return e;
+}
+// Convenience: parse a string (typically an SSE 'data:' line) into an
+// envelope. Returns null on JSON parse error or shape error so the
+// caller can decide whether to log or re-throw.
+export function parseZoneEnvelopeJson(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+    try {
+        return parseZoneEnvelope(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=zone-event-envelope.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { ZoneEvent } from './zone-event-envelope.js';
+export interface ZoneEventLogEntry {
+    recent: ZoneEvent[];
+    activeBossId: string | null;
+    lastNarratorLine: string | null;
+    lastNarratorTtlMs: number;
+    eventsApplied: number;
+}
+export interface ZoneEventLog {
+    byZone: Map<string, ZoneEventLogEntry>;
+}
+export declare const RESOURCE_ZONE_EVENT_LOG = "zone_event_log";
+export declare const ZONE_RING_SIZE = 32;
+export declare function createZoneEventLog(): ZoneEventLog;
+export declare function getOrCreateZoneEntry(log: ZoneEventLog, zoneId: string): ZoneEventLogEntry;
+export declare function pushZoneEvent(entry: ZoneEventLogEntry, ev: ZoneEvent): void;
+//# sourceMappingURL=zone-event-log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zone-event-log.d.ts","sourceRoot":"","sources":["../../../src/director/zone/zone-event-log.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAEhC,MAAM,EAAE,SAAS,EAAE,CAAC;IAGpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAG5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAG1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,uBAAuB,mBAAmB,CAAC;AAExD,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAKD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,GACb,iBAAiB,CAYnB;AAKD,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,SAAS,GAAG,IAAI,CAM3E"}

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

@@ -0,0 +1,46 @@
+// ZoneEventLog - per-zone ring buffer parallel to v1's
+// DirectorEventLog (LOOM-DIRECTOR-PROTOCOL-V2 §4.4).
+//
+// Renderer reads from this for UI surfaces (boss HP bar, recent loot
+// toast, narrator banner). Per-zone slots so a player who briefly
+// stepped through another zone keeps a separate diagnostic trail per
+// zone they have observed.
+//
+// The map is dense by-zone; a zone's slot is created lazily on the
+// first event for that zone (avoids preallocating slots for zones the
+// player will never enter). The ring buffer per zone caps at
+// ZONE_RING_SIZE = 32 entries, newest first - matches v1's
+// DirectorEventLog.recent semantics.
+export const RESOURCE_ZONE_EVENT_LOG = 'zone_event_log';
+export const ZONE_RING_SIZE = 32;
+export function createZoneEventLog() {
+    return { byZone: new Map() };
+}
+// Get or lazily create the slot for a zone. Used by ZoneEventSystem
+// when the first event for a zone arrives. Exported for tests +
+// bench.
+export function getOrCreateZoneEntry(log, zoneId) {
+    const existing = log.byZone.get(zoneId);
+    if (existing)
+        return existing;
+    const fresh = {
+        recent: [],
+        activeBossId: null,
+        lastNarratorLine: null,
+        lastNarratorTtlMs: 0,
+        eventsApplied: 0,
+    };
+    log.byZone.set(zoneId, fresh);
+    return fresh;
+}
+// Push an event into the per-zone ring buffer (newest first) and
+// bump eventsApplied. Pure; does not touch activeBossId / narrator
+// state - those are the system's job to set per event type.
+export function pushZoneEvent(entry, ev) {
+    entry.recent.unshift(ev);
+    if (entry.recent.length > ZONE_RING_SIZE) {
+        entry.recent.length = ZONE_RING_SIZE;
+    }
+    entry.eventsApplied++;
+}
+//# sourceMappingURL=zone-event-log.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zone-event-log.js","sourceRoot":"","sources":["../../../src/director/zone/zone-event-log.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,qDAAqD;AACrD,EAAE;AACF,qEAAqE;AACrE,kEAAkE;AAClE,qEAAqE;AACrE,2BAA2B;AAC3B,EAAE;AACF,mEAAmE;AACnE,sEAAsE;AACtE,6DAA6D;AAC7D,2DAA2D;AAC3D,qCAAqC;AAuBrC,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC;AAExD,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,MAAM,UAAU,kBAAkB;IAChC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;AAC/B,CAAC;AAED,oEAAoE;AACpE,gEAAgE;AAChE,SAAS;AACT,MAAM,UAAU,oBAAoB,CAClC,GAAiB,EACjB,MAAc;IAEd,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,KAAK,GAAsB;QAC/B,MAAM,EAAE,EAAE;QACV,YAAY,EAAE,IAAI;QAClB,gBAAgB,EAAE,IAAI;QACtB,iBAAiB,EAAE,CAAC;QACpB,aAAa,EAAE,CAAC;KACjB,CAAC;IACF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iEAAiE;AACjE,mEAAmE;AACnE,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,EAAa;IACnE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzB,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QACzC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC;IACvC,CAAC;IACD,KAAK,CAAC,aAAa,EAAE,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { System } from '../../system.js';
+import type { World } from '../../world.js';
+export interface ZoneEventSystemOptions {
+    currentZone?: () => string | null;
+    applyKnotToSharedContext?: boolean;
+}
+export declare class ZoneEventSystem implements System {
+    readonly name: string;
+    private readonly currentZone;
+    private readonly applyKnotToSharedContext;
+    constructor(opts?: ZoneEventSystemOptions);
+    update(world: World, _dt: number): void;
+}
+//# sourceMappingURL=zone-event-system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zone-event-system.d.ts","sourceRoot":"","sources":["../../../src/director/zone/zone-event-system.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AA6B5C,MAAM,WAAW,sBAAsB;IAKrC,WAAW,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAIlC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,qBAAa,eAAgB,YAAW,MAAM;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAiB;IAEtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAU;gBAEvC,IAAI,GAAE,sBAA2B;IAK7C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAkCxC"}