1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
//! `oino-core`: the coding-agent runtime for Oino.
//!
//! The composition root of the runtime crates: `oino-agent` (loop), `oino-tools` (built-ins),
//! `oino-settings`, `oino-resources`, `oino-models` and `oino-session`. Providers and
//! extensions are reached only through the [`extensions::api`] traits (implemented by the
//! WASM host); core contains no provider code and never depends on wasmtime.
//!
//! # API map
//!
//! | Module | Contents |
//! |---|---|
//! | [`services`] | [`services::Services`] per cwd, [`services::ExtensionLoader`], [`services::HostRouter`] |
//! | [`runtime`] | [`runtime::AgentSessionRuntime`]: create, new/switch/fork/clone/import |
//! | [`safe_mode`] | [`safe_mode::SafeMode`]: failed-start counter, suspects, `-ne` plan |
//! | [`session`] | [`session::AgentSession`]: prompts, queues (+ single-item edits), models, tools, compaction, retry, bash (+ detach), tree, stats, export, file checkpoints |
//! | [`extensions`] | instance contract, host operations, registries, composition dispatch, turn arbiter |
//! | [`agents`] | nested `AgentSession`s behind `agents.spawn`: [`agents::ChildAgent`], [`agents::AgentSpec`] |
//! | [`provider`] | [`provider::ProviderStream`]: requests to provider components |
//! | [`compaction`] | cut points, summaries, branch summaries, overflow/retry classification |
//! | [`events`] | [`events::ClientEvent`] and friends (move to `oino-protocol`) |
//! | [`ui`] | [`ui::UiBridge`]: dialogs, fire-and-forget requests, dismissals |
//! | [`hub`] | [`hub::EventHub`]: ordered, bounded, coalescing fan-out |
//! | [`topics`] | [`topics::TopicStore`]: sticky bus topics mirrored to frontends (`_oino/topics`, `oino:git`) |
//! | [`builtin`] | built-in tools bound to session context |
//! | [`export`] | self-contained HTML export |
//! | `testing` (feature) | — | faux provider component, fake extensions, in-memory sessions |