# Lilith -- Product Features

> **Canonical source:** the canonical features document for this domain is
> [`deep-dive/features.md`](./deep-dive/features.md), rendered in the docs
> center. This file is its operational companion (service topology, APIs,
> schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).

> **Lilith** is a Conversational AI and Consciousness Experience Platform that
> combines guided meditation, AI-powered spiritual conversations, immersive
> VR/AR spaces, creative expression tools, Web3 integration, and community
> features into a unified wellness ecosystem. This document describes every
> user-facing feature from the perspective of the people who use them.

---

## Table of Contents

1. [Platform Access](#platform-access)
2. [AI Conversations](#ai-conversations)
3. [Meditation and Wellness](#meditation-and-wellness)
4. [Voice and Audio](#voice-and-audio)
5. [Knowledge and Learning](#knowledge-and-learning)
6. [Journaling and Reflection](#journaling-and-reflection)
7. [Content Discovery](#content-discovery)
8. [Community Features](#community-features)
9. [Immersive Experiences](#immersive-experiences)
10. [Creator Economy](#creator-economy)
11. [Web3 and Token Economy](#web3-and-token-economy)
12. [Account and Identity](#account-and-identity)
13. [Personalization and Progress](#personalization-and-progress)
14. [Offline and Cross-Device](#offline-and-cross-device)
15. [Notifications and Daily Content](#notifications-and-daily-content)
16. [Subscription Plans](#subscription-plans)
17. [Accessibility and Localization](#accessibility-and-localization)
18. [Privacy and Data Governance](#privacy-and-data-governance)
19. [Developer and Partner Access](#developer-and-partner-access)
20. [Gaming -- Veilborn Chronicles](#gaming----veilborn-chronicles)
21. [Generative Art](#generative-art)

---

## Platform Access

Lilith is available on every major platform, giving users the freedom to
practice wherever they are.

### Client Applications

| Platform    | Framework                  | Key Capabilities                                                                  |
| ----------- | -------------------------- | --------------------------------------------------------------------------------- |
| **Web**     | Next.js 14 PWA             | 3D visualization (Three.js/BabylonJS), Storybook component library, Web3 wallet   |
| **Mobile**  | React Native (iOS/Android) | Audio recording, WebRTC, biometrics, haptic feedback, push notifications, offline |
| **Desktop** | Electron                   | Full-featured desktop client with native OS integration                           |
| **CLI**     | Command-line               | Scripted meditation workflows and developer utilities                             |
| **VR/AR**   | Metaverse service          | Immersive meditation spaces, 3D environments, avatar interaction                  |

### Web Features

- Progressive Web App (PWA) installable on any device
- 3D visualizations and interactive meditation environments
- Real-time chat with server-sent event (SSE) streaming
- Web3 wallet connection (MetaMask, WalletConnect) via wagmi/viem
- Storybook-driven design system with Radix UI and Tailwind CSS
- Internationalization with next-intl

### Mobile Features

- Native biometric authentication (Face ID, Touch ID, fingerprint)
- Background audio playback for meditation sessions
- Haptic feedback synchronized with breathing exercises
- Offline download of meditation content with encrypted bundles
- Health data integration (Apple HealthKit, Google Fit)
- Push notifications for meditation reminders and daily content
- WebRTC-based real-time voice chat

---

## AI Conversations

Lilith provides deeply personal AI-driven conversations across spiritual,
philosophical, and wellness topics.

### Conversational AI

| Feature                     | Description                                                                    |
| --------------------------- | ------------------------------------------------------------------------------ |
| **Multi-Persona Support**   | Choose from multiple AI personas, each with distinct personality and expertise |
| **Threaded Conversations**  | Organize discussions into threads for focused exploration                      |
| **Real-Time Streaming**     | Responses stream in real time via SSE for natural conversation flow            |
| **Document Understanding**  | Upload PDFs, Office docs, HTML, and Markdown for AI analysis                   |
| **Context-Aware Responses** | AI draws on your conversation history and preferences                          |
| **Safety Guardrails**       | Content moderation ensures safe and supportive dialogue                        |

### AI Knowledge System

| Feature                                  | Description                                                                  |
| ---------------------------------------- | ---------------------------------------------------------------------------- |
| **Retrieval-Augmented Generation (RAG)** | AI responses enriched with curated spiritual and wellness knowledge          |
| **Semantic Search**                      | Find relevant teachings using meaning-based search across the knowledge base |
| **Knowledge Graph**                      | Interconnected ontology of spiritual concepts, traditions, and practices     |
| **Spiritual Embeddings**                 | Domain-specific vector embeddings tuned for consciousness and spirituality   |
| **Source Attribution**                   | AI cites the sources behind its responses so users can explore further       |

### Spiritual Guidance

| Feature                      | Description                                                               |
| ---------------------------- | ------------------------------------------------------------------------- |
| **AI Spiritual Advisor**     | Personalized spiritual guidance conversations                             |
| **Tradition-Aware Counsel**  | Guidance respects and references multiple spiritual traditions            |
| **Life Questions**           | Explore existential, philosophical, and ethical questions with AI support |
| **Practice Recommendations** | AI suggests meditation techniques, readings, and practices based on needs |

---

## Meditation and Wellness

The core of the Lilith experience is a comprehensive meditation and wellness
practice system.

### Meditation Sessions

| Feature                      | Description                                                               |
| ---------------------------- | ------------------------------------------------------------------------- |
| **Guided Meditations**       | Professionally narrated guided meditation sessions across many topics     |
| **AI-Generated Meditations** | Personalized meditations created by AI based on your mood and preferences |
| **Timer Meditations**        | Silent timer with customizable intervals, bells, and ambient sounds       |
| **Session Safety**           | Built-in safety checks ensure meditations are appropriate for the user    |
| **Mode Selection**           | Choose meditation modes: guided, timer, music, silence, or AI-generated   |
| **Session Completion**       | Mark sessions complete with duration, rating, and optional feedback       |

### Group Meditation

| Feature                     | Description                                                |
| --------------------------- | ---------------------------------------------------------- |
| **Live Group Sessions**     | Meditate together with other users in real time            |
| **Synchronized Experience** | All participants hear the same guidance simultaneously     |
| **Group Energy Display**    | Visual representation of collective meditation energy      |
| **Session Scheduling**      | Schedule group meditations and invite friends              |
| **Teacher-Led Groups**      | Certified teachers can lead live group meditation sessions |

### Breathwork

| Feature                   | Description                                                           |
| ------------------------- | --------------------------------------------------------------------- |
| **Breathing Exercises**   | Library of breathing techniques (box breathing, 4-7-8, Wim Hof, etc.) |
| **Visual Breath Guide**   | Animated visualizations that guide inhale, hold, and exhale cycles    |
| **Haptic Breath Cues**    | Mobile haptic feedback that pulses with the breathing rhythm          |
| **Biometric Integration** | Heart rate and HRV tracking during breathwork via health device APIs  |
| **Progress Tracking**     | Track breathing session history, duration, and technique mastery      |

### Yoga Practice

| Feature                  | Description                                              |
| ------------------------ | -------------------------------------------------------- |
| **Guided Yoga Sessions** | Step-by-step yoga practice with pose guidance            |
| **Pose Library**         | Browse and learn individual yoga poses with instructions |
| **Difficulty Levels**    | Sessions for beginners through advanced practitioners    |
| **Sequence Builder**     | Create custom yoga sequences from the pose library       |
| **Practice History**     | Track your yoga practice over time                       |

---

## Voice and Audio

Lilith offers a rich voice experience for hands-free meditation and
conversation.

### Text-to-Speech (TTS)

| Feature                     | Description                                                       |
| --------------------------- | ----------------------------------------------------------------- |
| **Natural Voice Synthesis** | AI responses read aloud with natural, warm voices (AWS Polly)     |
| **Multiple Voice Options**  | Choose from a variety of voices suited to meditation and guidance |
| **Speed Control**           | Adjust speech rate to match your preferred listening pace         |
| **Background Music Mixing** | Voice guidance mixed with ambient music and nature sounds         |

### Speech-to-Text (STT)

| Feature                     | Description                                            |
| --------------------------- | ------------------------------------------------------ |
| **Voice Input**             | Speak to the AI instead of typing                      |
| **Real-Time Transcription** | Your words transcribed and sent to the AI as you speak |
| **Multi-Language Support**  | Speech recognition across multiple languages           |

### Voice Conversations

| Feature                        | Description                                                                  |
| ------------------------------ | ---------------------------------------------------------------------------- |
| **Duplex Voice Pipeline**      | Full-duplex voice conversation with the AI (speak and listen simultaneously) |
| **WebRTC Voice Chat**          | High-quality, low-latency real-time voice communication                      |
| **Cross-Device Audio Handoff** | Seamlessly transfer audio from phone to speaker to headphones                |
| **Voice-Guided Meditation**    | Complete meditation sessions delivered through voice                         |

---

## Knowledge and Learning

Users can deepen their spiritual and wellness knowledge through structured
learning paths.

### Curricula and Courses

| Feature                        | Description                                              |
| ------------------------------ | -------------------------------------------------------- |
| **Structured Learning Paths**  | Multi-session courses organized by topic and difficulty  |
| **Progress Tracking**          | Track completion of lessons, modules, and entire courses |
| **Bookmarks and Highlights**   | Save important passages and revisit them later           |
| **Certificates of Completion** | Earn certificates after finishing course requirements    |

### Knowledge Catalog

| Feature                    | Description                                                       |
| -------------------------- | ----------------------------------------------------------------- |
| **Searchable Catalog**     | Browse and search the full library of teachings and content       |
| **Category Organization**  | Content organized by tradition, topic, difficulty, and format     |
| **Data Lineage**           | Trace the origin and provenance of every piece of knowledge       |
| **Curator Administration** | Expert curators manage and quality-check the knowledge repository |

### Scholar Notes

| Feature                 | Description                                                  |
| ----------------------- | ------------------------------------------------------------ |
| **Highlight and Notes** | Annotate content with personal highlights and notes          |
| **Learning Journals**   | Maintain a learning journal connected to courses and content |
| **Note Organization**   | Tag and organize notes for easy retrieval                    |
| **Cross-Reference**     | Link notes to related content across the knowledge base      |

---

## Journaling and Reflection

A dedicated personal journaling system for introspection and growth.

### Journal Features

| Feature                     | Description                                                    |
| --------------------------- | -------------------------------------------------------------- |
| **Free-Form Journaling**    | Write freely about experiences, feelings, and reflections      |
| **Prompted Journaling**     | AI-suggested prompts to guide reflection                       |
| **Post-Meditation Journal** | Automatic journal prompt after completing a meditation session |
| **Mood Tracking**           | Record and visualize your emotional state over time            |
| **Search and Filter**       | Search through past journal entries by date, keyword, or tag   |
| **Privacy Protection**      | Journal entries are encrypted and visible only to you          |

---

## Content Discovery

Finding the right meditation, teaching, or practice is effortless.

### Discovery Features

| Feature                          | Description                                                    |
| -------------------------------- | -------------------------------------------------------------- |
| **Personalized Recommendations** | AI-powered content suggestions based on practice history       |
| **Daily Content Delivery**       | Fresh, personalized meditation or teaching delivered each day  |
| **Category Browsing**            | Explore by topic: stress relief, sleep, focus, gratitude, etc. |
| **Teacher Profiles**             | Discover content by specific teachers and traditions           |
| **Duration Filters**             | Find meditations by length (5, 10, 15, 20, 30+ minutes)        |
| **Trending and Popular**         | See what the community is practicing most                      |
| **Full-Text Search**             | Search across all content by keyword with Elasticsearch        |

### Content Reviews

| Feature                 | Description                                                     |
| ----------------------- | --------------------------------------------------------------- |
| **Ratings and Reviews** | Rate meditations and leave reviews for the community            |
| **Human Review System** | Content reviewed and approved by human moderators               |
| **Teacher Blessing**    | Traditional content requires teacher approval before publishing |

---

## Community Features

Connect with fellow practitioners and build a supportive spiritual community.

### Social Features

| Feature                   | Description                                                           |
| ------------------------- | --------------------------------------------------------------------- |
| **User Profiles**         | Public profiles showcasing practice streaks and achievements          |
| **Follow System**         | Follow teachers and practitioners to see their activity               |
| **Activity Feed**         | See meditation completions, achievements, and milestones from follows |
| **Community Translation** | Community members contribute translations for global accessibility    |
| **Shared Meditation**     | Invite friends to meditate together remotely                          |

### Real-Time Chat

| Feature                  | Description                                                |
| ------------------------ | ---------------------------------------------------------- |
| **WebSocket Chat**       | Real-time messaging with other users and in group sessions |
| **Threaded Discussions** | Organize conversations into topic-based threads            |
| **Moderation Tools**     | Automated and manual content moderation for safe community |
| **Input Sanitization**   | All user input sanitized to prevent abuse                  |

---

## Immersive Experiences

Step into consciousness-expanding virtual environments.

### VR/AR Meditation Spaces

| Feature                      | Description                                                        |
| ---------------------------- | ------------------------------------------------------------------ |
| **Virtual Meditation Rooms** | Immersive 3D environments for meditation (forests, temples, space) |
| **Avatar Presence**          | Represent yourself with a customizable avatar                      |
| **Spatial Audio**            | 3D positional sound that creates a sense of place                  |
| **Group VR Sessions**        | Meditate with others in shared virtual spaces                      |
| **Environment Selection**    | Choose from multiple themed virtual environments                   |

### 3D Visualizations

| Feature                    | Description                                                       |
| -------------------------- | ----------------------------------------------------------------- |
| **Three.js/BabylonJS/R3F** | Rich 3D graphics rendered in the browser                          |
| **Generative Fractals**    | Mathematically generated fractal visualizations for contemplation |
| **Interactive Mandalas**   | Generative mandala art responsive to meditation state             |
| **Cosmic Journeys**        | Guided visual journeys through space and abstract landscapes      |

### Avatar Customization

| Feature                   | Description                                        |
| ------------------------- | -------------------------------------------------- |
| **Avatar Creator**        | Design your virtual representation                 |
| **Cosmetic Marketplace**  | Purchase avatar skins, accessories, and outfits    |
| **Seasonal Collections**  | Limited-edition cosmetic items released seasonally |
| **Token-Gated Cosmetics** | Exclusive items available to token holders         |

---

## Creator Economy

Lilith empowers teachers and content creators to share their wisdom and earn
revenue.

### Creator Tools

| Feature                  | Description                                                   |
| ------------------------ | ------------------------------------------------------------- |
| **Content Upload**       | Upload guided meditations, teachings, courses, and multimedia |
| **Content Licensing**    | Set licensing terms for how your content can be used          |
| **Rights Management**    | Automated license gates and content source validation         |
| **Content Verification** | System verifies content authenticity and originality          |
| **Royalty Tracking**     | Real-time dashboard showing earnings from your content        |
| **ComfyUI Integration**  | AI-powered image and video generation for content creation    |

### Monetization

| Feature               | Description                                                      |
| --------------------- | ---------------------------------------------------------------- |
| **Royalty Payments**  | Earn royalties whenever users engage with your content           |
| **Creator Tiers**     | Unlock additional creator tools as your audience grows           |
| **Revenue Reports**   | Detailed earnings breakdowns by content, time period, and source |
| **Payout Management** | Configure preferred payout methods and schedule                  |

---

## Web3 and Token Economy

Lilith integrates blockchain technology for decentralized ownership, governance,
and monetization.

### Native Token

| Feature                | Description                                                    |
| ---------------------- | -------------------------------------------------------------- |
| **Platform Token**     | Native utility token for the Lilith ecosystem                  |
| **Token Wallet**       | Built-in wallet for managing token balances                    |
| **Fiat On/Off Ramp**   | Buy tokens with credit card or bank transfer; cash out to fiat |
| **Micro-Transactions** | Use tokens for small purchases (individual meditations, tips)  |

### Token-Gated Access

| Feature                   | Description                                                          |
| ------------------------- | -------------------------------------------------------------------- |
| **Exclusive Content**     | Access premium content available only to token holders               |
| **Token Verification**    | Cryptographic proof that you hold the required tokens                |
| **NFT-Gated Experiences** | Unique meditations or environments unlocked by holding specific NFTs |

### Staking and DeFi

| Feature                | Description                                                     |
| ---------------------- | --------------------------------------------------------------- |
| **Token Staking**      | Stake tokens to earn rewards and unlock premium features        |
| **DeFi Integration**   | Connect to decentralized finance protocols for yield            |
| **Cross-Chain Bridge** | Transfer tokens between Ethereum, Polygon, and other chains     |
| **IPFS Storage**       | Content stored on the decentralized IPFS network for permanence |

### DAO Governance

| Feature                   | Description                                                     |
| ------------------------- | --------------------------------------------------------------- |
| **Community Voting**      | Token holders vote on platform decisions and feature priorities |
| **Governance Proposals**  | Submit and discuss proposals for platform changes               |
| **Treasury Management**   | Community-governed treasury for funding projects and creators   |
| **Transparent Execution** | All governance actions recorded on-chain for transparency       |

### Transaction Management

| Feature                      | Description                                                |
| ---------------------------- | ---------------------------------------------------------- |
| **Transaction History**      | Complete history of all token transactions                 |
| **Settlement Orchestration** | Automated settlement of payments between parties           |
| **Multi-Currency Support**   | Support for multiple cryptocurrencies and tokens           |
| **Consent Management**       | Explicit user consent required for blockchain transactions |

---

## Account and Identity

Secure, flexible account management.

### Authentication

| Feature                        | Description                                              |
| ------------------------------ | -------------------------------------------------------- |
| **Email/Password Login**       | Traditional email and password authentication            |
| **WebAuthn/FIDO2 Passkeys**    | Passwordless login using biometric-backed passkeys       |
| **Two-Factor Authentication**  | TOTP-based 2FA for additional security                   |
| **QR Code Login**              | Scan a QR code to log in on a new device                 |
| **Cross-Platform Auth**        | Single account works across web, mobile, desktop, and VR |
| **Password Strength Checking** | Real-time password strength feedback (zxcvbn)            |

### Profile Management

| Feature                | Description                                                    |
| ---------------------- | -------------------------------------------------------------- |
| **User Preferences**   | Customize meditation preferences, notification settings, theme |
| **Language Selection** | Choose your preferred language with auto-detection             |
| **Privacy Settings**   | Control what information is visible to others                  |
| **Data Export**        | Download all your personal data at any time                    |

---

## Personalization and Progress

Track your practice and watch your growth.

### Progress Tracking

| Feature                  | Description                                                         |
| ------------------------ | ------------------------------------------------------------------- |
| **Practice Streaks**     | Track consecutive days of meditation practice                       |
| **Session History**      | Complete log of all meditation sessions with duration and rating    |
| **Achievement Badges**   | Earn badges for milestones (first session, 7-day streak, 100 hours) |
| **Statistics Dashboard** | Visualize total time meditated, sessions completed, and trends      |
| **Cross-Device Sync**    | Progress automatically syncs across all your devices                |

### Biometric Integration

| Feature                     | Description                                                       |
| --------------------------- | ----------------------------------------------------------------- |
| **Heart Rate Monitoring**   | Track heart rate during meditation via Apple HealthKit/Google Fit |
| **HRV Tracking**            | Heart rate variability data to measure meditation effectiveness   |
| **Stress Level Indicators** | Biometric-informed stress level feedback                          |
| **Health Data Privacy**     | Biometric data anonymized and encrypted                           |

### Personalized Recommendations

| Feature                    | Description                                                       |
| -------------------------- | ----------------------------------------------------------------- |
| **AI-Powered Suggestions** | Recommendations based on your practice history and preferences    |
| **Time-of-Day Awareness**  | Suggestions tailored to morning, afternoon, or evening            |
| **Mood-Based Selection**   | Select your current mood and get appropriate meditation options   |
| **Goal-Based Paths**       | Set goals (better sleep, reduced anxiety) and get a tailored plan |

---

## Offline and Cross-Device

Practice anywhere, even without internet.

### Offline Access

| Feature                       | Description                                                  |
| ----------------------------- | ------------------------------------------------------------ |
| **Download for Offline**      | Download meditations, courses, and teachings for offline use |
| **Encrypted Offline Bundles** | Downloaded content is encrypted for content protection       |
| **License Management**        | Offline downloads respect subscription and licensing terms   |
| **Automatic Sync**            | Changes made offline sync when connection is restored        |

### Cross-Device Continuity

| Feature                     | Description                                                  |
| --------------------------- | ------------------------------------------------------------ |
| **Seamless Handoff**        | Start a meditation on your phone, continue on your desktop   |
| **Audio Handoff**           | Transfer audio playback between devices without interruption |
| **Bookmark Sync**           | Bookmarks and progress sync instantly across all devices     |
| **CRDT-Based Sync**         | Conflict-free sync using CRDT for reliable cross-device data |
| **Real-Time Collaboration** | WebSocket-based real-time sync for shared experiences        |

---

## Notifications and Daily Content

Stay connected to your practice with gentle reminders and fresh content.

### Notification System

| Feature                     | Description                                                          |
| --------------------------- | -------------------------------------------------------------------- |
| **Meditation Reminders**    | Configurable reminders to maintain your daily practice               |
| **Streak Alerts**           | Notification if you are about to break your practice streak          |
| **New Content Alerts**      | Get notified when new meditations from your favorite teachers arrive |
| **Community Notifications** | Updates about group sessions, community events, and messages         |
| **Push and Email**          | Notifications delivered via push (mobile) and email                  |

### Daily Content

| Feature                    | Description                                                      |
| -------------------------- | ---------------------------------------------------------------- |
| **Daily Meditation**       | A new meditation delivered to you every day                      |
| **Personalized Selection** | Daily content chosen based on your preferences and history       |
| **Daily Quote**            | Inspirational quote or teaching to start your day                |
| **Seasonal Content**       | Special content aligned with seasons, holidays, and lunar cycles |

---

## Subscription Plans

Lilith offers flexible subscription tiers to match every practitioner's needs.

### Tier Comparison

| Feature                         | Free      | Premium     | Creator     | Enterprise  |
| ------------------------------- | --------- | ----------- | ----------- | ----------- |
| **Basic meditations**           | Yes       | Yes         | Yes         | Yes         |
| **Daily content**               | Limited   | Unlimited   | Unlimited   | Unlimited   |
| **Full content catalog**        | No        | Yes         | Yes         | Yes         |
| **Offline downloads**           | No        | Yes         | Yes         | Yes         |
| **Ad-free experience**          | No        | Yes         | Yes         | Yes         |
| **AI conversations**            | Limited   | Unlimited   | Unlimited   | Unlimited   |
| **Group meditations**           | Join only | Host + Join | Host + Join | Host + Join |
| **Create and monetize content** | No        | No          | Yes         | Yes         |
| **Royalty tracking**            | No        | No          | Yes         | Yes         |
| **Team features**               | No        | No          | No          | Yes         |
| **Advanced analytics**          | No        | No          | No          | Yes         |
| **Partner API access**          | No        | No          | No          | Yes         |
| **Dedicated support**           | No        | No          | No          | Yes         |

### Payment Options

| Method                | Availability                                |
| --------------------- | ------------------------------------------- |
| **Credit/Debit Card** | All plans                                   |
| **Crypto Payment**    | All plans (via fiat ramp)                   |
| **Token Payment**     | Premium and above (pay with Lilith tokens)  |
| **In-App Purchase**   | iOS App Store and Google Play subscriptions |

---

## Accessibility and Localization

### Language Support

| Feature                      | Description                                             |
| ---------------------------- | ------------------------------------------------------- |
| **Multi-Language Interface** | Interface available in multiple languages via next-intl |
| **Auto Language Detection**  | Automatically detects user's preferred language         |
| **Community Translation**    | Community members contribute and verify translations    |
| **RTL Support**              | Right-to-left language support for Arabic, Hebrew, etc. |

### Accessibility

| Feature                   | Description                                                  |
| ------------------------- | ------------------------------------------------------------ |
| **Screen Reader Support** | Full compatibility with screen readers (VoiceOver, TalkBack) |
| **Keyboard Navigation**   | Complete keyboard navigation across web and desktop          |
| **High Contrast Mode**    | Enhanced contrast for users with visual impairments          |
| **Adjustable Text Size**  | Scale text size to user preference                           |
| **Reduced Motion**        | Option to disable animations for motion-sensitive users      |

---

## Privacy and Data Governance

### Privacy Features

| Feature                        | Description                                                 |
| ------------------------------ | ----------------------------------------------------------- |
| **Data Anonymization**         | Privacy-preserving anonymization of analytics data          |
| **Consent Management**         | Explicit consent required for data processing activities    |
| **Data Governance Compliance** | Compliance with GDPR, CCPA, and other privacy regulations   |
| **Input Sanitization**         | All user input sanitized (DOMPurify) to prevent XSS attacks |
| **Encrypted Storage**          | Sensitive data encrypted at rest and in transit             |
| **Audit Logging**              | Complete audit trail of data access and modifications       |

---

## Developer and Partner Access

### SDK and API

| Feature                   | Description                                                            |
| ------------------------- | ---------------------------------------------------------------------- |
| **TypeScript SDK**        | Typed client library for programmatic access to all Lilith APIs        |
| **Partner SDK**           | SDK for third-party integrations with authentication and rate limiting |
| **GraphQL API**           | Flexible query interface via the BFF gateway                           |
| **REST API**              | RESTful endpoints for all platform operations                          |
| **Webhook Support**       | Receive real-time event notifications for integrations                 |
| **OpenAPI Documentation** | Auto-generated API documentation from OpenAPI specifications           |

### API Capabilities

| Endpoint                        | Description                              |
| ------------------------------- | ---------------------------------------- |
| `GET /v1/meditations`           | List and search the meditation catalog   |
| `GET /v1/meditations/:id`       | Get detailed meditation information      |
| `POST /v1/sessions`             | Start a new meditation session           |
| `PUT /v1/sessions/:id/complete` | Record session completion with feedback  |
| `GET /v1/progress`              | Retrieve user progress and statistics    |
| `GET /v1/achievements`          | List earned achievement badges           |
| `POST /v1/conversations`        | Start a new AI conversation              |
| `GET /v1/recommendations`       | Get personalized content recommendations |
| `GET /v1/catalog/daily`         | Retrieve today's daily content selection |

---

## Gaming -- Veilborn Chronicles

Lilith includes an integrated tabletop RPG and strategy game experience that
blends consciousness themes with interactive storytelling.

### Veilborn Chronicles: Tabletop RPG

| Feature                  | Description                                                     |
| ------------------------ | --------------------------------------------------------------- |
| **Character Creation**   | Create characters with spiritual archetypes and abilities       |
| **Story Campaigns**      | Play through narrative campaigns exploring consciousness themes |
| **Multiplayer Sessions** | Play with friends in real-time collaborative RPG sessions       |
| **AI Game Master**       | AI-powered game master for solo and group play                  |
| **Lore Library**         | Rich lore database exploring the Veilborn universe              |

### The Veil War: Strategy Game

| Feature                 | Description                                                    |
| ----------------------- | -------------------------------------------------------------- |
| **Strategic Battles**   | Turn-based or real-time strategy battles in the Veilborn world |
| **Faction System**      | Choose and develop factions with unique abilities              |
| **Resource Management** | Manage spiritual resources and territory                       |
| **Competitive Play**    | Ranked matches against other players                           |
| **Campaign Mode**       | Story-driven single-player campaign                            |

---

## Generative Art

### ComfyUI Integration

| Feature                        | Description                                                 |
| ------------------------------ | ----------------------------------------------------------- |
| **AI Image Generation**        | Create meditation-themed artwork using AI image models      |
| **AI Video Generation**        | Generate contemplative video content with ComfyUI workflows |
| **Custom Workflow Templates**  | Pre-built workflows for mandalas, sacred geometry, and more |
| **RunComfy Cloud Integration** | Cloud-based AI generation without local GPU requirements    |

### Generative Fractal Visualizations

| Feature                          | Description                                                  |
| -------------------------------- | ------------------------------------------------------------ |
| **Real-Time Fractal Generation** | Live mathematical fractal art that evolves during meditation |
| **Interactive Parameters**       | Adjust fractal parameters to explore infinite patterns       |
| **Meditation-Responsive**        | Fractals respond to biometric input and meditation state     |
| **Export and Share**             | Save fractal art as images or videos to share                |

---

## Feature Summary

| Category              | Feature Count | Highlights                                              |
| --------------------- | ------------- | ------------------------------------------------------- |
| AI Conversations      | 11            | Multi-persona, RAG, knowledge graph, spiritual guidance |
| Meditation & Wellness | 20            | Guided, AI-generated, group, breathwork, yoga           |
| Voice & Audio         | 10            | TTS, STT, duplex voice, WebRTC, audio handoff           |
| Knowledge & Learning  | 9             | Curricula, catalog, scholar notes, cross-reference      |
| Community             | 8             | Chat, follow, activity feed, community translation      |
| Immersive             | 12            | VR/AR rooms, 3D visuals, avatars, fractal art           |
| Creator Economy       | 10            | Upload, licensing, rights management, royalties         |
| Web3 & Tokens         | 17            | Native token, staking, DAO, DeFi, cross-chain bridge    |
| Account & Identity    | 10            | Passkeys, 2FA, QR login, cross-platform auth            |
| Personalization       | 12            | Streaks, biometrics, AI recommendations, goal paths     |
| Offline & Sync        | 9             | Encrypted downloads, CRDT sync, audio handoff           |
| Gaming                | 10            | Veilborn RPG, Veil War strategy, AI game master         |
| Generative Art        | 7             | ComfyUI, fractals, mandalas, sacred geometry            |

---

_Lilith: Where technology meets consciousness._
