sparrow-cli 0.8.0

A local-first Rust agent cockpit — route, run, replay, rewind
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

// src/cmd_handlers/prelude.rs — common imports for all handler modules.
//
// Every extracted handler does `use super::prelude::*;` and gets the full
// CLI vocabulary in one shot: types, traits, helpers, and the per-run
// flags. Anything a handler needs from elsewhere in the crate goes here so
// the handlers stay short.

pub use std::collections::HashMap;
pub use std::path::{Path, PathBuf};
pub use std::sync::Arc;

pub use anyhow::anyhow;
pub use sparrow::agent::{AgentStore, FsAgentStore, Soul};
pub use sparrow::auth::{AuthStore, Credential};
pub use sparrow::autonomy::GitCheckpoints;
pub use sparrow::capabilities::mcp::{BasicMcpClient, McpClient, McpServer, Transport};
pub use sparrow::capabilities::{FsSkillLibrary, Skill, SkillLibrary};
pub use sparrow::cli::{Cli, Commands, ImportSource};
pub use sparrow::config::{Config, ConfigStore, FsConfigStore, ProviderConfig};
pub use sparrow::console::WebViewServer;
pub use sparrow::engine::Engine;
pub use sparrow::event::{AutonomyLevel, Event, RunId};
pub use sparrow::extras::{ChatSession, Distiller, ReExecuter};
pub use sparrow::gateway::discord::DiscordTransport;
pub use sparrow::gateway::slack::SlackTransport;
pub use sparrow::gateway::telegram::TelegramTransport;
pub use sparrow::gateway::ws::WebSocketApi;
pub use sparrow::gateway::{GatewayMessage, GatewayResponse, GatewayTransport, MessageRouter};
pub use sparrow::memory::{Memory, SqliteMemory};
pub use sparrow::onboarding::migration::Migration;
pub use sparrow::runtime::event_bus::EventBus;
pub use sparrow::runtime::recorder::{FsRecorder, Recorder, Replayer, RunInputs};
pub use sparrow::runtime::scheduler::{Job, MemoryScheduler, Scheduler};
pub use sparrow::runtime::{Runtime, SparrowRuntime};
pub use sparrow::tui::Tui;

// Per-run flags. These live in the prelude (rather than in one handler) so
// every handler that calls `run_task` can construct them.

/// How `run_task` resolves the conversation context for this run.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum SessionMode {
    /// Continue this directory's session (existing behaviour).
    #[default]
    Auto,
    /// Ignore any saved session — start clean.
    Fresh,
    /// Continue the most recently updated session from ANY surface.
    ContinueLast,
}

/// Per-invocation run options threaded from the CLI flags.
#[derive(Debug, Clone, Copy, Default)]
pub struct RunFlags {
    pub session_mode: SessionMode,
    /// Skip the pre-run quote confirmation (--yes, or non-interactive).
    pub assume_yes: bool,
}

// Cross-handler helpers. They live in run_task_cmd, agent_cmd, gateway_cmd,
// and memory_graph_cmd respectively — re-exported here so any handler can
// call them via the prelude without having to remember which sibling owns
// each one.

pub use super::handle_agent_cmd::{build_provider_brains, config_for_soul};
pub use super::handle_gateway_cmd::sanitize_file_component;
pub use super::handle_memory_graph_cmd::current_repo_head;
pub use super::handle_run_task_cmd::{redacted_config_snapshot, run_task};