Skip to main content
Wait for multiple operations to complete.

​
TL;DR

  • Use when: Launched multiple async operations
  • Returns: All operation results
  • Cost: No VM needed (just waiting)

​
Parameters

ParameterTypeRequiredDefaultDescription
operation_idsarrayYes-List of operation UUIDs
modestringNo"all""all" or "any"
timeoutnumberNo300Max wait time (seconds)

​
Response

{
  "results": {
    "op-1": {
      "state": "SUCCESS",
      "exit_code": 0,
      "stdout": "..."
    },
    "op-2": {
      "state": "SUCCESS",
      "exit_code": 0,
      "stdout": "..."
    }
  },
  "completed": ["op-1", "op-2"],
  "cancelled": [],
  "timed_out": false
}

​
Examples

​
Wait for All

{"tool": "wait_operations", "args": {
  "operation_ids": ["op-1", "op-2", "op-3"]
}}

​
Wait for Any (First to Complete)

{"tool": "wait_operations", "args": {
  "operation_ids": ["op-1", "op-2", "op-3"],
  "mode": "any"
}}

​
With Timeout

{"tool": "wait_operations", "args": {
  "operation_ids": ["op-1", "op-2"],
  "timeout": 600
}}

​
Parallel Execution Pattern

// Launch async
{"tool": "run", "args": {"command": "test1.py", "wait": false}}
{"tool": "run", "args": {"command": "test2.py", "wait": false}}
{"tool": "run", "args": {"command": "test3.py", "wait": false}}

// Wait for all
{"tool": "wait_operations", "args": {
  "operation_ids": ["op-1", "op-2", "op-3"]
}}

​
See Also