Ensure type safety for nested field access

[yedidyakfir]

Goal

Maintain type hints through nested access

Description

Ensure that IDE auto-completion and type checking work correctly when accessing nested fields.

Acceptance Criteria

• Preserve type information through nested access
• IDE auto-completion works for nested fields
• mypy/pyright type checking passes
• Add type stub tests
• Document type safety guarantees