@sharpee/engine 0.9.66-beta → 0.9.69-beta

package/action-context-factory.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Action Context Factory - Creates ActionContext for action execution
+ */
+import { ActionContext, Action, ScopeResolver, ValidatedCommand } from "./src/index";
+import { WorldModel } from "./src/index";
+import { GameContext } from './types';
+/**
+ * Create an ActionContext for action execution
+ */
+export declare function createActionContext(world: WorldModel, gameContext: GameContext, command: ValidatedCommand, action: Action, scopeResolver: ScopeResolver): ActionContext;
+//# sourceMappingURL=action-context-factory.d.ts.map

package/action-context-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-context-factory.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/engine/src/action-context-factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAA+E,MAAM,iBAAiB,CAAC;AACtK,OAAO,EAAE,UAAU,EAAuB,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA+CtC;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,aAAa,GAC3B,aAAa,CAuPf"}

package/action-context-factory.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * Action Context Factory - Creates ActionContext for action execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createActionContext = createActionContext;
+const stdlib_1 = require("./src/index.js");
+const world_model_1 = require("./src/index.js");
+const core_1 = require("./src/index.js");
+const shared_data_keys_1 = require("./shared-data-keys");
+/**
+ * Helper to get entity from command slot
+ */
+function getEntityFromSlot(command, slot) {
+    switch (slot) {
+        case 'target':
+        case 'directObject':
+        case 'item':
+            return command.directObject?.entity ?? null;
+        case 'container':
+        case 'recipient':
+        case 'instrument':
+        case 'indirectObject':
+            return command.indirectObject?.entity ?? null;
+        default:
+            return command.directObject?.entity ?? null;
+    }
+}
+/**
+ * Generate appropriate scope error based on requirement and actual scope
+ */
+function getScopeError(required, actual, entity) {
+    const params = { item: entity.name };
+    if (actual === stdlib_1.ScopeLevel.UNAWARE) {
+        return { valid: false, error: stdlib_1.ScopeErrors.NOT_KNOWN, params };
+    }
+    if (required >= stdlib_1.ScopeLevel.VISIBLE && actual < stdlib_1.ScopeLevel.VISIBLE) {
+        return { valid: false, error: stdlib_1.ScopeErrors.NOT_VISIBLE, params };
+    }
+    if (required >= stdlib_1.ScopeLevel.REACHABLE && actual < stdlib_1.ScopeLevel.REACHABLE) {
+        return { valid: false, error: stdlib_1.ScopeErrors.NOT_REACHABLE, params };
+    }
+    if (required >= stdlib_1.ScopeLevel.CARRIED && actual < stdlib_1.ScopeLevel.CARRIED) {
+        return { valid: false, error: stdlib_1.ScopeErrors.NOT_CARRIED, params };
+    }
+    return { valid: false, error: stdlib_1.ScopeErrors.OUT_OF_SCOPE, params };
+}
+/**
+ * Create an ActionContext for action execution
+ */
+function createActionContext(world, gameContext, command, action, scopeResolver) {
+    const player = gameContext.player;
+    const currentLocation = world.getLocation(player.id)
+        ? world.getEntity(world.getLocation(player.id))
+        : player;
+    // Create sharedData object separately so it can be referenced in closures
+    const sharedData = {};
+    // Create the event method
+    const event = (type, data) => {
+        // Add standard entities
+        const entities = {
+            actor: player.id,
+            location: currentLocation?.id || player.id
+        };
+        // Add entities from command
+        if (command.directObject?.entity) {
+            entities.target = command.directObject.entity.id;
+        }
+        if (command.indirectObject?.entity) {
+            entities.indirect = command.indirectObject.entity.id;
+        }
+        // Create the event
+        return {
+            id: `evt_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+            type,
+            timestamp: Date.now(),
+            data: {
+                ...data,
+                // Include action context in data instead of metadata
+                actionId: action.id,
+                turn: gameContext.currentTurn
+            },
+            entities
+        };
+    };
+    return {
+        // World querying
+        world,
+        player,
+        currentLocation: currentLocation,
+        command,
+        scopeResolver,
+        action,
+        // Shared data for passing information between phases
+        sharedData,
+        // Validation result - set by CommandExecutor after validate() phase
+        validationResult: undefined,
+        // Scope checking methods (delegate to scopeResolver)
+        canSee: (entity) => {
+            return scopeResolver.canSee(player, entity);
+        },
+        canReach: (entity) => {
+            return scopeResolver.canReach(player, entity);
+        },
+        canTake: (entity) => {
+            // Basic implementation - can be enhanced
+            return !entity.has('if.trait.scenery') &&
+                !entity.has('if.trait.fixed') &&
+                entity.type !== 'room' &&
+                entity.type !== 'location';
+        },
+        isInScope: (entity) => {
+            const level = scopeResolver.getScope(player, entity);
+            return level >= stdlib_1.ScopeLevel.AWARE;
+        },
+        getVisible: () => {
+            return scopeResolver.getVisible(player);
+        },
+        getInScope: () => {
+            // Get all entities and filter by scope
+            const allEntities = world.getAllEntities();
+            return allEntities.filter(entity => {
+                const level = scopeResolver.getScope(player, entity);
+                return level >= stdlib_1.ScopeLevel.AWARE;
+            });
+        },
+        // Scope validation methods (Phase 4 parser refactor)
+        getEntityScope: (entity) => {
+            return scopeResolver.getScope(player, entity);
+        },
+        getSlotScope: (slot) => {
+            const entity = getEntityFromSlot(command, slot);
+            if (!entity) {
+                return stdlib_1.ScopeLevel.UNAWARE;
+            }
+            return scopeResolver.getScope(player, entity);
+        },
+        requireScope: (entity, required) => {
+            const actualScope = scopeResolver.getScope(player, entity);
+            if (actualScope >= required) {
+                return { ok: true, actualScope };
+            }
+            const error = getScopeError(required, actualScope, entity);
+            return { ok: false, error, actualScope };
+        },
+        requireSlotScope: (slot, required) => {
+            const entity = getEntityFromSlot(command, slot);
+            if (!entity) {
+                return {
+                    ok: false,
+                    error: { valid: false, error: 'no_target', params: { slot } }
+                };
+            }
+            const actualScope = scopeResolver.getScope(player, entity);
+            if (actualScope >= required) {
+                return { ok: true, actualScope };
+            }
+            const error = getScopeError(required, actualScope, entity);
+            return { ok: false, error, actualScope };
+        },
+        requireCarriedOrImplicitTake: (entity) => {
+            const actualScope = scopeResolver.getScope(player, entity);
+            // Case 1: Already carried - success, no implicit take needed
+            if (actualScope >= stdlib_1.ScopeLevel.CARRIED) {
+                return { ok: true };
+            }
+            // Case 2: Not reachable - can't take it, return scope error
+            if (actualScope < stdlib_1.ScopeLevel.REACHABLE) {
+                const error = getScopeError(stdlib_1.ScopeLevel.REACHABLE, actualScope, entity);
+                return { ok: false, error };
+            }
+            // Case 3: Reachable but not carried - attempt implicit take
+            // Check if implicit take is disabled at story level (ADR-104)
+            if (gameContext.implicitActions?.implicitTake === false) {
+                return {
+                    ok: false,
+                    error: { valid: false, error: stdlib_1.ScopeErrors.NOT_CARRIED, params: { item: entity.name } }
+                };
+            }
+            // Check if implicit take is disabled at action level (ADR-104)
+            if (action.allowImplicitTake === false) {
+                return {
+                    ok: false,
+                    error: { valid: false, error: stdlib_1.ScopeErrors.NOT_CARRIED, params: { item: entity.name } }
+                };
+            }
+            // Check if entity can be taken (not scenery, room, door)
+            if (entity.has(world_model_1.TraitType.SCENERY) || entity.has(world_model_1.TraitType.ROOM) || entity.has(world_model_1.TraitType.DOOR)) {
+                return {
+                    ok: false,
+                    error: { valid: false, error: 'fixed_in_place', params: { item: entity.name } }
+                };
+            }
+            // Create a synthetic command for the taking action
+            const takeCommand = {
+                parsed: {
+                    rawInput: `take ${entity.name}`,
+                    action: stdlib_1.takingAction.id,
+                    tokens: [],
+                    structure: { verb: { tokens: [0], text: 'take', head: 'take' } },
+                    pattern: 'VERB_NOUN',
+                    confidence: 1.0
+                },
+                actionId: stdlib_1.takingAction.id,
+                directObject: {
+                    entity,
+                    parsed: {
+                        text: entity.name,
+                        candidates: [entity.name]
+                    }
+                }
+            };
+            // Create a sub-context for the taking action
+            const takeContext = createActionContext(world, gameContext, takeCommand, stdlib_1.takingAction, scopeResolver);
+            // Run the taking action's validate phase
+            const validation = stdlib_1.takingAction.validate(takeContext);
+            if (!validation.valid) {
+                // Take validation failed - return the error
+                return {
+                    ok: false,
+                    error: {
+                        valid: false,
+                        error: validation.error || 'cannot_take',
+                        params: validation.params
+                    }
+                };
+            }
+            // Execute the taking action
+            stdlib_1.takingAction.execute(takeContext);
+            // Get the report events from the taking action
+            const takeEvents = stdlib_1.takingAction.report ? stdlib_1.takingAction.report(takeContext) : [];
+            // Filter out action.success events - the implicit_take message replaces them
+            // Keep if.event.taken for state tracking
+            const filteredTakeEvents = takeEvents.filter(e => e.type !== 'action.success');
+            // Create the implicit take event (for "(first taking the X)" message)
+            const implicitTakeEvent = (0, core_1.createEvent)('if.event.implicit_take', {
+                item: entity.id,
+                itemName: entity.name
+            }, {
+                actor: player.id,
+                target: entity.id,
+                location: currentLocation?.id || player.id
+            });
+            // Combine: implicit take notification + state change events (no success message)
+            const implicitTakeEvents = [implicitTakeEvent, ...filteredTakeEvents];
+            // Store in sharedData for the report phase to access
+            const existingEvents = sharedData[shared_data_keys_1.SharedDataKeys.IMPLICIT_TAKE_EVENTS] ?? [];
+            sharedData[shared_data_keys_1.SharedDataKeys.IMPLICIT_TAKE_EVENTS] = [...existingEvents, ...implicitTakeEvents];
+            return {
+                ok: true,
+                implicitTakeEvents
+            };
+        },
+        // Event creation
+        event
+    };
+}
+//# sourceMappingURL=action-context-factory.js.map

package/action-context-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-context-factory.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/engine/src/action-context-factory.ts"],"names":[],"mappings":"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"}

package/capability-dispatch-helper.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Capability Dispatch Helper for Universal Dispatch
+ *
+ * Enables capability dispatch for ALL stdlib actions, not just specialized verbs.
+ * When an entity's trait declares a capability for an action, the trait's behavior
+ * handles the action instead of the stdlib default.
+ *
+ * This enables patterns like:
+ * - Troll blocking: TrollTrait handles 'if.action.going' to block passage
+ * - Custom containers: ChestTrait handles 'if.action.opening' for locked chest
+ * - Guardian items: AxeTrait handles 'if.action.taking' while troll guards it
+ *
+ * Resolution modes (ADR-090 extension):
+ * - first-wins: First entity with capability determines result
+ * - any-blocks: Any entity returning valid: false blocks
+ * - all-must-pass: All entities must return valid: true
+ * - highest-priority: Only highest priority entity is checked
+ */
+import { ISemanticEvent } from "./src/index";
+import { IFEntity, CapabilityBehavior, CapabilitySharedData, ITrait, CapabilityResolution } from "./src/index";
+import { ActionContext, ValidationResult } from "./src/index";
+/**
+ * A single capability claim from an entity.
+ */
+export interface CapabilityClaim {
+    /** The entity making the claim */
+    entity: IFEntity;
+    /** The trait claiming the capability */
+    trait: ITrait;
+    /** The behavior to use */
+    behavior: CapabilityBehavior;
+    /** Priority for resolution ordering */
+    priority: number;
+    /** Resolution override from binding (if any) */
+    resolutionOverride?: CapabilityResolution;
+}
+/**
+ * Result of checking for capability dispatch.
+ */
+export interface CapabilityDispatchCheck {
+    /** Whether capability dispatch should be used */
+    shouldDispatch: boolean;
+    /** The trait claiming the capability (if found) - for single dispatch */
+    trait?: ITrait;
+    /** The behavior to use (if found) - for single dispatch */
+    behavior?: CapabilityBehavior;
+    /** The entity with the capability - for single dispatch */
+    entity?: IFEntity;
+    /** All claims found (for multi-entity resolution) */
+    claims?: CapabilityClaim[];
+    /** Resolution mode to use */
+    resolution?: CapabilityResolution;
+}
+/**
+ * Data stored for capability dispatch between phases.
+ */
+export interface CapabilityDispatchData {
+    trait: ITrait;
+    behavior: CapabilityBehavior;
+    entityId: string;
+    entityName: string;
+    sharedData: CapabilitySharedData;
+}
+/**
+ * Check if capability dispatch should be used for this action and target.
+ *
+ * @param actionId - The action being executed
+ * @param target - The target entity (directObject) - for backward compatibility
+ * @returns Check result with trait and behavior if dispatch should be used
+ */
+export declare function checkCapabilityDispatch(actionId: string, target: IFEntity | undefined): CapabilityDispatchCheck;
+/**
+ * Check if capability dispatch should be used for this action across multiple entities.
+ *
+ * Collects all capability claims from the provided entities, sorts by priority,
+ * and returns the appropriate dispatch information based on resolution config.
+ *
+ * @param actionId - The action being executed
+ * @param entities - All entities involved in the action (directObject, indirectObject, etc.)
+ * @returns Check result with claims and resolution mode
+ */
+export declare function checkCapabilityDispatchMulti(actionId: string, entities: (IFEntity | undefined)[]): CapabilityDispatchCheck;
+/**
+ * Execute capability dispatch validation phase.
+ *
+ * Handles resolution modes:
+ * - first-wins/highest-priority: Single behavior validates
+ * - any-blocks: All behaviors validate, any false blocks
+ * - all-must-pass: All behaviors must return true
+ *
+ * @returns ValidationResult with dispatch data if valid
+ */
+export declare function executeCapabilityValidate(check: CapabilityDispatchCheck, context: ActionContext): ValidationResult;
+/**
+ * Execute capability dispatch execute phase.
+ */
+export declare function executeCapabilityExecute(context: ActionContext): void;
+/**
+ * Execute capability dispatch report phase.
+ */
+export declare function executeCapabilityReport(context: ActionContext): ISemanticEvent[];
+/**
+ * Execute capability dispatch blocked phase.
+ */
+export declare function executeCapabilityBlocked(context: ActionContext, result: ValidationResult, actionId: string): ISemanticEvent[];
+//# sourceMappingURL=capability-dispatch-helper.d.ts.map

package/capability-dispatch-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-dispatch-helper.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/engine/src/capability-dispatch-helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,QAAQ,EAKR,kBAAkB,EAClB,oBAAoB,EAEpB,MAAM,EAEN,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAU,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,MAAM,EAAE,QAAQ,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iDAAiD;IACjD,cAAc,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,qDAAqD;IACrD,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,6BAA6B;IAC7B,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAC3B,uBAAuB,CAOzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,QAAQ,GAAG,SAAS,CAAC,EAAE,GACjC,uBAAuB,CAmEzB;AAYD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,aAAa,GACrB,gBAAgB,CAiGlB;AAuCD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,GACrB,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,GACrB,cAAc,EAAE,CAgBlB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE,CAyBlB"}

package/capability-dispatch-helper.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * Capability Dispatch Helper for Universal Dispatch
+ *
+ * Enables capability dispatch for ALL stdlib actions, not just specialized verbs.
+ * When an entity's trait declares a capability for an action, the trait's behavior
+ * handles the action instead of the stdlib default.
+ *
+ * This enables patterns like:
+ * - Troll blocking: TrollTrait handles 'if.action.going' to block passage
+ * - Custom containers: ChestTrait handles 'if.action.opening' for locked chest
+ * - Guardian items: AxeTrait handles 'if.action.taking' while troll guards it
+ *
+ * Resolution modes (ADR-090 extension):
+ * - first-wins: First entity with capability determines result
+ * - any-blocks: Any entity returning valid: false blocks
+ * - all-must-pass: All entities must return valid: true
+ * - highest-priority: Only highest priority entity is checked
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkCapabilityDispatch = checkCapabilityDispatch;
+exports.checkCapabilityDispatchMulti = checkCapabilityDispatchMulti;
+exports.executeCapabilityValidate = executeCapabilityValidate;
+exports.executeCapabilityExecute = executeCapabilityExecute;
+exports.executeCapabilityReport = executeCapabilityReport;
+exports.executeCapabilityBlocked = executeCapabilityBlocked;
+const world_model_1 = require("./src/index.js");
+/**
+ * Check if capability dispatch should be used for this action and target.
+ *
+ * @param actionId - The action being executed
+ * @param target - The target entity (directObject) - for backward compatibility
+ * @returns Check result with trait and behavior if dispatch should be used
+ */
+function checkCapabilityDispatch(actionId, target) {
+    if (!target) {
+        return { shouldDispatch: false };
+    }
+    // Use the multi-entity version with single entity
+    return checkCapabilityDispatchMulti(actionId, [target]);
+}
+/**
+ * Check if capability dispatch should be used for this action across multiple entities.
+ *
+ * Collects all capability claims from the provided entities, sorts by priority,
+ * and returns the appropriate dispatch information based on resolution config.
+ *
+ * @param actionId - The action being executed
+ * @param entities - All entities involved in the action (directObject, indirectObject, etc.)
+ * @returns Check result with claims and resolution mode
+ */
+function checkCapabilityDispatchMulti(actionId, entities) {
+    const validEntities = entities.filter((e) => e !== undefined);
+    if (validEntities.length === 0) {
+        return { shouldDispatch: false };
+    }
+    // Collect all claims
+    const claims = [];
+    for (const entity of validEntities) {
+        const trait = (0, world_model_1.findTraitWithCapability)(entity, actionId);
+        if (!trait)
+            continue;
+        const binding = (0, world_model_1.getBehaviorBinding)(trait, actionId);
+        if (!binding) {
+            // Trait claims capability but no behavior registered
+            console.warn(`Universal dispatch: trait "${trait.type}" claims "${actionId}" ` +
+                `but no behavior registered. Falling back to stdlib action.`);
+            continue;
+        }
+        claims.push({
+            entity,
+            trait,
+            behavior: binding.behavior,
+            priority: binding.priority,
+            resolutionOverride: binding.resolution
+        });
+    }
+    if (claims.length === 0) {
+        return { shouldDispatch: false };
+    }
+    // Sort by priority (highest first)
+    claims.sort((a, b) => b.priority - a.priority);
+    // Get resolution mode (use first binding override if present, else global config)
+    const firstOverride = claims.find(c => c.resolutionOverride)?.resolutionOverride;
+    const config = (0, world_model_1.getCapabilityConfig)(actionId);
+    const resolution = firstOverride ?? config.resolution;
+    // For single claim or first-wins/highest-priority, return simple result
+    if (claims.length === 1 || resolution === 'first-wins' || resolution === 'highest-priority') {
+        const primary = claims[0];
+        return {
+            shouldDispatch: true,
+            trait: primary.trait,
+            behavior: primary.behavior,
+            entity: primary.entity,
+            claims,
+            resolution
+        };
+    }
+    // For any-blocks or all-must-pass, return all claims for aggregate validation
+    return {
+        shouldDispatch: true,
+        trait: claims[0].trait,
+        behavior: claims[0].behavior,
+        entity: claims[0].entity,
+        claims,
+        resolution
+    };
+}
+/**
+ * Convert capability effects to semantic events.
+ */
+function effectsToEvents(effects, context) {
+    return effects.map(effect => context.event(effect.type, effect.payload));
+}
+/**
+ * Execute capability dispatch validation phase.
+ *
+ * Handles resolution modes:
+ * - first-wins/highest-priority: Single behavior validates
+ * - any-blocks: All behaviors validate, any false blocks
+ * - all-must-pass: All behaviors must return true
+ *
+ * @returns ValidationResult with dispatch data if valid
+ */
+function executeCapabilityValidate(check, context) {
+    const { trait, behavior, entity, claims, resolution } = check;
+    if (!trait || !behavior || !entity) {
+        return { valid: false, error: 'capability_dispatch_error' };
+    }
+    // Create sharedData for passing data between behavior phases
+    const sharedData = {};
+    // For first-wins or highest-priority (or single claim), just validate the primary
+    if (!claims || claims.length <= 1 || resolution === 'first-wins' || resolution === 'highest-priority') {
+        return validateSingleBehavior(entity, trait, behavior, context, sharedData);
+    }
+    // For any-blocks: validate all, return first failure
+    if (resolution === 'any-blocks') {
+        for (const claim of claims) {
+            const claimSharedData = {};
+            const result = claim.behavior.validate(claim.entity, context.world, context.player.id, claimSharedData);
+            if (!result.valid) {
+                // This claim blocks - use its error
+                const data = {
+                    trait: claim.trait,
+                    behavior: claim.behavior,
+                    entityId: claim.entity.id,
+                    entityName: claim.entity.name,
+                    sharedData: claimSharedData
+                };
+                return {
+                    valid: false,
+                    error: result.error,
+                    params: result.params,
+                    data
+                };
+            }
+        }
+        // All passed - use primary for execute/report
+        const data = {
+            trait,
+            behavior,
+            entityId: entity.id,
+            entityName: entity.name,
+            sharedData
+        };
+        return { valid: true, data };
+    }
+    // For all-must-pass: same logic as any-blocks (any failure = overall failure)
+    if (resolution === 'all-must-pass') {
+        for (const claim of claims) {
+            const claimSharedData = {};
+            const result = claim.behavior.validate(claim.entity, context.world, context.player.id, claimSharedData);
+            if (!result.valid) {
+                const data = {
+                    trait: claim.trait,
+                    behavior: claim.behavior,
+                    entityId: claim.entity.id,
+                    entityName: claim.entity.name,
+                    sharedData: claimSharedData
+                };
+                return {
+                    valid: false,
+                    error: result.error,
+                    params: result.params,
+                    data
+                };
+            }
+        }
+        const data = {
+            trait,
+            behavior,
+            entityId: entity.id,
+            entityName: entity.name,
+            sharedData
+        };
+        return { valid: true, data };
+    }
+    // Default: first-wins fallback
+    return validateSingleBehavior(entity, trait, behavior, context, sharedData);
+}
+/**
+ * Validate a single behavior (helper for executeCapabilityValidate).
+ */
+function validateSingleBehavior(entity, trait, behavior, context, sharedData) {
+    const behaviorResult = behavior.validate(entity, context.world, context.player.id, sharedData);
+    const data = {
+        trait,
+        behavior,
+        entityId: entity.id,
+        entityName: entity.name,
+        sharedData
+    };
+    if (!behaviorResult.valid) {
+        return {
+            valid: false,
+            error: behaviorResult.error,
+            params: behaviorResult.params,
+            data
+        };
+    }
+    return { valid: true, data };
+}
+/**
+ * Execute capability dispatch execute phase.
+ */
+function executeCapabilityExecute(context) {
+    const data = context.validationResult?.data;
+    const entity = context.command.directObject?.entity;
+    if (!entity || !data?.behavior) {
+        return;
+    }
+    // Delegate execution to behavior
+    data.behavior.execute(entity, context.world, context.player.id, data.sharedData);
+}
+/**
+ * Execute capability dispatch report phase.
+ */
+function executeCapabilityReport(context) {
+    const data = context.validationResult?.data;
+    const entity = context.command.directObject?.entity;
+    if (!entity || !data?.behavior) {
+        return [];
+    }
+    // Delegate reporting to behavior
+    const effects = data.behavior.report(entity, context.world, context.player.id, data.sharedData);
+    return effectsToEvents(effects, context);
+}
+/**
+ * Execute capability dispatch blocked phase.
+ */
+function executeCapabilityBlocked(context, result, actionId) {
+    // Check both validationResult.data and result.data
+    const data = (context.validationResult?.data ?? result.data);
+    const entity = context.command.directObject?.entity;
+    // If we have a behavior, let it handle the blocked message
+    if (entity && data?.behavior) {
+        const effects = data.behavior.blocked(entity, context.world, context.player.id, result.error || 'action_blocked', data.sharedData);
+        return effectsToEvents(effects, context);
+    }
+    // Default blocked event (shouldn't normally reach here)
+    return [
+        context.event('action.blocked', {
+            actionId,
+            messageId: result.error || 'action_blocked',
+            params: result.params || {}
+        })
+    ];
+}
+//# sourceMappingURL=capability-dispatch-helper.js.map