docs(langchain): add time trigger interrupts

[radu-mocanu]

Summary:

• Document WaitTimeTrigger usage with cronExpression and timeZoneId.
• Add a LangGraph regression test for typed timer-shaped interrupt pass-through.
• Add a HITL mock showing interrupt(WaitTimeTrigger(...)).

Tests:

• uv run pytest tests/runtime/test_resumable.py -q
• uv run ruff check tests/runtime/test_resumable.py tests/hitl/mocks/time_trigger_hitl.py

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.11.dev1009485067",

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

[[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.11.dev1009480000,<0.13.11.dev1009490000",
]

[Copilot]

Pull request overview

Adds documentation and examples for Orchestrator-backed time trigger interrupts, and introduces a regression test to ensure “timer-shaped” typed interrupt payloads are forwarded through the resumable runtime unchanged.

Changes:

• Documented WaitTimeTrigger usage, including cron_expression and time_zone_id, in the HITL guide.
• Added a regression test validating typed timer-like interrupt pass-through to the trigger handler.
• Added a HITL mock graph demonstrating interrupt(WaitTimeTrigger(...)).

Reviewed changes

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

File	Description
tests/runtime/test_resumable.py	Adds a pydantic timer-like interrupt model, capturing trigger handler, and regression test asserting typed interrupt pass-through and serialized payload shape.
tests/hitl/mocks/time_trigger_hitl.py	Adds a minimal HITL mock graph showing how to suspend with WaitTimeTrigger.
docs/human_in_the_loop.md	Adds a new “Time triggers” section documenting WaitTimeTrigger and showing an example interrupt payload.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud

[radu-mocanu]

Closing in favor of the split PR stack and replacement LangChain PR #949.