@sharpee/world-model 0.9.110 → 0.9.113

package/capabilities/action-interceptor.d.ts

@@ -10,6 +10,7 @@
  * - CapabilityBehavior: Full delegation, trait owns ALL logic (LOWER, RAISE)
  * - ActionInterceptor: Hooks into phases, action owns core logic (ENTER, PUT)
  */
+import { ISemanticEvent } from "../../core/index";
 import { IFEntity } from '../entities';
 import { WorldModel } from '../world';
 import { CapabilityEffect } from './types';
@@ -34,6 +35,98 @@ export interface InterceptorResult {
     /** Additional context for error messages */
     params?: Record<string, unknown>;
 }
+/**
+ * Result returned by `ActionInterceptor.postReport` (ISSUE-074).
+ *
+ * Distinguishes two semantically different intents that the old
+ * entity-`on` system collapsed onto a single `Effect[]` shape:
+ *
+ * 1. `override` — replace the primary domain event's `messageId`
+ *    (and optional params). Use when the interceptor's narration
+ *    *substitutes* for the action's standard message. Example: rug push
+ *    reveals the trap door — the rug-reveal text replaces the generic
+ *    "you give the rug a push" line.
+ *
+ * 2. `emit` — additional events to render alongside the action's
+ *    standard ones. Use for side-channel narration (multi-line
+ *    consequences) or events that are not message overrides.
+ *
+ * Both fields are optional and independent. Return `{}` (or simply
+ * an empty object literal) when the interceptor has nothing to do.
+ *
+ * Mirrors the override semantic that `event-processor.invokeEntityHandlers()`
+ * applies to single `game.message` reactions from story-level handlers
+ * (ADR-106), making the same intent explicit at the interceptor contract.
+ *
+ * @see applyInterceptorReportResult
+ */
+export interface InterceptorReportResult {
+    /** Override the primary domain event's messageId (and optional params/text).
+     *
+     *  - `messageId`: replaces the primary event's `data.messageId`.
+     *  - `params` (optional): replaces the primary event's `data.params`.
+     *  - `text` (optional): replaces the primary event's `data.text`. Used
+     *    when the interceptor has a pre-rendered string and wants the
+     *    text-service to fall back to it if `messageId` doesn't resolve
+     *    to a language template (mirrors the inline-text fallback in
+     *    `event-processor.ts`'s entity-handler override path).
+     *
+     *  Multiple interceptors returning `override` for the same action is a
+     *  hard error mirroring ADR-106's "multiple game.message reactions" rule. */
+    override?: {
+        messageId: string;
+        params?: Record<string, unknown>;
+        text?: string;
+    };
+    /** Emit additional events alongside the action's standard events. */
+    emit?: CapabilityEffect[];
+}
+/**
+ * Minimal context shape required by `applyInterceptorReportResult`.
+ *
+ * Real action contexts (both the engine's closure-based factory and the
+ * stdlib's class-based `EnhancedActionContext`) satisfy this structurally
+ * by exposing `event(type, data)`. Passing the *context object* — rather
+ * than an unbound `context.event` callback — preserves `this` for the
+ * class-based implementation, which would otherwise crash inside
+ * `createEventInternal`. Callers cannot forget to bind because there is
+ * nothing to bind.
+ */
+export interface InterceptorEventContext {
+    event(type: string, data: Record<string, any>): ISemanticEvent;
+}
+/**
+ * Apply an interceptor's `postReport` result to an action's emitted events.
+ *
+ * - If `result.override` is set, copies `messageId` (and optional `params`/`text`)
+ *   onto the data of the event whose type matches `primaryEventType`.
+ * - If `result.emit` is set, converts each effect to an `ISemanticEvent`
+ *   via `context.event(...)` and appends to `events`.
+ *
+ * The action's `report()` phase is responsible for calling this helper
+ * with the events array it has built so far, the event type that
+ * carries the standard message (e.g. `'if.event.pushed'`), and the
+ * action context whose `event(...)` method produces events with proper
+ * entity bindings.
+ *
+ * @param events - The action's events array; mutated in place.
+ * @param primaryEventType - The event type whose `messageId` an `override`
+ *                           should replace (e.g. `'if.event.pushed'`).
+ * @param result - The value returned from `interceptor.postReport`.
+ * @param context - The action context (any object exposing
+ *                  `event(type, data)`).
+ *
+ * @example
+ * ```typescript
+ * // In the pushing action's report() phase, after pushing the standard
+ * // if.event.pushed onto events:
+ * if (interceptor?.postReport) {
+ *   const result = interceptor.postReport(target, world, actorId, interceptorData);
+ *   applyInterceptorReportResult(events, 'if.event.pushed', result, context);
+ * }
+ * ```
+ */
+export declare function applyInterceptorReportResult(events: ISemanticEvent[], primaryEventType: string, result: InterceptorReportResult, context: InterceptorEventContext): void;
 /**
  * Action interceptor interface.
  *
@@ -138,17 +231,40 @@ export interface ActionInterceptor {
     /**
      * Called AFTER standard report.
      *
-     * Return additional effects to emit after the standard effects.
-     * Return empty array if no additional effects needed.
+     * Return an `InterceptorReportResult` that declares either:
+     * - `override`: replace the primary domain event's `messageId` (so the
+     *   interceptor's narration *substitutes* for the standard message), or
+     * - `emit`: additional events to render alongside the standard ones, or
+     * - both, or neither (return `{}` for no-op).
+     *
+     * Use `override` when the interceptor's message should *replace* the
+     * action's default text. Use `emit` for side-channel narration or
+     * non-message events.
+     *
+     * The action's `report()` phase applies the result via
+     * `applyInterceptorReportResult` (see helper below).
+     *
+     * @example
+     * // Override: rug push reveals trap door — the rug-reveal text
+     * // replaces the generic "you give the rug a push" message.
+     * postReport(entity, world, actorId, sharedData) {
+     *   if (!sharedData.rugRevealed) return {};
+     *   return { override: { messageId: 'dungeo.rug.moved.reveal_trapdoor' } };
+     * }
      *
      * @example
-     * // Add glacier melting message
+     * // Emit: ghost ritual narrates two consecutive lines.
      * postReport(entity, world, actorId, sharedData) {
-     *   if (!sharedData.melted) return [];
-     *   return [createEffect('dungeo.glacier.melted', { messageId: 'dungeo.glacier.melts' })];
+     *   if (!sharedData.ritualCompleted) return {};
+     *   return {
+     *     emit: [
+     *       createEffect('game.message', { messageId: 'dungeo.ghost.appears' }),
+     *       createEffect('game.message', { messageId: 'dungeo.ghost.canvas_spawns' })
+     *     ]
+     *   };
      * }
      */
-    postReport?(entity: IFEntity, world: WorldModel, actorId: string, sharedData: InterceptorSharedData): CapabilityEffect[];
+    postReport?(entity: IFEntity, world: WorldModel, actorId: string, sharedData: InterceptorSharedData): InterceptorReportResult;
     /**
      * Called when action is blocked (validation failed).
      *

package/capabilities/action-interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-interceptor.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/capabilities/action-interceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,iBAAiB,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CAAC,CACX,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,iBAAiB,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,IAAI,CAAC;IAER;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,CACT,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,gBAAgB,EAAE,CAAC;IAEtB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,CACR,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,qBAAqB,GAChC,gBAAgB,EAAE,GAAG,IAAI,CAAC;CAC9B"}
+{"version":3,"file":"action-interceptor.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/capabilities/action-interceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;iFAW6E;IAC7E,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,qEAAqE;IACrE,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAAC;CAChE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,cAAc,EAAE,EACxB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CA4BN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,iBAAiB,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CAAC,CACX,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,iBAAiB,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,IAAI,CAAC;IAER;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,UAAU,CAAC,CACT,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,uBAAuB,CAAC;IAE3B;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,CACR,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,qBAAqB,GAChC,gBAAgB,EAAE,GAAG,IAAI,CAAC;CAC9B"}

package/capabilities/action-interceptor.js

@@ -12,4 +12,63 @@
  * - ActionInterceptor: Hooks into phases, action owns core logic (ENTER, PUT)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyInterceptorReportResult = applyInterceptorReportResult;
+/**
+ * Apply an interceptor's `postReport` result to an action's emitted events.
+ *
+ * - If `result.override` is set, copies `messageId` (and optional `params`/`text`)
+ *   onto the data of the event whose type matches `primaryEventType`.
+ * - If `result.emit` is set, converts each effect to an `ISemanticEvent`
+ *   via `context.event(...)` and appends to `events`.
+ *
+ * The action's `report()` phase is responsible for calling this helper
+ * with the events array it has built so far, the event type that
+ * carries the standard message (e.g. `'if.event.pushed'`), and the
+ * action context whose `event(...)` method produces events with proper
+ * entity bindings.
+ *
+ * @param events - The action's events array; mutated in place.
+ * @param primaryEventType - The event type whose `messageId` an `override`
+ *                           should replace (e.g. `'if.event.pushed'`).
+ * @param result - The value returned from `interceptor.postReport`.
+ * @param context - The action context (any object exposing
+ *                  `event(type, data)`).
+ *
+ * @example
+ * ```typescript
+ * // In the pushing action's report() phase, after pushing the standard
+ * // if.event.pushed onto events:
+ * if (interceptor?.postReport) {
+ *   const result = interceptor.postReport(target, world, actorId, interceptorData);
+ *   applyInterceptorReportResult(events, 'if.event.pushed', result, context);
+ * }
+ * ```
+ */
+function applyInterceptorReportResult(events, primaryEventType, result, context) {
+    if (result.override) {
+        const primary = events.find((e) => e.type === primaryEventType);
+        if (primary) {
+            const data = primary.data;
+            data.messageId = result.override.messageId;
+            if (result.override.params) {
+                data.params = result.override.params;
+            }
+            if (result.override.text) {
+                data.text = result.override.text;
+            }
+        }
+        else {
+            // Defensive: an interceptor asked for an override but the action
+            // didn't emit a primary event of that type. Either the action's
+            // contract changed or the interceptor is misconfigured.
+            console.warn(`applyInterceptorReportResult: override requested for primary event type ` +
+                `"${primaryEventType}" but no event of that type was found in the events array.`);
+        }
+    }
+    if (result.emit) {
+        for (const effect of result.emit) {
+            events.push(context.event(effect.type, effect.payload));
+        }
+    }
+}
 //# sourceMappingURL=action-interceptor.js.map

package/capabilities/action-interceptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-interceptor.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/capabilities/action-interceptor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}
+{"version":3,"file":"action-interceptor.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/capabilities/action-interceptor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AA4HH,oEAiCC;AAhED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,4BAA4B,CAC1C,MAAwB,EACxB,gBAAwB,EACxB,MAA+B,EAC/B,OAAgC;IAEhC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;QAChE,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,OAAO,CAAC,IAA+B,CAAC;YACrD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvC,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACnC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,iEAAiE;YACjE,gEAAgE;YAChE,wDAAwD;YACxD,OAAO,CAAC,IAAI,CACV,0EAA0E;gBAC1E,IAAI,gBAAgB,4DAA4D,CACjF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;AACH,CAAC"}

package/capabilities/index.d.ts

@@ -10,7 +10,7 @@ export { TraitBehaviorBinding, BehaviorRegistrationOptions, registerCapabilityBe
 export { CapabilityResolution, CapabilityMode, CapabilityConfig, defineCapabilityDefaults, getCapabilityConfig, hasCapabilityDefaults, clearCapabilityDefaults, getAllCapabilityDefaults } from './capability-defaults';
 export { findTraitWithCapability, hasCapability, getEntityCapabilities, traitHasCapability, getCapableTraits } from './capability-helpers';
 export { EntityBuilder, buildEntity } from './entity-builder';
-export { ActionInterceptor, InterceptorSharedData, InterceptorResult } from './action-interceptor';
+export { ActionInterceptor, InterceptorSharedData, InterceptorResult, InterceptorReportResult, InterceptorEventContext, applyInterceptorReportResult } from './action-interceptor';
 export { TraitInterceptorBinding, InterceptorRegistrationOptions, InterceptorLookupResult, registerActionInterceptor, getInterceptorForAction, getInterceptorBinding, hasActionInterceptor, unregisterActionInterceptor, clearInterceptorRegistry, getAllInterceptorBindings } from './interceptor-registry';
 export { findTraitWithInterceptor, hasInterceptor, getEntityInterceptors, traitHasInterceptor, getInterceptorTraits } from './interceptor-helpers';
 //# sourceMappingURL=index.d.ts.map

package/capabilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGjF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,aAAa,EACb,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAW1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGjF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,aAAa,EACb,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAW1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC"}

package/capabilities/index.js

@@ -6,7 +6,7 @@
  * (action IDs they respond to) and behaviors implement the logic.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getInterceptorTraits = exports.traitHasInterceptor = exports.getEntityInterceptors = exports.hasInterceptor = exports.findTraitWithInterceptor = exports.getAllInterceptorBindings = exports.clearInterceptorRegistry = exports.unregisterActionInterceptor = exports.hasActionInterceptor = exports.getInterceptorBinding = exports.getInterceptorForAction = exports.registerActionInterceptor = exports.buildEntity = exports.EntityBuilder = exports.getCapableTraits = exports.traitHasCapability = exports.getEntityCapabilities = exports.hasCapability = exports.findTraitWithCapability = exports.getAllCapabilityDefaults = exports.clearCapabilityDefaults = exports.hasCapabilityDefaults = exports.getCapabilityConfig = exports.defineCapabilityDefaults = exports.getAllCapabilityBindings = exports.clearCapabilityRegistry = exports.unregisterCapabilityBehavior = exports.hasCapabilityBehavior = exports.getBehaviorBinding = exports.getBehaviorForCapability = exports.registerCapabilityBehavior = exports.createEffect = void 0;
+exports.getInterceptorTraits = exports.traitHasInterceptor = exports.getEntityInterceptors = exports.hasInterceptor = exports.findTraitWithInterceptor = exports.getAllInterceptorBindings = exports.clearInterceptorRegistry = exports.unregisterActionInterceptor = exports.hasActionInterceptor = exports.getInterceptorBinding = exports.getInterceptorForAction = exports.registerActionInterceptor = exports.applyInterceptorReportResult = exports.buildEntity = exports.EntityBuilder = exports.getCapableTraits = exports.traitHasCapability = exports.getEntityCapabilities = exports.hasCapability = exports.findTraitWithCapability = exports.getAllCapabilityDefaults = exports.clearCapabilityDefaults = exports.hasCapabilityDefaults = exports.getCapabilityConfig = exports.defineCapabilityDefaults = exports.getAllCapabilityBindings = exports.clearCapabilityRegistry = exports.unregisterCapabilityBehavior = exports.hasCapabilityBehavior = exports.getBehaviorBinding = exports.getBehaviorForCapability = exports.registerCapabilityBehavior = exports.createEffect = void 0;
 // Types
 var types_1 = require("./types");
 Object.defineProperty(exports, "createEffect", { enumerable: true, get: function () { return types_1.createEffect; } });
@@ -37,6 +37,16 @@ Object.defineProperty(exports, "getCapableTraits", { enumerable: true, get: func
 var entity_builder_1 = require("./entity-builder");
 Object.defineProperty(exports, "EntityBuilder", { enumerable: true, get: function () { return entity_builder_1.EntityBuilder; } });
 Object.defineProperty(exports, "buildEntity", { enumerable: true, get: function () { return entity_builder_1.buildEntity; } });
+// ============================================================================
+// Action Interceptors (ADR-118)
+//
+// Interceptors allow traits to hook into stdlib action phases without
+// replacing standard logic. This complements capability behaviors which
+// provide full delegation.
+// ============================================================================
+// Interceptor interface
+var action_interceptor_1 = require("./action-interceptor");
+Object.defineProperty(exports, "applyInterceptorReportResult", { enumerable: true, get: function () { return action_interceptor_1.applyInterceptorReportResult; } });
 // Interceptor registry
 var interceptor_registry_1 = require("./interceptor-registry");
 Object.defineProperty(exports, "registerActionInterceptor", { enumerable: true, get: function () { return interceptor_registry_1.registerActionInterceptor; } });

package/capabilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/capabilities/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,QAAQ;AACR,iCAIiB;AADf,qGAAA,YAAY,OAAA;AAMd,WAAW;AACX,6DAU+B;AAP7B,iIAAA,0BAA0B,OAAA;AAC1B,+HAAA,wBAAwB,OAAA;AACxB,yHAAA,kBAAkB,OAAA;AAClB,4HAAA,qBAAqB,OAAA;AACrB,mIAAA,4BAA4B,OAAA;AAC5B,8HAAA,uBAAuB,OAAA;AACvB,+HAAA,wBAAwB,OAAA;AAG1B,6BAA6B;AAC7B,6DAS+B;AAL7B,+HAAA,wBAAwB,OAAA;AACxB,0HAAA,mBAAmB,OAAA;AACnB,4HAAA,qBAAqB,OAAA;AACrB,8HAAA,uBAAuB,OAAA;AACvB,+HAAA,wBAAwB,OAAA;AAG1B,UAAU;AACV,2DAM8B;AAL5B,6HAAA,uBAAuB,OAAA;AACvB,mHAAA,aAAa,OAAA;AACb,2HAAA,qBAAqB,OAAA;AACrB,wHAAA,kBAAkB,OAAA;AAClB,sHAAA,gBAAgB,OAAA;AAGlB,iBAAiB;AACjB,mDAG0B;AAFxB,+GAAA,aAAa,OAAA;AACb,6GAAA,WAAW,OAAA;AAkBb,uBAAuB;AACvB,+DAWgC;AAP9B,iIAAA,yBAAyB,OAAA;AACzB,+HAAA,uBAAuB,OAAA;AACvB,6HAAA,qBAAqB,OAAA;AACrB,4HAAA,oBAAoB,OAAA;AACpB,mIAAA,2BAA2B,OAAA;AAC3B,gIAAA,wBAAwB,OAAA;AACxB,iIAAA,yBAAyB,OAAA;AAG3B,sBAAsB;AACtB,6DAM+B;AAL7B,+HAAA,wBAAwB,OAAA;AACxB,qHAAA,cAAc,OAAA;AACd,4HAAA,qBAAqB,OAAA;AACrB,0HAAA,mBAAmB,OAAA;AACnB,2HAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/capabilities/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,QAAQ;AACR,iCAIiB;AADf,qGAAA,YAAY,OAAA;AAMd,WAAW;AACX,6DAU+B;AAP7B,iIAAA,0BAA0B,OAAA;AAC1B,+HAAA,wBAAwB,OAAA;AACxB,yHAAA,kBAAkB,OAAA;AAClB,4HAAA,qBAAqB,OAAA;AACrB,mIAAA,4BAA4B,OAAA;AAC5B,8HAAA,uBAAuB,OAAA;AACvB,+HAAA,wBAAwB,OAAA;AAG1B,6BAA6B;AAC7B,6DAS+B;AAL7B,+HAAA,wBAAwB,OAAA;AACxB,0HAAA,mBAAmB,OAAA;AACnB,4HAAA,qBAAqB,OAAA;AACrB,8HAAA,uBAAuB,OAAA;AACvB,+HAAA,wBAAwB,OAAA;AAG1B,UAAU;AACV,2DAM8B;AAL5B,6HAAA,uBAAuB,OAAA;AACvB,mHAAA,aAAa,OAAA;AACb,2HAAA,qBAAqB,OAAA;AACrB,wHAAA,kBAAkB,OAAA;AAClB,sHAAA,gBAAgB,OAAA;AAGlB,iBAAiB;AACjB,mDAG0B;AAFxB,+GAAA,aAAa,OAAA;AACb,6GAAA,WAAW,OAAA;AAGb,+EAA+E;AAC/E,gCAAgC;AAChC,EAAE;AACF,sEAAsE;AACtE,wEAAwE;AACxE,2BAA2B;AAC3B,+EAA+E;AAE/E,wBAAwB;AACxB,2DAO8B;AAD5B,kIAAA,4BAA4B,OAAA;AAG9B,uBAAuB;AACvB,+DAWgC;AAP9B,iIAAA,yBAAyB,OAAA;AACzB,+HAAA,uBAAuB,OAAA;AACvB,6HAAA,qBAAqB,OAAA;AACrB,4HAAA,oBAAoB,OAAA;AACpB,mIAAA,2BAA2B,OAAA;AAC3B,gIAAA,wBAAwB,OAAA;AACxB,iIAAA,yBAAyB,OAAA;AAG3B,sBAAsB;AACtB,6DAM+B;AAL7B,+HAAA,wBAAwB,OAAA;AACxB,qHAAA,cAAc,OAAA;AACd,4HAAA,qBAAqB,OAAA;AACrB,0HAAA,mBAAmB,OAAA;AACnB,2HAAA,oBAAoB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharpee/world-model",
-  "version": "0.9.110",
+  "version": "0.9.113",
   "description": "World model for Sharpee IF platform - entities, traits, and behaviors",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -12,8 +12,8 @@
     }
   },
   "dependencies": {
-    "@sharpee/core": "^0.9.110",
-    "@sharpee/if-domain": "^0.9.110"
+    "@sharpee/core": "^0.9.113",
+    "@sharpee/if-domain": "^0.9.113"
   },
   "keywords": [
     "interactive-fiction",