- Almost done, documentation base for 6.1.0.

docs/src/README.md

@@ -1,12 +1,12 @@
-# BotServer Documentation
+# General Bots Documentation
 
-Welcome to the **BotServer** documentation. This guide explains how to install, configure, extend, and deploy conversational AI bots using BotServer's template-based package system and BASIC scripting language.
+Welcome to the **General Bots** documentation. This guide explains how to install, configure, extend, and deploy conversational AI bots using General Bots' template-based package system and BASIC scripting language.
 
 ---
 
 ## About This Documentation
 
-This documentation has been **recently updated** to accurately reflect the actual implementation of BotServer version 6.0.8. The following sections are now accurate:
+This documentation has been **recently updated** to accurately reflect the actual implementation of General Bots version 6.0.8. The following sections are now accurate:
 
 ✅ **Accurate Documentation:**
 - Chapter 02: Package system (template-based `.gbai` structure)
@@ -30,9 +30,9 @@ This documentation has been **recently updated** to accurately reflect the actua
 
 ---
 
-## What is BotServer?
+## What is General Bots?
 
-BotServer is an open-source conversational AI platform written in Rust. It enables users to create intelligent chatbots using:
+General Bots is an open-source conversational AI platform written in Rust. It enables users to create intelligent chatbots using:
 
 - **BASIC Scripting**: Simple `.bas` scripts for conversation flows
 - **Template Packages**: Organize bots as `.gbai` directories with dialogs, knowledge bases, and configuration
@@ -50,7 +50,7 @@ BotServer is an open-source conversational AI platform written in Rust. It enabl
 3. **Create a Bot**: Copy a template and modify it
 4. **Learn BASIC**: Read [Chapter 05: BASIC Reference](chapter-05/README.md)
 5. **Configure**: Edit `config.csv` in your `.gbot/` directory
-6. **Deploy**: Restart BotServer to activate changes
+6. **Deploy**: Restart General Bots to activate changes
 
 ---
 
@@ -81,7 +81,7 @@ BotServer is an open-source conversational AI platform written in Rust. It enabl
 - [Chapter 06: gbdialog Reference](chapter-06-gbdialog/README.md) - Complete BASIC scripting reference
   - Keywords: `TALK`, `HEAR`, `LLM`, `SET CONTEXT`, `USE KB`, and more
 
-### Part VII - Extending BotServer
+### Part VII - Extending General Bots
 - [Chapter 07: gbapp Architecture Reference](chapter-07-gbapp/README.md) - Internal architecture
   - [Architecture Overview](chapter-07-gbapp/architecture.md) - Bootstrap process
   - [Building from Source](chapter-07-gbapp/building.md) - Compilation and features
@@ -114,7 +114,7 @@ BotServer is an open-source conversational AI platform written in Rust. It enabl
 
 ## Architecture Overview
 
-BotServer is a **monolithic Rust application** (single crate) with the following structure:
+General Bots is a **monolithic Rust application** (single crate) with the following structure:
 
 ### Core Modules
 - `auth` - Argon2 password hashing, session tokens
@@ -159,7 +159,7 @@ BotServer is a **monolithic Rust application** (single crate) with the following
 
 - **Version**: 6.0.8
 - **License**: AGPL-3.0
-- **Repository**: https://github.com/GeneralBots/BotServer
+- **Repository**: https://github.com/GeneralBots/botserver
 - **Community**: Open-source contributors from Pragmatismo.com.br
 
 ---
@@ -178,4 +178,4 @@ See [TODO.txt](TODO.txt) for known documentation gaps.
 
 ## Next Steps
 
-Start with [Introduction](introduction.md) for a comprehensive overview, or jump directly to [Chapter 01: Run and Talk](chapter-01/README.md) to install and run BotServer.
+Start with [Introduction](introduction.md) for a comprehensive overview, or jump directly to [Chapter 01: Run and Talk](chapter-01/README.md) to install and run General Bots.

docs/src/SUMMARY.md

@@ -174,7 +174,7 @@
   - [Documentation](./chapter-13-community/documentation.md)
   - [Pull Requests](./chapter-13-community/pull-requests.md)
   - [Community Guidelines](./chapter-13-community/community.md)
-  - [IDE Extensions](./chapter-13-community/ide-extensions.md)
+  - [IDEs](./chapter-13-community/ide-extensions.md)
 
 # Appendices
 
@@ -183,4 +183,5 @@
   - [Tables](./appendix-i/tables.md)
   - [Relationships](./appendix-i/relationships.md)
 
-[Glossary](./glossary.md)
+[Glossary](./glossary.md)
+[Contact](./contact/README.md)

docs/src/appendix-i/README.md

@@ -1,6 +1,8 @@
-## Appendix I – Database Model
+## Appendix I – Database Model
 
-The core database schema for GeneralBots is defined in `src/shared/models.rs`. It uses **Diesel** with SQLite (or PostgreSQL) and includes the following primary tables:
+![Database Schema Overview](./assets/schema-overview.svg)
+
+The core database schema for GeneralBots is defined in `src/shared/models.rs`. It uses **Diesel** with PostgreSQL and includes the following primary tables:
 
 | Table | Description |
 |-------|-------------|
@@ -18,32 +20,27 @@ The core database schema for GeneralBots is defined in `src/shared/models.rs`. I
 - **Session ↔ Tools** – One‑to‑many: tools are scoped to the session that registers them.
 - **File ↔ KnowledgeBase** – Optional link for documents stored in a knowledge base.
 
-### Key Fields (excerpt)
+### Key Tables
 
-```rust
+**User Table**
-pub struct User {
+- id: Integer primary key
-    pub id: i32,
+- username: String
-    pub username: String,
+- email: String  
-    pub email: String,
+- password_hash: String
-    pub password_hash: String,
+- created_at: Timestamp
-    pub created_at: NaiveDateTime,
-}
 
-pub struct Session {
+**Session Table**
-    pub id: i32,
+- id: Integer primary key
-    pub user_id: i32,
+- user_id: Foreign key to User
-    pub started_at: NaiveDateTime,
+- started_at: Timestamp
-    pub last_active: NaiveDateTime,
+- last_active: Timestamp
-    pub knowledge_base_id: i32,
+- knowledge_base_id: Integer
-}
 
-pub struct Message {
+**Message Table**
-    pub id: i32,
+- id: Integer primary key
-    pub session_id: i32,
+- session_id: Foreign key to Session
-    pub role: String, // "user" or "assistant"
+- role: String ("user" or "assistant")
-    pub content: String,
+- content: Text
-    pub timestamp: NaiveDateTime,
+- timestamp: Timestamp
-}
-```
 
-The schema is automatically migrated by Diesel when the server starts. For custom extensions, add new tables to `models.rs` and run `diesel migration generate <name>`.
+The schema is automatically migrated when the server starts.

docs/src/chapter-02/gbdialog.md

@@ -19,8 +19,8 @@ Instead of complex logic, use the LLM's natural understanding:
 ```basic
 ' Example from announcements.gbai/update-summary.bas
 ' Generate summaries from documents
-let text = GET "announcements.gbkb/news/news.pdf"
+text = GET "announcements.gbkb/news/news.pdf"
-let resume = LLM "In a few words, resume this: " + text
+resume = LLM "In a few words, resume this: " + text
 SET BOT MEMORY "resume", resume
 
 ' Example from law.gbai/case.bas
@@ -136,8 +136,8 @@ TALK "Hello! I'm here to help."
 SET SCHEDULE "59 * * * *"
 
 ' Fetch and summarize documents ONCE for all users
-let text = GET "announcements.gbkb/news/news.pdf"
+text = GET "announcements.gbkb/news/news.pdf"
-let resume = LLM "In a few words, resume this: " + text
+resume = LLM "In a few words, resume this: " + text
 SET BOT MEMORY "resume", resume  ' Stored for all users
 ```
 

docs/src/chapter-06-gbdialog/README.md

@@ -83,7 +83,7 @@ TALK "The answer is: " + answer
 ### 2. HEAR - Input from User
 ```basic
 HEAR name
-HEAR age AS NUMBER
+HEAR age AS INTEGER
 HEAR confirm AS BOOLEAN
 ```
 

docs/src/chapter-12-auth/README.md

@@ -20,13 +20,7 @@ General Bots provides robust authentication with:
 - All passwords are hashed using Argon2 (winner of Password Hashing Competition)
 - Random salt generation for each password
 - Secure password update mechanism
-
+- Password management delegated to Directory Service
-```rust
-// Example password hashing
-let salt = SaltString::generate(&mut OsRng);
-let argon2 = Argon2::default();
-let password_hash = argon2.hash_password(password.as_bytes(), &salt);
-```
 
 ## API Endpoints
 
@@ -49,19 +43,13 @@ Authenticates user and returns session
 ## User Management
 
 ### Creating Users
-```rust
+Users are created through the Directory Service with randomly generated initial passwords.
-auth_service.create_user(username, email, password);
-```
 
 ### Verifying Users
-```rust
+User verification is handled through the Directory Service OAuth2/OIDC flow.
-auth_service.verify_user(username, password);
-```
 
 ### Updating Passwords
-```rust
+Password updates are managed through the Directory Service's built-in password reset workflows.
-auth_service.update_user_password(user_id, new_password);
-```
 
 ## Bot Authentication
 

docs/src/chapter-12-auth/bot-auth.md

@@ -40,16 +40,12 @@ Configuration stored in `bot_configuration` table:
 
 ### Session Structure
 
-```rust
+The user_sessions table structure:
-// user_sessions table
+- id: UUID
-{
+- user_id: UUID (User reference)
-    id: UUID,
+- bot_id: UUID (Bot reference)
-    user_id: UUID,      // User reference
+- session_token: String
-    bot_id: UUID,       // Bot reference
+- expires_at: Timestamp
-    session_token: String,
-    expires_at: Timestamp
-}
-```
 
 ## Bot Isolation
 

docs/src/chapter-12-auth/compliance-requirements.md

@@ -109,7 +109,7 @@ app.example.com {
 | 🔄 | Automated Backups | PostgreSQL | All | Daily backups via pg_dump/pg_basebackup |
 | ✅ | Point-in-Time Recovery | PostgreSQL | HIPAA | WAL archiving enabled |
 
-**Configuration File**: `/etc/postgresql/*/main/postgresql.conf`
+**Configuration**: Installed and configured automatically via installer.rs
 
 ```sql
 -- Enable SSL
@@ -150,16 +150,7 @@ log_statement = 'all'
 | 🔄 | Replication | Drive | HIPAA | Multi-site replication for DR |
 | ✅ | IAM Integration | Drive | All | Integration with Directory Service via OIDC |
 
-**Environment Variables**:
+**Configuration**: `/conf/drive/config.env`
-```bash
-DRIVE_ROOT_USER=admin
-DRIVE_ROOT_PASSWORD=SecurePassword123!
-DRIVE_SERVER_URL=https://drive.example.com
-DRIVE_BROWSER=on
-DRIVE_IDENTITY_OPENID_CONFIG_URL=http://localhost:8080/.well-known/openid-configuration
-DRIVE_IDENTITY_OPENID_CLIENT_ID=drive
-DRIVE_IDENTITY_OPENID_CLIENT_SECRET=secret
-```
 
 **Bucket Policy Example**:
 ```json
@@ -192,7 +183,7 @@ DRIVE_IDENTITY_OPENID_CLIENT_SECRET=secret
 | ✅ | Authentication | Stalwart | All | OIDC integration with Directory Service |
 | 📝 | Retention Policy | Stalwart | GDPR/LGPD | Define and implement email retention |
 
-**Configuration File**: `/etc/stalwart/config.toml`
+**Configuration**: `/conf/mail/config.toml`
 
 ```toml
 [server.listener."smtp"]

docs/src/chapter-12-auth/security-features.md

@@ -58,15 +58,12 @@ Enterprise-ready security features:
 
 General Bots uses the Directory Service (currently Zitadel, but can be migrated to Keycloak or other OIDC providers) as the primary identity provider:
 
-```rust
+Features:
-// Location: src/auth/directory.rs
-// Features:
 - OAuth2/OIDC authentication
 - JWT token validation
 - User/group management
 - Permission management
 - Session handling
-```
 
 ### Password Security
 
@@ -98,17 +95,15 @@ General Bots uses the Directory Service (currently Zitadel, but can be migrated
 
 ### Data Encryption
 
-```rust
+**Encryption at rest:**
-// Encryption at rest
 - Database: Column-level encryption for sensitive fields
 - File storage: AES-256-GCM for uploaded files
 - Configuration: Encrypted secrets with master key
 
-// Encryption in transit
+**Encryption in transit:**
 - TLS 1.3 for all external communications
 - mTLS for service-to-service communication
 - Certificate pinning for critical services
-```
 
 ## Network Security
 
@@ -169,26 +164,24 @@ General Bots uses the Directory Service (currently Zitadel, but can be migrated
   - Temporary files: Secure deletion
 
 ### Memory Security
+### Memory Protection
 
-```rust
+Memory protection measures:
-// Memory protection measures
 - Zeroization of sensitive data
 - No logging of secrets
 - Secure random generation
 - Protected memory pages for crypto keys
-```
 
 ## Audit & Compliance
 
 ### Logging Configuration
+### Log Security
 
-```rust
+Structured logging configuration:
-// Structured logging with tracing
 - Level: INFO (production), DEBUG (development)
 - Format: JSON for machine parsing
 - Rotation: Daily with 30-day retention
 - Sensitive data: Redacted
-```
 
 ### Audit Events
 
@@ -465,8 +458,8 @@ For security issues or questions:
 - [LiveKit Security](https://docs.livekit.io/realtime/server/security/) - Video conferencing
 
 ## References
+## Resources
 
 - [OWASP Top 10](https://owasp.org/Top10/)
 - [CIS Controls](https://www.cisecurity.org/controls/)
-- [NIST Cybersecurity Framework](https://www.nist.gov/cyberframework)
+- [NIST Cybersecurity Framework](https://www.nist.gov/cyberframework)
-- [Rust Security Guidelines](https://anssi-fr.github.io/rust-guide/)

docs/src/chapter-12-auth/user-auth.md

@@ -474,23 +474,16 @@ Located in `src/directory/mod.rs`:
 
 ### Creating Users
 
-```rust
+Creating users via Directory Client:
-// Via Directory Client
+- Username: john_doe
-client.create_user(
+- Email: john@example.com
-    username: "john_doe",
+- First name: John
-    email: "john@example.com", 
+- Last name: Doe
-    first_name: "John",
+- Password: Set through Directory UI or email flow
-    last_name: "Doe"
-)
-// Password set through Directory UI or email flow
-```
 
 ### Getting User Info
 
-```rust
+User information is fetched from the Directory service using the directory ID.
-// Fetch from Directory service
-let user_info = client.get_user(directory_id).await?;
-```
 
 ### Managing Sessions
 

docs/src/chapter-13-community/README.md

@@ -1,10 +1,10 @@
-# Contributing to BotServer
+# Contributing to General Bots
 
-Welcome to the BotServer community! We appreciate your interest in contributing to this open-source project. This chapter provides comprehensive guidance for contributors.
+Welcome to the General Bots community! We appreciate your interest in contributing to this open-source project. This chapter provides comprehensive guidance for contributors.
 
 ## Overview
 
-BotServer is an open-source conversational AI platform built in Rust. We welcome contributions of all kinds:
+General Bots is an open-source conversational AI platform built in Rust, actively used in production since 2018. We welcome contributions of all kinds:
 - Code improvements
 - Documentation updates
 - Bug reports
@@ -18,16 +18,15 @@ BotServer is an open-source conversational AI platform built in Rust. We welcome
 
 Before contributing, ensure you have:
 - Rust 1.70 or later
-- PostgreSQL 14 or later
 - Git experience
-- Basic understanding of BotServer architecture
+- Basic understanding of General Bots architecture
 
 ### First Steps
 
 1. **Fork the Repository**
    ```bash
    git clone https://github.com/GeneralBots/BotServer.git
-   cd BotServer
+   cd botserver
    ```
 
 2. **Set Up Development Environment**

docs/src/chapter-13-community/ide-extensions.md

@@ -1,53 +1,52 @@
-# IDE Extensions
+# IDEs
 
-BotServer provides extensions and plugins for modern code editors to enhance the development experience with BASIC scripts, bot configurations, and platform integration.
+General Bots supports development with any text editor or IDE. Choose the one that works best for your workflow.
 
-## Zed Editor (Recommended)
+## Zed Editor (Best for Rust Development)
 
-Zed is a high-performance, collaborative code editor built for the modern developer.
+Zed is a high-performance, collaborative code editor that excels at Rust development and is recommended for working with General Bots core.
+
+### Why Zed?
+- Native Rust support with excellent syntax highlighting
+- Fast performance and minimal resource usage
+- Built-in collaboration features
+- Modern, clean interface
 
 ### Installation
 
 ```bash
 # Install Zed
 curl https://zed.dev/install.sh | sh
-
-# Install BotServer extension
-zed --install-extension botserver
 ```
 
-### Features
+## Other Popular IDEs
 
-#### Syntax Highlighting
+You can use any IDE or text editor you prefer:
-- BASIC keywords and functions
-- Configuration CSV files
-- Bot package structure recognition
-- Theme CSS variables
 
-#### Language Server Protocol (LSP)
+### Visual Studio Code
+- Extensive extension marketplace
+- Good BASIC syntax highlighting with custom extensions
+- Integrated terminal for running General Bots
+- Git integration
 
-Configure in `~/.config/zed/settings.json`:
+### IntelliJ IDEA / RustRover
-```json
+- Excellent Rust support
-{
+- Powerful refactoring tools
-  "lsp": {
+- Database tools for PostgreSQL integration
-    "botserver": {
-      "binary": {
-        "path": "/usr/local/bin/botserver",
-        "arguments": ["--lsp"]
-      },
-      "initialization_options": {
-        "bot": "default",
-        "enableDebug": true
-      }
-    }
-  }
-}
-```
 
-#### Key Bindings
+### Neovim
+- Lightweight and fast
+- Highly customizable
+- Terminal-based workflow
 
-Add to `~/.config/zed/keymap.json`:
+### Sublime Text
-```json
+- Fast and responsive
+- Multiple cursors and powerful search
+- Customizable syntax highlighting
+
+## BASIC Script Support
+
+For editing `.bas` files (General Bots dialog scripts):
 {
   "bindings": {
     "cmd-shift-b": "botserver:run-script",

docs/src/chapter-13-community/setup.md

@@ -1,6 +1,6 @@
 # Development Setup
 
-This guide covers setting up a development environment for contributing to BotServer.
+This guide covers setting up a development environment for contributing to General Bots.
 
 ## Prerequisites
 
@@ -11,14 +11,7 @@ This guide covers setting up a development environment for contributing to BotSe
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   ```
 
-- **PostgreSQL**: 14 or later
+- **PostgreSQL**: Installed automatically during bootstrap
-  ```bash
-  # Ubuntu/Debian
-  sudo apt-get install postgresql postgresql-contrib
-  
-  # macOS
-  brew install postgresql
-  ```
 
 - **Git**: For version control
   ```bash
@@ -37,17 +30,16 @@ This guide covers setting up a development environment for contributing to BotSe
 
 ```bash
 git clone https://github.com/GeneralBots/BotServer.git
-cd BotServer
+cd botserver
 ```
 
 ### 2. Environment Setup
 
-Create a `.env` file in the project root:
+The `.env` file is created automatically during bootstrap with secure random credentials. No manual configuration needed.
 
 ```bash
-DATABASE_URL=postgres://gbuser:password@localhost:5432/botserver
+# Bootstrap creates everything automatically
-DRIVE_SERVER=http://localhost:9000
+./botserver
-DRIVE_ACCESSKEY=minioadmin
 DRIVE_SECRET=minioadmin
 SERVER_HOST=127.0.0.1
 SERVER_PORT=8080
@@ -153,8 +145,8 @@ If bootstrap doesn't create the database:
 psql -U postgres
 
 # Create user and database
-CREATE USER gbuser WITH PASSWORD 'your_password';
+CREATE USER gbuser WITH PASSWORD 'SecurePassword123!';
-CREATE DATABASE botserver OWNER gbuser;
+CREATE DATABASE generalbots OWNER gbuser;
 \q
 ```
 
@@ -234,13 +226,12 @@ ssh user@server 'tmux new -s botserver'
 
 ## Debugging
 
-### Enable Debug Logging
 ### Debug Mode
 
 Run with verbose output to troubleshoot issues:
 
 ```bash
-cargo run
+RUST_LOG=trace cargo run
 ```
 
 Check logs in the console output for debugging information.

docs/src/contact/README.md

@@ -0,0 +1,61 @@
+# Contact
+
+## Get in Touch
+
+General Bots has been powering conversational AI solutions since 2018. We're here to help you build intelligent automation and enhanced customer engagement.
+
+### Support
+
+For technical support and documentation:
+- **Documentation**: [https://pragmatismo.com.br](https://pragmatismo.com.br)
+- **GitHub**: [https://github.com/GeneralBots](https://github.com/GeneralBots)
+- **Email**: support@pragmatismo.com.br
+
+### Business Inquiries
+
+Interested in implementing General Bots for your organization?
+
+**Pragmatismo Inovações Ltda.**  
+Avenida Rio Branco, 177, Sala 201 a 2201  
+Rio de Janeiro - Brasil  
+CNPJ: 40.293.841/0001-59  
+
+📞 **Phone**: +55 21 4040-2160 (24h)  
+📧 **Email**: info@pragmatismo.com.br  
+🌐 **Website**: [pragmatismo.com.br](https://pragmatismo.com.br)
+
+### Schedule a Demo
+
+Want to see General Bots in action? Our team can demonstrate:
+- Custom bot development
+- LLM integration
+- Knowledge base setup
+- Multi-channel deployment
+- Enterprise automation
+
+[Schedule a meeting](https://calendly.com/pragmatismo) to explore how General Bots can transform your business operations.
+
+### Data Protection
+
+**Data Protection Officer (DPO)**  
+Rodrigo Rodriguez  
+📧 security@pragmatismo.com.br
+
+### Open Source Community
+
+General Bots is open source and we welcome contributions:
+- Report issues on GitHub
+- Submit pull requests
+- Join discussions
+- Share your use cases
+
+### Legal
+
+- [Terms of Service](/terms)
+- [Privacy Policy](/privacy)
+- DUNS Number: 926754884
+
+---
+
+*General Bots® - Enterprise conversational AI platform*  
+*Copyright © 2016-2025 Pragmatismo Inovações Ltda.*

docs/src/glossary.md

@@ -1,6 +1,6 @@
 # Glossary
 
-Quick lookup for BotServer terms. If you're lost, start here.
+Quick lookup for General Bots terms. If you're lost, start here.
 
 ## A
 
@@ -10,12 +10,14 @@ Quick lookup for BotServer terms. If you're lost, start here.
 
 ## B
 
-**BASIC** - Yes, that programming language from 1964. We brought it back because `TALK "Hello"` beats `await ctx.send()` any day. Powers all conversation scripts.
+**BASIC** - Yes, that programming language from 1964. We brought it back because `TALK "Hello"` beats `await ctx.send()` any day. Powers all conversation scripts. Used since 2018 in production systems.
 
 **Bot Package** - A folder ending in `.gbai` containing everything to run a bot. Scripts, documents, config. That's it. Copy folder = deploy bot.
 
 **BotSession** - The conversation between user and bot. Remembers everything - who you are, what you said, where you left off. Persists to database, cached for speed.
 
+**Bootstrap** - Initial setup process that automatically installs all dependencies. Runs on first launch, creates configuration, sets up database, configures services.
+
 ## C
 
 **Collection** - A folder of documents in `.gbkb/` that becomes searchable knowledge. Drop PDFs in `policies/`, bot answers policy questions. Zero configuration.
@@ -48,6 +50,96 @@ Quick lookup for BotServer terms. If you're lost, start here.
 
 **.gbtheme** - Optional UI customization. CSS files, images, HTML templates. Most bots don't need this.
 
+**.gbdrive** - File storage configuration. Maps to Drive (S3-compatible) buckets for document management.
+
+**General Bots** - The enterprise conversational AI platform. Combines LLMs with structured dialogs, knowledge bases, and multi-channel support.
+
+## H
+
+**HEAR** - BASIC keyword to get user input. `answer = HEAR "What's your name?"` waits for response.
+
+**Hot Reload** - Changes to BASIC scripts apply immediately. No restart needed. Edit, save, test - instant feedback loop.
+
+## I
+
+**Installer** - Component that auto-configures services. Manages PostgreSQL, Cache, Drive, Directory Service, LLM servers. Everything runs locally.
+
+**Intent** - What the user wants to do. Detected from natural language. "I want to reset my password" → password_reset intent.
+
+## K
+
+**Knowledge Base** - Documents that become searchable answers. PDFs, Word files, web pages. Automatically chunked, embedded, and indexed for semantic search.
+
+## L
+
+**LLM** - Large Language Model. The AI brain. Default uses llama.cpp with GGUF models. Supports OpenAI, Anthropic, local models.
+
+**Local-First** - Everything runs on your machine. No cloud dependencies. Database, storage, LLM - all local. Privacy by default.
+
+## M
+
+**Memory** - Bot and user memory storage. `SET BOT MEMORY "key", "value"` persists data. `GET BOT MEMORY "key"` retrieves it.
+
+**Multi-Channel** - Same bot works everywhere. WhatsApp, Teams, Web, API. Write once, deploy anywhere.
+
+## O
+
+**OIDC** - OpenID Connect authentication. Handled by Directory Service (Zitadel). No passwords stored in General Bots.
+
+## P
+
+**Package Manager** - System that installs bot packages. Drop `.gbai` folder, it's automatically loaded. Remove folder, bot stops.
+
+**PostgreSQL** - The database. Stores users, sessions, messages, memory. Auto-installed, auto-configured. Just works.
+
+**Pragmatismo** - Company behind General Bots. Brazilian software consultancy. Building bots since 2016.
+
+## Q
+
+**Qdrant** - Vector database for semantic search. Optional component for large-scale knowledge bases. Faster than PostgreSQL pgvector for millions of documents.
+
+## R
+
+**REPL** - Read-Eval-Print Loop. Interactive BASIC console for testing. Type commands, see results immediately.
+
+## S
+
+**Semantic Search** - Finding by meaning, not keywords. "How do I change my password?" finds "reset credentials" documentation.
+
+**Session** - Active conversation state. Tracks user, bot, context, memory. Expires after inactivity. Stored in PostgreSQL, cached in memory.
+
+**SET CONTEXT** - BASIC command to add information to LLM context. `SET CONTEXT "User is premium customer"` influences all responses.
+
+## T
+
+**TALK** - BASIC keyword for bot output. `TALK "Hello!"` sends message to user. Supports markdown, images, cards.
+
+**Token** - Unit of text for LLMs. Roughly 4 characters. Context windows measured in tokens. GPT-4: 8k tokens. Local models: 4k typically.
+
+**Tool** - Function the bot can call. Defined in BASIC with parameters. `PARAM "city"` then `weather = GET "weather"` calls weather API.
+
+## U
+
+**USE KB** - BASIC command to activate knowledge base. `USE KB "policies"` makes policy documents searchable in conversation.
+
+**USE TOOL** - Activate a tool for LLM to use. `USE TOOL "calculator"` lets bot do math.
+
+## V
+
+**Valkey** - Redis-compatible cache. Stores sessions, temporary data. Faster than database for frequently accessed data.
+
+**Vector** - Mathematical representation of text meaning. Used for semantic search. Created by embedding models.
+
+## W
+
+**WebSocket** - Real-time connection for chat. Enables streaming responses, live updates. No polling needed.
+
+**Workflow** - Sequence of dialog steps. Login → Verify → Action → Confirm. Defined in BASIC, no complex orchestration.
+
+## Z
+
+**Zitadel** - Current Directory Service implementation. Handles authentication, users, permissions. Can be replaced with Keycloak or other OIDC providers.
+
 ## H
 
 **HEAR** - BASIC keyword to get user input. `name = HEAR` waits for user to type, stores response in variable.
@@ -144,6 +236,6 @@ Quick lookup for BotServer terms. If you're lost, start here.
 
 **"Is BASIC really BASIC?"** - Inspired by BASIC, not strict implementation. Simpler, focused on conversations.
 
-**"Can I use TypeScript/Python/etc?"** - No. BASIC only for conversation logic. Extend core in Rust if needed.
+**"Can I use TypeScript/Python/etc?"** - BASIC is used for conversation logic. However, you can integrate with any language through APIs. See [API documentation](./chapter-10-api/README.md) for REST endpoints and integration options.
 
 **"Is it production-ready?"** - Yes. Used in production since 2016 (earlier versions), current Rust version since 2023.