refactor(api): type celery sqlcommenter tags with CelerySqlcommenterTagsDict TypedDict

[YB0y]

Summary

• Add CelerySqlcommenterTagsDict TypedDict (total=False) with keys framework, task_name, traceparent, celery_retries, routing_key
• Annotate return type of _build_celery_sqlcommenter_tags and its local variable

Why this change

_build_celery_sqlcommenter_tags builds a dict with 5 well-known optional keys but was typed as dict[str, str | int]. The TypedDict documents exactly which SQL commenter tags can appear and their individual types (str vs int for celery_retries).

Changes

• extensions/otel/celery_sqlcommenter.py: Define CelerySqlcommenterTagsDict, update function return type and local variable annotation

Test plan

• ruff check passes

Part of #32863 (extensions/otel/celery_sqlcommenter.py)

[github-actions]

Pyrefly Diff

base → PR

--- /tmp/pyrefly_base.txt	2026-04-03 11:58:31.401059777 +0000
+++ /tmp/pyrefly_pr.txt	2026-04-03 11:58:22.230073476 +0000
@@ -6025,8 +6025,6 @@
    --> tests/unit_tests/enterprise/telemetry/test_exporter.py:582:71
 ERROR Argument `dict[str, str]` is not assignable to parameter `labels` with type `dict[str, AttributeValue]` in function `enterprise.telemetry.exporter.EnterpriseExporter.record_histogram` [bad-argument-type]
    --> tests/unit_tests/enterprise/telemetry/test_exporter.py:615:85
-ERROR Object of class `int` has no attribute `startswith` [missing-attribute]
-  --> tests/unit_tests/extensions/otel/test_celery_sqlcommenter.py:25:16
 ERROR Cannot index into `object` [bad-index]
    --> tests/unit_tests/extensions/otel/test_celery_sqlcommenter.py:136:20
 ERROR Cannot index into `object` [bad-index]