The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
use crate::config::Config;
use crate::security::SecurityPolicy;
use async_trait::async_trait;
use serde_json::json;
use std::sync::Arc;
use tinytools::{PermissionLevel, Tool, ToolCallOptions, ToolExposure, ToolResult};
use {crate::cron, tinyflows_bus::schedule::types::CronJobPatch};
pub struct CronUpdateTool {
config: Arc<Config>,
security: Arc<SecurityPolicy>,
}
impl CronUpdateTool {
pub fn new(config: Arc<Config>, security: Arc<SecurityPolicy>) -> Self {
Self { config, security }
}
}
#[async_trait]
impl Tool for CronUpdateTool {
/// Superseded by the `cron` tool, which dispatches every scheduler
/// operation on one `action` field. Kept registered and dispatchable so a
/// replayed transcript or a saved skill naming `cron_*` keeps working;
/// hidden from the wire so six schemas do not ship where one does.
fn exposure(&self) -> ToolExposure {
ToolExposure::Hidden
}
fn name(&self) -> &str {
"cron_update"
}
fn description(&self) -> &str {
"Patch an existing cron job (schedule, command, prompt, enabled, delivery, model, etc.)"
}
fn parameters_schema(&self) -> serde_json::Value {
json!({
"type": "object",
"properties": {
"job_id": { "type": "string" },
"patch": { "type": "object" }
},
"required": ["job_id", "patch"]
})
}
fn supports_markdown(&self) -> bool {
true
}
fn permission_level(&self) -> PermissionLevel {
PermissionLevel::Execute
}
fn external_effect(&self) -> bool {
// Patching a job can change the stored command or re-enable a
// disabled job. Require approval via the gate (GHSA-f46p-6vf9-64mm).
true
}
async fn execute(&self, args: serde_json::Value) -> anyhow::Result<ToolResult> {
self.execute_with_options(args, ToolCallOptions::default())
.await
}
async fn execute_with_options(
&self,
args: serde_json::Value,
options: ToolCallOptions,
) -> anyhow::Result<ToolResult> {
self.execute_with_context(args, options, None).await
}
async fn execute_with_context(
&self,
args: serde_json::Value,
options: ToolCallOptions,
tool_context: Option<&dyn tinytools::ToolRunContext>,
) -> anyhow::Result<ToolResult> {
if !self.config.cron.enabled {
return Ok(ToolResult::error(
"cron is disabled by config (cron.enabled=false)".to_string(),
));
}
let job_id = match args.get("job_id").and_then(serde_json::Value::as_str) {
Some(v) if !v.trim().is_empty() => v,
_ => {
return Ok(ToolResult::error("Missing 'job_id' parameter".to_string()));
}
};
let patch_val = match args.get("patch") {
Some(v) => v.clone(),
None => {
return Ok(ToolResult::error("Missing 'patch' parameter".to_string()));
}
};
let patch = match serde_json::from_value::<CronJobPatch>(patch_val) {
Ok(patch) => patch,
Err(e) => {
return Ok(ToolResult::error(format!("Invalid patch payload: {e}")));
}
};
if let Some(command) = &patch.command {
if let Err(reason) = super::super::scheduler::shell_job::authorize_shell_command(
&self.config,
&self.security,
command,
)
.await
{
return Ok(ToolResult::error(reason));
}
}
let origin =
crate::agent::tinyagents::host::run_context::turn_origin_for_tool(tool_context)
.and_then(|origin| crate::cron::origin::current_job_origin(Some(&origin)));
match cron::store::update_job_with_origin(&self.config, job_id, patch, origin) {
Ok(job) => {
let mut tr = ToolResult::success(serde_json::to_string_pretty(&job)?);
if options.prefer_markdown {
tr.markdown_formatted = Some(format!(
"Updated **{}** (`{}`).\n- **schedule**: `{}`\n- **enabled**: {}\n- **next_run**: {}",
job.name.as_deref().unwrap_or(&job.id),
job.id,
job.expression,
job.enabled,
job.next_run.format("%Y-%m-%d %H:%M:%S UTC"),
));
}
Ok(tr)
}
Err(e) => Ok(ToolResult::error(e.to_string())),
}
}
}
#[cfg(test)]
#[path = "update_tests.rs"]
mod tests;