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
74
75
76
77
78
79
80
81
|
//! Effects (outputs) from the agent FSM.
//!
//! The FSM returns these as data; the driver is responsible for executing them.
use std::path::PathBuf;
use std::time::Duration;
use serde_json::Value;
use crate::permissions::rule::Rule;
use crate::permissions::writer::RuleDisposition;
use crate::tools::ClientToolCall;
/// Where to write a permission rule.
#[derive(Debug, Clone, PartialEq, Eq)]
pub(crate) enum PermissionTarget {
/// Project-level: `<git_root_or_cwd>/.atuin/permissions.ai.toml`
Project,
/// Global: `~/.config/atuin/permissions.ai.toml`
Global,
}
/// Side effects the driver should execute after a state transition.
#[derive(Debug, Clone)]
pub(crate) enum Effect {
// ─── Network ────────────────────────────────────────────────
/// Start a new streaming request to the server.
StartStream {
messages: Vec<Value>,
session_id: Option<String>,
},
/// Abort the active stream connection.
AbortStream,
// ─── Tool orchestration ─────────────────────────────────────
/// Run the permission resolver for a tool call.
CheckPermission {
tool_id: String,
tool: ClientToolCall,
},
/// Execute a tool (file read, edit, write, shell, history search).
ExecuteTool {
tool_id: String,
tool: ClientToolCall,
},
/// Kill a running tool (send interrupt to shell command).
AbortTool { tool_id: String },
// ─── Persistence ────────────────────────────────────────────
/// Persist current conversation state to disk.
Persist,
/// Write a permanent permission rule to disk.
WritePermissionRule {
target: PermissionTarget,
rule: Rule,
disposition: RuleDisposition,
},
/// Cache a session-scoped file permission grant.
CacheSessionGrant { path: PathBuf },
/// Archive current session and start fresh (IO only — state already updated by FSM).
ArchiveSession,
// ─── Timers ─────────────────────────────────────────────────
/// Schedule a timer that will fire ConfirmationTimeout after delay.
ScheduleTimeout { timeout_id: u64, duration: Duration },
// ─── Exit ───────────────────────────────────────────────────
/// Exit the application with the given action.
ExitApp(ExitAction),
}
/// What to do when exiting the TUI.
#[derive(Debug, Clone, PartialEq, Eq)]
pub(crate) enum ExitAction {
/// Run the suggested command.
Execute(String),
/// Insert the command into the shell without running.
Insert(String),
/// Exit without action.
Cancel,
}
|
