resonate-basic-debugging-python

What problem does it solve?

Identify and resolve runtime failures, stuck or hanging durable functions, registration mismatches, nondeterministic replays, and server-compat issues that occur when using the Resonate Python SDK, especially for the v0.6.7 legacy-server line.

Core Features & Use Cases

• Triage flow that classifies failures, verifies Python and SDK versions, checks server compatibility, and inspects worker registration and promise state.
• Python-specific generator diagnostics that detect missing yields, incorrect use of async/await, yield from mistakes, and functions that never yield.
• Promise-state and registration troubleshooting, including common error codes, duplicate registration detection, and arguments serialization checks.
• Determinism checks and remediation guidance to move side effects into persisted context calls and to use the SDK's deterministic helpers.
• Quick CLI and minimal repro guidance to reproduce issues locally and inspect invocation trees and promises.

Quick Start

Diagnose a stuck Python Resonate workflow by classifying the failure, verifying Python >= 3.12 and resonate-sdk v0.6.7 compatibility, checking worker registration and promise state, and reporting likely generator or non-determinism causes for the given invocation ID.