talon-cli 0.4.2

Talon CLI: hybrid retrieval over Obsidian vaults and markdown corpora, with grounded answers, MCP server, and agent-native output.
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

use serde::Serialize;
use talon_core::{ReadResponse, ReadResult, ReadSection};

#[derive(Debug, Serialize)]
pub(super) struct AgentReadResponse<'a> {
    #[serde(skip_serializing_if = "Option::is_none")]
    vault: Option<&'a str>,
    results: Vec<AgentReadResult<'a>>,
}

impl<'a> From<&'a ReadResponse> for AgentReadResponse<'a> {
    fn from(read: &'a ReadResponse) -> Self {
        Self {
            vault: read.vault.as_ref().map(talon_core::ContainerPath::as_str),
            results: read.results.iter().map(AgentReadResult::from).collect(),
        }
    }
}

#[derive(Debug, Serialize)]
struct AgentReadResult<'a> {
    path: &'a str,
    #[serde(skip_serializing_if = "Option::is_none")]
    found: Option<bool>,
    #[serde(skip_serializing_if = "Option::is_none")]
    title: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    content: Option<&'a str>,
    #[serde(skip_serializing_if = "Option::is_none")]
    section: Option<AgentReadSection<'a>>,
}

impl<'a> From<&'a ReadResult> for AgentReadResult<'a> {
    fn from(result: &'a ReadResult) -> Self {
        Self {
            path: result.vault_path.as_str(),
            found: (!result.found).then_some(false),
            title: result.title.as_deref(),
            content: result.content.as_deref(),
            section: result.section.as_ref().map(AgentReadSection::from),
        }
    }
}

#[derive(Debug, Serialize)]
#[serde(rename_all = "camelCase")]
struct AgentReadSection<'a> {
    heading: &'a str,
    from_line: u32,
    to_line: u32,
    obsidian_ref: &'a str,
}

impl<'a> From<&'a ReadSection> for AgentReadSection<'a> {
    fn from(section: &'a ReadSection) -> Self {
        Self {
            heading: &section.heading,
            from_line: section.from_line,
            to_line: section.to_line,
            obsidian_ref: &section.obsidian_ref,
        }
    }
}