Expand description
App-facing embedding facade for Lash.
lash is intentionally a small layer above the lower-level
lash-core runtime crate. Host applications own providers, persistence,
app state, HTTP protocols, auth, and frontend streaming; this crate
owns only the ergonomic core/session/turn API.
Every public name has exactly one home. The crate root carries the daily
core/session/turn path; each domain module (tools, persistence,
plugins, observe, triggers, …) carries its own
vocabulary. prelude mirrors the crate root exactly.
Re-exports§
pub use crate::admin::AdvancedToolAdmin;pub use crate::admin::Completions;pub use crate::admin::CoreTriggerAdmin;pub use crate::admin::PluginActions;pub use crate::admin::SessionCommandAdmin;pub use crate::admin::SessionTriggerAdmin;pub use crate::admin::ToolAdmin;pub use crate::turn::QueuedTurnBuilder;pub use crate::turn::TurnActivityFanout;pub use crate::turn::TurnBuilder;pub use crate::turn::TurnOutput;pub use crate::turn::TurnResult;pub use crate::turn::TurnStream;pub use crate::turn::message_role;pub use crate::turn::message_text;
Modules§
- admin
- direct
- durability
- messages
- observe
- Session observation: cursors, resumable event streams, and live replay
recovery for host frontends. Entry point:
LashSession::observe/ObservableSession. - persistence
- plugins
- prelude
- The prelude is exactly the crate root:
use lash::prelude::*;brings in the daily core/session/turn vocabulary and nothing from the domain modules. - process
- prompt
- provider
- remote
- runtime
- tools
- tracing
- triggers
- Triggers and subscriptions: declaring event sources, emitting occurrences,
and inspecting trigger subscriptions. Entry points:
LashCore::triggersandLashSession::triggers. - turn
- usage
- Token usage tracking surfaces.
Structs§
- Await
Event Key - Cancellation
Token - Cooperative cancellation handle accepted by
TurnBuilder::cancel; re-exported so embedders cancel turns without depending ontokio-utilthemselves. A token which can be used to signal a cancellation request to one or more tasks. - Enqueue
Turn Builder - External
Completion Error - Lash
Core - Lash
Core Builder - Lash
Session - Model
Limits - Model
Spec - Observable
Session - Plugin
Stack - Session
Builder - Session
Command Receipt - Session
Config Patch - Session
Delete Report - Session
Spec - Reusable session configuration overlay.
- Standard
Core - Standard
Core Builder - Turn
Activity - App-facing semantic activity emitted during a turn.
- Turn
Activity Id - Stable identifier for a semantic turn activity.
- Turn
Input - Host-provided per-turn input.
Enums§
- Await
Event Wait Identity - Embed
Error - Input
Item - Host-provided per-turn input.
- Resolution
- Resolve
Outcome - Session
Command - Turn
Event - App-facing semantic event payload for a turn activity.
Traits§
- Plugin
Binding - Typed app-facing activation for an ordinary Lash plugin.
- Prompt
Layer Sink - Builder-agnostic prompt-layer mutation surface.
- Turn
Activity Sink