@sharpee/stdlib 0.9.60-beta

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

@@ -0,0 +1,48 @@
+/**
+ * Event type definitions for the inventory action
+ * @module
+ */
+export interface InventoryItem {
+    /** Item ID */
+    id: string;
+    /** Item name for display */
+    name: string;
+    /** Whether the item is worn */
+    worn?: boolean;
+}
+export interface InventoryEventData {
+    /** ID of the actor checking inventory */
+    actorId: string;
+    /** ID of the location where the check occurs */
+    locationId: string;
+    /** Total number of items carried */
+    totalItems: number;
+    /** Number of items held (not worn) */
+    heldItems: number;
+    /** Number of items worn */
+    wornItems: number;
+    /** Whether inventory is empty */
+    isEmpty: boolean;
+    /** List of carried items (not worn) */
+    carried: InventoryItem[];
+    /** List of worn items */
+    worn: InventoryItem[];
+    /** Complete list of all items with worn status */
+    items: InventoryItem[];
+    /** Total weight carried (if applicable) */
+    totalWeight?: number;
+    /** Maximum weight capacity (if applicable) */
+    maxWeight?: number;
+    /** Weight limit (same as maxWeight) */
+    weightLimit?: number;
+    /** Weight as percentage of limit */
+    weightPercentage?: number;
+    /** Burden status: 'light', 'heavy', or 'overloaded' */
+    burden?: 'light' | 'heavy' | 'overloaded';
+    /** Whether this is a brief inventory check */
+    brief?: boolean;
+}
+export interface InventoryEventMap {
+    'if.action.inventory': InventoryEventData;
+}
+//# sourceMappingURL=inventory-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/inventory/inventory-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,cAAc;IACd,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,yBAAyB;IACzB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,kDAAkD;IAClD,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,YAAY,CAAC;IAC1C,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,qBAAqB,EAAE,kBAAkB,CAAC;CAC3C"}

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

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

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

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

package/dist/actions/standard/inventory/inventory-messages.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Message constants for the inventory action
+ *
+ * These constants provide type safety for message IDs within stdlib.
+ * The lang-en-us package uses matching string literals (stable, injected at runtime).
+ */
+export declare const InventoryMessages: {
+    readonly INVENTORY_EMPTY: "inventory_empty";
+    readonly CARRYING: "carrying";
+    readonly WEARING: "wearing";
+    readonly CARRYING_AND_WEARING: "carrying_and_wearing";
+    readonly HOLDING_LIST: "holding_list";
+    readonly WORN_LIST: "worn_list";
+    readonly CHECKING_POCKETS: "checking_pockets";
+    readonly RIFLING_THROUGH_BAG: "rifling_through_bag";
+    readonly INVENTORY_HEADER: "inventory_header";
+    readonly NOTHING_AT_ALL: "nothing_at_all";
+    readonly HANDS_EMPTY: "hands_empty";
+    readonly POCKETS_EMPTY: "pockets_empty";
+    readonly CARRYING_COUNT: "carrying_count";
+    readonly WEARING_COUNT: "wearing_count";
+    readonly BURDEN_LIGHT: "burden_light";
+    readonly BURDEN_HEAVY: "burden_heavy";
+    readonly BURDEN_OVERLOADED: "burden_overloaded";
+};
+export type InventoryMessageId = typeof InventoryMessages[keyof typeof InventoryMessages];
+//# sourceMappingURL=inventory-messages.d.ts.map

package/dist/actions/standard/inventory/inventory-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-messages.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/inventory/inventory-messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;CAmBpB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/actions/standard/inventory/inventory-messages.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InventoryMessages = void 0;
+/**
+ * Message constants for the inventory action
+ *
+ * These constants provide type safety for message IDs within stdlib.
+ * The lang-en-us package uses matching string literals (stable, injected at runtime).
+ */
+exports.InventoryMessages = {
+    // Success messages
+    INVENTORY_EMPTY: 'inventory_empty',
+    CARRYING: 'carrying',
+    WEARING: 'wearing',
+    CARRYING_AND_WEARING: 'carrying_and_wearing',
+    HOLDING_LIST: 'holding_list',
+    WORN_LIST: 'worn_list',
+    CHECKING_POCKETS: 'checking_pockets',
+    RIFLING_THROUGH_BAG: 'rifling_through_bag',
+    INVENTORY_HEADER: 'inventory_header',
+    NOTHING_AT_ALL: 'nothing_at_all',
+    HANDS_EMPTY: 'hands_empty',
+    POCKETS_EMPTY: 'pockets_empty',
+    CARRYING_COUNT: 'carrying_count',
+    WEARING_COUNT: 'wearing_count',
+    BURDEN_LIGHT: 'burden_light',
+    BURDEN_HEAVY: 'burden_heavy',
+    BURDEN_OVERLOADED: 'burden_overloaded',
+};
+//# sourceMappingURL=inventory-messages.js.map

package/dist/actions/standard/inventory/inventory-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-messages.js","sourceRoot":"","sources":["../../../../src/actions/standard/inventory/inventory-messages.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,iBAAiB,GAAG;IAC/B,mBAAmB;IACnB,eAAe,EAAE,iBAAiB;IAClC,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,oBAAoB,EAAE,sBAAsB;IAC5C,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;IACpC,mBAAmB,EAAE,qBAAqB;IAC1C,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Inventory action - Player checks what they're carrying
+ *
+ * This is treated as an observable action where the player
+ * physically checks their pockets/bag, which NPCs can notice.
+ *
+ * Unlike scoring which uses capability data, inventory queries
+ * the world model directly since items are core entities.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions)
+ * 2. execute: Analyze inventory (no world mutations)
+ * 3. report: Emit success events and messages
+ * 4. blocked: Generate error events (never called since always valid)
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const inventoryAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=inventory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/inventory/inventory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAI/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAiKrD,eAAO,MAAM,eAAe,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAwGhE,CAAC"}

package/dist/actions/standard/inventory/inventory.js

@@ -0,0 +1,239 @@
+"use strict";
+/**
+ * Inventory action - Player checks what they're carrying
+ *
+ * This is treated as an observable action where the player
+ * physically checks their pockets/bag, which NPCs can notice.
+ *
+ * Unlike scoring which uses capability data, inventory queries
+ * the world model directly since items are core entities.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions)
+ * 2. execute: Analyze inventory (no world mutations)
+ * 3. report: Emit success events and messages
+ * 4. blocked: Generate error events (never called since always valid)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inventoryAction = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+const inventory_messages_1 = require("./inventory-messages");
+function getInventorySharedData(context) {
+    return context.sharedData;
+}
+/**
+ * Analyzes the player's inventory and generates data for events
+ * Shared logic between validate and execute phases
+ */
+function analyzeInventory(context) {
+    const player = context.player;
+    const location = context.currentLocation;
+    // Query the world model for what the player is carrying
+    const carried = context.world.getContents(player.id);
+    // Separate worn items from held items
+    const worn = carried.filter(item => {
+        if (item.has(world_model_1.TraitType.WEARABLE)) {
+            const wearable = item.get(world_model_1.TraitType.WEARABLE);
+            return wearable.worn;
+        }
+        return false;
+    });
+    const holding = carried.filter(item => {
+        if (item.has(world_model_1.TraitType.WEARABLE)) {
+            const wearable = item.get(world_model_1.TraitType.WEARABLE);
+            return !wearable.worn;
+        }
+        return true;
+    });
+    // Calculate weight if player has inventory limits
+    let totalWeight = 0;
+    let hasWeightLimit = false;
+    let weightLimit = 0;
+    if (player.has(world_model_1.TraitType.ACTOR)) {
+        const actorTrait = player.get(world_model_1.TraitType.ACTOR);
+        if (actorTrait && actorTrait.inventoryLimit?.maxWeight !== undefined) {
+            hasWeightLimit = true;
+            weightLimit = actorTrait.inventoryLimit.maxWeight;
+            // Calculate weight manually from items
+            carried.forEach(item => {
+                const identity = item.get(world_model_1.TraitType.IDENTITY);
+                if (identity && identity.weight) {
+                    totalWeight += identity.weight;
+                }
+            });
+        }
+    }
+    // Build event data for the observable action
+    const eventData = {
+        actorId: player.id,
+        locationId: location.id,
+        totalItems: carried.length,
+        heldItems: holding.length,
+        wornItems: worn.length,
+        isEmpty: carried.length === 0,
+        carried: holding.map(e => ({ id: e.id, name: e.name })),
+        worn: worn.map(e => ({ id: e.id, name: e.name })),
+        items: [
+            ...holding.map(e => ({ id: e.id, name: e.name, worn: false })),
+            ...worn.map(e => ({ id: e.id, name: e.name, worn: true }))
+        ]
+    };
+    // Add weight info if applicable
+    if (hasWeightLimit) {
+        eventData.totalWeight = totalWeight;
+        eventData.maxWeight = weightLimit;
+        eventData.weightLimit = weightLimit;
+        eventData.weightPercentage = Math.round((totalWeight / weightLimit) * 100);
+        // Determine burden status
+        if (carried.length > 0) {
+            const percentage = (totalWeight / weightLimit) * 100;
+            if (percentage >= 90) {
+                eventData.burden = 'overloaded';
+            }
+            else if (percentage >= 75) {
+                eventData.burden = 'heavy';
+            }
+            else {
+                eventData.burden = 'light';
+            }
+        }
+    }
+    // Check action verb for variations
+    const verb = context.command.parsed.structure.verb?.text.toLowerCase() || 'inventory';
+    if (verb === 'i' || verb === 'inv') {
+        // Short form, brief output
+        eventData.brief = true;
+    }
+    const params = {};
+    // Determine appropriate message based on inventory state
+    let messageId = 'carrying';
+    if (carried.length === 0) {
+        messageId = 'inventory_empty';
+        // Vary the empty message
+        const emptyMessages = ['inventory_empty', 'nothing_at_all', 'hands_empty', 'pockets_empty'];
+        messageId = emptyMessages[Math.floor(Math.random() * emptyMessages.length)];
+    }
+    else if (holding.length > 0 && worn.length > 0) {
+        messageId = 'carrying_and_wearing';
+        params.holdingCount = holding.length;
+        params.wearingCount = worn.length;
+    }
+    else if (worn.length > 0 && holding.length === 0) {
+        messageId = 'wearing';
+        params.wearingCount = worn.length;
+    }
+    else {
+        params.holdingCount = holding.length;
+    }
+    // Prepare lists for display
+    const holdingList = holding.length > 0 ? holding.map(e => e.name).join(', ') : undefined;
+    const wornList = worn.length > 0 ? worn.map(e => e.name).join(', ') : undefined;
+    const burdenMessage = eventData.burden && carried.length > 0 ? `burden_${eventData.burden}` : undefined;
+    return {
+        holding,
+        worn,
+        carried,
+        eventData,
+        messageId,
+        params,
+        holdingList,
+        wornList,
+        burdenMessage,
+        totalWeight,
+        weightLimit
+    };
+}
+exports.inventoryAction = {
+    id: constants_1.IFActions.INVENTORY,
+    requiredMessages: [
+        'inventory_empty',
+        'carrying',
+        'wearing',
+        'carrying_and_wearing',
+        'holding_list',
+        'worn_list',
+        'checking_pockets',
+        'rifling_through_bag',
+        'inventory_header',
+        'nothing_at_all',
+        'hands_empty',
+        'pockets_empty',
+        'carrying_count',
+        'wearing_count',
+        'burden_light',
+        'burden_heavy',
+        'burden_overloaded'
+    ],
+    validate(context) {
+        // Inventory check is always valid - no preconditions
+        return { valid: true };
+    },
+    execute(context) {
+        // Inventory has NO world mutations
+        // Analyze inventory and store in sharedData for report phase
+        const analysis = analyzeInventory(context);
+        const sharedData = getInventorySharedData(context);
+        sharedData.analysis = analysis;
+    },
+    report(context) {
+        // report() is only called on success - inventory always succeeds
+        const events = [];
+        const sharedData = getInventorySharedData(context);
+        const analysis = sharedData.analysis;
+        if (!analysis) {
+            return events;
+        }
+        // Emit the main inventory event with messageId for text rendering
+        // Include all data for comprehensive event handling
+        events.push(context.event('if.event.inventory', {
+            messageId: `${context.action.id}.${analysis.messageId}`,
+            params: {
+                ...analysis.params,
+                holdingList: analysis.holdingList,
+                wornList: analysis.wornList
+            },
+            ...analysis.eventData
+        }));
+        // Add item lists if not empty
+        if (analysis.holdingList) {
+            events.push(context.event('if.event.inventory', {
+                messageId: `${context.action.id}.${inventory_messages_1.InventoryMessages.HOLDING_LIST}`,
+                params: { items: analysis.holdingList },
+                isHoldingList: true
+            }));
+        }
+        if (analysis.wornList) {
+            events.push(context.event('if.event.inventory', {
+                messageId: `${context.action.id}.${inventory_messages_1.InventoryMessages.WORN_LIST}`,
+                params: { items: analysis.wornList },
+                isWornList: true
+            }));
+        }
+        // Add burden status if relevant
+        if (analysis.burdenMessage) {
+            events.push(context.event('if.event.inventory', {
+                messageId: `${context.action.id}.${analysis.burdenMessage}`,
+                params: { weight: analysis.totalWeight, limit: analysis.weightLimit },
+                isBurdenMessage: true
+            }));
+        }
+        return events;
+    },
+    blocked(context, result) {
+        // blocked() is called when validation fails
+        // Inventory always succeeds, so this should never be called
+        return [context.event('if.event.inventory', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: result.params || {},
+                reason: result.error
+            })];
+    },
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=inventory.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Listening action - listen for sounds in the environment
+ */
+export { listeningAction } from './listening';
+export * from './listening-events';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Listening action - listen for sounds in the environment
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listeningAction = void 0;
+var listening_1 = require("./listening");
+Object.defineProperty(exports, "listeningAction", { enumerable: true, get: function () { return listening_1.listeningAction; } });
+__exportStar(require("./listening-events"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/listening/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AACxB,qDAAmC"}

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

@@ -0,0 +1,49 @@
+/**
+ * Event type definitions for the listening action
+ */
+import { EntityId } from '@sharpee/core';
+/**
+ * Event data for when something is listened to
+ */
+export interface ListenedEventData {
+    /** The entity that was listened to (optional) */
+    target?: EntityId;
+    /** Whether listening to the general environment */
+    listeningToEnvironment?: boolean;
+    /** Room ID when listening to environment */
+    roomId?: EntityId;
+    /** Whether the target has sound */
+    hasSound?: boolean;
+    /** Type of sound detected */
+    soundType?: 'device' | 'container' | 'liquid' | 'ambient';
+    /** IDs of sound sources in the environment */
+    soundSources?: EntityId[];
+    /** Whether target has contents (for containers) */
+    hasContents?: boolean;
+    /** Number of items in container */
+    contentCount?: number;
+}
+/**
+ * Error data for listening failures
+ */
+export interface ListeningErrorData {
+    reason: 'not_visible';
+    target?: string;
+}
+/**
+ * Complete event map for listening action
+ */
+export interface ListeningEventMap {
+    'if.event.listened': ListenedEventData;
+    'action.success': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+    'action.error': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+}
+//# sourceMappingURL=listening-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listening-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/listening/listening-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,MAAM,CAAC,EAAE,QAAQ,CAAC;IAElB,mDAAmD;IACnD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,QAAQ,CAAC;IAElB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE1D,8CAA8C;IAC9C,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;IAE1B,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,iBAAiB,CAAC;IACvC,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;IACF,cAAc,EAAE;QACd,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/listening/listening-events.js

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

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Listening action - listen for sounds in the environment
+ *
+ * This action allows players to listen for sounds in their current location
+ * or from specific objects.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions for listening)
+ * 2. execute: Analyze sounds (no world mutations)
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit listened event and success message
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const listeningAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=listening.d.ts.map

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

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