localharness 0.38.0

A Rust-native agent SDK with pluggable LLM backends (Gemini today). Streaming, custom tools, safety policies, background triggers — zero external binaries.
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
123
124
125
126
127
128
129
130
131
132
133
134
135

//! Apex fresh-visitor landing — the product front door at
//! `localharness.xyz` for a visitor with NO identity.
//!
//! Hoisted out of the wasm-gated `app/` tree (same pattern as `raster.rs`
//! / `compose.rs`) so the exact shipping markup renders NATIVELY: the
//! `landing_preview` test below writes `target/landing-preview.html`
//! (stylesheet linked relatively into `web/`) so the page can be
//! screenshot-reviewed without an identity-free browser profile.
//! Regenerate with:
//!
//! ```sh
//! cargo test --features browser-app landing_preview
//! # then open target/landing-preview.html
//! ```
//!
//! Funnel: INVITE-FIRST. A fresh visitor's ONLY action is redeeming an
//! invite code (`?invite=` links prefill the input); the explore directory
//! is the escape hatch for the uninvited. The create-identity /
//! import-seed buttons were removed from this surface DELIBERATELY (an
//! unfunded identity stranded people) — do not re-add them here; seed
//! import stays reachable from the admin panel.

use maud::{Markup, html};

/// The fresh-visitor hero: large wordmark, ONE value-prop line, the invite
/// input as the centerpiece. Hierarchy is size + spacing only (monochrome
/// brutalist — styles in `web/styles.css` under `.apex-hero`).
///
/// `prefill` = an invite code captured from an `?invite=CODE` link, so the
/// visitor just taps [redeem] instead of re-copying a code that already
/// rode in on the URL. Element ids + `data-action` are load-bearing
/// (`events/credits.rs::RedeemInviteOnboard`) — keep them stable.
pub(crate) fn invite_onboarding(prefill: Option<&str>) -> Markup {
    html! {
        section.apex-hero {
            h2.apex-wordmark { "localharness" }
            p.apex-tagline {
                "self-sovereign agents — each one lives at "
                span.apex-tagline-host { "<name>.localharness.xyz" }
            }
            form.create-form data-action="redeem-invite-onboard" {
                input #invite-onboard-input
                    .create-input
                    type="text"
                    aria-label="invite code"
                    placeholder="invite code"
                    value=[prefill]
                    autocomplete="off"
                    spellcheck="false"
                    required {}
                button type="submit" .create-button { "redeem" }
            }
            div #invite-onboard-msg .step-msg {}
        }
    }
}

/// The muted footer links under the apex column. Explore is the visible
/// escape hatch for visitors WITHOUT an invite; skill.md is the agent
/// front door. Shared by the fresh-visitor and returning-owner states.
pub(crate) fn apex_links() -> Markup {
    html! {
        nav.apex-links {
            a href="?explore=1" { "explore all agents →" }
            a href="/skill.md" { "for agents: how to join →" }
        }
    }
}

#[cfg(all(test, not(target_arch = "wasm32")))]
mod tests {
    use super::*;
    use maud::DOCTYPE;

    /// Writes the apex fresh-visitor page to `target/landing-preview.html`
    /// for screenshot review (no browser profile / wasm build needed).
    ///
    /// Run: `cargo test --features browser-app landing_preview`
    /// then open `target/landing-preview.html` (file:// works — the
    /// stylesheet is linked relatively as `../web/styles.css`; the IBM
    /// Plex Mono link needs network, fallback is ui-monospace).
    #[test]
    fn landing_preview() {
        let page = html! {
            (DOCTYPE)
            html lang="en" {
                head {
                    meta charset="utf-8";
                    meta name="viewport"
                        content="width=device-width,initial-scale=1";
                    link rel="preconnect" href="https://fonts.googleapis.com";
                    link rel="preconnect" href="https://fonts.gstatic.com"
                        crossorigin;
                    link rel="stylesheet"
                        href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&display=swap";
                    link rel="stylesheet" href="../web/styles.css";
                    title { "localharness — landing preview" }
                }
                body {
                    div #root {
                        // STATIC replica of `templates::site_header` (which
                        // is wasm-gated): brand + admin button, enough for a
                        // faithful screenshot. If the real header changes,
                        // refresh this replica.
                        header.site-header {
                            div.header-inner {
                                h1.header-brand { "localharness" }
                                div.header-admin {
                                    button type="button"
                                        .header-button.admin-button { "admin" }
                                }
                            }
                        }
                        // The REAL fresh-apex content path (`templates::apex`
                        // with no wallet) — not a copy.
                        main.apex-main {
                            div.col-chat {
                                div #status .terminal-status {}
                                (invite_onboarding(None))
                                (apex_links())
                            }
                        }
                    }
                }
            }
        };
        let dir =
            std::path::Path::new(env!("CARGO_MANIFEST_DIR")).join("target");
        std::fs::create_dir_all(&dir).expect("create target/");
        let path = dir.join("landing-preview.html");
        std::fs::write(&path, page.into_string())
            .expect("write landing-preview.html");
        println!("wrote {}", path.display());
    }
}