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.