fix: unbreak SDK generation (pyright, not mypy/pylint, gates Compile SDK)

scripts/postprocess-connect.py

@@ -13,12 +13,18 @@
    absolute imports that only resolve with the output dir on sys.path.
 2. Drop dangling ``from . import <pkg>`` lines from the package stubs, for the
    subtrees generate-connect.sh deletes (platform/, demo/, google/protobuf/).
-3. Prepend lint/typecheck opt-outs. Generated protobuf code is never clean
-   under either tool (~64k pylint messages: no-member, abstract-method,
-   protected-access; plus stub/types-protobuf mismatches under mypy).
+3. Prepend lint/typecheck opt-outs for all three checkers this repo runs:
+   pylint, mypy, and pyright. Generated protobuf code is never clean under any
+   of them (~64k pylint messages: no-member, abstract-method, protected-access;
+   stub/types-protobuf mismatches under mypy; ClassVar-in-extension-stub and
+   ``_ExtensionDict`` under pyright).
 
 ``# mypy: ignore-errors`` only suppresses *reporting* inside these files — the
 declared types are still used, so callers keep real protobuf types.
+
+pyright is the one that gates CI: it is what Speakeasy's "Compile SDK" step
+runs. mypy and pylint being clean locally says nothing about whether generation
+will pass. Reproduce with ``uv run pyright src/`` before pushing.
 """
 
 from __future__ import annotations
@@ -27,7 +33,16 @@
 import sys
 from pathlib import Path
 
-HEADERS = ("# pylint: skip-file", "# mypy: ignore-errors")
+HEADERS = (
+    "# pylint: skip-file",
+    "# mypy: ignore-errors",
+    # Speakeasy's "Compile SDK" step runs pyright, which the two headers above do
+    # nothing for. Only the rules the protobuf pyi plugin actually trips are
+    # disabled -- notably NOT reportMissingImports, which is what fires when
+    # `speakeasy run` regenerates pyproject.toml without connect-python and
+    # evicts the dependency. That one must keep failing loudly.
+    "# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false",
+)
 
 # `import a.b.c_pb2 as _alias` / `from a.b import c_pb2 as _alias`. Bare
 # `import x`/`from x import y` without an alias never appears in the generated

src/textql_sdk/_connect/__init__.py

@@ -1,2 +1,3 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors

src/textql_sdk/_connect/__init__.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from . import auth_pb2

src/textql_sdk/_connect/auth_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/auth_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/auth_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/buf/__init__.py

@@ -1,2 +1,3 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors

src/textql_sdk/_connect/buf/__init__.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from . import validate

src/textql_sdk/_connect/buf/validate/__init__.py

@@ -1,2 +1,3 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors

src/textql_sdk/_connect/buf/validate/__init__.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from . import validate_pb2

src/textql_sdk/_connect/buf/validate/validate_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/buf/validate/validate_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/compute_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/compute_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/compute_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from google.protobuf import empty_pb2 as _empty_pb2

src/textql_sdk/_connect/google/__init__.py

@@ -1,2 +1,3 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors

src/textql_sdk/_connect/google/__init__.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from . import api

src/textql_sdk/_connect/google/api/__init__.py

@@ -1,2 +1,3 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors

src/textql_sdk/_connect/google/api/__init__.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from . import visibility_pb2

src/textql_sdk/_connect/google/api/visibility_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/google/api/visibility_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from google.protobuf import descriptor_pb2 as _descriptor_pb2

src/textql_sdk/_connect/paradigm_params_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/paradigm_params_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from .google.api import visibility_pb2 as _visibility_pb2

src/textql_sdk/_connect/powerbi_selection_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/powerbi_selection_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from google.protobuf.internal import containers as _containers

src/textql_sdk/_connect/public/__init__.py

@@ -1,2 +1,3 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors

src/textql_sdk/_connect/public/__init__.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from . import agent_pb2

src/textql_sdk/_connect/public/agent_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/agent_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/agent_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/api_oauth_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/api_oauth_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/api_oauth_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/apps_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/apps_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/apps_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/audit_log_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/audit_log_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/audit_log_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/auth_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/auth_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/auth_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/cells_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/cells_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/chat_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/chat_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/chat_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/checks_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/checks_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/checks_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/common_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/common_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper

src/textql_sdk/_connect/public/communications_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/communications_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/communications_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from ..public import options_pb2 as _options_pb2

src/textql_sdk/_connect/public/config_source_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/config_source_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper

src/textql_sdk/_connect/public/connector_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/connector_member_auth_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/connector_member_auth_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/connector_member_auth_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from ..public import options_pb2 as _options_pb2

src/textql_sdk/_connect/public/connector_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/connector_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/context_prompts_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/context_prompts_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/context_prompts_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/dashboard_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/dashboard_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/dashboard_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime

src/textql_sdk/_connect/public/databricks_oauth_connect.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping

src/textql_sdk/_connect/public/databricks_oauth_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/databricks_oauth_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 from ..public import options_pb2 as _options_pb2

src/textql_sdk/_connect/public/dataframe_pb2.py

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 """Generated protocol buffer code."""

src/textql_sdk/_connect/public/dataframe_pb2.pyi

@@ -1,3 +1,4 @@
+# pyright: reportInvalidTypeForm=false, reportAttributeAccessIssue=false
 # pylint: skip-file
 # mypy: ignore-errors
 import datetime