fix(docs): prioritize interrupt check in SQL agent HITL example

[leecode]

Overview

check for interrupt before messages to ensure interrupts are not skipped when both keys exist in the stream step.

Type of change

Type: Fix bug

Related issues/PRs

Checklist

• I have read the contributing guidelines
• I have tested my changes locally using docs dev
• All code examples have been tested and work correctly
• I have used root relative paths for internal links
• I have updated navigation in src/docs.json if needed

Additional notes

Problem

The current SQL agent human-in-the-loop example checks for messages before __interrupt__ in the stream loop:

if "messages" in step:
    step["messages"][-1].pretty_print()
elif "__interrupt__" in step:  # This may never execute
    print("INTERRUPTED:")

This creates a potential bug: if a stream step contains both messages and interrupt keys simultaneously, the interrupt handling block will never execute due to the elif condition.

Solution

Reorder the condition checks to prioritize interrupt detection:

  if "__interrupt__" in step:  # Check interrupt first
      print("INTERRUPTED:")
      interrupt = step["__interrupt__"][0]
      for request in interrupt.value["action_requests"]:
          print(request["description"])
  elif "messages" in step:
      step["messages"][-1].pretty_print()

This ensures that interrupts are always detected and handled correctly, even when messages are present in the same step.