@sharpee/engine 0.9.111 → 1.0.0

package/sound/dispatcher.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Per-turn audibility dispatcher (ADR-172 Phase 6).
+ *
+ * Closes the loop between `emitSound` (authoring API; Step 6.1) and the
+ * `audibility` channel (Phase 5). For each `ISound` buffered during a
+ * turn, the dispatcher walks every entity carrying `ListenerTrait`,
+ * calls `propagate(sound, listenerId, world, timestamp)`, and emits one
+ * `sound.audibility.heard` `ISemanticEvent` per (sound × listener) pair
+ * that produced a non-null `IAudibilityEvent`.
+ *
+ * The dispatcher is pure: same buffer + same world state + same
+ * timestamp → same event array. Listeners are processed in entity-id
+ * sort order for deterministic event ordering across turns and runs.
+ *
+ * Owner context: `@sharpee/engine` — runtime / sound subsystem.
+ *
+ * Public interface:
+ *   - `class SoundDispatcher` — the dispatcher itself.
+ *   - `SoundDispatcher.dispatch(buffer, world, timestamp)` — produces
+ *     the `sound.audibility.heard` events for the turn.
+ *
+ * @see ADR-172 — Spatial Sound Propagation
+ * @see ADR-163 — Channel-Service Platform (audibility channel)
+ */
+import { type ISemanticEvent } from "../../core/index";
+import type { IAudibilityEvent, ISound } from "../../if-domain/index";
+import { type WorldModel } from "../../world-model/index";
+/**
+ * Semantic-event type fired by the dispatcher when a listener perceives
+ * a propagated sound. Mirrors `SOUND_EVENT_TYPES.AUDIBILITY_HEARD` in
+ * `@sharpee/stdlib/channels/sound-events`. The constant is duplicated
+ * here as a string literal so the engine package does not depend on
+ * stdlib at compile time (engine → stdlib is the existing dependency
+ * direction; the inverse would be a cycle). The string value is the
+ * contract — both sides must agree.
+ */
+export declare const AUDIBILITY_HEARD_EVENT_TYPE = "sound.audibility.heard";
+/**
+ * Per-turn audibility dispatcher.
+ *
+ * The class shape (rather than a free function) leaves room for a
+ * future propagate-injection point in tests and for caching listener
+ * lookups across multi-action turns. For Phase 6 the dispatcher is a
+ * thin wrapper around `propagate()`; the class structure is the
+ * extension seam for L2's "NPC voice profile" layer.
+ */
+export declare class SoundDispatcher {
+    /**
+     * The propagation function the dispatcher uses. Defaulted to the
+     * production `propagate` from `./propagation`; tests may inject a
+     * fake to isolate dispatcher behavior from edge-graph + Dijkstra
+     * complexity.
+     */
+    private readonly propagate;
+    constructor(propagateFn?: (sound: ISound, listenerId: string, world: WorldModel, timestamp: number) => IAudibilityEvent | null);
+    /**
+     * Dispatch every buffered sound to every listener.
+     *
+     * @param buffer    The per-turn sound buffer; iterated in insertion
+     *                  order. May be empty (quiet turn).
+     * @param world     The world model the propagation function reads
+     *                  from. Must be the same instance the actions
+     *                  mutated during the turn.
+     * @param timestamp The turn-sequence integer the engine assigns to
+     *                  this turn. Used as the `IAudibilityEvent.timestamp`
+     *                  for ordering across multi-emission turns.
+     * @returns         Array of `sound.audibility.heard` events, one per
+     *                  (sound × listener) where `propagate()` returned
+     *                  non-null. Order: outer iteration over the buffer in
+     *                  emission order, inner iteration over listeners
+     *                  sorted by entity id ascending.
+     */
+    dispatch(buffer: readonly ISound[], world: WorldModel, timestamp: number): ISemanticEvent[];
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/sound/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/sound/dispatcher.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGjF;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AAEpE;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAKG;gBAG3B,WAAW,GAAE,CACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,KACd,gBAAgB,GAAG,IAAuB;IAKjD;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CACN,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,cAAc,EAAE;CAsBpB"}

package/sound/dispatcher.js

@@ -0,0 +1,122 @@
+"use strict";
+// packages/engine/src/sound/dispatcher.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoundDispatcher = exports.AUDIBILITY_HEARD_EVENT_TYPE = void 0;
+/**
+ * Per-turn audibility dispatcher (ADR-172 Phase 6).
+ *
+ * Closes the loop between `emitSound` (authoring API; Step 6.1) and the
+ * `audibility` channel (Phase 5). For each `ISound` buffered during a
+ * turn, the dispatcher walks every entity carrying `ListenerTrait`,
+ * calls `propagate(sound, listenerId, world, timestamp)`, and emits one
+ * `sound.audibility.heard` `ISemanticEvent` per (sound × listener) pair
+ * that produced a non-null `IAudibilityEvent`.
+ *
+ * The dispatcher is pure: same buffer + same world state + same
+ * timestamp → same event array. Listeners are processed in entity-id
+ * sort order for deterministic event ordering across turns and runs.
+ *
+ * Owner context: `@sharpee/engine` — runtime / sound subsystem.
+ *
+ * Public interface:
+ *   - `class SoundDispatcher` — the dispatcher itself.
+ *   - `SoundDispatcher.dispatch(buffer, world, timestamp)` — produces
+ *     the `sound.audibility.heard` events for the turn.
+ *
+ * @see ADR-172 — Spatial Sound Propagation
+ * @see ADR-163 — Channel-Service Platform (audibility channel)
+ */
+const core_1 = require("../../core/index.js");
+const world_model_1 = require("../../world-model/index.js");
+const propagation_1 = require("./propagation");
+/**
+ * Semantic-event type fired by the dispatcher when a listener perceives
+ * a propagated sound. Mirrors `SOUND_EVENT_TYPES.AUDIBILITY_HEARD` in
+ * `@sharpee/stdlib/channels/sound-events`. The constant is duplicated
+ * here as a string literal so the engine package does not depend on
+ * stdlib at compile time (engine → stdlib is the existing dependency
+ * direction; the inverse would be a cycle). The string value is the
+ * contract — both sides must agree.
+ */
+exports.AUDIBILITY_HEARD_EVENT_TYPE = 'sound.audibility.heard';
+/**
+ * Per-turn audibility dispatcher.
+ *
+ * The class shape (rather than a free function) leaves room for a
+ * future propagate-injection point in tests and for caching listener
+ * lookups across multi-action turns. For Phase 6 the dispatcher is a
+ * thin wrapper around `propagate()`; the class structure is the
+ * extension seam for L2's "NPC voice profile" layer.
+ */
+class SoundDispatcher {
+    /**
+     * The propagation function the dispatcher uses. Defaulted to the
+     * production `propagate` from `./propagation`; tests may inject a
+     * fake to isolate dispatcher behavior from edge-graph + Dijkstra
+     * complexity.
+     */
+    propagate;
+    constructor(propagateFn = propagation_1.propagate) {
+        this.propagate = propagateFn;
+    }
+    /**
+     * Dispatch every buffered sound to every listener.
+     *
+     * @param buffer    The per-turn sound buffer; iterated in insertion
+     *                  order. May be empty (quiet turn).
+     * @param world     The world model the propagation function reads
+     *                  from. Must be the same instance the actions
+     *                  mutated during the turn.
+     * @param timestamp The turn-sequence integer the engine assigns to
+     *                  this turn. Used as the `IAudibilityEvent.timestamp`
+     *                  for ordering across multi-emission turns.
+     * @returns         Array of `sound.audibility.heard` events, one per
+     *                  (sound × listener) where `propagate()` returned
+     *                  non-null. Order: outer iteration over the buffer in
+     *                  emission order, inner iteration over listeners
+     *                  sorted by entity id ascending.
+     */
+    dispatch(buffer, world, timestamp) {
+        if (buffer.length === 0)
+            return [];
+        const listeners = world
+            .findByTrait(world_model_1.TraitType.LISTENER)
+            .slice()
+            .sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+        if (listeners.length === 0)
+            return [];
+        const events = [];
+        for (const sound of buffer) {
+            for (const listener of listeners) {
+                const audibility = this.propagate(sound, listener.id, world, timestamp);
+                if (!audibility)
+                    continue;
+                events.push(buildAudibilityEvent(audibility, listener.id));
+            }
+        }
+        return events;
+    }
+}
+exports.SoundDispatcher = SoundDispatcher;
+/**
+ * Build the `sound.audibility.heard` semantic event from a propagation
+ * result and the listener that perceived it.
+ *
+ * `entities` mapping:
+ *  - `actor`    → `sourceEntityId` (who emitted the sound)
+ *  - `location` → `sourceRoomId`   (where the sound came from)
+ *  - `target`   → listenerId       (who heard it)
+ *
+ * The `audibility` channel projection (ADR-163, ADR-172 Phase 5) reads
+ * the `IAudibilityEvent` from `event.data`; `entities` is provided for
+ * downstream filters and handlers that want a fast "who heard / from
+ * where" lookup without re-reading `data`.
+ */
+function buildAudibilityEvent(audibility, listenerId) {
+    return (0, core_1.createEvent)(exports.AUDIBILITY_HEARD_EVENT_TYPE, audibility, {
+        actor: audibility.sourceEntityId,
+        location: audibility.sourceRoomId,
+        target: listenerId,
+    });
+}
+//# sourceMappingURL=dispatcher.js.map

package/sound/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/sound/dispatcher.ts"],"names":[],"mappings":";AAAA,0CAA0C;;;AAE1C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wCAAiE;AAEjE,sDAAiF;AACjF,+CAA8D;AAE9D;;;;;;;;GAQG;AACU,QAAA,2BAA2B,GAAG,wBAAwB,CAAC;AAEpE;;;;;;;;GAQG;AACH,MAAa,eAAe;IAC1B;;;;;OAKG;IACc,SAAS,CAKG;IAE7B,YACE,cAK+B,uBAAgB;QAE/C,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CACN,MAAyB,EACzB,KAAiB,EACjB,SAAiB;QAEjB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEnC,MAAM,SAAS,GAAG,KAAK;aACpB,WAAW,CAAC,uBAAS,CAAC,QAAQ,CAAC;aAC/B,KAAK,EAAE;aACP,IAAI,CAAC,CAAC,CAAW,EAAE,CAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEtC,MAAM,MAAM,GAAqB,EAAE,CAAC;QAEpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;gBACxE,IAAI,CAAC,UAAU;oBAAE,SAAS;gBAC1B,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AApED,0CAoEC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,oBAAoB,CAC3B,UAA4B,EAC5B,UAAkB;IAElB,OAAO,IAAA,kBAAW,EAChB,mCAA2B,EAC3B,UAAgD,EAChD;QACE,KAAK,EAAE,UAAU,CAAC,cAAc;QAChC,QAAQ,EAAE,UAAU,CAAC,YAAY;QACjC,MAAM,EAAE,UAAU;KACnB,CACF,CAAC;AACJ,CAAC"}

package/sound/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @sharpee/engine/sound — spatial sound propagation runtime (ADR-172).
+ *
+ * Owner context: engine layer. The propagation function lives here
+ * because it consumes world-model state, doesn't fit in a pure
+ * domain-types layer, and is invoked from the action pipeline (Phase
+ * 6) which is engine-adjacent.
+ *
+ * Public interface:
+ *  - `propagate(sound, listenerId, world, timestamp)` — produce an
+ *    `AudibilityEvent` (or null) for a single listener.
+ *  - `clarityToTier(clarity)` — exposed for testability and for
+ *    composition layers that need to query "what tier does this
+ *    clarity value map to?".
+ *  - `SoundDispatcher` — per-turn fan-out: for each buffered sound,
+ *    propagate to every `ListenerTrait` entity and emit one
+ *    `sound.audibility.heard` semantic event per non-silent result
+ *    (Phase 6 Step 6.2).
+ *  - `AUDIBILITY_HEARD_EVENT_TYPE` — the semantic-event type string
+ *    fired by the dispatcher.
+ *
+ * @see ADR-172 — Spatial Sound Propagation
+ */
+export { propagate, clarityToTier } from './propagation';
+export { SoundDispatcher, AUDIBILITY_HEARD_EVENT_TYPE } from './dispatcher';
+//# sourceMappingURL=index.d.ts.map

package/sound/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/sound/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC"}

package/sound/index.js

@@ -0,0 +1,34 @@
+"use strict";
+// packages/engine/src/sound/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUDIBILITY_HEARD_EVENT_TYPE = exports.SoundDispatcher = exports.clarityToTier = exports.propagate = void 0;
+/**
+ * @sharpee/engine/sound — spatial sound propagation runtime (ADR-172).
+ *
+ * Owner context: engine layer. The propagation function lives here
+ * because it consumes world-model state, doesn't fit in a pure
+ * domain-types layer, and is invoked from the action pipeline (Phase
+ * 6) which is engine-adjacent.
+ *
+ * Public interface:
+ *  - `propagate(sound, listenerId, world, timestamp)` — produce an
+ *    `AudibilityEvent` (or null) for a single listener.
+ *  - `clarityToTier(clarity)` — exposed for testability and for
+ *    composition layers that need to query "what tier does this
+ *    clarity value map to?".
+ *  - `SoundDispatcher` — per-turn fan-out: for each buffered sound,
+ *    propagate to every `ListenerTrait` entity and emit one
+ *    `sound.audibility.heard` semantic event per non-silent result
+ *    (Phase 6 Step 6.2).
+ *  - `AUDIBILITY_HEARD_EVENT_TYPE` — the semantic-event type string
+ *    fired by the dispatcher.
+ *
+ * @see ADR-172 — Spatial Sound Propagation
+ */
+var propagation_1 = require("./propagation");
+Object.defineProperty(exports, "propagate", { enumerable: true, get: function () { return propagation_1.propagate; } });
+Object.defineProperty(exports, "clarityToTier", { enumerable: true, get: function () { return propagation_1.clarityToTier; } });
+var dispatcher_1 = require("./dispatcher");
+Object.defineProperty(exports, "SoundDispatcher", { enumerable: true, get: function () { return dispatcher_1.SoundDispatcher; } });
+Object.defineProperty(exports, "AUDIBILITY_HEARD_EVENT_TYPE", { enumerable: true, get: function () { return dispatcher_1.AUDIBILITY_HEARD_EVENT_TYPE; } });
+//# sourceMappingURL=index.js.map

package/sound/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/sound/index.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AAErC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,6CAAyD;AAAhD,wGAAA,SAAS,OAAA;AAAE,4GAAA,aAAa,OAAA;AACjC,2CAA4E;AAAnE,6GAAA,eAAe,OAAA;AAAE,yHAAA,2BAA2B,OAAA"}

package/sound/propagation.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Spatial sound propagation function (ADR-172 Phase 3).
+ *
+ * Pure logic: given a `Sound` emission, a listener entity-id, and the
+ * world-model, returns the `AudibilityEvent` the listener perceives —
+ * or `null` if the sound is silent at the listener's location.
+ *
+ * The function is structured around three pieces:
+ *
+ *  1. **Edge-graph construction** (`getAcousticEdges`) — for any room,
+ *     enumerate the rooms it's acoustically connected to, with each
+ *     edge's cost. Today's edge sources are exits-with-doors and walls
+ *     (per ADR-173). Future acoustic conduits ride on the same shape
+ *     without changes here.
+ *
+ *  2. **Path search** (`findShortestAcousticPath`) — Dijkstra from
+ *     source room to listener's room. Path cost = sum of edge costs +
+ *     1 unit per intermediate room. Wall edges traversed are recorded
+ *     so the resulting `AudibilityEvent` can name a wall when the path
+ *     crosses exactly one.
+ *
+ *  3. **Clarity → tier mapping** (`clarityToTier`) — the ADR-172
+ *     audibility-tier table.
+ *
+ * The propagation function does *not* enumerate listeners — that is
+ * Phase 5/6's dispatcher. This file is `propagate(sound, listenerId,
+ * world, timestamp) → event | null`, intended to be called per
+ * listener.
+ *
+ * Owner context: `@sharpee/engine` — runtime / sound subsystem.
+ *
+ * @see ADR-172 — Spatial Sound Propagation
+ * @see ADR-173 — Wall Adjacency Primitive (substrate)
+ */
+import type { EntityId } from "../../core/index";
+import { type AudibilityTier, type IAudibilityEvent, type ISound } from "../../if-domain/index";
+import { WorldModel } from "../../world-model/index";
+/**
+ * Propagate a sound emission to a single listener.
+ *
+ * Returns an `AudibilityEvent` for the listener if the sound reaches
+ * them at any tier above `silent`; returns `null` if the sound is
+ * silent at the listener's location (no reachable path, cost too high
+ * for the volume budget, or the listener has no resolvable room).
+ *
+ * Same-room emissions short-circuit to `full` audibility regardless of
+ * intervening boundaries (degenerate case from ADR-172 §Propagation
+ * function step 5).
+ *
+ * @param sound        The emission shape.
+ * @param listenerId   The entity id of the listener.
+ * @param world        The world-model carrying rooms, walls, doors,
+ *                     and obstructors.
+ * @param timestamp    Engine-provided turn-sequence integer for event
+ *                     ordering. Phase 6's dispatcher threads this from
+ *                     the turn manager.
+ */
+export declare function propagate(sound: ISound, listenerId: EntityId, world: WorldModel, timestamp: number): IAudibilityEvent | null;
+/**
+ * Map a clarity value (volume budget − accumulated path cost) to the
+ * ADR-172 audibility tier table.
+ *
+ * Exposed for testability and so that future composition layers can
+ * reuse the mapping (e.g., a conversation-choreography layer that
+ * wants to show a "what would the audibility be at this volume from
+ * here?" debug overlay).
+ */
+export declare function clarityToTier(clarity: number): AudibilityTier;
+//# sourceMappingURL=propagation.d.ts.map

package/sound/propagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/sound/propagation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,MAAM,EACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAUL,UAAU,EACX,MAAM,sBAAsB,CAAC;AAM9B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,QAAQ,EACpB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,gBAAgB,GAAG,IAAI,CAuBzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAM7D"}

package/sound/propagation.js

@@ -0,0 +1,219 @@
+"use strict";
+// packages/engine/src/sound/propagation.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.propagate = propagate;
+exports.clarityToTier = clarityToTier;
+const if_domain_1 = require("../../if-domain/index.js");
+const world_model_1 = require("../../world-model/index.js");
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Propagate a sound emission to a single listener.
+ *
+ * Returns an `AudibilityEvent` for the listener if the sound reaches
+ * them at any tier above `silent`; returns `null` if the sound is
+ * silent at the listener's location (no reachable path, cost too high
+ * for the volume budget, or the listener has no resolvable room).
+ *
+ * Same-room emissions short-circuit to `full` audibility regardless of
+ * intervening boundaries (degenerate case from ADR-172 §Propagation
+ * function step 5).
+ *
+ * @param sound        The emission shape.
+ * @param listenerId   The entity id of the listener.
+ * @param world        The world-model carrying rooms, walls, doors,
+ *                     and obstructors.
+ * @param timestamp    Engine-provided turn-sequence integer for event
+ *                     ordering. Phase 6's dispatcher threads this from
+ *                     the turn manager.
+ */
+function propagate(sound, listenerId, world, timestamp) {
+    const listenerRoom = locateRoom(world, listenerId);
+    if (!listenerRoom)
+        return null;
+    // Same-room: full audibility, no wall, no path search.
+    if (sound.sourceLocation === listenerRoom) {
+        return buildAudibilityEvent(sound, listenerRoom, undefined, 'full', timestamp);
+    }
+    const path = findShortestAcousticPath(sound.sourceLocation, listenerRoom, world);
+    if (!path)
+        return null;
+    const budget = if_domain_1.VOLUME_TIER_BUDGETS[sound.volumeTier];
+    const clarity = budget - path.cost;
+    const tier = clarityToTier(clarity);
+    if (tier === 'silent')
+        return null;
+    // Per ADR-172 AudibilityEvent shape: `wallId` is set when the path
+    // crosses exactly one wall. Multi-wall and zero-wall (door-only)
+    // paths leave it undefined.
+    const wallId = path.wallEdges.length === 1 ? path.wallEdges[0] : undefined;
+    return buildAudibilityEvent(sound, listenerRoom, wallId, tier, timestamp);
+}
+/**
+ * Map a clarity value (volume budget − accumulated path cost) to the
+ * ADR-172 audibility tier table.
+ *
+ * Exposed for testability and so that future composition layers can
+ * reuse the mapping (e.g., a conversation-choreography layer that
+ * wants to show a "what would the audibility be at this volume from
+ * here?" debug overlay).
+ */
+function clarityToTier(clarity) {
+    if (clarity >= 4)
+        return 'full';
+    if (clarity === 3)
+        return 'muffled';
+    if (clarity === 2)
+        return 'fragments';
+    if (clarity === 1)
+        return 'presence-only';
+    return 'silent';
+}
+// =============================================================================
+// Internal: room resolution
+// =============================================================================
+function locateRoom(world, entityId) {
+    const entity = world.getEntity(entityId);
+    if (!entity)
+        return undefined;
+    if (entity.has(world_model_1.TraitType.ROOM))
+        return entityId;
+    return world.getContainingRoom(entityId)?.id;
+}
+function getAcousticEdges(roomId, world) {
+    const room = world.getEntity(roomId);
+    if (!room)
+        return [];
+    const roomTrait = room.get(world_model_1.TraitType.ROOM);
+    if (!roomTrait)
+        return [];
+    const edges = [];
+    // Exits — each direction may carry a door whose state determines cost.
+    if (roomTrait.exits) {
+        for (const exit of Object.values(roomTrait.exits)) {
+            if (!exit)
+                continue;
+            const cost = exitAcousticCost(exit, world);
+            edges.push({ to: exit.destination, cost });
+        }
+    }
+    // Walls — effective cost combines AcousticTrait base + obstructor
+    // dampener contributions per ADR-173's generalized obstructor protocol.
+    if (roomTrait.walls) {
+        for (const wallId of roomTrait.walls) {
+            const wall = world.getEntity(wallId);
+            if (!(wall instanceof world_model_1.WallEntity))
+                continue;
+            const otherRoom = wall.otherRoom(roomId);
+            if (!otherRoom)
+                continue;
+            const cost = wallEffectiveAcousticCost(wall, world);
+            // Soundproof walls (cost = ∞) contribute no usable edge — drop
+            // them rather than feeding Infinity into Dijkstra.
+            if (!Number.isFinite(cost))
+                continue;
+            edges.push({ to: otherRoom, cost, wallId });
+        }
+    }
+    // Future: acoustic conduits (separate ADR) plug in here.
+    return edges;
+}
+function exitAcousticCost(exit, world) {
+    if (!exit.via)
+        return 1; // open passage, no door
+    const door = world.getEntity(exit.via);
+    if (!door)
+        return 1;
+    if (!door.has(world_model_1.TraitType.OPENABLE))
+        return 1; // door without state = always open
+    const openable = door.get(world_model_1.TraitType.OPENABLE);
+    return openable?.isOpen ? 1 : 4;
+}
+function wallEffectiveAcousticCost(wall, world) {
+    const acoustic = wall.get(world_model_1.TraitType.ACOUSTIC);
+    const baseTier = acoustic?.tier ?? 'default';
+    const baseCost = world_model_1.ACOUSTIC_TIER_COSTS[baseTier];
+    if (!Number.isFinite(baseCost))
+        return Number.POSITIVE_INFINITY;
+    // Cross-side aggregation per ADR-172 effective_cost formula:
+    // base + Σ AcousticDampenerTrait.contribution for each side's
+    // currently-located obstructor.
+    const dampeners = (0, world_model_1.findTraitsOnObstructors)(wall, world_model_1.TraitType.ACOUSTIC_DAMPENER, world);
+    const contribution = dampeners.reduce((sum, m) => sum + m.trait.contribution, 0);
+    // Negative effective cost (a hole / amplifier / extreme conduit)
+    // clamps to 0 — sound passes the wall as if it weren't there, but
+    // we don't amplify beyond the volume budget.
+    return Math.max(0, baseCost + contribution);
+}
+function findShortestAcousticPath(source, target, world) {
+    if (source === target)
+        return { cost: 0, wallEdges: [] };
+    const dist = new Map();
+    const prev = new Map();
+    const visited = new Set();
+    dist.set(source, 0);
+    while (true) {
+        // Pick unvisited node with minimum tentative distance.
+        let current;
+        let currentDist = Number.POSITIVE_INFINITY;
+        for (const [node, d] of dist) {
+            if (!visited.has(node) && d < currentDist) {
+                current = node;
+                currentDist = d;
+            }
+        }
+        if (!current || !Number.isFinite(currentDist))
+            break;
+        if (current === target)
+            break;
+        visited.add(current);
+        const edges = getAcousticEdges(current, world);
+        for (const edge of edges) {
+            if (visited.has(edge.to))
+                continue;
+            // Room-traversal cost: 1 per *intermediate* room. The source
+            // room contributes 0; every subsequent leg adds 1 to account
+            // for traversing the room we're leaving from.
+            const traversalCost = current === source ? 0 : 1;
+            const tentative = currentDist + traversalCost + edge.cost;
+            const known = dist.get(edge.to) ?? Number.POSITIVE_INFINITY;
+            if (tentative < known) {
+                dist.set(edge.to, tentative);
+                prev.set(edge.to, { from: current, wallId: edge.wallId });
+            }
+        }
+    }
+    const finalCost = dist.get(target);
+    if (finalCost === undefined || !Number.isFinite(finalCost))
+        return null;
+    // Reconstruct wall edges along the chosen path.
+    const wallEdges = [];
+    let cur = target;
+    while (cur && cur !== source) {
+        const p = prev.get(cur);
+        if (!p)
+            return null;
+        if (p.wallId)
+            wallEdges.push(p.wallId);
+        cur = p.from;
+    }
+    return { cost: finalCost, wallEdges };
+}
+// =============================================================================
+// Internal: AudibilityEvent construction
+// =============================================================================
+function buildAudibilityEvent(sound, listenerRoom, wallId, tier, timestamp) {
+    return {
+        sourceRoomId: sound.sourceLocation,
+        targetRoomId: listenerRoom,
+        wallId,
+        sourceEntityId: sound.sourceEntity,
+        kind: sound.kind,
+        volumeTier: sound.volumeTier,
+        audibilityTier: tier,
+        content: sound.content,
+        timestamp,
+    };
+}
+//# sourceMappingURL=propagation.js.map

package/sound/propagation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propagation.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/sound/propagation.ts"],"names":[],"mappings":"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"}

package/story.d.ts

@@ -2,7 +2,7 @@
  * Story configuration and interfaces
  */
 import { WorldModel, IFEntity, IGameEvent, SimpleEventHandler } from "../world-model/index";
-import { LanguageProvider } from "../if-domain/index";
+import { LanguageProvider, IChannelRegistry } from "../if-domain/index";
 import { Parser } from "../stdlib/index";
 import { ISemanticEvent } from "../core/index";
 import type { GameEngine } from './game-engine';
@@ -23,6 +23,16 @@ export interface StoryConfig {
      * Story author(s)
      */
     author: string | string[];
+    /**
+     * Credit lines for the opening banner's `author-list` section. Each
+     * string becomes one `author-list`-classed paragraph. Use this when
+     * the banner needs distinct credit lines (e.g., a primary author
+     * line plus a "Ported by …" line, or multiple separate roles).
+     *
+     * When omitted, the engine falls back to a single `author-list`
+     * entry built from `author` (joined with ", " if it's an array).
+     */
+    credits?: string[];
     /**
      * Story version (semantic version, e.g., "1.0.0" or "1.0.0-beta")
      */
@@ -185,6 +195,23 @@ export interface Story {
      * @param engine - The fully initialized game engine
      */
     onEngineReady?(engine: GameEngine): void;
+    /**
+     * Register or override channels on the platform's channel registry
+     * (ADR-163 §6, §7, §14). Invoked by `engine.start()` before the
+     * `ChannelService` is constructed.
+     *
+     * Stories use this hook to:
+     *  - Add story-specific channels (e.g., a `debug-stats` JSON channel
+     *    for renderer overlays).
+     *  - Override a standard channel by re-registering an `IOChannel`
+     *    with the same id (last-write-wins per ADR-163 §6).
+     *  - Register dynamic image / ambient channels via stdlib's
+     *    `createImageChannel` / `createAmbientChannel` builders.
+     *
+     * The registry passed in is the same instance for the lifetime of
+     * the engine. Re-registrations persist across the session.
+     */
+    registerChannels?(registry: IChannelRegistry): void;
 }
 /**
  * Extended story class with event handling capabilities

package/story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/engine/src/story.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/engine/src/story.ts"],"names":[],"mappings":"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"}

package/story.js.map

@@ -1 +1 @@
-{"version":3,"file":"story.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/story.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAyQH,kDAUC;AA9QD,0DAAsD;AAqNtD;;GAEG;AACH,MAAa,eAAe;IAC1B,MAAM,CAAc;IACZ,YAAY,CAAe;IAEnC,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,IAAI,4BAAY,EAAE,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,EAAE,CAAC,SAAiB,EAAE,OAA2B;QAC/C,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,OAA2B;QAChD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,KAAiB;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,0DAA0D;IAC1D,eAAe,CAAC,KAAiB;QAC/B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,YAAY,CAAC,KAAiB;QAC5B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;CACF;AAvCD,0CAuCC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAmB;IACrD,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,gFAAgF;IAChF,MAAM,YAAY,GAAG,mCAAmC,CAAC;IACzD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;AACH,CAAC"}
+{"version":3,"file":"story.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/story.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAsSH,kDAUC;AA3SD,0DAAsD;AAkPtD;;GAEG;AACH,MAAa,eAAe;IAC1B,MAAM,CAAc;IACZ,YAAY,CAAe;IAEnC,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,IAAI,4BAAY,EAAE,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,EAAE,CAAC,SAAiB,EAAE,OAA2B;QAC/C,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,OAA2B;QAChD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,KAAiB;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,0DAA0D;IAC1D,eAAe,CAAC,KAAiB;QAC/B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,YAAY,CAAC,KAAiB;QAC5B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;CACF;AAvCD,0CAuCC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAmB;IACrD,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,gFAAgF;IAChF,MAAM,YAAY,GAAG,mCAAmC,CAAC;IACzD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;AACH,CAAC"}