@sharpee/engine 0.9.64-beta → 0.9.66-beta

package/package.json

@@ -1,34 +1,26 @@
 {
   "name": "@sharpee/engine",
-  "version": "0.9.64-beta",
+  "version": "0.9.66-beta",
   "description": "Runtime engine for Sharpee IF Platform - game loop, command execution, and turn management",
-  "main": "./dist-npm/index.js",
+  "main": "./index.js",
   "module": "dist-npm/index.js",
-  "types": "./dist-npm/index.d.ts",
+  "types": "./index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist-npm/index.d.ts",
-      "require": "./dist-npm/index.js"
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
     }
   },
-  "dependencies": {
-    "@sharpee/core": "0.9.64-beta",
-    "@sharpee/if-domain": "0.9.64-beta",
-    "@sharpee/event-processor": "0.9.64-beta",
-    "@sharpee/plugins": "0.9.64-beta",
-    "@sharpee/if-services": "0.9.64-beta",
-    "@sharpee/parser-en-us": "0.9.64-beta",
-    "@sharpee/stdlib": "0.9.64-beta",
-    "@sharpee/lang-en-us": "0.9.64-beta",
-    "@sharpee/text-blocks": "0.9.64-beta",
-    "@sharpee/world-model": "0.9.64-beta",
-    "@sharpee/text-service": "0.9.64-beta"
-  },
-  "devDependencies": {
-    "@types/node": "^20.11.19",
-    "cross-env": "^7.0.3",
-    "rimraf": "^5.0.5",
-    "typescript": "^5.3.3"
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "test:ci": "vitest run",
+    "test:verbose": "vitest run --reporter=verbose",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rimraf dist",
+    "build:npm": "tsc --outDir dist-npm"
   },
   "files": [
     "dist-npm"
@@ -57,15 +49,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest",
-    "test:ci": "vitest run",
-    "test:verbose": "vitest run --reporter=verbose",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "clean": "rimraf dist",
-    "build:npm": "tsc --outDir dist-npm"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 David Cornelson
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist-npm/action-context-factory.d.ts

@@ -1,11 +0,0 @@
-/**
- * Action Context Factory - Creates ActionContext for action execution
- */
-import { ActionContext, Action, ScopeResolver, ValidatedCommand } from "../../stdlib/dist-npm/src/index";
-import { WorldModel } from "../../world-model/dist-npm/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/dist-npm/action-context-factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"action-context-factory.d.ts","sourceRoot":"","sources":["../../../../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/dist-npm/action-context-factory.js

@@ -1,258 +0,0 @@
-"use strict";
-/**
- * Action Context Factory - Creates ActionContext for action execution
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createActionContext = createActionContext;
-const stdlib_1 = require("../../stdlib/dist-npm/src/index.js");
-const world_model_1 = require("../../world-model/dist-npm/src/index.js");
-const core_1 = require("../../core/dist-npm/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/dist-npm/action-context-factory.js.map

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

package/dist-npm/capability-dispatch-helper.d.ts

@@ -1,106 +0,0 @@
-/**
- * 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 "../../core/dist-npm/src/index";
-import { IFEntity, CapabilityBehavior, CapabilitySharedData, ITrait, CapabilityResolution } from "../../world-model/dist-npm/src/index";
-import { ActionContext, ValidationResult } from "../../stdlib/dist-npm/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/dist-npm/capability-dispatch-helper.d.ts.map

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