@sharpee/stdlib 0.9.60-beta

package/dist/actions/standard/inserting/inserting-data.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Data builder for inserting action
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insertedDataConfig = exports.buildInsertedData = void 0;
+const snapshot_utils_1 = require("../../base/snapshot-utils");
+const buildInsertedData = (context) => {
+    const item = context.command.directObject?.entity;
+    const container = context.command.indirectObject?.entity;
+    if (!item || !container) {
+        return { item: 'nothing', container: 'nowhere' };
+    }
+    return {
+        item: item.name,
+        itemSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(item, context.world, true),
+        container: container.name,
+        containerSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(container, context.world, true),
+        itemId: item.id,
+        containerId: container.id
+    };
+};
+exports.buildInsertedData = buildInsertedData;
+exports.insertedDataConfig = {
+    builder: exports.buildInsertedData,
+    protectedFields: ['item', 'container', 'itemId', 'containerId']
+};
+//# sourceMappingURL=inserting-data.js.map

package/dist/actions/standard/inserting/inserting-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inserting-data.js","sourceRoot":"","sources":["../../../../src/actions/standard/inserting/inserting-data.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,8DAAkE;AAE3D,MAAM,iBAAiB,GAA+C,CAC3E,OAAsB,EACG,EAAE;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;IAEzD,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IACnD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAA,sCAAqB,EAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QAC9D,SAAS,EAAE,SAAS,CAAC,IAAI;QACzB,iBAAiB,EAAE,IAAA,sCAAqB,EAAC,SAAS,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QACxE,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,WAAW,EAAE,SAAS,CAAC,EAAE;KAC1B,CAAC;AACJ,CAAC,CAAC;AAlBW,QAAA,iBAAiB,qBAkB5B;AAEW,QAAA,kBAAkB,GAA8C;IAC3E,OAAO,EAAE,yBAAiB;IAC1B,eAAe,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC;CAChE,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Event type definitions for the inserting action
+ * @module
+ */
+export { PutInEventData as InsertedEventData } from '../putting/putting-events';
+export interface InsertingEventMap {
+    'if.event.put_in': import('../putting/putting-events').PutInEventData;
+}
+//# sourceMappingURL=inserting-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inserting-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/inserting/inserting-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,OAAO,2BAA2B,EAAE,cAAc,CAAC;CACvE"}

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

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

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Message constants for the inserting action
+ * Used by validate() and blocked() for consistent error messages
+ */
+export declare const InsertingMessages: {
+    readonly NO_TARGET: "no_target";
+    readonly NO_DESTINATION: "no_destination";
+    readonly NOT_HELD: "not_held";
+    readonly NOT_INSERTABLE: "not_insertable";
+    readonly NOT_CONTAINER: "not_container";
+    readonly ALREADY_THERE: "already_there";
+    readonly INSERTED: "inserted";
+    readonly WONT_FIT: "wont_fit";
+    readonly CONTAINER_CLOSED: "container_closed";
+    readonly CANT_INSERT: "cant_insert";
+    readonly NOTHING_TO_INSERT: "nothing_to_insert";
+};
+//# sourceMappingURL=inserting-messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inserting-messages.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/inserting/inserting-messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAYpB,CAAC"}

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InsertingMessages = void 0;
+/**
+ * Message constants for the inserting action
+ * Used by validate() and blocked() for consistent error messages
+ */
+exports.InsertingMessages = {
+    NO_TARGET: 'no_target',
+    NO_DESTINATION: 'no_destination',
+    NOT_HELD: 'not_held',
+    NOT_INSERTABLE: 'not_insertable',
+    NOT_CONTAINER: 'not_container',
+    ALREADY_THERE: 'already_there',
+    INSERTED: 'inserted',
+    WONT_FIT: 'wont_fit',
+    CONTAINER_CLOSED: 'container_closed',
+    CANT_INSERT: 'cant_insert',
+    NOTHING_TO_INSERT: 'nothing_to_insert'
+};
+//# sourceMappingURL=inserting-messages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inserting-messages.js","sourceRoot":"","sources":["../../../../src/actions/standard/inserting/inserting-messages.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,iBAAiB,GAAG;IAC/B,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,gBAAgB,EAAE,kBAAkB;IACpC,WAAW,EAAE,aAAa;IAC1B,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC"}

package/dist/actions/standard/inserting/inserting-semantic.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SEMANTIC VERSION: Inserting action - insert objects specifically into containers
+ *
+ * This version demonstrates how semantic grammar eliminates the need for:
+ * - Modifying parsed commands to add implicit prepositions
+ * - Checking verb.text for variations
+ * - Tight coupling to parser internals
+ *
+ * Instead, the grammar provides semantic properties that tell us:
+ * - spatialRelation: 'in' (normalized from 'in', 'into', or implicit)
+ * - manner: how the insertion should be performed
+ * - implicitPreposition: whether the user said "insert X Y" vs "insert X into Y"
+ */
+import { IAction } from '@sharpee/if-domain';
+export declare const insertingActionSemantic: IAction;
+/**
+ * Key improvements in this semantic version:
+ *
+ * 1. NO COMMAND MODIFICATION
+ *    - The old version modified context.command.parsed to add 'in' preposition
+ *    - This version trusts the grammar-provided semantics.spatialRelation
+ *
+ * 2. SEMANTIC-BASED BEHAVIOR
+ *    - Different messages based on manner (forceful, careful, stealthy)
+ *    - Sound events based on how the action was performed
+ *    - Validation considers semantics (forceful + fragile = error)
+ *
+ * 3. CLEANER ARCHITECTURE
+ *    - No delegation to putting action needed
+ *    - No need to create modified contexts
+ *    - Action is self-contained and focused
+ *
+ * 4. IMPLICIT PREPOSITION HANDLING
+ *    - Grammar tells us if user said "insert X Y" via implicitPreposition flag
+ *    - We can provide clearer feedback without hacking the command
+ *
+ * 5. NO PARSER COUPLING
+ *    - Never accesses context.command.parsed
+ *    - Never checks verb.text
+ *    - Never looks at structure.preposition.text
+ */ 
+//# sourceMappingURL=inserting-semantic.d.ts.map

package/dist/actions/standard/inserting/inserting-semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inserting-semantic.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/inserting/inserting-semantic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAsD,MAAM,oBAAoB,CAAC;AAIjG,eAAO,MAAM,uBAAuB,EAAE,OAuLrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}

package/dist/actions/standard/inserting/inserting-semantic.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * SEMANTIC VERSION: Inserting action - insert objects specifically into containers
+ *
+ * This version demonstrates how semantic grammar eliminates the need for:
+ * - Modifying parsed commands to add implicit prepositions
+ * - Checking verb.text for variations
+ * - Tight coupling to parser internals
+ *
+ * Instead, the grammar provides semantic properties that tell us:
+ * - spatialRelation: 'in' (normalized from 'in', 'into', or implicit)
+ * - manner: how the insertion should be performed
+ * - implicitPreposition: whether the user said "insert X Y" vs "insert X into Y"
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insertingActionSemantic = void 0;
+exports.insertingActionSemantic = {
+    id: 'if.action.inserting',
+    requiredMessages: [
+        'no_target',
+        'no_destination',
+        'not_held',
+        'not_insertable',
+        'not_container',
+        'already_there',
+        'inserted',
+        'inserted_forcefully',
+        'inserted_carefully',
+        'wont_fit',
+        'container_closed'
+    ],
+    validate(context) {
+        const item = context.command.directObject?.entity;
+        const container = context.command.indirectObject?.entity;
+        const semantics = context.command.semantics || {};
+        // Validate we have an item
+        if (!item) {
+            return {
+                valid: false,
+                error: 'no_target'
+            };
+        }
+        // Validate we have a destination
+        if (!container) {
+            return {
+                valid: false,
+                error: 'no_destination',
+                params: { item: item.attributes.name || item.id }
+            };
+        }
+        // Check if player is holding the item
+        if (!context.canReach(item)) {
+            return {
+                valid: false,
+                error: 'not_held',
+                params: { item: item.attributes.name || item.id }
+            };
+        }
+        // Check if container is actually a container
+        // Note: IEntity doesn't have getCapability - need to check attributes
+        const containerData = container.attributes?.['container'] || container.capabilities?.['container'];
+        if (!containerData) {
+            return {
+                valid: false,
+                error: 'not_container',
+                params: { container: container.attributes.name || container.id }
+            };
+        }
+        // Check if container is closed
+        if (containerData.closed) {
+            return {
+                valid: false,
+                error: 'container_closed',
+                params: { container: container.attributes.name || container.id }
+            };
+        }
+        // Check if item is already in container
+        if (context.getEntityLocation(item.id) === container.id) {
+            return {
+                valid: false,
+                error: 'already_there',
+                params: {
+                    item: item.attributes.name || item.id,
+                    container: container.attributes.name || container.id
+                }
+            };
+        }
+        // Check capacity if applicable
+        if (containerData.maxCapacity !== undefined) {
+            const contents = context.getEntityContents(container.id);
+            if (contents.length >= containerData.maxCapacity) {
+                return {
+                    valid: false,
+                    error: 'wont_fit',
+                    params: {
+                        item: item.attributes.name || item.id,
+                        container: container.attributes.name || container.id
+                    }
+                };
+            }
+        }
+        // Semantic validation: forceful insertion might damage fragile containers
+        if (semantics.manner === 'forceful' && container.attributes?.['fragile']) {
+            return {
+                valid: false,
+                error: 'would_damage',
+                params: {
+                    item: item.attributes.name || item.id,
+                    container: container.attributes.name || container.id
+                }
+            };
+        }
+        return { valid: true };
+    },
+    execute(context) {
+        // Revalidate
+        const validation = this.validate(context);
+        if (!validation.valid) {
+            return [context.event('action.error', {
+                    actionId: this.id,
+                    messageId: validation.error,
+                    params: validation.params || {}
+                })];
+        }
+        const item = context.command.directObject.entity;
+        const container = context.command.indirectObject.entity;
+        const semantics = context.command.semantics || {};
+        // Move the item into the container
+        const success = context.moveEntity(item.id, container.id);
+        if (!success) {
+            return [context.event('action.error', {
+                    actionId: this.id,
+                    messageId: 'insertion_failed',
+                    params: {
+                        item: item.attributes.name || item.id,
+                        container: container.attributes.name || container.id
+                    }
+                })];
+        }
+        // Choose message based on semantic manner
+        let messageId = 'inserted';
+        if (semantics.manner === 'forceful') {
+            messageId = 'inserted_forcefully';
+        }
+        else if (semantics.manner === 'careful') {
+            messageId = 'inserted_carefully';
+        }
+        else if (semantics.manner === 'stealthy') {
+            messageId = 'inserted_stealthily';
+        }
+        // If the preposition was implicit, we might want to be more explicit in the response
+        if (semantics.implicitPreposition) {
+            // The grammar told us the user said "insert X Y" not "insert X into Y"
+            // We can provide clearer feedback
+            messageId = 'inserted_into'; // "You insert the coin into the slot."
+        }
+        return [
+            context.event('action.success', {
+                actionId: this.id,
+                messageId: messageId,
+                params: {
+                    item: item.attributes.name || item.id,
+                    container: container.attributes.name || container.id,
+                    manner: semantics.manner || 'normal'
+                }
+            }),
+            // Additional semantic events based on manner
+            ...(semantics.manner === 'forceful' ? [
+                context.event('sound.loud', {
+                    source: container.id,
+                    description: 'clunk'
+                })
+            ] : []),
+            ...(semantics.manner === 'stealthy' ? [
+                context.event('sound.quiet', {
+                    source: container.id,
+                    description: 'soft sliding'
+                })
+            ] : [])
+        ];
+    }
+};
+/**
+ * Key improvements in this semantic version:
+ *
+ * 1. NO COMMAND MODIFICATION
+ *    - The old version modified context.command.parsed to add 'in' preposition
+ *    - This version trusts the grammar-provided semantics.spatialRelation
+ *
+ * 2. SEMANTIC-BASED BEHAVIOR
+ *    - Different messages based on manner (forceful, careful, stealthy)
+ *    - Sound events based on how the action was performed
+ *    - Validation considers semantics (forceful + fragile = error)
+ *
+ * 3. CLEANER ARCHITECTURE
+ *    - No delegation to putting action needed
+ *    - No need to create modified contexts
+ *    - Action is self-contained and focused
+ *
+ * 4. IMPLICIT PREPOSITION HANDLING
+ *    - Grammar tells us if user said "insert X Y" via implicitPreposition flag
+ *    - We can provide clearer feedback without hacking the command
+ *
+ * 5. NO PARSER COUPLING
+ *    - Never accesses context.command.parsed
+ *    - Never checks verb.text
+ *    - Never looks at structure.preposition.text
+ */ 
+//# sourceMappingURL=inserting-semantic.js.map

package/dist/actions/standard/inserting/inserting-semantic.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * Inserting action - insert objects specifically into containers
+ *
+ * This action is container-specific, unlike putting which handles both
+ * containers and supporters. It's more explicit about the container relationship.
+ * In many cases, this delegates to the putting action with 'in' preposition.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check item and container exist and are compatible
+ * 2. execute: Delegate to putting action with 'in' preposition
+ * 3. blocked: Generate error events when validation fails
+ * 4. report: Generate success events (delegates to putting)
+ *
+ * Supports multi-object commands:
+ * - "insert all in box" - inserts all carried items in box
+ * - "insert all but X in box" - inserts all except specified items
+ * - "insert X and Y in box" - inserts multiple specified items
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const insertingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=inserting.d.ts.map

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

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

package/dist/actions/standard/inserting/inserting.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Inserting action - insert objects specifically into containers
+ *
+ * This action is container-specific, unlike putting which handles both
+ * containers and supporters. It's more explicit about the container relationship.
+ * In many cases, this delegates to the putting action with 'in' preposition.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check item and container exist and are compatible
+ * 2. execute: Delegate to putting action with 'in' preposition
+ * 3. blocked: Generate error events when validation fails
+ * 4. report: Generate success events (delegates to putting)
+ *
+ * Supports multi-object commands:
+ * - "insert all in box" - inserts all carried items in box
+ * - "insert all but X in box" - inserts all except specified items
+ * - "insert X and Y in box" - inserts multiple specified items
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insertingAction = void 0;
+const types_1 = require("../../../scope/types");
+const constants_1 = require("../../constants");
+const putting_1 = require("../putting");
+const enhanced_context_1 = require("../../enhanced-context");
+const inserting_messages_1 = require("./inserting-messages");
+function getInsertingSharedData(context) {
+    return context.sharedData;
+}
+/**
+ * Create a modified command with 'in' preposition for delegation to putting
+ */
+function createModifiedCommand(context) {
+    return {
+        ...context.command,
+        parsed: {
+            ...context.command.parsed,
+            structure: {
+                ...context.command.parsed.structure,
+                preposition: {
+                    tokens: [],
+                    text: 'in'
+                }
+            },
+            preposition: 'in'
+        }
+    };
+}
+exports.insertingAction = {
+    id: constants_1.IFActions.INSERTING,
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        item: types_1.ScopeLevel.REACHABLE, // REACHABLE allows implicit take
+        container: types_1.ScopeLevel.REACHABLE
+    },
+    requiredMessages: [
+        'no_target',
+        'no_destination',
+        'not_held',
+        'not_insertable',
+        'not_container',
+        'already_there',
+        'inserted',
+        'wont_fit',
+        'container_closed',
+        'nothing_to_insert'
+    ],
+    group: 'object_manipulation',
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: true,
+        directObjectScope: types_1.ScopeLevel.REACHABLE, // REACHABLE allows implicit take
+        indirectObjectScope: types_1.ScopeLevel.REACHABLE
+    },
+    validate(context) {
+        const item = context.command.directObject?.entity;
+        const container = context.command.indirectObject?.entity;
+        // For single-object commands, validate we have an item
+        // (Multi-object commands may not have a resolved entity yet)
+        const isMultiObject = context.command.parsed.structure.directObject?.isAll ||
+            context.command.parsed.structure.directObject?.isList;
+        if (!isMultiObject && !item) {
+            return {
+                valid: false,
+                error: inserting_messages_1.InsertingMessages.NO_TARGET
+            };
+        }
+        // Validate we have a destination
+        if (!container) {
+            return {
+                valid: false,
+                error: inserting_messages_1.InsertingMessages.NO_DESTINATION,
+                params: { item: item?.name }
+            };
+        }
+        // Create modified command with 'in' preposition for delegation to putting
+        const modifiedCommand = createModifiedCommand(context);
+        // Create a new context for the putting action with the modified command
+        const modifiedContext = (0, enhanced_context_1.createActionContext)(context.world, context.player, putting_1.puttingAction, modifiedCommand);
+        // Store modified context for execute/report phases (preserves implicit take events)
+        const sharedData = getInsertingSharedData(context);
+        sharedData.modifiedContext = modifiedContext;
+        // Delegate validation to putting action
+        // This includes implicit take check - events stored in modifiedContext.sharedData
+        const puttingValidation = putting_1.puttingAction.validate(modifiedContext);
+        if (!puttingValidation.valid) {
+            return puttingValidation;
+        }
+        return { valid: true };
+    },
+    execute(context) {
+        // Reuse the modified context from validate (preserves implicit take events)
+        const sharedData = getInsertingSharedData(context);
+        const modifiedContext = sharedData.modifiedContext;
+        if (!modifiedContext) {
+            // Shouldn't happen, but create one defensively
+            const modifiedCommand = createModifiedCommand(context);
+            sharedData.modifiedContext = (0, enhanced_context_1.createActionContext)(context.world, context.player, putting_1.puttingAction, modifiedCommand);
+        }
+        // Execute putting action
+        putting_1.puttingAction.execute(sharedData.modifiedContext);
+    },
+    /**
+     * Report events after successful inserting
+     *
+     * Delegates to putting action which uses simplified event pattern (ADR-097).
+     */
+    report(context) {
+        const sharedData = getInsertingSharedData(context);
+        const modifiedContext = sharedData.modifiedContext;
+        if (!modifiedContext) {
+            // Shouldn't happen, but handle gracefully with domain event
+            const item = context.command.directObject?.entity;
+            const container = context.command.indirectObject?.entity;
+            return [context.event('if.event.insert_blocked', {
+                    messageId: `${context.action.id}.${inserting_messages_1.InsertingMessages.CANT_INSERT}`,
+                    params: { item: item?.name, container: container?.name },
+                    itemId: item?.id,
+                    itemName: item?.name,
+                    containerId: container?.id,
+                    containerName: container?.name,
+                    reason: 'cant_insert'
+                })];
+        }
+        // Delegate to putting action's report (already using new pattern)
+        if ('report' in putting_1.puttingAction && typeof putting_1.puttingAction.report === 'function') {
+            return putting_1.puttingAction.report(modifiedContext);
+        }
+        // Shouldn't happen since putting is migrated
+        return [];
+    },
+    /**
+     * Generate events when validation fails
+     *
+     * Uses simplified event pattern (ADR-097): domain event carries messageId directly.
+     */
+    blocked(context, result) {
+        const item = context.command.directObject?.entity;
+        const container = context.command.indirectObject?.entity;
+        return [context.event('if.event.insert_blocked', {
+                // Rendering data
+                messageId: `${context.action.id}.${result.error}`,
+                params: {
+                    ...result.params,
+                    item: item?.name,
+                    container: container?.name
+                },
+                // Domain data
+                itemId: item?.id,
+                itemName: item?.name,
+                containerId: container?.id,
+                containerName: container?.name,
+                reason: result.error
+            })];
+    }
+};
+//# sourceMappingURL=inserting.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Inventory action module
+ * @module
+ */
+export { inventoryAction } from './inventory';
+export * from './inventory-events';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Inventory action module
+ * @module
+ */
+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.inventoryAction = void 0;
+var inventory_1 = require("./inventory");
+Object.defineProperty(exports, "inventoryAction", { enumerable: true, get: function () { return inventory_1.inventoryAction; } });
+__exportStar(require("./inventory-events"), exports);
+//# sourceMappingURL=index.js.map

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

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