feat: add auth0_get_quickstart_guide tool (DXAA-555)#173
Draft
GilbertLS wants to merge 8 commits into
Draft
Conversation
…kstart guide tool branch
# Conflicts: # src/utils/onboarding.ts # test/utils/onboarding.test.ts
Remove the duplicate hasNonVerifiableCallbacks from quickstart-guide now that the canonical implementation from PR #162 is available, resolving the standing TODO. Drops the redundant test block; coverage lives in onboarding.test.ts.
Replace the hardcoded VALID_FRAMEWORKS list with the shared SUPPORTED_FRAMEWORKS/isFrameworkSupported from onboarding util. This also makes framework validation case-insensitive, consistent with fetchQuickstartSpec which already lowercases the framework.
…ates' into feat/DXAA-auth0-get-quickstart-guide-tool
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
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.
Changes
Adds the
auth0_get_quickstart_guideMCP tool, which fetches a framework-specific Auth0 quickstart implementation prompt, configures the application's callback URLs, and returns a ready-to-implement prompt.auth0_get_quickstart_guide(src/tools/quickstarts.ts): givenclient_id,framework, andproject_path, it resolves callback URLs from project config, fetches the quickstart LLM prompt from CDN, injects runtime values, updates the Auth0 application's callback/logout/web-origin URLs, and returns the resolved prompt. Requiresread:clientsandupdate:clients; markedlocalOnly.src/utils/quickstart-guide.ts:resolvePlaceholders(injects runtime values into the prompt template) andcalculateUrlUpdates(computes the minimal application URL patch).*******MASKED*********) in the injected input values so secrets are never written into the returned prompt..envdetection: when a quickstart spec includes an env snippet, the tool detects an existing env file (e.g..env.development) before falling back to the spec's preferred filename, and instructs the caller to reuse it rather than create a new one.isFrameworkSupported/SUPPORTED_FRAMEWORKSfromutils/onboarding.ts(case-insensitive, consistent withfetchQuickstartSpec), and non-verifiable callback handling uses the sharedhasNonVerifiableCallbackshelper, removing duplicated logic.src/tools/index.ts.References
Testing
Unit tests cover the new tool handler, the placeholder/URL-update utilities, and the shared onboarding helpers — including framework validation (valid, unsupported, and mixed-case),
.envdetection and missing-file handling, secret masking, callback-URL update calculation, and error paths (missing params, spec unavailable, app not found, CDN failure).Run:
npx vitest run test/tools/quickstarts.test.ts test/utils/quickstart-guide.test.ts test/utils/onboarding.test.tsChecklist