use crate::agent_runs::remote_control::{
AdapterKind, PermissionPolicy, RunnerKind, WorkspacePolicy,
};
use serde_json::Value;
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
pub enum AgentRunStatus {
#[default]
Queued,
Running,
Completed,
Failed,
Cancelled,
}
impl AgentRunStatus {
pub fn from_wire(s: Option<&str>) -> Self {
match s {
Some("running") => Self::Running,
Some("completed") => Self::Completed,
Some("failed") => Self::Failed,
Some("cancelled") => Self::Cancelled,
_ => Self::Queued,
}
}
pub fn as_str(&self) -> &'static str {
match self {
Self::Queued => "queued",
Self::Running => "running",
Self::Completed => "completed",
Self::Failed => "failed",
Self::Cancelled => "cancelled",
}
}
}
pub const AGENT_RUN_RUNTIME_STANDARD: &str = "standard";
pub const AGENT_RUN_RUNTIME_CRABCODE_REMOTE: &str = "crabcode_remote";
pub const AGENT_RUN_META_TITLE: &str = "title";
pub const AGENT_RUN_META_WORKSPACE: &str = "workspace";
#[derive(Debug, Clone, Default)]
pub struct AgentRunLocalContextPolicy {
pub enabled: Option<bool>,
pub readonly: Option<bool>,
pub max_bytes: Option<i64>,
pub allowed_tools: Option<Vec<String>>,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRunArtifactPolicy {
pub enabled: Option<bool>,
pub max_files: Option<i64>,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRunCreateRequest {
pub app_id: String,
pub mode: Option<String>,
pub session_id: Option<String>,
pub input: String,
pub messages: Option<Vec<Value>>,
pub model: Option<String>,
pub active_skill_ids: Option<Vec<String>>,
pub knowledge_base_ids: Option<Vec<String>>,
pub metadata: Option<std::collections::HashMap<String, String>>,
pub local_context_policy: Option<AgentRunLocalContextPolicy>,
pub artifact_policy: Option<AgentRunArtifactPolicy>,
pub runtime: Option<String>,
pub runner: Option<RunnerKind>,
pub adapter: Option<AdapterKind>,
pub permission_policy: Option<PermissionPolicy>,
pub workspace_policy: Option<WorkspacePolicy>,
pub byok_credential_ref: Option<String>,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRun {
pub run_id: String,
pub session_id: String,
pub app_id: Option<String>,
pub mode: Option<String>,
pub status: Option<AgentRunStatus>,
pub created_at: Option<String>,
pub started_at: Option<String>,
pub completed_at: Option<String>,
pub error: Option<AgentRunErrorPayload>,
pub metadata: Option<std::collections::HashMap<String, String>>,
pub runtime: Option<String>,
pub runner: Option<String>,
pub adapter: Option<String>,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRunListOptions {
pub runtime: Option<String>,
pub status: Option<String>,
pub page: Option<i64>,
pub page_size: Option<i64>,
}
#[derive(Debug, Clone)]
pub struct AgentRunListResult {
pub records: Vec<AgentRun>,
pub total: i64,
pub page: i64,
pub page_size: i64,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRunCreateResponse {
pub run_id: String,
pub session_id: String,
pub status: AgentRunStatus,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRunArtifact {
pub id: String,
pub filename: String,
pub content_type: Option<String>,
pub size: Option<i64>,
pub r#type: Option<String>,
pub metadata: Option<std::collections::HashMap<String, String>>,
}
#[derive(Debug, Clone)]
pub struct AgentRunDownload {
pub data: Vec<u8>,
pub filename: String,
pub content_type: Option<String>,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRunUsage {
pub input_tokens: Option<i64>,
pub output_tokens: Option<i64>,
pub total_tokens: Option<i64>,
pub cache_read_tokens: Option<i64>,
pub cache_create_tokens: Option<i64>,
pub exact: Option<bool>,
pub source: Option<String>,
pub raw: Value,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRunSettlement {
pub request_id: Option<String>,
pub status: Option<String>,
pub consume_status: Option<String>,
pub input_tokens: Option<i64>,
pub output_tokens: Option<i64>,
pub total_tokens: Option<i64>,
pub cache_read_tokens: Option<i64>,
pub cache_create_tokens: Option<i64>,
pub token_remaining: Option<i64>,
pub call_remaining: Option<i64>,
pub retry_queued: Option<bool>,
pub exact: Option<bool>,
pub raw: Value,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRunErrorPayload {
pub code: Option<String>,
pub message: String,
pub stage: Option<String>,
pub retryable: Option<bool>,
pub raw: Option<Value>,
}
#[derive(Debug, Clone, Default)]
pub struct AgentRunLocalToolResult {
pub request_id: String,
pub ok: bool,
pub content: Option<Value>,
pub error: Option<String>,
}
#[derive(Debug, Clone)]
pub struct AgentRunStreamOptions {
pub throw_on_error: bool,
}
impl Default for AgentRunStreamOptions {
fn default() -> Self {
Self {
throw_on_error: true,
}
}
}
pub type AgentRunRunOptions = AgentRunStreamOptions;
#[derive(Debug, Clone)]
pub struct AgentRunWithLocalToolsOptions {
pub throw_on_error: bool,
pub timeout_ms: u64,
}
impl Default for AgentRunWithLocalToolsOptions {
fn default() -> Self {
Self {
throw_on_error: true,
timeout_ms: 30_000,
}
}
}
#[derive(Debug, Clone)]
pub enum AgentRunStreamEvent {
RunStarted {
run_id: String,
session_id: String,
},
Status {
status: String,
message: Option<String>,
},
TextDelta {
text: String,
},
ReasoningDelta {
text: String,
},
ToolCall {
id: String,
name: String,
input: Option<Value>,
},
ToolResult {
id: String,
name: Option<String>,
result: Option<Value>,
error: Option<String>,
},
LocalToolRequest {
request_id: String,
name: String,
input: Value,
},
Artifact {
artifact: AgentRunArtifact,
},
Sources {
sources: Value,
},
Usage {
usage: AgentRunUsage,
},
Settle {
settlement: AgentRunSettlement,
},
Error {
error: AgentRunErrorPayload,
},
Done {
run_id: String,
status: String,
},
}
impl AgentRunStreamEvent {
pub fn type_str(&self) -> &'static str {
match self {
Self::RunStarted { .. } => "run_started",
Self::Status { .. } => "status",
Self::TextDelta { .. } => "text_delta",
Self::ReasoningDelta { .. } => "reasoning_delta",
Self::ToolCall { .. } => "tool_call",
Self::ToolResult { .. } => "tool_result",
Self::LocalToolRequest { .. } => "local_tool_request",
Self::Artifact { .. } => "artifact",
Self::Sources { .. } => "sources",
Self::Usage { .. } => "usage",
Self::Settle { .. } => "settle",
Self::Error { .. } => "error",
Self::Done { .. } => "done",
}
}
}