periplon 0.2.0

Rust SDK for building multi-agent AI workflows and automation
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

use serde::{Deserialize, Serialize};

pub type HookEvent = String;

#[derive(Clone)]
pub struct HookMatcher {
    pub matcher: Option<String>,
    pub hooks: Vec<HookCallback>,
}

pub struct HookContext {
    pub signal: Option<()>,
}

/// Hook input types (discriminated union)
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "hook_event_name")]
pub enum HookInput {
    PreToolUse {
        session_id: String,
        transcript_path: String,
        cwd: String,
        permission_mode: Option<String>,
        tool_name: String,
        tool_input: serde_json::Value,
    },
    PostToolUse {
        session_id: String,
        transcript_path: String,
        cwd: String,
        permission_mode: Option<String>,
        tool_name: String,
        tool_input: serde_json::Value,
        tool_response: serde_json::Value,
    },
    UserPromptSubmit {
        session_id: String,
        transcript_path: String,
        cwd: String,
        permission_mode: Option<String>,
        prompt: String,
    },
    Stop {
        session_id: String,
        transcript_path: String,
        cwd: String,
        permission_mode: Option<String>,
        stop_hook_active: bool,
    },
    SubagentStop {
        session_id: String,
        transcript_path: String,
        cwd: String,
        permission_mode: Option<String>,
        stop_hook_active: bool,
    },
    PreCompact {
        session_id: String,
        transcript_path: String,
        cwd: String,
        permission_mode: Option<String>,
        trigger: String,
        custom_instructions: Option<String>,
    },
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum HookJSONOutput {
    Async {
        #[serde(rename = "async")]
        is_async: bool,
        #[serde(rename = "asyncTimeout", skip_serializing_if = "Option::is_none")]
        async_timeout: Option<u32>,
    },
    Sync {
        #[serde(rename = "continue", skip_serializing_if = "Option::is_none")]
        should_continue: Option<bool>,
        #[serde(rename = "suppressOutput", skip_serializing_if = "Option::is_none")]
        suppress_output: Option<bool>,
        #[serde(rename = "stopReason", skip_serializing_if = "Option::is_none")]
        stop_reason: Option<String>,
        #[serde(skip_serializing_if = "Option::is_none")]
        decision: Option<String>,
        #[serde(rename = "systemMessage", skip_serializing_if = "Option::is_none")]
        system_message: Option<String>,
        #[serde(skip_serializing_if = "Option::is_none")]
        reason: Option<String>,
        #[serde(rename = "hookSpecificOutput", skip_serializing_if = "Option::is_none")]
        hook_specific_output: Option<HookSpecificOutput>,
    },
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "hookEventName")]
pub enum HookSpecificOutput {
    PreToolUse {
        #[serde(rename = "permissionDecision", skip_serializing_if = "Option::is_none")]
        permission_decision: Option<String>,
        #[serde(
            rename = "permissionDecisionReason",
            skip_serializing_if = "Option::is_none"
        )]
        permission_decision_reason: Option<String>,
        #[serde(rename = "updatedInput", skip_serializing_if = "Option::is_none")]
        updated_input: Option<serde_json::Value>,
    },
    PostToolUse {
        #[serde(rename = "additionalContext", skip_serializing_if = "Option::is_none")]
        additional_context: Option<String>,
    },
    UserPromptSubmit {
        #[serde(rename = "additionalContext", skip_serializing_if = "Option::is_none")]
        additional_context: Option<String>,
    },
}

pub type HookCallback = std::sync::Arc<
    dyn Fn(
            HookInput,
            Option<String>,
            HookContext,
        ) -> std::pin::Pin<Box<dyn std::future::Future<Output = HookJSONOutput> + Send>>
        + Send
        + Sync,
>;