vifu-runtime 0.1.0

Small, stateful, embeddable Agent Runtime primitives for Vifu.
Documentation 
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
55
56
57
58
59
60
61

# vifu-runtime

`vifu-runtime` is the small, stateful execution kernel at the center of Vifu.
Most applications should depend on the `vifu` crate, which includes Runtime
support by default. This lower-level crate remains available for hosts that only
need the kernel implementation.

The crate uses Bevy App and ECS primitives without the renderer, windowing
stack, database, HTTP server, or Vifu Console.

## Use the public Vifu SDK

```toml
[dependencies]
vifu = "0.1"
```

## Embed a runtime

```rust
use vifu::runtime::prelude::*;

struct ApplicationPlugin;

impl Plugin for ApplicationPlugin {
    fn build(&self, app: &mut App) {
        app.add_systems(RuntimeSchedule, handle_commands);
    }
}

fn handle_commands(
    mut commands: ResMut<RuntimeCommandQueue>,
    mut events: ResMut<RuntimeEventQueue>,
    mut effects: ResMut<EffectRequestQueue>,
    mut state: ResMut<RuntimeState>,
) {
    for command in commands.drain() {
        state.value["lastCommand"] = json!(command.name);
        events.emit("command.accepted", json!({ "commandId": command.id }));
        effects.request("agent.invoke", command.payload);
    }
}

let mut runtime = HeadlessRuntime::new();
runtime.app_mut().add_plugins(ApplicationPlugin);

let advance = runtime.dispatch(RuntimeCommand::new(
    "command-1",
    "application.input",
    json!({ "text": "Hello" }),
));

assert_eq!(advance.snapshot.revision, 1);
```

The host executes requested effects and returns their results through
`HeadlessRuntime::complete_effect`. Persist `RuntimeSnapshot` when state must
survive restarts.

Vifu Server, Agent Gateway, PostgreSQL, and the web Console are separate
components in the [Vifu repository](https://github.com/vifudotdev/vifu).