execkit 0.7.2

Stateful, structured, safe shell sessions for AI agents on real infrastructure.
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

// SPDX-License-Identifier: Apache-2.0
use crate::budget::BudgetReport;
use serde::{Deserialize, Serialize};

/// The structured result of running one command - the agent-facing contract.
///
/// Note `stdout` and `stderr` are **split** (a raw PTY merges them), already
/// ANSI-stripped and secret-redacted, and bounded to the session's output cap.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct ExecResult {
    pub command: String,
    pub stdout: String,
    pub stderr: String,
    pub exit_code: i32,
    pub duration_ms: u64,
    pub cwd: String,
    /// True if output was shortened: a char-cap hit, lines dropped by an output
    /// budget, or anti-flood overflow.
    pub truncated: bool,
    /// Present only when a non-default budget shaped this result.
    #[serde(skip_serializing_if = "Option::is_none", default)]
    pub budget: Option<BudgetReport>,
}

/// A snapshot of shell state carried alongside results.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct ShellState {
    pub cwd: String,
    pub last_exit: i32,
}