feat: add wait_for_triggers option to poll instead of suspend

[mjnovice]

Summary

• Add wait_for_triggers and trigger_poll_interval options to UiPathExecuteOptions
• When wait_for_triggers=True, the runtime polls triggers until completion instead of suspending
• This keeps the process running and automatically resumes execution when triggers complete
• Created shared TriggerPoller utility for reusable polling logic
• Refactored UiPathDebugRuntime to use the shared TriggerPoller

Usage

# Execute with wait_for_triggers - process waits instead of suspending
result = await runtime.execute(
    input={"query": "Hello"},
    options=UiPathExecuteOptions(
        wait_for_triggers=True,  # Enable waiting mode
        trigger_poll_interval=5.0,  # Poll every 5 seconds
    )
)

Test plan

• All existing tests pass (55/55)
• Linting passes
• Format checks pass
• Manual testing with actual triggers

🤖 Generated with Claude Code

Development Package

• Add this package as a dependency in your pyproject.toml:

[project]
dependencies = [
  # Exact version:
  "uipath-runtime==0.6.2.dev1000740244",

  # Any version from PR
  "uipath-runtime>=0.6.2.dev1000740000,<0.6.2.dev1000750000"
]

[[tool.uv.index]]
name = "testpypi"
url = "https://test.pypi.org/simple/"
publish-url = "https://test.pypi.org/legacy/"
explicit = true

[tool.uv.sources]
uipath-runtime = { index = "testpypi" }

[cristipufu]

Nope. Please explain what you re trying to achieve

[cristipufu]

If you want polling, just wrap the runtime with a Debug Runtime instantiated with a polling interval gt 0

[mjnovice]

Nope. Please explain what you re trying to achieve

What I am trying to achieve here is experiment the option of running the uipath run ... locally with tool calls, without serverless and orchestrator (as we don't have it in Flow ).

[cristipufu]

The whole point of triggers is persistance. If you don't persist the triggers, you don't need suspend/resume semantics. Just poll for results in the tool itself