Add wall-clock timeout to reflect operations

[ThePlenkov]

Reflect has no overall timeout. With high budget (20 iterations × 120s LLM timeout), a single call can hang for ~40 minutes.

Changes

• Config: HINDSIGHT_API_REFLECT_WALL_TIMEOUT env var (default 300s)
• Engine: Wrap run_reflect_agent() in asyncio.wait_for() inside reflect_async()
• HTTP: Catch TimeoutError in reflect endpoint, return 504
• Test: Unit test for timeout enforcement

MCP callers are already covered by the existing except Exception handler—no changes needed there.

# memory_engine.py
try:
    agent_result = await asyncio.wait_for(
        run_reflect_agent(...),
        timeout=wall_timeout,
    )
except asyncio.TimeoutError:
    raise TimeoutError(
        f"Reflect operation timed out after {wall_timeout} seconds. "
        f"Consider reducing the budget or simplifying the query."
    )

Timeout is enforced at the reflect_async() level so both HTTP and MCP callers are protected.

Reflect operations have no overall wall-clock timeout ��� only per-LLM-call timeouts. With high budget (20 iterations �� 120s default LLM timeout), a reflect call can hang for ~40 minutes.

Fixes REDACTED` (http block)

• https://api.github.com/repos/vectorize-io/hindsight/pulls
  • Triggering command: /usr/bin/curl curl -s -w \n%{http_code} -X POST -H Authorization: token ****** -H Accept: application/vnd.github+json REDACTED -d { "title": "feat: add wall-clock timeout to reflect operations (fixes #642)", "body": "## Summary\n\nReflect operations have no overall wall-clock timeout ��� only per-LLM-call timeouts. With high budget (20 iterations �� 120s default LLM timeout) (http block)
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

⌨️ Start Copilot coding agent tasks without leaving your editor — available in VS Code, Visual Studio, JetBrains IDEs and Eclipse.

[nicoloboschi]

Great idea, LGTM