Add SpaceXSI conversation integration by jeffglousher · Pull Request #181709 · home-assistant/core

jeffglousher · 2026-09-09T05:39:12Z

Breaking change

None. This adds a new integration.

Proposed change

Add the community-maintained SpaceXSI integration to use Grok as a conversation agent through a subscription.

Setup uses browser-based device authorization and creates one conversation agent per account. Users select a model, instructions, and Home Assistant AI tools. Same-account reauthentication preserves the agent and its settings. No API key or installed CLI is required.

The integration uses Home Assistant's application-credentials and OAuth helpers, shared HTTP sessions, conversation history, and LLM tool interface. Subscription API requests use spacexai-subscription-client==0.1.3.

Validation on a920151 with the released spacexai-subscription-client==0.1.3: all 68 SpaceXSI tests, scoped Ruff and mypy, hassfest, translations, and requirements generation passed locally. GitHub Actions also passed, including prek, mypy, pylint, hassfest, and all ten full-suite test shards.

Type of change

Dependency upgrade
Bugfix (non-breaking change which fixes an issue)
New integration (thank you!)
New feature (which adds functionality to an existing integration)
Deprecation (breaking change to happen in the future)
Breaking change (fix/feature causing existing functionality to break)
Code quality improvements to existing code or addition of tests

Additional information

This PR fixes or closes issue: Not applicable; new integration.
This PR is related to issue: Not applicable.
Link to documentation pull request: Document the SpaceXSI conversation integration home-assistant.io#48027
Link to contributors documentation pull request: Not applicable.
Link to frontend pull request: Not applicable.
Brands pull request: Add SpaceXSI integration branding brands#11129
New dependency: spacexai-subscription-client 0.1.3. Release notes and changes since 0.1.2.

Checklist

I understand the code I am submitting and can explain how it works.
The code change is tested and works locally.
Local tests pass. Your PR cannot be merged unless tests pass
There is no commented out code in this PR.
I have followed the development checklist
I have followed the perfect PR recommendations
The code has been formatted using Ruff (ruff format homeassistant tests)
Tests have been added to verify that the new code works.
Any generated code has been carefully reviewed for correctness and compliance with project standards.

If user exposed functionality or configuration variables are added/changed:

Documentation added/updated for www.home-assistant.io

If the code communicates with devices, web services, or third-party tools:

The manifest file has all fields filled out correctly.
Updated and included derived files by running: python3 -m script.hassfest.
New or updated dependencies have been added to requirements_all.txt.
Updated by running python3 -m script.gen_requirements_all.
For the updated dependencies a diff between library versions and ideally a link to the changelog/release notes is added to the PR description.

To help with the load of incoming pull requests:

I have reviewed two other open pull requests in this repository.

Copilot

🟡 Changes recommended

Setup must reject or recover from a configured model that is no longer available.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds a community-maintained SpaceXAI conversation integration using browser OAuth and Grok models.

Changes:

Adds OAuth device authorization and token refresh.
Adds conversation history, Assist tools, and model selection.
Adds metadata, dependency registration, and comprehensive tests.

File summaries

File	Description
`.strict-typing`	Enables strict typing.
`CODEOWNERS`	Assigns integration ownership.
`homeassistant/components/spacexai/__init__.py`	Manages setup, OAuth, and runtime data.
`homeassistant/components/spacexai/config_flow.py`	Implements device authorization and agent setup.
`homeassistant/components/spacexai/const.py`	Defines integration defaults.
`homeassistant/components/spacexai/conversation.py`	Implements conversation and tool handling.
`homeassistant/components/spacexai/manifest.json`	Registers integration metadata and dependency.
`homeassistant/components/spacexai/quality_scale.yaml`	Declares quality-scale compliance.
`homeassistant/components/spacexai/strings.json`	Adds configuration and error translations.
`homeassistant/generated/config_flows.py`	Registers the config flow.
`homeassistant/generated/integrations.json`	Adds generated integration metadata.
`mypy.ini`	Enables strict mypy checks.
`requirements_all.txt`	Adds the client dependency.
`tests/components/spacexai/__init__.py`	Adds a setup test helper.
`tests/components/spacexai/conftest.py`	Provides shared fixtures.
`tests/components/spacexai/test_config_flow.py`	Tests OAuth and configuration flows.
`tests/components/spacexai/test_conversation.py`	Tests conversations, tools, and errors.
`tests/components/spacexai/test_init.py`	Tests setup, unloading, and refresh behavior.

Review details

Files reviewed: 16/18 changed files
Comments generated: 1
Review effort level: Balanced

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Copilot

🔵 Needs a closer look

The unofficial OAuth integration and cloud-based Assist control path require final human validation.

Review details

Files reviewed: 16/18 changed files
Comments generated: 0 new
Review effort level: Balanced

github-actions · 2026-09-09T11:57:29Z

Check requirements

Checked at commit d6b69cd.

All requirements checks passed. ✅

Package	Old	New	No Advisories	Not Yanked	Repo Public	CI Upload	Release Pipeline	Security	PR Link	Async Safe
spacexai-subscription-client	—	0.1.1	✅	✅	✅	✅	✅	☑️	✅	✅

📦 spacexai-subscription-client: 0.1.1

No Advisories: ✅ No active advisories reported by PyPI for version 0.1.1.
Not Yanked: ✅ Version 0.1.1 is a live (non-yanked) release.
Repo Public: ✅ https://github.com/jeffglousher/spacexai-subscription-client is publicly accessible.
CI Upload: ✅ Trusted Publisher attestation found (GitHub).
Release Pipeline: ✅ OIDC via Trusted Publisher attestation (GitHub); automated CI upload verified by PyPI.
Security: ☑️ Baseline scan found nothing obvious in pyproject.toml, __init__.py, client.py, const.py, errors.py, models.py. This is not a security review — only the cheap checks were run.
PR Link: ✅ PR description links to the source repository at https://github.com/jeffglousher/spacexai-subscription-client (release, source, and changelog links included).
Async Safe: ✅ New dependency reviewed in full at v0.1.1. All network I/O uses aiohttp/httpx/openai async clients, delays use await asyncio.sleep(...), and no sync-blocking patterns (requests, time.sleep, sync sockets, blocking file/DB I/O, subprocess) were found in any async def body.

Generated by Check requirements (AW) · copilot · auto · 34.7 AIC · ⌖ 8.03 AIC · ⊞ 13.7K · ◷

github-actions · 2026-09-09T12:20:00Z

Check requirements

Checked at commit 51d5dcb.

All requirements checks passed. ✅

Package	Old	New	No Advisories	Not Yanked	Repo Public	CI Upload	Release Pipeline	Security	PR Link	Async Safe
spacexai-subscription-client	—	0.1.1	✅	✅	✅	✅	✅	☑️	✅	✅

📦 spacexai-subscription-client: 0.1.1

No Advisories: ✅ No active advisories reported by PyPI for version 0.1.1.
Not Yanked: ✅ Version 0.1.1 is a live (non-yanked) release.
Repo Public: ✅ https://github.com/jeffglousher/spacexai-subscription-client is publicly accessible.
CI Upload: ✅ Trusted Publisher attestation found (GitHub).
Release Pipeline: ✅ OIDC via Trusted Publisher attestation (GitHub); automated CI upload verified by PyPI.
Security: ☑️ Baseline scan found nothing obvious in pyproject.toml, __init__.py, client.py, const.py. This is not a security review — only the cheap checks were run.
PR Link: ✅ PR description links to the source repository at https://github.com/jeffglousher/spacexai-subscription-client/tree/v0.1.1.
Async Safe: ✅ Sole async def surface (client.py) uses aiohttp and the openai async SDK exclusively; no blocking HTTP, file, subprocess, or sleep calls found on the request path.

Generated by Check requirements (AW) · copilot · auto · 40.2 AIC · ⌖ 7.83 AIC · ⊞ 13.7K · ◷

Copilot

🔵 Needs a closer look

The unofficial OAuth integration and cloud-based Assist control path require final human validation.

Review details

Files reviewed: 16/18 changed files
Comments generated: 0 new
Review effort level: Balanced

joostlek · 2026-10-14T20:26:02Z

+def oauth_implementation(hass: HomeAssistant) -> LocalOAuth2Implementation:
+    """Return the public OAuth implementation used by Grok CLI."""
+    return LocalOAuth2Implementation(
+        hass=hass,
+        domain=DOMAIN,
+        client_id=GROK_CLI_OAUTH_CLIENT_ID,
+        client_secret="",
+        authorize_url=AUTHORIZE_URL,
+        token_url=TOKEN_URL,
+    )


why isn't this in application_credentials.py

It mostly came from borrowing the idea from Hermes Agent and then trying to split what was necessary between the library and the HA side. I missed this, but it can be collapsed. Thanks—I’ll follow up with the code.

joostlek · 2026-10-14T20:29:48Z

+    @override
+    async def async_step_user(
+        self, user_input: dict[str, Any] | None = None
+    ) -> ConfigFlowResult:
+        """Start device authorization."""
+        return await self.async_step_device()
+
+    async def async_step_device(


why do we split this?

I was trying to keep it simple and separate concerns, but that’s a better idea. I’ll collapse the steps.

joostlek · 2026-10-14T20:56:00Z

+        return self.async_show_form(
+            step_id="conversation",
+            data_schema=vol.Schema(
+                {
+                    vol.Required(CONF_MODEL): SelectSelector(
+                        SelectSelectorConfig(
+                            options=self._models,
+                            mode=SelectSelectorMode.DROPDOWN,
+                            sort=True,
+                        )
+                    ),


why don't you use subentries so you can add multiple models for the same account

I do want better capabilities and have been working on more, but I was trying to keep the first PR very simple. Could we leave the extra agents for a follow-up?

joostlek · 2026-10-14T20:56:10Z

+from homeassistant.const import CONF_LLM_HASS_API, CONF_PROMPT
+from homeassistant.helpers import llm
+
+DOMAIN = "spacexai"


isn't it like x_ai?

It's SpaceXSI now 😂

It’s been a moving target. Looks like the current branding guidelines now say SpaceXSI.

home-assistant · 2026-10-14T20:56:34Z

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

Copilot

🔵 Needs a closer look

The unofficial subscription OAuth path still needs human validation of live sign-in and reauthentication on the current revision.

No open issues 🎉

_{Review effort: Balanced}

github-actions · 2026-10-24T17:22:37Z

Check requirements

Checked at commit 9ee4053.

All requirements checks passed. ✅

Package	Old	New	No Advisories	Not Yanked	Repo Public	CI Upload	Release Pipeline	Security	PR Link	Async Safe
spacexai-subscription-client	—	0.1.1	✅	✅	✅	✅	✅	☑️	✅	✅

📦 spacexai-subscription-client: 0.1.1

No Advisories: ✅ No active advisories reported by PyPI for version 0.1.1.
Not Yanked: ✅ Version 0.1.1 is a live (non-yanked) release.
Repo Public: ✅ https://github.com/jeffglousher/spacexai-subscription-client is publicly accessible.
CI Upload: ✅ Trusted Publisher attestation found (GitHub).
Release Pipeline: ✅ OIDC via Trusted Publisher attestation (GitHub); automated CI upload verified by PyPI.
Security: ☑️ Baseline scan found nothing obvious in __init__.py, client.py, const.py, errors.py, models.py, and pyproject.toml. All network calls target auth.x.ai/cli-chat-proxy.grok.com, consistent with the package's stated purpose (unofficial Grok/SpaceXAI OAuth client). No execution of network-sourced data, no filesystem access outside the HA integration's documented API, no secret exfiltration patterns, and no obfuscated code. This is not a security review — only the cheap checks were run.
PR Link: ✅ PR description links to the source repository (release and source tree at v0.1.1): https://github.com/jeffglousher/spacexai-subscription-client/releases/tag/v0.1.1
Async Safe: ✅ No blocking calls found. The entire source tree (new package) uses aiohttp/httpx async clients and asyncio.sleep for device-code polling backoff; no sync HTTP, time.sleep, blocking file/DB I/O, or subprocess calls appear in any async def body or its helpers.

Generated by Check requirements (AW) · copilot · auto · 37 AIC · ⌖ 7.7 AIC · ⊞ 5K · ◷

Copilot

🟡 Changes recommended

Tool-result serialization drops the independent error flag, making failed and successful calls with identical data indistinguishable to the provider.

1 open issue

Test conversation history across reused conversation ID · New

2 resolved since last review

_{Review effort: Balanced}

Copilot

🔵 Needs a closer look

Live sign-in, token refresh, and same-account reauthentication require human validation because mocked tests cannot establish provider compatibility with the unofficial API and third-party OAuth client.

1 open issue

Test conversation history across reused conversation ID

_{Review effort: Balanced}

Copilot

🔵 Needs a closer look

Provider compatibility remains unverified for the unofficial subscription API and reused Grok CLI OAuth client, requiring maintainer end-to-end validation of live sign-in, same-account reauthentication, and token refresh.

1 open issue

Test conversation history across reused conversation ID

_{Review effort: Balanced}

Copilot

🔵 Needs a closer look

The current revision needs human validation of live sign-in, token refresh, and same-account reauthentication against the unofficial subscription API, which mocked integration tests cannot establish.

1 open issue

Test conversation history across reused conversation ID

_{Review effort: Balanced}

…sh-20261027

Copilot

🔵 Needs a closer look

Human validation is needed because mocked tests do not establish provider support for the third-party CLI OAuth client or compatibility with live refresh-token rotation.

No open issues 🎉

1 resolved since last review

Test conversation history across reused conversation ID

_{Review effort: Balanced}

…sh-20261027

Copilot

🟡 Changes recommended

The PR description references dependency version 0.1.2 while the manifest and requirements pin 0.1.3, leaving validation of the shipped version unclear.

1 open issue

Align PR description with the pinned dependency version · New

_{Review effort: Balanced}

+  "integration_type": "service",
+  "iot_class": "cloud_polling",
+  "quality_scale": "bronze",
+  "requirements": ["spacexai-subscription-client==0.1.3"]


Copilot

🔵 Needs a closer look

Human validation is needed because the new subscription client is unavailable for inspection or end-to-end verification, leaving its provider API contract and Grok public OAuth device authorization unverified beyond mocked tests.

1 open issue

Align PR description with the pinned dependency version

_{Review effort: Balanced}

Copilot AI balanced review requested due to automatic review settings September 9, 2026 05:39

home-assistant Bot added cla-signed has-tests integration: spacexai new-integration quality-scale labels Sep 9, 2026

Copilot started reviewing on behalf of jeffglousher September 9, 2026 05:39

View session

This was referenced Sep 9, 2026

Document the SpaceXSI conversation integration home-assistant/home-assistant.io#48027

Draft

Add SpaceXSI integration branding home-assistant/brands#11129

Draft

Copilot AI reviewed Sep 9, 2026

View reviewed changes

Comment thread homeassistant/components/spacexai/__init__.py Resolved

Copilot AI review requested due to automatic review settings September 9, 2026 11:43

Copilot started reviewing on behalf of jeffglousher September 9, 2026 11:44

View session

Copilot AI reviewed Sep 9, 2026

View reviewed changes

Copilot AI review requested due to automatic review settings September 9, 2026 12:13

jeffglousher marked this pull request as ready for review September 9, 2026 12:14

Copilot started reviewing on behalf of jeffglousher September 9, 2026 12:14

View session

Copilot AI reviewed Sep 9, 2026

View reviewed changes

joostlek requested changes Oct 14, 2026

View reviewed changes

home-assistant Bot marked this pull request as draft October 14, 2026 20:56

jeffglousher changed the title ~~Add SpaceXAI conversation integration~~ Add SpaceXSI conversation integration Oct 24, 2026

Copilot AI balanced review requested due to automatic review settings October 24, 2026 17:17

Copilot started reviewing on behalf of jeffglousher October 24, 2026 17:18

View session

Copilot AI reviewed Oct 24, 2026

View reviewed changes

jeffglousher force-pushed the codex/spacexai/upstream-initial branch from 9ee4053 to dd28564 Compare October 27, 2026 12:07

Copilot AI balanced review requested due to automatic review settings October 27, 2026 12:07

Copilot started reviewing on behalf of jeffglousher October 27, 2026 12:08

View session

jeffglousher force-pushed the codex/spacexai/upstream-initial branch from cb70784 to 434bdba Compare October 27, 2026 12:19

Copilot AI reviewed Oct 27, 2026

View reviewed changes

Comment thread homeassistant/components/spacexsi/conversation.py Resolved

Copilot AI balanced review requested due to automatic review settings October 27, 2026 12:22

Copilot started reviewing on behalf of jeffglousher October 27, 2026 12:22

View session

jeffglousher force-pushed the codex/spacexai/upstream-initial branch from 434bdba to 7fc5f85 Compare October 27, 2026 12:25

Copilot AI reviewed Oct 27, 2026

View reviewed changes

Copilot AI balanced review requested due to automatic review settings October 27, 2026 12:27

Copilot started reviewing on behalf of jeffglousher October 27, 2026 12:28

View session

Copilot AI reviewed Oct 27, 2026

View reviewed changes

Add SpaceXSI conversation integration

7247149

jeffglousher force-pushed the codex/spacexai/upstream-initial branch from 7fc5f85 to 7247149 Compare October 28, 2026 01:58

Copilot AI balanced review requested due to automatic review settings October 28, 2026 01:58

Copilot started reviewing on behalf of jeffglousher October 28, 2026 01:58

View session

Copilot AI reviewed Oct 28, 2026

View reviewed changes

jeffglousher added 4 commits October 29, 2026 17:16

Merge remote-tracking branch 'upstream/dev' into codex/spacexsi/publi…

364f602

…sh-20261027

Merge remote-tracking branch 'upstream/dev' into codex/spacexsi/publi…

2784019

…sh-20261027

Merge upstream dev into SpaceXSI contribution

9e0fdce

Guard SpaceXSI type-narrowing assertions

3f3695a

Copilot AI balanced review requested due to automatic review settings October 30, 2026 14:18

Copilot started reviewing on behalf of jeffglousher October 30, 2026 14:18

View session

Copilot AI reviewed Oct 30, 2026

View reviewed changes

jeffglousher added 2 commits November 2, 2026 08:06

Clarify SpaceXSI model retry and consume client 0.1.3

dbb3fcb

Merge remote-tracking branch 'upstream/dev' into codex/spacexsi/publi…

a920151

…sh-20261027

Copilot AI balanced review requested due to automatic review settings November 2, 2026 14:16

Copilot started reviewing on behalf of jeffglousher November 2, 2026 14:16

View session

Copilot AI reviewed Nov 2, 2026

View reviewed changes

Comment thread homeassistant/components/spacexsi/manifest.json

"integration_type": "service",

"iot_class": "cloud_polling",

"quality_scale": "bronze",

"requirements": ["spacexai-subscription-client==0.1.3"]

Correct SpaceXSI shared HTTP client documentation

a24bf9e

Copilot AI balanced review requested due to automatic review settings November 3, 2026 03:18

Copilot started reviewing on behalf of jeffglousher November 3, 2026 03:19

View session

Copilot AI reviewed Nov 3, 2026

View reviewed changes

Conversation

jeffglousher commented Sep 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Breaking change

Proposed change

Type of change

Additional information

Checklist

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

github-actions Bot commented Sep 9, 2026

Check requirements

Uh oh!

github-actions Bot commented Sep 9, 2026

Check requirements

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

home-assistant Bot commented Oct 14, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

github-actions Bot commented Oct 24, 2026

Check requirements

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🔵 Needs a closer look

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟡 Changes recommended

Uh oh!

jeffglousher commented Sep 9, 2026 •

edited

Loading