chore(toolkit-docs): add missing summaries for 5 toolkits#929
Merged
Conversation
posthog, granola, microsoftoutlookcalendar, microsoftoutlookmail, and zohocreatorapi never received a summary — LLM generation was either skipped or failed on the first auto-update run and the null state has persisted ever since (see #926 for the underlying regression). Each summary is written from the actual tool list in the toolkit JSON, matching the structure the LLM prompt targets (60–140 words, Capabilities bullets, OAuth / Secrets sections) so the rendered overview looks consistent with LLM-generated peers. Refs #926 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
…cade auth provider docs Same follow-up as #928 applied to the five toolkits with brand-new summaries. Each OAuth section now states the provider and links to /en/references/auth-providers/<provider> instead of enumerating scopes. Secrets sections were also tightened with per-secret provenance and a link to the Arcade secret setup guide. Refs #926 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
jottakka
added a commit
that referenced
this pull request
Apr 18, 2026
…scopes Per follow-up on PRs #928 and #929, the OAuth section of each summary should name the provider and link to the Arcade per-provider auth docs rather than enumerate scopes. Scopes already live on the provider reference page and repeating them in toolkit summaries creates drift every time a provider page updates. Changes: - Add ARCADE_AUTH_PROVIDERS_BASE_URL constant alongside the existing Arcade secret URLs in secret-coherence.ts. - Rewrite the OAuth bullet in toolkit-summary-generator.ts's prompt to require a link to {base}/<providerId> and explicitly forbid listing scopes. - Drop scopes from formatAuth's prompt payload so the model has no stray scope list to fall back on. - README: note the no-scopes-in-summary rule and point to the provider reference pages as the source of truth. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
torresmateo
approved these changes
Apr 20, 2026
byrro
approved these changes
Apr 20, 2026
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
3 participants
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.
Summary
summaryfor 5 toolkits that have always shipped withsummary: nullbecause LLM generation was skipped or failed on their first auto-update run: posthog, granola, microsoftoutlookcalendar, microsoftoutlookmail, zohocreatorapi.toolkit-docs-generator/data/toolkits/<id>.json. Format matches whatLlmToolkitSummaryGeneratorproduces (60–140 words, Capabilities bullets, OAuth / Secrets sections).Why
Without a summary the rendered toolkit page (app/_components/toolkit-docs/components/toolkit-page.tsx:647) omits the prose overview block. Readers land on a page with just the header + tool list and no narrative orientation.
Per-toolkit notes
posthoggranolamicrosoftoutlookcalendaroutlookcalendar(see #874).microsoftoutlookmailoutlookmail(see #874).zohocreatorapiZOHO_SERVER_URLsecret for regional domain selection.Why separate from #927 / #928
Test plan
.auth.allScopesin the JSON.excluded-toolkits.txtorignored-toolkits.txt./en/mcp-servers/productivity/posthog).Refs #926
🤖 Generated with Claude Code
Note
Low Risk
Low risk documentation-only change: adds
summarystrings to existing toolkit JSON metadata without altering tool definitions, auth, or runtime code paths.Overview
Adds
summaryfields to five toolkit definition JSONs (granola,microsoftoutlookcalendar,microsoftoutlookmail,posthog,zohocreatorapi), providing a prose overview plus Capabilities, and where applicable OAuth/Secrets sections.Also normalizes the JSON file endings by keeping
generatedAtand appending the newsummaryfield with proper trailing comma/newline so the metadata is valid and complete.Reviewed by Cursor Bugbot for commit ac753d2. Bugbot is set up for automated code reviews on this repo. Configure here.