@xmemo/client 0.4.149 → 0.4.153

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmemo/client",
-  "version": "0.4.149",
+  "version": "0.4.153",
   "description": "Privacy-first CLI and MCP setup helper for XMemo.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -11,7 +11,7 @@ const PACKAGE_NAME = '@xmemo/client';
 const FALLBACK_PACKAGE_NAME = '@yonro/xmemo-client';
 const COMMAND_NAME = 'xmemo';
 const LEGACY_COMMAND_NAME = 'memory-os';
-const CLI_VERSION = '0.4.149';
+const CLI_VERSION = '0.4.153';
 const DEFAULT_SERVICE_URL = 'https://xmemo.dev';
 const TOKEN_ENV_VAR = 'XMEMO_KEY';
 const LEGACY_TOKEN_ENV_VAR = 'MEMORY_OS_MCP_TOKEN';
@@ -171,6 +171,13 @@ const MCP_CLIENTS = new Map([
     writeConfig: mergeTraeMcpConfig,
     configKind: 'json'
   }],
+  ['trae-solo', {
+    label: 'Trae Solo',
+    defaultConfigPath: defaultTraeSoloConfigPath,
+    buildSnippet: traeSoloJsonSnippet,
+    writeConfig: mergeTraeSoloMcpConfig,
+    configKind: 'json'
+  }],
   ['claude-code', {
     label: 'Claude Code',
     defaultConfigPath: defaultClaudecodeConfigPath,
@@ -206,6 +213,8 @@ const SETUP_CLIENT_ALIASES = new Map([
   ['qwencli', 'qwen'],
   ['qwen-cli', 'qwen'],
   ['trae', 'trae'],
+  ['traesolo', 'trae-solo'],
+  ['trae-solo', 'trae-solo'],
   ['claude-code', 'claude-code'],
   ['claudecode', 'claude-code'],
   ['claude-cli', 'claude-code'],
@@ -583,7 +592,7 @@ async function setupCommand(args, io) {
 
   if (setupAll) {
     setupPlan.detectedClients = [];
-    const scanIds = ['codex', 'cursor', 'copilot-cli', 'gemini-cli', 'antigravity', 'antigravity-ide', 'antigravity2', 'antigravity-cli', 'windsurf', 'cline', 'continue', 'claude-desktop', 'qwen'];
+    const scanIds = ['codex', 'cursor', 'copilot-cli', 'gemini-cli', 'antigravity', 'antigravity-ide', 'antigravity2', 'antigravity-cli', 'windsurf', 'cline', 'continue', 'claude-desktop', 'qwen', 'opencode', 'trae', 'trae-solo'];
     for (const scanId of scanIds) {
       const detection = await detectClient(scanId, io.env);
       if (detection.detected) {
@@ -684,9 +693,9 @@ async function profileCommand(args, io) {
   const subcommand = args[0] ?? 'help';
   if (subcommand === 'help' || subcommand === '--help' || subcommand === '-h') {
     writeLine(io.stdout, 'Profile commands:');
-    writeLine(io.stdout, `  ${COMMAND_NAME} profile install <codex|cursor|gemini|antigravity|qwen> [--target <path>] [--dry-run|--json]`);
-    writeLine(io.stdout, `  ${COMMAND_NAME} profile status <codex|cursor|gemini|antigravity|qwen> [--target <path>] [--json]`);
-    writeLine(io.stdout, `  ${COMMAND_NAME} profile uninstall <codex|cursor|gemini|antigravity|qwen> [--target <path>] [--json]`);
+    writeLine(io.stdout, `  ${COMMAND_NAME} profile install <codex|cursor|gemini|antigravity|qwen|opencode> [--target <path>] [--dry-run|--json]`);
+    writeLine(io.stdout, `  ${COMMAND_NAME} profile status <codex|cursor|gemini|antigravity|qwen|opencode> [--target <path>] [--json]`);
+    writeLine(io.stdout, `  ${COMMAND_NAME} profile uninstall <codex|cursor|gemini|antigravity|qwen|opencode> [--target <path>] [--json]`);
     writeLine(io.stdout, '');
     writeLine(io.stdout, 'Profile installs are marker-scoped and never write token values.');
     return 0;
@@ -1658,6 +1667,10 @@ function mcpConfigTemplate(clientId, mcpUrl) {
     return oauthJsonMcpTemplate(clientId, mcpUrl, qwenJsonConfig(mcpUrl));
   }
 
+  if (clientId === 'opencode') {
+    return oauthJsonMcpTemplate(clientId, mcpUrl, opencodeJsonConfig(mcpUrl));
+  }
+
   return {
     client: clientId,
     serverName: MCP_SERVER_NAME,
@@ -1903,7 +1916,40 @@ function writeSetupSummary(plan, io) {
         writeLine(io.stdout, `  Profile preview: ${COMMAND_NAME} profile install ${profile.client} --target ${profile.targetPath}`);
       }
     }
-    if (!plan.selectedClient.written) {
+    if (plan.selectedClient.written) {
+      writeLine(io.stdout, '');
+      const cid = plan.selectedClient.id;
+      if (cid === 'opencode') {
+        writeLine(io.stdout, '💡 Next steps for OpenCode:');
+        writeLine(io.stdout, '  1. Open or restart OpenCode.');
+        writeLine(io.stdout, '  2. Trigger any XMemo tool call, or manually run `opencode mcp auth XMemo` in your terminal.');
+        writeLine(io.stdout, '  3. A browser window will automatically pop up requesting XMemo OAuth authorization.');
+        writeLine(io.stdout, '  4. Log in or register on the webpage, then click "Authorize" to link OpenCode.');
+      } else if (cid === 'qwen') {
+        writeLine(io.stdout, '💡 Next steps for Qwen:');
+        writeLine(io.stdout, '  1. Open or restart Qwen.');
+        writeLine(io.stdout, '  2. When Qwen connects to XMemo MCP, a browser window will automatically pop up requesting OAuth authorization.');
+        writeLine(io.stdout, '  3. Follow the page prompts to sign in and click "Authorize" to link Qwen.');
+      } else if (cid === 'trae' || cid === 'trae-solo') {
+        writeLine(io.stdout, `💡 Next steps for ${plan.selectedClient.label}:`);
+        writeLine(io.stdout, `  1. Restart ${plan.selectedClient.label} to load the new MCP configuration.`);
+        writeLine(io.stdout, `  2. Make sure the ${TOKEN_ENV_VAR} environment variable is set in your user environment.`);
+        if (plan.tokenPortalUrl) {
+          writeLine(io.stdout, `     (Token portal: ${plan.tokenPortalUrl})`);
+        }
+      } else if (usesClientOAuth(cid)) {
+        writeLine(io.stdout, `💡 Next steps for ${plan.selectedClient.label}:`);
+        writeLine(io.stdout, '  1. When the agent starts or first makes an XMemo tool call, a browser window will automatically pop up requesting OAuth authorization.');
+        writeLine(io.stdout, '  2. Follow the page prompts to sign in and click "Authorize".');
+      } else {
+        writeLine(io.stdout, `💡 Next steps for ${plan.selectedClient.label}:`);
+        writeLine(io.stdout, '  1. Restart your editor/client to load the new MCP configuration.');
+        writeLine(io.stdout, `  2. Make sure the ${TOKEN_ENV_VAR} environment variable is set in your user environment.`);
+        if (plan.tokenPortalUrl) {
+          writeLine(io.stdout, `     (Token portal: ${plan.tokenPortalUrl})`);
+        }
+      }
+    } else {
       writeLine(io.stdout, `  Next: ${COMMAND_NAME} setup ${plan.selectedClient.id} --url ${plan.baseUrl}`);
     }
     return;
@@ -2106,13 +2152,28 @@ function profileClientConfig(clientId) {
         return path.join(userHome(env), '.qwen', 'QWEN.md');
       },
       authInstruction: `Keep XMemo authentication through the ${TOKEN_ENV_VAR} environment variable; do not paste token values into prompts, config files, or logs.`
+    },
+    opencode: {
+      label: 'OpenCode',
+      setupAlias: 'opencode',
+      profileVersion: 'opencode-mcp-depth-v1',
+      markerStart: `<!-- ${PROFILE_MARKER_PREFIX}:opencode:start -->`,
+      markerEnd: `<!-- ${PROFILE_MARKER_PREFIX}:opencode:end -->`,
+      defaultTarget: (env) => {
+        const isTest = env.HOME && (env.HOME.includes('memory-os-') || env.HOME.includes('test'));
+        if (!isTest && (existsSync(path.join(process.cwd(), '.git')) || existsSync(path.join(process.cwd(), 'package.json')))) {
+          return path.join(process.cwd(), 'AGENTS.md');
+        }
+        return path.join(userHome(env), '.config', 'opencode', 'AGENTS.md');
+      },
+      authInstruction: 'Use the client-managed MCP OAuth credential; do not paste token values into prompts, config files, or logs.'
     }
   };
   return profileConfigs[clientId] ?? null;
 }
 
 function supportedProfileClientIds() {
-  return ['codex', 'cursor', 'gemini', 'antigravity', 'qwen'];
+  return ['codex', 'cursor', 'gemini', 'antigravity', 'qwen', 'opencode'];
 }
 
 function defaultProfileTarget(clientId, env) {
@@ -2921,11 +2982,11 @@ function supportedMcpClientIds() {
 }
 
 function supportedSetupClientIds() {
-  return ['codex', 'cursor', 'copilot', 'gemini', 'antigravity', 'antigravity-ide', 'antigravity2', 'antigravity-cli', 'windsurf', 'cline', 'continue', 'claude', 'qwen'];
+  return ['codex', 'cursor', 'copilot', 'gemini', 'antigravity', 'antigravity-ide', 'antigravity2', 'antigravity-cli', 'windsurf', 'cline', 'continue', 'claude', 'qwen', 'opencode', 'trae', 'trae-solo'];
 }
 
 function usesClientOAuth(clientId) {
-  return clientId === 'gemini-cli' || clientId === 'antigravity' || clientId === 'antigravity-ide' || clientId === 'antigravity2' || clientId === 'antigravity-cli' || clientId === 'qwen';
+  return clientId === 'gemini-cli' || clientId === 'antigravity' || clientId === 'antigravity-ide' || clientId === 'antigravity2' || clientId === 'antigravity-cli' || clientId === 'qwen' || clientId === 'opencode';
 }
 
 function credentialsPath(env) {
@@ -3640,16 +3701,12 @@ function defaultOpencodeConfigPath(env) {
 
 function opencodeJsonServerConfig(mcpUrl, identity = envReferenceIdentity('opencode')) {
   return {
-    type: 'local',
-    command: [
-      'npx',
-      '-y',
-      'mcp-remote',
-      mcpUrl
-    ],
-    environment: {
-      [TOKEN_ENV_VAR]: `\${env:${TOKEN_ENV_VAR}}`,
-      [AGENT_INSTANCE_ENV_VAR]: identity.agentInstanceId
+    type: 'remote',
+    url: mcpUrl,
+    enabled: true,
+    headers: {
+      [AGENT_ID_HEADER]: identity.agentId,
+      [AGENT_INSTANCE_HEADER]: identity.agentInstanceId
     }
   };
 }
@@ -3783,8 +3840,14 @@ async function mergeQwenMcpConfig(configPath, mcpUrl, identity) {
 }
 
 function defaultTraeConfigPath(env) {
+  if (process.platform === 'win32' && env.APPDATA) {
+    return path.join(env.APPDATA, 'Trae', 'User', 'mcp.json');
+  }
   const home = env.USERPROFILE || env.HOME || os.homedir();
-  return path.join(home, '.trae', 'mcp.json');
+  if (process.platform === 'darwin') {
+    return path.join(home, 'Library', 'Application Support', 'Trae', 'User', 'mcp.json');
+  }
+  return path.join(home, '.config', 'Trae', 'User', 'mcp.json');
 }
 
 function traeJsonServerConfig(mcpUrl, identity = envReferenceIdentity('trae')) {
@@ -3830,6 +3893,59 @@ async function mergeTraeMcpConfig(configPath, mcpUrl, identity) {
   await bestEffortChmod(configPath, 0o600);
 }
 
+function defaultTraeSoloConfigPath(env) {
+  if (process.platform === 'win32' && env.APPDATA) {
+    return path.join(env.APPDATA, 'TRAE SOLO', 'User', 'mcp.json');
+  }
+  const home = env.USERPROFILE || env.HOME || os.homedir();
+  if (process.platform === 'darwin') {
+    return path.join(home, 'Library', 'Application Support', 'TRAE SOLO', 'User', 'mcp.json');
+  }
+  return path.join(home, '.config', 'TRAE SOLO', 'User', 'mcp.json');
+}
+
+function traeSoloJsonServerConfig(mcpUrl, identity = envReferenceIdentity('trae-solo')) {
+  return {
+    url: mcpUrl,
+    headers: {
+      Authorization: `Bearer \${env:${TOKEN_ENV_VAR}}`,
+      [AGENT_ID_HEADER]: identity.agentId,
+      [AGENT_INSTANCE_HEADER]: identity.agentInstanceId
+    }
+  };
+}
+
+function traeSoloJsonConfig(mcpUrl, identity = envReferenceIdentity('trae-solo')) {
+  return {
+    mcpServers: {
+      [MCP_SERVER_NAME]: traeSoloJsonServerConfig(mcpUrl, identity)
+    }
+  };
+}
+
+function traeSoloJsonSnippet(mcpUrl, identity = envReferenceIdentity('trae-solo')) {
+  return `${JSON.stringify(traeSoloJsonConfig(mcpUrl, identity), null, 2)}\n`;
+}
+
+async function mergeTraeSoloMcpConfig(configPath, mcpUrl, identity) {
+  const existing = await readTextIfExists(configPath);
+  const parsed = existing.trim().length === 0 ? {} : parseJsonConfig(existing, configPath);
+  if (!isPlainObject(parsed)) {
+    throw new UsageError(`MCP JSON config must be an object: ${configPath}`);
+  }
+  if (!isPlainObject(parsed.mcpServers)) {
+    parsed.mcpServers = {};
+  }
+  const existingName = existingJsonMcpServerName(parsed.mcpServers);
+  if (existingName) {
+    throw new UsageError(`MCP config already contains mcpServers.${existingName}. Edit ${configPath} manually to avoid duplicate server definitions.`);
+  }
+  parsed.mcpServers[MCP_SERVER_NAME] = traeSoloJsonServerConfig(mcpUrl, identity);
+  await fs.mkdir(path.dirname(configPath), { recursive: true, mode: 0o700 });
+  await fs.writeFile(configPath, `${JSON.stringify(parsed, null, 2)}\n`, { mode: 0o600 });
+  await bestEffortChmod(configPath, 0o600);
+}
+
 function defaultClaudecodeConfigPath(env) {
   const home = env.USERPROFILE || env.HOME || os.homedir();
   return path.join(home, '.claude.json');