Can't open the frontend in GitHub Codespaces

[pamelafox]

I am following the path from the Foundry app preview to use the app.

Steps:

1. I opened this repo in GitHub Codespaces
2. I created a .env file with the values
3. I used the default VS Code build task
4. I opened the localhost:5173 port from Codespaces
5. That redirects to this login URL:
   https://login.microsoftonline.com/undefined/oauth2/v2.0/authorize?client_id=undefined&scope=api%3A%2F%2Fundefined%2FChat.ReadWrite%20openid%20profile%20offline_access&redirect_uri=https%3A%2F%2Fglorious-space-dollop-7pjx9rqrgfxp5q-5173.app.github.dev&client-request-id=019cf787-9639-7f66-bcc7-fcc72dc514c6&response_mode=fragment&client_info=1&nonce=019cf787-963b-762c-9e53-91c86648bd44&state=eyJpZCI6IjAxOWNmNzg3LTk2M2ItNzY3My04ZDU3LWIxYTVhZjRlMWFiYSIsIm1ldGEiOnsiaW50ZXJhY3Rpb25UeXBlIjoicmVkaXJlY3QifX0%3D&x-client-SKU=msal.js.browser&x-client-VER=4.29.0&response_type=code&code_challenge=1iGonOlSRxx1TcwA3ruoWG4BUSw5svPn88VDsK6-hJs&code_challenge_method=S256

And that shows this error:

AADSTS900023: Specified tenant identifier 'undefined' is neither a valid DNS name, nor a valid external domain.

Presumably it's because I did not login, but the steps in Foundry do not detail the login step.
Please put the minimal steps in the Foundry dialog, or link to the appropriate spot in the README.
I assume that I do not need to run azd up, since the resources already exist, but perhaps I am wrong.

[pamelafox]

I just tried this locally in VS Code, where I am logged into azd already, and got the same error. So perhaps you are constructing an Entra login scheme that does not have all the details it needs, I haven't looked into the codebase.

[RobiladK]

Thanks for the detailed report, @pamelafox! You're right, the undefined values are because the Entra ID app registration hasn't been provisioned yet.

The Foundry portal's "View sample app code" dialog gives you the AI resource variables (AI_AGENT_ENDPOINT, AI_AGENT_ID), which tell the app which agent to talk to. But this app also needs an Entra ID app registration for authentication, which is created when you run azd up.

The sample actually works without the portal page you referenced. azd up discovers agents in your subscription automatically and connects to them. The portal's .env values are optional; they just skip the discovery step by pointing directly at a specific agent. If you don't provide them, the sample works fine as long as you have an agent in Foundry.

I pushed some updates (ee092c7) to guard against this scenario regardless of whether it's a human, an AI agent, or both working with the repo:

Vite env check plugin - the dev server now shows a clear "Setup Required" error page instead of silently passing undefined to MSAL
README - added a portal callout at the top and expanded the "Coming from the AI Foundry Portal" section explaining what the portal provides vs what azd up creates

devcontainer.json - Codespaces now has azd pre-installed (see #24)
preToolUse hook + agent skill - AI coding agents also get warned about incomplete setup before running dev commands

I agree the Foundry dialog instructions are incomplete for the "clone and run" scenario and I'll flag that to the portal team. Thanks for the feedback!