localharness 0.31.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

//! `ask_question` — interactive dialog with the user.
//!
//! The model calls `ask_question` to surface a multi-choice or freeform
//! question. The host renders the UI; in the Rust crate that means the
//! caller must register their own ask_question implementation if they
//! want anything more than the default "skipped" response.
//!
//! The default tool below is a no-op that always returns "skipped" —
//! safe to ship, lets the model keep going without crashing, and is
//! documented as overridable.

use std::sync::Arc;

use async_trait::async_trait;
use serde_json::{json, Value};

use crate::error::Result;
use crate::tools::{Tool, ToolContext};

pub struct AskQuestion;

#[cfg_attr(not(target_arch = "wasm32"), async_trait)]
#[cfg_attr(target_arch = "wasm32", async_trait(?Send))]
impl Tool for AskQuestion {
    fn name(&self) -> &str {
        "ask_question"
    }

    fn description(&self) -> &str {
        "Ask the user a clarifying question. Each question entry supports multiple choice \
         and/or freeform responses. The default host implementation skips all questions \
         — register a custom `ask_question` tool to wire interactive UI."
    }

    fn input_schema(&self) -> Value {
        json!({
            "type": "object",
            "properties": {
                "questions": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "question": { "type": "string" },
                            "options": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "id":   { "type": "string" },
                                        "text": { "type": "string" }
                                    },
                                    "required": ["id", "text"]
                                }
                            },
                            "is_multi_select": { "type": "boolean" }
                        },
                        "required": ["question"]
                    }
                }
            },
            "required": ["questions"]
        })
    }

    async fn execute(&self, _args: Value, _ctx: Option<Arc<ToolContext>>) -> Result<Value> {
        Ok(json!({
            "skipped": true,
            "responses": [],
            "note": "default ask_question tool — register a custom implementation to enable interactive UI"
        }))
    }
}