@sharpee/stdlib 0.9.108 → 0.9.110

package/actions/author/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/actions/author/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/actions/author/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/author/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iCAAsC;AAA7B,oGAAA,WAAW,OAAA"}

package/actions/author/trace.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Trace Command
+ *
+ * Enables/disables tracing of internal engine events for debugging
+ *
+ * Usage:
+ *   trace - Show current trace status
+ *   trace on - Enable all tracing
+ *   trace off - Disable all tracing
+ *   trace parser on/off - Control parser event tracing
+ *   trace validation on/off - Control validation event tracing
+ *   trace system on/off - Control system event tracing
+ *   trace all on/off - Control all tracing
+ */
+import { ActionContext } from '../enhanced-types';
+import { MetaAction } from '../meta-action';
+import { ValidationResult } from '../enhanced-types';
+import { ISemanticEvent } from "../../../core/index";
+export declare class TraceAction extends MetaAction {
+    id: string;
+    verbs: string[];
+    constructor();
+    validate(context: ActionContext): ValidationResult;
+    execute(context: ActionContext): ISemanticEvent[];
+}
+//# sourceMappingURL=trace.d.ts.map

package/actions/author/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/actions/author/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,qBAAa,WAAY,SAAQ,UAAU;IACzC,EAAE,SAAkB;IACpB,KAAK,WAAa;;IAOlB,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB;IAuClD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,EAAE;CA4ElD"}

package/actions/author/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/author/trace.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAGH,gDAA4C;AAI5C,MAAa,WAAY,SAAQ,wBAAU;IACzC,EAAE,GAAG,cAAc,CAAC;IACpB,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;IAElB;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED,QAAQ,CAAC,OAAsB;QAC7B,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;QAE5C,6BAA6B;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAErE,+BAA+B;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;QAClD,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAElE,kBAAkB;QAClB,qBAAqB;QACrB,4BAA4B;QAC5B,qCAAqC;QAErC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,eAAe;QACzC,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;YACpD,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QAC5G,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;YAEnD,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC/D,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAElC,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAChE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;QAC9E,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAqB,EAAE,CAAC;QAEpC,sCAAsC;QACtC,IAAI,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI;YAC9C,iBAAiB,EAAE,KAAK;YACxB,qBAAqB,EAAE,KAAK;YAC5B,iBAAiB,EAAE,KAAK;SACzB,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,6BAA6B;YAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE;gBACxC,MAAM,EAAE,SAAS,CAAC,iBAAiB,IAAI,KAAK;gBAC5C,UAAU,EAAE,SAAS,CAAC,qBAAqB,IAAI,KAAK;gBACpD,MAAM,EAAE,SAAS,CAAC,iBAAiB,IAAI,KAAK;aAC7C,CAAC,CAAC,CAAC;YACJ,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,8BAA8B;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;YAC5D,SAAS,CAAC,iBAAiB,GAAG,KAAK,CAAC;YACpC,SAAS,CAAC,qBAAqB,GAAG,KAAK,CAAC;YACxC,SAAS,CAAC,iBAAiB,GAAG,KAAK,CAAC;YAEpC,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAE3C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE;gBACzC,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,KAAK;aACf,CAAC,CAAC,CAAC;YACJ,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,0BAA0B;YAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;YAE5D,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,QAAQ;oBACX,SAAS,CAAC,iBAAiB,GAAG,KAAK,CAAC;oBACpC,MAAM;gBACR,KAAK,YAAY;oBACf,SAAS,CAAC,qBAAqB,GAAG,KAAK,CAAC;oBACxC,MAAM;gBACR,KAAK,QAAQ;oBACX,SAAS,CAAC,iBAAiB,GAAG,KAAK,CAAC;oBACpC,MAAM;gBACR,KAAK,KAAK;oBACR,SAAS,CAAC,iBAAiB,GAAG,KAAK,CAAC;oBACpC,SAAS,CAAC,qBAAqB,GAAG,KAAK,CAAC;oBACxC,SAAS,CAAC,iBAAiB,GAAG,KAAK,CAAC;oBACpC,MAAM;gBACR;oBACE,kDAAkD;oBAClD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE;wBACxC,MAAM,EAAE,yBAAyB,MAAM,EAAE;qBAC1C,CAAC,CAAC,CAAC;oBACJ,OAAO,MAAM,CAAC;YAClB,CAAC;YAED,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAE3C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE;gBACzC,MAAM;gBACN,OAAO,EAAE,KAAK;aACf,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA5HD,kCA4HC"}

package/actions/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/actions/base/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/actions/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/base/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,mDAAiC;AACjC,mDAAiC"}

package/actions/base/migration-shim.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Migration shim for transitioning actions to the three-phase pattern
+ *
+ * This provides utilities to help migrate existing actions from the
+ * two-phase pattern (validate + execute) to the three-phase pattern
+ * (validate + execute + report).
+ */
+import { ISemanticEvent } from "../../../core/index";
+import { Action, ActionContext, ValidationResult } from '../enhanced-types';
+/**
+ * Base class for migrating actions to three-phase pattern
+ *
+ * Subclasses can override executeWithMutation() and generateReport()
+ * to implement the new pattern while maintaining compatibility.
+ */
+export declare abstract class ThreePhaseAction implements Action {
+    abstract id: string;
+    requiredMessages?: string[];
+    descriptionMessageId?: string;
+    examplesMessageId?: string;
+    group?: string;
+    priority?: number;
+    /**
+     * Validate phase - check if action can proceed
+     */
+    abstract validate(context: ActionContext): ValidationResult;
+    /**
+     * Execute phase - handles both old and new patterns
+     *
+     * This method checks if the subclass has implemented the new pattern.
+     * If so, it calls executeWithMutation() and returns void.
+     * Otherwise, it falls back to the old pattern.
+     */
+    execute(context: ActionContext): ISemanticEvent[] | void;
+    /**
+     * Report phase - generate events after mutations
+     *
+     * This is automatically used when executeWithMutation is implemented.
+     */
+    report(context: ActionContext): ISemanticEvent[];
+    /**
+     * New pattern: perform mutations only (optional override)
+     *
+     * Subclasses implementing the three-phase pattern should override this.
+     */
+    protected executeWithMutation?(context: ActionContext): void;
+    /**
+     * New pattern: generate events with captured state (optional override)
+     *
+     * Subclasses implementing the three-phase pattern should override this.
+     */
+    protected generateReport?(context: ActionContext): ISemanticEvent[];
+}
+/**
+ * Helper to create a three-phase action from functions
+ *
+ * This is useful for quickly converting existing actions without
+ * creating a full class.
+ */
+export declare function createThreePhaseAction(config: {
+    id: string;
+    validate: (context: ActionContext) => ValidationResult;
+    execute: (context: ActionContext) => void;
+    report: (context: ActionContext) => ISemanticEvent[];
+    requiredMessages?: string[];
+    descriptionMessageId?: string;
+    examplesMessageId?: string;
+    group?: string;
+    priority?: number;
+}): Action;
+/**
+ * Adapter to wrap old-style actions in the new interface
+ *
+ * This allows old actions to work with the new CommandExecutor
+ * without modification.
+ */
+export declare function adaptOldAction(oldAction: {
+    id: string;
+    validate: (context: ActionContext) => ValidationResult;
+    execute: (context: ActionContext) => ISemanticEvent[];
+    requiredMessages?: string[];
+    descriptionMessageId?: string;
+    examplesMessageId?: string;
+    group?: string;
+    priority?: number;
+}): Action;
+/**
+ * Helper to split an old execute method into execute + report
+ *
+ * This helps when migrating actions that mix mutations and event generation.
+ *
+ * @param executeOld The old execute method that does both
+ * @returns Object with separate execute and report methods
+ */
+export declare function splitExecuteMethod(executeOld: (context: ActionContext) => ISemanticEvent[]): {
+    execute: (context: ActionContext) => void;
+    report: (context: ActionContext) => ISemanticEvent[];
+};
+/**
+ * Create a migration wrapper that logs when old patterns are used
+ *
+ * This helps identify which actions still need migration.
+ */
+export declare function createMigrationLogger(action: Action, logger?: (message: string) => void): Action;
+//# sourceMappingURL=migration-shim.d.ts.map

package/actions/base/migration-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-shim.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/actions/base/migration-shim.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E;;;;;GAKG;AACH,8BAAsB,gBAAiB,YAAW,MAAM;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB;IAE3D;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,EAAE,GAAG,IAAI;IAexD;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,EAAE;IAShD;;;;OAIG;IACH,SAAS,CAAC,mBAAmB,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAE5D;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,EAAE;CACpE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,gBAAgB,CAAC;IACvD,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,EAAE,CAAC;IACrD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAkBT;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,gBAAgB,CAAC;IACvD,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,EAAE,CAAC;IACtD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAOT;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,EAAE,GACvD;IACD,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,EAAE,CAAC;CACtD,CAqBA;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAmB,GAC/C,MAAM,CAsBR"}

package/actions/base/migration-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-shim.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/base/migration-shim.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAiFH,wDA4BC;AAQD,wCAgBC;AAUD,gDA0BC;AAOD,sDAyBC;AApMD;;;;;GAKG;AACH,MAAsB,gBAAgB;IAEpC,gBAAgB,CAAY;IAC5B,oBAAoB,CAAU;IAC9B,iBAAiB,CAAU;IAC3B,KAAK,CAAU;IACf,QAAQ,CAAU;IAOlB;;;;;;OAMG;IACH,OAAO,CAAC,OAAsB;QAC5B,+CAA+C;QAC/C,IAAI,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACpD,iDAAiD;YACjD,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAClC,OAAO;QACT,CAAC;QAED,8CAA8C;QAC9C,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,CAAC,EAAE,4DAA4D;YAC7E,wCAAwC,CACzC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAsB;QAC3B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,+DAA+D;QAC/D,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,EAAE,kCAAkC,CAAC,CAAC;IACvE,CAAC;CAeF;AA9DD,4CA8DC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CAAC,MAUtC;IACC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;QACjD,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QAEzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QAEzB,OAAO,EAAE,CAAC,OAAsB,EAAE,EAAE;YAClC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,CAAC,8BAA8B;QACxC,CAAC;QAED,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,SAS9B;IACC,OAAO;QACL,GAAG,SAAS;QACZ,+CAA+C;QAC/C,OAAO,EAAE,CAAC,OAAsB,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;QAC/D,0CAA0C;KAC3C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAChC,UAAwD;IAKxD,wCAAwC;IACxC,IAAI,cAAc,GAA4B,IAAI,CAAC;IAEnD,OAAO;QACL,OAAO,EAAE,CAAC,OAAsB,EAAE,EAAE;YAClC,4CAA4C;YAC5C,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YACrC,+BAA+B;QACjC,CAAC;QAED,MAAM,EAAE,CAAC,OAAsB,EAAE,EAAE;YACjC,6BAA6B;YAC7B,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,MAAM,GAAG,cAAc,CAAC;YAC9B,cAAc,GAAG,IAAI,CAAC,CAAC,2BAA2B;YAClD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,MAAc,EACd,SAAoC,OAAO,CAAC,IAAI;IAEhD,MAAM,OAAO,GAAW;QACtB,GAAG,MAAM;QAET,OAAO,EAAE,CAAC,OAAsB,EAAE,EAAE;YAClC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAEvC,mCAAmC;YACnC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAC5C,MAAM,CAAC,UAAU,MAAM,CAAC,EAAE,gDAAgD,CAAC,CAAC;YAC9E,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;IAEF,oCAAoC;IACpC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACjC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,89 @@
+/**
+ * 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 "../../../core/index";
+/**
+ * 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, messageId: 'taken' })
+ *   ];
+ * }
+ */
+export declare function handleReportErrors(context: ActionContext, validationResult?: ValidationResult, executionError?: Error, options?: ErrorEventOptions): ISemanticEvent[] | null;
+//# sourceMappingURL=report-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;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/actions/base/report-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-helpers.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/base/report-helpers.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA0CH,sDAqCC;AAoBD,oDAgBC;AA2BD,gDAgBC;AA1JD,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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;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/actions/base/snapshot-utils.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 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 "../../../world-model/index";
+/**
+ * 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>;
+    /** Direction constant → display name from the active vocabulary (ADR-143) */
+    exitDisplayNames?: 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/actions/base/snapshot-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-utils.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/actions/base/snapshot-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,QAAQ,EAAE,UAAU,EAGrB,MAAM,sBAAsB,CAAC;AAE9B;;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,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,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,CAiGhB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,UAAU,EACjB,eAAe,UAAO,GACrB,YAAY,CAkEd;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/actions/base/snapshot-utils.js

@@ -0,0 +1,200 @@
+"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;
+const world_model_1 = require("../../../world-model/index.js");
+/**
+ * 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.getTrait(world_model_1.IdentityTrait);
+    const openable = entity.getTrait(world_model_1.OpenableTrait);
+    const lockable = entity.getTrait(world_model_1.LockableTrait);
+    const container = entity.getTrait(world_model_1.ContainerTrait);
+    const supporter = entity.getTrait(world_model_1.SupporterTrait);
+    const wearable = entity.getTrait(world_model_1.WearableTrait);
+    const edible = entity.getTrait(world_model_1.EdibleTrait);
+    const pushable = entity.getTrait(world_model_1.PushableTrait);
+    const scenery = entity.getTrait(world_model_1.SceneryTrait);
+    const snapshot = {
+        id: entity.id,
+        name: identity?.name || entity.id,
+        description: identity?.description,
+        shortDescription: identity?.brief,
+        // Include message IDs if present (ADR-107 dual-mode)
+        nameId: identity?.nameId,
+        descriptionId: identity?.descriptionId,
+        location: world.getLocation(entity.id)
+    };
+    // Portability: entities are portable unless they have SceneryTrait
+    if (!scenery) {
+        snapshot.isPortable = true;
+    }
+    // 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.getTrait(world_model_1.IdentityTrait);
+    const roomTrait = room.getTrait(world_model_1.RoomTrait);
+    const snapshot = {
+        id: room.id,
+        name: identity?.name || String(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 from room trait
+    if (roomTrait?.isDark !== undefined) {
+        snapshot.isDark = roomTrait.isDark === true;
+    }
+    // Add visited state
+    if (roomTrait?.visited !== undefined) {
+        snapshot.isVisited = roomTrait.visited === true;
+    }
+    // Capture exits from room trait
+    const exits = {};
+    const exitDisplayNames = {};
+    if (roomTrait?.exits) {
+        const vocab = world.directions();
+        for (const [dir, exitInfo] of Object.entries(roomTrait.exits)) {
+            if (exitInfo?.destination) {
+                exits[dir] = exitInfo.destination;
+                exitDisplayNames[dir] = vocab.getDisplayName(dir);
+            }
+        }
+    }
+    if (Object.keys(exits).length > 0) {
+        snapshot.exits = exits;
+        snapshot.exitDisplayNames = exitDisplayNames;
+    }
+    // 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 standardRoomTraits = ['identity', 'room', 'darkness'];
+    const customTraits = {};
+    for (const [key, value] of Object.entries(room)) {
+        if (!standardRoomTraits.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.getTrait(world_model_1.IdentityTrait);
+    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/actions/base/snapshot-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-utils.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/base/snapshot-utils.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability-dispatch.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/stdlib/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;AAoCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,wBAAwB,GAC/B,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAAE,CA6IvC"}