Skip to content

improvement(integrations): add Managed Agents templates and guard docs links - #6608

Merged
waleedlatif1 merged 4 commits into
stagingfrom
investigate/explore-managed-agents
Aug 12, 2026
Merged

improvement(integrations): add Managed Agents templates and guard docs links#6608
waleedlatif1 merged 4 commits into
stagingfrom
investigate/explore-managed-agents

Conversation

@waleedlatif1

Copy link
Copy Markdown
Collaborator

Summary

  • Add 9 templates and 7 suggested skills to the Claude Managed Agents block — it was one of the few visible integrations with neither, so its detail page had nothing to show. Each skill maps to operations the block actually exposes (run/create session, send message, tool confirmations, custom tool results, list events, interrupt, archive/delete, memory stores).
  • Fix 6 broken docsLink values. managed_agent pointed at integrations/managed-agent (hyphen) while the page is managed_agent; datagma, dropcontact, icypeas, leadmagic, and thrive used a stale tools/ prefix. All six 404'd.
  • Add a CI guard so this class of bug fails the build. check-integration-catalog.ts now resolves every visible integration's docsLink to a real .mdx, and the 6 blocks that deliberately link to vendor docs are an explicit allowlist rather than an unchecked pass — a newly pasted vendor URL, or a stale allowlist entry, now fails.
  • Collapse the docs-URL contract onto one exported helper. generate-docs.ts had two copies of the default and the checker was adding a third; it now owns defaultIntegrationDocsUrl() and both consumers use it, so the checker can't validate a different rule than the generator emits.

Type of Change

  • Bug fix

Testing

Verified the guard fails on each case it exists to catch — a broken Sim link, an un-allowlisted vendor link, and a stale allowlist entry — and returns green when restored. Confirmed the 9 templates resolve as owned with valid alsoIntegrations, and the 7 skill names are unique. bun run scripts/check-integration-catalog.ts passes (237 integrations), type-check and biome are clean, and blocks/ tests pass (510).

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

…s links
The Claude Managed Agents block shipped without templates or suggested
skills, so its integration detail page had nothing to offer and the
"Add to Sim" chat handoff was the only affordance. Add nine templates
and seven skills, each grounded in an operation the block actually
exposes.
Its docsLink also pointed at integrations/managed-agent while the page
is managed_agent, so the link 404'd. Five more blocks had the same
class of bug via a stale tools/ prefix. Nothing validated these,
because the catalog check only compares deployment fields.
Add that validation, and collapse the three copies of the docs-URL
contract onto one exported helper so the checker and the generator
cannot drift apart.
@vercel

vercelBot commented Aug 12, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
docsReadyReadyPreviewAug 12, 2026 8:36am

Request Review

@cursor

cursorBot commented Aug 12, 2026

Copy link
Copy Markdown

PR Summary

Low Risk
Presentation and docs-link fixes plus a CI guard; no runtime execution, auth, or data-handling logic changes.

Overview
Fills out the Claude Managed Agents detail page with 9 workflow templates and 7 suggested skills covering session lifecycle, tool approvals, custom tools, auditing, and memory.

Fixes 6 broken docsLinks that 404'd: managed_agent hyphen vs underscore, plus datagma, dropcontact, icypeas, leadmagic, and thrive still pointing at the stale tools/ path. Updates both block configs and integrations.json.

Adds a CI check in check-integration-catalog.ts that every visible integration's docs link resolves to a real .mdx page, with an explicit allowlist for vendor-docs exceptions. Centralizes the default URL in defaultIntegrationDocsUrl() so the generator and checker share one contract.

Reviewed by Cursor Bugbot for commit 12dc12b. Configure here.

@greptile-apps

greptile-appsBot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

The PR adds Managed Agents templates and skills, corrects six integration documentation URLs, and centralizes generated documentation URL handling.

  • Validates visible integrations’ resolved documentation links against existing MDX pages.
  • Restricts external documentation links to an explicit vendor allowlist and detects stale entries.
  • Fixes the previously reported omitted-link case by deriving stale detection from the same resolved URL used by the main validation loop.

Confidence Score: 5/5

The PR appears safe to merge.

No blocking failure remains; the previously reported omitted-link stale-allowlist bypass is fixed by tracking vendor links from each block’s resolved documentation URL.

Important Files Changed

FilenameOverview
scripts/check-integration-catalog.tsAdds documentation-link validation and correctly records vendor-linked types from resolved URLs, fixing the previously reported stale-allowlist bypass.
scripts/generate-docs.tsExports the documentation origin, output path, and default integration URL helper so generation and validation share one contract.
apps/sim/blocks/blocks/managed_agent.tsCorrects the documentation URL and adds nine templates and seven skills to the Managed Agents integration metadata.
apps/sim/lib/integrations/integrations.jsonUpdates generated catalog documentation URLs to match the corrected integration routes.

Reviews (2): Last reviewed commit: "fix(integrations): resolve docsLink once..." | Re-trigger Greptile

Comment threadscripts/check-integration-catalog.ts Outdated
…owlist
The stale-allowlist predicate read block.docsLink directly while the main
loop read the resolved link, so an allowlisted block that dropped its
explicit docsLink produced undefined from the optional chain, negated to
true, and was treated as still vendor-linked — the stale entry went
undetected.
Record vendor-linked types during the single pass that already resolves
each link, so both checks agree by construction.
Comment threadapps/sim/blocks/blocks/managed_agent.ts
Comment threadscripts/check-integration-catalog.ts Outdated
@waleedlatif1

Copy link
Copy Markdown
CollaboratorAuthor

@greptile

@waleedlatif1

Copy link
Copy Markdown
CollaboratorAuthor

@cursor review

@cursorcursorBot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit 12dc12b. Configure here.

…ions claims
alsoIntegrations is documented as the blocks a template's prompt
references, and it drives which catalog pages the template cross-lists
on plus the icon cluster on the detail page. Three prompts named a
service only implicitly, or not at all: the runaway stopper claimed
Slack without mentioning it, the PR reviewer said "pull request" rather
than GitHub, and the weekly report said "emails" rather than Gmail.
Name the service in each prompt so the field is accurate and the
templates surface on the right pages.
Six blocks had a vendor documentation URL in docsLink — cursor, enrich,
enrow, google_groups, qdrant, and similarweb — which was accidental
rather than deliberate. Each already has a generated Sim page, and each
already carries the vendor's homepage on BlockMeta.url, so the vendor
link in docsLink only sent readers away from our own documentation.
Point all six at their Sim page and drop the allowlist that had been
tolerating them. Every visible integration gets a generated page, so a
docsLink outside docs.sim.ai is now always an error.
@waleedlatif1
waleedlatif1 merged commit d1bc99a into stagingAug 12, 2026
19 of 20 checks passed
@waleedlatif1
waleedlatif1 deleted the investigate/explore-managed-agents branch August 12, 2026 08:31
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@waleedlatif1