@xopcai/xopc 0.0.142 → 0.0.143

package/dist/src/connectors/builtin-catalog.js

@@ -1,47 +1,18 @@
 //#region src/connectors/builtin-catalog.ts
-function remoteMcpConnector(params) {
+const BUILTIN_CONNECTOR_BACKGROUNDS = {
+	"brave-search": "#FFF4ED",
+	fetch: "#E8F3FF",
+	filesystem: "#FFF7E6",
+	memory: "#F3E8FF",
+	playwright: "#FFFFFF",
+	"sequential-thinking": "#ECFDF5",
+	time: "#ECFEFF"
+};
+function builtinBranding(id) {
 	return {
-		id: params.id,
-		version: "1.0.0",
-		displayName: params.displayName,
-		description: params.description,
-		category: params.category,
-		kind: "mcp",
+		logoUrl: `/connector-icons/${id}.svg`,
 		source: "builtin",
-		capabilities: [
-			"tools",
-			"resources",
-			"prompts",
-			"auth.apiKey",
-			"runtime.mcp.streamableHttp"
-		],
-		tags: params.tags,
-		auth: { mode: "apiKey" },
-		setup: {
-			secrets: [{
-				key: "AUTHORIZATION_HEADER",
-				label: "Authorization header value",
-				description: "Full Authorization header value for the remote MCP endpoint, for example \"Bearer ...\".",
-				required: true
-			}],
-			config: [{
-				key: "url",
-				label: "MCP endpoint URL",
-				type: "string",
-				required: true,
-				placeholder: "https://example.com/mcp",
-				description: "Streamable HTTP MCP endpoint exposed by your provider or gateway."
-			}]
-		},
-		runtime: {
-			type: "mcp",
-			serverId: params.id,
-			serverTemplate: {
-				url: "{{config.url}}",
-				transport: "streamable-http",
-				headers: { Authorization: "{{secrets.AUTHORIZATION_HEADER}}" }
-			}
-		}
+		backgroundColor: BUILTIN_CONNECTOR_BACKGROUNDS[id] ?? "#FFFFFF"
 	};
 }
 const BUILTIN_CONNECTORS = [
@@ -53,6 +24,7 @@ const BUILTIN_CONNECTORS = [
 		category: "docs",
 		kind: "mcp",
 		source: "builtin",
+		branding: builtinBranding("fetch"),
 		capabilities: ["tools", "runtime.mcp.stdio"],
 		tags: [
 			"web",
@@ -68,6 +40,11 @@ const BUILTIN_CONNECTORS = [
 				command: "uvx",
 				args: ["mcp-server-fetch"]
 			}
+		},
+		integrationStrategy: {
+			lane: "mcp",
+			workload: "high_frequency",
+			preferred: true
 		}
 	},
 	{
@@ -78,6 +55,7 @@ const BUILTIN_CONNECTORS = [
 		category: "docs",
 		kind: "mcp",
 		source: "builtin",
+		branding: builtinBranding("filesystem"),
 		capabilities: [
 			"tools",
 			"resources",
@@ -108,6 +86,11 @@ const BUILTIN_CONNECTORS = [
 					"{{config.rootPath}}"
 				]
 			}
+		},
+		integrationStrategy: {
+			lane: "mcp",
+			workload: "high_frequency",
+			preferred: true
 		}
 	},
 	{
@@ -118,6 +101,7 @@ const BUILTIN_CONNECTORS = [
 		category: "automation",
 		kind: "mcp",
 		source: "builtin",
+		branding: builtinBranding("time"),
 		capabilities: ["tools", "runtime.mcp.stdio"],
 		tags: [
 			"time",
@@ -133,6 +117,11 @@ const BUILTIN_CONNECTORS = [
 				command: "uvx",
 				args: ["mcp-server-time"]
 			}
+		},
+		integrationStrategy: {
+			lane: "mcp",
+			workload: "high_frequency",
+			preferred: true
 		}
 	},
 	{
@@ -143,6 +132,7 @@ const BUILTIN_CONNECTORS = [
 		category: "browser",
 		kind: "mcp",
 		source: "builtin",
+		branding: builtinBranding("playwright"),
 		capabilities: ["tools", "runtime.mcp.stdio"],
 		tags: [
 			"browser",
@@ -158,36 +148,11 @@ const BUILTIN_CONNECTORS = [
 				command: "npx",
 				args: ["-y", "@playwright/mcp@latest"]
 			}
-		}
-	},
-	{
-		id: "github",
-		version: "1.0.0",
-		displayName: "GitHub",
-		description: "Work with GitHub repositories, issues, pull requests, and code search.",
-		category: "code",
-		kind: "mcp",
-		source: "builtin",
-		capabilities: [
-			"tools",
-			"auth.oauth",
-			"runtime.mcp.stdio"
-		],
-		tags: [
-			"code",
-			"repository",
-			"issues"
-		],
-		auth: { mode: "oauth" },
-		setup: {},
-		runtime: {
-			type: "mcp",
-			serverId: "github",
-			serverTemplate: {
-				command: "npx",
-				args: ["-y", "@modelcontextprotocol/server-github"],
-				env: { GITHUB_PERSONAL_ACCESS_TOKEN: "{{secrets.GITHUB_PERSONAL_ACCESS_TOKEN}}" }
-			}
+		},
+		integrationStrategy: {
+			lane: "mcp",
+			workload: "high_frequency",
+			preferred: true
 		}
 	},
 	{
@@ -198,6 +163,7 @@ const BUILTIN_CONNECTORS = [
 		category: "data",
 		kind: "mcp",
 		source: "builtin",
+		branding: builtinBranding("memory"),
 		capabilities: [
 			"tools",
 			"resources",
@@ -218,6 +184,11 @@ const BUILTIN_CONNECTORS = [
 				command: "npx",
 				args: ["-y", "@modelcontextprotocol/server-memory"]
 			}
+		},
+		integrationStrategy: {
+			lane: "mcp",
+			workload: "high_frequency",
+			preferred: true
 		}
 	},
 	{
@@ -228,6 +199,7 @@ const BUILTIN_CONNECTORS = [
 		category: "automation",
 		kind: "mcp",
 		source: "builtin",
+		branding: builtinBranding("sequential-thinking"),
 		capabilities: ["tools", "runtime.mcp.stdio"],
 		tags: [
 			"reasoning",
@@ -243,6 +215,11 @@ const BUILTIN_CONNECTORS = [
 				command: "npx",
 				args: ["-y", "@modelcontextprotocol/server-sequential-thinking"]
 			}
+		},
+		integrationStrategy: {
+			lane: "mcp",
+			workload: "high_frequency",
+			preferred: true
 		}
 	},
 	{
@@ -253,6 +230,7 @@ const BUILTIN_CONNECTORS = [
 		category: "docs",
 		kind: "mcp",
 		source: "builtin",
+		branding: builtinBranding("brave-search"),
 		capabilities: [
 			"tools",
 			"auth.apiKey",
@@ -278,52 +256,13 @@ const BUILTIN_CONNECTORS = [
 				args: ["-y", "@modelcontextprotocol/server-brave-search"],
 				env: { BRAVE_API_KEY: "{{secrets.BRAVE_API_KEY}}" }
 			}
+		},
+		integrationStrategy: {
+			lane: "mcp",
+			workload: "high_frequency",
+			preferred: true
 		}
-	},
-	remoteMcpConnector({
-		id: "notion",
-		displayName: "Notion",
-		description: "Connect a Notion-compatible remote MCP endpoint for pages, databases, and workspace context.",
-		category: "docs",
-		tags: [
-			"notion",
-			"docs",
-			"workspace"
-		]
-	}),
-	remoteMcpConnector({
-		id: "slack",
-		displayName: "Slack",
-		description: "Connect a Slack-compatible remote MCP endpoint for workspace messages and actions.",
-		category: "automation",
-		tags: [
-			"slack",
-			"messages",
-			"work"
-		]
-	}),
-	remoteMcpConnector({
-		id: "linear",
-		displayName: "Linear",
-		description: "Connect a Linear-compatible remote MCP endpoint for issues, projects, and triage workflows.",
-		category: "code",
-		tags: [
-			"linear",
-			"issues",
-			"work"
-		]
-	}),
-	remoteMcpConnector({
-		id: "google-drive",
-		displayName: "Google Drive",
-		description: "Connect a Google Drive-compatible remote MCP endpoint for documents and shared files.",
-		category: "docs",
-		tags: [
-			"google",
-			"drive",
-			"docs"
-		]
-	})
+	}
 ];
 //#endregion
 export { BUILTIN_CONNECTORS };

package/dist/src/connectors/builtin-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-catalog.js","names":[],"sources":["../../../src/connectors/builtin-catalog.ts"],"sourcesContent":["import type { ConnectorDefinition } from './types.js';\n\nfunction remoteMcpConnector(params: {\n  id: string;\n  displayName: string;\n  description: string;\n  category: ConnectorDefinition['category'];\n  tags: string[];\n}): ConnectorDefinition {\n  return {\n    id: params.id,\n    version: '1.0.0',\n    displayName: params.displayName,\n    description: params.description,\n    category: params.category,\n    kind: 'mcp',\n    source: 'builtin',\n    capabilities: ['tools', 'resources', 'prompts', 'auth.apiKey', 'runtime.mcp.streamableHttp'],\n    tags: params.tags,\n    auth: { mode: 'apiKey' },\n    setup: {\n      secrets: [\n        {\n          key: 'AUTHORIZATION_HEADER',\n          label: 'Authorization header value',\n          description: 'Full Authorization header value for the remote MCP endpoint, for example \"Bearer ...\".',\n          required: true,\n        },\n      ],\n      config: [\n        {\n          key: 'url',\n          label: 'MCP endpoint URL',\n          type: 'string',\n          required: true,\n          placeholder: 'https://example.com/mcp',\n          description: 'Streamable HTTP MCP endpoint exposed by your provider or gateway.',\n        },\n      ],\n    },\n    runtime: {\n      type: 'mcp',\n      serverId: params.id,\n      serverTemplate: {\n        url: '{{config.url}}',\n        transport: 'streamable-http',\n        headers: {\n          Authorization: '{{secrets.AUTHORIZATION_HEADER}}',\n        },\n      },\n    },\n  };\n}\n\nexport const BUILTIN_CONNECTORS: readonly ConnectorDefinition[] = [\n  {\n    id: 'fetch',\n    version: '1.0.0',\n    displayName: 'Fetch',\n    description: 'Fetch and read web pages through the official MCP fetch server.',\n    category: 'docs',\n    kind: 'mcp',\n    source: 'builtin',\n    capabilities: ['tools', 'runtime.mcp.stdio'],\n    tags: ['web', 'docs', 'http'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'fetch',\n      serverTemplate: {\n        command: 'uvx',\n        args: ['mcp-server-fetch'],\n      },\n    },\n  },\n  {\n    id: 'filesystem',\n    version: '1.0.0',\n    displayName: 'Filesystem',\n    description: 'Read and search files from an explicitly selected local directory.',\n    category: 'docs',\n    kind: 'mcp',\n    source: 'builtin',\n    capabilities: ['tools', 'resources', 'runtime.mcp.stdio'],\n    tags: ['files', 'local', 'docs'],\n    auth: { mode: 'none' },\n    setup: {\n      config: [\n        {\n          key: 'rootPath',\n          label: 'Allowed directory',\n          type: 'path',\n          required: true,\n          placeholder: '/Users/you/project',\n          description: 'The only directory this connector can expose to the MCP runtime.',\n        },\n      ],\n    },\n    runtime: {\n      type: 'mcp',\n      serverId: 'filesystem',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@modelcontextprotocol/server-filesystem', '{{config.rootPath}}'],\n      },\n    },\n  },\n  {\n    id: 'time',\n    version: '1.0.0',\n    displayName: 'Time',\n    description: 'Convert time zones and answer current-time questions through an MCP time server.',\n    category: 'automation',\n    kind: 'mcp',\n    source: 'builtin',\n    capabilities: ['tools', 'runtime.mcp.stdio'],\n    tags: ['time', 'timezone', 'utility'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'time',\n      serverTemplate: {\n        command: 'uvx',\n        args: ['mcp-server-time'],\n      },\n    },\n  },\n  {\n    id: 'playwright',\n    version: '1.0.0',\n    displayName: 'Playwright',\n    description: 'Automate and inspect browser pages through the official Playwright MCP server.',\n    category: 'browser',\n    kind: 'mcp',\n    source: 'builtin',\n    capabilities: ['tools', 'runtime.mcp.stdio'],\n    tags: ['browser', 'automation', 'testing'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'playwright',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@playwright/mcp@latest'],\n      },\n    },\n  },\n  {\n    id: 'github',\n    version: '1.0.0',\n    displayName: 'GitHub',\n    description: 'Work with GitHub repositories, issues, pull requests, and code search.',\n    category: 'code',\n    kind: 'mcp',\n    source: 'builtin',\n    capabilities: ['tools', 'auth.oauth', 'runtime.mcp.stdio'],\n    tags: ['code', 'repository', 'issues'],\n    auth: { mode: 'oauth' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'github',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@modelcontextprotocol/server-github'],\n        env: {\n          GITHUB_PERSONAL_ACCESS_TOKEN: '{{secrets.GITHUB_PERSONAL_ACCESS_TOKEN}}',\n        },\n      },\n    },\n  },\n  {\n    id: 'memory',\n    version: '1.0.0',\n    displayName: 'Memory',\n    description: 'Give the agent a simple MCP knowledge graph memory store.',\n    category: 'data',\n    kind: 'mcp',\n    source: 'builtin',\n    capabilities: ['tools', 'resources', 'runtime.mcp.stdio', 'memory_source'],\n    tags: ['memory', 'knowledge', 'personalization'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'memory',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@modelcontextprotocol/server-memory'],\n      },\n    },\n  },\n  {\n    id: 'sequential-thinking',\n    version: '1.0.0',\n    displayName: 'Sequential Thinking',\n    description: 'Add a structured reasoning scratchpad MCP server for multi-step tasks.',\n    category: 'automation',\n    kind: 'mcp',\n    source: 'builtin',\n    capabilities: ['tools', 'runtime.mcp.stdio'],\n    tags: ['reasoning', 'planning', 'utility'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'sequential-thinking',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@modelcontextprotocol/server-sequential-thinking'],\n      },\n    },\n  },\n  {\n    id: 'brave-search',\n    version: '1.0.0',\n    displayName: 'Brave Search',\n    description: 'Search the web through the Brave Search MCP server.',\n    category: 'docs',\n    kind: 'mcp',\n    source: 'builtin',\n    capabilities: ['tools', 'auth.apiKey', 'runtime.mcp.stdio'],\n    tags: ['search', 'web', 'research'],\n    auth: { mode: 'apiKey' },\n    setup: {\n      secrets: [\n        {\n          key: 'BRAVE_API_KEY',\n          label: 'Brave API key',\n          description: 'Stored in the xopc credential store and passed to the MCP server at runtime.',\n          required: true,\n        },\n      ],\n    },\n    runtime: {\n      type: 'mcp',\n      serverId: 'brave-search',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@modelcontextprotocol/server-brave-search'],\n        env: {\n          BRAVE_API_KEY: '{{secrets.BRAVE_API_KEY}}',\n        },\n      },\n    },\n  },\n  remoteMcpConnector({\n    id: 'notion',\n    displayName: 'Notion',\n    description: 'Connect a Notion-compatible remote MCP endpoint for pages, databases, and workspace context.',\n    category: 'docs',\n    tags: ['notion', 'docs', 'workspace'],\n  }),\n  remoteMcpConnector({\n    id: 'slack',\n    displayName: 'Slack',\n    description: 'Connect a Slack-compatible remote MCP endpoint for workspace messages and actions.',\n    category: 'automation',\n    tags: ['slack', 'messages', 'work'],\n  }),\n  remoteMcpConnector({\n    id: 'linear',\n    displayName: 'Linear',\n    description: 'Connect a Linear-compatible remote MCP endpoint for issues, projects, and triage workflows.',\n    category: 'code',\n    tags: ['linear', 'issues', 'work'],\n  }),\n  remoteMcpConnector({\n    id: 'google-drive',\n    displayName: 'Google Drive',\n    description: 'Connect a Google Drive-compatible remote MCP endpoint for documents and shared files.',\n    category: 'docs',\n    tags: ['google', 'drive', 'docs'],\n  }),\n];\n"],"mappings":"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"}
+{"version":3,"file":"builtin-catalog.js","names":[],"sources":["../../../src/connectors/builtin-catalog.ts"],"sourcesContent":["import type { ConnectorDefinition } from './types.js';\n\nconst BUILTIN_CONNECTOR_BACKGROUNDS: Record<string, string> = {\n  'brave-search': '#FFF4ED',\n  fetch: '#E8F3FF',\n  filesystem: '#FFF7E6',\n  memory: '#F3E8FF',\n  playwright: '#FFFFFF',\n  'sequential-thinking': '#ECFDF5',\n  time: '#ECFEFF',\n};\n\nfunction builtinBranding(id: string): NonNullable<ConnectorDefinition['branding']> {\n  return {\n    logoUrl: `/connector-icons/${id}.svg`,\n    source: 'builtin',\n    backgroundColor: BUILTIN_CONNECTOR_BACKGROUNDS[id] ?? '#FFFFFF',\n  };\n}\n\nexport const BUILTIN_CONNECTORS: readonly ConnectorDefinition[] = [\n  {\n    id: 'fetch',\n    version: '1.0.0',\n    displayName: 'Fetch',\n    description: 'Fetch and read web pages through the official MCP fetch server.',\n    category: 'docs',\n    kind: 'mcp',\n    source: 'builtin',\n    branding: builtinBranding('fetch'),\n    capabilities: ['tools', 'runtime.mcp.stdio'],\n    tags: ['web', 'docs', 'http'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'fetch',\n      serverTemplate: {\n        command: 'uvx',\n        args: ['mcp-server-fetch'],\n      },\n    },\n    integrationStrategy: { lane: 'mcp', workload: 'high_frequency', preferred: true },\n  },\n  {\n    id: 'filesystem',\n    version: '1.0.0',\n    displayName: 'Filesystem',\n    description: 'Read and search files from an explicitly selected local directory.',\n    category: 'docs',\n    kind: 'mcp',\n    source: 'builtin',\n    branding: builtinBranding('filesystem'),\n    capabilities: ['tools', 'resources', 'runtime.mcp.stdio'],\n    tags: ['files', 'local', 'docs'],\n    auth: { mode: 'none' },\n    setup: {\n      config: [\n        {\n          key: 'rootPath',\n          label: 'Allowed directory',\n          type: 'path',\n          required: true,\n          placeholder: '/Users/you/project',\n          description: 'The only directory this connector can expose to the MCP runtime.',\n        },\n      ],\n    },\n    runtime: {\n      type: 'mcp',\n      serverId: 'filesystem',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@modelcontextprotocol/server-filesystem', '{{config.rootPath}}'],\n      },\n    },\n    integrationStrategy: { lane: 'mcp', workload: 'high_frequency', preferred: true },\n  },\n  {\n    id: 'time',\n    version: '1.0.0',\n    displayName: 'Time',\n    description: 'Convert time zones and answer current-time questions through an MCP time server.',\n    category: 'automation',\n    kind: 'mcp',\n    source: 'builtin',\n    branding: builtinBranding('time'),\n    capabilities: ['tools', 'runtime.mcp.stdio'],\n    tags: ['time', 'timezone', 'utility'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'time',\n      serverTemplate: {\n        command: 'uvx',\n        args: ['mcp-server-time'],\n      },\n    },\n    integrationStrategy: { lane: 'mcp', workload: 'high_frequency', preferred: true },\n  },\n  {\n    id: 'playwright',\n    version: '1.0.0',\n    displayName: 'Playwright',\n    description: 'Automate and inspect browser pages through the official Playwright MCP server.',\n    category: 'browser',\n    kind: 'mcp',\n    source: 'builtin',\n    branding: builtinBranding('playwright'),\n    capabilities: ['tools', 'runtime.mcp.stdio'],\n    tags: ['browser', 'automation', 'testing'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'playwright',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@playwright/mcp@latest'],\n      },\n    },\n    integrationStrategy: { lane: 'mcp', workload: 'high_frequency', preferred: true },\n  },\n  {\n    id: 'memory',\n    version: '1.0.0',\n    displayName: 'Memory',\n    description: 'Give the agent a simple MCP knowledge graph memory store.',\n    category: 'data',\n    kind: 'mcp',\n    source: 'builtin',\n    branding: builtinBranding('memory'),\n    capabilities: ['tools', 'resources', 'runtime.mcp.stdio', 'memory_source'],\n    tags: ['memory', 'knowledge', 'personalization'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'memory',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@modelcontextprotocol/server-memory'],\n      },\n    },\n    integrationStrategy: { lane: 'mcp', workload: 'high_frequency', preferred: true },\n  },\n  {\n    id: 'sequential-thinking',\n    version: '1.0.0',\n    displayName: 'Sequential Thinking',\n    description: 'Add a structured reasoning scratchpad MCP server for multi-step tasks.',\n    category: 'automation',\n    kind: 'mcp',\n    source: 'builtin',\n    branding: builtinBranding('sequential-thinking'),\n    capabilities: ['tools', 'runtime.mcp.stdio'],\n    tags: ['reasoning', 'planning', 'utility'],\n    auth: { mode: 'none' },\n    setup: {},\n    runtime: {\n      type: 'mcp',\n      serverId: 'sequential-thinking',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@modelcontextprotocol/server-sequential-thinking'],\n      },\n    },\n    integrationStrategy: { lane: 'mcp', workload: 'high_frequency', preferred: true },\n  },\n  {\n    id: 'brave-search',\n    version: '1.0.0',\n    displayName: 'Brave Search',\n    description: 'Search the web through the Brave Search MCP server.',\n    category: 'docs',\n    kind: 'mcp',\n    source: 'builtin',\n    branding: builtinBranding('brave-search'),\n    capabilities: ['tools', 'auth.apiKey', 'runtime.mcp.stdio'],\n    tags: ['search', 'web', 'research'],\n    auth: { mode: 'apiKey' },\n    setup: {\n      secrets: [\n        {\n          key: 'BRAVE_API_KEY',\n          label: 'Brave API key',\n          description: 'Stored in the xopc credential store and passed to the MCP server at runtime.',\n          required: true,\n        },\n      ],\n    },\n    runtime: {\n      type: 'mcp',\n      serverId: 'brave-search',\n      serverTemplate: {\n        command: 'npx',\n        args: ['-y', '@modelcontextprotocol/server-brave-search'],\n        env: {\n          BRAVE_API_KEY: '{{secrets.BRAVE_API_KEY}}',\n        },\n      },\n    },\n    integrationStrategy: { lane: 'mcp', workload: 'high_frequency', preferred: true },\n  },\n];\n"],"mappings":"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"}

package/dist/src/connectors/catalog.js

@@ -1,11 +1,16 @@
+import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
+import { getCachedConnectorCatalogEntry, listCachedConnectorCatalogEntries } from "../storage/sqlite/connector-repository.js";
 import { listConnectorProviderDefinitions, listConnectorProviders } from "./providers.js";
 //#region src/connectors/catalog.ts
 const CONNECTOR_BY_ID = new Map(listConnectorProviderDefinitions().map((connector) => [connector.id, connector]));
 function listConnectorCatalog() {
-	return listConnectorProviderDefinitions().sort((left, right) => left.displayName.localeCompare(right.displayName));
+	const definitions = [...isXopcDatabaseOpen() ? listCachedConnectorCatalogEntries().map((entry) => entry.definition) : [], ...listConnectorProviderDefinitions()];
+	return [...new Map(definitions.map((connector) => [connector.id, connector])).values()].sort((left, right) => left.displayName.localeCompare(right.displayName));
 }
 function getConnectorDefinition(connectorId) {
-	return CONNECTOR_BY_ID.get(connectorId);
+	const providerDefinition = CONNECTOR_BY_ID.get(connectorId);
+	if (providerDefinition || !isXopcDatabaseOpen()) return providerDefinition;
+	return getCachedConnectorCatalogEntry(connectorId)?.definition;
 }
 //#endregion
 export { getConnectorDefinition, listConnectorCatalog, listConnectorProviders };

package/dist/src/connectors/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","names":[],"sources":["../../../src/connectors/catalog.ts"],"sourcesContent":["import { listConnectorProviderDefinitions, listConnectorProviders } from './providers.js';\nimport type { ConnectorDefinition } from './types.js';\n\nconst CONNECTOR_BY_ID = new Map(listConnectorProviderDefinitions().map((connector) => [connector.id, connector]));\n\nexport function listConnectorCatalog(): ConnectorDefinition[] {\n  return listConnectorProviderDefinitions().sort((left, right) => left.displayName.localeCompare(right.displayName));\n}\n\nexport function getConnectorDefinition(connectorId: string): ConnectorDefinition | undefined {\n  return CONNECTOR_BY_ID.get(connectorId);\n}\n\nexport { listConnectorProviders };\n"],"mappings":";;AAGA,MAAM,kBAAkB,IAAI,IAAI,kCAAkC,CAAC,KAAK,cAAc,CAAC,UAAU,IAAI,UAAU,CAAC,CAAC;AAEjH,SAAgB,uBAA8C;AAC5D,QAAO,kCAAkC,CAAC,MAAM,MAAM,UAAU,KAAK,YAAY,cAAc,MAAM,YAAY,CAAC;;AAGpH,SAAgB,uBAAuB,aAAsD;AAC3F,QAAO,gBAAgB,IAAI,YAAY"}
+{"version":3,"file":"catalog.js","names":[],"sources":["../../../src/connectors/catalog.ts"],"sourcesContent":["import { listConnectorProviderDefinitions, listConnectorProviders } from './providers.js';\nimport { getCachedConnectorCatalogEntry, listCachedConnectorCatalogEntries } from '../storage/sqlite/connector-repository.js';\nimport { isXopcDatabaseOpen } from '../storage/sqlite/connection.js';\nimport type { ConnectorDefinition } from './types.js';\n\nconst CONNECTOR_BY_ID = new Map(listConnectorProviderDefinitions().map((connector) => [connector.id, connector]));\n\nexport function listConnectorCatalog(): ConnectorDefinition[] {\n  const cached = isXopcDatabaseOpen()\n    ? listCachedConnectorCatalogEntries().map((entry) => entry.definition)\n    : [];\n  const definitions = [...cached, ...listConnectorProviderDefinitions()];\n  return [...new Map(definitions.map((connector) => [connector.id, connector])).values()]\n    .sort((left, right) => left.displayName.localeCompare(right.displayName));\n}\n\nexport function getConnectorDefinition(connectorId: string): ConnectorDefinition | undefined {\n  const providerDefinition = CONNECTOR_BY_ID.get(connectorId);\n  if (providerDefinition || !isXopcDatabaseOpen()) return providerDefinition;\n  const cached = getCachedConnectorCatalogEntry(connectorId)?.definition;\n  return cached;\n}\n\nexport { listConnectorProviders };\n"],"mappings":";;;;AAKA,MAAM,kBAAkB,IAAI,IAAI,kCAAkC,CAAC,KAAK,cAAc,CAAC,UAAU,IAAI,UAAU,CAAC,CAAC;AAEjH,SAAgB,uBAA8C;CAI5D,MAAM,cAAc,CAAC,GAHN,oBAAoB,GAC/B,mCAAmC,CAAC,KAAK,UAAU,MAAM,WAAW,GACpE,EAAE,EAC0B,GAAG,kCAAkC,CAAC;AACtE,QAAO,CAAC,GAAG,IAAI,IAAI,YAAY,KAAK,cAAc,CAAC,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CACpF,MAAM,MAAM,UAAU,KAAK,YAAY,cAAc,MAAM,YAAY,CAAC;;AAG7E,SAAgB,uBAAuB,aAAsD;CAC3F,MAAM,qBAAqB,gBAAgB,IAAI,YAAY;AAC3D,KAAI,sBAAsB,CAAC,oBAAoB,CAAE,QAAO;AAExD,QADe,+BAA+B,YAAY,EAAE"}

package/dist/src/connectors/composio-catalog.d.ts

@@ -0,0 +1,19 @@
+import { ComposioSessionsAdapter, type ComposioToolkitCatalogItem } from './composio-sessions.js';
+import type { ConnectorDefinition } from './types.js';
+export declare const COMPOSIO_RECOMMENDED_TOOLKITS: readonly ["gmail", "googlecalendar", "googledrive", "notion", "slack", "github", "linear", "outlook", "microsoft_teams", "jira", "dropbox", "todoist"];
+export declare const COMPOSIO_AGENT_READY_TOOLKITS: readonly ["gmail", "googlecalendar", "googledrive", "notion", "slack", "github", "linear", "outlook", "microsoft_teams", "jira", "dropbox", "todoist", "discord", "googledocs", "googlesheets", "trello", "asana", "clickup", "twitter", "spotify", "telegram", "whatsapp", "shopify", "stripe", "hubspot", "salesforce", "airtable", "figma", "youtube", "one_drive", "excel"];
+export type ComposioAgentReadyToolkit = typeof COMPOSIO_AGENT_READY_TOOLKITS[number];
+export declare const COMPOSIO_TOOLKIT_DISPLAY_NAMES: Record<ComposioAgentReadyToolkit, string>;
+export declare function connectorDefinitionFromComposioToolkit(item: ComposioToolkitCatalogItem): ConnectorDefinition;
+export type ComposioCatalogResult = {
+    connectors: ConnectorDefinition[];
+    source: 'live' | 'cache';
+    stale: boolean;
+    fetchedAt?: string;
+};
+export declare function listComposioConnectorCatalog(options?: {
+    principalId?: string;
+    refresh?: boolean;
+    adapter?: ComposioSessionsAdapter;
+    now?: number;
+}): Promise<ComposioCatalogResult>;

package/dist/src/connectors/composio-catalog.js

@@ -0,0 +1,237 @@
+import { listCachedConnectorCatalogEntries, upsertConnectorCatalogEntry } from "../storage/sqlite/connector-repository.js";
+import { ComposioSessionsAdapter } from "./composio-sessions.js";
+import { composioIntegrationStrategy } from "./integration-strategy.js";
+//#region src/connectors/composio-catalog.ts
+const CATALOG_CACHE_TTL_MS = 360 * 60 * 1e3;
+const COMPOSIO_RECOMMENDED_TOOLKITS = [
+	"gmail",
+	"googlecalendar",
+	"googledrive",
+	"notion",
+	"slack",
+	"github",
+	"linear",
+	"outlook",
+	"microsoft_teams",
+	"jira",
+	"dropbox",
+	"todoist"
+];
+const COMPOSIO_AGENT_READY_TOOLKITS = [
+	...COMPOSIO_RECOMMENDED_TOOLKITS,
+	"discord",
+	"googledocs",
+	"googlesheets",
+	"trello",
+	"asana",
+	"clickup",
+	"twitter",
+	"spotify",
+	"telegram",
+	"whatsapp",
+	"shopify",
+	"stripe",
+	"hubspot",
+	"salesforce",
+	"airtable",
+	"figma",
+	"youtube",
+	"one_drive",
+	"excel"
+];
+const COMPOSIO_TOOLKIT_DISPLAY_NAMES = {
+	gmail: "Gmail",
+	googlecalendar: "Google Calendar",
+	googledrive: "Google Drive",
+	notion: "Notion",
+	slack: "Slack",
+	github: "GitHub",
+	linear: "Linear via Composio",
+	outlook: "Outlook",
+	microsoft_teams: "Microsoft Teams",
+	jira: "Jira",
+	dropbox: "Dropbox",
+	todoist: "Todoist",
+	discord: "Discord",
+	googledocs: "Google Docs",
+	googlesheets: "Google Sheets",
+	trello: "Trello",
+	asana: "Asana",
+	clickup: "ClickUp",
+	twitter: "X (Twitter)",
+	spotify: "Spotify",
+	telegram: "Telegram",
+	whatsapp: "WhatsApp",
+	shopify: "Shopify",
+	stripe: "Stripe",
+	hubspot: "HubSpot",
+	salesforce: "Salesforce",
+	airtable: "Airtable",
+	figma: "Figma",
+	youtube: "YouTube",
+	one_drive: "OneDrive",
+	excel: "Microsoft Excel"
+};
+const RECOMMENDED = new Set(COMPOSIO_RECOMMENDED_TOOLKITS);
+const AGENT_READY = new Set(COMPOSIO_AGENT_READY_TOOLKITS);
+const LOCAL_TOOLKIT_LOGO_FILE_NAMES = {
+	googlecalendar: "google-calendar",
+	googledocs: "google-docs",
+	googledrive: "google-drive",
+	googlesheets: "google-sheets",
+	microsoft_teams: "microsoft-teams",
+	one_drive: "one-drive"
+};
+function composioLogoUrl(slug) {
+	if (AGENT_READY.has(slug)) return `/connector-icons/${LOCAL_TOOLKIT_LOGO_FILE_NAMES[slug] ?? slug}.svg`;
+	return `/connector-icons/composio/${encodeURIComponent(slug)}`;
+}
+const CONNECTOR_DESCRIPTIONS = {
+	gmail: "Find, draft, and send Gmail messages with explicit write confirmation.",
+	googlecalendar: "Find and manage Google Calendar events from conversations and workflows.",
+	googledrive: "Search and work with approved files in Google Drive.",
+	notion: "Search and update approved Notion pages and databases.",
+	slack: "Read conversations and send approved messages in Slack.",
+	github: "Work with repositories, issues, pull requests, and reviews on GitHub.",
+	linear: "Find and manage Linear issues and projects.",
+	outlook: "Read and send Outlook mail with account-level controls.",
+	microsoft_teams: "Read conversations and send approved Microsoft Teams messages.",
+	jira: "Find and manage Jira issues for an approved site.",
+	dropbox: "Search and work with approved Dropbox files.",
+	todoist: "Create and manage personal or team tasks in Todoist.",
+	discord: "Read conversations and send approved messages in Discord.",
+	googledocs: "Find, read, and update approved documents in Google Docs.",
+	googlesheets: "Read and update approved spreadsheets in Google Sheets.",
+	trello: "Find and manage Trello boards, lists, and cards.",
+	asana: "Find and manage Asana tasks and projects.",
+	clickup: "Find and manage ClickUp tasks, lists, and workspaces.",
+	twitter: "Search posts and publish approved updates on X.",
+	spotify: "Search Spotify and manage approved playlists and playback actions.",
+	telegram: "Read conversations and send approved Telegram messages.",
+	whatsapp: "Read conversations and send approved WhatsApp messages.",
+	shopify: "Work with Shopify products, customers, and orders.",
+	stripe: "Work with Stripe customers, payments, invoices, and subscriptions.",
+	hubspot: "Find and manage HubSpot contacts, companies, and deals.",
+	salesforce: "Find and manage approved Salesforce records and opportunities.",
+	airtable: "Read and update approved Airtable bases and records.",
+	figma: "Find Figma files, inspect project context, and manage comments.",
+	youtube: "Find and manage YouTube videos, channels, and playlists.",
+	one_drive: "Search and work with approved files in OneDrive.",
+	excel: "Read and update approved Microsoft Excel workbooks and tables."
+};
+const CODE_TOOLKITS = new Set([
+	"github",
+	"gitlab",
+	"bitbucket",
+	"linear",
+	"jira"
+]);
+const DOC_TOOLKITS = new Set([
+	"notion",
+	"googledocs",
+	"figma"
+]);
+const DATA_TOOLKITS = new Set([
+	"googledrive",
+	"dropbox",
+	"one_drive",
+	"googlesheets",
+	"excel",
+	"airtable"
+]);
+function categoryForToolkit(slug) {
+	if (CODE_TOOLKITS.has(slug)) return "code";
+	if (DOC_TOOLKITS.has(slug)) return "docs";
+	if (DATA_TOOLKITS.has(slug)) return "data";
+	return "automation";
+}
+function verificationForToolkit(slug) {
+	if (RECOMMENDED.has(slug) || AGENT_READY.has(slug)) return "verified";
+	return "experimental";
+}
+function connectorDefinitionFromComposioToolkit(item) {
+	const slug = item.slug.trim().toLowerCase();
+	return {
+		id: `composio-${slug}`,
+		version: "sessions-v1",
+		displayName: item.name,
+		description: CONNECTOR_DESCRIPTIONS[slug] ?? `Connect ${item.name} so agents can use approved actions on your behalf.`,
+		category: categoryForToolkit(slug),
+		kind: "composio",
+		source: "builtin",
+		capabilities: item.isNoAuth ? [
+			"tools",
+			"events",
+			"workflows"
+		] : [
+			"tools",
+			"auth.oauth",
+			"events",
+			"workflows"
+		],
+		tags: [
+			"composio",
+			slug,
+			verificationForToolkit(slug)
+		],
+		branding: {
+			logoUrl: composioLogoUrl(slug),
+			source: "composio-catalog",
+			fetchedAt: (/* @__PURE__ */ new Date()).toISOString()
+		},
+		verificationLevel: verificationForToolkit(slug),
+		auth: item.isNoAuth ? { mode: "none" } : {
+			mode: "oauth",
+			provider: "composio"
+		},
+		setup: {},
+		runtime: {
+			type: "composio",
+			toolkit: slug,
+			role: "toolkit"
+		},
+		integrationStrategy: composioIntegrationStrategy(slug)
+	};
+}
+async function listComposioConnectorCatalog(options = {}) {
+	const now = options.now ?? Date.now();
+	const cached = listCachedConnectorCatalogEntries("composio");
+	const freshCached = cached.filter((entry) => !entry.expiresAt || Date.parse(entry.expiresAt) > now);
+	if (!options.refresh && freshCached.length > 0) return {
+		connectors: freshCached.map((entry) => entry.definition),
+		source: "cache",
+		stale: false,
+		fetchedAt: freshCached[0]?.fetchedAt
+	};
+	try {
+		const toolkits = await (options.adapter ?? new ComposioSessionsAdapter()).listToolkitCatalog({ principalId: options.principalId ?? "local-owner" });
+		const fetchedAt = new Date(now).toISOString();
+		const expiresAt = new Date(now + CATALOG_CACHE_TTL_MS).toISOString();
+		const connectors = toolkits.map(connectorDefinitionFromComposioToolkit);
+		for (const definition of connectors) upsertConnectorCatalogEntry({
+			connectorId: definition.id,
+			provider: "composio",
+			definition,
+			fetchedAt,
+			expiresAt
+		});
+		return {
+			connectors,
+			source: "live",
+			stale: false,
+			fetchedAt
+		};
+	} catch (error) {
+		if (cached.length === 0) throw error;
+		return {
+			connectors: cached.map((entry) => entry.definition),
+			source: "cache",
+			stale: true,
+			fetchedAt: cached[0]?.fetchedAt
+		};
+	}
+}
+//#endregion
+export { COMPOSIO_AGENT_READY_TOOLKITS, COMPOSIO_RECOMMENDED_TOOLKITS, COMPOSIO_TOOLKIT_DISPLAY_NAMES, connectorDefinitionFromComposioToolkit, listComposioConnectorCatalog };
+
+//# sourceMappingURL=composio-catalog.js.map

package/dist/src/connectors/composio-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composio-catalog.js","names":[],"sources":["../../../src/connectors/composio-catalog.ts"],"sourcesContent":["import {\n  listCachedConnectorCatalogEntries,\n  upsertConnectorCatalogEntry,\n} from '../storage/sqlite/connector-repository.js';\nimport { ComposioSessionsAdapter, type ComposioToolkitCatalogItem } from './composio-sessions.js';\nimport { composioIntegrationStrategy } from './integration-strategy.js';\nimport type { ConnectorCategory, ConnectorDefinition, ConnectorVerificationLevel } from './types.js';\n\nconst CATALOG_CACHE_TTL_MS = 6 * 60 * 60 * 1000;\n\nexport const COMPOSIO_RECOMMENDED_TOOLKITS = [\n  'gmail',\n  'googlecalendar',\n  'googledrive',\n  'notion',\n  'slack',\n  'github',\n  'linear',\n  'outlook',\n  'microsoft_teams',\n  'jira',\n  'dropbox',\n  'todoist',\n] as const;\n\nexport const COMPOSIO_AGENT_READY_TOOLKITS = [\n  ...COMPOSIO_RECOMMENDED_TOOLKITS,\n  'discord',\n  'googledocs',\n  'googlesheets',\n  'trello',\n  'asana',\n  'clickup',\n  'twitter',\n  'spotify',\n  'telegram',\n  'whatsapp',\n  'shopify',\n  'stripe',\n  'hubspot',\n  'salesforce',\n  'airtable',\n  'figma',\n  'youtube',\n  'one_drive',\n  'excel',\n] as const;\n\nexport type ComposioAgentReadyToolkit = typeof COMPOSIO_AGENT_READY_TOOLKITS[number];\n\nexport const COMPOSIO_TOOLKIT_DISPLAY_NAMES: Record<ComposioAgentReadyToolkit, string> = {\n  gmail: 'Gmail',\n  googlecalendar: 'Google Calendar',\n  googledrive: 'Google Drive',\n  notion: 'Notion',\n  slack: 'Slack',\n  github: 'GitHub',\n  linear: 'Linear via Composio',\n  outlook: 'Outlook',\n  microsoft_teams: 'Microsoft Teams',\n  jira: 'Jira',\n  dropbox: 'Dropbox',\n  todoist: 'Todoist',\n  discord: 'Discord',\n  googledocs: 'Google Docs',\n  googlesheets: 'Google Sheets',\n  trello: 'Trello',\n  asana: 'Asana',\n  clickup: 'ClickUp',\n  twitter: 'X (Twitter)',\n  spotify: 'Spotify',\n  telegram: 'Telegram',\n  whatsapp: 'WhatsApp',\n  shopify: 'Shopify',\n  stripe: 'Stripe',\n  hubspot: 'HubSpot',\n  salesforce: 'Salesforce',\n  airtable: 'Airtable',\n  figma: 'Figma',\n  youtube: 'YouTube',\n  one_drive: 'OneDrive',\n  excel: 'Microsoft Excel',\n};\n\nconst RECOMMENDED = new Set<string>(COMPOSIO_RECOMMENDED_TOOLKITS);\nconst AGENT_READY = new Set<string>(COMPOSIO_AGENT_READY_TOOLKITS);\n\nconst LOCAL_TOOLKIT_LOGO_FILE_NAMES: Readonly<Record<string, string>> = {\n  googlecalendar: 'google-calendar',\n  googledocs: 'google-docs',\n  googledrive: 'google-drive',\n  googlesheets: 'google-sheets',\n  microsoft_teams: 'microsoft-teams',\n  one_drive: 'one-drive',\n};\n\nfunction composioLogoUrl(slug: string): string {\n  if (AGENT_READY.has(slug)) {\n    const fileName = LOCAL_TOOLKIT_LOGO_FILE_NAMES[slug] ?? slug;\n    return `/connector-icons/${fileName}.svg`;\n  }\n  return `/connector-icons/composio/${encodeURIComponent(slug)}`;\n}\n\nconst CONNECTOR_DESCRIPTIONS: Record<string, string> = {\n  gmail: 'Find, draft, and send Gmail messages with explicit write confirmation.',\n  googlecalendar: 'Find and manage Google Calendar events from conversations and workflows.',\n  googledrive: 'Search and work with approved files in Google Drive.',\n  notion: 'Search and update approved Notion pages and databases.',\n  slack: 'Read conversations and send approved messages in Slack.',\n  github: 'Work with repositories, issues, pull requests, and reviews on GitHub.',\n  linear: 'Find and manage Linear issues and projects.',\n  outlook: 'Read and send Outlook mail with account-level controls.',\n  microsoft_teams: 'Read conversations and send approved Microsoft Teams messages.',\n  jira: 'Find and manage Jira issues for an approved site.',\n  dropbox: 'Search and work with approved Dropbox files.',\n  todoist: 'Create and manage personal or team tasks in Todoist.',\n  discord: 'Read conversations and send approved messages in Discord.',\n  googledocs: 'Find, read, and update approved documents in Google Docs.',\n  googlesheets: 'Read and update approved spreadsheets in Google Sheets.',\n  trello: 'Find and manage Trello boards, lists, and cards.',\n  asana: 'Find and manage Asana tasks and projects.',\n  clickup: 'Find and manage ClickUp tasks, lists, and workspaces.',\n  twitter: 'Search posts and publish approved updates on X.',\n  spotify: 'Search Spotify and manage approved playlists and playback actions.',\n  telegram: 'Read conversations and send approved Telegram messages.',\n  whatsapp: 'Read conversations and send approved WhatsApp messages.',\n  shopify: 'Work with Shopify products, customers, and orders.',\n  stripe: 'Work with Stripe customers, payments, invoices, and subscriptions.',\n  hubspot: 'Find and manage HubSpot contacts, companies, and deals.',\n  salesforce: 'Find and manage approved Salesforce records and opportunities.',\n  airtable: 'Read and update approved Airtable bases and records.',\n  figma: 'Find Figma files, inspect project context, and manage comments.',\n  youtube: 'Find and manage YouTube videos, channels, and playlists.',\n  one_drive: 'Search and work with approved files in OneDrive.',\n  excel: 'Read and update approved Microsoft Excel workbooks and tables.',\n};\n\nconst CODE_TOOLKITS = new Set(['github', 'gitlab', 'bitbucket', 'linear', 'jira']);\nconst DOC_TOOLKITS = new Set(['notion', 'googledocs', 'figma']);\nconst DATA_TOOLKITS = new Set(['googledrive', 'dropbox', 'one_drive', 'googlesheets', 'excel', 'airtable']);\n\nfunction categoryForToolkit(slug: string): ConnectorCategory {\n  if (CODE_TOOLKITS.has(slug)) return 'code';\n  if (DOC_TOOLKITS.has(slug)) return 'docs';\n  if (DATA_TOOLKITS.has(slug)) return 'data';\n  return 'automation';\n}\n\nfunction verificationForToolkit(slug: string): ConnectorVerificationLevel {\n  if (RECOMMENDED.has(slug) || AGENT_READY.has(slug)) return 'verified';\n  return 'experimental';\n}\n\nexport function connectorDefinitionFromComposioToolkit(item: ComposioToolkitCatalogItem): ConnectorDefinition {\n  const slug = item.slug.trim().toLowerCase();\n  return {\n    id: `composio-${slug}`,\n    version: 'sessions-v1',\n    displayName: item.name,\n    description: CONNECTOR_DESCRIPTIONS[slug]\n      ?? `Connect ${item.name} so agents can use approved actions on your behalf.`,\n    category: categoryForToolkit(slug),\n    kind: 'composio',\n    source: 'builtin',\n    capabilities: item.isNoAuth\n      ? ['tools', 'events', 'workflows']\n      : ['tools', 'auth.oauth', 'events', 'workflows'],\n    tags: ['composio', slug, verificationForToolkit(slug)],\n    branding: {\n      logoUrl: composioLogoUrl(slug),\n      source: 'composio-catalog',\n      fetchedAt: new Date().toISOString(),\n    },\n    verificationLevel: verificationForToolkit(slug),\n    auth: item.isNoAuth\n      ? { mode: 'none' }\n      : { mode: 'oauth', provider: 'composio' },\n    setup: {},\n    runtime: { type: 'composio', toolkit: slug, role: 'toolkit' },\n    integrationStrategy: composioIntegrationStrategy(slug),\n  };\n}\n\nexport type ComposioCatalogResult = {\n  connectors: ConnectorDefinition[];\n  source: 'live' | 'cache';\n  stale: boolean;\n  fetchedAt?: string;\n};\n\nexport async function listComposioConnectorCatalog(options: {\n  principalId?: string;\n  refresh?: boolean;\n  adapter?: ComposioSessionsAdapter;\n  now?: number;\n} = {}): Promise<ComposioCatalogResult> {\n  const now = options.now ?? Date.now();\n  const cached = listCachedConnectorCatalogEntries('composio');\n  const freshCached = cached.filter((entry) => !entry.expiresAt || Date.parse(entry.expiresAt) > now);\n  if (!options.refresh && freshCached.length > 0) {\n    return {\n      connectors: freshCached.map((entry) => entry.definition),\n      source: 'cache',\n      stale: false,\n      fetchedAt: freshCached[0]?.fetchedAt,\n    };\n  }\n\n  try {\n    const adapter = options.adapter ?? new ComposioSessionsAdapter();\n    const toolkits = await adapter.listToolkitCatalog({ principalId: options.principalId ?? 'local-owner' });\n    const fetchedAt = new Date(now).toISOString();\n    const expiresAt = new Date(now + CATALOG_CACHE_TTL_MS).toISOString();\n    const connectors = toolkits.map(connectorDefinitionFromComposioToolkit);\n    for (const definition of connectors) {\n      upsertConnectorCatalogEntry({\n        connectorId: definition.id,\n        provider: 'composio',\n        definition,\n        fetchedAt,\n        expiresAt,\n      });\n    }\n    return { connectors, source: 'live', stale: false, fetchedAt };\n  } catch (error) {\n    if (cached.length === 0) throw error;\n    return {\n      connectors: cached.map((entry) => entry.definition),\n      source: 'cache',\n      stale: true,\n      fetchedAt: cached[0]?.fetchedAt,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/src/connectors/composio-logo.d.ts

@@ -0,0 +1 @@
+export declare function composioLogoResponse(toolkit: string): Promise<Response>;