navi-core 0.1.1

Local agentic engine and terminal-first coding agent.
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

use anyhow::Result;
use async_trait::async_trait;
use serde_json::json;

use super::helpers;
use crate::tool::{Tool, ToolDefinition, ToolInvocation, ToolKind, ToolResult};

pub(crate) struct QuestionTool;

#[async_trait]
impl Tool for QuestionTool {
    fn definition(&self) -> ToolDefinition {
        helpers::definition(
            "question",
            "Ask the user to choose from a short list of options. Use this only when user input is needed to proceed.",
            ToolKind::Read,
            json!({
                "type": "object",
                "properties": {
                    "question": {
                        "type": "string",
                        "description": "The question shown to the user."
                    },
                    "options": {
                        "type": "array",
                        "minItems": 1,
                        "items": {
                            "oneOf": [
                                { "type": "string" },
                                {
                                    "type": "object",
                                    "properties": {
                                        "label": { "type": "string" },
                                        "description": { "type": "string" }
                                    },
                                    "required": ["label"],
                                    "additionalProperties": false
                                }
                            ]
                        },
                        "description": "Options the user can choose from. Prefer concise labels with optional descriptions."
                    },
                    "multiple": {
                        "type": "boolean",
                        "description": "When true, the user may select more than one option. Defaults to false."
                    },
                    "custom": {
                        "type": "boolean",
                        "description": "When true, allow the user to type a custom answer. Defaults to false."
                    }
                },
                "required": ["question", "options"],
                "additionalProperties": false,
            }),
        )
    }

    async fn invoke(&self, invocation: ToolInvocation) -> Result<ToolResult> {
        Ok(ToolResult {
            invocation_id: invocation.id,
            ok: false,
            output: helpers::tool_error(
                "interactive_question_unavailable",
                "question requires an interactive client",
                true,
                Some(
                    "Run this turn from the TUI or another client that supports question resolution.",
                ),
                None,
            ),
        })
    }
}