Platform Tool for Scheduler: Allow Goose to Manage Its Own Schedule (#2944)

crates/goose/src/agents/platform_tools.rs

@@ -7,6 +7,7 @@ pub const PLATFORM_LIST_RESOURCES_TOOL_NAME: &str = "platform__list_resources";
 pub const PLATFORM_SEARCH_AVAILABLE_EXTENSIONS_TOOL_NAME: &str =
     "platform__search_available_extensions";
 pub const PLATFORM_MANAGE_EXTENSIONS_TOOL_NAME: &str = "platform__manage_extensions";
+pub const PLATFORM_MANAGE_SCHEDULE_TOOL_NAME: &str = "platform__manage_schedule";
 
 pub fn read_resource_tool() -> Tool {
     Tool::new(
@@ -112,3 +113,47 @@ pub fn manage_extensions_tool() -> Tool {
         }),
     )
 }
+
+pub fn manage_schedule_tool() -> Tool {
+    Tool::new(
+        PLATFORM_MANAGE_SCHEDULE_TOOL_NAME.to_string(),
+        indoc! {r#"
+            Manage scheduled recipe execution for this Goose instance.
+            
+            Actions:
+            - "list": List all scheduled jobs
+            - "create": Create a new scheduled job from a recipe file
+            - "run_now": Execute a scheduled job immediately  
+            - "pause": Pause a scheduled job
+            - "unpause": Resume a paused job
+            - "delete": Remove a scheduled job
+            - "kill": Terminate a currently running job
+            - "inspect": Get details about a running job
+            - "sessions": List execution history for a job
+            - "session_content": Get the full content (messages) of a specific session
+        "#}
+        .to_string(),
+        json!({
+            "type": "object",
+            "required": ["action"],
+            "properties": {
+                "action": {
+                    "type": "string",
+                    "enum": ["list", "create", "run_now", "pause", "unpause", "delete", "kill", "inspect", "sessions", "session_content"]
+                },
+                "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"},
+                "limit": {"type": "integer", "description": "Limit for sessions list", "default": 50},
+                "session_id": {"type": "string", "description": "Session identifier for session_content action"}
+            }
+        }),
+        Some(ToolAnnotations {
+            title: Some("Manage scheduled recipes".to_string()),
+            read_only_hint: false,
+            destructive_hint: true, // Can kill jobs
+            idempotent_hint: false,
+            open_world_hint: false,
+        }),
+    )
+}