Skip to main content

Module assistant

Module assistant 

Source
Expand description

The built-in assistant: the embedded AWL document, its boot install, and the description the server serves of it. The built-in assistant: the aion authoring assistant ships INSIDE the server binary, present the moment aion server runs.

This is the ops-console doctrine applied to a workflow document. The console is compiled into the binary and served at / with no operator step; the assistant document (crates/aion-server/assistant-embed/assistant.awl) is compiled into the binary the same way, installed into the engine at boot, and described over /assistant. A stock cargo install aion-cli therefore carries the assistant — no repository checkout, no example crate, no hand deploy.

§The brain is a seam, not a dependency

Nothing here names an agent harness. The document declares one agent action on the default queue; WHICH agent serves that queue is the worker’s business (aion worker agent --harness …, norn today, ACP for external agents). This module installs the document and describes it; it neither spawns nor selects a brain.

§What the install will and will not do

[install::install_embedded_assistant] loads the embedded package into the engine ONLY when the catalog holds no version of the assistant workflow type at all — a fresh home. Loading a package re-points routing for its type (aion::Engine::load_package), so an unconditional boot install would silently steal the route from an operator’s deliberate rollback, on every restart. When any version is already resident the install stands down and says so, naming both hashes and the operator’s own cut verbs. The live cut is the operator’s act, never a side effect of a restart.

Re-exports§

pub use descriptor::AssistantDescriptor;
pub use descriptor::AssistantResidency;
pub use descriptor::AssistantSessionContract;
pub use descriptor::AssistantSignal;
pub use descriptor::describe;
pub use document::CONTINUE_END_FIELD;
pub use document::CONTINUE_MESSAGE_FIELD;
pub use document::CONTINUE_SIGNAL;
pub use document::EMBEDDED_ASSISTANT_DOCUMENT;
pub use document::EMBEDDED_ASSISTANT_FILENAME;
pub use document::EmbeddedAssistant;
pub use document::EmbeddedAssistantError;
pub use document::OBJECTIVE_INPUT;
pub use document::REPO_PATH_INPUT;
pub use document::STATUS_QUERY;
pub use document::embedded_assistant;
pub use install::AssistantInstall;
pub use install::install_embedded_assistant;
pub use install::install_embedded_assistant_for_server;

Modules§

descriptor
The served description of the embedded assistant: identity, contract, and current residency in the engine catalog. What the server says about the assistant it carries.
document
The embedded AWL document, its compiled identity, and its verified session contract. The embedded assistant document: its bytes, its compiled identity, and the session contract the operator verbs bind to.
install
Boot-time installation of the embedded document into the engine catalog. Boot-time installation of the embedded assistant into the engine catalog.