@sharpee/stdlib 0.9.62-beta → 0.9.66-beta

package/dist-npm/actions/base/report-helpers.d.ts

@@ -1,90 +0,0 @@
-/**
- * Report phase helpers for reducing boilerplate across actions
- *
- * These helpers standardize error event generation in the report phase,
- * ensuring consistent error handling across all stdlib actions.
- */
-import { ActionContext, ValidationResult } from '../enhanced-types';
-import { ISemanticEvent } from '@sharpee/core';
-/**
- * Options for error event generation
- */
-export interface ErrorEventOptions {
-    /**
-     * Whether to include a snapshot of the direct object entity.
-     * Defaults to true if the entity exists.
-     */
-    includeTargetSnapshot?: boolean;
-    /**
-     * Whether to include a snapshot of the indirect object entity.
-     * Defaults to true if the entity exists.
-     */
-    includeIndirectSnapshot?: boolean;
-}
-/**
- * Handle validation errors in report phase
- *
- * Creates standardized error events when validation fails.
- * Returns null if validation passed (valid === true).
- *
- * @param context The action context
- * @param validationResult The result from the validate phase
- * @param options Optional configuration for snapshot capture
- * @returns Array of error events if validation failed, null otherwise
- *
- * @example
- * report(context, validationResult, executionError) {
- *   const errorEvents = handleValidationError(context, validationResult);
- *   if (errorEvents) return errorEvents;
- *
- *   // ... success logic
- * }
- */
-export declare function handleValidationError(context: ActionContext, validationResult?: ValidationResult, options?: ErrorEventOptions): ISemanticEvent[] | null;
-/**
- * Handle execution errors in report phase
- *
- * Creates standardized error events when execution throws an error.
- * Returns null if no execution error occurred.
- *
- * @param context The action context
- * @param executionError Error thrown during execute phase (if any)
- * @returns Array of error events if execution failed, null otherwise
- *
- * @example
- * report(context, validationResult, executionError) {
- *   const errorEvents = handleExecutionError(context, executionError);
- *   if (errorEvents) return errorEvents;
- *
- *   // ... success logic
- * }
- */
-export declare function handleExecutionError(context: ActionContext, executionError?: Error): ISemanticEvent[] | null;
-/**
- * Combined helper - handles both validation and execution errors
- *
- * This is the recommended helper for most actions. It checks validation
- * first, then execution errors, returning error events for whichever
- * failed first (or null if both succeeded).
- *
- * @param context The action context
- * @param validationResult The result from the validate phase
- * @param executionError Error thrown during execute phase (if any)
- * @param options Optional configuration for snapshot capture
- * @returns Array of error events if any error occurred, null otherwise
- *
- * @example
- * report(context, validationResult, executionError) {
- *   const errorEvents = handleReportErrors(context, validationResult, executionError);
- *   if (errorEvents) return errorEvents;
- *
- *   // All clear - generate success events
- *   const noun = context.command.directObject!.entity!;
- *   return [
- *     context.event('if.event.taken', { item: noun.name }),
- *     context.event('action.success', { actionId: this.id, messageId: 'taken' })
- *   ];
- * }
- */
-export declare function handleReportErrors(context: ActionContext, validationResult?: ValidationResult, executionError?: Error, options?: ErrorEventOptions): ISemanticEvent[] | null;
-//# sourceMappingURL=report-helpers.d.ts.map

package/dist-npm/actions/base/report-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"report-helpers.d.ts","sourceRoot":"","sources":["../../../src/actions/base/report-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EACtB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,OAAO,GAAE,iBAAsB,GAC9B,cAAc,EAAE,GAAG,IAAI,CAiCzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,cAAc,CAAC,EAAE,KAAK,GACrB,cAAc,EAAE,GAAG,IAAI,CAazB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,cAAc,CAAC,EAAE,KAAK,EACtB,OAAO,GAAE,iBAAsB,GAC9B,cAAc,EAAE,GAAG,IAAI,CAWzB"}

package/dist-npm/actions/base/report-helpers.js

@@ -1,123 +0,0 @@
-"use strict";
-/**
- * Report phase helpers for reducing boilerplate across actions
- *
- * These helpers standardize error event generation in the report phase,
- * ensuring consistent error handling across all stdlib actions.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleValidationError = handleValidationError;
-exports.handleExecutionError = handleExecutionError;
-exports.handleReportErrors = handleReportErrors;
-const snapshot_utils_1 = require("./snapshot-utils");
-/**
- * Handle validation errors in report phase
- *
- * Creates standardized error events when validation fails.
- * Returns null if validation passed (valid === true).
- *
- * @param context The action context
- * @param validationResult The result from the validate phase
- * @param options Optional configuration for snapshot capture
- * @returns Array of error events if validation failed, null otherwise
- *
- * @example
- * report(context, validationResult, executionError) {
- *   const errorEvents = handleValidationError(context, validationResult);
- *   if (errorEvents) return errorEvents;
- *
- *   // ... success logic
- * }
- */
-function handleValidationError(context, validationResult, options = {}) {
-    if (!validationResult || validationResult.valid) {
-        return null;
-    }
-    const errorParams = { ...(validationResult.params || {}) };
-    // Optionally capture entity snapshots for richer error context
-    if (options.includeTargetSnapshot !== false && context.command.directObject?.entity) {
-        errorParams.targetSnapshot = (0, snapshot_utils_1.captureEntitySnapshot)(context.command.directObject.entity, context.world, false);
-    }
-    if (options.includeIndirectSnapshot !== false && context.command.indirectObject?.entity) {
-        errorParams.indirectTargetSnapshot = (0, snapshot_utils_1.captureEntitySnapshot)(context.command.indirectObject.entity, context.world, false);
-    }
-    return [
-        context.event('action.error', {
-            actionId: context.action.id,
-            error: validationResult.error || 'validation_failed',
-            reason: validationResult.error || 'validation_failed',
-            messageId: validationResult.messageId || validationResult.error || 'action_failed',
-            params: errorParams
-        })
-    ];
-}
-/**
- * Handle execution errors in report phase
- *
- * Creates standardized error events when execution throws an error.
- * Returns null if no execution error occurred.
- *
- * @param context The action context
- * @param executionError Error thrown during execute phase (if any)
- * @returns Array of error events if execution failed, null otherwise
- *
- * @example
- * report(context, validationResult, executionError) {
- *   const errorEvents = handleExecutionError(context, executionError);
- *   if (errorEvents) return errorEvents;
- *
- *   // ... success logic
- * }
- */
-function handleExecutionError(context, executionError) {
-    if (!executionError) {
-        return null;
-    }
-    return [
-        context.event('action.error', {
-            actionId: context.action.id,
-            error: 'execution_failed',
-            messageId: 'action_failed',
-            params: { error: executionError.message }
-        })
-    ];
-}
-/**
- * Combined helper - handles both validation and execution errors
- *
- * This is the recommended helper for most actions. It checks validation
- * first, then execution errors, returning error events for whichever
- * failed first (or null if both succeeded).
- *
- * @param context The action context
- * @param validationResult The result from the validate phase
- * @param executionError Error thrown during execute phase (if any)
- * @param options Optional configuration for snapshot capture
- * @returns Array of error events if any error occurred, null otherwise
- *
- * @example
- * report(context, validationResult, executionError) {
- *   const errorEvents = handleReportErrors(context, validationResult, executionError);
- *   if (errorEvents) return errorEvents;
- *
- *   // All clear - generate success events
- *   const noun = context.command.directObject!.entity!;
- *   return [
- *     context.event('if.event.taken', { item: noun.name }),
- *     context.event('action.success', { actionId: this.id, messageId: 'taken' })
- *   ];
- * }
- */
-function handleReportErrors(context, validationResult, executionError, options = {}) {
-    // Check validation errors first
-    const validationEvents = handleValidationError(context, validationResult, options);
-    if (validationEvents)
-        return validationEvents;
-    // Then check execution errors
-    const executionEvents = handleExecutionError(context, executionError);
-    if (executionEvents)
-        return executionEvents;
-    // No errors
-    return null;
-}
-//# sourceMappingURL=report-helpers.js.map

package/dist-npm/actions/base/report-helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"report-helpers.js","sourceRoot":"","sources":["../../../src/actions/base/report-helpers.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA0CH,sDAqCC;AAoBD,oDAgBC;AA4BD,gDAgBC;AA3JD,qDAAyD;AAmBzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,qBAAqB,CACnC,OAAsB,EACtB,gBAAmC,EACnC,UAA6B,EAAE;IAE/B,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,EAAE,GAAG,CAAC,gBAAgB,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;IAE3D,+DAA+D;IAC/D,IAAI,OAAO,CAAC,qBAAqB,KAAK,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QACpF,WAAW,CAAC,cAAc,GAAG,IAAA,sCAAqB,EAChD,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EACnC,OAAO,CAAC,KAAK,EACb,KAAK,CACN,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,uBAAuB,KAAK,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QACxF,WAAW,CAAC,sBAAsB,GAAG,IAAA,sCAAqB,EACxD,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,EACrC,OAAO,CAAC,KAAK,EACb,KAAK,CACN,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE;YAC5B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;YAC3B,KAAK,EAAE,gBAAgB,CAAC,KAAK,IAAI,mBAAmB;YACpD,MAAM,EAAE,gBAAgB,CAAC,KAAK,IAAI,mBAAmB;YACrD,SAAS,EAAE,gBAAgB,CAAC,SAAS,IAAI,gBAAgB,CAAC,KAAK,IAAI,eAAe;YAClF,MAAM,EAAE,WAAW;SACpB,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,oBAAoB,CAClC,OAAsB,EACtB,cAAsB;IAEtB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE;YAC5B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;YAC3B,KAAK,EAAE,kBAAkB;YACzB,SAAS,EAAE,eAAe;YAC1B,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,EAAE;SAC1C,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,kBAAkB,CAChC,OAAsB,EACtB,gBAAmC,EACnC,cAAsB,EACtB,UAA6B,EAAE;IAE/B,gCAAgC;IAChC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACnF,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAE9C,8BAA8B;IAC9B,MAAM,eAAe,GAAG,oBAAoB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACtE,IAAI,eAAe;QAAE,OAAO,eAAe,CAAC;IAE5C,YAAY;IACZ,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist-npm/actions/base/snapshot-utils.d.ts

@@ -1,99 +0,0 @@
-/**
- * Snapshot utilities for capturing entity and room state
- *
- * These utilities help actions capture complete state snapshots
- * for atomic events during the report phase.
- */
-import { IFEntity, WorldModel } from '@sharpee/world-model';
-/**
- * Entity snapshot containing all relevant state
- */
-export interface EntitySnapshot {
-    id: string;
-    name: string;
-    description?: string;
-    shortDescription?: string;
-    /** Message ID for localized name (ADR-107) */
-    nameId?: string;
-    /** Message ID for localized description (ADR-107) */
-    descriptionId?: string;
-    location?: string;
-    isOpenable?: boolean;
-    isOpen?: boolean;
-    isLockable?: boolean;
-    isLocked?: boolean;
-    isContainer?: boolean;
-    isSupporter?: boolean;
-    isWearable?: boolean;
-    isWorn?: boolean;
-    isEdible?: boolean;
-    isPushable?: boolean;
-    isScenery?: boolean;
-    isPortable?: boolean;
-    contents?: EntitySnapshot[];
-    traits?: Record<string, unknown>;
-}
-/**
- * Room snapshot containing complete room state
- */
-export interface RoomSnapshot {
-    id: string;
-    name: string;
-    description?: string;
-    /** Message ID for localized name (ADR-107) */
-    nameId?: string;
-    /** Message ID for localized description (ADR-107) */
-    descriptionId?: string;
-    isDark?: boolean;
-    isVisited?: boolean;
-    exits?: Record<string, string>;
-    contents?: EntitySnapshot[];
-    traits?: Record<string, unknown>;
-}
-/**
- * Capture a complete snapshot of an entity's current state
- *
- * @param entity The entity to snapshot
- * @param world The world model (for getting contents)
- * @param includeContents Whether to include contents recursively
- * @returns Complete entity snapshot
- */
-export declare function captureEntitySnapshot(entity: IFEntity, world: WorldModel, includeContents?: boolean): EntitySnapshot;
-/**
- * Capture a complete snapshot of a room's current state
- *
- * @param room The room entity to snapshot
- * @param world The world model
- * @param includeContents Whether to include room contents
- * @returns Complete room snapshot
- */
-export declare function captureRoomSnapshot(room: IFEntity, world: WorldModel, includeContents?: boolean): RoomSnapshot;
-/**
- * Capture snapshots of multiple entities
- *
- * @param entities Array of entities to snapshot
- * @param world The world model
- * @returns Array of entity snapshots
- */
-export declare function captureEntitySnapshots(entities: IFEntity[], world: WorldModel): EntitySnapshot[];
-/**
- * Create a minimal entity reference (just id and name)
- *
- * @param entity The entity to reference
- * @returns Minimal entity reference
- */
-export declare function createEntityReference(entity: IFEntity): {
-    id: string;
-    name: string;
-};
-/**
- * Create references for multiple entities
- *
- * @param entities Array of entities
- * @returns Array of entity references
- */
-export declare function createEntityReferences(entities: IFEntity[]): {
-    id: string;
-    name: string;
-}[];
-//# sourceMappingURL=snapshot-utils.d.ts.map

package/dist-npm/actions/base/snapshot-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"snapshot-utils.d.ts","sourceRoot":"","sources":["../../../src/actions/base/snapshot-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,eAAe,UAAO,GACrB,cAAc,CAkGhB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,UAAU,EACjB,eAAe,UAAO,GACrB,YAAY,CAoEd;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAAE,EACpB,KAAK,EAAE,UAAU,GAChB,cAAc,EAAE,CAElB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMpF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAE3F"}

package/dist-npm/actions/base/snapshot-utils.js

@@ -1,202 +0,0 @@
-"use strict";
-/**
- * Snapshot utilities for capturing entity and room state
- *
- * These utilities help actions capture complete state snapshots
- * for atomic events during the report phase.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.captureEntitySnapshot = captureEntitySnapshot;
-exports.captureRoomSnapshot = captureRoomSnapshot;
-exports.captureEntitySnapshots = captureEntitySnapshots;
-exports.createEntityReference = createEntityReference;
-exports.createEntityReferences = createEntityReferences;
-/**
- * Capture a complete snapshot of an entity's current state
- *
- * @param entity The entity to snapshot
- * @param world The world model (for getting contents)
- * @param includeContents Whether to include contents recursively
- * @returns Complete entity snapshot
- */
-function captureEntitySnapshot(entity, world, includeContents = true) {
-    const identity = entity.get?.('identity');
-    const physical = entity.get?.('physical');
-    const openable = entity.get?.('openable');
-    const lockable = entity.get?.('lockable');
-    const container = entity.get?.('container');
-    const supporter = entity.get?.('supporter');
-    const wearable = entity.get?.('wearable');
-    const edible = entity.get?.('edible');
-    const pushable = entity.get?.('pushable');
-    const scenery = entity.get?.('scenery');
-    const snapshot = {
-        id: entity.id,
-        name: identity?.name || entity.id,
-        description: identity?.description,
-        shortDescription: identity?.shortDescription,
-        // Include message IDs if present (ADR-107 dual-mode)
-        nameId: identity?.nameId,
-        descriptionId: identity?.descriptionId,
-        location: world.getLocation(entity.id)
-    };
-    // Add physical properties
-    if (physical) {
-        snapshot.isPortable = physical.portable !== false;
-    }
-    // Add openable properties
-    if (openable !== undefined) {
-        snapshot.isOpenable = true;
-        snapshot.isOpen = openable.isOpen === true;
-    }
-    // Add lockable properties
-    if (lockable !== undefined) {
-        snapshot.isLockable = true;
-        snapshot.isLocked = lockable.isLocked === true;
-    }
-    // Add container properties
-    if (container !== undefined) {
-        snapshot.isContainer = true;
-    }
-    // Add supporter properties
-    if (supporter !== undefined) {
-        snapshot.isSupporter = true;
-    }
-    // Add wearable properties
-    if (wearable !== undefined) {
-        snapshot.isWearable = true;
-        snapshot.isWorn = wearable.isWorn === true;
-    }
-    // Add other trait flags
-    if (edible !== undefined) {
-        snapshot.isEdible = true;
-    }
-    if (pushable !== undefined) {
-        snapshot.isPushable = true;
-    }
-    if (scenery !== undefined) {
-        snapshot.isScenery = true;
-    }
-    // Capture contents if requested
-    if (includeContents && (container || supporter)) {
-        const contents = world.getContents(entity.id);
-        if (contents.length > 0) {
-            snapshot.contents = contents.map(item => captureEntitySnapshot(item, world, false) // Don't recurse deeply
-            );
-        }
-    }
-    // Add any custom traits (excluding standard ones we've already captured)
-    const standardTraits = [
-        'identity', 'physical', 'openable', 'lockable',
-        'container', 'supporter', 'wearable', 'edible',
-        'pushable', 'scenery'
-    ];
-    const customTraits = {};
-    for (const [key, value] of Object.entries(entity)) {
-        if (!standardTraits.includes(key) && key !== 'id' && key !== 'type') {
-            customTraits[key] = value;
-        }
-    }
-    if (Object.keys(customTraits).length > 0) {
-        snapshot.traits = customTraits;
-    }
-    return snapshot;
-}
-/**
- * Capture a complete snapshot of a room's current state
- *
- * @param room The room entity to snapshot
- * @param world The world model
- * @param includeContents Whether to include room contents
- * @returns Complete room snapshot
- */
-function captureRoomSnapshot(room, world, includeContents = true) {
-    const identity = room.get?.('identity');
-    const roomTrait = room.get?.('room');
-    const darknessTrait = room.get?.('darkness');
-    const snapshot = {
-        id: room.id,
-        name: identity?.name || room.attributes?.name || room.id,
-        description: identity?.description || room.attributes?.description,
-        // Include message IDs if present (ADR-107 dual-mode)
-        nameId: identity?.nameId,
-        descriptionId: identity?.descriptionId
-    };
-    // Add darkness state (can be on dedicated darkness trait OR on room trait)
-    if (darknessTrait !== undefined) {
-        snapshot.isDark = darknessTrait.isDark === true;
-    }
-    else if (roomTrait?.isDark !== undefined) {
-        snapshot.isDark = roomTrait.isDark === true;
-    }
-    // Add visited state
-    if (roomTrait?.visited !== undefined) {
-        snapshot.isVisited = roomTrait.visited === true;
-    }
-    // Capture exits
-    const exits = {};
-    const exitDirs = ['north', 'south', 'east', 'west', 'northeast', 'northwest',
-        'southeast', 'southwest', 'up', 'down', 'in', 'out'];
-    for (const dir of exitDirs) {
-        const exitId = room[dir];
-        if (exitId && typeof exitId === 'string') {
-            exits[dir] = exitId;
-        }
-    }
-    if (Object.keys(exits).length > 0) {
-        snapshot.exits = exits;
-    }
-    // Capture contents if requested
-    if (includeContents) {
-        const contents = world.getContents(room.id);
-        if (contents.length > 0) {
-            snapshot.contents = contents.map(item => captureEntitySnapshot(item, world, true));
-        }
-    }
-    // Add any custom traits
-    const standardTraits = ['identity', 'room', 'darkness'];
-    const customTraits = {};
-    for (const [key, value] of Object.entries(room)) {
-        if (!standardTraits.includes(key) && !exitDirs.includes(key) &&
-            key !== 'id' && key !== 'type') {
-            customTraits[key] = value;
-        }
-    }
-    if (Object.keys(customTraits).length > 0) {
-        snapshot.traits = customTraits;
-    }
-    return snapshot;
-}
-/**
- * Capture snapshots of multiple entities
- *
- * @param entities Array of entities to snapshot
- * @param world The world model
- * @returns Array of entity snapshots
- */
-function captureEntitySnapshots(entities, world) {
-    return entities.map(entity => captureEntitySnapshot(entity, world, true));
-}
-/**
- * Create a minimal entity reference (just id and name)
- *
- * @param entity The entity to reference
- * @returns Minimal entity reference
- */
-function createEntityReference(entity) {
-    const identity = entity.get?.('identity');
-    return {
-        id: entity.id,
-        name: identity?.name || entity.id
-    };
-}
-/**
- * Create references for multiple entities
- *
- * @param entities Array of entities
- * @returns Array of entity references
- */
-function createEntityReferences(entities) {
-    return entities.map(createEntityReference);
-}
-//# sourceMappingURL=snapshot-utils.js.map

package/dist-npm/actions/base/snapshot-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"snapshot-utils.js","sourceRoot":"","sources":["../../../src/actions/base/snapshot-utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA2DH,sDAsGC;AAUD,kDAwEC;AASD,wDAKC;AAQD,sDAMC;AAQD,wDAEC;AAtOD;;;;;;;GAOG;AACH,SAAgB,qBAAqB,CACnC,MAAgB,EAChB,KAAiB,EACjB,eAAe,GAAG,IAAI;IAEtB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAQ,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAQ,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAQ,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAQ,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAQ,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAQ,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAQ,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAQ,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAQ,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,SAAS,CAAQ,CAAC;IAE/C,MAAM,QAAQ,GAAmB;QAC/B,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,EAAE;QACjC,WAAW,EAAE,QAAQ,EAAE,WAAW;QAClC,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB;QAC5C,qDAAqD;QACrD,MAAM,EAAE,QAAQ,EAAE,MAAM;QACxB,aAAa,EAAE,QAAQ,EAAE,aAAa;QACtC,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;KACvC,CAAC;IAEF,0BAA0B;IAC1B,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,QAAQ,KAAK,KAAK,CAAC;IACpD,CAAC;IAED,0BAA0B;IAC1B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3B,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC;IAC7C,CAAC;IAED,0BAA0B;IAC1B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3B,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC;IACjD,CAAC;IAED,2BAA2B;IAC3B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED,2BAA2B;IAC3B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED,0BAA0B;IAC1B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3B,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC;IAC7C,CAAC;IAED,wBAAwB;IACxB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,gCAAgC;IAChC,IAAI,eAAe,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACtC,qBAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,uBAAuB;aAClE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,MAAM,cAAc,GAAG;QACrB,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU;QAC9C,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ;QAC9C,UAAU,EAAE,SAAS;KACtB,CAAC;IAEF,MAAM,YAAY,GAA4B,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACpE,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAC;IACjC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,IAAc,EACd,KAAiB,EACjB,eAAe,GAAG,IAAI;IAEtB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAQ,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAQ,CAAC;IAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,CAAQ,CAAC;IAEpD,MAAM,QAAQ,GAAiB;QAC7B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,IAAI,IAAI,CAAC,EAAE;QACxD,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,IAAI,CAAC,UAAU,EAAE,WAAW;QAClE,qDAAqD;QACrD,MAAM,EAAE,QAAQ,EAAE,MAAM;QACxB,aAAa,EAAE,QAAQ,EAAE,aAAa;KACvC,CAAC;IAEF,2EAA2E;IAC3E,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,KAAK,IAAI,CAAC;IAClD,CAAC;SAAM,IAAI,SAAS,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAC3C,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9C,CAAC;IAED,oBAAoB;IACpB,IAAI,SAAS,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;QACrC,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC,OAAO,KAAK,IAAI,CAAC;IAClD,CAAC;IAED,gBAAgB;IAChB,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW;QACzD,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAExE,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAI,IAAY,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,gCAAgC;IAChC,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CACtC,qBAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CACzC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,YAAY,GAA4B,EAAE,CAAC;IAEjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;YACxD,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnC,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,QAAQ,CAAC,MAAM,GAAG,YAAY,CAAC;IACjC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CACpC,QAAoB,EACpB,KAAiB;IAEjB,OAAO,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,MAAgB;IACpD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAQ,CAAC;IACjD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,MAAM,CAAC,EAAE;KAClC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,QAAoB;IACzD,OAAO,QAAQ,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAC7C,CAAC"}

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

@@ -1,48 +0,0 @@
-/**
- * Capability Dispatch Action Factory (ADR-090)
- *
- * Creates actions that dispatch to trait behaviors instead of having
- * fixed semantics. These actions find the trait claiming the capability
- * and delegate to the registered behavior.
- */
-import { Action } from './enhanced-types';
-import { ActionMetadata } from '../validation';
-import { ScopeLevel } from '../scope/types';
-/**
- * Configuration for creating a capability-dispatch action.
- */
-export interface CapabilityDispatchConfig {
-    /** Action ID (e.g., 'if.action.lowering') */
-    actionId: string;
-    /** Action group for organization */
-    group: string;
-    /** Error when no target specified */
-    noTargetError: string;
-    /** Error when target lacks capability */
-    cantDoThatError: string;
-    /** Scope level for direct object (default: REACHABLE) */
-    scope?: ScopeLevel;
-}
-/**
- * Create a capability-dispatching action.
- *
- * These actions have no fixed semantics - they find the trait on the
- * target entity that claims the capability and delegate to its behavior.
- *
- * @param config - Configuration for the action
- * @returns Action that dispatches to capability behaviors
- *
- * @example
- * ```typescript
- * export const loweringAction = createCapabilityDispatchAction({
- *   actionId: IFActions.LOWERING,
- *   group: 'manipulation',
- *   noTargetError: 'if.lower.no_target',
- *   cantDoThatError: 'if.lower.cant_lower_that'
- * });
- * ```
- */
-export declare function createCapabilityDispatchAction(config: CapabilityDispatchConfig): Action & {
-    metadata: ActionMetadata;
-};
-//# sourceMappingURL=capability-dispatch.d.ts.map

package/dist-npm/actions/capability-dispatch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"capability-dispatch.d.ts","sourceRoot":"","sources":["../../src/actions/capability-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,kBAAkB,CAAC;AAQ3E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAwBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,wBAAwB,GAC/B,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAAE,CA0IvC"}