AID Story Helper

**AID Story Helper (MemorAID) — Chrome Webstore Extension Description** This extension is a companion tool for **AI Dungeon (AID)** designed to introduce deep NPC psychological state-tracking, dynamic memory management, a reusable Favorites library, and structured multi-pass character creation. By integrating directly into the AI Dungeon play interface, the extension acts as a real-time cognitive pipeline that intercepts player turns, runs background reflection passes, and updates Story Cards on the fly. Below is a detailed breakdown of how the extension operates, its core features, and configuration setup for beta testers, updated with the new enhancements in version 1.1.2. *** **1. The Story Helper Dashboard & Library Manager** The extension renders a premium, integrated companion pane directly within the AI Dungeon play view. It keeps track of your current turn counts, scenario settings, and active characters. It provides four primary tabs to help you track, update, and manage your adventure: - **Progression Tracker Tab:** The control center for reviewing and updating your Story Cards. - **AID Memories Tab:** A direct, real-time interface to view and edit AI Dungeon's native memory list. - **Library Manager Tab (Favorites & Local DB Explorer):** Manage your reusable asset library and browse cached adventure states. - **Settings & Prompts Tab:** Customize AI providers, API keys, and prompt templates. *** **2. Adventures Manager: Favorites & Local DB Explorer (Enhanced in v1.1.2)** The Library Manager lets you reuse assets across different scenarios and browse cached history locally. - **Collapsible Favorites Accordions:** Save and organize favorite AI Instructions, Author's Notes, Plot Essentials character bios, and Story Cards. Version 1.1.2 adds collapsible category accordions for each asset type that synchronize their open/close states across renders. - **Swappable Favorites Edit Form:** In the Edit Favorite form, changing the Asset Type dropdown dynamically switches between simple text fields and full Story Card layouts while preserving your current text input. - **AI Instructions Auto-Capture:** Intercepts and caches native `UpdateAdventureState` instructions from GQL responses, automatically keeping them synchronized in your local database. - **Local DB Explorer Hierarchy:** Browse all saved adventures cached in IndexedDB. Version 1.1.2 introduces a clean, logical hierarchy: 1. AI Instructions (if present) 2. Plot Essentials (with character rows and a collapsible **📄 See Full Plot Essentials** drawer at the bottom to view the remainder string) 3. Author's Note 4. Story Cards (organized by card type) - **Indented Child Accordion Styling:** Subgroups and categories are styled as indented child accordions with left-border accents and chevrons, making navigation intuitive even on massive adventures. *** **3. Progression Tracker & Story Card Syncing** The Story Helper continuously monitors recent actions in your adventure. It uses your gameplay history to propose relevant updates for active Story Cards (including Character, Faction, Location, and Custom cards). **GraphQL Mutation Learning (Replay System)** To update your Story Cards on the AI Dungeon servers without requiring manual entry copy-pasting, the extension features a smart GraphQL interceptor: - **Operation Caching:** When you perform a native edit and save on a Story Card or Memory in the AI Dungeon user interface, the extension intercepts and caches the exact query schema (e.g., `UseAutoSaveStoryCard` or `SaveQueueStoryCard`). - **One-Click Sync (Push to AID):** Once a mutation is learned, the extension can programmatically recreate these actions. When the Story Helper proposes a card update, you can review the change and click **Accept**. - **Push Update:** Clicking **Accept** and **Push** replays the mutation directly to the AI Dungeon GraphQL endpoint using your active session token. The game card updates immediately. - **Direct Generation & Bulk Update:** You can manually trigger a generation for any single character card from your tracker list, or click the **Update Cards** button to refresh active cards in a background sequence. - **Smart Card Syncing (v1.1.2):** Upgraded baseline seeding prevents duplicate character baselines when matching cards exist without cached IDs. Renames and type changes sync cleanly to version history. *** **4. AID Memories Manager (Direct Memory Editing)** The **AID Memories** tab gives you a direct management suite for AI Dungeon's native, AI-generated Memory Bank list. > [!TIP] > **Direct Access to Hidden Data:** Natively, AI Dungeon hides these stored memories deep inside nested menus (requiring you to navigate through *Action Options → View Context → Details → Adventure & Memories → Explore Memories* just to view them). This extension brings them directly to the main screen, providing the only convenient and immediate way to view and manage them. - **Real-Time WebSocket Sync:** The extension listens to incoming `AdventureMemoriesUpdate` WebSocket packets. When AI Dungeon's active Memories list updates in the background, the list in the companion panel updates instantly. - **Direct Inline Editing:** In the AID Memories list, simply click the **Edit** button next to any memory item to open an inline text editor, modify the text, and click **Save** to send an `EditMemory` GraphQL mutation. State is updated immediately. - **Memory Deletion:** Click the **Delete** button next to any memory item to prune outdated info from your list. *** **5. MemorAID: Real-Time NPC Memory & Cognitive Loop** In default AI Dungeon play, NPCs lack active, turn-by-turn internal tracking. MemorAID solves this by running a **synchronous cognitive loop** that generates and archives NPC thoughts, opinions, and intentions in real time. **How It Works: Synchronous Action Interception** To ensure NPC thoughts are fed into the next story generation *without a one-turn delay*, MemorAID intercepts…