Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

fix(connectors): never show the gateway's placeholder description

bubu-dudu04a84aedf3d9
diff --git a/cli/scripts/update-connector-catalog.ts b/cli/scripts/update-connector-catalog.ts
index 0ce3a8c55..bb94d9422 100644
--- a/cli/scripts/update-connector-catalog.ts
+++ b/cli/scripts/update-connector-catalog.ts
@@ -51,7 +51,8 @@ for (const row of [...(Array.isArray(rows) ? rows : rows.connectors ?? [])].sort
let auth = row.auth_type
if (auth === 'app' && row.mcp_url && await selfRegisters(row.mcp_url)) auth = 'dcr'
if (auth !== 'app' && auth !== 'dcr') continue
- items.push({ code: row.code, label: row.label ?? row.code, auth, description: row.description || before[row.code]?.description || '', ...(row.mcp_url ? { mcp_url: row.mcp_url } : {}) })
+ // A description written here is kept: the gateway's has carried placeholder text. Review new ones.
+ items.push({ code: row.code, label: row.label ?? row.code, auth, description: before[row.code]?.description || row.description || '', ...(row.mcp_url ? { mcp_url: row.mcp_url } : {}) })
await icon(row.code, (row as { image_url?: string }).image_url)
console.log(`${auth} ${row.code}`)
}
diff --git a/cli/src/lib/connectors/assets/catalog.json b/cli/src/lib/connectors/assets/catalog.json
index 39ee09e9a..f44d64102 100644
--- a/cli/src/lib/connectors/assets/catalog.json
+++ b/cli/src/lib/connectors/assets/catalog.json
@@ -393,7 +393,7 @@
"code": "notion",
"label": "Notion",
"auth": "dcr",
- "description": "Notion description abcd",
+ "description": "Pages and databases in your Notion workspace: search, read and write.",
"mcp_url": "https://mcp.notion.com/mcp"
},
{
diff --git a/cli/src/lib/connectors/catalog.ts b/cli/src/lib/connectors/catalog.ts
index 7dc60a471..923387669 100644
--- a/cli/src/lib/connectors/catalog.ts
+++ b/cli/src/lib/connectors/catalog.ts
@@ -34,7 +34,10 @@ export function services(offered?: Record<string, GatewayRow>): Record<string, C
const url = row.mcp_url ?? ''
if (url && (auth === 'dcr' || !item.mcp_url)) item.mcp_url = url
item.label = row.label || item.label || code
- item.description = row.description || item.description || ''
+ // The bundled description wins: the gateway's has carried placeholder text ("Notion description
+ // abcd"), and a service's own words do not change between releases. A service Harness does not know
+ // yet has only the gateway's.
+ item.description = item.description || row.description || ''
if (item.auth === 'dcr' && !item.mcp_url) continue
items[code] = item
}
diff --git a/cli/src/lib/connectors/connectors.spec.ts b/cli/src/lib/connectors/connectors.spec.ts
index a5747ff56..da04ea50f 100644
--- a/cli/src/lib/connectors/connectors.spec.ts
+++ b/cli/src/lib/connectors/connectors.spec.ts
@@ -324,8 +324,16 @@ describe('REST calls and the command', () => {
expect(customCode('Linear', new Set(['linear']))).toBe('custom-linear')
})
- it('bundles an icon for every service', () => {
+ it('bundles an icon and a real description for every service', () => {
expect(Object.keys(CATALOG).filter(code => !ICONS[code])).toEqual([])
+ expect(Object.values(CATALOG).filter(item => item.description.length < 20 || /abcd|lorem|placeholder|\bdescription\b/i.test(item.description))).toEqual([])
+ })
+
+ it('keeps a known service\'s own description over the gateway\'s', () => {
+ const items = services({ notion: { code: 'notion', auth_type: 'app', label: 'Notion', description: 'Notion description abcd', mcp_url: 'https://mcp.notion.com/mcp' },
+ fresh: { code: 'fresh', auth_type: 'dcr', label: 'Fresh', description: 'A service Harness does not know yet.', mcp_url: 'https://mcp.fresh.example/mcp' } })
+ expect(items.notion.description).toBe(CATALOG.notion.description)
+ expect(items.fresh.description).toBe('A service Harness does not know yet.')
})
it('adds a custom server that asks for sign-in through the same flow', async () => {
diff --git a/cli/src/lib/connectors/generated/catalog.ts b/cli/src/lib/connectors/generated/catalog.ts
index 5e297c99f..48a9960a1 100644
--- a/cli/src/lib/connectors/generated/catalog.ts
+++ b/cli/src/lib/connectors/generated/catalog.ts
@@ -394,7 +394,7 @@ export const CATALOG_ITEMS: CatalogItem[] = [
"code": "notion",
"label": "Notion",
"auth": "dcr",
- "description": "Notion description abcd",
+ "description": "Pages and databases in your Notion workspace: search, read and write.",
"mcp_url": "https://mcp.notion.com/mcp"
},
{