@xmemo/client 0.4.154 → 0.4.156

package/src/mcp/registry.js

@@ -0,0 +1,67 @@
+import { JSON_MCP_CLIENT_DEFINITIONS } from './json-clients.js';
+
+export function createMcpClients(deps) {
+  const clients = new Map();
+
+  clients.set('codex', {
+    label: 'Codex',
+    defaultConfigPath: deps.defaultCodexConfigPath,
+    buildSnippet: deps.codexTomlSnippet,
+    writeConfig: deps.appendTomlServerConfig,
+    configKind: 'toml'
+  });
+
+  for (const definition of deps.JSON_MCP_CLIENT_DEFINITIONS) {
+    if (definition.id === 'qwen') {
+      clients.set('hermes', hermesClient(deps));
+    }
+    clients.set(definition.id, jsonClient(definition, deps));
+  }
+
+  if (!clients.has('hermes')) {
+    clients.set('hermes', hermesClient(deps));
+  }
+
+  return clients;
+}
+
+function jsonClient(definition, deps) {
+  return {
+    label: definition.label,
+    defaultConfigPath: deps[definition.defaultConfigPath],
+    buildSnippet: (mcpUrl, identity) => deps.jsonClientSnippet(definition.id, mcpUrl, identity),
+    writeConfig: (configPath, mcpUrl, identity) => deps.mergeJsonClientMcpConfig(definition.id, configPath, mcpUrl, identity),
+    configKind: definition.configKind,
+    authentication: definition.authentication
+  };
+}
+
+function hermesClient(deps) {
+  return {
+    label: 'Hermes',
+    defaultConfigPath: deps.defaultHermesConfigPath,
+    buildSnippet: deps.hermesYamlSnippet,
+    writeConfig: deps.mergeHermesMcpConfig,
+    configKind: 'yaml'
+  };
+}
+
+export function supportedMcpClients(mcpClients) {
+  const clients = Array.from(mcpClients.entries()).map(([id, client]) => ({
+    id,
+    label: client.label,
+    configKind: client.configKind
+  }));
+  clients.push({ id: 'copilot-cli', label: 'Copilot CLI', configKind: 'local-proxy' });
+  return clients;
+}
+
+export function supportedMcpClientIds(mcpClients) {
+  return Array.from(mcpClients.keys());
+}
+
+export function usesClientOAuth(clientId) {
+  return JSON_MCP_CLIENT_DEFINITIONS.some(
+    (definition) => definition.id === clientId && definition.authentication === 'oauth'
+  );
+}

package/src/mcp/templates.js

@@ -0,0 +1,155 @@
+import {
+  AGENT_ID_HEADER,
+  AGENT_INSTANCE_ENV_VAR,
+  AGENT_INSTANCE_HEADER,
+  COMMAND_NAME,
+  DEFAULT_PROXY_PORT,
+  MCP_SERVER_NAME,
+  TOKEN_ENV_VAR
+} from '../constants.js';
+import { codexTomlSnippet } from './codex.js';
+import {
+  jsonClientConfig,
+  jsonMcpClientDefinition
+} from './json-clients.js';
+
+export function mcpConfigTemplate(clientId, mcpUrl, options = {}) {
+  if (clientId === 'codex') {
+    return {
+      client: clientId,
+      serverName: MCP_SERVER_NAME,
+      snippetFormat: 'toml',
+      snippet: codexTomlSnippet(mcpUrl),
+      requiresEnv: [TOKEN_ENV_VAR],
+      optionalEnv: [AGENT_INSTANCE_ENV_VAR],
+      agentIdentity: {
+        agentId: 'codex',
+        agentIdHeader: AGENT_ID_HEADER,
+        agentInstanceEnvVar: AGENT_INSTANCE_ENV_VAR,
+        agentInstanceHeader: AGENT_INSTANCE_HEADER
+      },
+      agentInstanceGeneration: agentInstanceGenerationPolicy(clientId, options),
+      writesTokenValue: false
+    };
+  }
+
+  const jsonDefinition = jsonMcpClientDefinition(clientId);
+  if (jsonDefinition) {
+    return jsonDefinition.authentication === 'oauth'
+      ? oauthJsonMcpTemplate(clientId, mcpUrl, jsonClientConfig(clientId, mcpUrl), options)
+      : bearerJsonMcpTemplate(clientId, mcpUrl, jsonClientConfig(clientId, mcpUrl), options);
+  }
+
+  return {
+    client: clientId,
+    serverName: MCP_SERVER_NAME,
+    snippetFormat: 'json',
+    snippet: {
+      mcpServers: {
+        [MCP_SERVER_NAME]: {
+          type: 'http',
+          url: mcpUrl,
+          headers: {
+            Authorization: `Bearer \${${TOKEN_ENV_VAR}}`,
+            [AGENT_ID_HEADER]: clientId,
+            [AGENT_INSTANCE_HEADER]: `\${${AGENT_INSTANCE_ENV_VAR}}`
+          }
+        }
+      }
+    },
+    requiresEnv: [TOKEN_ENV_VAR],
+    optionalEnv: [AGENT_INSTANCE_ENV_VAR],
+    agentIdentity: {
+      agentId: clientId,
+      agentIdHeader: AGENT_ID_HEADER,
+      agentInstanceEnvVar: AGENT_INSTANCE_ENV_VAR,
+      agentInstanceHeader: AGENT_INSTANCE_HEADER
+    },
+    agentInstanceGeneration: agentInstanceGenerationPolicy(clientId, options),
+    writesTokenValue: false
+  };
+}
+
+export function mcpLocalProxyTemplate(clientId, proxyUrl, options = {}) {
+  return {
+    client: clientId,
+    serverName: MCP_SERVER_NAME,
+    snippetFormat: 'json',
+    snippet: {
+      mcpServers: {
+        [MCP_SERVER_NAME]: {
+          type: 'http',
+          url: proxyUrl
+        }
+      }
+    },
+    requiresCredential: [`${COMMAND_NAME} login`, `${COMMAND_NAME} token add --from-stdin`],
+    requiresLocalCommand: `${COMMAND_NAME} mcp proxy --port ${new URL(proxyUrl).port || DEFAULT_PROXY_PORT}`,
+    agentIdentity: {
+      agentId: clientId,
+      agentIdHeader: AGENT_ID_HEADER,
+      agentInstanceEnvVar: AGENT_INSTANCE_ENV_VAR,
+      agentInstanceHeader: AGENT_INSTANCE_HEADER
+    },
+    agentInstanceGeneration: agentInstanceGenerationPolicy(clientId, options),
+    writesTokenValue: false
+  };
+}
+
+export function agentInstanceGenerationPolicy(clientId, options = {}) {
+  const automaticCommand = options.mcpClients?.has(clientId)
+    ? `${COMMAND_NAME} mcp add ${clientId} --write`
+    : clientId === 'copilot-cli'
+      ? `${COMMAND_NAME} setup copilot --write`
+      : null;
+  return {
+    requiredForHeaders: true,
+    stablePerInstall: true,
+    automaticCommand,
+    generatedPattern: `xmemo-${clientId}-<uuid>`,
+    storagePath: `~/.config/xmemo/agent-instances/${clientId}.json`,
+    manualEnvVar: AGENT_INSTANCE_ENV_VAR
+  };
+}
+
+function bearerJsonMcpTemplate(clientId, mcpUrl, snippet, options) {
+  return {
+    client: clientId,
+    serverName: MCP_SERVER_NAME,
+    snippetFormat: 'json',
+    snippet,
+    requiresEnv: [TOKEN_ENV_VAR],
+    optionalEnv: [AGENT_INSTANCE_ENV_VAR],
+    authentication: 'env-bearer',
+    agentIdentity: {
+      agentId: clientId,
+      agentIdHeader: AGENT_ID_HEADER,
+      agentInstanceEnvVar: AGENT_INSTANCE_ENV_VAR,
+      agentInstanceHeader: AGENT_INSTANCE_HEADER
+    },
+    agentInstanceGeneration: agentInstanceGenerationPolicy(clientId, options),
+    mcpUrl,
+    writesTokenValue: false
+  };
+}
+
+function oauthJsonMcpTemplate(clientId, mcpUrl, snippet, options) {
+  return {
+    client: clientId,
+    serverName: MCP_SERVER_NAME,
+    snippetFormat: 'json',
+    snippet,
+    requiresEnv: [],
+    optionalEnv: [AGENT_INSTANCE_ENV_VAR],
+    authentication: 'oauth',
+    agentIdentity: {
+      agentId: clientId,
+      agentIdHeader: AGENT_ID_HEADER,
+      agentInstanceEnvVar: AGENT_INSTANCE_ENV_VAR,
+      agentInstanceHeader: AGENT_INSTANCE_HEADER
+    },
+    agentInstanceGeneration: agentInstanceGenerationPolicy(clientId, options),
+    mcpUrl,
+    writesTokenValue: false
+  };
+}

package/src/path-config.js

@@ -0,0 +1,25 @@
+export {
+  configRoot,
+  defaultAntigravity2ConfigPath,
+  defaultAntigravityCliConfigPath,
+  defaultAntigravityConfigPath,
+  defaultAntigravityIdeConfigPath,
+  defaultClaudeConfigPath,
+  defaultClaudecodeConfigPath,
+  defaultClineConfigPath,
+  defaultCodexConfigPath,
+  defaultContinueConfigPath,
+  defaultCopilotConfigPath,
+  defaultCursorConfigPath,
+  defaultGeminiConfigPath,
+  defaultHermesConfigPath,
+  defaultJetbrainsConfigPath,
+  defaultKiroConfigPath,
+  defaultOpencodeConfigPath,
+  defaultOpenclawConfigPath,
+  defaultQwenConfigPath,
+  defaultTraeConfigPath,
+  defaultTraeSoloConfigPath,
+  defaultWindsurfConfigPath,
+  defaultZedConfigPath
+} from './mcp/paths.js';