Skip to main content

Architecture Overview

Nova is an agentic operations platform for email, calendar, and contacts.

Core Runtime​

Nova now runs on an OpenAI Agents SDK-first kernel behind a task orchestrator gateway.

  • TaskOrchestratorService is the orchestration source-of-truth for taskful instructions.
  • agent-v2 remains the execution kernel collaborator for tool planning/execution and approvals.
  • Every channel (API, Telegram, Dashboard worker) uses the same orchestrator semantics.
  • Task lifecycle and thread history are append-only and auditable.

Tool Boundary​

Google capabilities are executed through MCP tools:

  • google_gmail.*
  • google_calendar.*
  • google_contacts.*

This keeps provider execution behind a consistent, typed tool boundary.

Data Backbone​

Mongo is canonical for operational state and memory:

  • agent_runs_v2
  • agent_turns_v2
  • agent_tool_calls_v2
  • agent_approvals_v2
  • agent_memory_summaries_v2

Existing normalized inbox/calendar stores remain the substrate for retrieval and reasoning. Task lifecycle state is persisted separately with task-thread, task-link, and notification/digest collections.

Safety​

Nova enforces confirm-before-write by default for mutating actions.

  • write proposals are persisted
  • approvals are explicit
  • conversational yes/do it works only when exactly one pending approval exists
  • callback paths are replay-safe and ownership-checked

Product Direction​

Nova is not command-driven. Natural language is primary, with tool-grounded responses and auditable mutations.