@sharpee/engine 0.9.60-beta

package/dist/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 '@sharpee/core';
+import { IFEntity, CapabilityBehavior, CapabilitySharedData, ITrait, CapabilityResolution } from '@sharpee/world-model';
+import { ActionContext, ValidationResult } from '@sharpee/stdlib';
+/**
+ * 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/dist/capability-dispatch-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-dispatch-helper.d.ts","sourceRoot":"","sources":["../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/dist/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("@sharpee/world-model");
+/**
+ * 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/capability-dispatch-helper.js.map

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

package/dist/command-executor.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 '@sharpee/core';
+import { IParser, IParsedCommand } from '@sharpee/world-model';
+import { WorldModel } from '@sharpee/world-model';
+import { EventProcessor } from '@sharpee/event-processor';
+import { ActionRegistry } from '@sharpee/stdlib';
+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/command-executor.d.ts.map

@@ -0,0 +1 @@
+{"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"}