@sharpee/stdlib 0.9.60-beta

package/dist/actions/standard/unlocking/unlocking.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * Unlocking action - unlocks containers and doors
+ *
+ * This action properly delegates to LockableBehavior for validation
+ * and execution. It follows the three-phase pattern.
+ *
+ * Uses three-phase pattern:
+ * 1. validate: Check if target is lockable and key requirements
+ * 2. execute: Call LockableBehavior.unlock(), store result in sharedData
+ * 3. report: Generate events from sharedData
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unlockingAction = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+const scope_1 = require("../../../scope");
+const lock_shared_1 = require("../lock-shared");
+const unlocking_messages_1 = require("./unlocking-messages");
+function getUnlockingSharedData(context) {
+    return context.sharedData;
+}
+exports.unlockingAction = {
+    id: constants_1.IFActions.UNLOCKING,
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        target: scope_1.ScopeLevel.REACHABLE,
+        key: scope_1.ScopeLevel.CARRIED
+    },
+    requiredMessages: [
+        'no_target',
+        'not_lockable',
+        'no_key',
+        'wrong_key',
+        'already_unlocked',
+        'unlocked',
+        'unlocked_with',
+        'cant_reach',
+        'key_not_held',
+        'still_locked'
+    ],
+    group: 'lock_manipulation',
+    /**
+     * Validate whether the unlock action can be executed
+     * Uses behavior validation methods to check preconditions
+     */
+    validate(context) {
+        const noun = context.command.directObject?.entity;
+        // ADR-080: Prefer instrument field (from .instrument() patterns), fall back to indirectObject
+        const withKey = context.command.instrument?.entity ?? context.command.indirectObject?.entity;
+        // Validate we have a target
+        if (!noun) {
+            return {
+                valid: false,
+                error: unlocking_messages_1.MESSAGES.NO_TARGET
+            };
+        }
+        // Check scope - must be able to reach the target
+        const scopeCheck = context.requireScope(noun, scope_1.ScopeLevel.REACHABLE);
+        if (!scopeCheck.ok) {
+            return scopeCheck.error;
+        }
+        // Check if it's lockable
+        if (!noun.has(world_model_1.TraitType.LOCKABLE)) {
+            return {
+                valid: false,
+                error: unlocking_messages_1.MESSAGES.NOT_LOCKABLE,
+                params: { item: noun.name }
+            };
+        }
+        // Use behavior's canUnlock method for validation
+        if (!world_model_1.LockableBehavior.canUnlock(noun)) {
+            return {
+                valid: false,
+                error: unlocking_messages_1.MESSAGES.ALREADY_UNLOCKED,
+                params: { item: noun.name }
+            };
+        }
+        // Validate key requirements using shared helper
+        const keyValidation = (0, lock_shared_1.validateKeyRequirements)(context, noun, withKey, false);
+        if (keyValidation) {
+            return keyValidation;
+        }
+        return { valid: true };
+    },
+    /**
+     * Execute the unlock action - performs mutations only
+     * Assumes validation has already passed
+     * Delegates to LockableBehavior for actual state changes
+     */
+    execute(context) {
+        const noun = context.command.directObject.entity;
+        // ADR-080: Prefer instrument field, fall back to indirectObject
+        const withKey = context.command.instrument?.entity ?? context.command.indirectObject?.entity;
+        const sharedData = getUnlockingSharedData(context);
+        // Analyze the unlocking context
+        const analysis = (0, lock_shared_1.analyzeLockContext)(context, noun, withKey);
+        // Delegate to behavior for unlocking (world mutation)
+        const result = world_model_1.LockableBehavior.unlock(noun, withKey);
+        // Store basic info
+        sharedData.targetId = noun.id;
+        sharedData.targetName = noun.name;
+        // Check if the behavior reported failure
+        if (!result.success) {
+            sharedData.failed = true;
+            // Map behavior failure to error message
+            if (result.wrongKey) {
+                sharedData.errorMessageId = 'wrong_key';
+            }
+            else if (result.noKey) {
+                sharedData.errorMessageId = 'no_key';
+            }
+            else {
+                sharedData.errorMessageId = 'cant_unlock';
+            }
+            return;
+        }
+        // Unlocking succeeded
+        sharedData.failed = false;
+        // Add type information from analysis
+        if (analysis.isContainer) {
+            sharedData.isContainer = true;
+            // Get container contents
+            const contents = context.world.getContents(noun.id);
+            sharedData.hasContents = contents.length > 0;
+            sharedData.contentsCount = contents.length;
+            sharedData.contentsIds = contents.map(e => e.id);
+        }
+        if (analysis.isDoor) {
+            sharedData.isDoor = true;
+        }
+        // Add key information
+        if (withKey) {
+            sharedData.keyId = withKey.id;
+            sharedData.keyName = withKey.name;
+        }
+        // Add sound information from result
+        if (result.unlockSound) {
+            sharedData.sound = result.unlockSound;
+        }
+        // Check for auto-open behavior
+        if (noun.has(world_model_1.TraitType.OPENABLE)) {
+            const openableTrait = noun.get(world_model_1.TraitType.OPENABLE);
+            if (openableTrait.autoOpenOnUnlock) {
+                sharedData.willAutoOpen = true;
+            }
+        }
+        // Determine success message
+        sharedData.messageId = (0, lock_shared_1.determineLockMessage)(false, !!withKey);
+        sharedData.params = {
+            item: noun.name
+        };
+        // Add container/door info to params
+        if (analysis.isContainer) {
+            sharedData.params.isContainer = true;
+            sharedData.params.hasContents = sharedData.hasContents;
+        }
+        if (analysis.isDoor) {
+            sharedData.params.isDoor = true;
+        }
+        if (withKey) {
+            sharedData.params.key = withKey.name;
+        }
+        if (sharedData.willAutoOpen) {
+            sharedData.params.willAutoOpen = true;
+        }
+        if (sharedData.sound) {
+            sharedData.params.sound = sharedData.sound;
+        }
+    },
+    /**
+     * Report phase - generates events after successful execution
+     *
+     * Uses simplified event pattern (ADR-097): domain event carries messageId directly.
+     */
+    report(context) {
+        const sharedData = getUnlockingSharedData(context);
+        // Check if behavior failed (safety net for edge cases)
+        if (sharedData.failed) {
+            return [context.event('if.event.unlock_blocked', {
+                    messageId: `${context.action.id}.${sharedData.errorMessageId}`,
+                    params: { item: sharedData.targetName },
+                    targetId: sharedData.targetId,
+                    targetName: sharedData.targetName,
+                    reason: sharedData.errorMessageId
+                })];
+        }
+        // Emit domain event with messageId (simplified pattern - ADR-097)
+        return [
+            context.event('if.event.unlocked', {
+                // Rendering data (messageId + params for text-service)
+                messageId: `${context.action.id}.${sharedData.messageId}`,
+                params: sharedData.params,
+                // Domain data (for event sourcing / handlers)
+                targetId: sharedData.targetId,
+                targetName: sharedData.targetName,
+                containerId: sharedData.targetId,
+                containerName: sharedData.targetName,
+                actorId: context.player.id,
+                isContainer: sharedData.isContainer,
+                isDoor: sharedData.isDoor,
+                keyId: sharedData.keyId,
+                keyName: sharedData.keyName,
+                sound: sharedData.sound,
+                willAutoOpen: sharedData.willAutoOpen,
+                hasContents: sharedData.hasContents,
+                contentsCount: sharedData.contentsCount,
+                contentsIds: sharedData.contentsIds
+            })
+        ];
+    },
+    /**
+     * Generate events when validation fails
+     *
+     * Uses simplified event pattern (ADR-097): domain event carries messageId directly.
+     */
+    blocked(context, result) {
+        const noun = context.command.directObject?.entity;
+        return [context.event('if.event.unlock_blocked', {
+                // Rendering data
+                messageId: `${context.action.id}.${result.error}`,
+                params: result.params || {},
+                // Domain data
+                targetId: noun?.id,
+                targetName: noun?.name,
+                reason: result.error
+            })];
+    },
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: false,
+        directObjectScope: scope_1.ScopeLevel.REACHABLE
+    }
+};
+//# sourceMappingURL=unlocking.js.map

package/dist/actions/standard/unlocking/unlocking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlocking.js","sourceRoot":"","sources":["../../../../src/actions/standard/unlocking/unlocking.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAKH,sDAAkF;AAClF,+CAA4C;AAC5C,0CAA4C;AAE5C,gDAAmG;AACnG,6DAAgD;AAwBhD,SAAS,sBAAsB,CAAC,OAAsB;IACpD,OAAO,OAAO,CAAC,UAAiC,CAAC;AACnD,CAAC;AAEY,QAAA,eAAe,GAA0C;IACpE,EAAE,EAAE,qBAAS,CAAC,SAAS;IAEvB,qDAAqD;IACrD,YAAY,EAAE;QACZ,MAAM,EAAE,kBAAU,CAAC,SAAS;QAC5B,GAAG,EAAE,kBAAU,CAAC,OAAO;KACxB;IAED,gBAAgB,EAAE;QAChB,WAAW;QACX,cAAc;QACd,QAAQ;QACR,WAAW;QACX,kBAAkB;QAClB,UAAU;QACV,eAAe;QACf,YAAY;QACZ,cAAc;QACd,cAAc;KACf;IACD,KAAK,EAAE,mBAAmB;IAE1B;;;OAGG;IACH,QAAQ,CAAC,OAAsB;QAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;QAClD,8FAA8F;QAC9F,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;QAE7F,4BAA4B;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,6BAAQ,CAAC,SAAS;aAC1B,CAAC;QACJ,CAAC;QAED,iDAAiD;QACjD,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,kBAAU,CAAC,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,OAAO,UAAU,CAAC,KAAM,CAAC;QAC3B,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,6BAAQ,CAAC,YAAY;gBAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;aAC5B,CAAC;QACJ,CAAC;QAED,iDAAiD;QACjD,IAAI,CAAC,8BAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,6BAAQ,CAAC,gBAAgB;gBAChC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;aAC5B,CAAC;QACJ,CAAC;QAED,gDAAgD;QAChD,MAAM,aAAa,GAAG,IAAA,qCAAuB,EAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC7E,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAsB;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAa,CAAC,MAAO,CAAC;QACnD,gEAAgE;QAChE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;QAC7F,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAEnD,gCAAgC;QAChC,MAAM,QAAQ,GAAG,IAAA,gCAAkB,EAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAE5D,sDAAsD;QACtD,MAAM,MAAM,GAAkB,8BAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAErE,mBAAmB;QACnB,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;QAC9B,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;QAElC,yCAAyC;QACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC;YACzB,wCAAwC;YACxC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,UAAU,CAAC,cAAc,GAAG,WAAW,CAAC;YAC1C,CAAC;iBAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACxB,UAAU,CAAC,cAAc,GAAG,QAAQ,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,cAAc,GAAG,aAAa,CAAC;YAC5C,CAAC;YACD,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC;QAE1B,qCAAqC;QACrC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YACzB,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC;YAC9B,yBAAyB;YACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpD,UAAU,CAAC,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YAC7C,UAAU,CAAC,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC3C,UAAU,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,sBAAsB;QACtB,IAAI,OAAO,EAAE,CAAC;YACZ,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC;YAC9B,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;QACpC,CAAC;QAED,oCAAoC;QACpC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;QACxC,CAAC;QAED,+BAA+B;QAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,uBAAS,CAAC,QAAQ,CAAQ,CAAC;YAC1D,IAAI,aAAa,CAAC,gBAAgB,EAAE,CAAC;gBACnC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC;YACjC,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,UAAU,CAAC,SAAS,GAAG,IAAA,kCAAoB,EAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC9D,UAAU,CAAC,MAAM,GAAG;YAClB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;QAEF,oCAAoC;QACpC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YACzB,UAAU,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;YACrC,UAAU,CAAC,MAAM,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QACzD,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;QAClC,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,UAAU,CAAC,MAAM,CAAC,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;QACvC,CAAC;QACD,IAAI,UAAU,CAAC,YAAY,EAAE,CAAC;YAC5B,UAAU,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;QACxC,CAAC;QACD,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,UAAU,CAAC,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAsB;QAC3B,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAEnD,uDAAuD;QACvD,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE;oBAC/C,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,UAAU,CAAC,cAAc,EAAE;oBAC9D,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,EAAE;oBACvC,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,UAAU,EAAE,UAAU,CAAC,UAAU;oBACjC,MAAM,EAAE,UAAU,CAAC,cAAc;iBAClC,CAAC,CAAC,CAAC;QACN,CAAC;QAED,kEAAkE;QAClE,OAAO;YACL,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE;gBACjC,uDAAuD;gBACvD,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,UAAU,CAAC,SAAS,EAAE;gBACzD,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,8CAA8C;gBAC9C,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,UAAU,EAAE,UAAU,CAAC,UAAU;gBACjC,WAAW,EAAE,UAAU,CAAC,QAAQ;gBAChC,aAAa,EAAE,UAAU,CAAC,UAAU;gBACpC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;gBAC1B,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,aAAa,EAAE,UAAU,CAAC,aAAa;gBACvC,WAAW,EAAE,UAAU,CAAC,WAAW;aACpC,CAAC;SACH,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAsB,EAAE,MAAwB;QACtD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;QAElD,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE;gBAC/C,iBAAiB;gBACjB,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,EAAE;gBACjD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;gBAC3B,cAAc;gBACd,QAAQ,EAAE,IAAI,EAAE,EAAE;gBAClB,UAAU,EAAE,IAAI,EAAE,IAAI;gBACtB,MAAM,EAAE,MAAM,CAAC,KAAK;aACrB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,QAAQ,EAAE;QACR,oBAAoB,EAAE,IAAI;QAC1B,sBAAsB,EAAE,KAAK;QAC7B,iBAAiB,EAAE,kBAAU,CAAC,SAAS;KACxC;CACF,CAAC"}

package/dist/actions/standard/version/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Version action module exports
+ */
+export { versionAction, ENGINE_VERSION } from './version';
+export type { VersionDisplayedEventData, VersionEventMap } from './version-events';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/standard/version/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/version/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/actions/standard/version/index.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Version action module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENGINE_VERSION = exports.versionAction = void 0;
+var version_1 = require("./version");
+Object.defineProperty(exports, "versionAction", { enumerable: true, get: function () { return version_1.versionAction; } });
+Object.defineProperty(exports, "ENGINE_VERSION", { enumerable: true, get: function () { return version_1.ENGINE_VERSION; } });
+//# sourceMappingURL=index.js.map

package/dist/actions/standard/version/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/version/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAA0D;AAAjD,wGAAA,aAAa,OAAA;AAAE,yGAAA,cAAc,OAAA"}

package/dist/actions/standard/version/version-events.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Event type definitions for the version action
+ */
+/**
+ * Event data for when version information is displayed
+ * Uses domain event pattern with embedded messageId (ADR-097)
+ *
+ * Includes both semantic fields (storyVersion, storyTitle) and
+ * template-friendly aliases (version, title) for banner compatibility.
+ */
+export interface VersionDisplayedEventData {
+    /** Message ID for text-service lookup */
+    messageId: string;
+    /** Parameters for message template substitution */
+    params: {
+        storyVersion?: string;
+        storyTitle?: string;
+        engineVersion?: string;
+        clientVersion?: string;
+        buildDate?: string;
+        author?: string;
+        title?: string;
+        version?: string;
+    };
+    /** Story/game version */
+    storyVersion?: string;
+    /** Story title */
+    storyTitle?: string;
+    /** Engine version */
+    engineVersion?: string;
+    /** Client version (browser, electron, etc.) */
+    clientVersion?: string;
+    /** Build timestamp (ISO 8601) */
+    buildDate?: string;
+    /** Whether this is a blocked/error case */
+    blocked?: boolean;
+    /** Reason for block (if blocked) */
+    reason?: string;
+}
+/**
+ * Complete event map for version action
+ */
+export interface VersionEventMap {
+    'if.event.version_displayed': VersionDisplayedEventData;
+}
+//# sourceMappingURL=version-events.d.ts.map

package/dist/actions/standard/version/version-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/version/version-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B,EAAE,yBAAyB,CAAC;CACzD"}

package/dist/actions/standard/version/version-events.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Event type definitions for the version action
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=version-events.js.map

package/dist/actions/standard/version/version-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-events.js","sourceRoot":"","sources":["../../../../src/actions/standard/version/version-events.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/actions/standard/version/version.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Version action - displays version information about the game and engine
+ *
+ * This is a meta action that emits version information for display.
+ * The text service will render the version info based on story config
+ * and engine version data.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions)
+ * 2. execute: No world mutations
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit version event with version data
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+/** Engine version - update this when engine version changes */
+export declare const ENGINE_VERSION = "0.9.43-beta.1";
+export declare const versionAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=version.d.ts.map

package/dist/actions/standard/version/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/version/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,+DAA+D;AAC/D,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAE9C,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA2E9D,CAAC"}

package/dist/actions/standard/version/version.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Version action - displays version information about the game and engine
+ *
+ * This is a meta action that emits version information for display.
+ * The text service will render the version info based on story config
+ * and engine version data.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions)
+ * 2. execute: No world mutations
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit version event with version data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.versionAction = exports.ENGINE_VERSION = void 0;
+const constants_1 = require("../../constants");
+/** Engine version - update this when engine version changes */
+exports.ENGINE_VERSION = '0.9.43-beta.1';
+exports.versionAction = {
+    id: constants_1.IFActions.VERSION,
+    validate(context) {
+        // Version action always succeeds
+        return {
+            valid: true
+        };
+    },
+    execute(context) {
+        // No state mutations needed for this meta action
+    },
+    blocked(context, result) {
+        // Version always succeeds, but include blocked for consistency
+        return [context.event('if.event.version_displayed', {
+                messageId: `if.action.version.${result.error}`,
+                params: result.params || {},
+                blocked: true,
+                reason: result.error
+            })];
+    },
+    report(context) {
+        // Get version info from world/story config
+        const world = context.world;
+        const storyConfig = world.storyConfig || {};
+        const versionInfo = world.versionInfo || {};
+        const storyTitle = storyConfig.title || 'Unknown';
+        const storyVersion = versionInfo.version || storyConfig.version || '0.0.0';
+        const engineVersion = versionInfo.engineVersion || exports.ENGINE_VERSION;
+        const clientVersion = versionInfo.clientVersion || world.clientVersion || 'N/A';
+        const buildDate = versionInfo.buildDate;
+        const author = storyConfig.author || 'Unknown';
+        // Determine messageId based on available data
+        // Use existing lang-en-us keys: version_full, version_no_date
+        const messageId = buildDate
+            ? 'if.action.version.version_full'
+            : 'if.action.version.version_no_date';
+        // Event data with messageId for text-service lookup
+        const eventData = {
+            messageId,
+            params: {
+                storyTitle,
+                storyVersion,
+                engineVersion,
+                clientVersion,
+                buildDate,
+                title: storyTitle,
+                version: storyVersion,
+                author: Array.isArray(author) ? author.join(', ') : author
+            },
+            // Domain data for event handlers
+            storyTitle,
+            storyVersion,
+            engineVersion,
+            clientVersion,
+            buildDate
+        };
+        return [
+            context.event('if.event.version_displayed', eventData)
+        ];
+    },
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=version.js.map

package/dist/actions/standard/version/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../src/actions/standard/version/version.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAIH,+CAA4C;AAI5C,+DAA+D;AAClD,QAAA,cAAc,GAAG,eAAe,CAAC;AAEjC,QAAA,aAAa,GAA0C;IAClE,EAAE,EAAE,qBAAS,CAAC,OAAO;IAErB,QAAQ,CAAC,OAAsB;QAC7B,iCAAiC;QACjC,OAAO;YACL,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,iDAAiD;IACnD,CAAC;IAED,OAAO,CAAC,OAAsB,EAAE,MAAwB;QACtD,+DAA+D;QAC/D,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE;gBAClD,SAAS,EAAE,qBAAqB,MAAM,CAAC,KAAK,EAAE;gBAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;gBAC3B,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,MAAM,CAAC,KAAK;aACrB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,CAAC,OAAsB;QAC3B,2CAA2C;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,MAAM,WAAW,GAAI,KAAa,CAAC,WAAW,IAAI,EAAE,CAAC;QACrD,MAAM,WAAW,GAAI,KAAa,CAAC,WAAW,IAAI,EAAE,CAAC;QAErD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,IAAI,SAAS,CAAC;QAClD,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;QAC3E,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,IAAI,sBAAc,CAAC;QAClE,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,IAAK,KAAa,CAAC,aAAa,IAAI,KAAK,CAAC;QACzF,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;QACxC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,SAAS,CAAC;QAE/C,8CAA8C;QAC9C,8DAA8D;QAC9D,MAAM,SAAS,GAAG,SAAS;YACzB,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,mCAAmC,CAAC;QAExC,oDAAoD;QACpD,MAAM,SAAS,GAA8B;YAC3C,SAAS;YACT,MAAM,EAAE;gBACN,UAAU;gBACV,YAAY;gBACZ,aAAa;gBACb,aAAa;gBACb,SAAS;gBACT,KAAK,EAAE,UAAU;gBACjB,OAAO,EAAE,YAAY;gBACrB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM;aAC3D;YACD,iCAAiC;YACjC,UAAU;YACV,YAAY;YACZ,aAAa;YACb,aAAa;YACb,SAAS;SACV,CAAC;QAEF,OAAO;YACL,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,SAAS,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,KAAK,EAAE,MAAM;IAEb,QAAQ,EAAE;QACR,oBAAoB,EAAE,KAAK;QAC3B,sBAAsB,EAAE,KAAK;KAC9B;CACF,CAAC"}

package/dist/actions/standard/waiting/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Waiting action module exports
+ */
+export { waitingAction } from './waiting';
+export type { WaitedEventData, WaitingEventMap } from './waiting-events';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/standard/waiting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/waiting/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/actions/standard/waiting/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Waiting action module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitingAction = void 0;
+var waiting_1 = require("./waiting");
+Object.defineProperty(exports, "waitingAction", { enumerable: true, get: function () { return waiting_1.waitingAction; } });
+//# sourceMappingURL=index.js.map

package/dist/actions/standard/waiting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/waiting/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAA0C;AAAjC,wGAAA,aAAa,OAAA"}

package/dist/actions/standard/waiting/waiting-events.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Event type definitions for the waiting action
+ */
+import { EntityId } from '@sharpee/core';
+/**
+ * Event data for when an actor waits
+ */
+export interface WaitedEventData {
+    /** Number of turns that passed while waiting */
+    turnsPassed: number;
+    /** Location where the waiting occurred */
+    location?: EntityId;
+    /** Name of the location */
+    locationName?: string;
+    /** Number of consecutive waits */
+    waitCount?: number;
+    /** ID of any pending timed event */
+    pendingEvent?: string;
+}
+/**
+ * Complete event map for waiting action
+ */
+export interface WaitingEventMap {
+    'if.event.waited': WaitedEventData;
+    'action.success': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+}
+//# sourceMappingURL=waiting-events.d.ts.map

package/dist/actions/standard/waiting/waiting-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/waiting/waiting-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,eAAe,CAAC;IACnC,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC9B,CAAC;CACH"}

package/dist/actions/standard/waiting/waiting-events.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Event type definitions for the waiting action
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=waiting-events.js.map

package/dist/actions/standard/waiting/waiting-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting-events.js","sourceRoot":"","sources":["../../../../src/actions/standard/waiting/waiting-events.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/actions/standard/waiting/waiting.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Waiting action - passes time without doing anything
+ *
+ * This is a signal action that emits an event to indicate the player
+ * chose to wait. The engine handles turn advancement and daemon processing.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions for waiting)
+ * 2. execute: No world mutations (stores location in sharedData)
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emits if.event.waited signal for engine/daemons
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const waitingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=waiting.d.ts.map

package/dist/actions/standard/waiting/waiting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/waiting/waiting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAerD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAqD9D,CAAC"}

package/dist/actions/standard/waiting/waiting.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Waiting action - passes time without doing anything
+ *
+ * This is a signal action that emits an event to indicate the player
+ * chose to wait. The engine handles turn advancement and daemon processing.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions for waiting)
+ * 2. execute: No world mutations (stores location in sharedData)
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emits if.event.waited signal for engine/daemons
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitingAction = void 0;
+const constants_1 = require("../../constants");
+function getWaitingSharedData(context) {
+    return context.sharedData;
+}
+exports.waitingAction = {
+    id: constants_1.IFActions.WAITING,
+    requiredMessages: [
+        'time_passes'
+    ],
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    },
+    validate(context) {
+        // Waiting always succeeds - no preconditions
+        return { valid: true };
+    },
+    execute(context) {
+        // Waiting has NO world mutations
+        // Just store location info in sharedData for report phase
+        const location = context.currentLocation;
+        const sharedData = getWaitingSharedData(context);
+        sharedData.locationId = location?.id;
+        sharedData.locationName = location?.name;
+    },
+    blocked(context, result) {
+        // Waiting always succeeds, but include blocked for consistency
+        return [context.event('if.event.wait_blocked', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: result.params,
+                reason: result.error
+            })];
+    },
+    report(context) {
+        const events = [];
+        const sharedData = getWaitingSharedData(context);
+        // Emit waited event with messageId for text rendering
+        // Engine/daemons listen to this to advance turn counter and process scheduled events
+        events.push(context.event('if.event.waited', {
+            messageId: `${context.action.id}.time_passes`,
+            turnsPassed: 1,
+            location: sharedData.locationId,
+            locationName: sharedData.locationName
+        }));
+        return events;
+    }
+};
+//# sourceMappingURL=waiting.js.map

package/dist/actions/standard/waiting/waiting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting.js","sourceRoot":"","sources":["../../../../src/actions/standard/waiting/waiting.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAIH,+CAA4C;AAY5C,SAAS,oBAAoB,CAAC,OAAsB;IAClD,OAAO,OAAO,CAAC,UAA+B,CAAC;AACjD,CAAC;AAEY,QAAA,aAAa,GAA0C;IAClE,EAAE,EAAE,qBAAS,CAAC,OAAO;IAErB,gBAAgB,EAAE;QAChB,aAAa;KACd;IAED,KAAK,EAAE,MAAM;IAEb,QAAQ,EAAE;QACR,oBAAoB,EAAE,KAAK;QAC3B,sBAAsB,EAAE,KAAK;KAC9B;IAED,QAAQ,CAAC,OAAsB;QAC7B,6CAA6C;QAC7C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,iCAAiC;QACjC,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;QACzC,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,UAAU,CAAC,UAAU,GAAG,QAAQ,EAAE,EAAE,CAAC;QACrC,UAAU,CAAC,YAAY,GAAG,QAAQ,EAAE,IAAI,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,OAAsB,EAAE,MAAwB;QACtD,+DAA+D;QAC/D,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBAC7C,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,EAAE;gBACjD,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,KAAK;aACrB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,CAAC,OAAsB;QAC3B,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAEjD,sDAAsD;QACtD,qFAAqF;QACrF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE;YAC3C,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,cAAc;YAC7C,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,UAAU,CAAC,UAAU;YAC/B,YAAY,EAAE,UAAU,CAAC,YAAY;SACK,CAAC,CAAC,CAAC;QAE/C,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}