HKUDS/DeepTutor · error · RuntimeError

GitHub Copilot auth is unavailable. Validate local Copilot a

Error message

GitHub Copilot auth is unavailable. Validate local Copilot auth or log in first.

What it means

The GitHub Copilot provider exchanges a locally stored GitHub OAuth token for a short-lived Copilot token; if no stored GitHub token exists, _exchange_token raises RuntimeError telling the user to log in first.

Source

Thrown at deeptutor/services/llm/provider_core/github_copilot_provider.py:65

    async def _load_stored_github_token(self) -> str | None:
        try:
            from oauth_cli_kit.storage import FileTokenStorage
        except ImportError:
            return None
        storage = FileTokenStorage(  # nosec B106 - token_filename is a file name, not a password.
            token_filename="github-copilot.json",
            app_name="nanobot",
            import_codex_cli=False,
        )
        token = storage.load()
        if not token or not getattr(token, "access", None):
            return None
        return str(token.access)

    async def _exchange_token(self) -> str:
        github_token = await self._load_stored_github_token()
        if not github_token:
            raise RuntimeError(
                "GitHub Copilot auth is unavailable. Validate local Copilot auth or log in first."
            )

        timeout = httpx.Timeout(20.0, connect=20.0)
        async with httpx.AsyncClient(
            timeout=timeout, follow_redirects=True, trust_env=True
        ) as client:
            response = await client.get(
                DEFAULT_COPILOT_TOKEN_URL,
                headers={
                    "Authorization": f"token {github_token}",
                    "Accept": "application/json",
                    "User-Agent": USER_AGENT,
                    "Editor-Version": EDITOR_VERSION,
                    "Editor-Plugin-Version": EDITOR_PLUGIN_VERSION,
                },
            )
            response.raise_for_status()

View on GitHub (pinned to 3e82f13042)

Solutions

Run `deeptutor provider login github-copilot` (or sign in via GitHub Copilot tooling) to populate the token store.
Verify the token store file exists and contains an oauth token for github.com.
Re-run after checking file permissions on the config directory.

Defensive patterns

Strategy: validation

Validate before calling

from pathlib import Path

def copilot_auth_present() -> bool:
    # token store location used by the provider
    return Path.home().joinpath('.config/github-copilot/hosts.json').exists()

Try / catch

try:
    resp = await provider.chat(messages)
except RuntimeError as e:
    if 'log in first' in str(e):
        prompt_user_to_login('deeptutor provider login github-copilot')
    else:
        raise

Prevention

Run provider login during environment provisioning scripts
Check token store existence before enabling the Copilot provider
Re-login on a schedule or on auth failures

When it happens

Trigger: Calling chat via the Copilot provider with an empty/expired GitHub token store (e.g. ~/.config/github-copilot/ missing or devoid of hosts entries); _chat_impl → _exchange_token finds _load_stored_github_token() returning None.

Common situations: Never having run `deeptutor provider login github-copilot`; token store deleted; Copilot plugin auth files not present on a new machine/CI.

Related errors

AI-assisted analysis of HKUDS/DeepTutor@3e82f13042 (2026-08-27). Data as JSON: /api/errors/d0238a51ccdc73ad. Report an issue: GitHub.