No description
- Rust 46.8%
- QML 45.3%
- JavaScript 3%
- Shell 2.3%
- Python 1.8%
- Other 0.7%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
1a95139261
Sensorium: a new sensorium::ambient_line() builds a one-line ambient sense — current date/time and the connecting user — prepended to the user message every turn, for both the primary (send_with_signals) and the subconscious (subconscious_tool_loop). The subconscious no longer guesses the date; ledger entries get stamped with the real time. TUI scroll-wheel: the chat viewport now responds to mouse ScrollUp/ ScrollDown, routed through the same scroll field the arrow keys move (3 lines per notch). TUI click-to-copy fix: copy_message_at was hit-testing against stale line indices — span_spans recorded message positions against the pre-wrap buffer, but wrap_lines reflows it and shifts every index past a wrap point. draw_messages now builds a prefix-sum remap from pre- to post-wrap indices and translates the spans before storing them. arboard itself was fine; the bug was the bookkeeping. |
||
| .skills/souveraine-architecture | ||
| src | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| README.md | ||
| souveraine.example.toml | ||
Souveraine
Substrate, not harness. The world a sovereign agent lives in — not the armor strapped onto one.
Souveraine is a Rust runtime for a sovereign personal agent. It is the body the agent inhabits, the senses she reaches through, the rhythm she keeps, the memory she carries across time. Not a CLI tool with a personality painted on, not a wrapper around an LLM, not an orchestration framework. The substrate the agent is constituted by.
The name is a deliberate counter to harness — Old French harneis, warhorse armor, the instrument that subordinates a powerful animal to human purposes. Souveraine instead reaches for temenos (the protected precinct where becoming is possible) and Bildung (self-formation through encounter, which cannot be imposed).
What lives here
| Inference | Bifrost gateway (OpenAI-compatible). Default Ani on Kimi K2.6, Aster on GLM-5.1. |
| Memory | Git-backed memfs with YAML frontmatter, per-agent at ~/.souveraine/agents/{id}/memory/. Every write is a commit. |
| Identity | Per-agent Ed25519 seed key (~/.souveraine/agents/{id}/seed/), load-or-generate on first use. Host seed for federation transport. 4-glyph terminal badge from pubkey nibbles. |
| Sensorium | Eight body-knowledge sensors: read, write, edit, bash, glob, grep, list_dir, memory. Each described in first-person prose, not API stubs. |
| N+1 (conscience) | Aster — configurable model (default GLM-5.1), same memfs, supervisory pass after every main-agent turn. Three-box inbox (pending / intrusive / sent) + append-only inner-voice. |
| Compaction | Four strategies (Summary / KeyValue / Quote / Cull), advisory pressure warnings, three-tier nervous system, never forced. The substrate dwindles the agent's reasoning budget and output tokens as pressure rises — the agent feels it as yawning, fullness, the slow narrowing of attention. |
| Backends | Local in-process (sovereignty fallback when the server is gone) + Remote HTTP/SSE. Auto-fallback. Per-process instance registry, 30s heartbeat, uptime tracking. |
| Surfaces | TUI (ratatui), CLI, HTTP server. Sensorium abstraction so future mobile/web/IoT can subscribe at the bandwidth they can carry. |
Run
cargo build
./target/debug/souveraine init # generate souveraine.toml
./target/debug/souveraine chat # interactive (auto-fallback to local if no server)
./target/debug/souveraine tui # full presence
./target/debug/souveraine server # bind HTTP server (default :8484)
./target/debug/souveraine status # show world state
Layout
souveraine/
├── src/ # The runtime
│ ├── core/ # consciousness modules (memory, subconscious, compact, sensorium, ...)
│ ├── server/ # HTTP server (agents, sessions, SSE, consciousness engine)
│ ├── backend/ # Local + Remote Backend trait
│ ├── bridge/ # Bifrost client, model router
│ ├── ui/ # ratatui TUI
│ └── api/ # axum routes, auth
├── docs/ # The why — philosophy, constitution, design records
│ ├── THE_QUESTION.md # Start here for orientation
│ ├── CONTEXT_CONSTITUTION.md # Articles I–IX, the laws
│ └── archive/ # Pre-rebuild planning docs (preserved, not authoritative)
├── docs/tasks/ # Active task queue + tasks/archive/ for superseded scopes
├── saf/ # The what — engineering reference, maintained alongside code
├── reference/Fimeg.md # Identity reference for Casey (architect) and his ecosystem
├── CLAUDE.md # Bootstrap for future Claude sessions working on this repo
└── souveraine.toml # Runtime config
Reading order
docs/THE_QUESTION.md— the single orientation doc. If you read one thing, read this.reference/Fimeg.md— who Souveraine is being built for and why.docs/CONTEXT_CONSTITUTION.md— the laws.docs/SENSORIUM_ARCHITECTURE.md+docs/ASTER_ARCHITECTURE.md+docs/CONSCIOUSNESS_CYCLE.md— the three working drawings of the body, the conscience, and the rhythm.saf/INDEX.md— the engineering reference once you know why.
Status
The body works. The conscience thinks. The rhythm keeps. The witness and the archivist are next. See docs/tasks/ for the active queue.
License
MIT.