@sharpee/engine 0.9.65-beta → 0.9.66-beta

package/dist-npm/capability-dispatch-helper.js

@@ -1,269 +0,0 @@
-"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("../../world-model/dist-npm/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

package/dist-npm/capability-dispatch-helper.js.map

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

package/dist-npm/command-executor.d.ts

@@ -1,53 +0,0 @@
-/**
- * Command Executor - Orchestrates command pipeline
- *
- * Responsibilities:
- * - Orchestrate the four-phase pattern (validate → execute → report/blocked)
- * - Handle implicit inference (ADR-104) when validation fails with pronouns
- * - Pass results between phases
- * - Return the final TurnResult
- *
- * All event creation is owned by the action components themselves.
- */
-import { ISystemEvent, IGenericEventSource } from "../../core/dist-npm/src/index";
-import { IParser, IParsedCommand } from "../../world-model/dist-npm/src/index";
-import { WorldModel } from "../../world-model/dist-npm/src/index";
-import { EventProcessor } from "../../event-processor/dist-npm/src/index";
-import { ActionRegistry } from "../../stdlib/dist-npm/src/index";
-import { GameContext, TurnResult, EngineConfig } from './types';
-/**
- * Transformer function for parsed commands.
- * Called after parsing but before validation.
- * Can modify the parsed command to bypass or alter validation behavior.
- *
- * @param parsed - The parsed command from the parser
- * @param world - The world model for checking state (e.g., gdtMode)
- * @returns The (potentially modified) parsed command
- */
-export type ParsedCommandTransformer = (parsed: IParsedCommand, world: WorldModel) => IParsedCommand;
-export declare class CommandExecutor {
-    private parser;
-    private validator;
-    private actionRegistry;
-    private eventProcessor;
-    private scopeResolver?;
-    private parsedCommandTransformers;
-    constructor(world: WorldModel, actionRegistry: ActionRegistry, eventProcessor: EventProcessor, parser: IParser, systemEvents?: IGenericEventSource<ISystemEvent>);
-    /**
-     * Register a transformer that can modify parsed commands before validation.
-     * Transformers are called in order of registration.
-     *
-     * @param transformer - Function to transform parsed commands
-     */
-    registerParsedCommandTransformer(transformer: ParsedCommandTransformer): void;
-    /**
-     * Unregister a previously registered transformer.
-     *
-     * @param transformer - The transformer to remove
-     * @returns true if the transformer was found and removed
-     */
-    unregisterParsedCommandTransformer(transformer: ParsedCommandTransformer): boolean;
-    execute(input: string, world: WorldModel, context: GameContext, config?: EngineConfig): Promise<TurnResult>;
-}
-export declare function createCommandExecutor(world: WorldModel, actionRegistry: ActionRegistry, eventProcessor: EventProcessor, parser: IParser, systemEvents?: IGenericEventSource<ISystemEvent>): CommandExecutor;
-//# sourceMappingURL=command-executor.d.ts.map

package/dist-npm/command-executor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"command-executor.d.ts","sourceRoot":"","sources":["../../../../src/command-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAkB,YAAY,EAAE,mBAAmB,EAA0B,MAAM,eAAe,CAAC;AAC1G,OAAO,EAAE,OAAO,EAAqB,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGlF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAEL,cAAc,EAKf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAYhE;;;;;;;;GAQG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,UAAU,KACd,cAAc,CAAC;AAEpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,yBAAyB,CAAkC;gBAGjE,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,OAAO,EACf,YAAY,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC;IAgBlD;;;;;OAKG;IACH,gCAAgC,CAAC,WAAW,EAAE,wBAAwB,GAAG,IAAI;IAI7E;;;;;OAKG;IACH,kCAAkC,CAAC,WAAW,EAAE,wBAAwB,GAAG,OAAO;IAS5E,OAAO,CACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,UAAU,CAAC;CA4SvB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,cAAc,EAC9B,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,OAAO,EACf,YAAY,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,GAC/C,eAAe,CAEjB"}

package/dist-npm/command-executor.js

@@ -1,329 +0,0 @@
-"use strict";
-/**
- * Command Executor - Orchestrates command pipeline
- *
- * Responsibilities:
- * - Orchestrate the four-phase pattern (validate → execute → report/blocked)
- * - Handle implicit inference (ADR-104) when validation fails with pronouns
- * - Pass results between phases
- * - Return the final TurnResult
- *
- * All event creation is owned by the action components themselves.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommandExecutor = void 0;
-exports.createCommandExecutor = createCommandExecutor;
-const core_1 = require("../../core/dist-npm/src/index.js");
-const parser_interface_1 = require("./parser-interface");
-const shared_data_keys_1 = require("./shared-data-keys");
-const stdlib_1 = require("../../stdlib/dist-npm/src/index.js");
-const event_sequencer_1 = require("./event-sequencer");
-const action_context_factory_1 = require("./action-context-factory");
-const capability_dispatch_helper_1 = require("./capability-dispatch-helper");
-class CommandExecutor {
-    parser;
-    validator;
-    actionRegistry;
-    eventProcessor;
-    scopeResolver;
-    parsedCommandTransformers = [];
-    constructor(world, actionRegistry, eventProcessor, parser, systemEvents) {
-        if (!world)
-            throw new Error('World model is required');
-        if (!actionRegistry)
-            throw new Error('Action registry is required');
-        if (!eventProcessor)
-            throw new Error('Event processor is required');
-        if (!parser)
-            throw new Error('Parser is required');
-        this.parser = parser;
-        this.validator = new stdlib_1.CommandValidator(world, actionRegistry);
-        if (systemEvents) {
-            this.validator.setSystemEventSource(systemEvents);
-        }
-        this.actionRegistry = actionRegistry;
-        this.eventProcessor = eventProcessor;
-    }
-    /**
-     * Register a transformer that can modify parsed commands before validation.
-     * Transformers are called in order of registration.
-     *
-     * @param transformer - Function to transform parsed commands
-     */
-    registerParsedCommandTransformer(transformer) {
-        this.parsedCommandTransformers.push(transformer);
-    }
-    /**
-     * Unregister a previously registered transformer.
-     *
-     * @param transformer - The transformer to remove
-     * @returns true if the transformer was found and removed
-     */
-    unregisterParsedCommandTransformer(transformer) {
-        const index = this.parsedCommandTransformers.indexOf(transformer);
-        if (index !== -1) {
-            this.parsedCommandTransformers.splice(index, 1);
-            return true;
-        }
-        return false;
-    }
-    async execute(input, world, context, config) {
-        const turn = context.currentTurn;
-        event_sequencer_1.eventSequencer.resetTurn(turn);
-        // Timing tracking
-        const startTime = config?.collectTiming ? Date.now() : 0;
-        let parseTime = 0;
-        let executionTime = 0;
-        try {
-            // Set world context for parser entity resolution
-            const player = world.getPlayer();
-            if (player && (0, parser_interface_1.hasWorldContext)(this.parser)) {
-                const playerLocation = world.getLocation(player.id) || '';
-                this.parser.setWorldContext(world, player.id, playerLocation);
-            }
-            // Phase 1: Parse
-            const parseStart = config?.collectTiming ? Date.now() : 0;
-            const parseResult = this.parser.parse(input);
-            if (config?.collectTiming) {
-                parseTime = Date.now() - parseStart;
-            }
-            if (!parseResult.success) {
-                throw new Error(`Parse failed: ${parseResult.error.code}`);
-            }
-            // Phase 1.5: Apply parsed command transformers
-            // Allows stories to modify parsed commands before validation
-            let parsedCommand = parseResult.value;
-            for (const transformer of this.parsedCommandTransformers) {
-                parsedCommand = transformer(parsedCommand, world);
-            }
-            // Phase 2: Validate
-            const validationResult = this.validator.validate(parsedCommand);
-            if (!validationResult.success) {
-                // Check for disambiguation - emit client.query event instead of throwing
-                if (validationResult.error.code === 'AMBIGUOUS_ENTITY') {
-                    const details = validationResult.error.details || {};
-                    const candidates = details.ambiguousEntities || [];
-                    // Emit client.query event for disambiguation
-                    const queryEvent = event_sequencer_1.eventSequencer.sequence({
-                        type: 'client.query',
-                        data: {
-                            source: core_1.QuerySource.DISAMBIGUATION,
-                            type: core_1.QueryType.DISAMBIGUATION,
-                            messageId: 'core.disambiguation_prompt',
-                            candidates: candidates,
-                            searchText: details.searchText,
-                            originalCommand: parsedCommand
-                        }
-                    }, turn);
-                    // Return early with query pending
-                    return {
-                        turn,
-                        input,
-                        success: false,
-                        needsInput: true,
-                        events: [queryEvent],
-                        error: 'DISAMBIGUATION_NEEDED'
-                    };
-                }
-                // Other validation errors still throw
-                throw new Error(`Validation failed: ${validationResult.error.code}`);
-            }
-            // Phase 3: Execute action's three-phase pattern
-            const executionStart = config?.collectTiming ? Date.now() : 0;
-            const command = validationResult.value;
-            const action = this.actionRegistry.get(command.actionId);
-            if (!action) {
-                throw new Error(`Action not found: ${command.actionId}`);
-            }
-            // Create context
-            if (!this.scopeResolver) {
-                this.scopeResolver = (0, stdlib_1.createScopeResolver)(world);
-            }
-            const actionContext = (0, action_context_factory_1.createActionContext)(world, context, command, action, this.scopeResolver);
-            // Universal Capability Dispatch: Check if any involved entity has a capability for this action
-            // If so, the entity's behavior handles the action instead of the stdlib default
-            // Check all entities: directObject, indirectObject, and any others
-            const involvedEntities = [
-                command.directObject?.entity,
-                command.indirectObject?.entity
-            ];
-            const capabilityCheck = (0, capability_dispatch_helper_1.checkCapabilityDispatchMulti)(command.actionId, involvedEntities);
-            // Run action's four phases: validate → execute → report (or blocked)
-            // If capability dispatch applies, use capability behavior; otherwise use action
-            let actionValidation = capabilityCheck.shouldDispatch
-                ? (0, capability_dispatch_helper_1.executeCapabilityValidate)(capabilityCheck, actionContext)
-                : action.validate(actionContext);
-            let currentCommand = command;
-            let currentContext = actionContext;
-            let useCapabilityDispatch = capabilityCheck.shouldDispatch;
-            // ADR-104: Implicit inference - if validation fails and pronoun was used,
-            // try to find a valid alternative target
-            // Check story-level config first
-            const inferenceEnabled = context.implicitActions?.inference !== false;
-            if (!actionValidation.valid && action.targetRequirements && inferenceEnabled) {
-                const directObject = command.directObject;
-                // Check if pronoun was used (INounPhrase has wasPronoun, cast is safe)
-                const parsedNounPhrase = directObject?.parsed;
-                const wasPronoun = parsedNounPhrase?.wasPronoun === true;
-                if (wasPronoun && directObject?.entity) {
-                    // Note: directObject.parsed is typed as IParsedObjectReference but at runtime
-                    // it's actually an INounPhrase (command-validator sets it from the noun phrase)
-                    // Get entities in scope for inference (visible entities)
-                    const scopeEntities = this.scopeResolver.getVisible(world.getPlayer());
-                    // Try to infer a different target
-                    const inferenceResult = (0, stdlib_1.tryInferTarget)(directObject.entity, wasPronoun, action, scopeEntities, world);
-                    if (inferenceResult.inferred && inferenceResult.inferredTarget) {
-                        // Create a modified command with the inferred target
-                        const inferredCommand = {
-                            ...command,
-                            directObject: {
-                                entity: inferenceResult.inferredTarget,
-                                parsed: {
-                                    ...directObject.parsed,
-                                    // Update text to reflect inferred entity
-                                    text: inferenceResult.inferredTarget.name
-                                }
-                            }
-                        };
-                        // Create new context with inferred command
-                        const inferredContext = (0, action_context_factory_1.createActionContext)(world, context, inferredCommand, action, this.scopeResolver);
-                        // Mark that inference occurred (for "(the leaflet)" message)
-                        const sharedData = inferredContext.sharedData;
-                        sharedData[shared_data_keys_1.SharedDataKeys.INFERENCE_PERFORMED] = true;
-                        sharedData[shared_data_keys_1.SharedDataKeys.ORIGINAL_TARGET] = directObject.entity;
-                        sharedData[shared_data_keys_1.SharedDataKeys.INFERRED_TARGET] = inferenceResult.inferredTarget;
-                        // Re-check capability dispatch for inferred target
-                        const inferredInvolvedEntities = [
-                            inferenceResult.inferredTarget,
-                            command.indirectObject?.entity
-                        ];
-                        const inferredCapabilityCheck = (0, capability_dispatch_helper_1.checkCapabilityDispatchMulti)(command.actionId, inferredInvolvedEntities);
-                        // Re-validate with inferred target (using capability dispatch if applicable)
-                        const retryValidation = inferredCapabilityCheck.shouldDispatch
-                            ? (0, capability_dispatch_helper_1.executeCapabilityValidate)(inferredCapabilityCheck, inferredContext)
-                            : action.validate(inferredContext);
-                        if (retryValidation.valid) {
-                            // Inference succeeded - use the inferred command
-                            actionValidation = retryValidation;
-                            currentCommand = inferredCommand;
-                            currentContext = inferredContext;
-                            useCapabilityDispatch = inferredCapabilityCheck.shouldDispatch;
-                        }
-                    }
-                }
-            }
-            // Thread validation result to later phases via context
-            // This allows actions to access data from validate() in execute/report
-            currentContext.validationResult = actionValidation;
-            let events;
-            if (actionValidation.valid) {
-                if (useCapabilityDispatch) {
-                    // Capability dispatch: use behavior phases
-                    (0, capability_dispatch_helper_1.executeCapabilityExecute)(currentContext);
-                    events = (0, capability_dispatch_helper_1.executeCapabilityReport)(currentContext);
-                }
-                else {
-                    // Standard action: use action phases
-                    const executeResult = action.execute(currentContext);
-                    // Check pattern (new vs old)
-                    if (executeResult === undefined || executeResult === null) {
-                        // New pattern: use report() for success events only
-                        if (action.report) {
-                            events = action.report(currentContext);
-                        }
-                        else {
-                            throw new Error(`Action ${action.id} uses new pattern but lacks report()`);
-                        }
-                    }
-                    else {
-                        // Old pattern: events from execute()
-                        events = executeResult;
-                    }
-                }
-            }
-            else {
-                // Validation failed - use blocked() for error events
-                if (useCapabilityDispatch) {
-                    // Capability dispatch: use behavior's blocked phase
-                    events = (0, capability_dispatch_helper_1.executeCapabilityBlocked)(currentContext, actionValidation, command.actionId);
-                }
-                else if (action.blocked) {
-                    events = action.blocked(currentContext, actionValidation);
-                }
-                else {
-                    // Fallback for unmigrated actions
-                    events = [{
-                            id: `${turn}-error`,
-                            type: 'action.error',
-                            timestamp: Date.now(),
-                            data: {
-                                actionId: command.actionId,
-                                messageId: actionValidation.error || 'validation_failed',
-                                params: actionValidation.params || {}
-                            },
-                            entities: {}
-                        }];
-                }
-            }
-            if (config?.collectTiming) {
-                executionTime = Date.now() - executionStart;
-            }
-            // Process events and collect reactions (ADR-052 entity handlers)
-            let allEvents = events;
-            if (events.length > 0) {
-                const processed = this.eventProcessor.processEvents(events);
-                // Add reaction events from entity handlers
-                if (processed.reactions && processed.reactions.length > 0) {
-                    allEvents = [...events, ...processed.reactions];
-                }
-            }
-            // Preserve all event properties (including requiresClientAction for platform events)
-            const sequenced = event_sequencer_1.eventSequencer.sequenceAll(allEvents, turn);
-            const result = {
-                turn,
-                input,
-                success: !events.some(e => e.type === 'action.error'),
-                events: sequenced,
-                actionId: command.actionId,
-                parsedCommand: command.parsed,
-                validatedCommand: command
-            };
-            // Add timing data if requested
-            if (config?.collectTiming) {
-                result.timing = {
-                    parsing: parseTime,
-                    execution: executionTime,
-                    total: Date.now() - startTime
-                };
-            }
-            return result;
-        }
-        catch (error) {
-            // Minimal error handling - just return failure
-            const result = {
-                turn,
-                input,
-                success: false,
-                events: [event_sequencer_1.eventSequencer.sequence({
-                        type: 'command.failed',
-                        data: { reason: error.message, input }
-                    }, turn)],
-                error: error.message
-            };
-            // Add timing data even for errors if requested
-            if (config?.collectTiming) {
-                result.timing = {
-                    parsing: parseTime,
-                    execution: executionTime,
-                    total: Date.now() - startTime
-                };
-            }
-            return result;
-        }
-    }
-}
-exports.CommandExecutor = CommandExecutor;
-function createCommandExecutor(world, actionRegistry, eventProcessor, parser, systemEvents) {
-    return new CommandExecutor(world, actionRegistry, eventProcessor, parser, systemEvents);
-}
-//# sourceMappingURL=command-executor.js.map