[senamakel]

Summary

• Expand the frontend Composio fallback catalog from a small hand-curated set to the full 118-toolkit managed-auth list documented by Composio.
• Replace the static icon mapping with Composio-hosted logo rendering plus a safe generic fallback so provider cards stay branded without breaking on logo misses.
• Clarify the Composio connect modal copy so provider access and OpenHuman's own read/write/admin agent permissions are visually distinct.
• Add/update targeted Vitest coverage for the managed-auth catalog fallback and Skills page grouping.

Problem

• Issue [Feature] Scale OAuth integrations toward Composio-class managed auth coverage #1063 asks the app to expose the broader set of Composio managed-auth providers instead of only a narrow subset.
• The existing metadata layer only knew about a handful of providers, so most managed-auth integrations would either not appear in the fallback catalog or would render as generic placeholders with weak permission framing.

Solution

• Rework app/src/components/composio/toolkitMeta.tsx into a managed-auth catalog sourced from Composio's current 118-toolkit docs list.
• Derive stable names, categories, descriptions, logo URLs, and permission-summary labels from that catalog while preserving canonical slug normalization.
• Update ComposioConnectModal to label these as managed-auth connections and explain provider data access separately from OpenHuman agent permission toggles.
• Add a focused metadata test and broaden the Skills catalog fallback test to cover the expanded surface.

Submission Checklist

• Tests added or updated (happy path + at least one failure / edge case) per docs/TESTING-STRATEGY.md
• Coverage matrix updated — added/removed/renamed feature rows in docs/TEST-COVERAGE-MATRIX.md reflect this change (or N/A: behaviour-only change)
• All affected feature IDs from the matrix are listed in the PR description under ## Related
• No new external network dependencies introduced (mock backend used per docs/TESTING-STRATEGY.md)
• Manual smoke checklist updated if this touches release-cut surfaces (docs/RELEASE-MANUAL-SMOKE.md)
• Linked issue closed via Closes #NNN in the ## Related section

Checklist notes:

• Coverage matrix: N/A: behaviour-only change to an existing Skills/Composio surface; no feature rows were added, removed, or renamed.
• Manual smoke checklist: N/A: no release manual smoke checklist entries changed for this catalog/UI copy update.

Impact

• Desktop Skills UI now surfaces a much broader managed-auth integration catalog before or alongside backend allowlist expansion.
• Provider cards and connect modals render branded logos more consistently, with graceful fallback when a logo is unavailable.
• No Rust core or transport behaviour changed.

Related

• Closes [Feature] Scale OAuth integrations toward Composio-class managed auth coverage #1063
• Feature IDs: 10.2.1, 10.2.2, 10.7.1
• Follow-up PR(s)/TODOs:
  • Consider replacing heuristic category/description assignment with backend-sourced provider metadata if/when the Composio API exposes it through our existing RPC path.

Summary by CodeRabbit

Release Notes

• New Features

  • Expanded managed authentication provider catalog with additional integrations available.
  • Provider logos now dynamically loaded from integration service with fallback support.

• UI Improvements

  • Enhanced authorization flow messaging with clearer hosted authorization details.
  • Refined permission and scope display with explicit agent permission controls and provider access information.

[coderabbitai]

Warning

Rate limit exceeded

@senamakel has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 2 minutes and 21 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9e28242a-b4a6-4b89-b241-0ddbaee3097c

📥 Commits

Reviewing files that changed from the base of the PR and between 647e4d4 and 1ed71f4.

📒 Files selected for processing (2)

• app/src/pages/__tests__/Skills.third-party-notion-debug-tools.test.tsx
• app/src/test/setup.ts

📝 Walkthrough

Walkthrough

The changes expand Composio toolkit coverage with a curated catalog of 118 managed-auth toolkits, update the connect modal UI to highlight hosted authorization and provider permissions, dynamically load toolkit logos from Composio's API with fallback handling, and introduce comprehensive test coverage for metadata generation and catalog discovery.

Changes

Cohort / File(s)	Summary
Connect Modal UI app/src/components/composio/ComposioConnectModal.tsx	Updates idle-state copy and UI to reflect managed auth flow; adds "managed auth" badge, clarifies hosted authorization in browser, and includes new "Provider access" callout describing provider capabilities and permission controls via read/write/admin toggles.
Toolkit Metadata System app/src/components/composio/toolkitMeta.tsx	Introduces local catalog of 118 managed-auth toolkits (MANAGED_COMPOSIO_TOOLKITS) derived from Composio's managed auth list; extends ComposioToolkitMeta interface with logoUrl and permissionLabel; replaces static per-provider icons with dynamic logo loading from https://logos.composio.dev/api/{slug} via ComposioLogoBadge component with fallback to GenericIntegrationIcon; generates metadata via map lookup or slug prettification for unknown entries.
Metadata & Catalog Tests app/src/components/composio/toolkitMeta.test.tsx	Adds three test cases: validates KNOWN_COMPOSIO_TOOLKITS length (118) and expected slug presence; confirms canonical display names and permission labels via composioToolkitMeta(); verifies slug normalization (e.g., google_calendar → googlecalendar) and fallback behavior for unknown toolkit slugs.
Catalog Fallback Test app/src/pages/__tests__/Skills.composio-catalog.test.tsx	Updates test expectations to require Chat and Platform category headings; adds toolkit assertions for Discord, Supabase, and Zoom; removes Notion expectation under fallback conditions.

Sequence Diagram

sequenceDiagram
    participant User
    participant Modal as ComposioConnectModal
    participant Meta as toolkitMeta
    participant LogoAPI as logos.composio.dev
    participant Fallback as GenericIcon

    User->>Modal: Open toolkit selector
    Modal->>Meta: composioToolkitMeta(slug)
    Meta->>Meta: Lookup in MANAGED_COMPOSIO_TOOLKITS
    Meta->>Meta: Generate metadata & permissionLabel
    Meta->>Modal: Return ComposioToolkitMeta + logoUrl
    Modal->>LogoAPI: Load logo from /api/{slug}
    LogoAPI-->>Modal: Image loaded ✓
    Modal->>User: Render toolkit with logo + managed auth UI
    
    Note over LogoAPI,Fallback: On image load failure:
    LogoAPI--XModal: Image 404/error
    Modal->>Fallback: Fallback to GenericIntegrationIcon
    Fallback-->>Modal: Icon component ✓
    Modal->>User: Render toolkit with fallback icon

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Possibly related PRs

• feat(composio): improve toolkit sync and connection handling #507 — Modifies app/src/components/composio/toolkitMeta in parallel; both PRs alter KNOWN_COMPOSIO_TOOLKITS derivation and toolkit metadata generation logic with overlapping scope.

Poem

🐰 One hundred and eighteen toolkits now bloom,
With logos that dance in the digital room,
No more static icons—they fetch from on high,
Composio's managed auth reaching the sky! 🌟
The rabbit rejoices, OAuth looks neat,
Scaled integrations make the picture complete! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: adding the full Composio managed-auth toolkit catalog (expanding from a small hand-curated list to 118 toolkits).
Linked Issues check	✅ Passed	The PR implements direct coding work toward issue #1063: expands frontend catalog from curated subset to full 118-toolkit Composio managed-auth list, replaces static icons with Composio-hosted logo rendering, updates connect modal UX to distinguish provider access from agent permissions, and adds test coverage.
Out of Scope Changes check	✅ Passed	All changes align with stated PR objectives: ComposioConnectModal UI updates, toolkitMeta catalog expansion and metadata enrichment, test additions for coverage, and Skills catalog fallback test updates. No unrelated modifications detected.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Review rate limit: 0/5 reviews remaining, refill in 2 minutes and 21 seconds.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

🧹 Nitpick comments (2)

app/src/components/composio/toolkitMeta.tsx (1)

244-263: 💤 Low value

Consider resetting error state when slug changes.

If ComposioLogoBadge fails to load a logo and later the same component instance receives a different slug prop, it will remain in the failed state and show the fallback icon instead of attempting to load the new logo.

This is a minor edge case since cards are typically not reused across different toolkits, but adding a reset improves robustness.

♻️ Proposed fix

 function ComposioLogoBadge({ slug, name }: { slug: string; name: string }) {
   const [failed, setFailed] = useState(false);
   const logoUrl = composioLogoUrl(slug);
+
+  // Reset failed state when slug changes so we retry loading the new logo
+  const [prevSlug, setPrevSlug] = useState(slug);
+  if (slug !== prevSlug) {
+    setPrevSlug(slug);
+    setFailed(false);
+  }

   if (failed) {
     return <GenericIntegrationIcon />;
   }

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@app/src/components/composio/toolkitMeta.tsx` around lines 244 - 263,
ComposioLogoBadge currently keeps failed=true across prop changes so when the
slug prop changes it won't retry; update the component (ComposioLogoBadge) to
reset the failed state whenever slug changes by adding a useEffect that watches
slug and calls setFailed(false) so the new logo URL (composioLogoUrl(slug)) will
be retried instead of stuck on the GenericIntegrationIcon.

app/src/components/composio/toolkitMeta.test.tsx (1)

14-25: 💤 Low value

Semantic mismatch in Gmail's permission label.

The test asserts gmail.permissionLabel is 'Docs, files, tasks, and workspace data', which is technically correct per the implementation (Gmail matches PRODUCTIVITY_KEYWORDS → Productivity category). However, this label doesn't accurately describe email access.

Consider either:

1. Adding a 'Communication' or 'Email' category with an appropriate permission label, or
2. Accepting this as acceptable grouping since Gmail is part of Google Workspace

Not blocking since the current behavior is intentional, but worth noting for UX clarity.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@app/src/components/composio/toolkitMeta.test.tsx` around lines 14 - 25, The
test reveals Gmail's permissionLabel is semantically incorrect; update
composioToolkitMeta to classify 'gmail' into a new Communication/Email category
instead of PRODUCTIVITY_KEYWORDS so it returns an appropriate permissionLabel
(e.g., "Email, contacts, and workspace data"); modify the category mapping and
any relevant keyword sets (e.g., PRODUCTIVITY_KEYWORDS) or add a new
EMAIL_KEYWORDS constant and ensure composioToolkitMeta('gmail') returns the new
label and still preserves name/logo/slug behavior.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@app/src/components/composio/toolkitMeta.test.tsx`:
- Around line 14-25: The test reveals Gmail's permissionLabel is semantically
incorrect; update composioToolkitMeta to classify 'gmail' into a new
Communication/Email category instead of PRODUCTIVITY_KEYWORDS so it returns an
appropriate permissionLabel (e.g., "Email, contacts, and workspace data");
modify the category mapping and any relevant keyword sets (e.g.,
PRODUCTIVITY_KEYWORDS) or add a new EMAIL_KEYWORDS constant and ensure
composioToolkitMeta('gmail') returns the new label and still preserves
name/logo/slug behavior.

In `@app/src/components/composio/toolkitMeta.tsx`:
- Around line 244-263: ComposioLogoBadge currently keeps failed=true across prop
changes so when the slug prop changes it won't retry; update the component
(ComposioLogoBadge) to reset the failed state whenever slug changes by adding a
useEffect that watches slug and calls setFailed(false) so the new logo URL
(composioLogoUrl(slug)) will be retried instead of stuck on the
GenericIntegrationIcon.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: cfbda2c4-4709-499c-b71f-d167511a62e2

📥 Commits

Reviewing files that changed from the base of the PR and between a084ebf and 647e4d4.

📒 Files selected for processing (4)

• app/src/components/composio/ComposioConnectModal.tsx
• app/src/components/composio/toolkitMeta.test.tsx
• app/src/components/composio/toolkitMeta.tsx
• app/src/pages/__tests__/Skills.composio-catalog.test.tsx