L1-L4 Mentor Agent Suite

type: architecture

description: Tiered intelligence system where voice agents can discuss, teach, guide, and act on behalf of customers across any platform. Four mentor modes (DISCUSS/TEACH/GUIDE/ACT) gated by subscription tier.


L1 Basic Mentor

description: $497 AUD/mo. Text-only. DISCUSS + TEACH modes. Gemini 2.5 Flash. 30-day memory. 5 tools. 99.2% margin at ~$4 COGS. Platform Q&A and step-by-step tutorials. No voice, no actions.

mentor_modes: discuss teach


L2 Digital Employee

description: $697 AUD/mo. Voice + Text. DISCUSS + TEACH + GUIDE modes. Gemini 2.5 Flash via Telnyx Eucalyptus. 60-day memory with entity extraction. 8 tools. 96.8% margin at ~$22 COGS. Real-time voice guidance while user operates platform.

mentor_modes: discuss teach guide

voice: telnyx-eucalyptus


L3 Domain Expert ($997)

description: $997 AUD/mo. Voice + API Actions. All 4 mentor modes including ACT via API/MCP. Gemini 2.5 Pro. 90-day memory with KG. 15 tools including GHL MCP. 94.9% margin at ~$51 COGS. Agent executes platform actions on customer's behalf.

mentor_modes: discuss teach guide act


L3 Domain Master ($1,497)

description: $1,497 AUD/mo. Full API Actions + RLM. All 4 mentor modes with full MCP tool suite. Gemini 2.5 Pro. Unlimited memory with full RLM bloodstream. 25 tools. 93.5% margin at ~$97 COGS. Deep automation with learning memory.


L4 Executive ($2,997)

description: $2,997 AUD/mo. Full autonomy including browser automation via Gemini 3 Flash vision. All mentor modes + BROWSER ACT. Gemini 2.5 Pro + Gemini 3 Flash. Unlimited memory. 32+ tools. 92.9% margin at ~$211 COGS. The never-touch-the-keyboard tier.

mentor_modes: discuss teach guide act browser_act


L4 Executive Plus ($4,997)

description: $4,997 AUD/mo. Everything in L4 + increased browser budget (500 tasks/mo), dedicated Telnyx assistant, priority inference queue, white-label + custom domain. 94.2% margin at ~$291 COGS.


Mentor Mode State Machine

type: concept

description: Four-mode state machine: DISCUSS (Q&A) -> TEACH (tutorials) -> GUIDE (real-time voice co-pilot) -> ACT (execute on behalf). Mode detection via lightweight classifier (<50ms). Transitions are seamless within conversation. Tier restrictions gate which modes are available.

modes: discuss teach guide act


Platform Knowledge Ingestion Pipeline

description: 5-phase pipeline: SCRAPE (docs, forums, YouTube) -> STRUCTURE (entity extraction) -> EMBED (Qdrant 768-dim) -> VALIDATE (80% accuracy gate via automated quiz) -> DEPLOY (inject into SubAIVA). ~10,000 vectors per major platform. KB not deployed until accuracy threshold met.

phases: scrape structure embed validate deploy


100/1000 Interaction Learning Curve

description: SubAIVA intelligence progression: 0-10 interactions (base KB, generic) -> 50-100 (customer-specific shortcuts) -> 100-500 (genuine platform expert) -> 500-1000 (exceeds most human consultants) -> 1000+ (indispensable, switching cost exceeds subscription). This IS the memory lock-in moat.


Upgrade Pull Mechanism

description: Natural tier upgrade pull: agent detects when customer requests capability above their tier, delivers best current-tier response PLUS natural upsell. Not pushy — demonstrates value gap. L1->L2: voice guidance. L2->L3: API actions. L3->L4: browser automation. Stripe one-click upgrade, tools unlock in 60 seconds.


Gemini 3 Flash Browser Agent (L4)

description: L4 differentiator: Gemini 3 Flash with native vision navigates platform portals without API. Flow: customer voice request -> credential vault retrieval -> Gemini 3 Flash opens browser -> navigates portal -> executes action -> screenshot verification -> voice narration of progress. Fallback: Playwright MCP + Gemini 2.5 Flash vision.

fallback: playwright-mcp


Voice + Browser Narration Bridge (L4)

description: L4 capability where voice agent (Gemini 2.5 Pro via Telnyx) narrates browser agent (Gemini 3 Flash) actions in real-time. Communication via Redis pub/sub. Voice agent says 'Opening ServiceM8 now...' as browser navigates. Customer can interrupt at any time. Latency target: <500ms between browser event and voice narration.


Network Effect Flywheel

description: Every SubAIVA interaction generates anonymised patterns that flow UP to Queen AIVA nightly (3 AM AEST). Queen generates improved base templates that flow DOWN to all SubAIVAs. More customers -> smarter Queen -> better SubAIVAs -> better product -> more customers. At 200+ SubAIVAs: ~500K patterns/year, world-class AU business AI.


L1-L4 Mentor Mode Moat

description: No competitor offers a voice agent that can: (1) answer platform questions, (2) walk through tutorials, (3) guide in real-time via voice, (4) execute API actions, (5) navigate portals via browser, (6) learn preferences, (7) get smarter from entire network. This combination is unique. Memory lock-in + network effects + tiered capability = compound moat.

competitors_compared: generic_chatbot vapi synthflow intercom drift


type: relationship

name: L1-L4 Suite depends on SubAIVA Provisioning

description: Mentor engine extends the existing SubAIVA provisioning pipeline with mentor-specific initialization (Steps 10-13): mentor state record, platform overlay loading, credential vault setup, mentor welcome flow.


L1-L4 Suite feeds Queen AIVA learning

description: All SubAIVA mentor interactions generate anonymised patterns that flow UP to Queen AIVA. Queen's improved templates flow DOWN. Raw customer data NEVER leaves tenant namespace. This is the network effect flywheel.


L1-L4 Implementation Roadmap

5 phases over 12 weeks: Phase 1 (W1-2) Foundation — mode classifier, state machine, upgrade engine. Phase 2 (W3-4) L1+L2 launch — text/voice mentor, GHL KB. Phase 3 (W5-6) L3 launch — action router, GHL MCP, credential vault. Phase 4 (W7-10) L4 launch — browser agent, narration bridge, screenshot verification. Phase 5 (W11-12) Network effects — pattern extraction, Queen ingestion, template propagation.


L1-L4 Margin Analysis

All tiers maintain 92-99% gross margin. L1: $4 COGS / $497 rev (99.2%). L2: $22 / $697 (96.8%). L3a: $51 / $997 (94.9%). L3b: $97 / $1,497 (93.5%). L4a: $211 / $2,997 (92.9%). L4b: $291 / $4,997 (94.2%). Primary cost drivers: LLM inference, Telnyx voice minutes, Gemini 3 Flash browser sessions.


L1-L4 Mentor Architecture Key Files

PRD: plans/L1_L4_MENTOR_AGENT_ARCHITECTURE.md. To build: core/mentor/mode_classifier.py, core/mentor/state_machine.py, core/mentor/upgrade_prompter.py, core/mentor/action_router.py, core/mentor/browser_agent.py, core/mentor/knowledge_ingester.py, core/mentor/quiz_validator.py, core/mentor/narration_bridge.py, core/provisioning/credential_vault.py.