@sharpee/stdlib 0.9.66-beta → 0.9.69-beta

package/actions/author/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Author commands for debugging and development
+ */
+export { TraceAction } from './trace';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../mnt/c/repotemp/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

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Author commands for debugging and development
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceAction = void 0;
+var trace_1 = require("./trace");
+Object.defineProperty(exports, "TraceAction", { enumerable: true, get: function () { return trace_1.TraceAction; } });
+//# sourceMappingURL=index.js.map

package/actions/author/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../../mnt/c/repotemp/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 "../../src/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":["../../../../../../../mnt/c/repotemp/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

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceAction = void 0;
+const meta_action_1 = require("../meta-action");
+class TraceAction extends meta_action_1.MetaAction {
+    id = 'author.trace';
+    verbs = ['trace'];
+    constructor() {
+        super();
+        this.ensureRegistered();
+    }
+    validate(context) {
+        const { command } = context;
+        const tokens = command.parsed?.tokens || [];
+        // Must have at least "trace"
+        if (tokens.length === 0)
+            return { valid: false, error: 'no_tokens' };
+        // Check first token is "trace"
+        const verb = tokens[0]?.normalized?.toLowerCase();
+        if (verb !== 'trace')
+            return { valid: false, error: 'not_trace' };
+        // Valid patterns:
+        // "trace" - length 1
+        // "trace on/off" - length 2
+        // "trace [target] on/off" - length 3
+        if (tokens.length === 1) {
+            return { valid: true }; // Just "trace"
+        }
+        if (tokens.length === 2) {
+            const second = tokens[1]?.normalized?.toLowerCase();
+            return (second === 'on' || second === 'off') ? { valid: true } : { valid: false, error: 'invalid_state' };
+        }
+        if (tokens.length === 3) {
+            const target = tokens[1]?.normalized?.toLowerCase();
+            const state = tokens[2]?.normalized?.toLowerCase();
+            const validTargets = ['parser', 'validation', 'system', 'all'];
+            const validStates = ['on', 'off'];
+            return (validTargets.includes(target) && validStates.includes(state)) ?
+                { valid: true } : { valid: false, error: 'invalid_target_or_state' };
+        }
+        return { valid: false, error: 'invalid_pattern' };
+    }
+    execute(context) {
+        const { command, world } = context;
+        const tokens = command.parsed?.tokens || [];
+        const events = [];
+        // Get or create debug capability data
+        let debugData = world.getCapability('debug') || {
+            debugParserEvents: false,
+            debugValidationEvents: false,
+            debugSystemEvents: false
+        };
+        if (tokens.length === 1) {
+            // Just "trace" - show status
+            events.push(context.event('trace.status', {
+                parser: debugData.debugParserEvents || false,
+                validation: debugData.debugValidationEvents || false,
+                system: debugData.debugSystemEvents || false
+            }));
+            return events;
+        }
+        if (tokens.length === 2) {
+            // "trace on/off" - affect all
+            const state = tokens[1]?.normalized?.toLowerCase() === 'on';
+            debugData.debugParserEvents = state;
+            debugData.debugValidationEvents = state;
+            debugData.debugSystemEvents = state;
+            world.updateCapability('debug', debugData);
+            events.push(context.event('trace.changed', {
+                target: 'all',
+                enabled: state
+            }));
+            return events;
+        }
+        if (tokens.length === 3) {
+            // "trace [target] on/off"
+            const target = tokens[1]?.normalized?.toLowerCase();
+            const state = tokens[2]?.normalized?.toLowerCase() === 'on';
+            switch (target) {
+                case 'parser':
+                    debugData.debugParserEvents = state;
+                    break;
+                case 'validation':
+                    debugData.debugValidationEvents = state;
+                    break;
+                case 'system':
+                    debugData.debugSystemEvents = state;
+                    break;
+                case 'all':
+                    debugData.debugParserEvents = state;
+                    debugData.debugValidationEvents = state;
+                    debugData.debugSystemEvents = state;
+                    break;
+                default:
+                    // Shouldn't happen due to validation, but be safe
+                    events.push(context.event('action.error', {
+                        reason: `Unknown trace target: ${target}`
+                    }));
+                    return events;
+            }
+            world.updateCapability('debug', debugData);
+            events.push(context.event('trace.changed', {
+                target,
+                enabled: state
+            }));
+        }
+        return events;
+    }
+}
+exports.TraceAction = TraceAction;
+//# sourceMappingURL=trace.js.map

package/actions/author/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/author/trace.ts"],"names":[],"mappings":"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"}

package/actions/base/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Base utilities for actions
+ *
+ * Provides snapshot utilities and migration helpers for the
+ * three-phase action pattern (validate, execute, report).
+ */
+export * from './snapshot-utils';
+export * from './migration-shim';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../mnt/c/repotemp/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

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Base utilities for actions
+ *
+ * Provides snapshot utilities and migration helpers for the
+ * three-phase action pattern (validate, execute, report).
+ */
+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 });
+__exportStar(require("./snapshot-utils"), exports);
+__exportStar(require("./migration-shim"), exports);
+//# sourceMappingURL=index.js.map

package/actions/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../../mnt/c/repotemp/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 "../../src/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":["../../../../../../../mnt/c/repotemp/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

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * 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).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThreePhaseAction = void 0;
+exports.createThreePhaseAction = createThreePhaseAction;
+exports.adaptOldAction = adaptOldAction;
+exports.splitExecuteMethod = splitExecuteMethod;
+exports.createMigrationLogger = createMigrationLogger;
+/**
+ * Base class for migrating actions to three-phase pattern
+ *
+ * Subclasses can override executeWithMutation() and generateReport()
+ * to implement the new pattern while maintaining compatibility.
+ */
+class ThreePhaseAction {
+    requiredMessages;
+    descriptionMessageId;
+    examplesMessageId;
+    group;
+    priority;
+    /**
+     * 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) {
+        // Check if subclass implements the new pattern
+        if (this.executeWithMutation && this.generateReport) {
+            // New pattern: perform mutations and return void
+            this.executeWithMutation(context);
+            return;
+        }
+        // Old pattern: must be overridden in subclass
+        throw new Error(`Action ${this.id} must implement either executeWithMutation/generateReport ` +
+            `or override execute() to return events`);
+    }
+    /**
+     * Report phase - generate events after mutations
+     *
+     * This is automatically used when executeWithMutation is implemented.
+     */
+    report(context) {
+        if (this.generateReport) {
+            return this.generateReport(context);
+        }
+        // Should never reach here if execute() is properly implemented
+        throw new Error(`Action ${this.id} must implement generateReport()`);
+    }
+}
+exports.ThreePhaseAction = ThreePhaseAction;
+/**
+ * Helper to create a three-phase action from functions
+ *
+ * This is useful for quickly converting existing actions without
+ * creating a full class.
+ */
+function createThreePhaseAction(config) {
+    return {
+        id: config.id,
+        requiredMessages: config.requiredMessages,
+        descriptionMessageId: config.descriptionMessageId,
+        examplesMessageId: config.examplesMessageId,
+        group: config.group,
+        priority: config.priority,
+        validate: config.validate,
+        execute: (context) => {
+            config.execute(context);
+            return; // Return void for new pattern
+        },
+        report: config.report
+    };
+}
+/**
+ * Adapter to wrap old-style actions in the new interface
+ *
+ * This allows old actions to work with the new CommandExecutor
+ * without modification.
+ */
+function adaptOldAction(oldAction) {
+    return {
+        ...oldAction,
+        // Old pattern: execute returns events directly
+        execute: (context) => oldAction.execute(context)
+        // No report method needed for old pattern
+    };
+}
+/**
+ * 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
+ */
+function splitExecuteMethod(executeOld) {
+    // Store events generated during execute
+    let capturedEvents = null;
+    return {
+        execute: (context) => {
+            // Run the old method but capture its events
+            capturedEvents = executeOld(context);
+            // Don't return anything (void)
+        },
+        report: (context) => {
+            // Return the captured events
+            if (!capturedEvents) {
+                throw new Error('Report called before execute');
+            }
+            const events = capturedEvents;
+            capturedEvents = null; // Reset for next execution
+            return events;
+        }
+    };
+}
+/**
+ * Create a migration wrapper that logs when old patterns are used
+ *
+ * This helps identify which actions still need migration.
+ */
+function createMigrationLogger(action, logger = console.warn) {
+    const wrapped = {
+        ...action,
+        execute: (context) => {
+            const result = action.execute(context);
+            // Check if this is the old pattern
+            if (result !== undefined && result !== null) {
+                logger(`Action ${action.id} is using old execute pattern (returns events)`);
+            }
+            return result;
+        }
+    };
+    // Add report if the original has it
+    if (action.report) {
+        wrapped.report = action.report;
+    }
+    return wrapped;
+}
+//# sourceMappingURL=migration-shim.js.map

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

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

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

@@ -0,0 +1,90 @@
+/**
+ * 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 "../../src/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 }),
+ *     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/actions/base/report-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-helpers.d.ts","sourceRoot":"","sources":["../../../../../../../mnt/c/repotemp/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;;;;;;;;;;;;;;;;;;;;;;;;;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"}