Sometimes the “Add” app page does not appear in Teams local debug and remote debug

[HuihuiWu-Microsoft]

Describe the bug

1. Create a simple bot
2. Sign in with m365 account
3. Execute the local debug with 'Debug in Teams(Chrome)' option

Expected: The 'Add' app page should appear

Actual: Sometimes the 'Add' app page does not appear

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

VS Code Extension Information (please complete the following information):

• OS: [e.g. iOS]
• Version [e.g. 22]

CLI Information (please complete the following information):

• OS: [e.g. iOS8.1]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

[HuihuiWu-Microsoft]

Reproduced the issue and captured har file for DP team to check. https://portal.microsofticm.com/imp/v5/incidents/details/813492891/summary?tmpl=n2O3j2

[m365-agent-toolkit-assistant]

👋 Hi @HuihuiWu-Microsoft,

Thank you for reporting this issue! We want to let you know that:

⏱️ Our team will personally review your issue
🎯 You can expect a response within 2 business days

✨ This is an AI-generated initial response
🤖 AI-Generated Preliminary Analysis:

Classification: Upstream — this appears consistent with intermittent Teams client/sideload install behavior, not documented ATK behavior; the local debug doc expects the Add page to appear reliably.

• Learn docs for local debug explicitly say Teams opens the install page and you then select Add; your observed “sometimes missing” flow deviates from that expected Teams client behavior.
• A very similar ATK issue was tracked as upstream: MS Teams showing welcome screen only #13716 MS Teams showing welcome screen only (labeled upstream).
• Another related report, 🐞 Unable to deploy app via sideloading using Teams clients (works via Teams Admin Center) #14740 Unable to deploy app via sideloading using Teams clients, says install works via Teams Admin Center but not Teams clients, again pointing to Teams-side install/sideload instability.
• No changelog entry found for an ATK-side fix specific to this symptom.

Upgrade check: No verified ATK changelog fix for this issue.

What to do now:

1. Confirm ATK version/OS/browser and capture browser console + ATK Output logs.
2. Retry with a fresh Teams web session / alternate browser profile.
3. Verify custom app upload permission in the tenant.
4. As a workaround, install/upload via Teams Admin Center or direct install link.

Useful links:

• OfficeDev/microsoft-365-agents-toolkit#13716 — MS Teams showing welcome screen only
• OfficeDev/microsoft-365-agents-toolkit#14740 — Unable to deploy app via sideloading using Teams clients
• https://learn.microsoft.com/microsoftteams/platform/toolkit/debug-local
• https://learn.microsoft.com/microsoftteams/platform/toolkit/test-app-behavior#upload-your-app-to-teams

If you share logs/version details, I can help narrow whether it’s tenant-, browser-, or Teams-client-specific.

---

Note: This is an automated first response generated by AI. A human team member will review your issue and provide a more detailed response soon. We appreciate your patience!