Archimedes 3.0: a personal-assistant application with Discord as a channel

[HiLleywyn]

Summary

A hard pivot from "Discord bot with AI features" to a personal-assistant application that lives in Discord. The agent is lifted out of the Discord cog into a coherent application layer (arch/), and Discord becomes a pluggable channel (channels/) following the session-keyed routing pattern from the OpenClaw channels reference. Same agent core could power a web, voice or CLI channel without rewriting any of the assistant logic.

Six headline features land as first-class concepts:

• Soul -- editable system-prompt persona with named presets (default, short, tutor, creative, expert), persisted in the database, switchable at runtime.
• Heartbeat -- optional autonomous self-check loop with an active-hours window and recent-activity log.
• Scheduler -- durable cron and oneshot tasks that survive restarts and fire back into the channel that scheduled them.
• MCP -- streamable HTTP and stdio Model Context Protocol client. Servers declared in env or added live; their tools bridge into the agent registry.
• Dynamic UI -- channel-agnostic Card / Section / StatTile / Button / Suggestion primitives. Discord renders as embeds plus interactive views; plaintext channels get a sensible fallback.
• Service Chain -- ordered model providers with per-provider circuit breakers and explicit fallback semantics.

Plus four built-in tools (arch.time, arch.location, arch.fetch_url, arch.open_url) and a focused, owner-only .app command group covering every 3.0 feature without leaving Discord.

Architecture

                  ArchAgent (arch/core.py)
                       ▲
                       │ handle(text, ctx) -> ArchResponse
        ┌──────────────┼──────────────┐
        │              │              │
  DiscordChannel    (web)         (cli, voice)

• arch/ -- the application: Soul, Heartbeat, Scheduler, MCP, Memories, Services, Dynamic UI, built-in tools, config.
• channels/ -- the transport abstraction: base Channel, Discord adapter, policy evaluator, session-key derivation, streaming preview, embed renderer.
• cogs/arch_app.py -- the .app operator command group.
• docs/architecture.md -- the full picture.

Tests

237 offline tests pass, including 59 new ones covering soul presets, heartbeat windowing, cron evaluation, oneshot delay parsing, dynamic UI builders, service-chain fallback and circuit-breaker behaviour, MCP spec parsing and registry bookkeeping, session-key derivation, and the DM/guild policy evaluator.

Backwards compatibility

Every new env var defaults to a no-op so an unchanged 2.x deployment behaves exactly as before. Existing tables, the Lua plugin runtime, the Node sidecar, cogs/chat, and ai/tools all keep their place; the application layer wraps them rather than replacing them.

Database additions (all idempotent)

archimedes_soul, archimedes_heartbeat_log, archimedes_scheduled_tasks, archimedes_mcp_servers, archimedes_settings.

Test plan

• pytest tests/ -- 237 passed, no failures.
• python -c "from arch import ArchAgent, Card, ArchResponse, Heartbeat, Scheduler, ServiceChain, SoulStore, MCPRegistry" -- clean.
• python -c "import channels.discord_channel; import cogs.arch_app" -- clean.
• ArchConfig.from_env() parses every documented ARCHIMEDES_* and DISCORD_*_POLICY env var.
• ServiceChain.from_specs correctly builds the multi-provider chain from comma-separated ARCHIMEDES_SERVICES.
• _parse_mcp handles HTTP, stdio and rejects unknown schemes silently.
• No em-dashes, en-dashes or Unicode minus signs in any new source file.
• End-to-end smoke against a live Discord token and PostgreSQL (manual, post-merge).

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
archimedes	Error		May 20, 2026 6:08am