axllm 24.0.1

Generated Ax runtime library
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use axllm::runtime::quickjs::QuickJsCodeRuntime;
use axllm::{agent, AxCodeRuntime, AxError, AxResult};
use serde_json::json;

fn main() -> AxResult<()> {
    let mut runtime = QuickJsCodeRuntime::new()
        .with_runtime_policy(json!({"timeoutMs": 100, "maxSnapshotBytes": 64}));
    runtime.register_callable("search", |params| {
        Ok(json!({"answer": format!("result for {}", params["query"].as_str().unwrap_or(""))}))
    })?;
    runtime.register_callable("badTool", |_params| {
        Err(AxError::runtime("bad tool failed"))
    })?;

    let mut runner = agent("question:string -> answer:string")?;
    let step = runner.test(
        &mut runtime,
        "answer = inputs.question; final({ answer })",
        json!({"question": "quickjs"}),
        json!({}),
    )?;
    assert_eq!(step.payload["kind"], "final");
    assert_eq!(step.payload["result"]["args"][0]["answer"], "quickjs");

    let actor_step = runner.execute_actor_step(
        &mut runtime,
        "answer = inputs.question; final({ answer })",
        json!({"question": "quickjs"}),
        json!({}),
    )?;
    assert_eq!(actor_step.payload["kind"], "final");
    assert_eq!(runner.inspect_runtime()?["answer"], "quickjs");

    let snapshot = runner.export_session_state()?;
    assert_eq!(snapshot["bindings"]["answer"], "quickjs");
    runner.restore_session_state(json!({"bindings": {"answer": "patched"}}))?;
    assert_eq!(runner.inspect_runtime()?["answer"], "patched");

    let mut session = runtime.create_session(
        json!({
            "inputs": {"question": "host"},
            "marker": {"__ax_host_callable": true, "result": {"ok": true}}
        }),
        json!({"reservedNames": ["inputs", "final"]}),
    )?;
    assert_eq!(
        session
            .execute("askClarification('more?')", json!({}))?
            .payload["type"],
        "askClarification"
    );
    assert_eq!(
        session
            .execute("discover({topic: 'docs'})", json!({}))?
            .payload["kind"],
        "discover"
    );
    assert_eq!(
        session
            .execute("recall({query: 'state'})", json!({}))?
            .payload["kind"],
        "recall"
    );
    assert_eq!(
        session
            .execute("used('doc-1', 'needed')", json!({}))?
            .payload["kind"],
        "used"
    );
    assert_eq!(
        session.execute("reportSuccess('ok')", json!({}))?.payload["kind"],
        "status"
    );
    assert_eq!(
        session.execute("reportFailure('no')", json!({}))?.payload["kind"],
        "status"
    );
    assert_eq!(
        session
            .execute("guideAgent('try this')", json!({}))?
            .payload["type"],
        "guide_agent"
    );
    assert_eq!(
        session
            .execute("final(search({query: inputs.question}))", json!({}))?
            .payload["args"][0]["answer"],
        "result for host"
    );
    assert_eq!(
        session.execute("final(marker())", json!({}))?.payload["args"][0]["ok"],
        true
    );
    let failed = session.execute("final({error: badTool({}).error})", json!({}))?;
    assert_eq!(failed.payload["args"][0]["error"], "bad tool failed");
    assert_eq!(
        session
            .execute("throw new Error('boom')", json!({}))?
            .payload["error_category"],
        "runtime"
    );
    assert_eq!(
        session
            .execute("while (true) {}", json!({"timeoutMs": 1}))?
            .payload["error_category"],
        "timeout"
    );
    session.patch_globals(
        json!({"bindings": {"final": "blocked", "answer": "patched"}}),
        json!({}),
    )?;
    assert_ne!(session.inspect_globals(json!({}))?["final"], "blocked");
    assert_eq!(session.inspect_globals(json!({}))?["answer"], "patched");
    session.close()?;
    assert_eq!(
        session.execute("final({})", json!({}))?.payload["error_category"],
        "session_closed"
    );

    println!("rust-javascript-quickjs-profile-ok runtime-behavior-parity-ok");
    Ok(())
}