Mnovich/temporal foreground tasks (#2895)

Co-authored-by: Carlos M. Lopez <carlopez@squareup.com>

crates/goose/src/agents/agent.rs

@@ -574,7 +574,25 @@ impl Agent {
         let (mut tools, mut toolshim_tools, mut system_prompt) =
             self.prepare_tools_and_prompt().await?;
 
-        let goose_mode = config.get_param("GOOSE_MODE").unwrap_or("auto".to_string());
+        // Get goose_mode from config, but override with execution_mode if provided in session config
+        let mut goose_mode = config.get_param("GOOSE_MODE").unwrap_or("auto".to_string());
+
+        // If this is a scheduled job with an execution_mode, override the goose_mode
+        if let Some(session_config) = &session {
+            if let Some(execution_mode) = &session_config.execution_mode {
+                // Map "foreground" to "auto" and "background" to "chat"
+                goose_mode = match execution_mode.as_str() {
+                    "foreground" => "auto".to_string(),
+                    "background" => "chat".to_string(),
+                    _ => goose_mode,
+                };
+                tracing::info!(
+                    "Using execution_mode '{}' which maps to goose_mode '{}'",
+                    execution_mode,
+                    goose_mode
+                );
+            }
+        }
 
         let (tools_with_readonly_annotation, tools_without_annotation) =
             Self::categorize_tools_by_annotation(&tools);

crates/goose/src/agents/platform_tools.rs

@@ -144,6 +144,7 @@ pub fn manage_schedule_tool() -> Tool {
                 "job_id": {"type": "string", "description": "Job identifier for operations on existing jobs"},
                 "recipe_path": {"type": "string", "description": "Path to recipe file for create action"},
                 "cron_expression": {"type": "string", "description": "A six field cron expression for create action"},
+                "execution_mode": {"type": "string", "description": "Execution mode for create action: 'foreground' or 'background'", "enum": ["foreground", "background"], "default": "background"},
                 "limit": {"type": "integer", "description": "Limit for sessions list", "default": 50},
                 "session_id": {"type": "string", "description": "Session identifier for session_content action"}
             }

crates/goose/src/agents/schedule_tool.rs

@@ -94,6 +94,20 @@ impl Agent {
                 ToolError::ExecutionError("Missing 'cron_expression' parameter".to_string())
             })?;
 
+        // Get the execution_mode parameter, defaulting to "background" if not provided
+        let execution_mode = arguments
+            .get("execution_mode")
+            .and_then(|v| v.as_str())
+            .unwrap_or("background");
+
+        // Validate execution_mode is either "foreground" or "background"
+        if execution_mode != "foreground" && execution_mode != "background" {
+            return Err(ToolError::ExecutionError(format!(
+                "Invalid execution_mode: {}. Must be 'foreground' or 'background'",
+                execution_mode
+            )));
+        }
+
         // Validate recipe file exists and is readable
         if !std::path::Path::new(recipe_path).exists() {
             return Err(ToolError::ExecutionError(format!(
@@ -135,12 +149,13 @@ impl Agent {
             paused: false,
             current_session_id: None,
             process_start_time: None,
+            execution_mode: Some(execution_mode.to_string()),
         };
 
         match scheduler.add_scheduled_job(job).await {
             Ok(()) => Ok(vec![Content::text(format!(
-                "Successfully created scheduled job '{}' for recipe '{}' with cron expression '{}'",
-                job_id, recipe_path, cron_expression
+                "Successfully created scheduled job '{}' for recipe '{}' with cron expression '{}' in {} mode",
+                job_id, recipe_path, cron_expression, execution_mode
             ))]),
             Err(e) => Err(ToolError::ExecutionError(format!(
                 "Failed to create job: {}",

crates/goose/src/agents/types.rs

@@ -23,5 +23,7 @@ pub struct SessionConfig {
     /// Working directory for the session
     pub working_dir: PathBuf,
     /// ID of the schedule that triggered this session, if any
-    pub schedule_id: Option<String>, // NEW
+    pub schedule_id: Option<String>,
+    /// Execution mode for scheduled jobs: "foreground" or "background"
+    pub execution_mode: Option<String>,
 }