@sharpee/stdlib 0.9.66-beta → 0.9.69-beta

package/actions/meta-registry.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Meta-Command Registry
+ *
+ * Centralized registry for tracking which commands are meta-commands.
+ * Meta-commands don't increment turns, trigger NPCs, or get recorded in history.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaCommandRegistry = void 0;
+/**
+ * Registry for meta-commands
+ *
+ * Maintains a list of action IDs that should be treated as meta-commands.
+ * This includes both standard system commands (SAVE, RESTORE, etc.) and
+ * custom meta-commands (debug commands, author commands, etc.).
+ */
+class MetaCommandRegistry {
+    /**
+     * Set of registered meta-command IDs
+     * Pre-populated with standard IF meta-commands
+     */
+    static metaCommands = new Set([
+        // System commands (using IF action IDs)
+        'if.action.saving', // SAVE
+        'if.action.restoring', // RESTORE / LOAD
+        'if.action.quitting', // QUIT / Q
+        'if.action.restarting', // RESTART
+        // Information commands
+        'if.action.scoring', // SCORE / STATUS
+        'if.action.version', // VERSION
+        'if.action.about', // ABOUT
+        'if.action.help', // HELP
+        // Transcript commands
+        'transcript', // TRANSCRIPT ON/OFF
+        'transcript_on', // TRANSCRIPT ON
+        'transcript_off', // TRANSCRIPT OFF
+        // Undo system
+        'if.action.again', // AGAIN (repeat last command)
+        'if.action.undoing', // UNDO (action ID)
+        'undo', // UNDO (grammar pattern)
+        // Preference commands
+        'verbose', // VERBOSE mode
+        'brief', // BRIEF mode
+        'superbrief', // SUPERBRIEF mode
+        'notify', // NOTIFY ON/OFF
+        // Debug/Author commands (will be auto-registered by MetaAction)
+        // Listed here for documentation
+        // 'author.trace',
+    ]);
+    /**
+     * Register an action ID as a meta-command
+     *
+     * @param actionId The action ID to register
+     * @example
+     * ```typescript
+     * MetaCommandRegistry.register('my_debug_command');
+     * ```
+     */
+    static register(actionId) {
+        if (!actionId) {
+            console.warn('MetaCommandRegistry: Attempted to register empty action ID');
+            return;
+        }
+        this.metaCommands.add(actionId);
+    }
+    /**
+     * Unregister an action ID from meta-commands
+     * Useful for testing or dynamic configuration
+     *
+     * @param actionId The action ID to unregister
+     * @returns true if the command was registered and is now removed
+     */
+    static unregister(actionId) {
+        return this.metaCommands.delete(actionId);
+    }
+    /**
+     * Check if an action ID is registered as a meta-command
+     *
+     * @param actionId The action ID to check
+     * @returns true if this is a meta-command
+     * @example
+     * ```typescript
+     * if (!MetaCommandRegistry.isMeta(result.actionId)) {
+     *   // Increment turn counter
+     *   this.updateContext(result);
+     * }
+     * ```
+     */
+    static isMeta(actionId) {
+        if (!actionId)
+            return false;
+        return this.metaCommands.has(actionId);
+    }
+    /**
+     * Get all registered meta-command IDs
+     * Useful for debugging and documentation
+     *
+     * @returns Array of all registered meta-command IDs
+     */
+    static getAll() {
+        return Array.from(this.metaCommands).sort();
+    }
+    /**
+     * Clear all registered meta-commands
+     * Useful for testing - resets to default state
+     */
+    static clear() {
+        this.metaCommands.clear();
+        // Re-add standard commands
+        this.reset();
+    }
+    /**
+     * Reset to default meta-commands
+     * Removes any custom registrations and restores defaults
+     */
+    static reset() {
+        this.metaCommands = new Set([
+            'if.action.saving',
+            'if.action.restoring',
+            'if.action.quitting',
+            'if.action.restarting',
+            'if.action.undoing',
+            'if.action.scoring',
+            'if.action.version',
+            'if.action.about',
+            'if.action.help',
+            'if.action.again',
+            'transcript',
+            'transcript_on',
+            'transcript_off',
+            'undo',
+            'verbose',
+            'brief',
+            'superbrief',
+            'notify'
+        ]);
+    }
+    /**
+     * Get the count of registered meta-commands
+     *
+     * @returns Number of registered meta-commands
+     */
+    static count() {
+        return this.metaCommands.size;
+    }
+    /**
+     * Check if registry has any custom (non-default) meta-commands
+     *
+     * @returns true if any non-default commands are registered
+     */
+    static hasCustomCommands() {
+        const defaults = new Set([
+            'if.action.saving', 'if.action.restoring', 'if.action.quitting', 'if.action.restarting',
+            'if.action.undoing', 'if.action.scoring', 'if.action.version', 'if.action.about', 'if.action.help',
+            'if.action.again', 'transcript', 'transcript_on', 'transcript_off',
+            'undo', 'verbose', 'brief', 'superbrief', 'notify'
+        ]);
+        for (const cmd of this.metaCommands) {
+            if (!defaults.has(cmd)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Common verb strings for non-undoable commands.
+     *
+     * Used for early detection before parsing (when action ID is not yet available).
+     * Includes both meta-commands and info commands that don't change game state.
+     *
+     * @internal Used by game engine for undo snapshot decisions
+     */
+    static nonUndoableVerbs = new Set([
+        // Meta-commands (match MetaCommandRegistry)
+        'undo', 'save', 'restore', 'restart', 'quit',
+        'score', 'version', 'about', 'help',
+        'verbose', 'brief', 'superbrief', 'notify',
+        'again', 'g',
+        // Info commands (don't change game state)
+        'look', 'l',
+        'examine', 'x',
+        'inventory', 'i'
+    ]);
+    /**
+     * Check if a raw input string is a non-undoable command.
+     *
+     * Used for early detection before parsing when we don't have an action ID yet.
+     * This covers:
+     * - Meta-commands (save, restore, quit, restart, undo, etc.)
+     * - Info commands (look, examine, inventory)
+     *
+     * @param input Raw command input string
+     * @returns true if this command should not create an undo snapshot
+     *
+     * @example
+     * ```typescript
+     * if (!MetaCommandRegistry.isNonUndoable(input)) {
+     *   createUndoSnapshot();
+     * }
+     * ```
+     */
+    static isNonUndoable(input) {
+        const normalized = input.trim().toLowerCase();
+        const firstWord = normalized.split(/\s+/)[0];
+        return this.nonUndoableVerbs.has(firstWord);
+    }
+}
+exports.MetaCommandRegistry = MetaCommandRegistry;
+//# sourceMappingURL=meta-registry.js.map

package/actions/meta-registry.js.map

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

package/actions/registry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Action registry implementation
+ *
+ * Manages registration and lookup of actions.
+ * Actions are pure logic - patterns come from the language provider.
+ */
+import { Action, ActionRegistry as IActionRegistry } from './enhanced-types';
+import { LanguageProvider } from "../src/index";
+export { ActionRegistry } from './enhanced-types';
+export declare class StandardActionRegistry implements IActionRegistry {
+    private actions;
+    private actionsByPattern;
+    private actionsByGroup;
+    private languageProvider;
+    /**
+     * Set the language provider for pattern resolution
+     * @param provider Language provider instance (required for pattern resolution)
+     */
+    setLanguageProvider(provider: LanguageProvider): void;
+    /**
+     * Register an action
+     */
+    register(action: Action): void;
+    /**
+     * Register multiple actions
+     */
+    registerMany(actions: Action[]): void;
+    /**
+     * Get an action by ID
+     */
+    get(actionId: string): Action | undefined;
+    /**
+     * Get all registered actions
+     */
+    getAll(): Action[];
+    /**
+     * Check if an action is registered
+     */
+    has(actionId: string): boolean;
+    /**
+     * Find actions by pattern
+     */
+    findByPattern(pattern: string): Action[];
+    /**
+     * Get actions by group
+     */
+    getByGroup(group: string): Action[];
+    /**
+     * Find an action by ID or pattern (backward compatibility)
+     * @param idOrPattern Action ID or pattern to search for
+     * @returns First matching action or undefined
+     */
+    find(idOrPattern: string): Action | undefined;
+    /**
+     * Register messages for an action (placeholder for future implementation)
+     */
+    registerMessages(actionId: string, messages: Record<string, string>): void;
+    /**
+     * Update pattern mappings for a single action
+     */
+    private updatePatternMappingsForAction;
+    /**
+     * Rebuild all pattern mappings from language provider
+     */
+    private rebuildPatternMappings;
+}
+//# sourceMappingURL=registry.d.ts.map

package/actions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IAEzD;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAMrD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA0B9B;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAMrC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;IAIlB;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAIxC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAInC;;;;OAIG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAU7C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK1E;;OAEG;IACH,OAAO,CAAC,8BAA8B;IAqBtC;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAO/B"}

package/actions/registry.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Action registry implementation
+ *
+ * Manages registration and lookup of actions.
+ * Actions are pure logic - patterns come from the language provider.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandardActionRegistry = void 0;
+class StandardActionRegistry {
+    actions = new Map();
+    actionsByPattern = new Map(); // pattern -> actions
+    actionsByGroup = new Map(); // group -> actions
+    languageProvider = null;
+    /**
+     * Set the language provider for pattern resolution
+     * @param provider Language provider instance (required for pattern resolution)
+     */
+    setLanguageProvider(provider) {
+        this.languageProvider = provider;
+        // Rebuild pattern mappings when language provider changes
+        this.rebuildPatternMappings();
+    }
+    /**
+     * Register an action
+     */
+    register(action) {
+        this.actions.set(action.id, action);
+        // Add to group mapping if specified
+        if (action.group) {
+            const groupActions = this.actionsByGroup.get(action.group) || [];
+            groupActions.push(action);
+            this.actionsByGroup.set(action.group, groupActions);
+        }
+        // Handle direct aliases (backward compatibility)
+        if ('aliases' in action && Array.isArray(action.aliases)) {
+            const aliases = action.aliases;
+            for (const alias of aliases) {
+                const normalizedAlias = alias.toLowerCase();
+                // For direct aliases, only keep the latest action (override previous)
+                this.actionsByPattern.set(normalizedAlias, [action]);
+            }
+        }
+        // Update pattern mappings if we have a language provider
+        if (this.languageProvider) {
+            this.updatePatternMappingsForAction(action);
+        }
+    }
+    /**
+     * Register multiple actions
+     */
+    registerMany(actions) {
+        for (const action of actions) {
+            this.register(action);
+        }
+    }
+    /**
+     * Get an action by ID
+     */
+    get(actionId) {
+        return this.actions.get(actionId);
+    }
+    /**
+     * Get all registered actions
+     */
+    getAll() {
+        return Array.from(this.actions.values());
+    }
+    /**
+     * Check if an action is registered
+     */
+    has(actionId) {
+        return this.actions.has(actionId);
+    }
+    /**
+     * Find actions by pattern
+     */
+    findByPattern(pattern) {
+        return this.actionsByPattern.get(pattern.toLowerCase()) || [];
+    }
+    /**
+     * Get actions by group
+     */
+    getByGroup(group) {
+        return this.actionsByGroup.get(group) || [];
+    }
+    /**
+     * Find an action by ID or pattern (backward compatibility)
+     * @param idOrPattern Action ID or pattern to search for
+     * @returns First matching action or undefined
+     */
+    find(idOrPattern) {
+        // First try direct ID lookup
+        const directLookup = this.get(idOrPattern);
+        if (directLookup)
+            return directLookup;
+        // Then try pattern lookup
+        const patternMatches = this.findByPattern(idOrPattern);
+        return patternMatches[0]; // Return first match
+    }
+    /**
+     * Register messages for an action (placeholder for future implementation)
+     */
+    registerMessages(actionId, messages) {
+        // This would be implemented when we have a message registry
+        // For now, messages are handled by the language provider
+    }
+    /**
+     * Update pattern mappings for a single action
+     */
+    updatePatternMappingsForAction(action) {
+        if (!this.languageProvider) {
+            // Language provider not yet set - patterns will be mapped when it's provided
+            return;
+        }
+        const patterns = this.languageProvider.getActionPatterns(action.id);
+        if (patterns) {
+            for (const pattern of patterns) {
+                const normalizedPattern = pattern.toLowerCase();
+                const actions = this.actionsByPattern.get(normalizedPattern) || [];
+                if (!actions.includes(action)) {
+                    actions.push(action);
+                    // Sort by priority (higher priority first)
+                    actions.sort((a, b) => (b.priority || 0) - (a.priority || 0));
+                    this.actionsByPattern.set(normalizedPattern, actions);
+                }
+            }
+        }
+    }
+    /**
+     * Rebuild all pattern mappings from language provider
+     */
+    rebuildPatternMappings() {
+        this.actionsByPattern.clear();
+        for (const action of this.actions.values()) {
+            this.updatePatternMappingsForAction(action);
+        }
+    }
+}
+exports.StandardActionRegistry = StandardActionRegistry;
+//# sourceMappingURL=registry.js.map

package/actions/registry.js.map

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

package/actions/standard/about/about-events.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Event type definitions for the about action
+ */
+/**
+ * Event data for when about information is displayed
+ * Uses domain event pattern with embedded messageId (ADR-097)
+ */
+export interface AboutDisplayedEventData {
+    /** Message ID for text-service lookup */
+    messageId: string;
+    /** Parameters for message template substitution */
+    params: {
+        title?: string;
+        author?: string;
+        version?: string;
+        description?: string;
+        engineVersion?: string;
+        buildDate?: string;
+        clientVersion?: string;
+        portedBy?: string;
+    };
+    /** Whether this is a blocked/error case */
+    blocked?: boolean;
+    /** Reason for block (if blocked) */
+    reason?: string;
+}
+/**
+ * Complete event map for about action
+ */
+export interface AboutEventMap {
+    'if.event.about_displayed': AboutDisplayedEventData;
+}
+//# sourceMappingURL=about-events.d.ts.map

package/actions/standard/about/about-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"about-events.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/about/about-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B,EAAE,uBAAuB,CAAC;CACrD"}

package/actions/standard/about/about-events.js

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

package/actions/standard/about/about-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"about-events.js","sourceRoot":"","sources":["../../../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/about/about-events.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/actions/standard/about/about.d.ts

@@ -0,0 +1,19 @@
+/**
+ * About action - displays information about the game
+ *
+ * This is a meta action that signals the text service to display
+ * game information. The text service will query the story config
+ * directly for the information it needs.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions)
+ * 2. execute: No world mutations
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit about event
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const aboutAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=about.d.ts.map

package/actions/standard/about/about.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"about.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/about/about.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,eAAO,MAAM,WAAW,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAyD5D,CAAC"}

package/actions/standard/about/about.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * About action - displays information about the game
+ *
+ * This is a meta action that signals the text service to display
+ * game information. The text service will query the story config
+ * directly for the information it needs.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions)
+ * 2. execute: No world mutations
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit about event
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aboutAction = void 0;
+const constants_1 = require("../../constants");
+exports.aboutAction = {
+    id: constants_1.IFActions.ABOUT,
+    validate(context) {
+        // About action always succeeds
+        return {
+            valid: true
+        };
+    },
+    execute(context) {
+        // No state mutations needed for this meta action
+        // The text service will construct output from story config
+    },
+    blocked(context, result) {
+        // About always succeeds, but include blocked for consistency
+        return [context.event('if.event.about_displayed', {
+                messageId: `if.action.about.${result.error}`,
+                params: result.params || {},
+                blocked: true,
+                reason: result.error
+            })];
+    },
+    report(context) {
+        // Get story info from StoryInfoTrait (or fall back to legacy (world as any))
+        const world = context.world;
+        const storyInfoEntities = world.findByTrait('storyInfo');
+        const trait = storyInfoEntities[0]?.get('storyInfo');
+        const storyConfig = trait || world.storyConfig || {};
+        const eventData = {
+            messageId: 'if.action.about.success',
+            params: {
+                title: storyConfig.title || 'Unknown',
+                author: Array.isArray(storyConfig.author) ? storyConfig.author.join(', ') : (storyConfig.author || 'Unknown'),
+                version: storyConfig.version || '0.0.0',
+                description: storyConfig.description || '',
+                engineVersion: storyConfig.engineVersion || '',
+                buildDate: storyConfig.buildDate || '',
+                clientVersion: storyConfig.clientVersion || '',
+                portedBy: storyConfig.portedBy || ''
+            }
+        };
+        return [
+            context.event('if.event.about_displayed', eventData)
+        ];
+    },
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=about.js.map

package/actions/standard/about/about.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"about.js","sourceRoot":"","sources":["../../../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/about/about.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAIH,+CAA4C;AAI/B,QAAA,WAAW,GAA0C;IAChE,EAAE,EAAE,qBAAS,CAAC,KAAK;IAEnB,QAAQ,CAAC,OAAsB;QAC7B,+BAA+B;QAC/B,OAAO;YACL,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,iDAAiD;QACjD,2DAA2D;IAC7D,CAAC;IAED,OAAO,CAAC,OAAsB,EAAE,MAAwB;QACtD,6DAA6D;QAC7D,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE;gBAChD,SAAS,EAAE,mBAAmB,MAAM,CAAC,KAAK,EAAE;gBAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;gBAC3B,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,MAAM,CAAC,KAAK;aACrB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,CAAC,OAAsB;QAC3B,6EAA6E;QAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,MAAM,iBAAiB,GAAG,KAAK,CAAC,WAAW,CAAC,WAAkB,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,CAAM,WAAW,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,KAAK,IAAK,KAAa,CAAC,WAAW,IAAI,EAAE,CAAC;QAE9D,MAAM,SAAS,GAA4B;YACzC,SAAS,EAAE,yBAAyB;YACpC,MAAM,EAAE;gBACN,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,SAAS;gBACrC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,IAAI,SAAS,CAAC;gBAC7G,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,OAAO;gBACvC,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,EAAE;gBAC1C,aAAa,EAAE,WAAW,CAAC,aAAa,IAAI,EAAE;gBAC9C,SAAS,EAAE,WAAW,CAAC,SAAS,IAAI,EAAE;gBACtC,aAAa,EAAE,WAAW,CAAC,aAAa,IAAI,EAAE;gBAC9C,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,EAAE;aACrC;SACF,CAAC;QAEF,OAAO;YACL,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,SAAS,CAAC;SACrD,CAAC;IACJ,CAAC;IAED,KAAK,EAAE,MAAM;IAEb,QAAQ,EAAE;QACR,oBAAoB,EAAE,KAAK;QAC3B,sBAAsB,EAAE,KAAK;KAC9B;CACF,CAAC"}

package/actions/standard/about/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * About action module exports
+ */
+export { aboutAction } from './about';
+export type { AboutDisplayedEventData, AboutEventMap } from './about-events';
+//# sourceMappingURL=index.d.ts.map

package/actions/standard/about/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/about/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/actions/standard/about/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * About action module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aboutAction = void 0;
+var about_1 = require("./about");
+Object.defineProperty(exports, "aboutAction", { enumerable: true, get: function () { return about_1.aboutAction; } });
+//# sourceMappingURL=index.js.map

package/actions/standard/about/index.js.map

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

package/actions/standard/again/again-events.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Event type definitions for the again action
+ */
+/**
+ * Event data for when validation fails (no command history)
+ */
+export interface AgainBlockedEventData {
+    blocked: true;
+    messageId: string;
+    reason: string;
+}
+/**
+ * Complete event map for again action
+ */
+export interface AgainEventMap {
+    'if.event.again_blocked': AgainBlockedEventData;
+}
+//# sourceMappingURL=again-events.d.ts.map

package/actions/standard/again/again-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"again-events.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/again/again-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB,EAAE,qBAAqB,CAAC;CACjD"}

package/actions/standard/again/again-events.js

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

package/actions/standard/again/again-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"again-events.js","sourceRoot":"","sources":["../../../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/again/again-events.ts"],"names":[],"mappings":";AAAA;;GAEG"}