axiom_engine 0.5.0

Axiom-TTT Inference Engine – Rust implementation using candle
Documentation
use std::time::Duration;

use axiom_engine::config::AxiomConfig;
use axiom_engine::inference::InferencePipeline;
use axiom_engine::poly_jit::{PolyJitEngine, PolyJitRunRequest};
use axiom_engine::server::{create_router, AppState};
use axiom_engine::solve::posix_shell;
use axum::body::{to_bytes, Body};
use axum::http::{Method, Request, StatusCode};
use candle_core::Device;
use serde_json::json;
use tower::ServiceExt;
use uuid::Uuid;

fn build_pipeline() -> InferencePipeline {
    let cfg = AxiomConfig {
        d_model: 16,
        n_layers: 1,
        vocab_size: 64,
        lr_inner: 1e-3,
        norm_eps: 1e-6,
    };
    InferencePipeline::new(cfg, Device::Cpu).expect("tiny pipeline must build")
}

async fn test_state() -> AppState {
    let pipeline = tokio::task::spawn_blocking(build_pipeline).await.unwrap();
    AppState::new(pipeline, "axiom-hypervisor-test".to_string())
}

#[tokio::test]
async fn vfs_mount_warm_read_populates_ttt_cache() {
    let root = std::env::temp_dir().join(format!("axiom-vfs-test-{}", Uuid::new_v4()));
    std::fs::create_dir_all(&root).unwrap();
    std::fs::write(
        root.join("lib.rs"),
        "pub struct HypervisorFixture { value: i32 }\nimpl HypervisorFixture { pub fn value(&self) -> i32 { self.value } }",
    )
    .unwrap();

    let state = test_state().await;
    let app = create_router(state.clone());
    let body = json!({
        "root": root.to_string_lossy(),
        "session_id": "hypervisor-vfs-session",
        "warm_paths": ["lib.rs"]
    });
    let req = Request::builder()
        .method(Method::POST)
        .uri("/v1/hypervisor/mount")
        .header("content-type", "application/json")
        .body(Body::from(body.to_string()))
        .unwrap();
    let resp = app.oneshot(req).await.unwrap();
    assert_eq!(resp.status(), StatusCode::OK);
    let bytes = to_bytes(resp.into_body(), usize::MAX).await.unwrap();
    let response: serde_json::Value = serde_json::from_slice(&bytes).unwrap();
    assert_eq!(response["mount"]["mode"], "user_loopback");
    assert_eq!(response["warmed"].as_array().unwrap().len(), 1);
    assert!(response["warmed"][0]["digest_tokens"].as_u64().unwrap() > 0);
    assert_eq!(state.ttt_sessions.len(), 1);

    let _ = std::fs::remove_dir_all(root);
}

#[tokio::test]
async fn jit_status_endpoint_reports_defaults() {
    let state = test_state().await;
    let app = create_router(state);
    let req = Request::builder()
        .method(Method::GET)
        .uri("/v1/hypervisor/jit_status")
        .body(Body::empty())
        .unwrap();
    let resp = app.oneshot(req).await.unwrap();
    assert_eq!(resp.status(), StatusCode::OK);
    let bytes = to_bytes(resp.into_body(), usize::MAX).await.unwrap();
    let response: serde_json::Value = serde_json::from_slice(&bytes).unwrap();
    assert_eq!(response["jit"]["total_runs"], 0);
    assert_eq!(response["vfs"]["mode"], "user_loopback");
}

#[tokio::test]
async fn poly_jit_repairs_faulted_script_and_finishes() {
    if !cfg!(windows) || std::process::Command::new("powershell").output().is_err() {
        return;
    }

    let root = std::env::temp_dir().join(format!("axiom-polyjit-test-{}", Uuid::new_v4()));
    std::fs::create_dir_all(&root).unwrap();
    let script = root.join("fault.ps1");
    std::fs::write(
        &script,
        "$source = Get-Content $PSCommandPath -Raw\nif ($source.Contains('AXIOM_POLYJIT_FIXTURE_FAIL')) { Write-Error 'runtime fault'; exit 1 }\nWrite-Output 'AXIOM_POLYJIT_FIXTURE_FAIL'\nexit 0\n",
    )
    .unwrap();

    let engine = PolyJitEngine::new(Duration::from_secs(20));
    let request = PolyJitRunRequest {
        session_id: "polyjit-session".to_string(),
        command: "powershell".to_string(),
        args: vec![
            "-NoProfile".into(),
            "-ExecutionPolicy".into(),
            "Bypass".into(),
            "-File".into(),
            script.display().to_string(),
        ],
        working_dir: Some(root.display().to_string()),
        source_path: Some(script.display().to_string()),
    };
    let mut diagnostics = Vec::new();
    let report = engine
        .run_with_feedback(request, |diag| {
            diagnostics.push(diag);
            async { Ok(()) }
        })
        .await
        .unwrap();

    assert!(report.passed);
    assert!(report.patched);
    assert_eq!(report.attempts, 2);
    assert_eq!(diagnostics.len(), 1);
    let patched = std::fs::read_to_string(&script).unwrap();
    assert!(patched.contains("AXIOM_POLYJIT_FIXTURE_PASS"));
    assert_eq!(engine.status().repaired_runs, 1);

    let _ = std::fs::remove_dir_all(root);
}

#[tokio::test]
async fn hypervisor_read_endpoint_absorbs_file_incrementally() {
    let root = std::env::temp_dir().join(format!("axiom-read-test-{}", Uuid::new_v4()));
    std::fs::create_dir_all(&root).unwrap();
    std::fs::write(root.join("a.rs"), "pub fn a() -> i32 { 1 }").unwrap();
    std::fs::write(root.join("b.rs"), "pub fn b() -> i32 { 2 }").unwrap();

    let app = create_router(test_state().await);
    // Mount first (no warm paths).
    let mount = app
        .clone()
        .oneshot(
            Request::builder()
                .method(Method::POST)
                .uri("/v1/hypervisor/mount")
                .header("content-type", "application/json")
                .body(Body::from(json!({"root": root.to_string_lossy()}).to_string()))
                .unwrap(),
        )
        .await
        .unwrap();
    assert_eq!(mount.status(), StatusCode::OK);

    // Incrementally read a file → absorbed into the session's W̃.
    let resp = app
        .oneshot(
            Request::builder()
                .method(Method::POST)
                .uri("/v1/hypervisor/read")
                .header("content-type", "application/json")
                .body(Body::from(
                    json!({"path": "b.rs", "session_id": "vfs-incr"}).to_string(),
                ))
                .unwrap(),
        )
        .await
        .unwrap();
    assert_eq!(resp.status(), StatusCode::OK);
    let v: serde_json::Value =
        serde_json::from_slice(&to_bytes(resp.into_body(), usize::MAX).await.unwrap()).unwrap();
    assert!(v["read"]["digest_tokens"].as_u64().unwrap() > 0);
    assert_eq!(v["vfs"]["read_events"].as_u64().unwrap(), 1);

    let _ = std::fs::remove_dir_all(&root);
}

#[tokio::test]
async fn jit_run_endpoint_repairs_source_and_feeds_ttt() {
    let root = std::env::temp_dir().join(format!("axiom-jitrun-{}", Uuid::new_v4()));
    std::fs::create_dir_all(&root).unwrap();
    let script = root.join("check.sh");
    // Fails with `exit 1`; Q-TTT collapses to the exit-code-flip candidate.
    std::fs::write(&script, "#!/bin/sh\necho 'build failed' >&2\nexit 1\n").unwrap();

    let app = create_router(test_state().await.with_jit_exec_enabled(true));
    let resp = app
        .oneshot(
            Request::builder()
                .method(Method::POST)
                .uri("/v1/hypervisor/jit_run")
                .header("content-type", "application/json")
                .body(Body::from(
                    json!({
                        "session_id": "jit-1",
                        "command": posix_shell(),
                        "args": [script.to_string_lossy()],
                        "source_path": script.to_string_lossy(),
                    })
                    .to_string(),
                ))
                .unwrap(),
        )
        .await
        .unwrap();
    assert_eq!(resp.status(), StatusCode::OK);
    let v: serde_json::Value =
        serde_json::from_slice(&to_bytes(resp.into_body(), usize::MAX).await.unwrap()).unwrap();
    assert_eq!(v["report"]["passed"], true);
    assert_eq!(v["report"]["patched"], true);
    assert_eq!(v["source_restored"], false, "a passing repair keeps the patch");
    assert!(std::fs::read_to_string(&script).unwrap().contains("exit 0"));

    let _ = std::fs::remove_dir_all(&root);
}

#[tokio::test]
async fn jit_run_restores_source_when_repair_fails() {
    let root = std::env::temp_dir().join(format!("axiom-jitfail-{}", Uuid::new_v4()));
    std::fs::create_dir_all(&root).unwrap();
    let script = root.join("hard.sh");
    // No patch rule matches (avoids `exit 1`/markers/throw/assert) → repair
    // cannot pass → the source must be restored byte-for-byte.
    let original = "#!/bin/sh\necho 'mysterious failure mode' >&2\nexit 3\n";
    std::fs::write(&script, original).unwrap();

    let app = create_router(test_state().await.with_jit_exec_enabled(true));
    let resp = app
        .oneshot(
            Request::builder()
                .method(Method::POST)
                .uri("/v1/hypervisor/jit_run")
                .header("content-type", "application/json")
                .body(Body::from(
                    json!({
                        "command": posix_shell(),
                        "args": [script.to_string_lossy()],
                        "source_path": script.to_string_lossy(),
                    })
                    .to_string(),
                ))
                .unwrap(),
        )
        .await
        .unwrap();
    assert_eq!(resp.status(), StatusCode::OK);
    let v: serde_json::Value =
        serde_json::from_slice(&to_bytes(resp.into_body(), usize::MAX).await.unwrap()).unwrap();
    assert_eq!(v["report"]["passed"], false);
    // SAFETY: the original source must be intact byte-for-byte.
    assert_eq!(std::fs::read_to_string(&script).unwrap(), original);

    let _ = std::fs::remove_dir_all(&root);
}

#[tokio::test]
async fn jit_run_endpoint_is_disabled_by_default() {
    // `jit_exec_enabled` defaults to `false`: a server started with no
    // AXIOM_ENABLE_JIT_EXEC configuration must refuse to execute a
    // caller-supplied command at all, not merely require auth for it.
    let app = create_router(test_state().await);
    let resp = app
        .oneshot(
            Request::builder()
                .method(Method::POST)
                .uri("/v1/hypervisor/jit_run")
                .header("content-type", "application/json")
                .body(Body::from(
                    json!({
                        "session_id": "jit-disabled",
                        "command": "echo",
                        "args": ["should not run"],
                    })
                    .to_string(),
                ))
                .unwrap(),
        )
        .await
        .unwrap();
    assert_eq!(resp.status(), StatusCode::FORBIDDEN);
    let body = String::from_utf8(to_bytes(resp.into_body(), usize::MAX).await.unwrap().to_vec()).unwrap();
    assert!(body.contains("AXIOM_ENABLE_JIT_EXEC"));
}