Create a new Devin session with a playbook and prompt.

Args: prompt: The task prompt (e.g., "thoughts/shared/plans/2024-01-15-auth.md, phase 1, branch feature/auth") playbook_id: The Devin playbook ID to use. Optional if DEVIN_PLAYBOOK_ID env var is set.

Returns: dict with keys: - success: bool indicating if session was created - session_id: The created session ID (if success) - url: The session URL (if success) - error: Error message (if not success)

Quick, non-blocking status check on a Devin session.

Args: session_id: The session ID to check

Returns: dict with keys: - success: bool indicating if status was retrieved - session_id: The session ID - url: The session URL (if success) - status_enum: Current status (if success) - error: Error message (if not success)

Poll a Devin session until it reaches a terminal state.

Args: session_id: The session ID to monitor timeout: Maximum seconds to wait (default: 600 = 10 minutes)

Returns: Full session details if completed within timeout. Raises DevinTimeoutError if timeout exceeded.

The tool polls every 5 seconds and returns when status_enum is one of: blocked, finished, expired, stopped, suspend_requested, suspend_requested_frontend

Send a follow-up message to a Devin session.

Use this when Devin is blocked and needs clarification to continue.

Args: session_id: The session ID to message message: The message content to send

Returns: dict with keys: - success: bool indicating if message was sent - detail: Confirmation message (if success) - error: Error message (if not success)