Glossary
Key terms and concepts used throughout the AnyaSelf platform.
| Term | Definition |
|---|
| Household | The top-level data boundary in AnyaSelf. All members, items, outfits, missions, and purchase requests belong to a household. Equivalent to a "family account." |
| Member | A person within a household. Each member has their own wardrobe items, outfits, and style preferences. |
| Aura | The name of the AnyaSelf AI voice assistant. Implemented as a floating bubble overlay in the frontend, connected to Gemini Live via WebSocket. |
| Term | Definition |
|---|
| Mission | A stateful agent conversation managed by the Orchestrator. Each mission has a type (STYLE, POLL, CARTPREP, INTERACTIVE), a lifecycle state, and a conversation history. |
| Mission Type | The behavioral mode of a mission: STYLE (styling advice), POLL (preference ranking), CARTPREP (cart automation), INTERACTIVE (browser session). |
| Plan Step | An individual step within a mission plan generated by the agent. Has states: PENDING → IN_PROGRESS → DONE / FAILED. |
| Tool | An internal HTTP API exposed to the LLM as a callable function. Examples: list_wardrobe, search_commerce, prepare_cart, create_hyperbeam_session. |
| Artifact | A structured output of a mission: MissionPlan, OutcomeSummary, BrowserRecording, Transcript, or AuditLog. |
| Reasoning Engine | The Vertex AI SDK component (LangchainAgent) that executes the LLM reasoning loop: receive input → choose tool → execute → synthesize response. |
| Term | Definition |
|---|
| Wardrobe Item | A clothing piece or accessory owned by a household member. Has category, colors, seasons, occasions, images, and optional purchase metadata. |
| Outfit | A curated composition of wardrobe items. Can be created by members or recommended by the agent. |
| Feed Item | A wardrobe item surfaced in the discover feed with engagement tracking (likes, saves, impressions). |
| Collection | A named grouping of feed items saved by a user (e.g., "Spring Inspiration", "Work Outfits"). |
| Term | Definition |
|---|
| Offer | A normalized representation of a product from an external e-commerce source. Contains price, images, sizes, colors, and status. |
| Offer Source | Where the offer originated: MERCHANT_FEED, AFFILIATE, RETAILER_DIRECT, or MANUAL_LINK. |
| Search Constraints | A structured query object used to search offers: category, colors, season, brands, price range, sizes, keywords. |
| Match Score | A 0-1 float indicating how well an offer matches search constraints, broken down into weighted features. |
| Term | Definition |
|---|
| Purchase Request | A formal request to buy something, requiring guardian approval. Lifecycle: DRAFT → SUBMITTED → APPROVED → CART_READY → COMPLETED. |
| Purchase Intent | Created after approval, binds a purchase request to a specific checkout action with an ephemeral confirmation token. |
| Confirmation Token | A short-lived token (default 15min) used to authorize the final checkout action. Must be held in memory only. |
| Guardian | A household member with PARENT/GUARDIAN role who can approve or reject purchase requests. |
| Term | Definition |
|---|
| Hyperbeam Session | An ephemeral cloud Chromium browser instance provided by the Hyperbeam API. Embeddable via iframe. |
| Takeover | The user takes manual control of the Hyperbeam session. While in takeover, the agent cannot execute actions. The user can release control to let the agent resume. |
| DOM Indexing | The Chrome Extension running inside Hyperbeam sessions identifies interactive elements and reports them via events. The agent queries these indexed elements to perform structured actions. |
| Agent Action | A structured command sent to the Hyperbeam session: CLICK, TYPE, SCROLL, NAVIGATE, QUERY_ELEMENTS, SNAPSHOT. |
| CartPrep Job | A headless browser automation task that navigates to a product page, selects size/color, and adds items to a cart. |
| Barge-In | Voice interaction pattern where the user interrupts the agent mid-speech. Stops TTS playback and begins a new input turn. |
| Term | Definition |
|---|
| Dual Backend | Every service supports PERSISTENCE_BACKEND=firestore (production) and inmemory (development) via the repository pattern. |
| Bridge Event | An event sent from the hyperbeam-bridge service to the orchestrator when session state changes (e.g., takeover start/end, page navigation). |
| Audit Event | An immutable ledger entry recording significant system actions. Categorized by severity (INFO, WARNING, CRITICAL) and category (MISSION_LIFECYCLE, PURCHASE_GATE, etc.). |
| Internal Token | A shared secret (X-Internal-Token header) used for machine-to-machine authentication between services. |