From f6e474d7d8ff9339ba9d263afaf93916fca54cba Mon Sep 17 00:00:00 2001 From: jottakka Date: Fri, 17 Apr 2026 20:55:33 -0300 Subject: [PATCH 1/2] chore(toolkit-docs): add missing summaries for 5 toolkits MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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) --- toolkit-docs-generator/data/toolkits/granola.json | 5 +++-- .../data/toolkits/microsoftoutlookcalendar.json | 5 +++-- .../data/toolkits/microsoftoutlookmail.json | 5 +++-- toolkit-docs-generator/data/toolkits/posthog.json | 5 +++-- toolkit-docs-generator/data/toolkits/zohocreatorapi.json | 5 +++-- 5 files changed, 15 insertions(+), 10 deletions(-) diff --git a/toolkit-docs-generator/data/toolkits/granola.json b/toolkit-docs-generator/data/toolkits/granola.json index 6ab766a32..74f4ee72b 100644 --- a/toolkit-docs-generator/data/toolkits/granola.json +++ b/toolkit-docs-generator/data/toolkits/granola.json @@ -180,5 +180,6 @@ "documentationChunks": [], "customImports": [], "subPages": [], - "generatedAt": "2026-04-02T11:25:02.794Z" -} \ No newline at end of file + "generatedAt": "2026-04-02T11:25:02.794Z", + "summary": "Granola is a meeting intelligence platform that captures notes and transcripts from calls. The Arcade Granola toolkit gives agents read access to Granola's public Enterprise API for working with meeting metadata and transcripts.\n\n**Capabilities**\n\n- List meetings with optional date-range filters and cursor pagination.\n- Fetch full metadata for a meeting, including attendees and linked calendar event.\n- Retrieve verbatim transcripts with speaker labels and timestamps, optionally filtered by speaker.\n\n**OAuth**\n\nNo OAuth — the toolkit authenticates via a Granola Enterprise API key passed as a secret.\n\n**Secrets**\n\nRequires `GRANOLA_API_KEY`, an Enterprise API key provisioned from Granola, for all tool calls." +} diff --git a/toolkit-docs-generator/data/toolkits/microsoftoutlookcalendar.json b/toolkit-docs-generator/data/toolkits/microsoftoutlookcalendar.json index 5f6d41612..94e3738af 100644 --- a/toolkit-docs-generator/data/toolkits/microsoftoutlookcalendar.json +++ b/toolkit-docs-generator/data/toolkits/microsoftoutlookcalendar.json @@ -546,5 +546,6 @@ "documentationChunks": [], "customImports": [], "subPages": [], - "generatedAt": "2026-04-02T11:25:02.800Z" -} \ No newline at end of file + "generatedAt": "2026-04-02T11:25:02.800Z", + "summary": "Microsoft Outlook Calendar is Microsoft's calendaring service, accessed through the Microsoft Graph API. The Arcade Outlook Calendar toolkit lets agents read and manage events across a user's primary and shared calendars.\n\n**Capabilities**\n\n- Create events with attendees, locations, and optional online-meeting links.\n- List and search events in a time range with filters for subject, attendees, organizer, importance, and online-meeting status.\n- Retrieve individual events and list event attachment metadata.\n- Enumerate calendars (including shared and delegated) and fetch profile details via WhoAmI.\n\n**OAuth**\n\nUses Microsoft OAuth with scopes `Calendars.Read`, `Calendars.ReadBasic`, `Calendars.ReadWrite`, `MailboxSettings.Read`, and `User.Read` to cover read, write, and mailbox-timezone access." +} diff --git a/toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json b/toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json index 40cec6c67..1b3f37a7a 100644 --- a/toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json +++ b/toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json @@ -1147,5 +1147,6 @@ "documentationChunks": [], "customImports": [], "subPages": [], - "generatedAt": "2026-04-03T11:23:10.952Z" -} \ No newline at end of file + "generatedAt": "2026-04-03T11:23:10.952Z", + "summary": "Microsoft Outlook Mail is Microsoft's email service, accessed through the Microsoft Graph API. The Arcade Outlook Mail toolkit gives agents full mailbox control — reading, composing, sending, and organizing messages on behalf of a user.\n\n**Capabilities**\n\n- Send emails immediately or manage drafts through create, update, and send operations.\n- List and search messages across folders, with filters for sender, recipient, attachments, importance, and read status.\n- Reply to a sender or all recipients, and list attachment metadata for any message.\n- Navigate the mailbox by enumerating mail folders and listing messages by folder or property.\n\n**OAuth**\n\nUses Microsoft OAuth with scopes `Mail.Read`, `Mail.ReadWrite`, `Mail.Send`, `MailboxSettings.Read`, and `User.Read` to cover read, compose, send, and profile access." +} diff --git a/toolkit-docs-generator/data/toolkits/posthog.json b/toolkit-docs-generator/data/toolkits/posthog.json index 1fbf5a400..34ecf06ad 100644 --- a/toolkit-docs-generator/data/toolkits/posthog.json +++ b/toolkit-docs-generator/data/toolkits/posthog.json @@ -2990,5 +2990,6 @@ "documentationChunks": [], "customImports": [], "subPages": [], - "generatedAt": "2026-04-10T11:26:08.921Z" -} \ No newline at end of file + "generatedAt": "2026-04-10T11:26:08.921Z", + "summary": "PostHog is a product analytics and experimentation platform. The Arcade PostHog toolkit lets agents query analytics, manage experiments, and curate insights directly from a PostHog project.\n\n**Capabilities**\n\n- Build and manage dashboards, insights, funnels, trends, and retention views.\n- Create and iterate on experiments, feature flags, and surveys with full CRUD support.\n- Inspect event and property definitions, investigate errors, and compare time periods.\n- Run ad-hoc HogQL or insight queries and retrieve results for downstream analysis.\n\n**OAuth**\n\nNo OAuth — authentication uses a PostHog personal API key passed as a secret.\n\n**Secrets**\n\nRequires `POSTHOG_PERSONAL_API_KEY` for authentication and `POSTHOG_SERVER_URL` to target the correct PostHog region or self-hosted instance." +} diff --git a/toolkit-docs-generator/data/toolkits/zohocreatorapi.json b/toolkit-docs-generator/data/toolkits/zohocreatorapi.json index be6d26a86..375044aa2 100644 --- a/toolkit-docs-generator/data/toolkits/zohocreatorapi.json +++ b/toolkit-docs-generator/data/toolkits/zohocreatorapi.json @@ -1146,5 +1146,6 @@ "documentationChunks": [], "customImports": [], "subPages": [], - "generatedAt": "2026-04-16T11:32:31.216Z" -} \ No newline at end of file + "generatedAt": "2026-04-16T11:32:31.216Z", + "summary": "Zoho Creator is a low-code platform for building custom business applications. The Arcade Zoho Creator toolkit lets agents interact directly with the Creator REST API to manage records, reports, forms, and application metadata.\n\n**Capabilities**\n\n- Create, read, update, and delete records across Zoho Creator forms and reports.\n- Bulk-insert up to 200 records per call and run asynchronous bulk read jobs.\n- Inspect application metadata, form field schemas, report definitions, sections, and pages.\n- Fetch individual records or paginated report rows with filter criteria.\n\n**OAuth**\n\nUses Zoho OAuth with `ZohoCreator` scopes covering bulk read/create, form create, application and form metadata reads, and report read/update/delete.\n\n**Secrets**\n\nRequires `ZOHO_SERVER_URL` to target the correct Zoho data-center domain (for example `.com`, `.eu`, `.in`) for API calls." +} From ac753d23de4edff40f67e4afa79d268e0943b4dd Mon Sep 17 00:00:00 2001 From: jottakka Date: Sat, 18 Apr 2026 15:30:47 -0300 Subject: [PATCH 2/2] chore(toolkit-docs): drop OAuth scopes from new summaries, link to Arcade 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/ 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) --- toolkit-docs-generator/data/toolkits/granola.json | 2 +- .../data/toolkits/microsoftoutlookcalendar.json | 2 +- toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json | 2 +- toolkit-docs-generator/data/toolkits/posthog.json | 2 +- toolkit-docs-generator/data/toolkits/zohocreatorapi.json | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/toolkit-docs-generator/data/toolkits/granola.json b/toolkit-docs-generator/data/toolkits/granola.json index 74f4ee72b..d8c617a18 100644 --- a/toolkit-docs-generator/data/toolkits/granola.json +++ b/toolkit-docs-generator/data/toolkits/granola.json @@ -181,5 +181,5 @@ "customImports": [], "subPages": [], "generatedAt": "2026-04-02T11:25:02.794Z", - "summary": "Granola is a meeting intelligence platform that captures notes and transcripts from calls. The Arcade Granola toolkit gives agents read access to Granola's public Enterprise API for working with meeting metadata and transcripts.\n\n**Capabilities**\n\n- List meetings with optional date-range filters and cursor pagination.\n- Fetch full metadata for a meeting, including attendees and linked calendar event.\n- Retrieve verbatim transcripts with speaker labels and timestamps, optionally filtered by speaker.\n\n**OAuth**\n\nNo OAuth — the toolkit authenticates via a Granola Enterprise API key passed as a secret.\n\n**Secrets**\n\nRequires `GRANOLA_API_KEY`, an Enterprise API key provisioned from Granola, for all tool calls." + "summary": "Granola is a meeting intelligence platform that captures notes and transcripts from calls. The Arcade Granola toolkit gives agents read access to Granola's public Enterprise API for working with meeting metadata and transcripts.\n\n**Capabilities**\n\n- List meetings with optional date-range filters and cursor pagination.\n- Fetch full metadata for a meeting, including attendees and linked calendar event.\n- Retrieve verbatim transcripts with speaker labels and timestamps, optionally filtered by speaker.\n\n**OAuth**\n\nNo OAuth — the toolkit authenticates via a Granola Enterprise API key passed as a secret.\n\n**Secrets**\n\n- `GRANOLA_API_KEY` — Enterprise API key provisioned from Granola. Configure it in the [Arcade Dashboard](https://api.arcade.dev/dashboard/auth/secrets) per the [Arcade secret setup guide](https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets)." } diff --git a/toolkit-docs-generator/data/toolkits/microsoftoutlookcalendar.json b/toolkit-docs-generator/data/toolkits/microsoftoutlookcalendar.json index 94e3738af..ee93550ff 100644 --- a/toolkit-docs-generator/data/toolkits/microsoftoutlookcalendar.json +++ b/toolkit-docs-generator/data/toolkits/microsoftoutlookcalendar.json @@ -547,5 +547,5 @@ "customImports": [], "subPages": [], "generatedAt": "2026-04-02T11:25:02.800Z", - "summary": "Microsoft Outlook Calendar is Microsoft's calendaring service, accessed through the Microsoft Graph API. The Arcade Outlook Calendar toolkit lets agents read and manage events across a user's primary and shared calendars.\n\n**Capabilities**\n\n- Create events with attendees, locations, and optional online-meeting links.\n- List and search events in a time range with filters for subject, attendees, organizer, importance, and online-meeting status.\n- Retrieve individual events and list event attachment metadata.\n- Enumerate calendars (including shared and delegated) and fetch profile details via WhoAmI.\n\n**OAuth**\n\nUses Microsoft OAuth with scopes `Calendars.Read`, `Calendars.ReadBasic`, `Calendars.ReadWrite`, `MailboxSettings.Read`, and `User.Read` to cover read, write, and mailbox-timezone access." + "summary": "Microsoft Outlook Calendar is Microsoft's calendaring service, accessed through the Microsoft Graph API. The Arcade Outlook Calendar toolkit lets agents read and manage events across a user's primary and shared calendars.\n\n**Capabilities**\n\n- Create events with attendees, locations, and optional online-meeting links.\n- List and search events in a time range with filters for subject, attendees, organizer, importance, and online-meeting status.\n- Retrieve individual events and list event attachment metadata.\n- Enumerate calendars (including shared and delegated) and fetch profile details via WhoAmI.\n\n**OAuth**\n\nRequires Microsoft OAuth. See the [Arcade Microsoft auth provider docs](https://docs.arcade.dev/en/references/auth-providers/microsoft) for configuration." } diff --git a/toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json b/toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json index 1b3f37a7a..b4609362e 100644 --- a/toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json +++ b/toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json @@ -1148,5 +1148,5 @@ "customImports": [], "subPages": [], "generatedAt": "2026-04-03T11:23:10.952Z", - "summary": "Microsoft Outlook Mail is Microsoft's email service, accessed through the Microsoft Graph API. The Arcade Outlook Mail toolkit gives agents full mailbox control — reading, composing, sending, and organizing messages on behalf of a user.\n\n**Capabilities**\n\n- Send emails immediately or manage drafts through create, update, and send operations.\n- List and search messages across folders, with filters for sender, recipient, attachments, importance, and read status.\n- Reply to a sender or all recipients, and list attachment metadata for any message.\n- Navigate the mailbox by enumerating mail folders and listing messages by folder or property.\n\n**OAuth**\n\nUses Microsoft OAuth with scopes `Mail.Read`, `Mail.ReadWrite`, `Mail.Send`, `MailboxSettings.Read`, and `User.Read` to cover read, compose, send, and profile access." + "summary": "Microsoft Outlook Mail is Microsoft's email service, accessed through the Microsoft Graph API. The Arcade Outlook Mail toolkit gives agents full mailbox control — reading, composing, sending, and organizing messages on behalf of a user.\n\n**Capabilities**\n\n- Send emails immediately or manage drafts through create, update, and send operations.\n- List and search messages across folders, with filters for sender, recipient, attachments, importance, and read status.\n- Reply to a sender or all recipients, and list attachment metadata for any message.\n- Navigate the mailbox by enumerating mail folders and listing messages by folder or property.\n\n**OAuth**\n\nRequires Microsoft OAuth. See the [Arcade Microsoft auth provider docs](https://docs.arcade.dev/en/references/auth-providers/microsoft) for configuration." } diff --git a/toolkit-docs-generator/data/toolkits/posthog.json b/toolkit-docs-generator/data/toolkits/posthog.json index 34ecf06ad..42a224080 100644 --- a/toolkit-docs-generator/data/toolkits/posthog.json +++ b/toolkit-docs-generator/data/toolkits/posthog.json @@ -2991,5 +2991,5 @@ "customImports": [], "subPages": [], "generatedAt": "2026-04-10T11:26:08.921Z", - "summary": "PostHog is a product analytics and experimentation platform. The Arcade PostHog toolkit lets agents query analytics, manage experiments, and curate insights directly from a PostHog project.\n\n**Capabilities**\n\n- Build and manage dashboards, insights, funnels, trends, and retention views.\n- Create and iterate on experiments, feature flags, and surveys with full CRUD support.\n- Inspect event and property definitions, investigate errors, and compare time periods.\n- Run ad-hoc HogQL or insight queries and retrieve results for downstream analysis.\n\n**OAuth**\n\nNo OAuth — authentication uses a PostHog personal API key passed as a secret.\n\n**Secrets**\n\nRequires `POSTHOG_PERSONAL_API_KEY` for authentication and `POSTHOG_SERVER_URL` to target the correct PostHog region or self-hosted instance." + "summary": "PostHog is a product analytics and experimentation platform. The Arcade PostHog toolkit lets agents query analytics, manage experiments, and curate insights directly from a PostHog project.\n\n**Capabilities**\n\n- Build and manage dashboards, insights, funnels, trends, and retention views.\n- Create and iterate on experiments, feature flags, and surveys with full CRUD support.\n- Inspect event and property definitions, investigate errors, and compare time periods.\n- Run ad-hoc HogQL or insight queries and retrieve results for downstream analysis.\n\n**OAuth**\n\nNo OAuth — authentication uses a PostHog personal API key passed as a secret.\n\n**Secrets**\n\n- `POSTHOG_PERSONAL_API_KEY` — PostHog personal API key created under Account Settings → Personal API Keys.\n- `POSTHOG_SERVER_URL` — target PostHog region or self-hosted instance URL (e.g. `https://us.posthog.com`).\n\nConfigure both in the [Arcade Dashboard](https://api.arcade.dev/dashboard/auth/secrets) per the [Arcade secret setup guide](https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets)." } diff --git a/toolkit-docs-generator/data/toolkits/zohocreatorapi.json b/toolkit-docs-generator/data/toolkits/zohocreatorapi.json index 375044aa2..45b8e3b02 100644 --- a/toolkit-docs-generator/data/toolkits/zohocreatorapi.json +++ b/toolkit-docs-generator/data/toolkits/zohocreatorapi.json @@ -1147,5 +1147,5 @@ "customImports": [], "subPages": [], "generatedAt": "2026-04-16T11:32:31.216Z", - "summary": "Zoho Creator is a low-code platform for building custom business applications. The Arcade Zoho Creator toolkit lets agents interact directly with the Creator REST API to manage records, reports, forms, and application metadata.\n\n**Capabilities**\n\n- Create, read, update, and delete records across Zoho Creator forms and reports.\n- Bulk-insert up to 200 records per call and run asynchronous bulk read jobs.\n- Inspect application metadata, form field schemas, report definitions, sections, and pages.\n- Fetch individual records or paginated report rows with filter criteria.\n\n**OAuth**\n\nUses Zoho OAuth with `ZohoCreator` scopes covering bulk read/create, form create, application and form metadata reads, and report read/update/delete.\n\n**Secrets**\n\nRequires `ZOHO_SERVER_URL` to target the correct Zoho data-center domain (for example `.com`, `.eu`, `.in`) for API calls." + "summary": "Zoho Creator is a low-code platform for building custom business applications. The Arcade Zoho Creator toolkit lets agents interact directly with the Creator REST API to manage records, reports, forms, and application metadata.\n\n**Capabilities**\n\n- Create, read, update, and delete records across Zoho Creator forms and reports.\n- Bulk-insert up to 200 records per call and run asynchronous bulk read jobs.\n- Inspect application metadata, form field schemas, report definitions, sections, and pages.\n- Fetch individual records or paginated report rows with filter criteria.\n\n**OAuth**\n\nRequires Zoho OAuth. See the [Arcade Zoho auth provider docs](https://docs.arcade.dev/en/references/auth-providers/zoho) for configuration.\n\n**Secrets**\n\n- `ZOHO_SERVER_URL` — Zoho data-center domain for API calls (for example `.com`, `.eu`, `.in`). Configure in the [Arcade Dashboard](https://api.arcade.dev/dashboard/auth/secrets) per the [Arcade secret setup guide](https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets)." }