Pathfinder — 8-Layer Architecture Map

OpenNextFrontier · Technical Reference

🦅 Pathfinder
8-Layer Stack Map

v0.1.5 · APRIL 2026

All 9 blocks complete. Tauri 2 · Rust · React 19 · SQLite. Your Self-Sovereign AI Agent.

Built & working

★ Pathfinder-unique

Planned — next blocks

LAYER 01
Runtime
Host platform, OS integration, packaging, distribution
🦅 Pathfinder v0.1.5
★ Tauri 2 — native desktop appRust backend — memory safe, zero GCReact 19 + TypeScript frontendWindows 11 · macOS · LinuxNSIS installer · single .exe★ First-run environment scan + tier auto-detectAndroid — Block 10iOS — future
LAYER 02
Gateways
Channels, external connectivity, multi-modal inputs
🦅 Pathfinder v0.1.5
Tauri desktop window — primary UITelegram gateway — teloxide · polling mode · no public IP★ Gateway trait — pluggable transportsPhoto · voice · document via Telegramn8n webhook routing — intent-basedSignal gateway — trait readyDiscord · IRC · Meshtastic — future
LAYER 03
Protocol
API contracts, inter-agent comms, intent tokens
🦅 Pathfinder v0.1.5
Anthropic Messages APIOpenAI Chat Completions APIGoogle Gemini APIOllama local REST APIBitNet local API★ Intent token protocol — memory: journal: note: find: card: password: doc:★ n8n chunky payload — intent + query + timestamp + persona contextPathfinder as MCP server — Feature 19
LAYER 04
Tooling
Tools the agent can invoke — search, calendar, documents
🦅 Pathfinder v0.1.5
★ Tool factory — tier + key gated, community extensibleWeb search — Serper API · confirmed liveDocument search — BM25 keyword · knowledge_chunks tablen8n workflow executor — 400+ tools via visual workflowGoogle Calendar read — via n8n OAuthCalculator — built-in, no API key★ Agent loop short-circuit — no tool overhead when tools offGmail — OAuth reconnect pendingBrowser automation — future
LAYER 05
Cognition
LLM routing, agent loops, reasoning, tier enforcement
🦅 Pathfinder v0.1.5
★ Multi-persona cognition — per-persona LLM, system prompt, tone, tier★ Agent loop — up to 5 iterations · dedup · unknown tool fallback★ Brace-matching parser fallback — qwen3 robustness · 10 unit testsClaude Sonnet 4.6 / Opus 4.6 / Haiku 4.5GPT-4o / GPT-4o miniGemini 2.5 Flash / 2.0 FlashOllama — qwen3 (preferred) · llama3.2 · gemma4BitNet — 1-bit CPU inferenceTier enforcement in Rust — architectural, not config
LAYER 06
Memory
Storage, retrieval, context injection, knowledge base
🦅 Pathfinder v0.1.5
★ SQLite WAL — rusqlite 0.37 bundled · no system dep★ AES-256-GCM vault — PBKDF2 100k iterations · zeroize on drop★ Vault key resolution chain — shared → persona override → blockedmemories table — persona-scoped · tagged · sensitivity tieredknowledge_chunks — BM25 search · docs/ auto-indexed on startupTrailhead doc context injection — RAG for Pathfinder itselfCredentials table — passwords in vault · pfcreds export/importSave to memory from any message · #tag auto-fill · export to .mdVector semantic search — future
LAYER 07
Application
UI, automation, scheduling, skills pipeline
🦅 Pathfinder v0.1.5
★ Multi-persona identity — emoji · color · model · system prompt · tier★ Skills system — folder pipeline 00_references → 01_input → 02_process → 03_output★ Scheduler — cron auto-fire · one-shot · Telegram delivery · job run historyStreaming chat — all 5 providersConversation sidebar — auto-title · delete · persona emojiSettings — 11 panels · registry-drivenLogs panel — tool calls · job runs · SQL queries · web searchesTrailhead persona — pre-installed Eagle · doc-aware · cannot deleteFirst-run wizard — tier auto-detect · consent · ToSSkill in-app editor — nextDynamic job rescheduling — next
LAYER 08
Governance
Privacy, security, key mgmt, data ownership, sovereignty
🦅 Pathfinder v0.1.5
★ "By default, nothing leaves your machine" — architecture, not policy★ Dual license — AGPL v3 open source + commercialAPI keys — vault key shared.keys.{provider} · never in DB4-tier security model — Settler · Scout · Pioneer · ExplorerSettler/Scout — local LLM only · cloud blocked architecturallyPer-persona key overrides — resolution chain UIMedia capture — caption-slug filenames · JSON sidecars · memory entriesCredentials manager — AES vault · pfcreds format · CSV import/exportBlockchain ledger — gates community contributions (Block 12)Hardware wallet signing — Explorer tier

★ PATHFINDER'S DEFINING ARCHITECTURE — LAYERS 5, 6 & 8

Multi-Persona Cognition + Sovereign Storage + Architectural Privacy

Pathfinder is the only personal AI with a multi-persona identity layer — one installation that is fundamentally different cognitive agents depending on context. Me-Corporate routes to Claude Opus with formal tone. Me-Personal runs qwen3 locally with casual warmth. Me-Hobby uses BitNet at zero API cost. Each has its own system prompt, tier enforcement, model selection, and key overrides.

At Layer 6, all storage is sovereign by architecture. The vault is AES-256-GCM with PBKDF2 — the key never touches disk. SQLite stores conversations, memories, credentials, and knowledge chunks locally. Nothing is logged by a third party. The vault key resolution chain means cloud keys stay encrypted even when local AI is running.

At Layer 8, sovereignty is enforced, not promised. Settler and Scout tiers are blocked from cloud LLMs at the Rust command layer — not by a config flag that could be bypassed, but by architecture. The claim is scoped: web search, n8n, and cloud LLMs explicitly send data externally when the user chooses them. Everything else stays on your machine.