@xopcai/xopc 0.0.115 → 0.0.117

package/dist/src/connectors/registries/search.js

@@ -0,0 +1,89 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { modelscopeRegistryAdapter } from "./modelscope.js";
+import { officialMcpRegistryAdapter } from "./official-mcp.js";
+import { smitheryRegistryAdapter } from "./smithery.js";
+//#region src/connectors/registries/search.ts
+init_logger();
+const log = createLogger("Connectors:Registry");
+const registryAdapters = /* @__PURE__ */ new Map();
+const REGISTRY_CACHE_TTL_MS = 600 * 1e3;
+const registrySearchCache = /* @__PURE__ */ new Map();
+function registerConnectorRegistryAdapter(registration) {
+	registryAdapters.set(registration.adapter.source, registration.adapter);
+	registrySearchCache.clear();
+}
+function unregisterConnectorRegistryAdapter(source) {
+	const removed = registryAdapters.delete(source);
+	if (removed) registrySearchCache.clear();
+	return removed;
+}
+registerConnectorRegistryAdapter({ adapter: officialMcpRegistryAdapter });
+registerConnectorRegistryAdapter({ adapter: smitheryRegistryAdapter });
+registerConnectorRegistryAdapter({ adapter: modelscopeRegistryAdapter });
+function cacheKey(params) {
+	return JSON.stringify({
+		source: params.source ?? "all",
+		query: params.query?.trim() ?? "",
+		page: params.page ?? 1,
+		pageSize: params.pageSize ?? 24,
+		browse: params.browse ?? false
+	});
+}
+function listConnectorRegistries() {
+	return [...registryAdapters.values()].map((registry) => ({
+		id: registry.source,
+		displayName: registry.displayName
+	}));
+}
+function isConnectorRegistrySource(source) {
+	return registryAdapters.has(source);
+}
+async function runRegistrySearch(params) {
+	const source = params.source ?? "all";
+	const registries = source === "all" ? [...registryAdapters.values()] : [...registryAdapters.values()].filter((registry) => registry.source === source);
+	return Promise.all(registries.map(async (registry) => {
+		try {
+			return await registry.search(params);
+		} catch (error) {
+			const errorMessage = error instanceof Error ? error.message : String(error);
+			log.warn({
+				source: registry.source,
+				errorMessage
+			}, `Connector registry search failed: ${errorMessage}`);
+			return {
+				source: registry.source,
+				connectors: [],
+				error: errorMessage
+			};
+		}
+	}));
+}
+async function searchConnectorRegistries(params) {
+	if (!params.query?.trim() && !params.browse) {
+		const source = params.source ?? "all";
+		return (source === "all" ? [...registryAdapters.values()] : [...registryAdapters.values()].filter((registry) => registry.source === source)).map((registry) => ({
+			source: registry.source,
+			connectors: []
+		}));
+	}
+	const key = cacheKey(params);
+	const now = Date.now();
+	const cached = registrySearchCache.get(key);
+	if (cached && cached.expiresAt > now) return cached.promise;
+	const promise = runRegistrySearch(params);
+	registrySearchCache.set(key, {
+		expiresAt: now + REGISTRY_CACHE_TTL_MS,
+		promise
+	});
+	try {
+		return await promise;
+	} catch (error) {
+		registrySearchCache.delete(key);
+		throw error;
+	}
+}
+//#endregion
+export { isConnectorRegistrySource, listConnectorRegistries, registerConnectorRegistryAdapter, searchConnectorRegistries, unregisterConnectorRegistryAdapter };
+
+//# sourceMappingURL=search.js.map

package/dist/src/connectors/registries/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","names":[],"sources":["../../../../src/connectors/registries/search.ts"],"sourcesContent":["import { createLogger } from '../../utils/logger.js';\nimport { modelscopeRegistryAdapter } from './modelscope.js';\nimport { officialMcpRegistryAdapter } from './official-mcp.js';\nimport { smitheryRegistryAdapter } from './smithery.js';\nimport type { ConnectorRegistryAdapter, ConnectorRegistrySearchParams, ConnectorRegistrySearchResult } from './types.js';\n\nconst log = createLogger('Connectors:Registry');\n\nconst registryAdapters = new Map<string, ConnectorRegistryAdapter>();\nconst REGISTRY_CACHE_TTL_MS = 10 * 60 * 1000;\nconst registrySearchCache = new Map<string, { expiresAt: number; promise: Promise<ConnectorRegistrySearchResult[]> }>();\n\nexport type ConnectorRegistryRegistration = {\n  adapter: ConnectorRegistryAdapter;\n};\n\nexport function registerConnectorRegistryAdapter(registration: ConnectorRegistryRegistration): void {\n  registryAdapters.set(registration.adapter.source, registration.adapter);\n  registrySearchCache.clear();\n}\n\nexport function unregisterConnectorRegistryAdapter(source: string): boolean {\n  const removed = registryAdapters.delete(source);\n  if (removed) registrySearchCache.clear();\n  return removed;\n}\n\nregisterConnectorRegistryAdapter({ adapter: officialMcpRegistryAdapter });\nregisterConnectorRegistryAdapter({ adapter: smitheryRegistryAdapter });\nregisterConnectorRegistryAdapter({ adapter: modelscopeRegistryAdapter });\n\nfunction cacheKey(params: ConnectorRegistrySearchParams): string {\n  return JSON.stringify({\n    source: params.source ?? 'all',\n    query: params.query?.trim() ?? '',\n    page: params.page ?? 1,\n    pageSize: params.pageSize ?? 24,\n    browse: params.browse ?? false,\n  });\n}\n\nexport function listConnectorRegistries(): Array<{ id: string; displayName: string }> {\n  return [...registryAdapters.values()].map((registry) => ({ id: registry.source, displayName: registry.displayName }));\n}\n\nexport function isConnectorRegistrySource(source: string): boolean {\n  return registryAdapters.has(source);\n}\n\nasync function runRegistrySearch(params: ConnectorRegistrySearchParams): Promise<ConnectorRegistrySearchResult[]> {\n  const source = params.source ?? 'all';\n  const registries = source === 'all'\n    ? [...registryAdapters.values()]\n    : [...registryAdapters.values()].filter((registry) => registry.source === source);\n  return Promise.all(registries.map(async (registry) => {\n    try {\n      return await registry.search(params);\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      log.warn({ source: registry.source, errorMessage }, `Connector registry search failed: ${errorMessage}`);\n      return { source: registry.source, connectors: [], error: errorMessage } satisfies ConnectorRegistrySearchResult;\n    }\n  }));\n}\n\nexport async function searchConnectorRegistries(params: ConnectorRegistrySearchParams): Promise<ConnectorRegistrySearchResult[]> {\n  if (!params.query?.trim() && !params.browse) {\n    const source = params.source ?? 'all';\n    const registries = source === 'all'\n      ? [...registryAdapters.values()]\n      : [...registryAdapters.values()].filter((registry) => registry.source === source);\n    return registries.map((registry) => ({ source: registry.source, connectors: [] }));\n  }\n  const key = cacheKey(params);\n  const now = Date.now();\n  const cached = registrySearchCache.get(key);\n  if (cached && cached.expiresAt > now) {\n    return cached.promise;\n  }\n  const promise = runRegistrySearch(params);\n  registrySearchCache.set(key, { expiresAt: now + REGISTRY_CACHE_TTL_MS, promise });\n  try {\n    return await promise;\n  } catch (error) {\n    registrySearchCache.delete(key);\n    throw error;\n  }\n}\n"],"mappings":";;;;;;aAAqD;AAMrD,MAAM,MAAM,aAAa,sBAAsB;AAE/C,MAAM,mCAAmB,IAAI,KAAuC;AACpE,MAAM,wBAAwB,MAAU;AACxC,MAAM,sCAAsB,IAAI,KAAuF;AAMvH,SAAgB,iCAAiC,cAAmD;AAClG,kBAAiB,IAAI,aAAa,QAAQ,QAAQ,aAAa,QAAQ;AACvE,qBAAoB,OAAO;;AAG7B,SAAgB,mCAAmC,QAAyB;CAC1E,MAAM,UAAU,iBAAiB,OAAO,OAAO;AAC/C,KAAI,QAAS,qBAAoB,OAAO;AACxC,QAAO;;AAGT,iCAAiC,EAAE,SAAS,4BAA4B,CAAC;AACzE,iCAAiC,EAAE,SAAS,yBAAyB,CAAC;AACtE,iCAAiC,EAAE,SAAS,2BAA2B,CAAC;AAExE,SAAS,SAAS,QAA+C;AAC/D,QAAO,KAAK,UAAU;EACpB,QAAQ,OAAO,UAAU;EACzB,OAAO,OAAO,OAAO,MAAM,IAAI;EAC/B,MAAM,OAAO,QAAQ;EACrB,UAAU,OAAO,YAAY;EAC7B,QAAQ,OAAO,UAAU;EAC1B,CAAC;;AAGJ,SAAgB,0BAAsE;AACpF,QAAO,CAAC,GAAG,iBAAiB,QAAQ,CAAC,CAAC,KAAK,cAAc;EAAE,IAAI,SAAS;EAAQ,aAAa,SAAS;EAAa,EAAE;;AAGvH,SAAgB,0BAA0B,QAAyB;AACjE,QAAO,iBAAiB,IAAI,OAAO;;AAGrC,eAAe,kBAAkB,QAAiF;CAChH,MAAM,SAAS,OAAO,UAAU;CAChC,MAAM,aAAa,WAAW,QAC1B,CAAC,GAAG,iBAAiB,QAAQ,CAAC,GAC9B,CAAC,GAAG,iBAAiB,QAAQ,CAAC,CAAC,QAAQ,aAAa,SAAS,WAAW,OAAO;AACnF,QAAO,QAAQ,IAAI,WAAW,IAAI,OAAO,aAAa;AACpD,MAAI;AACF,UAAO,MAAM,SAAS,OAAO,OAAO;WAC7B,OAAO;GACd,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3E,OAAI,KAAK;IAAE,QAAQ,SAAS;IAAQ;IAAc,EAAE,qCAAqC,eAAe;AACxG,UAAO;IAAE,QAAQ,SAAS;IAAQ,YAAY,EAAE;IAAE,OAAO;IAAc;;GAEzE,CAAC;;AAGL,eAAsB,0BAA0B,QAAiF;AAC/H,KAAI,CAAC,OAAO,OAAO,MAAM,IAAI,CAAC,OAAO,QAAQ;EAC3C,MAAM,SAAS,OAAO,UAAU;AAIhC,UAHmB,WAAW,QAC1B,CAAC,GAAG,iBAAiB,QAAQ,CAAC,GAC9B,CAAC,GAAG,iBAAiB,QAAQ,CAAC,CAAC,QAAQ,aAAa,SAAS,WAAW,OAAO,EACjE,KAAK,cAAc;GAAE,QAAQ,SAAS;GAAQ,YAAY,EAAE;GAAE,EAAE;;CAEpF,MAAM,MAAM,SAAS,OAAO;CAC5B,MAAM,MAAM,KAAK,KAAK;CACtB,MAAM,SAAS,oBAAoB,IAAI,IAAI;AAC3C,KAAI,UAAU,OAAO,YAAY,IAC/B,QAAO,OAAO;CAEhB,MAAM,UAAU,kBAAkB,OAAO;AACzC,qBAAoB,IAAI,KAAK;EAAE,WAAW,MAAM;EAAuB;EAAS,CAAC;AACjF,KAAI;AACF,SAAO,MAAM;UACN,OAAO;AACd,sBAAoB,OAAO,IAAI;AAC/B,QAAM"}

package/dist/src/connectors/registries/smithery.d.ts

@@ -0,0 +1,2 @@
+import type { ConnectorRegistryAdapter } from './types.js';
+export declare const smitheryRegistryAdapter: ConnectorRegistryAdapter;

package/dist/src/connectors/registries/smithery.js

@@ -0,0 +1,98 @@
+//#region src/connectors/registries/smithery.ts
+const DEFAULT_BASE_URL = "https://registry.smithery.ai";
+function smitheryApiKey() {
+	return process.env.XOPC_SMITHERY_API_KEY?.trim() || process.env.SMITHERY_API_KEY?.trim() || void 0;
+}
+function smitheryBaseUrl() {
+	return process.env.XOPC_SMITHERY_REGISTRY_URL?.trim().replace(/\/+$/, "") || DEFAULT_BASE_URL;
+}
+function readString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function slugFrom(value) {
+	return value.trim().toLowerCase().replace(/^@/, "").replace(/[^a-z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "smithery-mcp";
+}
+function connectorFromSmitheryServer(server, apiKey) {
+	const qualifiedName = readString(server.qualifiedName ?? server.qualified_name ?? server.name ?? server.id);
+	const displayName = readString(server.displayName ?? server.display_name ?? server.name) ?? qualifiedName;
+	if (!qualifiedName || !displayName) return void 0;
+	const serverId = slugFrom(qualifiedName);
+	const url = `https://server.smithery.ai/${qualifiedName.split("/").map((part) => encodeURIComponent(part)).join("/")}/mcp`;
+	return {
+		id: `smithery-${serverId}`,
+		version: readString(server.version) ?? "registry",
+		displayName,
+		description: readString(server.description) ?? "MCP server hosted through Smithery.",
+		category: "custom",
+		kind: "mcp",
+		source: "registry",
+		capabilities: [
+			"tools",
+			"resources",
+			"prompts",
+			"auth.apiKey",
+			"runtime.mcp.streamableHttp"
+		],
+		tags: [
+			"smithery",
+			"registry",
+			"mcp"
+		],
+		auth: { mode: "apiKey" },
+		setup: apiKey ? {} : { secrets: [{
+			key: "SMITHERY_AUTHORIZATION_HEADER",
+			label: "Smithery Authorization header",
+			description: "Full Authorization header used when launching hosted Smithery MCP servers, for example \"Bearer ...\".",
+			required: true
+		}] },
+		runtime: {
+			type: "mcp",
+			serverId,
+			serverTemplate: {
+				url,
+				transport: "streamable-http",
+				headers: { Authorization: apiKey ? `Bearer ${apiKey}` : "{{secrets.SMITHERY_AUTHORIZATION_HEADER}}" }
+			}
+		}
+	};
+}
+function extractServers(payload) {
+	if (Array.isArray(payload)) return payload.filter((item) => Boolean(item && typeof item === "object" && !Array.isArray(item)));
+	if (!payload || typeof payload !== "object" || Array.isArray(payload)) return [];
+	const data = payload;
+	for (const key of [
+		"servers",
+		"items",
+		"results",
+		"data"
+	]) {
+		const value = data[key];
+		if (Array.isArray(value)) return value.filter((item) => Boolean(item && typeof item === "object" && !Array.isArray(item)));
+	}
+	return [];
+}
+const smitheryRegistryAdapter = {
+	source: "smithery",
+	displayName: "Smithery",
+	async search(params) {
+		const apiKey = smitheryApiKey();
+		const url = new URL("/servers", smitheryBaseUrl());
+		const query = params.query?.trim();
+		if (query) url.searchParams.set("q", query);
+		url.searchParams.set("pageSize", String(Math.min(Math.max(params.pageSize ?? 24, 1), 100)));
+		if (params.page && params.page > 1) url.searchParams.set("page", String(params.page));
+		const response = await fetch(url, { headers: {
+			Accept: "application/json",
+			...apiKey ? { Authorization: `Bearer ${apiKey}` } : {}
+		} });
+		if (!response.ok) throw new Error(`Smithery registry returned ${response.status}`);
+		return {
+			source: "smithery",
+			connectors: extractServers(await response.json()).map((server) => connectorFromSmitheryServer(server, apiKey)).filter((item) => Boolean(item))
+		};
+	}
+};
+//#endregion
+export { smitheryRegistryAdapter };
+
+//# sourceMappingURL=smithery.js.map

package/dist/src/connectors/registries/smithery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smithery.js","names":[],"sources":["../../../../src/connectors/registries/smithery.ts"],"sourcesContent":["import type { ConnectorDefinition } from '../types.js';\nimport type { ConnectorRegistryAdapter, ConnectorRegistrySearchParams, ConnectorRegistrySearchResult } from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://registry.smithery.ai';\n\nfunction smitheryApiKey(): string | undefined {\n  return process.env.XOPC_SMITHERY_API_KEY?.trim() || process.env.SMITHERY_API_KEY?.trim() || undefined;\n}\n\nfunction smitheryBaseUrl(): string {\n  return process.env.XOPC_SMITHERY_REGISTRY_URL?.trim().replace(/\\/+$/, '') || DEFAULT_BASE_URL;\n}\n\nfunction readString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\nfunction slugFrom(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/^@/, '')\n    .replace(/[^a-z0-9_-]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 64) || 'smithery-mcp';\n}\n\nfunction connectorFromSmitheryServer(server: Record<string, unknown>, apiKey?: string): ConnectorDefinition | undefined {\n  const qualifiedName = readString(server.qualifiedName ?? server.qualified_name ?? server.name ?? server.id);\n  const displayName = readString(server.displayName ?? server.display_name ?? server.name) ?? qualifiedName;\n  if (!qualifiedName || !displayName) return undefined;\n  const serverId = slugFrom(qualifiedName);\n  const encodedPath = qualifiedName.split('/').map((part) => encodeURIComponent(part)).join('/');\n  const url = `https://server.smithery.ai/${encodedPath}/mcp`;\n  return {\n    id: `smithery-${serverId}`,\n    version: readString(server.version) ?? 'registry',\n    displayName,\n    description: readString(server.description) ?? 'MCP server hosted through Smithery.',\n    category: 'custom',\n    kind: 'mcp',\n    source: 'registry',\n    capabilities: ['tools', 'resources', 'prompts', 'auth.apiKey', 'runtime.mcp.streamableHttp'],\n    tags: ['smithery', 'registry', 'mcp'],\n    auth: { mode: 'apiKey' },\n    setup: apiKey\n      ? {}\n      : {\n          secrets: [\n            {\n              key: 'SMITHERY_AUTHORIZATION_HEADER',\n              label: 'Smithery Authorization header',\n              description: 'Full Authorization header used when launching hosted Smithery MCP servers, for example \"Bearer ...\".',\n              required: true,\n            },\n          ],\n        },\n    runtime: {\n      type: 'mcp',\n      serverId,\n      serverTemplate: {\n        url,\n        transport: 'streamable-http',\n        headers: {\n          Authorization: apiKey ? `Bearer ${apiKey}` : '{{secrets.SMITHERY_AUTHORIZATION_HEADER}}',\n        },\n      },\n    },\n  };\n}\n\nfunction extractServers(payload: unknown): Record<string, unknown>[] {\n  if (Array.isArray(payload)) return payload.filter((item): item is Record<string, unknown> => Boolean(item && typeof item === 'object' && !Array.isArray(item)));\n  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return [];\n  const data = payload as Record<string, unknown>;\n  for (const key of ['servers', 'items', 'results', 'data']) {\n    const value = data[key];\n    if (Array.isArray(value)) {\n      return value.filter((item): item is Record<string, unknown> => Boolean(item && typeof item === 'object' && !Array.isArray(item)));\n    }\n  }\n  return [];\n}\n\nexport const smitheryRegistryAdapter: ConnectorRegistryAdapter = {\n  source: 'smithery',\n  displayName: 'Smithery',\n  async search(params: ConnectorRegistrySearchParams): Promise<ConnectorRegistrySearchResult> {\n    const apiKey = smitheryApiKey();\n    const url = new URL('/servers', smitheryBaseUrl());\n    const query = params.query?.trim();\n    if (query) url.searchParams.set('q', query);\n    url.searchParams.set('pageSize', String(Math.min(Math.max(params.pageSize ?? 24, 1), 100)));\n    if (params.page && params.page > 1) url.searchParams.set('page', String(params.page));\n    const response = await fetch(url, {\n      headers: {\n        Accept: 'application/json',\n        ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),\n      },\n    });\n    if (!response.ok) throw new Error(`Smithery registry returned ${response.status}`);\n    const payload = await response.json();\n    return {\n      source: 'smithery',\n      connectors: extractServers(payload).map((server) => connectorFromSmitheryServer(server, apiKey)).filter((item): item is ConnectorDefinition => Boolean(item)),\n    };\n  },\n};\n"],"mappings":";AAGA,MAAM,mBAAmB;AAEzB,SAAS,iBAAqC;AAC5C,QAAO,QAAQ,IAAI,uBAAuB,MAAM,IAAI,QAAQ,IAAI,kBAAkB,MAAM,IAAI,KAAA;;AAG9F,SAAS,kBAA0B;AACjC,QAAO,QAAQ,IAAI,4BAA4B,MAAM,CAAC,QAAQ,QAAQ,GAAG,IAAI;;AAG/E,SAAS,WAAW,OAAoC;AACtD,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG,KAAA;;AAGpE,SAAS,SAAS,OAAuB;AACvC,QAAO,MACJ,MAAM,CACN,aAAa,CACb,QAAQ,MAAM,GAAG,CACjB,QAAQ,iBAAiB,IAAI,CAC7B,QAAQ,YAAY,GAAG,CACvB,MAAM,GAAG,GAAG,IAAI;;AAGrB,SAAS,4BAA4B,QAAiC,QAAkD;CACtH,MAAM,gBAAgB,WAAW,OAAO,iBAAiB,OAAO,kBAAkB,OAAO,QAAQ,OAAO,GAAG;CAC3G,MAAM,cAAc,WAAW,OAAO,eAAe,OAAO,gBAAgB,OAAO,KAAK,IAAI;AAC5F,KAAI,CAAC,iBAAiB,CAAC,YAAa,QAAO,KAAA;CAC3C,MAAM,WAAW,SAAS,cAAc;CAExC,MAAM,MAAM,8BADQ,cAAc,MAAM,IAAI,CAAC,KAAK,SAAS,mBAAmB,KAAK,CAAC,CAAC,KAAK,IACrC,CAAC;AACtD,QAAO;EACL,IAAI,YAAY;EAChB,SAAS,WAAW,OAAO,QAAQ,IAAI;EACvC;EACA,aAAa,WAAW,OAAO,YAAY,IAAI;EAC/C,UAAU;EACV,MAAM;EACN,QAAQ;EACR,cAAc;GAAC;GAAS;GAAa;GAAW;GAAe;GAA6B;EAC5F,MAAM;GAAC;GAAY;GAAY;GAAM;EACrC,MAAM,EAAE,MAAM,UAAU;EACxB,OAAO,SACH,EAAE,GACF,EACE,SAAS,CACP;GACE,KAAK;GACL,OAAO;GACP,aAAa;GACb,UAAU;GACX,CACF,EACF;EACL,SAAS;GACP,MAAM;GACN;GACA,gBAAgB;IACd;IACA,WAAW;IACX,SAAS,EACP,eAAe,SAAS,UAAU,WAAW,6CAC9C;IACF;GACF;EACF;;AAGH,SAAS,eAAe,SAA6C;AACnE,KAAI,MAAM,QAAQ,QAAQ,CAAE,QAAO,QAAQ,QAAQ,SAA0C,QAAQ,QAAQ,OAAO,SAAS,YAAY,CAAC,MAAM,QAAQ,KAAK,CAAC,CAAC;AAC/J,KAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,QAAQ,CAAE,QAAO,EAAE;CAChF,MAAM,OAAO;AACb,MAAK,MAAM,OAAO;EAAC;EAAW;EAAS;EAAW;EAAO,EAAE;EACzD,MAAM,QAAQ,KAAK;AACnB,MAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,QAAQ,SAA0C,QAAQ,QAAQ,OAAO,SAAS,YAAY,CAAC,MAAM,QAAQ,KAAK,CAAC,CAAC;;AAGrI,QAAO,EAAE;;AAGX,MAAa,0BAAoD;CAC/D,QAAQ;CACR,aAAa;CACb,MAAM,OAAO,QAA+E;EAC1F,MAAM,SAAS,gBAAgB;EAC/B,MAAM,MAAM,IAAI,IAAI,YAAY,iBAAiB,CAAC;EAClD,MAAM,QAAQ,OAAO,OAAO,MAAM;AAClC,MAAI,MAAO,KAAI,aAAa,IAAI,KAAK,MAAM;AAC3C,MAAI,aAAa,IAAI,YAAY,OAAO,KAAK,IAAI,KAAK,IAAI,OAAO,YAAY,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;AAC3F,MAAI,OAAO,QAAQ,OAAO,OAAO,EAAG,KAAI,aAAa,IAAI,QAAQ,OAAO,OAAO,KAAK,CAAC;EACrF,MAAM,WAAW,MAAM,MAAM,KAAK,EAChC,SAAS;GACP,QAAQ;GACR,GAAI,SAAS,EAAE,eAAe,UAAU,UAAU,GAAG,EAAE;GACxD,EACF,CAAC;AACF,MAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,8BAA8B,SAAS,SAAS;AAElF,SAAO;GACL,QAAQ;GACR,YAAY,eAAe,MAHP,SAAS,MAAM,CAGA,CAAC,KAAK,WAAW,4BAA4B,QAAQ,OAAO,CAAC,CAAC,QAAQ,SAAsC,QAAQ,KAAK,CAAC;GAC9J;;CAEJ"}

package/dist/src/connectors/registries/types.d.ts

@@ -0,0 +1,20 @@
+import type { ConnectorDefinition } from '../types.js';
+export type ConnectorRegistrySource = string;
+export type ConnectorRegistrySearchParams = {
+    query?: string;
+    page?: number;
+    pageSize?: number;
+    source?: ConnectorRegistrySource | 'all';
+    browse?: boolean;
+};
+export type ConnectorRegistrySearchResult = {
+    source: ConnectorRegistrySource;
+    connectors: ConnectorDefinition[];
+    totalPages?: number;
+    error?: string;
+};
+export type ConnectorRegistryAdapter = {
+    source: ConnectorRegistrySource;
+    displayName: string;
+    search(params: ConnectorRegistrySearchParams): Promise<ConnectorRegistrySearchResult>;
+};

package/dist/src/connectors/registries/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/connectors/secret-store.js

@@ -1,4 +1,5 @@
 import { CredentialResolver, init_credentials } from "../auth/credentials.js";
+import { consumeConnectorSetupSecretRef } from "./setup-secrets.js";
 //#region src/connectors/secret-store.ts
 init_credentials();
 function normalizeSecretSegment(value) {
@@ -21,8 +22,9 @@ function isConnectorSecretReference(value) {
 async function saveConnectorSecrets(definition, input, resolver = new CredentialResolver()) {
 	for (const secret of definition.setup.secrets ?? []) {
 		const rawValue = input.secrets?.[secret.key];
-		if (typeof rawValue !== "string" || rawValue.trim().length === 0) continue;
-		await resolver.saveApiKey(connectorSecretProviderId(definition.id, secret.key), rawValue.trim(), { profileName: "default" });
+		const resolvedValue = typeof rawValue === "string" && rawValue.trim().startsWith("secret://") ? consumeConnectorSetupSecretRef(rawValue) : rawValue;
+		if (typeof resolvedValue !== "string" || resolvedValue.trim().length === 0) continue;
+		await resolver.saveApiKey(connectorSecretProviderId(definition.id, secret.key), resolvedValue.trim(), { profileName: "default" });
 	}
 }
 async function resolveSecretReference(reference, resolver) {

package/dist/src/connectors/secret-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"secret-store.js","names":[],"sources":["../../../src/connectors/secret-store.ts"],"sourcesContent":["import { CredentialResolver } from '../auth/credentials.js';\nimport type { ConnectorDefinition, ConnectorInstallInput, ConnectorSecretReference } from './types.js';\n\nfunction normalizeSecretSegment(value: string): string {\n  return value.trim().toLowerCase().replace(/[^a-z0-9_-]+/g, '-').replace(/^-+|-+$/g, '');\n}\n\nexport function connectorSecretProviderId(connectorId: string, fieldKey: string): string {\n  const normalizedConnectorId = normalizeSecretSegment(connectorId);\n  const normalizedFieldKey = normalizeSecretSegment(fieldKey);\n  return `connector-${normalizedConnectorId}-${normalizedFieldKey}`;\n}\n\nexport function createConnectorSecretReference(connectorId: string, fieldKey: string): ConnectorSecretReference {\n  return {\n    xopcSecretRef: {\n      provider: connectorSecretProviderId(connectorId, fieldKey),\n      fieldKey,\n    },\n  };\n}\n\nexport function isConnectorSecretReference(value: unknown): value is ConnectorSecretReference {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return false;\n  }\n  const ref = (value as Record<string, unknown>).xopcSecretRef;\n  return Boolean(\n    ref &&\n      typeof ref === 'object' &&\n      !Array.isArray(ref) &&\n      typeof (ref as Record<string, unknown>).provider === 'string' &&\n      typeof (ref as Record<string, unknown>).fieldKey === 'string',\n  );\n}\n\nexport async function saveConnectorSecrets(\n  definition: ConnectorDefinition,\n  input: ConnectorInstallInput,\n  resolver = new CredentialResolver(),\n): Promise<void> {\n  for (const secret of definition.setup.secrets ?? []) {\n    const rawValue = input.secrets?.[secret.key];\n    if (typeof rawValue !== 'string' || rawValue.trim().length === 0) {\n      continue;\n    }\n    await resolver.saveApiKey(connectorSecretProviderId(definition.id, secret.key), rawValue.trim(), {\n      profileName: 'default',\n    });\n  }\n}\n\nasync function resolveSecretReference(\n  reference: ConnectorSecretReference,\n  resolver: CredentialResolver,\n): Promise<string | undefined> {\n  const value = await resolver.resolveApiKey(reference.xopcSecretRef.provider);\n  return value ?? undefined;\n}\n\nexport async function resolveConnectorSecretReferences(\n  value: unknown,\n  resolver = new CredentialResolver(),\n): Promise<unknown> {\n  if (isConnectorSecretReference(value)) {\n    return resolveSecretReference(value, resolver);\n  }\n  if (Array.isArray(value)) {\n    const items = await Promise.all(value.map((item) => resolveConnectorSecretReferences(item, resolver)));\n    return items.filter((item) => item !== undefined);\n  }\n  if (value && typeof value === 'object') {\n    const output: Record<string, unknown> = {};\n    for (const [key, child] of Object.entries(value as Record<string, unknown>)) {\n      const resolved = await resolveConnectorSecretReferences(child, resolver);\n      if (resolved !== undefined) {\n        output[key] = resolved;\n      }\n    }\n    return output;\n  }\n  return value;\n}\n"],"mappings":";;kBAA4D;AAG5D,SAAS,uBAAuB,OAAuB;AACrD,QAAO,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,iBAAiB,IAAI,CAAC,QAAQ,YAAY,GAAG;;AAGzF,SAAgB,0BAA0B,aAAqB,UAA0B;AAGvF,QAAO,aAFuB,uBAAuB,YAEZ,CAAC,GADf,uBAAuB,SACa;;AAGjE,SAAgB,+BAA+B,aAAqB,UAA4C;AAC9G,QAAO,EACL,eAAe;EACb,UAAU,0BAA0B,aAAa,SAAS;EAC1D;EACD,EACF;;AAGH,SAAgB,2BAA2B,OAAmD;AAC5F,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,QAAO;CAET,MAAM,MAAO,MAAkC;AAC/C,QAAO,QACL,OACE,OAAO,QAAQ,YACf,CAAC,MAAM,QAAQ,IAAI,IACnB,OAAQ,IAAgC,aAAa,YACrD,OAAQ,IAAgC,aAAa,SACxD;;AAGH,eAAsB,qBACpB,YACA,OACA,WAAW,IAAI,oBAAoB,EACpB;AACf,MAAK,MAAM,UAAU,WAAW,MAAM,WAAW,EAAE,EAAE;EACnD,MAAM,WAAW,MAAM,UAAU,OAAO;AACxC,MAAI,OAAO,aAAa,YAAY,SAAS,MAAM,CAAC,WAAW,EAC7D;AAEF,QAAM,SAAS,WAAW,0BAA0B,WAAW,IAAI,OAAO,IAAI,EAAE,SAAS,MAAM,EAAE,EAC/F,aAAa,WACd,CAAC;;;AAIN,eAAe,uBACb,WACA,UAC6B;AAE7B,QAAO,MADa,SAAS,cAAc,UAAU,cAAc,SAAS,IAC5D,KAAA;;AAGlB,eAAsB,iCACpB,OACA,WAAW,IAAI,oBAAoB,EACjB;AAClB,KAAI,2BAA2B,MAAM,CACnC,QAAO,uBAAuB,OAAO,SAAS;AAEhD,KAAI,MAAM,QAAQ,MAAM,CAEtB,SAAO,MADa,QAAQ,IAAI,MAAM,KAAK,SAAS,iCAAiC,MAAM,SAAS,CAAC,CAAC,EACzF,QAAQ,SAAS,SAAS,KAAA,EAAU;AAEnD,KAAI,SAAS,OAAO,UAAU,UAAU;EACtC,MAAM,SAAkC,EAAE;AAC1C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAiC,EAAE;GAC3E,MAAM,WAAW,MAAM,iCAAiC,OAAO,SAAS;AACxE,OAAI,aAAa,KAAA,EACf,QAAO,OAAO;;AAGlB,SAAO;;AAET,QAAO"}
+{"version":3,"file":"secret-store.js","names":[],"sources":["../../../src/connectors/secret-store.ts"],"sourcesContent":["import { CredentialResolver } from '../auth/credentials.js';\nimport { consumeConnectorSetupSecretRef } from './setup-secrets.js';\nimport type { ConnectorDefinition, ConnectorInstallInput, ConnectorSecretReference } from './types.js';\n\nfunction normalizeSecretSegment(value: string): string {\n  return value.trim().toLowerCase().replace(/[^a-z0-9_-]+/g, '-').replace(/^-+|-+$/g, '');\n}\n\nexport function connectorSecretProviderId(connectorId: string, fieldKey: string): string {\n  const normalizedConnectorId = normalizeSecretSegment(connectorId);\n  const normalizedFieldKey = normalizeSecretSegment(fieldKey);\n  return `connector-${normalizedConnectorId}-${normalizedFieldKey}`;\n}\n\nexport function createConnectorSecretReference(connectorId: string, fieldKey: string): ConnectorSecretReference {\n  return {\n    xopcSecretRef: {\n      provider: connectorSecretProviderId(connectorId, fieldKey),\n      fieldKey,\n    },\n  };\n}\n\nexport function isConnectorSecretReference(value: unknown): value is ConnectorSecretReference {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return false;\n  }\n  const ref = (value as Record<string, unknown>).xopcSecretRef;\n  return Boolean(\n    ref &&\n      typeof ref === 'object' &&\n      !Array.isArray(ref) &&\n      typeof (ref as Record<string, unknown>).provider === 'string' &&\n      typeof (ref as Record<string, unknown>).fieldKey === 'string',\n  );\n}\n\nexport async function saveConnectorSecrets(\n  definition: ConnectorDefinition,\n  input: ConnectorInstallInput,\n  resolver = new CredentialResolver(),\n): Promise<void> {\n  for (const secret of definition.setup.secrets ?? []) {\n    const rawValue = input.secrets?.[secret.key];\n    const resolvedValue = typeof rawValue === 'string' && rawValue.trim().startsWith('secret://')\n      ? consumeConnectorSetupSecretRef(rawValue)\n      : rawValue;\n    if (typeof resolvedValue !== 'string' || resolvedValue.trim().length === 0) {\n      continue;\n    }\n    await resolver.saveApiKey(connectorSecretProviderId(definition.id, secret.key), resolvedValue.trim(), {\n      profileName: 'default',\n    });\n  }\n}\n\nasync function resolveSecretReference(\n  reference: ConnectorSecretReference,\n  resolver: CredentialResolver,\n): Promise<string | undefined> {\n  const value = await resolver.resolveApiKey(reference.xopcSecretRef.provider);\n  return value ?? undefined;\n}\n\nexport async function resolveConnectorSecretReferences(\n  value: unknown,\n  resolver = new CredentialResolver(),\n): Promise<unknown> {\n  if (isConnectorSecretReference(value)) {\n    return resolveSecretReference(value, resolver);\n  }\n  if (Array.isArray(value)) {\n    const items = await Promise.all(value.map((item) => resolveConnectorSecretReferences(item, resolver)));\n    return items.filter((item) => item !== undefined);\n  }\n  if (value && typeof value === 'object') {\n    const output: Record<string, unknown> = {};\n    for (const [key, child] of Object.entries(value as Record<string, unknown>)) {\n      const resolved = await resolveConnectorSecretReferences(child, resolver);\n      if (resolved !== undefined) {\n        output[key] = resolved;\n      }\n    }\n    return output;\n  }\n  return value;\n}\n"],"mappings":";;;kBAA4D;AAI5D,SAAS,uBAAuB,OAAuB;AACrD,QAAO,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,iBAAiB,IAAI,CAAC,QAAQ,YAAY,GAAG;;AAGzF,SAAgB,0BAA0B,aAAqB,UAA0B;AAGvF,QAAO,aAFuB,uBAAuB,YAEZ,CAAC,GADf,uBAAuB,SACa;;AAGjE,SAAgB,+BAA+B,aAAqB,UAA4C;AAC9G,QAAO,EACL,eAAe;EACb,UAAU,0BAA0B,aAAa,SAAS;EAC1D;EACD,EACF;;AAGH,SAAgB,2BAA2B,OAAmD;AAC5F,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,QAAO;CAET,MAAM,MAAO,MAAkC;AAC/C,QAAO,QACL,OACE,OAAO,QAAQ,YACf,CAAC,MAAM,QAAQ,IAAI,IACnB,OAAQ,IAAgC,aAAa,YACrD,OAAQ,IAAgC,aAAa,SACxD;;AAGH,eAAsB,qBACpB,YACA,OACA,WAAW,IAAI,oBAAoB,EACpB;AACf,MAAK,MAAM,UAAU,WAAW,MAAM,WAAW,EAAE,EAAE;EACnD,MAAM,WAAW,MAAM,UAAU,OAAO;EACxC,MAAM,gBAAgB,OAAO,aAAa,YAAY,SAAS,MAAM,CAAC,WAAW,YAAY,GACzF,+BAA+B,SAAS,GACxC;AACJ,MAAI,OAAO,kBAAkB,YAAY,cAAc,MAAM,CAAC,WAAW,EACvE;AAEF,QAAM,SAAS,WAAW,0BAA0B,WAAW,IAAI,OAAO,IAAI,EAAE,cAAc,MAAM,EAAE,EACpG,aAAa,WACd,CAAC;;;AAIN,eAAe,uBACb,WACA,UAC6B;AAE7B,QAAO,MADa,SAAS,cAAc,UAAU,cAAc,SAAS,IAC5D,KAAA;;AAGlB,eAAsB,iCACpB,OACA,WAAW,IAAI,oBAAoB,EACjB;AAClB,KAAI,2BAA2B,MAAM,CACnC,QAAO,uBAAuB,OAAO,SAAS;AAEhD,KAAI,MAAM,QAAQ,MAAM,CAEtB,SAAO,MADa,QAAQ,IAAI,MAAM,KAAK,SAAS,iCAAiC,MAAM,SAAS,CAAC,CAAC,EACzF,QAAQ,SAAS,SAAS,KAAA,EAAU;AAEnD,KAAI,SAAS,OAAO,UAAU,UAAU;EACtC,MAAM,SAAkC,EAAE;AAC1C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAiC,EAAE;GAC3E,MAAM,WAAW,MAAM,iCAAiC,OAAO,SAAS;AACxE,OAAI,aAAa,KAAA,EACf,QAAO,OAAO;;AAGlB,SAAO;;AAET,QAAO"}

package/dist/src/connectors/setup-secrets.d.ts

@@ -0,0 +1,15 @@
+export type ConnectorSetupSecretRequest = {
+    ref: string;
+    key: string;
+    label?: string;
+    createdAt: number;
+    expiresAt: number;
+};
+export declare function createConnectorSetupSecretRequest(params: {
+    key: string;
+    label?: string;
+}): ConnectorSetupSecretRequest;
+export declare function submitConnectorSetupSecret(ref: string, value: string): boolean;
+export declare function resolveConnectorSetupSecretRef(ref: string): string | undefined;
+export declare function consumeConnectorSetupSecretRef(ref: string): string | undefined;
+export declare function sweepExpiredConnectorSetupSecrets(): number;

package/dist/src/connectors/setup-secrets.js

@@ -0,0 +1,64 @@
+import crypto from "node:crypto";
+//#region src/connectors/setup-secrets.ts
+const REQUEST_TIMEOUT_MS = 300 * 1e3;
+const IDLE_TTL_MS = 900 * 1e3;
+const pendingSecrets = /* @__PURE__ */ new Map();
+function nowMs() {
+	return Date.now();
+}
+function createSecretRef() {
+	return `secret://${crypto.randomBytes(6).toString("hex")}`;
+}
+function createConnectorSetupSecretRequest(params) {
+	sweepExpiredConnectorSetupSecrets();
+	const createdAt = nowMs();
+	const request = {
+		ref: createSecretRef(),
+		key: params.key,
+		label: params.label,
+		createdAt,
+		expiresAt: createdAt + REQUEST_TIMEOUT_MS,
+		lastTouchedAt: createdAt
+	};
+	pendingSecrets.set(request.ref, request);
+	return {
+		ref: request.ref,
+		key: request.key,
+		label: request.label,
+		createdAt: request.createdAt,
+		expiresAt: request.expiresAt
+	};
+}
+function submitConnectorSetupSecret(ref, value) {
+	sweepExpiredConnectorSetupSecrets();
+	const entry = pendingSecrets.get(ref.trim());
+	if (!entry || entry.expiresAt < nowMs() || typeof value !== "string" || value.length === 0) return false;
+	entry.value = value;
+	entry.lastTouchedAt = nowMs();
+	return true;
+}
+function resolveConnectorSetupSecretRef(ref) {
+	sweepExpiredConnectorSetupSecrets();
+	const entry = pendingSecrets.get(ref.trim());
+	if (!entry?.value) return void 0;
+	entry.lastTouchedAt = nowMs();
+	return entry.value;
+}
+function consumeConnectorSetupSecretRef(ref) {
+	const value = resolveConnectorSetupSecretRef(ref);
+	if (value !== void 0) pendingSecrets.delete(ref.trim());
+	return value;
+}
+function sweepExpiredConnectorSetupSecrets() {
+	const now = nowMs();
+	let removed = 0;
+	for (const [ref, entry] of pendingSecrets) if (entry.expiresAt < now || entry.lastTouchedAt + IDLE_TTL_MS < now) {
+		pendingSecrets.delete(ref);
+		removed += 1;
+	}
+	return removed;
+}
+//#endregion
+export { consumeConnectorSetupSecretRef, createConnectorSetupSecretRequest, resolveConnectorSetupSecretRef, submitConnectorSetupSecret, sweepExpiredConnectorSetupSecrets };
+
+//# sourceMappingURL=setup-secrets.js.map

package/dist/src/connectors/setup-secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-secrets.js","names":[],"sources":["../../../src/connectors/setup-secrets.ts"],"sourcesContent":["import crypto from 'node:crypto';\n\nconst REQUEST_TIMEOUT_MS = 5 * 60 * 1000;\nconst IDLE_TTL_MS = 15 * 60 * 1000;\n\nexport type ConnectorSetupSecretRequest = {\n  ref: string;\n  key: string;\n  label?: string;\n  createdAt: number;\n  expiresAt: number;\n};\n\ntype PendingSecret = ConnectorSetupSecretRequest & {\n  value?: string;\n  lastTouchedAt: number;\n};\n\nconst pendingSecrets = new Map<string, PendingSecret>();\n\nfunction nowMs(): number {\n  return Date.now();\n}\n\nfunction createSecretRef(): string {\n  return `secret://${crypto.randomBytes(6).toString('hex')}`;\n}\n\nexport function createConnectorSetupSecretRequest(params: { key: string; label?: string }): ConnectorSetupSecretRequest {\n  sweepExpiredConnectorSetupSecrets();\n  const createdAt = nowMs();\n  const request: PendingSecret = {\n    ref: createSecretRef(),\n    key: params.key,\n    label: params.label,\n    createdAt,\n    expiresAt: createdAt + REQUEST_TIMEOUT_MS,\n    lastTouchedAt: createdAt,\n  };\n  pendingSecrets.set(request.ref, request);\n  return { ref: request.ref, key: request.key, label: request.label, createdAt: request.createdAt, expiresAt: request.expiresAt };\n}\n\nexport function submitConnectorSetupSecret(ref: string, value: string): boolean {\n  sweepExpiredConnectorSetupSecrets();\n  const entry = pendingSecrets.get(ref.trim());\n  if (!entry || entry.expiresAt < nowMs() || typeof value !== 'string' || value.length === 0) {\n    return false;\n  }\n  entry.value = value;\n  entry.lastTouchedAt = nowMs();\n  return true;\n}\n\nexport function resolveConnectorSetupSecretRef(ref: string): string | undefined {\n  sweepExpiredConnectorSetupSecrets();\n  const entry = pendingSecrets.get(ref.trim());\n  if (!entry?.value) return undefined;\n  entry.lastTouchedAt = nowMs();\n  return entry.value;\n}\n\nexport function consumeConnectorSetupSecretRef(ref: string): string | undefined {\n  const value = resolveConnectorSetupSecretRef(ref);\n  if (value !== undefined) {\n    pendingSecrets.delete(ref.trim());\n  }\n  return value;\n}\n\nexport function sweepExpiredConnectorSetupSecrets(): number {\n  const now = nowMs();\n  let removed = 0;\n  for (const [ref, entry] of pendingSecrets) {\n    if (entry.expiresAt < now || entry.lastTouchedAt + IDLE_TTL_MS < now) {\n      pendingSecrets.delete(ref);\n      removed += 1;\n    }\n  }\n  return removed;\n}\n"],"mappings":";;AAEA,MAAM,qBAAqB,MAAS;AACpC,MAAM,cAAc,MAAU;AAe9B,MAAM,iCAAiB,IAAI,KAA4B;AAEvD,SAAS,QAAgB;AACvB,QAAO,KAAK,KAAK;;AAGnB,SAAS,kBAA0B;AACjC,QAAO,YAAY,OAAO,YAAY,EAAE,CAAC,SAAS,MAAM;;AAG1D,SAAgB,kCAAkC,QAAsE;AACtH,oCAAmC;CACnC,MAAM,YAAY,OAAO;CACzB,MAAM,UAAyB;EAC7B,KAAK,iBAAiB;EACtB,KAAK,OAAO;EACZ,OAAO,OAAO;EACd;EACA,WAAW,YAAY;EACvB,eAAe;EAChB;AACD,gBAAe,IAAI,QAAQ,KAAK,QAAQ;AACxC,QAAO;EAAE,KAAK,QAAQ;EAAK,KAAK,QAAQ;EAAK,OAAO,QAAQ;EAAO,WAAW,QAAQ;EAAW,WAAW,QAAQ;EAAW;;AAGjI,SAAgB,2BAA2B,KAAa,OAAwB;AAC9E,oCAAmC;CACnC,MAAM,QAAQ,eAAe,IAAI,IAAI,MAAM,CAAC;AAC5C,KAAI,CAAC,SAAS,MAAM,YAAY,OAAO,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,EACvF,QAAO;AAET,OAAM,QAAQ;AACd,OAAM,gBAAgB,OAAO;AAC7B,QAAO;;AAGT,SAAgB,+BAA+B,KAAiC;AAC9E,oCAAmC;CACnC,MAAM,QAAQ,eAAe,IAAI,IAAI,MAAM,CAAC;AAC5C,KAAI,CAAC,OAAO,MAAO,QAAO,KAAA;AAC1B,OAAM,gBAAgB,OAAO;AAC7B,QAAO,MAAM;;AAGf,SAAgB,+BAA+B,KAAiC;CAC9E,MAAM,QAAQ,+BAA+B,IAAI;AACjD,KAAI,UAAU,KAAA,EACZ,gBAAe,OAAO,IAAI,MAAM,CAAC;AAEnC,QAAO;;AAGT,SAAgB,oCAA4C;CAC1D,MAAM,MAAM,OAAO;CACnB,IAAI,UAAU;AACd,MAAK,MAAM,CAAC,KAAK,UAAU,eACzB,KAAI,MAAM,YAAY,OAAO,MAAM,gBAAgB,cAAc,KAAK;AACpE,iBAAe,OAAO,IAAI;AAC1B,aAAW;;AAGf,QAAO"}

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

@@ -0,0 +1,15 @@
+import type { Config } from '../config/schema.js';
+export type ConnectorSupervisorOptions = {
+    getConfig: () => Config;
+    saveConfig: (config: Config) => Promise<{
+        saved: boolean;
+        error?: string;
+    }>;
+    intervalMs?: number;
+    initialDelayMs?: number;
+};
+export type ConnectorSupervisor = {
+    runNow(): Promise<void>;
+    stop(): void;
+};
+export declare function startConnectorSupervisor(options: ConnectorSupervisorOptions): ConnectorSupervisor;

package/dist/src/connectors/supervisor.js

@@ -0,0 +1,73 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { recordConnectorHealthUsage } from "./usage.js";
+import { listConnectorInstances } from "./instances.js";
+import { testConnectorInstance } from "./health.js";
+//#region src/connectors/supervisor.ts
+init_logger();
+const log = createLogger("Connectors:Supervisor");
+function resolveIntervalMs(input) {
+	const env = Number(process.env.XOPC_CONNECTOR_SUPERVISOR_INTERVAL_MS ?? "");
+	return Math.max(1e4, Math.min(input ?? (Number.isFinite(env) && env > 0 ? env : 6e4), 30 * 6e4));
+}
+function startConnectorSupervisor(options) {
+	const intervalMs = resolveIntervalMs(options.intervalMs);
+	let timer = null;
+	let running = false;
+	let stopped = false;
+	async function runNow() {
+		if (running || stopped) return;
+		running = true;
+		const config = options.getConfig();
+		let changed = false;
+		try {
+			const instances = listConnectorInstances(config).filter((instance) => instance.enabled);
+			for (const instance of instances) {
+				if (instance.materialized.type !== "mcp") continue;
+				try {
+					const result = await testConnectorInstance(config, instance.materialized.serverId);
+					recordConnectorHealthUsage(config, instance.instanceId, result);
+					changed = true;
+					if (!result.ok) log.warn({
+						instanceId: instance.instanceId,
+						status: result.status,
+						errorMessage: result.error
+					}, `Connector health check failed: ${result.status}`);
+				} catch (error) {
+					const errorMessage = error instanceof Error ? error.message : String(error);
+					log.warn({
+						instanceId: instance.instanceId,
+						errorMessage
+					}, `Connector supervisor check failed: ${errorMessage}`);
+				}
+			}
+			if (changed) {
+				const saved = await options.saveConfig(config);
+				if (!saved.saved) log.warn({ errorMessage: saved.error }, `Connector supervisor could not save health state: ${saved.error}`);
+			}
+		} finally {
+			running = false;
+		}
+	}
+	const initialDelayMs = options.initialDelayMs ?? 15e3;
+	timer = setTimeout(() => {
+		runNow();
+		timer = setInterval(() => void runNow(), intervalMs);
+	}, Math.max(0, initialDelayMs));
+	timer.unref?.();
+	return {
+		runNow,
+		stop() {
+			stopped = true;
+			if (timer) {
+				clearTimeout(timer);
+				clearInterval(timer);
+				timer = null;
+			}
+		}
+	};
+}
+//#endregion
+export { startConnectorSupervisor };
+
+//# sourceMappingURL=supervisor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.js","names":[],"sources":["../../../src/connectors/supervisor.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { createLogger } from '../utils/logger.js';\nimport { testConnectorInstance } from './health.js';\nimport { listConnectorInstances } from './instances.js';\nimport { recordConnectorHealthUsage } from './usage.js';\n\nconst log = createLogger('Connectors:Supervisor');\n\nexport type ConnectorSupervisorOptions = {\n  getConfig: () => Config;\n  saveConfig: (config: Config) => Promise<{ saved: boolean; error?: string }>;\n  intervalMs?: number;\n  initialDelayMs?: number;\n};\n\nexport type ConnectorSupervisor = {\n  runNow(): Promise<void>;\n  stop(): void;\n};\n\nfunction resolveIntervalMs(input?: number): number {\n  const env = Number(process.env.XOPC_CONNECTOR_SUPERVISOR_INTERVAL_MS ?? '');\n  const value = input ?? (Number.isFinite(env) && env > 0 ? env : 60_000);\n  return Math.max(10_000, Math.min(value, 30 * 60_000));\n}\n\nexport function startConnectorSupervisor(options: ConnectorSupervisorOptions): ConnectorSupervisor {\n  const intervalMs = resolveIntervalMs(options.intervalMs);\n  let timer: NodeJS.Timeout | null = null;\n  let running = false;\n  let stopped = false;\n\n  async function runNow(): Promise<void> {\n    if (running || stopped) return;\n    running = true;\n    const config = options.getConfig();\n    let changed = false;\n    try {\n      const instances = listConnectorInstances(config).filter((instance) => instance.enabled);\n      for (const instance of instances) {\n        if (instance.materialized.type !== 'mcp') continue;\n        try {\n          const result = await testConnectorInstance(config, instance.materialized.serverId);\n          recordConnectorHealthUsage(config, instance.instanceId, result);\n          changed = true;\n          if (!result.ok) {\n            log.warn(\n              { instanceId: instance.instanceId, status: result.status, errorMessage: result.error },\n              `Connector health check failed: ${result.status}`,\n            );\n          }\n        } catch (error) {\n          const errorMessage = error instanceof Error ? error.message : String(error);\n          log.warn({ instanceId: instance.instanceId, errorMessage }, `Connector supervisor check failed: ${errorMessage}`);\n        }\n      }\n      if (changed) {\n        const saved = await options.saveConfig(config);\n        if (!saved.saved) {\n          log.warn({ errorMessage: saved.error }, `Connector supervisor could not save health state: ${saved.error}`);\n        }\n      }\n    } finally {\n      running = false;\n    }\n  }\n\n  const initialDelayMs = options.initialDelayMs ?? 15_000;\n  timer = setTimeout(() => {\n    void runNow();\n    timer = setInterval(() => void runNow(), intervalMs);\n  }, Math.max(0, initialDelayMs));\n  timer.unref?.();\n\n  return {\n    runNow,\n    stop() {\n      stopped = true;\n      if (timer) {\n        clearTimeout(timer);\n        clearInterval(timer);\n        timer = null;\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;aACkD;AAKlD,MAAM,MAAM,aAAa,wBAAwB;AAcjD,SAAS,kBAAkB,OAAwB;CACjD,MAAM,MAAM,OAAO,QAAQ,IAAI,yCAAyC,GAAG;AAE3E,QAAO,KAAK,IAAI,KAAQ,KAAK,IADf,UAAU,OAAO,SAAS,IAAI,IAAI,MAAM,IAAI,MAAM,MACxB,KAAK,IAAO,CAAC;;AAGvD,SAAgB,yBAAyB,SAA0D;CACjG,MAAM,aAAa,kBAAkB,QAAQ,WAAW;CACxD,IAAI,QAA+B;CACnC,IAAI,UAAU;CACd,IAAI,UAAU;CAEd,eAAe,SAAwB;AACrC,MAAI,WAAW,QAAS;AACxB,YAAU;EACV,MAAM,SAAS,QAAQ,WAAW;EAClC,IAAI,UAAU;AACd,MAAI;GACF,MAAM,YAAY,uBAAuB,OAAO,CAAC,QAAQ,aAAa,SAAS,QAAQ;AACvF,QAAK,MAAM,YAAY,WAAW;AAChC,QAAI,SAAS,aAAa,SAAS,MAAO;AAC1C,QAAI;KACF,MAAM,SAAS,MAAM,sBAAsB,QAAQ,SAAS,aAAa,SAAS;AAClF,gCAA2B,QAAQ,SAAS,YAAY,OAAO;AAC/D,eAAU;AACV,SAAI,CAAC,OAAO,GACV,KAAI,KACF;MAAE,YAAY,SAAS;MAAY,QAAQ,OAAO;MAAQ,cAAc,OAAO;MAAO,EACtF,kCAAkC,OAAO,SAC1C;aAEI,OAAO;KACd,MAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AAC3E,SAAI,KAAK;MAAE,YAAY,SAAS;MAAY;MAAc,EAAE,sCAAsC,eAAe;;;AAGrH,OAAI,SAAS;IACX,MAAM,QAAQ,MAAM,QAAQ,WAAW,OAAO;AAC9C,QAAI,CAAC,MAAM,MACT,KAAI,KAAK,EAAE,cAAc,MAAM,OAAO,EAAE,qDAAqD,MAAM,QAAQ;;YAGvG;AACR,aAAU;;;CAId,MAAM,iBAAiB,QAAQ,kBAAkB;AACjD,SAAQ,iBAAiB;AAClB,UAAQ;AACb,UAAQ,kBAAkB,KAAK,QAAQ,EAAE,WAAW;IACnD,KAAK,IAAI,GAAG,eAAe,CAAC;AAC/B,OAAM,SAAS;AAEf,QAAO;EACL;EACA,OAAO;AACL,aAAU;AACV,OAAI,OAAO;AACT,iBAAa,MAAM;AACnB,kBAAc,MAAM;AACpB,YAAQ;;;EAGb"}

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

@@ -1,4 +1,4 @@
-export type ConnectorKind = 'mcp' | 'cli' | 'http' | 'channel' | 'browser' | 'extension' | 'builtin';
+export type ConnectorKind = 'mcp' | 'cli' | 'http' | 'channel' | 'browser' | 'extension' | 'builtin' | 'composio' | 'nativeTool' | 'memorySource';
 export type ConnectorCategory = 'code' | 'docs' | 'browser' | 'data' | 'automation' | 'custom';
 export type ConnectorCapability = 'tools' | 'resources' | 'prompts' | 'context' | 'channel' | 'events' | 'ui' | 'memory_source' | 'workflows' | 'auth.apiKey' | 'auth.oauth' | 'runtime.mcp.stdio' | 'runtime.mcp.sse' | 'runtime.mcp.streamableHttp';
 export type ConnectorAuthMode = 'none' | 'apiKey' | 'oauth';
@@ -27,6 +27,19 @@ export type ConnectorRuntimeDefinition = {
     type: 'mcp';
     serverId: string;
     serverTemplate: Record<string, unknown>;
+} | {
+    type: 'channel';
+    channelId: string;
+    pluginId: string;
+} | {
+    type: 'composio';
+    toolkit: string;
+} | {
+    type: 'nativeTool';
+    toolsetId: string;
+} | {
+    type: 'memorySource';
+    sourceKind: string;
 };
 export type ConnectorDefinition = {
     id: string;
@@ -72,16 +85,23 @@ export type ConnectorInstance = {
     connectorId: string;
     displayName: string;
     enabled: boolean;
-    status: 'installed' | 'not_configured' | 'failed' | 'disabled';
+    status: 'installed' | 'not_configured' | 'failed' | 'disabled' | 'connecting' | 'connected' | 'unauthorized' | 'degraded';
+    connectionStatus?: 'unknown' | 'disconnected' | 'connecting' | 'connected' | 'unauthorized' | 'error' | 'disabled';
+    authStatus?: 'unknown' | 'none' | 'connected' | 'missing' | 'expired' | 'unauthorized';
+    lastConnectedAt?: string;
+    lastError?: string;
     secretStatus: Record<string, boolean>;
     materialized: {
         type: 'mcp';
         serverId: string;
+    } | {
+        type: 'channel' | 'composio' | 'nativeTool' | 'memorySource';
+        id: string;
     };
     usage: ConnectorUsageRecord;
     audit: ConnectorAuditRecord[];
 };
-export type ConnectorHealthStatus = 'ok' | 'server_not_found' | 'missing_secret' | 'startup_failed' | 'tools_list_failed' | 'timeout' | 'network_failed' | 'unknown_error';
+export type ConnectorHealthStatus = 'ok' | 'server_not_found' | 'missing_secret' | 'startup_failed' | 'tools_list_failed' | 'timeout' | 'network_failed' | 'unauthorized' | 'disabled' | 'unknown_error';
 export type ConnectorHealthResult = {
     serverId: string;
     ok: boolean;
@@ -118,4 +138,8 @@ export type ManagedConnectorMarker = {
     managed: true;
     connectorId: string;
     version: string;
+    enabled?: boolean;
+    lastConnectedAt?: string;
+    lastError?: string;
+    displayName?: string;
 };

package/dist/src/connectors/usage.js

@@ -49,13 +49,18 @@ function appendConnectorAuditRecord(config, instanceId, record) {
 function recordConnectorHealthUsage(config, instanceId, result) {
 	const marker = getManagedConnectorMarker(config, instanceId);
 	if (!marker) return;
+	const checkedAt = (/* @__PURE__ */ new Date()).toISOString();
 	marker.usage = {
-		lastHealthCheckAt: (/* @__PURE__ */ new Date()).toISOString(),
+		lastHealthCheckAt: checkedAt,
 		lastHealthStatus: result.status,
 		lastToolCount: result.toolCount,
 		lastResourceCount: result.resourceCount,
 		lastPromptCount: result.promptCount
 	};
+	if (result.ok) {
+		marker.lastConnectedAt = checkedAt;
+		delete marker.lastError;
+	} else if (result.error) marker.lastError = result.error;
 	appendConnectorAuditRecord(config, instanceId, {
 		action: "health_check",
 		status: result.status,

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

@@ -1 +1 @@
-{"version":3,"file":"usage.js","names":[],"sources":["../../../src/connectors/usage.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { isManagedConnectorServer } from './materialize.js';\nimport type { ConnectorAuditRecord, ConnectorHealthResult, ConnectorUsageRecord } from './types.js';\n\nconst MAX_AUDIT_RECORDS = 50;\n\nfunction getManagedConnectorMarker(config: Config, instanceId: string): Record<string, unknown> | undefined {\n  const server = config.mcp?.servers?.[instanceId];\n  if (!isManagedConnectorServer(server)) {\n    return undefined;\n  }\n  return server.xopcConnector as Record<string, unknown>;\n}\n\nexport function getConnectorUsageFromMarker(marker: unknown): ConnectorUsageRecord {\n  if (!marker || typeof marker !== 'object' || Array.isArray(marker)) {\n    return {};\n  }\n  const usage = (marker as Record<string, unknown>).usage;\n  if (!usage || typeof usage !== 'object' || Array.isArray(usage)) {\n    return {};\n  }\n  const record = usage as Record<string, unknown>;\n  return {\n    lastHealthCheckAt: typeof record.lastHealthCheckAt === 'string' ? record.lastHealthCheckAt : undefined,\n    lastHealthStatus: typeof record.lastHealthStatus === 'string' ? record.lastHealthStatus as ConnectorUsageRecord['lastHealthStatus'] : undefined,\n    lastToolCount: typeof record.lastToolCount === 'number' ? record.lastToolCount : undefined,\n    lastResourceCount: typeof record.lastResourceCount === 'number' ? record.lastResourceCount : undefined,\n    lastPromptCount: typeof record.lastPromptCount === 'number' ? record.lastPromptCount : undefined,\n  };\n}\n\nexport function getConnectorAuditFromMarker(marker: unknown): ConnectorAuditRecord[] {\n  if (!marker || typeof marker !== 'object' || Array.isArray(marker)) {\n    return [];\n  }\n  const audit = (marker as Record<string, unknown>).audit;\n  if (!Array.isArray(audit)) {\n    return [];\n  }\n  return audit.flatMap((entry) => {\n    if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {\n      return [];\n    }\n    const record = entry as Record<string, unknown>;\n    if (typeof record.at !== 'string' || typeof record.action !== 'string') {\n      return [];\n    }\n    return [{\n      at: record.at,\n      action: record.action as ConnectorAuditRecord['action'],\n      status: typeof record.status === 'string' ? record.status as ConnectorAuditRecord['status'] : undefined,\n      ok: typeof record.ok === 'boolean' ? record.ok : undefined,\n      toolCount: typeof record.toolCount === 'number' ? record.toolCount : undefined,\n      resourceCount: typeof record.resourceCount === 'number' ? record.resourceCount : undefined,\n      promptCount: typeof record.promptCount === 'number' ? record.promptCount : undefined,\n    }];\n  });\n}\n\nexport function appendConnectorAuditRecord(\n  config: Config,\n  instanceId: string,\n  record: Omit<ConnectorAuditRecord, 'at'>,\n): void {\n  const marker = getManagedConnectorMarker(config, instanceId);\n  if (!marker) {\n    return;\n  }\n  const existing = Array.isArray(marker.audit) ? marker.audit : [];\n  marker.audit = [\n    ...existing.slice(-MAX_AUDIT_RECORDS + 1),\n    { ...record, at: new Date().toISOString() },\n  ];\n}\n\nexport function recordConnectorHealthUsage(\n  config: Config,\n  instanceId: string,\n  result: ConnectorHealthResult,\n): void {\n  const marker = getManagedConnectorMarker(config, instanceId);\n  if (!marker) {\n    return;\n  }\n  marker.usage = {\n    lastHealthCheckAt: new Date().toISOString(),\n    lastHealthStatus: result.status,\n    lastToolCount: result.toolCount,\n    lastResourceCount: result.resourceCount,\n    lastPromptCount: result.promptCount,\n  } satisfies ConnectorUsageRecord;\n  appendConnectorAuditRecord(config, instanceId, {\n    action: 'health_check',\n    status: result.status,\n    ok: result.ok,\n    toolCount: result.toolCount,\n    resourceCount: result.resourceCount,\n    promptCount: result.promptCount,\n  });\n}\n"],"mappings":";;AAIA,MAAM,oBAAoB;AAE1B,SAAS,0BAA0B,QAAgB,YAAyD;CAC1G,MAAM,SAAS,OAAO,KAAK,UAAU;AACrC,KAAI,CAAC,yBAAyB,OAAO,CACnC;AAEF,QAAO,OAAO;;AAGhB,SAAgB,4BAA4B,QAAuC;AACjF,KAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,CAChE,QAAO,EAAE;CAEX,MAAM,QAAS,OAAmC;AAClD,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,QAAO,EAAE;CAEX,MAAM,SAAS;AACf,QAAO;EACL,mBAAmB,OAAO,OAAO,sBAAsB,WAAW,OAAO,oBAAoB,KAAA;EAC7F,kBAAkB,OAAO,OAAO,qBAAqB,WAAW,OAAO,mBAA+D,KAAA;EACtI,eAAe,OAAO,OAAO,kBAAkB,WAAW,OAAO,gBAAgB,KAAA;EACjF,mBAAmB,OAAO,OAAO,sBAAsB,WAAW,OAAO,oBAAoB,KAAA;EAC7F,iBAAiB,OAAO,OAAO,oBAAoB,WAAW,OAAO,kBAAkB,KAAA;EACxF;;AAGH,SAAgB,4BAA4B,QAAyC;AACnF,KAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,CAChE,QAAO,EAAE;CAEX,MAAM,QAAS,OAAmC;AAClD,KAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,QAAO,EAAE;AAEX,QAAO,MAAM,SAAS,UAAU;AAC9B,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,QAAO,EAAE;EAEX,MAAM,SAAS;AACf,MAAI,OAAO,OAAO,OAAO,YAAY,OAAO,OAAO,WAAW,SAC5D,QAAO,EAAE;AAEX,SAAO,CAAC;GACN,IAAI,OAAO;GACX,QAAQ,OAAO;GACf,QAAQ,OAAO,OAAO,WAAW,WAAW,OAAO,SAA2C,KAAA;GAC9F,IAAI,OAAO,OAAO,OAAO,YAAY,OAAO,KAAK,KAAA;GACjD,WAAW,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY,KAAA;GACrE,eAAe,OAAO,OAAO,kBAAkB,WAAW,OAAO,gBAAgB,KAAA;GACjF,aAAa,OAAO,OAAO,gBAAgB,WAAW,OAAO,cAAc,KAAA;GAC5E,CAAC;GACF;;AAGJ,SAAgB,2BACd,QACA,YACA,QACM;CACN,MAAM,SAAS,0BAA0B,QAAQ,WAAW;AAC5D,KAAI,CAAC,OACH;AAGF,QAAO,QAAQ,CACb,IAFe,MAAM,QAAQ,OAAO,MAAM,GAAG,OAAO,QAAQ,EAAE,EAElD,MAAM,CAAC,oBAAoB,EAAE,EACzC;EAAE,GAAG;EAAQ,qBAAI,IAAI,MAAM,EAAC,aAAa;EAAE,CAC5C;;AAGH,SAAgB,2BACd,QACA,YACA,QACM;CACN,MAAM,SAAS,0BAA0B,QAAQ,WAAW;AAC5D,KAAI,CAAC,OACH;AAEF,QAAO,QAAQ;EACb,oCAAmB,IAAI,MAAM,EAAC,aAAa;EAC3C,kBAAkB,OAAO;EACzB,eAAe,OAAO;EACtB,mBAAmB,OAAO;EAC1B,iBAAiB,OAAO;EACzB;AACD,4BAA2B,QAAQ,YAAY;EAC7C,QAAQ;EACR,QAAQ,OAAO;EACf,IAAI,OAAO;EACX,WAAW,OAAO;EAClB,eAAe,OAAO;EACtB,aAAa,OAAO;EACrB,CAAC"}
+{"version":3,"file":"usage.js","names":[],"sources":["../../../src/connectors/usage.ts"],"sourcesContent":["import type { Config } from '../config/schema.js';\nimport { isManagedConnectorServer } from './materialize.js';\nimport type { ConnectorAuditRecord, ConnectorHealthResult, ConnectorUsageRecord } from './types.js';\n\nconst MAX_AUDIT_RECORDS = 50;\n\nfunction getManagedConnectorMarker(config: Config, instanceId: string): Record<string, unknown> | undefined {\n  const server = config.mcp?.servers?.[instanceId];\n  if (!isManagedConnectorServer(server)) {\n    return undefined;\n  }\n  return server.xopcConnector as Record<string, unknown>;\n}\n\nexport function getConnectorUsageFromMarker(marker: unknown): ConnectorUsageRecord {\n  if (!marker || typeof marker !== 'object' || Array.isArray(marker)) {\n    return {};\n  }\n  const usage = (marker as Record<string, unknown>).usage;\n  if (!usage || typeof usage !== 'object' || Array.isArray(usage)) {\n    return {};\n  }\n  const record = usage as Record<string, unknown>;\n  return {\n    lastHealthCheckAt: typeof record.lastHealthCheckAt === 'string' ? record.lastHealthCheckAt : undefined,\n    lastHealthStatus: typeof record.lastHealthStatus === 'string' ? record.lastHealthStatus as ConnectorUsageRecord['lastHealthStatus'] : undefined,\n    lastToolCount: typeof record.lastToolCount === 'number' ? record.lastToolCount : undefined,\n    lastResourceCount: typeof record.lastResourceCount === 'number' ? record.lastResourceCount : undefined,\n    lastPromptCount: typeof record.lastPromptCount === 'number' ? record.lastPromptCount : undefined,\n  };\n}\n\nexport function getConnectorAuditFromMarker(marker: unknown): ConnectorAuditRecord[] {\n  if (!marker || typeof marker !== 'object' || Array.isArray(marker)) {\n    return [];\n  }\n  const audit = (marker as Record<string, unknown>).audit;\n  if (!Array.isArray(audit)) {\n    return [];\n  }\n  return audit.flatMap((entry) => {\n    if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {\n      return [];\n    }\n    const record = entry as Record<string, unknown>;\n    if (typeof record.at !== 'string' || typeof record.action !== 'string') {\n      return [];\n    }\n    return [{\n      at: record.at,\n      action: record.action as ConnectorAuditRecord['action'],\n      status: typeof record.status === 'string' ? record.status as ConnectorAuditRecord['status'] : undefined,\n      ok: typeof record.ok === 'boolean' ? record.ok : undefined,\n      toolCount: typeof record.toolCount === 'number' ? record.toolCount : undefined,\n      resourceCount: typeof record.resourceCount === 'number' ? record.resourceCount : undefined,\n      promptCount: typeof record.promptCount === 'number' ? record.promptCount : undefined,\n    }];\n  });\n}\n\nexport function appendConnectorAuditRecord(\n  config: Config,\n  instanceId: string,\n  record: Omit<ConnectorAuditRecord, 'at'>,\n): void {\n  const marker = getManagedConnectorMarker(config, instanceId);\n  if (!marker) {\n    return;\n  }\n  const existing = Array.isArray(marker.audit) ? marker.audit : [];\n  marker.audit = [\n    ...existing.slice(-MAX_AUDIT_RECORDS + 1),\n    { ...record, at: new Date().toISOString() },\n  ];\n}\n\nexport function recordConnectorHealthUsage(\n  config: Config,\n  instanceId: string,\n  result: ConnectorHealthResult,\n): void {\n  const marker = getManagedConnectorMarker(config, instanceId);\n  if (!marker) {\n    return;\n  }\n  const checkedAt = new Date().toISOString();\n  marker.usage = {\n    lastHealthCheckAt: checkedAt,\n    lastHealthStatus: result.status,\n    lastToolCount: result.toolCount,\n    lastResourceCount: result.resourceCount,\n    lastPromptCount: result.promptCount,\n  } satisfies ConnectorUsageRecord;\n  if (result.ok) {\n    marker.lastConnectedAt = checkedAt;\n    delete marker.lastError;\n  } else if (result.error) {\n    marker.lastError = result.error;\n  }\n  appendConnectorAuditRecord(config, instanceId, {\n    action: 'health_check',\n    status: result.status,\n    ok: result.ok,\n    toolCount: result.toolCount,\n    resourceCount: result.resourceCount,\n    promptCount: result.promptCount,\n  });\n}\n"],"mappings":";;AAIA,MAAM,oBAAoB;AAE1B,SAAS,0BAA0B,QAAgB,YAAyD;CAC1G,MAAM,SAAS,OAAO,KAAK,UAAU;AACrC,KAAI,CAAC,yBAAyB,OAAO,CACnC;AAEF,QAAO,OAAO;;AAGhB,SAAgB,4BAA4B,QAAuC;AACjF,KAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,CAChE,QAAO,EAAE;CAEX,MAAM,QAAS,OAAmC;AAClD,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,QAAO,EAAE;CAEX,MAAM,SAAS;AACf,QAAO;EACL,mBAAmB,OAAO,OAAO,sBAAsB,WAAW,OAAO,oBAAoB,KAAA;EAC7F,kBAAkB,OAAO,OAAO,qBAAqB,WAAW,OAAO,mBAA+D,KAAA;EACtI,eAAe,OAAO,OAAO,kBAAkB,WAAW,OAAO,gBAAgB,KAAA;EACjF,mBAAmB,OAAO,OAAO,sBAAsB,WAAW,OAAO,oBAAoB,KAAA;EAC7F,iBAAiB,OAAO,OAAO,oBAAoB,WAAW,OAAO,kBAAkB,KAAA;EACxF;;AAGH,SAAgB,4BAA4B,QAAyC;AACnF,KAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,OAAO,CAChE,QAAO,EAAE;CAEX,MAAM,QAAS,OAAmC;AAClD,KAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,QAAO,EAAE;AAEX,QAAO,MAAM,SAAS,UAAU;AAC9B,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,QAAO,EAAE;EAEX,MAAM,SAAS;AACf,MAAI,OAAO,OAAO,OAAO,YAAY,OAAO,OAAO,WAAW,SAC5D,QAAO,EAAE;AAEX,SAAO,CAAC;GACN,IAAI,OAAO;GACX,QAAQ,OAAO;GACf,QAAQ,OAAO,OAAO,WAAW,WAAW,OAAO,SAA2C,KAAA;GAC9F,IAAI,OAAO,OAAO,OAAO,YAAY,OAAO,KAAK,KAAA;GACjD,WAAW,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY,KAAA;GACrE,eAAe,OAAO,OAAO,kBAAkB,WAAW,OAAO,gBAAgB,KAAA;GACjF,aAAa,OAAO,OAAO,gBAAgB,WAAW,OAAO,cAAc,KAAA;GAC5E,CAAC;GACF;;AAGJ,SAAgB,2BACd,QACA,YACA,QACM;CACN,MAAM,SAAS,0BAA0B,QAAQ,WAAW;AAC5D,KAAI,CAAC,OACH;AAGF,QAAO,QAAQ,CACb,IAFe,MAAM,QAAQ,OAAO,MAAM,GAAG,OAAO,QAAQ,EAAE,EAElD,MAAM,CAAC,oBAAoB,EAAE,EACzC;EAAE,GAAG;EAAQ,qBAAI,IAAI,MAAM,EAAC,aAAa;EAAE,CAC5C;;AAGH,SAAgB,2BACd,QACA,YACA,QACM;CACN,MAAM,SAAS,0BAA0B,QAAQ,WAAW;AAC5D,KAAI,CAAC,OACH;CAEF,MAAM,6BAAY,IAAI,MAAM,EAAC,aAAa;AAC1C,QAAO,QAAQ;EACb,mBAAmB;EACnB,kBAAkB,OAAO;EACzB,eAAe,OAAO;EACtB,mBAAmB,OAAO;EAC1B,iBAAiB,OAAO;EACzB;AACD,KAAI,OAAO,IAAI;AACb,SAAO,kBAAkB;AACzB,SAAO,OAAO;YACL,OAAO,MAChB,QAAO,YAAY,OAAO;AAE5B,4BAA2B,QAAQ,YAAY;EAC7C,QAAQ;EACR,QAAQ,OAAO;EACf,IAAI,OAAO;EACX,WAAW,OAAO;EAClB,eAAe,OAAO;EACtB,aAAa,OAAO;EACrB,CAAC"}

package/dist/src/cron/index.js

@@ -1,6 +1,6 @@
-import { AddJobRequestSchema, JobDataSchema, UpdateJobRequestSchema } from "./validation.js";
 import { describeSchedule } from "./schedule.js";
 import { getCronPayloadText } from "./job-content.js";
+import { AddJobRequestSchema, JobDataSchema, UpdateJobRequestSchema } from "./validation.js";
 import { DefaultJobExecutor } from "./executor.js";
 import { CronRunLogStore } from "./run-log-store.js";
 import { CronService } from "./service.js";

package/dist/src/cron/service.js

@@ -2,10 +2,10 @@ import { init_agent_scope, normalizeAgentId } from "../agent/agent-scope.js";
 import { buildSessionKey, init_session_key } from "../routing/session-key.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { computeNextRunAtMs, describeSchedule, timerDelayUntil } from "./schedule.js";
 import { AddJobRequestSchema, JobDataSchema, UpdateJobRequestSchema } from "./validation.js";
 import { deleteCronJob, getCronJob, listCronJobs, saveCronJob, saveCronJobs } from "../storage/sqlite/cron-job-repository.js";
 import "../storage/sqlite/index.js";
-import { computeNextRunAtMs, describeSchedule, timerDelayUntil } from "./schedule.js";
 import { DefaultJobExecutor } from "./executor.js";
 import { CronRunLogStore } from "./run-log-store.js";
 import { randomUUID } from "node:crypto";