@xopcai/xopc 0.0.155 → 0.0.157

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

@@ -1,13 +1,5 @@
 //#region src/connectors/builtin-catalog.ts
-const BUILTIN_CONNECTOR_BACKGROUNDS = {
-	"brave-search": "#FFF4ED",
-	fetch: "#E8F3FF",
-	filesystem: "#FFF7E6",
-	memory: "#F3E8FF",
-	playwright: "#FFFFFF",
-	"sequential-thinking": "#ECFDF5",
-	time: "#ECFEFF"
-};
+const BUILTIN_CONNECTOR_BACKGROUNDS = { filesystem: "#FFF7E6" };
 function builtinBranding(id) {
 	return {
 		logoUrl: `/connector-icons/${id}.svg`,
@@ -15,254 +7,104 @@ function builtinBranding(id) {
 		backgroundColor: BUILTIN_CONNECTOR_BACKGROUNDS[id] ?? "#FFFFFF"
 	};
 }
-const BUILTIN_CONNECTORS = [
-	{
-		id: "fetch",
-		version: "1.0.0",
-		displayName: "Fetch",
-		description: "Fetch and read web pages through the official MCP fetch server.",
-		category: "docs",
-		kind: "mcp",
-		source: "builtin",
-		branding: builtinBranding("fetch"),
-		capabilities: ["tools", "runtime.mcp.stdio"],
-		tags: [
-			"web",
-			"docs",
-			"http"
-		],
-		auth: { mode: "none" },
-		setup: {},
-		runtime: {
-			type: "mcp",
-			serverId: "fetch",
-			serverTemplate: {
-				command: "uvx",
-				args: ["mcp-server-fetch"]
-			}
-		},
-		integrationStrategy: {
-			lane: "mcp",
-			workload: "high_frequency",
-			preferred: true
-		}
-	},
-	{
-		id: "filesystem",
-		version: "1.0.0",
-		displayName: "Filesystem",
-		description: "Read and search files from an explicitly selected local directory.",
-		category: "docs",
-		kind: "mcp",
-		source: "builtin",
-		branding: builtinBranding("filesystem"),
-		capabilities: [
-			"tools",
-			"resources",
-			"runtime.mcp.stdio"
-		],
-		tags: [
-			"files",
-			"local",
-			"docs"
-		],
-		auth: { mode: "none" },
-		setup: { config: [{
+const BUILTIN_CONNECTORS = [{
+	id: "local-files",
+	version: "1.0.0",
+	displayName: "Local Files / Obsidian",
+	description: "Incrementally ingest text and Markdown from an explicitly selected local folder.",
+	category: "docs",
+	kind: "memorySource",
+	source: "builtin",
+	branding: builtinBranding("local-files"),
+	capabilities: ["context", "memory_source"],
+	benefits: ["understand"],
+	tags: [
+		"files",
+		"local",
+		"obsidian",
+		"knowledge",
+		"personalization"
+	],
+	auth: { mode: "none" },
+	setup: { config: [
+		{
 			key: "rootPath",
-			label: "Allowed directory",
+			label: "Knowledge folder",
 			type: "path",
 			required: true,
-			placeholder: "/Users/you/project",
-			description: "The only directory this connector can expose to the MCP runtime."
-		}] },
-		runtime: {
-			type: "mcp",
-			serverId: "filesystem",
-			serverTemplate: {
-				command: "npx",
-				args: [
-					"-y",
-					"@modelcontextprotocol/server-filesystem",
-					"{{config.rootPath}}"
-				]
-			}
-		},
-		integrationStrategy: {
-			lane: "mcp",
-			workload: "high_frequency",
-			preferred: true
-		}
-	},
-	{
-		id: "time",
-		version: "1.0.0",
-		displayName: "Time",
-		description: "Convert time zones and answer current-time questions through an MCP time server.",
-		category: "automation",
-		kind: "mcp",
-		source: "builtin",
-		branding: builtinBranding("time"),
-		capabilities: ["tools", "runtime.mcp.stdio"],
-		tags: [
-			"time",
-			"timezone",
-			"utility"
-		],
-		auth: { mode: "none" },
-		setup: {},
-		runtime: {
-			type: "mcp",
-			serverId: "time",
-			serverTemplate: {
-				command: "uvx",
-				args: ["mcp-server-time"]
-			}
-		},
-		integrationStrategy: {
-			lane: "mcp",
-			workload: "high_frequency",
-			preferred: true
-		}
-	},
-	{
-		id: "playwright",
-		version: "1.0.0",
-		displayName: "Playwright",
-		description: "Automate and inspect browser pages through the official Playwright MCP server.",
-		category: "browser",
-		kind: "mcp",
-		source: "builtin",
-		branding: builtinBranding("playwright"),
-		capabilities: ["tools", "runtime.mcp.stdio"],
-		tags: [
-			"browser",
-			"automation",
-			"testing"
-		],
-		auth: { mode: "none" },
-		setup: {},
-		runtime: {
-			type: "mcp",
-			serverId: "playwright",
-			serverTemplate: {
-				command: "npx",
-				args: ["-y", "@playwright/mcp@latest"]
-			}
+			placeholder: "/Users/you/Documents/Notes",
+			description: "Only supported text files below this directory are ingested."
 		},
-		integrationStrategy: {
-			lane: "mcp",
-			workload: "high_frequency",
-			preferred: true
-		}
-	},
-	{
-		id: "memory",
-		version: "1.0.0",
-		displayName: "Memory",
-		description: "Give the agent a simple MCP knowledge graph memory store.",
-		category: "data",
-		kind: "mcp",
-		source: "builtin",
-		branding: builtinBranding("memory"),
-		capabilities: [
-			"tools",
-			"resources",
-			"runtime.mcp.stdio",
-			"memory_source"
-		],
-		tags: [
-			"memory",
-			"knowledge",
-			"personalization"
-		],
-		auth: { mode: "none" },
-		setup: {},
-		runtime: {
-			type: "mcp",
-			serverId: "memory",
-			serverTemplate: {
-				command: "npx",
-				args: ["-y", "@modelcontextprotocol/server-memory"]
-			}
+		{
+			key: "autoSync",
+			label: "Automatic sync",
+			type: "boolean",
+			defaultValue: true,
+			description: "Keep this knowledge source updated while the gateway is running."
 		},
-		integrationStrategy: {
-			lane: "mcp",
-			workload: "high_frequency",
-			preferred: true
+		{
+			key: "syncIntervalMinutes",
+			label: "Sync interval (minutes)",
+			type: "number",
+			defaultValue: 15,
+			description: "Automatic sync interval, clamped between 5 minutes and 24 hours."
 		}
+	] },
+	runtime: {
+		type: "memorySource",
+		sourceKind: "local-folder"
 	},
-	{
-		id: "sequential-thinking",
-		version: "1.0.0",
-		displayName: "Sequential Thinking",
-		description: "Add a structured reasoning scratchpad MCP server for multi-step tasks.",
-		category: "automation",
-		kind: "mcp",
-		source: "builtin",
-		branding: builtinBranding("sequential-thinking"),
-		capabilities: ["tools", "runtime.mcp.stdio"],
-		tags: [
-			"reasoning",
-			"planning",
-			"utility"
-		],
-		auth: { mode: "none" },
-		setup: {},
-		runtime: {
-			type: "mcp",
-			serverId: "sequential-thinking",
-			serverTemplate: {
-				command: "npx",
-				args: ["-y", "@modelcontextprotocol/server-sequential-thinking"]
-			}
-		},
-		integrationStrategy: {
-			lane: "mcp",
-			workload: "high_frequency",
-			preferred: true
+	integrationStrategy: {
+		lane: "native",
+		workload: "core",
+		preferred: true
+	}
+}, {
+	id: "filesystem",
+	version: "1.0.0",
+	displayName: "Filesystem",
+	description: "Read and search files from an explicitly selected local directory.",
+	category: "docs",
+	kind: "mcp",
+	source: "builtin",
+	branding: builtinBranding("filesystem"),
+	capabilities: [
+		"tools",
+		"resources",
+		"runtime.mcp.stdio"
+	],
+	benefits: ["understand"],
+	tags: [
+		"files",
+		"local",
+		"docs"
+	],
+	auth: { mode: "none" },
+	setup: { config: [{
+		key: "rootPath",
+		label: "Allowed directory",
+		type: "path",
+		required: true,
+		placeholder: "/Users/you/project",
+		description: "The only directory this connector can expose to the MCP runtime."
+	}] },
+	runtime: {
+		type: "mcp",
+		serverId: "filesystem",
+		serverTemplate: {
+			command: "npx",
+			args: [
+				"-y",
+				"@modelcontextprotocol/server-filesystem",
+				"{{config.rootPath}}"
+			]
 		}
 	},
-	{
-		id: "brave-search",
-		version: "1.0.0",
-		displayName: "Brave Search",
-		description: "Search the web through the Brave Search MCP server.",
-		category: "docs",
-		kind: "mcp",
-		source: "builtin",
-		branding: builtinBranding("brave-search"),
-		capabilities: [
-			"tools",
-			"auth.apiKey",
-			"runtime.mcp.stdio"
-		],
-		tags: [
-			"search",
-			"web",
-			"research"
-		],
-		auth: { mode: "apiKey" },
-		setup: { secrets: [{
-			key: "BRAVE_API_KEY",
-			label: "Brave API key",
-			description: "Stored in the xopc credential store and passed to the MCP server at runtime.",
-			required: true
-		}] },
-		runtime: {
-			type: "mcp",
-			serverId: "brave-search",
-			serverTemplate: {
-				command: "npx",
-				args: ["-y", "@modelcontextprotocol/server-brave-search"],
-				env: { BRAVE_API_KEY: "{{secrets.BRAVE_API_KEY}}" }
-			}
-		},
-		integrationStrategy: {
-			lane: "mcp",
-			workload: "high_frequency",
-			preferred: true
-		}
+	integrationStrategy: {
+		lane: "mcp",
+		workload: "high_frequency",
+		preferred: true
 	}
-];
+}];
 //#endregion
 export { BUILTIN_CONNECTORS };

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

@@ -76,9 +76,19 @@ const RECOMMENDED = new Set(COMPOSIO_RECOMMENDED_TOOLKITS);
 const AGENT_READY = new Set(COMPOSIO_AGENT_READY_TOOLKITS);
 const PERSONAL_CONTEXT_TOOLKITS = new Set([
 	"gmail",
+	"googlecalendar",
 	"googledrive",
+	"googledocs",
+	"googlesheets",
 	"notion",
-	"slack"
+	"slack",
+	"github",
+	"linear",
+	"jira",
+	"outlook",
+	"microsoft_teams",
+	"one_drive",
+	"excel"
 ]);
 const LOCAL_TOOLKIT_LOGO_FILE_NAMES = {
 	googlecalendar: "google-calendar",
@@ -145,6 +155,22 @@ const DATA_TOOLKITS = new Set([
 	"excel",
 	"airtable"
 ]);
+const COMMUNICATION_TOOLKITS = new Set([
+	"gmail",
+	"outlook",
+	"slack",
+	"microsoft_teams",
+	"discord",
+	"telegram",
+	"whatsapp",
+	"twitter"
+]);
+function benefitsForToolkit(slug) {
+	const benefits = ["act"];
+	if (PERSONAL_CONTEXT_TOOLKITS.has(slug) || DOC_TOOLKITS.has(slug) || DATA_TOOLKITS.has(slug)) benefits.unshift("understand");
+	if (COMMUNICATION_TOOLKITS.has(slug)) benefits.push("reach");
+	return benefits;
+}
 function categoryForToolkit(slug) {
 	if (CODE_TOOLKITS.has(slug)) return "code";
 	if (DOC_TOOLKITS.has(slug)) return "docs";
@@ -178,6 +204,7 @@ function connectorDefinitionFromComposioToolkit(item) {
 			"workflows",
 			...knowledgeCapabilities
 		],
+		benefits: benefitsForToolkit(slug),
 		tags: [
 			"composio",
 			slug,

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

@@ -113,7 +113,7 @@ var ComposioSessionsAdapter = class {
 		let cursor;
 		for (let page = 0; page < 20; page++) {
 			const response = await session.toolkits({
-				limit: 100,
+				limit: 50,
 				cursor
 			});
 			for (const item of response.items) items.push({

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

@@ -56,6 +56,7 @@ export declare const COMPOSIO_CONNECTORS: readonly ConnectorDefinition[];
 export declare function saveComposioApiKey(input: {
     secrets?: Record<string, unknown>;
 }, resolver?: CredentialResolver): Promise<void>;
+export declare function configureComposioApiKey(apiKey: string, resolver?: CredentialResolver): Promise<void>;
 export declare function listComposioConnections(resolver?: CredentialResolver): Promise<ComposioConnection[]>;
 export declare function inspectComposioConnectorHealth(toolkit: string, resolver?: CredentialResolver): Promise<ComposioConnectorHealth>;
 export declare function getComposioInstallationPolicy(config: Config | undefined, toolkit: string): ConnectorInstallationPolicy;

package/dist/src/connectors/composio.js

@@ -306,6 +306,13 @@ async function saveComposioApiKey(input, resolver = new CredentialResolver()) {
 	if (typeof resolved !== "string" || !resolved.trim()) throw new Error("Composio API key is required.");
 	await resolver.saveApiKey(COMPOSIO_API_KEY_PROVIDER, resolved.trim(), { profileName: "default" });
 }
+async function configureComposioApiKey(apiKey, resolver = new CredentialResolver()) {
+	const normalized = apiKey.trim();
+	if (!normalized) throw new Error("Composio API key is required.");
+	if (normalized.length > 4096) throw new Error("Composio API key is too long.");
+	await new ComposioSessionsAdapter({ resolver: { resolveApiKey: async () => normalized } }).listToolkitCatalog({ principalId: LOCAL_OWNER_PRINCIPAL });
+	await resolver.saveApiKey(COMPOSIO_API_KEY_PROVIDER, normalized, { profileName: "default" });
+}
 async function listComposioConnections(resolver = new CredentialResolver()) {
 	await new ComposioSessionsAdapter({ resolver }).syncConnections({ principalId: LOCAL_OWNER_PRINCIPAL });
 	return listConnectorConnections({ principalId: LOCAL_OWNER_PRINCIPAL }).filter((connection) => connection.provider === "composio").map((connection) => ({
@@ -552,4 +559,4 @@ async function executeComposioTool(params, resolver = new CredentialResolver())
 	return result.result;
 }
 //#endregion
-export { COMPOSIO_CONNECTORS, canUseComposioAction, executeComposioTool, getComposioInstallationPolicy, getComposioToolkitScope, inspectComposioConnectorHealth, isComposioActionAllowedByCatalog, listComposioConnections, listComposioTools, refreshComposioConnection, revokeComposioConnection, saveComposioApiKey, scopeForComposioAction, setComposioToolkitScope, startComposioAuthorize, toolkitFromComposioSlug, updateComposioConnection, updateComposioInstallationPolicy };
+export { COMPOSIO_CONNECTORS, canUseComposioAction, configureComposioApiKey, executeComposioTool, getComposioInstallationPolicy, getComposioToolkitScope, inspectComposioConnectorHealth, isComposioActionAllowedByCatalog, listComposioConnections, listComposioTools, refreshComposioConnection, revokeComposioConnection, saveComposioApiKey, scopeForComposioAction, setComposioToolkitScope, startComposioAuthorize, toolkitFromComposioSlug, updateComposioConnection, updateComposioInstallationPolicy };

package/dist/src/connectors/connector-memory-sync.d.ts

@@ -1,5 +1,6 @@
 import type { Config } from '../config/schema.js';
 import { ComposioSessionsAdapter } from './composio-sessions.js';
+export declare const COMPOSIO_MEMORY_SOURCE_TOOLKITS: Set<string>;
 export declare function syncComposioResultToMemory(input: {
     config: Config;
     connectorId: string;
@@ -13,3 +14,12 @@ export declare function syncComposioResultToMemory(input: {
     connectorId: string;
     actionId: string;
 }>;
+export declare function syncLocalFolderToMemory(input: {
+    config: Config;
+    connectorId: string;
+    agentId: string;
+}): Promise<{
+    connectorId: string;
+    sourceInstanceId: string;
+    recordIds: string[];
+}>;