Skip to content

fix: pin hatchet sdk version#903

Merged
yamijuan merged 1 commit intomainfrom
juan/fix-sdk
Mar 6, 2026
Merged

fix: pin hatchet sdk version#903
yamijuan merged 1 commit intomainfrom
juan/fix-sdk

Conversation

@yamijuan
Copy link
Contributor

@yamijuan yamijuan commented Mar 6, 2026

Summary

  • Pin hatchet-sdk==1.22.16 to fix KeyError: detect_chunk_topic in topic detection

Problem

The detect_topics step in the multitrack pipeline fails every time with:

KeyError: <TaskName.DETECT_CHUNK_TOPIC: 'detect_chunk_topic'>

This was caused by the hatchet-sdk upgrade from 1.21.61.27.0 (via dependabot in #886).

Root Cause

In v1.23.0, the hatchet SDK renamed protobuf fields in its gRPC contract:

v1.22.x (old) v1.23.0+ (new)
Result key field result.stepReadableId result.task_name
Run ID field workflowRunId workflow_run_id

The SDK was upgraded but our hatchet server still uses the old protobuf schema. So when aio_run_many() returns child workflow results, the new SDK reads result.task_name (empty string from old server) instead of result.stepReadableId (which has the actual task name). This produces an empty result dict, causing the KeyError on every lookup.

Fix

Pin hatchet-sdk==1.22.16 — the latest version compatible with our current hatchet server. All APIs used by our code (workflow(), .task(), aio_run_many(), create_bulk_run_item(), ctx.task_output()) are present and unchanged in 1.22.16.

Future

To upgrade past 1.22.16, the hatchet server must be upgraded first to a version that serves the new protobuf field names.

@yamijuan yamijuan requested review from smankovsky and tito March 6, 2026 19:20
@yamijuan yamijuan merged commit 504ca74 into main Mar 6, 2026
6 checks passed
@yamijuan yamijuan deleted the juan/fix-sdk branch March 6, 2026 19:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants