docs: document wait until and timer race interrupts

[radu-mocanu]

Summary

• document WaitUntil time-based interrupts
• document racing multiple resume conditions with interrupt([..., WaitUntil(...)])
• rename the timeout sample to invoke-process-timer-race-agent and include bindings for the child process
• add a typed time interrupt mock used by resumable runtime tests
• save resume trigger sets atomically in state.db

Depends on: UiPath/uipath-python#1769
Depends on: UiPath/uipath-runtime-python#138

Development Package

• Use uipath pack --nolock to get the latest dev build from this PR (requires version range).
• Add this package as a dependency in your pyproject.toml:

[project]
dependencies = [
  # Exact version:
  "uipath-langchain==0.13.13.dev1009495094",

  # Any version from PR
  "uipath-langchain>=0.13.13.dev1009490000,<0.13.13.dev1009500000"
]

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

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

[tool.uv]
override-dependencies = [
    "uipath-langchain>=0.13.13.dev1009490000,<0.13.13.dev1009500000",
]

[Copilot]

Pull request overview

Documents time-based typed interrupts (WaitUntil) and interrupt timeout handling, and adds test/mocks to validate typed time interrupt values flow through the resumable runtime trigger plumbing.

Changes:

• Add runtime test coverage ensuring a timer-shaped typed interrupt is forwarded unchanged to the trigger handler.
• Introduce a HITL mock graph that uses WaitUntil for timer-style suspension.
• Extend HITL documentation with WaitUntil behavior and typed interrupt timeout helpers (is_timeout, assert_no_timeout).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
tests/runtime/test_resumable.py	Adds a typed timer-shaped interrupt model + trigger handler mock and a new test asserting typed interrupt pass-through.
tests/hitl/mocks/time_trigger_hitl.py	Adds a sample HITL graph that suspends via WaitUntil using a time-based resume condition.
docs/human_in_the_loop.md	Documents WaitUntil time triggers and typed interrupt timeout handling helpers.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud