From 77b2697ec7e04ca592c58daf46487566ab8c2c80 Mon Sep 17 00:00:00 2001 From: jottakka Date: Fri, 17 Apr 2026 20:54:19 -0300 Subject: [PATCH 1/3] chore(toolkit-docs): restore lost summaries for 6 toolkits MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The summary field for github, googledocs, jira, salesforce, daytona, and linear was silently wiped to null across recent [AUTO] docs update merges (see #926 for the root cause — regeneration fallback paths did not preserve the previous summary). Each restored summary was rewritten from the last known-good version in git history and then updated to reflect the toolkit's CURRENT tools. Notable capability drift accounted for: - github: drop notifications (no notification tools currently); drop CLASSIC_PERSONAL_ACCESS_TOKEN (only GITHUB_SERVER_URL remains); add explicit Projects V2 fields/items and user-centric views (review workload, open items, recent activity). - googledocs: clarify SearchAndRetrieveDocuments returns body content while SearchDocuments is metadata-only; keep File Picker recovery. - jira: no capability drift; tighten wording around single-call batching and name/key/email reference resolution. - salesforce: no capability drift; add explicit mention of related- object enrichment (contact roles, line items) visible in current descriptions. - daytona: drop abstract "metadata for coordination"; add ListRegions, signed vs. standard port preview URLs, snapshots as a separate lifecycle. - linear: drop the comment-anchoring caveat (no longer present in tool descriptions); add pagination for project/initiative descriptions and ManageIssueSubscription. This restoration is intentionally separate from #927 (the code fix) so content review can happen independently of the regression fix. Refs #926 Co-Authored-By: Claude Opus 4.7 (1M context) --- toolkit-docs-generator/data/toolkits/daytona.json | 5 +++-- toolkit-docs-generator/data/toolkits/github.json | 5 +++-- toolkit-docs-generator/data/toolkits/googledocs.json | 5 +++-- toolkit-docs-generator/data/toolkits/jira.json | 5 +++-- toolkit-docs-generator/data/toolkits/linear.json | 5 +++-- toolkit-docs-generator/data/toolkits/salesforce.json | 5 +++-- 6 files changed, 18 insertions(+), 12 deletions(-) diff --git a/toolkit-docs-generator/data/toolkits/daytona.json b/toolkit-docs-generator/data/toolkits/daytona.json index 1e7d9dfde..ac5e3ff73 100644 --- a/toolkit-docs-generator/data/toolkits/daytona.json +++ b/toolkit-docs-generator/data/toolkits/daytona.json @@ -4192,5 +4192,6 @@ "documentationChunks": [], "customImports": [], "subPages": [], - "generatedAt": "2026-04-02T11:25:02.814Z" -} \ No newline at end of file + "generatedAt": "2026-04-02T11:25:02.814Z", + "summary": "Arcade's Daytona toolkit lets LLMs provision and manage isolated sandboxes, run code and commands, operate persistent sessions, manage snapshots, and perform Git and file operations inside the sandbox. It streamlines dev-loop automation including port previews and SSH access.\n\n**Capabilities**\n- Full sandbox lifecycle: create (from snapshot or image), start, stop, archive, delete, resize, label, list regions, and configure auto-stop / auto-archive / auto-delete intervals.\n- File system and content tools: read, write, move, delete, list, get info, find by glob, search content, replace across files, and create folders.\n- Git operations inside the sandbox: clone, status, add, commit, push, pull, log, checkout, and branch create/list/delete.\n- Execute code or shell commands directly, or drive persistent sessions with input, logs, and listings for long-running processes.\n- Access and sharing: snapshot create/list/get, port listing and preview URLs (standard or signed), and time-boxed SSH access credentials.\n\n**OAuth**\nProvider: github\nScopes: None\n\n**Secrets**\nType: unknown. Example: DAYTONA_API_KEY (authenticates Arcade to the Daytona API; store in environment variables or a secret manager). SSH tokens returned by CreateSshAccess are sensitive and should not be logged." +} diff --git a/toolkit-docs-generator/data/toolkits/github.json b/toolkit-docs-generator/data/toolkits/github.json index 28bdda9ef..87563f1f7 100644 --- a/toolkit-docs-generator/data/toolkits/github.json +++ b/toolkit-docs-generator/data/toolkits/github.json @@ -5766,5 +5766,6 @@ "import { Callout, Tabs } from \"nextra/components\";" ], "subPages": [], - "generatedAt": "2026-04-17T11:27:15.538Z" -} \ No newline at end of file + "generatedAt": "2026-04-17T11:27:15.538Z", + "summary": "Arcade's GitHub toolkit provides authenticated access to GitHub resources, enabling automated repository, issue, pull request, review, and Projects V2 workflows. It exposes high-level actions that handle fuzzy matching, diff-aware edits, and user-centric queries without forcing agents to juggle raw REST calls.\n\n**Capabilities**\n- Manage repository and file operations: create branches, read files with line ranges, create or overwrite files, and replace line blocks safely.\n- Drive the pull request lifecycle: create, update, list, merge, check merge readiness, manage reviewers, submit reviews, and reply to or resolve review threads.\n- Administer issues and labels with fuzzy-matched add/remove, comments, assignment, and issue-to-project linking.\n- Query Projects V2 fields and items, list stargazers, collaborators, labels, activities, and authenticated-user views (open items, recent activity, review workload).\n\n**OAuth**\nProvider: github\nScopes: None (default GitHub app scopes apply)\n\n**Secrets**\nType: unknown. Example: GITHUB_SERVER_URL (override for GitHub Enterprise endpoints)." +} diff --git a/toolkit-docs-generator/data/toolkits/googledocs.json b/toolkit-docs-generator/data/toolkits/googledocs.json index 999efbd47..982be64d3 100644 --- a/toolkit-docs-generator/data/toolkits/googledocs.json +++ b/toolkit-docs-generator/data/toolkits/googledocs.json @@ -1175,5 +1175,6 @@ "import ScopePicker from \"@/app/_components/scope-picker\";" ], "subPages": [], - "generatedAt": "2026-04-10T11:26:08.782Z" -} \ No newline at end of file + "generatedAt": "2026-04-10T11:26:08.782Z", + "summary": "Arcade's Google Docs toolkit lets LLM-driven apps create, read, edit, comment on, and search Google Docs while accessing document metadata and authenticated user profile information. It understands multi-tab documents and returns structured DocMD output for context-aware editing.\n\n**Capabilities**\n- Create documents from blank templates or from plain text / Markdown, and append or edit body content via batchUpdate.\n- Retrieve structured DocMD with tab annotations, fetch document metadata with hierarchical tab character counts, or search and retrieve documents with body content.\n- Search Drive for documents (metadata-only or with content), list and add comments, and generate a Google File Picker URL to recover from missing-file or permission errors.\n- Expose authenticated user profile and Docs environment info through WhoAmI.\n\n**OAuth**\nProvider: google\nScopes: https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile\n\n**Secrets**\nType: api_key. Example: OPENAI_API_KEY (used for LLM-assisted edit parsing; store in environment variables or a secret manager)." +} diff --git a/toolkit-docs-generator/data/toolkits/jira.json b/toolkit-docs-generator/data/toolkits/jira.json index e56899781..38a3c2dd2 100644 --- a/toolkit-docs-generator/data/toolkits/jira.json +++ b/toolkit-docs-generator/data/toolkits/jira.json @@ -4575,5 +4575,6 @@ "relativePath": "environment-variables/page.mdx" } ], - "generatedAt": "2026-04-17T11:27:15.538Z" -} \ No newline at end of file + "generatedAt": "2026-04-17T11:27:15.538Z", + "summary": "Arcade's Jira toolkit enables LLM-driven interactions with Atlassian Jira, letting agents create and update issues, move work through transitions, manage sprints and boards, handle attachments and comments, and resolve projects, users, and priorities. It is designed for programmatic issue lifecycle and Agile workflows with aggressive single-call batching.\n\n**Capabilities**\n- Manage issues end-to-end: create, update, transition, comment, add/remove labels, and attach or download files.\n- Run Scrum/Kanban workflows: list boards and sprints with date filters, fetch sprint and backlog issues, add issues to sprints, and move issues back to the backlog.\n- Search and browse flexibly: parameterized issue search (preferred) or raw JQL, plus listings for projects, users, issue types, priorities, and priority schemes.\n- Resolve references by name, key, or email so agents avoid unnecessary lookup round-trips, and establish user context with WhoAmI against available Atlassian clouds.\n\n**OAuth**\nProvider: atlassian\nScopes: manage:jira-configuration, read:board-scope.admin:jira-software, read:board-scope:jira-software, read:issue-details:jira, read:jira-user, read:jira-work, read:jql:jira, read:project:jira, read:sprint:jira-software, write:board-scope:jira-software, write:jira-work, write:sprint:jira-software" +} diff --git a/toolkit-docs-generator/data/toolkits/linear.json b/toolkit-docs-generator/data/toolkits/linear.json index bfcdc7ec5..723ac7d8d 100644 --- a/toolkit-docs-generator/data/toolkits/linear.json +++ b/toolkit-docs-generator/data/toolkits/linear.json @@ -4066,5 +4066,6 @@ ], "customImports": [], "subPages": [], - "generatedAt": "2026-04-10T11:26:08.882Z" -} \ No newline at end of file + "generatedAt": "2026-04-10T11:26:08.882Z", + "summary": "Arcade's Linear toolkit lets LLMs interact with Linear workspaces, enabling programmatic creation, update, archival, and search across issues, projects, initiatives, cycles, and comments. It validates entity references and exposes workspace metadata so agents can plan work without manual lookups.\n\n**Capabilities**\n- Full issue lifecycle: create, update, archive, transition workflow state, relate issues, and link GitHub PRs, commits, or issues.\n- Project and initiative management: create, update, archive, post status updates, link projects to initiatives, and paginate long descriptions.\n- Collaboration: add, list, update, and reply to comments on issues and project documents; manage per-issue notification subscriptions.\n- Discovery and context: list and get cycles, teams, labels, workflow states, notifications, and recent authenticated-user activity; resolve the current user via WhoAmI." +} diff --git a/toolkit-docs-generator/data/toolkits/salesforce.json b/toolkit-docs-generator/data/toolkits/salesforce.json index db8904219..b73b517a6 100644 --- a/toolkit-docs-generator/data/toolkits/salesforce.json +++ b/toolkit-docs-generator/data/toolkits/salesforce.json @@ -2381,5 +2381,6 @@ "documentationChunks": [], "customImports": [], "subPages": [], - "generatedAt": "2026-04-02T11:25:02.802Z" -} \ No newline at end of file + "generatedAt": "2026-04-02T11:25:02.802Z", + "summary": "Arcade's Salesforce toolkit lets LLMs interact with Salesforce orgs to create, update, search, and convert CRM records, log activities, and fetch enriched relational data. It validates against org-configured picklists and returns contextual warnings and IDs to guide multi-step agent workflows.\n\n**Capabilities**\n- CRUD and lifecycle for leads, contacts, opportunities, and tasks, including the canonical lead-to-deal conversion with Contact/Account/Opportunity creation.\n- Rich account and opportunity retrieval with related contacts, leads, notes, calls, tasks, emails, events, contact roles, and line items.\n- Filtered search across accounts, contacts, leads, and opportunities with owner-scoped (me/all) and paginated results.\n- Activity logging and task management: log completed calls, create follow-up tasks, and list or update assigned tasks with overdue filters.\n- Org-aware validation: picklist checks, conversion guards, and WhoAmI for authenticated user and org context.\n\n**OAuth**\nProvider: salesforce\nScopes: read_account, read_contact, read_lead, read_note, read_opportunity, read_task, read_user, write_contact, write_lead, write_opportunity, write_task\n\n**Secrets**\nType: unknown. Examples: SALESFORCE_ORG_SUBDOMAIN (target org subdomain), SALESFORCE_MAX_CONCURRENT_REQUESTS (concurrency limit for batched related-record fetches)." +} From 4782ed4139ac8e371800247cf0d5a45f88a55b12 Mon Sep 17 00:00:00 2001 From: jottakka Date: Sat, 18 Apr 2026 15:29:47 -0300 Subject: [PATCH 2/3] chore(toolkit-docs): drop OAuth scopes from restored summaries, link to Arcade auth provider docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per follow-up feedback, summaries should not repeat OAuth scopes — they belong in the per-toolkit auth provider documentation, not the overview prose. Each of the six restored summaries now: - States whether OAuth is required and names the provider. - Links to the matching Arcade auth provider page under /en/references/auth-providers/ instead of listing scopes. - Where applicable, adds explicit explanations for each secret plus a link to the Arcade Dashboard secret setup flow. The deterministic secret-coverage check in #932 is not changed here — that PR already accepts either the Arcade secret docs link or the Dashboard URL, both of which remain present in these summaries. Refs #926 Co-Authored-By: Claude Opus 4.7 (1M context) --- toolkit-docs-generator/data/toolkits/daytona.json | 2 +- toolkit-docs-generator/data/toolkits/github.json | 2 +- toolkit-docs-generator/data/toolkits/googledocs.json | 2 +- toolkit-docs-generator/data/toolkits/jira.json | 2 +- toolkit-docs-generator/data/toolkits/linear.json | 2 +- toolkit-docs-generator/data/toolkits/salesforce.json | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/toolkit-docs-generator/data/toolkits/daytona.json b/toolkit-docs-generator/data/toolkits/daytona.json index ac5e3ff73..8e48a1671 100644 --- a/toolkit-docs-generator/data/toolkits/daytona.json +++ b/toolkit-docs-generator/data/toolkits/daytona.json @@ -4193,5 +4193,5 @@ "customImports": [], "subPages": [], "generatedAt": "2026-04-02T11:25:02.814Z", - "summary": "Arcade's Daytona toolkit lets LLMs provision and manage isolated sandboxes, run code and commands, operate persistent sessions, manage snapshots, and perform Git and file operations inside the sandbox. It streamlines dev-loop automation including port previews and SSH access.\n\n**Capabilities**\n- Full sandbox lifecycle: create (from snapshot or image), start, stop, archive, delete, resize, label, list regions, and configure auto-stop / auto-archive / auto-delete intervals.\n- File system and content tools: read, write, move, delete, list, get info, find by glob, search content, replace across files, and create folders.\n- Git operations inside the sandbox: clone, status, add, commit, push, pull, log, checkout, and branch create/list/delete.\n- Execute code or shell commands directly, or drive persistent sessions with input, logs, and listings for long-running processes.\n- Access and sharing: snapshot create/list/get, port listing and preview URLs (standard or signed), and time-boxed SSH access credentials.\n\n**OAuth**\nProvider: github\nScopes: None\n\n**Secrets**\nType: unknown. Example: DAYTONA_API_KEY (authenticates Arcade to the Daytona API; store in environment variables or a secret manager). SSH tokens returned by CreateSshAccess are sensitive and should not be logged." + "summary": "Arcade's Daytona toolkit lets LLMs provision and manage isolated sandboxes, run code and commands, operate persistent sessions, manage snapshots, and perform Git and file operations inside the sandbox. It streamlines dev-loop automation including port previews and SSH access.\n\n**Capabilities**\n- Full sandbox lifecycle: create (from snapshot or image), start, stop, archive, delete, resize, label, list regions, and configure auto-stop / auto-archive / auto-delete intervals.\n- File system and content tools: read, write, move, delete, list, get info, find by glob, search content, replace across files, and create folders.\n- Git operations inside the sandbox: clone, status, add, commit, push, pull, log, checkout, and branch create/list/delete.\n- Execute code or shell commands directly, or drive persistent sessions with input, logs, and listings for long-running processes.\n- Access and sharing: snapshot create/list/get, port listing and preview URLs (standard or signed), and time-boxed SSH access credentials.\n\n**OAuth**\nUses GitHub OAuth for user identification. See the [Arcade GitHub auth provider docs](https://docs.arcade.dev/en/references/auth-providers/github) for configuration.\n\n**Secrets**\n- `DAYTONA_API_KEY` — authenticates Arcade to the Daytona API. 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). SSH tokens returned by `CreateSshAccess` are sensitive and should not be logged." } diff --git a/toolkit-docs-generator/data/toolkits/github.json b/toolkit-docs-generator/data/toolkits/github.json index 87563f1f7..6cd4e3115 100644 --- a/toolkit-docs-generator/data/toolkits/github.json +++ b/toolkit-docs-generator/data/toolkits/github.json @@ -5767,5 +5767,5 @@ ], "subPages": [], "generatedAt": "2026-04-17T11:27:15.538Z", - "summary": "Arcade's GitHub toolkit provides authenticated access to GitHub resources, enabling automated repository, issue, pull request, review, and Projects V2 workflows. It exposes high-level actions that handle fuzzy matching, diff-aware edits, and user-centric queries without forcing agents to juggle raw REST calls.\n\n**Capabilities**\n- Manage repository and file operations: create branches, read files with line ranges, create or overwrite files, and replace line blocks safely.\n- Drive the pull request lifecycle: create, update, list, merge, check merge readiness, manage reviewers, submit reviews, and reply to or resolve review threads.\n- Administer issues and labels with fuzzy-matched add/remove, comments, assignment, and issue-to-project linking.\n- Query Projects V2 fields and items, list stargazers, collaborators, labels, activities, and authenticated-user views (open items, recent activity, review workload).\n\n**OAuth**\nProvider: github\nScopes: None (default GitHub app scopes apply)\n\n**Secrets**\nType: unknown. Example: GITHUB_SERVER_URL (override for GitHub Enterprise endpoints)." + "summary": "Arcade's GitHub toolkit provides authenticated access to GitHub resources, enabling automated repository, issue, pull request, review, and Projects V2 workflows. It exposes high-level actions that handle fuzzy matching, diff-aware edits, and user-centric queries without forcing agents to juggle raw REST calls.\n\n**Capabilities**\n- Manage repository and file operations: create branches, read files with line ranges, create or overwrite files, and replace line blocks safely.\n- Drive the pull request lifecycle: create, update, list, merge, check merge readiness, manage reviewers, submit reviews, and reply to or resolve review threads.\n- Administer issues and labels with fuzzy-matched add/remove, comments, assignment, and issue-to-project linking.\n- Query Projects V2 fields and items, list stargazers, collaborators, labels, activities, and authenticated-user views (open items, recent activity, review workload).\n\n**OAuth**\nRequires GitHub OAuth. See the [Arcade GitHub auth provider docs](https://docs.arcade.dev/en/references/auth-providers/github) for configuration.\n\n**Secrets**\n- `GITHUB_SERVER_URL` — override for GitHub Enterprise endpoints. 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)." } diff --git a/toolkit-docs-generator/data/toolkits/googledocs.json b/toolkit-docs-generator/data/toolkits/googledocs.json index 982be64d3..47560a53a 100644 --- a/toolkit-docs-generator/data/toolkits/googledocs.json +++ b/toolkit-docs-generator/data/toolkits/googledocs.json @@ -1176,5 +1176,5 @@ ], "subPages": [], "generatedAt": "2026-04-10T11:26:08.782Z", - "summary": "Arcade's Google Docs toolkit lets LLM-driven apps create, read, edit, comment on, and search Google Docs while accessing document metadata and authenticated user profile information. It understands multi-tab documents and returns structured DocMD output for context-aware editing.\n\n**Capabilities**\n- Create documents from blank templates or from plain text / Markdown, and append or edit body content via batchUpdate.\n- Retrieve structured DocMD with tab annotations, fetch document metadata with hierarchical tab character counts, or search and retrieve documents with body content.\n- Search Drive for documents (metadata-only or with content), list and add comments, and generate a Google File Picker URL to recover from missing-file or permission errors.\n- Expose authenticated user profile and Docs environment info through WhoAmI.\n\n**OAuth**\nProvider: google\nScopes: https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile\n\n**Secrets**\nType: api_key. Example: OPENAI_API_KEY (used for LLM-assisted edit parsing; store in environment variables or a secret manager)." + "summary": "Arcade's Google Docs toolkit lets LLM-driven apps create, read, edit, comment on, and search Google Docs while accessing document metadata and authenticated user profile information. It understands multi-tab documents and returns structured DocMD output for context-aware editing.\n\n**Capabilities**\n- Create documents from blank templates or from plain text / Markdown, and append or edit body content via batchUpdate.\n- Retrieve structured DocMD with tab annotations, fetch document metadata with hierarchical tab character counts, or search and retrieve documents with body content.\n- Search Drive for documents (metadata-only or with content), list and add comments, and generate a Google File Picker URL to recover from missing-file or permission errors.\n- Expose authenticated user profile and Docs environment info through WhoAmI.\n\n**OAuth**\nRequires Google OAuth. See the [Arcade Google auth provider docs](https://docs.arcade.dev/en/references/auth-providers/google) for configuration.\n\n**Secrets**\n- `OPENAI_API_KEY` — used for LLM-assisted edit parsing. 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)." } diff --git a/toolkit-docs-generator/data/toolkits/jira.json b/toolkit-docs-generator/data/toolkits/jira.json index 38a3c2dd2..8443a9760 100644 --- a/toolkit-docs-generator/data/toolkits/jira.json +++ b/toolkit-docs-generator/data/toolkits/jira.json @@ -4576,5 +4576,5 @@ } ], "generatedAt": "2026-04-17T11:27:15.538Z", - "summary": "Arcade's Jira toolkit enables LLM-driven interactions with Atlassian Jira, letting agents create and update issues, move work through transitions, manage sprints and boards, handle attachments and comments, and resolve projects, users, and priorities. It is designed for programmatic issue lifecycle and Agile workflows with aggressive single-call batching.\n\n**Capabilities**\n- Manage issues end-to-end: create, update, transition, comment, add/remove labels, and attach or download files.\n- Run Scrum/Kanban workflows: list boards and sprints with date filters, fetch sprint and backlog issues, add issues to sprints, and move issues back to the backlog.\n- Search and browse flexibly: parameterized issue search (preferred) or raw JQL, plus listings for projects, users, issue types, priorities, and priority schemes.\n- Resolve references by name, key, or email so agents avoid unnecessary lookup round-trips, and establish user context with WhoAmI against available Atlassian clouds.\n\n**OAuth**\nProvider: atlassian\nScopes: manage:jira-configuration, read:board-scope.admin:jira-software, read:board-scope:jira-software, read:issue-details:jira, read:jira-user, read:jira-work, read:jql:jira, read:project:jira, read:sprint:jira-software, write:board-scope:jira-software, write:jira-work, write:sprint:jira-software" + "summary": "Arcade's Jira toolkit enables LLM-driven interactions with Atlassian Jira, letting agents create and update issues, move work through transitions, manage sprints and boards, handle attachments and comments, and resolve projects, users, and priorities. It is designed for programmatic issue lifecycle and Agile workflows with aggressive single-call batching.\n\n**Capabilities**\n- Manage issues end-to-end: create, update, transition, comment, add/remove labels, and attach or download files.\n- Run Scrum/Kanban workflows: list boards and sprints with date filters, fetch sprint and backlog issues, add issues to sprints, and move issues back to the backlog.\n- Search and browse flexibly: parameterized issue search (preferred) or raw JQL, plus listings for projects, users, issue types, priorities, and priority schemes.\n- Resolve references by name, key, or email so agents avoid unnecessary lookup round-trips, and establish user context with WhoAmI against available Atlassian clouds.\n\n**OAuth**\nRequires Atlassian OAuth. See the [Arcade Atlassian auth provider docs](https://docs.arcade.dev/en/references/auth-providers/atlassian) for configuration." } diff --git a/toolkit-docs-generator/data/toolkits/linear.json b/toolkit-docs-generator/data/toolkits/linear.json index 723ac7d8d..0eddb2aa7 100644 --- a/toolkit-docs-generator/data/toolkits/linear.json +++ b/toolkit-docs-generator/data/toolkits/linear.json @@ -4067,5 +4067,5 @@ "customImports": [], "subPages": [], "generatedAt": "2026-04-10T11:26:08.882Z", - "summary": "Arcade's Linear toolkit lets LLMs interact with Linear workspaces, enabling programmatic creation, update, archival, and search across issues, projects, initiatives, cycles, and comments. It validates entity references and exposes workspace metadata so agents can plan work without manual lookups.\n\n**Capabilities**\n- Full issue lifecycle: create, update, archive, transition workflow state, relate issues, and link GitHub PRs, commits, or issues.\n- Project and initiative management: create, update, archive, post status updates, link projects to initiatives, and paginate long descriptions.\n- Collaboration: add, list, update, and reply to comments on issues and project documents; manage per-issue notification subscriptions.\n- Discovery and context: list and get cycles, teams, labels, workflow states, notifications, and recent authenticated-user activity; resolve the current user via WhoAmI." + "summary": "Arcade's Linear toolkit lets LLMs interact with Linear workspaces, enabling programmatic creation, update, archival, and search across issues, projects, initiatives, cycles, and comments. It validates entity references and exposes workspace metadata so agents can plan work without manual lookups.\n\n**Capabilities**\n- Full issue lifecycle: create, update, archive, transition workflow state, relate issues, and link GitHub PRs, commits, or issues.\n- Project and initiative management: create, update, archive, post status updates, link projects to initiatives, and paginate long descriptions.\n- Collaboration: add, list, update, and reply to comments on issues and project documents; manage per-issue notification subscriptions.\n- Discovery and context: list and get cycles, teams, labels, workflow states, notifications, and recent authenticated-user activity; resolve the current user via WhoAmI.\n\n**OAuth**\nRequires Linear OAuth. See the [Arcade Linear auth provider docs](https://docs.arcade.dev/en/references/auth-providers/linear) for configuration." } diff --git a/toolkit-docs-generator/data/toolkits/salesforce.json b/toolkit-docs-generator/data/toolkits/salesforce.json index b73b517a6..2c40a690d 100644 --- a/toolkit-docs-generator/data/toolkits/salesforce.json +++ b/toolkit-docs-generator/data/toolkits/salesforce.json @@ -2382,5 +2382,5 @@ "customImports": [], "subPages": [], "generatedAt": "2026-04-02T11:25:02.802Z", - "summary": "Arcade's Salesforce toolkit lets LLMs interact with Salesforce orgs to create, update, search, and convert CRM records, log activities, and fetch enriched relational data. It validates against org-configured picklists and returns contextual warnings and IDs to guide multi-step agent workflows.\n\n**Capabilities**\n- CRUD and lifecycle for leads, contacts, opportunities, and tasks, including the canonical lead-to-deal conversion with Contact/Account/Opportunity creation.\n- Rich account and opportunity retrieval with related contacts, leads, notes, calls, tasks, emails, events, contact roles, and line items.\n- Filtered search across accounts, contacts, leads, and opportunities with owner-scoped (me/all) and paginated results.\n- Activity logging and task management: log completed calls, create follow-up tasks, and list or update assigned tasks with overdue filters.\n- Org-aware validation: picklist checks, conversion guards, and WhoAmI for authenticated user and org context.\n\n**OAuth**\nProvider: salesforce\nScopes: read_account, read_contact, read_lead, read_note, read_opportunity, read_task, read_user, write_contact, write_lead, write_opportunity, write_task\n\n**Secrets**\nType: unknown. Examples: SALESFORCE_ORG_SUBDOMAIN (target org subdomain), SALESFORCE_MAX_CONCURRENT_REQUESTS (concurrency limit for batched related-record fetches)." + "summary": "Arcade's Salesforce toolkit lets LLMs interact with Salesforce orgs to create, update, search, and convert CRM records, log activities, and fetch enriched relational data. It validates against org-configured picklists and returns contextual warnings and IDs to guide multi-step agent workflows.\n\n**Capabilities**\n- CRUD and lifecycle for leads, contacts, opportunities, and tasks, including the canonical lead-to-deal conversion with Contact/Account/Opportunity creation.\n- Rich account and opportunity retrieval with related contacts, leads, notes, calls, tasks, emails, events, contact roles, and line items.\n- Filtered search across accounts, contacts, leads, and opportunities with owner-scoped (me/all) and paginated results.\n- Activity logging and task management: log completed calls, create follow-up tasks, and list or update assigned tasks with overdue filters.\n- Org-aware validation: picklist checks, conversion guards, and WhoAmI for authenticated user and org context.\n\n**OAuth**\nRequires Salesforce OAuth. See the [Arcade Salesforce auth provider docs](https://docs.arcade.dev/en/references/auth-providers/salesforce) for configuration.\n\n**Secrets**\n- `SALESFORCE_ORG_SUBDOMAIN` — target org subdomain.\n- `SALESFORCE_MAX_CONCURRENT_REQUESTS` — concurrency limit for batched related-record fetches.\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)." } From 3b7a17f1a34eb8b7757702f6a6c91d902b658eca Mon Sep 17 00:00:00 2001 From: jottakka Date: Mon, 20 Apr 2026 14:27:50 -0300 Subject: [PATCH 3/3] chore(toolkit-docs): align generatedAt with restore batch (PR feedback) torresmateo noted daytona.json carried an older generatedAt than the actual edit. Refresh timestamps for toolkit JSON touched in this PR where dates were still from prior generator runs (Apr 2 / Apr 10). Made-with: Cursor --- toolkit-docs-generator/data/toolkits/daytona.json | 2 +- toolkit-docs-generator/data/toolkits/googledocs.json | 2 +- toolkit-docs-generator/data/toolkits/salesforce.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/toolkit-docs-generator/data/toolkits/daytona.json b/toolkit-docs-generator/data/toolkits/daytona.json index 8e48a1671..a776d0a50 100644 --- a/toolkit-docs-generator/data/toolkits/daytona.json +++ b/toolkit-docs-generator/data/toolkits/daytona.json @@ -4192,6 +4192,6 @@ "documentationChunks": [], "customImports": [], "subPages": [], - "generatedAt": "2026-04-02T11:25:02.814Z", + "generatedAt": "2026-04-20T17:27:26.000Z", "summary": "Arcade's Daytona toolkit lets LLMs provision and manage isolated sandboxes, run code and commands, operate persistent sessions, manage snapshots, and perform Git and file operations inside the sandbox. It streamlines dev-loop automation including port previews and SSH access.\n\n**Capabilities**\n- Full sandbox lifecycle: create (from snapshot or image), start, stop, archive, delete, resize, label, list regions, and configure auto-stop / auto-archive / auto-delete intervals.\n- File system and content tools: read, write, move, delete, list, get info, find by glob, search content, replace across files, and create folders.\n- Git operations inside the sandbox: clone, status, add, commit, push, pull, log, checkout, and branch create/list/delete.\n- Execute code or shell commands directly, or drive persistent sessions with input, logs, and listings for long-running processes.\n- Access and sharing: snapshot create/list/get, port listing and preview URLs (standard or signed), and time-boxed SSH access credentials.\n\n**OAuth**\nUses GitHub OAuth for user identification. See the [Arcade GitHub auth provider docs](https://docs.arcade.dev/en/references/auth-providers/github) for configuration.\n\n**Secrets**\n- `DAYTONA_API_KEY` — authenticates Arcade to the Daytona API. 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). SSH tokens returned by `CreateSshAccess` are sensitive and should not be logged." } diff --git a/toolkit-docs-generator/data/toolkits/googledocs.json b/toolkit-docs-generator/data/toolkits/googledocs.json index 47560a53a..89c1e5cf7 100644 --- a/toolkit-docs-generator/data/toolkits/googledocs.json +++ b/toolkit-docs-generator/data/toolkits/googledocs.json @@ -1175,6 +1175,6 @@ "import ScopePicker from \"@/app/_components/scope-picker\";" ], "subPages": [], - "generatedAt": "2026-04-10T11:26:08.782Z", + "generatedAt": "2026-04-20T17:27:26.000Z", "summary": "Arcade's Google Docs toolkit lets LLM-driven apps create, read, edit, comment on, and search Google Docs while accessing document metadata and authenticated user profile information. It understands multi-tab documents and returns structured DocMD output for context-aware editing.\n\n**Capabilities**\n- Create documents from blank templates or from plain text / Markdown, and append or edit body content via batchUpdate.\n- Retrieve structured DocMD with tab annotations, fetch document metadata with hierarchical tab character counts, or search and retrieve documents with body content.\n- Search Drive for documents (metadata-only or with content), list and add comments, and generate a Google File Picker URL to recover from missing-file or permission errors.\n- Expose authenticated user profile and Docs environment info through WhoAmI.\n\n**OAuth**\nRequires Google OAuth. See the [Arcade Google auth provider docs](https://docs.arcade.dev/en/references/auth-providers/google) for configuration.\n\n**Secrets**\n- `OPENAI_API_KEY` — used for LLM-assisted edit parsing. 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)." } diff --git a/toolkit-docs-generator/data/toolkits/salesforce.json b/toolkit-docs-generator/data/toolkits/salesforce.json index 2c40a690d..f4a4da7d4 100644 --- a/toolkit-docs-generator/data/toolkits/salesforce.json +++ b/toolkit-docs-generator/data/toolkits/salesforce.json @@ -2381,6 +2381,6 @@ "documentationChunks": [], "customImports": [], "subPages": [], - "generatedAt": "2026-04-02T11:25:02.802Z", + "generatedAt": "2026-04-20T17:27:26.000Z", "summary": "Arcade's Salesforce toolkit lets LLMs interact with Salesforce orgs to create, update, search, and convert CRM records, log activities, and fetch enriched relational data. It validates against org-configured picklists and returns contextual warnings and IDs to guide multi-step agent workflows.\n\n**Capabilities**\n- CRUD and lifecycle for leads, contacts, opportunities, and tasks, including the canonical lead-to-deal conversion with Contact/Account/Opportunity creation.\n- Rich account and opportunity retrieval with related contacts, leads, notes, calls, tasks, emails, events, contact roles, and line items.\n- Filtered search across accounts, contacts, leads, and opportunities with owner-scoped (me/all) and paginated results.\n- Activity logging and task management: log completed calls, create follow-up tasks, and list or update assigned tasks with overdue filters.\n- Org-aware validation: picklist checks, conversion guards, and WhoAmI for authenticated user and org context.\n\n**OAuth**\nRequires Salesforce OAuth. See the [Arcade Salesforce auth provider docs](https://docs.arcade.dev/en/references/auth-providers/salesforce) for configuration.\n\n**Secrets**\n- `SALESFORCE_ORG_SUBDOMAIN` — target org subdomain.\n- `SALESFORCE_MAX_CONCURRENT_REQUESTS` — concurrency limit for batched related-record fetches.\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)." }