aion_server/assistant/
mod.rs

1//! The built-in assistant: a server-owned agent session, present the moment
2//! `aion server` runs.
3//!
4//! This is the ops-console doctrine applied to an agent. The console is
5//! compiled into the binary and served at `/` with no operator step; the
6//! assistant is the same — the agent harnesses ship in the binary as a
7//! catalogue ([`aion_integration_acp::catalogue`]), a session is opened from
8//! the console, and the server owns the harness process for its lifetime.
9//! There is no document to deploy, no worker to start, and no configuration to
10//! write: a stock `cargo install aion-cli` therefore carries the assistant.
11//!
12//! # The brain is a seam, not a dependency
13//!
14//! Nothing here names one agent. WHICH harness serves a session is the
15//! operator's pick from the shipped catalogue, made per session in the console
16//! and remembered per caller; every launch setting is the catalogue entry's
17//! own. This module describes the surface, mints the session credential, and
18//! drives the process; it never decides which brain answers.
19//!
20//! # What lives here
21//!
22//! - [`descriptor`] — what `GET /assistant` says: the catalogue with this
23//!   machine's availability reading, the tool wiring a session is handed,
24//!   whether sessions can be opened, and the reading caller's grant standing.
25//! - [`sessions`] — the live harness processes, their durable transcripts, and
26//!   the surface that drives them.
27//! - [`mcp`] — the assistant-only MCP route: the tools about one conversation,
28//!   behind that session's own server-minted bearer.
29//! - `grounding` — the version-true Aion and AWL reference pack every spawned
30//!   agent is pointed at.
31
32/// The grounding pack a spawned agent reads Aion and AWL out of.
33pub(crate) mod grounding;
34#[cfg(test)]
35mod grounding_gate_tests;
36
37pub mod descriptor;
38
39pub use descriptor::{
40    AssistantDescriptor, AssistantGrantDescriptor, AssistantHarnessDescriptor,
41    AssistantOwnToolsDescriptor, AssistantSessionTokenDescriptor, AssistantToolsDescriptor,
42    describe,
43};
44
45/// The assistant-only MCP route: the tools about one conversation, behind the
46/// session's own bearer.
47pub mod mcp;
48
49/// Server-owned assistant sessions: the live harness processes, their durable
50/// transcripts, and the surface that drives them.
51pub mod sessions;
aion_server/assistant/mod.rs

aion_server/assistant/
mod.rs
