lingshu-tools 0.10.0

Tool registry, ToolHandler trait, and 50+ tool implementations
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

//! Checkpoint configuration and result types.

use std::path::PathBuf;

use crate::registry::ToolContext;

/// Configuration for checkpoint operations (mirrors Hermes `CheckpointManager`).
#[derive(Debug, Clone)]
pub struct CheckpointConfig {
    pub enabled: bool,
    pub max_snapshots: u32,
    pub max_total_size_mb: u32,
    pub max_file_size_mb: u32,
    pub lingshu_home: PathBuf,
}

impl CheckpointConfig {
    pub fn from_ctx(ctx: &ToolContext) -> Self {
        Self {
            enabled: ctx.config.checkpoints_enabled,
            max_snapshots: ctx.config.checkpoints_max_snapshots.max(1),
            max_total_size_mb: ctx.config.checkpoints_max_total_size_mb,
            max_file_size_mb: ctx.config.checkpoints_max_file_size_mb,
            lingshu_home: ctx.config.lingshu_home.clone(),
        }
    }

    pub fn from_home(
        lingshu_home: PathBuf,
        enabled: bool,
        max_snapshots: u32,
        max_total_size_mb: u32,
        max_file_size_mb: u32,
    ) -> Self {
        Self {
            enabled,
            max_snapshots: max_snapshots.max(1),
            max_total_size_mb,
            max_file_size_mb,
            lingshu_home,
        }
    }
}

#[derive(Debug, Clone, serde::Serialize)]
pub struct CheckpointEntry {
    pub n: usize,
    pub hash: String,
    pub short_hash: String,
    pub timestamp: String,
    pub reason: String,
    pub files_changed: u32,
    pub insertions: u32,
    pub deletions: u32,
    pub size_bytes: u64,
    pub pinned: bool,
}

#[derive(Debug, Clone, serde::Serialize)]
pub struct RestoreResult {
    pub restored_to: String,
    pub reason: String,
    pub files_restored: usize,
    pub restored_files: Vec<String>,
}