chore(toolkit-docs): add missing summaries for 5 toolkits (#929)

* chore(toolkit-docs): add missing summaries for 5 toolkits

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>

* 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/<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>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: jottakka

toolkit-docs-generator/data/toolkits/granola.json

@@ -180,5 +180,6 @@
   "documentationChunks": [],
   "customImports": [],
   "subPages": [],
-  "generatedAt": "2026-04-02T11:25:02.794Z"
-}
+  "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\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)."
+}

toolkit-docs-generator/data/toolkits/microsoftoutlookcalendar.json

@@ -546,5 +546,6 @@
   "documentationChunks": [],
   "customImports": [],
   "subPages": [],
-  "generatedAt": "2026-04-02T11:25:02.800Z"
-}
+  "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\nRequires Microsoft OAuth. See the [Arcade Microsoft auth provider docs](https://docs.arcade.dev/en/references/auth-providers/microsoft) for configuration."
+}

toolkit-docs-generator/data/toolkits/microsoftoutlookmail.json

@@ -1147,5 +1147,6 @@
   "documentationChunks": [],
   "customImports": [],
   "subPages": [],
-  "generatedAt": "2026-04-03T11:23:10.952Z"
-}
+  "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\nRequires Microsoft OAuth. See the [Arcade Microsoft auth provider docs](https://docs.arcade.dev/en/references/auth-providers/microsoft) for configuration."
+}

toolkit-docs-generator/data/toolkits/posthog.json

@@ -2990,5 +2990,6 @@
   "documentationChunks": [],
   "customImports": [],
   "subPages": [],
-  "generatedAt": "2026-04-10T11:26:08.921Z"
-}
+  "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\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)."
+}

toolkit-docs-generator/data/toolkits/zohocreatorapi.json

@@ -1146,5 +1146,6 @@
   "documentationChunks": [],
   "customImports": [],
   "subPages": [],
-  "generatedAt": "2026-04-16T11:32:31.216Z"
-}
+  "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\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)."
+}