feat(amazonq): Auto Debug Functionality #7609
Open
+3,190
−26
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
… ## Problem - to reduce # of service calls within short time duration and result in throttling error thrown - ## Solution --- - Treat all work as PUBLIC. Private `feature/x` branches will not be squash-merged at release time. - Your code changes must meet the guidelines in [CONTRIBUTING.md](https://github.com/aws/aws-toolkit-vscode/blob/master/CONTRIBUTING.md#guidelines). - License: I confirm that my contribution is made under the terms of the Apache 2.0 license.
…ble deployment from WFS (aws#7315) ## Problem - Save telemetry was being recorded for all document saves in VS Code, not just for the active workflow studio document. - Save & Deploy functionality required closing Workflow Studio before starting deployment ## Solution - Add URI comparison check to ensure telemetry is only recorded when the saved document matches the current workflow studio document. - Refactored publishStateMachine.ts to accept an optional TextDocument parameter and updated activation.ts to support new interface - Removed closeCustomEditorMessageHandler call from saveFileAndDeployMessageHandler --- - Treat all work as PUBLIC. Private `feature/x` branches will not be squash-merged at release time. - Your code changes must meet the guidelines in [CONTRIBUTING.md](https://github.com/aws/aws-toolkit-vscode/blob/master/CONTRIBUTING.md#guidelines). - License: I confirm that my contribution is made under the terms of the Apache 2.0 license. --------- Co-authored-by: Diler Zaza <[email protected]>
## Problem Instead of running `mvn dependency:copy-dependencies` and `mvn clean install`, we have a JAR that we can execute which will gather all of the project dependencies as well as some important metadata stored in a `compilations.json` file which our service will use to improve the quality of transformations. ## Solution Remove Maven shell commands; add custom JAR execution. --- - Treat all work as PUBLIC. Private `feature/x` branches will not be squash-merged at release time. - Your code changes must meet the guidelines in [CONTRIBUTING.md](https://github.com/aws/aws-toolkit-vscode/blob/master/CONTRIBUTING.md#guidelines). - License: I confirm that my contribution is made under the terms of the Apache 2.0 license. --------- Co-authored-by: David Hasani <[email protected]>
## Problem Minor text update request. ## Solution Update text. --- - Treat all work as PUBLIC. Private `feature/x` branches will not be squash-merged at release time. - Your code changes must meet the guidelines in [CONTRIBUTING.md](https://github.com/aws/aws-toolkit-vscode/blob/master/CONTRIBUTING.md#guidelines). - License: I confirm that my contribution is made under the terms of the Apache 2.0 license. Co-authored-by: David Hasani <[email protected]>
## Problem step functions still uses sdk v2 ## Solution - Refactor `DefaultStepFunctionsClient` to `StepFunctionsClient` using ClientWrapper. - Refactor references to `DefaultStepFunctionsClient` with `StepFunctionsClient` and reference sdk v3 types ## Verification - Verified CreateStateMachine, UpdateStateMachine works and creates/updates StateMachine - Verified AWS Explorer lists all StateMachines using ListStateMachine - Verified StartExecution works - Verified TestState, ListIAMRoles works in Workflow Studio, which also fixes the bug that variables cannot be used in TestState in Workflow Studio - fixes aws#6819  --- - Treat all work as PUBLIC. Private `feature/x` branches will not be squash-merged at release time. - Your code changes must meet the guidelines in [CONTRIBUTING.md](https://github.com/aws/aws-toolkit-vscode/blob/master/CONTRIBUTING.md#guidelines). - License: I confirm that my contribution is made under the terms of the Apache 2.0 license.
## Problem Modify text in some places, and modify the manifest to include the `IDE` field. ## Solution Above --- - Treat all work as PUBLIC. Private `feature/x` branches will not be squash-merged at release time. - Your code changes must meet the guidelines in [CONTRIBUTING.md](https://github.com/aws/aws-toolkit-vscode/blob/master/CONTRIBUTING.md#guidelines). - License: I confirm that my contribution is made under the terms of the Apache 2.0 license. Co-authored-by: David Hasani <[email protected]>
1. update the commonAuthViewProvider to use the locally bundled vue.js, instead of to load the vue.js from CDN. 2. this going to resolve the customer request that When customer is trying to login to IDC via Q they are hitting a URL which is not part of the whitelist urls as per [documentation](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/firewall.html)
laileni-aws
reviewed
Jul 3, 2025
| * This uses the same method as explainIssue command which works properly | ||
| */ | ||
| public async sendChatMessage(message: string, eventId: string): Promise<ChatResult> { | ||
| this.logger.info('AutoDebugLspClient: Sending message via webview postMessage') |
There was a problem hiding this comment.
Combine these logs into a single one
laileni-aws
reviewed
Jul 3, 2025
| }, | ||
| }) | ||
|
|
||
| this.logger.info('AutoDebugLspClient: ✅ Message sent successfully via webview postMessage') |
ashishrp-aws
reviewed
Jul 3, 2025
| * AutoDebug LSP client that uses the regular Amazon Q chat pipeline | ||
| * This ensures the response appears in the chat UI and can be processed by the language server | ||
| */ | ||
| export class AutoDebugLspClient { |
There was a problem hiding this comment.
Do we need another client?
There was a problem hiding this comment.
Yeah because certain dependencies are not available at core side.
laileni-aws
reviewed
Jul 14, 2025
| * This ensures perfect compatibility with the language server integration | ||
| */ | ||
| export function activateAutoDebug(client: LanguageClient, encryptionKey: Buffer): AutoDebugLspClient { | ||
| logger.info('AutoDebug: Activating AutoDebug LSP client using exact inline chat pattern') |
There was a problem hiding this comment.
Can we combine these into a single log
There was a problem hiding this comment.
Yeah sure! Sorry I forgot to make changes to this one before!
laileni-aws
reviewed
Jul 15, 2025
| context.extensionContext.subscriptions.push(autoDebugFeature) | ||
| getLogger().debug('AutoDebug feature added to extension subscriptions') | ||
| } catch (error) { | ||
| getLogger().error('Failed to activate AutoDebug feature: %s', error) |
MarcoWang3
force-pushed
the
feature/auto-debug
branch
from
e71ffa9 to
0bdd5a3
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Problem
Amazon Q users currently face significant challenges when debugging code errors in VS Code:
This disconnect between VS Code's powerful diagnostic capabilities and Amazon Q's AI assistance creates friction in the development workflow, resulting in longer debugging cycles and reduced productivity.
Solution
Implemented a comprehensive Amazon Q Auto Debug System that bridges VS Code's diagnostic ecosystem with Amazon Q's AI capabilities through an intelligent, event-driven architecture. This system provides proactive error detection with smart notifications and seamless AI-powered debugging assistance.
High-Level Auto Debug Workflow
File Save/Open → Diagnostic Capture → Baseline Comparison → Smart Filtering → Multi-Fallback Notifications → Amazon Q Integration
Detailed Flow:
Architecture & Component Structure
Core System Architecture
AutoDebugFeature (Orchestration Layer - 320 lines)
AutoDebugController (Business Logic Engine - 600 lines)
Diagnostic Processing Pipeline
DiagnosticsMonitor (Diagnostic Capture Engine - 180 lines)
ProblemDetector (Intelligence Layer - 200 lines)
AI Integration & Context Assembly
ErrorContextFormatter (Context Enrichment - 220 lines)
AutoDebugLspClient (Communication Layer - 250 lines)
User Interface Integration
ContextMenuProvider (Right-Click Integration - 200 lines)
AutoDebugCodeActionsProvider (Light Bulb Integration - 150 lines)
Extension Integration
Activation System (Extension Bootstrap - 100 lines)
Intelligent Workflow Implementation
Event-Driven Problem Detection
Multi-Fallback Notification System
Amazon Q Integration Architecture
IDE Integration Features
New Functionalities
Intelligent Error Detection
Proactive Multi-Fallback Notifications
AI-Powered Batch Processing
Comprehensive IDE Integration
Advanced Configuration Options
Unit Test Design & Coverage
Comprehensive Test Strategy
Implemented 95%+ code coverage across all components with systematic edge case testing:
AutoDebugFeature Tests (12 test categories, 35+ test cases)
AutoDebugController Tests (15 test categories, 45+ test cases)
Edge Cases & Robustness Testing
Input Validation & Error Handling
Performance & Scalability
VS Code Integration Robustness
Mock Strategy & Test Infrastructure
Benefits of This New Feature
Enhanced Development Experience
Improved Developer Productivity
Technical Architecture Advantages
Configuration & Customization
Users can fine-tune the Auto Debug experience through comprehensive VS Code settings:
{ "amazonq.autoDebug.enabled": true, "amazonq.autoDebug.autoReportThreshold": 1, "amazonq.autoDebug.severityFilter": ["error"], "amazonq.autoDebug.debounceMs": 2000, "amazonq.autoDebug.excludedSources": ["spell-checker"], "amazonq.autoDebug.includedSources": [] }Configuration Options:
Integration & Activation
The Auto Debug system integrates seamlessly with existing VS Code extensions through a clean activation API:
Screenshots
Auto.detect.and.fix.mov
Fix.with.Amazon.Q.mov
QuickFix.and.Explain.with.Amazon.Q.mov
feature/xbranches will not be squash-merged at release time.