Fix Pyright reportMissingImports for sphinx_autodoc_typehints in docs conf.py files

[Copilot]

Summary

Pyright scans docs/ but the default poe install excludes the docs dependency group, causing reportMissingImports on the sphinx_autodoc_typehints import in both conf.py files in a fresh dev environment.

Added reportMissingImports to the existing # pyright: ignore inline suppression on the conditional import — the minimal, targeted fix:

# Before
import sphinx_autodoc_typehints  # noqa: F401  # pyright: ignore[reportUnusedImport]

# After
import sphinx_autodoc_typehints  # noqa: F401  # pyright: ignore[reportUnusedImport,reportMissingImports]

Applied to both:

• docs/source/conf.py
• agents/agent1/docs/source/conf.py

Testing

• Not run (why?)
• uv run poe check
• Other: pyright agents/agent1/docs/source/conf.py docs/source/conf.py → 0 errors, 0 warnings, 0 informations

Checklist

• Linked issue or task reference
• Added/updated tests where relevant
• Updated docs/README if needed
• No secrets or sensitive data added
• Considered backward compatibility and deployment impact

Additional context

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Fix Pyright failure: suppress missing-import for sphinx_autodoc_typehints in docs/source/conf.py</issue_title>
<issue_description>## Summary

agents/agent1/docs/source/conf.py is included in Pyright's scan (via [tool.pyright].include), but the docs dependency group is excluded from the default poe setup/install. This means Pyright will fail with a reportMissingImports error for sphinx_autodoc_typehints in a fresh dev environment unless the docs group is explicitly installed.

File / Line

• File: agents/agent1/docs/source/conf.py
• Line: 52

Original Review Comment

This file is type-checked by Pyright (docs are included), but later it conditionally imports sphinx_autodoc_typehints without a reportMissingImports suppression. Since the default poe setup/install excludes the docs dependency group, Pyright will commonly fail in a fresh dev env unless you either (a) add a Pyright missing-import ignore for that import, (b) exclude docs from Pyright, or (c) install the docs group by default.

Suggested Fix

Choose one of:

• (a) Add a # type: ignore[import] (or # pyright: ignore[reportMissingImports]) comment on the sphinx_autodoc_typehints import line in conf.py.
• (b) Exclude docs/ from Pyright's include list in pyproject.toml.
• (c) Install the docs dependency group by default in the dev setup task.

Context

Related PR: #51
Review comment: #51 (comment)

Generated by PR Review Comment — Create Issue for issue #51

Comments on the Issue (you are @copilot in this section)

• Fixes Fix Pyright failure: suppress missing-import for sphinx_autodoc_typehints in docs/source/conf.py #74

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[Copilot]

Copilot wasn't able to review any files in this pull request.