clementine-agent 1.12.0 → 1.12.1

package/dist/cli/dashboard.js

@@ -4406,8 +4406,16 @@ If the tool returns nothing or errors, return an empty array \`[]\`.`,
             // This replaces the hardcoded CURATED_TOOLKITS — slug typos are now
             // impossible because we render directly from Composio's data, and
             // newly-added services appear automatically.
-            const [catalog, connected, configured] = await Promise.all([
-                c.listAllToolkits(),
+            let catalog = [];
+            let catalogError = null;
+            try {
+                catalog = await c.listAllToolkits();
+            }
+            catch (err) {
+                catalogError = err?.message ?? String(err);
+                console.error('[composio] catalog fetch failed:', catalogError);
+            }
+            const [connected, configured] = await Promise.all([
                 c.listConnectedToolkits(),
                 c.listToolkitSlugsWithAuthConfig(),
             ]);
@@ -4475,6 +4483,7 @@ If the tool returns nothing or errors, return an empty array \`[]\`.`,
                 toolkits,
                 featured: featured.map(t => t.slug),
                 totalCount: toolkits.length,
+                catalogError,
             });
         }
         catch (err) {
@@ -25794,7 +25803,18 @@ async function refreshComposioConnections() {
     }
     var toolkits = d.toolkits || [];
     if (toolkits.length === 0) {
-      container.innerHTML = '<div class="empty-state" style="padding:16px">No toolkits available. Check that your Composio API key is valid.</div>';
+      // Distinguish "catalog fetch failed" from "user has nothing connected".
+      // Surfacing d.catalogError tells us if Composio rejected the catalog
+      // call (different permission than connectedAccounts.list, etc.).
+      var msg = d.catalogError
+        ? 'Could not load toolkits from Composio: <code style="color:var(--red);font-size:11px">' + esc(d.catalogError) + '</code>'
+        : 'Composio returned an empty toolkit catalog. This is unusual — try refreshing.';
+      container.innerHTML =
+        '<div style="padding:16px">' +
+        '<div style="margin-bottom:12px;font-size:13px">' + msg + '</div>' +
+        '<div style="font-size:11px;color:var(--text-muted);margin-bottom:12px">If your existing connections (e.g. Outlook) work via the agent, your API key is valid — the catalog endpoint may require a different permission tier or there\\'s a transient API issue.</div>' +
+        '<button class="btn btn-sm btn-primary" onclick="refreshComposioConnections()">Retry</button>' +
+        '</div>';
       return;
     }
     // Stash full catalog in a closure so the search input can re-render

package/dist/integrations/composio/client.d.ts

@@ -79,8 +79,8 @@ export interface CatalogToolkit {
  * static CURATED_TOOLKITS array as the source of truth for the dashboard
  * Connections panel — slug typos are now impossible because we render from
  * Composio's own data, and new services appear automatically as they're
- * added. Cached at module level for 1 hour; resetComposioClient() clears
- * the cache when the API key changes.
+ * added. Cached at module level for 1 hour on success; failures don't
+ * cache (so the next request retries instead of returning stale empty).
  */
 export declare function listAllToolkits(): Promise<CatalogToolkit[]>;
 export declare function listToolkitMeta(): Promise<Map<string, ToolkitMeta>>;

package/dist/integrations/composio/client.js

@@ -342,57 +342,88 @@ const CATALOG_TTL_MS = 60 * 60 * 1000; // 1h — catalog drifts very slowly
  * static CURATED_TOOLKITS array as the source of truth for the dashboard
  * Connections panel — slug typos are now impossible because we render from
  * Composio's own data, and new services appear automatically as they're
- * added. Cached at module level for 1 hour; resetComposioClient() clears
- * the cache when the API key changes.
+ * added. Cached at module level for 1 hour on success; failures don't
+ * cache (so the next request retries instead of returning stale empty).
  */
 export async function listAllToolkits() {
     const now = Date.now();
-    if (catalogCache && now - catalogCache.at < CATALOG_TTL_MS) {
+    if (catalogCache && catalogCache.data.length > 0 && now - catalogCache.at < CATALOG_TTL_MS) {
         return catalogCache.data;
     }
     const composio = getComposio();
     if (!composio)
         return [];
-    const out = [];
-    let cursor;
-    // Bounded loop — 30 pages × 500 items = 15K ceiling, far more than any
-    // realistic catalog. Composio currently returns ~1.5K items across 3
-    // pages, but the cap makes a runaway impossible.
-    for (let page = 0; page < 30; page++) {
+    // Try the raw client first — supports cursor pagination so we get the full
+    // 1000+ catalog. If that errors (some API keys / plans restrict it), fall
+    // back to the high-level wrapper which returns up to 500 in one shot.
+    let result = [];
+    let lastError = null;
+    try {
+        result = await fetchCatalogViaRawClient(composio);
+    }
+    catch (err) {
+        lastError = err;
+        logger.warn({ err }, 'Raw-client toolkit list failed — falling back to high-level wrapper');
+    }
+    if (result.length === 0) {
         try {
-            const rawClient = composio.client;
-            const resp = await rawClient.toolkits.list({
-                limit: 500,
-                ...(cursor ? { cursor } : {}),
-            });
-            const items = (resp?.items ?? []);
-            for (const it of items) {
-                const managed = (it.composioManagedAuthSchemes ?? it.composio_managed_auth_schemes ?? []);
-                const schemes = (it.authSchemes ?? it.auth_schemes ?? []);
-                const noAuth = it.noAuth ?? it.no_auth ?? false;
-                out.push({
-                    slug: it.slug,
-                    name: it.name,
-                    logoUrl: it.meta?.logo,
-                    description: it.meta?.description,
-                    toolsCount: it.meta?.toolsCount ?? it.meta?.tools_count,
-                    authMode: noAuth ? 'none' : (managed.length > 0 ? 'managed' : (schemes.length > 0 ? 'byo' : 'none')),
-                    categories: it.meta?.categories ?? [],
-                });
-            }
-            cursor = resp?.next_cursor ?? resp?.nextCursor;
-            if (!cursor || items.length === 0)
-                break;
+            result = await fetchCatalogViaWrapper(composio);
         }
         catch (err) {
-            logger.warn({ err, page }, 'listAllToolkits page failed — stopping pagination');
-            break;
+            lastError = err;
+            logger.error({ err }, 'High-level toolkit list also failed');
         }
     }
-    catalogCache = { at: now, data: out };
-    logger.info({ count: out.length }, 'Composio catalog fetched');
+    if (result.length === 0) {
+        // Surface whichever error we hit so the dashboard can render something
+        // actionable instead of "no toolkits available".
+        const detail = lastError?.message ?? 'Unknown error';
+        throw new Error(`Composio catalog fetch failed: ${detail}`);
+    }
+    catalogCache = { at: now, data: result };
+    logger.info({ count: result.length }, 'Composio catalog fetched');
+    return result;
+}
+function normalizeCatalogItem(it) {
+    const managed = (it.composioManagedAuthSchemes ?? it.composio_managed_auth_schemes ?? []);
+    const schemes = (it.authSchemes ?? it.auth_schemes ?? []);
+    const noAuth = it.noAuth ?? it.no_auth ?? false;
+    return {
+        slug: it.slug,
+        name: it.name,
+        logoUrl: it.meta?.logo,
+        description: it.meta?.description,
+        toolsCount: it.meta?.toolsCount ?? it.meta?.tools_count,
+        authMode: noAuth ? 'none' : (managed.length > 0 ? 'managed' : (schemes.length > 0 ? 'byo' : 'none')),
+        categories: it.meta?.categories ?? [],
+    };
+}
+async function fetchCatalogViaRawClient(composio) {
+    const out = [];
+    let cursor;
+    // Bounded loop — 30 pages × 500 items = 15K ceiling.
+    for (let page = 0; page < 30; page++) {
+        const rawClient = composio.client;
+        const resp = await rawClient.toolkits.list({
+            limit: 500,
+            ...(cursor ? { cursor } : {}),
+        });
+        const items = (resp?.items ?? []);
+        for (const it of items)
+            out.push(normalizeCatalogItem(it));
+        cursor = resp?.next_cursor ?? resp?.nextCursor;
+        if (!cursor || items.length === 0)
+            break;
+    }
     return out;
 }
+async function fetchCatalogViaWrapper(composio) {
+    // High-level wrapper returns an array (up to limit). No cursor support
+    // through this path, so we cap at the documented max. Better than zero.
+    const resp = await composio.toolkits.get({ limit: 500 });
+    const items = (Array.isArray(resp) ? resp : (resp?.items ?? []));
+    return items.map(normalizeCatalogItem);
+}
 async function fetchAllToolkitMeta() {
     const composio = getComposio();
     if (!composio)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",