refactor(types): remove redundant total=False from TypedDict definitions

[cofin]

Summary

Removes the redundant total=False parameter from all TypedDict class definitions throughout the codebase. When total=False is used with NotRequired[...] wrappers on all fields, it creates unnecessary redundancy and confusion.

Problem

The anti-pattern was pervasive across the entire codebase:

# BEFORE (redundant and confusing)
class MyConfig(TypedDict, total=False):
    field1: NotRequired[str]  # Already optional due to total=False
    field2: NotRequired[int]  # NotRequired is redundant here

When total=False is specified, all fields are implicitly optional, making the NotRequired[...] wrapper redundant. This pattern was:

• Confusing to readers
• Against Python typing best practices
• Inconsistent with the purpose of NotRequired

Solution

Use the correct TypedDict pattern where total=True (the default) with explicit NotRequired[...] for optional fields:

# AFTER (correct and clear)
class MyConfig(TypedDict):
    field1: NotRequired[str]  # Explicitly optional
    field2: NotRequired[int]  # Clear intent

Changes Made

Python Files (15 files, 30+ TypedDict classes)

• sqlspec/config.py - LifecycleConfig, MigrationConfig, LitestarConfig
• sqlspec/adapters/adbc/config.py - AdbcConnectionParams, AdbcDriverFeatures
• sqlspec/adapters/aiosqlite/config.py - AiosqliteConnectionParams, AiosqlitePoolParams, AiosqliteDriverFeatures
• sqlspec/adapters/asyncmy/config.py - AsyncmyConnectionParams, AsyncmyPoolParams, AsyncmyDriverFeatures
• sqlspec/adapters/asyncpg/config.py - AsyncpgConnectionConfig, AsyncpgPoolConfig, AsyncpgDriverFeatures
• sqlspec/adapters/bigquery/config.py - BigQueryConnectionParams, BigQueryDriverFeatures
• sqlspec/adapters/duckdb/config.py - DuckDBConnectionParams, DuckDBExtensionConfig, DuckDBSecretConfig, DuckDBDriverFeatures
• sqlspec/adapters/oracledb/config.py - OracleConnectionParams, OraclePoolParams, OracleDriverFeatures
• sqlspec/adapters/psqlpy/config.py - PsqlpyConnectionParams, PsqlpyPoolParams, PsqlpyDriverFeatures
• sqlspec/adapters/psycopg/config.py - PsycopgConnectionParams, PsycopgPoolParams, PsycopgDriverFeatures
• sqlspec/adapters/sqlite/config.py - SqliteConnectionParams, SqliteDriverFeatures
• sqlspec/adapters/sqlite/pool.py - SqliteConnectionParams
• sqlspec/extensions/adk/config.py - ADKConfig
• sqlspec/extensions/litestar/config.py - LitestarConfig

Documentation (1 file, 8 examples)

• AGENTS.md - Updated all TypedDict examples in driver_features pattern documentation

Benefits

✅ Clarity: Fields are explicitly marked as optional with NotRequired
✅ Consistency: One canonical way to define optional fields
✅ Best Practices: Aligns with Python typing standards
✅ IDE Support: Better type checking and autocomplete
✅ Maintainability: Less confusion for contributors

Testing

• ✅ make fix - All linting passes
• ✅ pyright - 0 errors, 0 warnings
• ✅ No functional changes to type behavior
• ✅ All NotRequired[...] wrappers preserved exactly

Impact

No breaking changes - This is purely a refactor of type definitions. The runtime behavior and type checking behavior remain identical.

References

• Python typing documentation on TypedDict
• PEP 655 - Marking individual TypedDict items as required or not-required