@tempoxyz/mercator 0.0.0

package/dist/clients.js

@@ -0,0 +1,282 @@
+import { randomUUID } from 'node:crypto';
+import { lstat, mkdir, readFile, realpath, rename, stat, writeFile, } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { commandAvailable, runCapturedCommand } from './command.js';
+export const Client = {
+    Claude: 'claude',
+    Cline: 'cline',
+    Codex: 'codex',
+    Continue: 'continue',
+    Cursor: 'cursor',
+    Gemini: 'gemini',
+    Hermes: 'hermes',
+    OpenClaw: 'openclaw',
+    VsCode: 'vscode',
+    Windsurf: 'windsurf',
+};
+export const CLIENT_IDS = Object.values(Client);
+export function setupPlan(client, url, options = {}) {
+    const home = options.home ?? homedir();
+    const cwd = options.cwd ?? process.cwd();
+    const mcpServers = { mercator: { url } };
+    switch (client) {
+        case Client.Codex:
+            return commandPlan('codex', ['mcp', 'add', 'mercator', '--url', url], {
+                args: ['mcp', 'get', 'mercator'],
+                command: 'codex',
+                url,
+            });
+        case Client.Claude:
+            return commandPlan('claude', ['mcp', 'add', '--scope', 'user', '--transport', 'http', 'mercator', url], {
+                args: ['mcp', 'get', 'mercator'],
+                command: 'claude',
+                url,
+            });
+        case Client.Gemini:
+            return commandPlan('gemini', ['mcp', 'add', 'mercator', url, '--transport', 'http', '--scope', 'user'], {
+                args: ['mcp', 'list'],
+                command: 'gemini',
+                serverName: 'mercator',
+                url,
+            });
+        case Client.OpenClaw:
+            return commandPlan('openclaw', ['mcp', 'add', 'mercator', '--url', url, '--transport', 'streamable-http'], {
+                args: ['mcp', 'show', 'mercator', '--json'],
+                command: 'openclaw',
+                url,
+            }, 'openclaw mcp unset mercator');
+        case Client.Hermes:
+            return commandPlan('hermes', ['mcp', 'add', 'mercator', '--url', url], {
+                args: ['mcp', 'list'],
+                command: 'hermes',
+                serverName: 'mercator',
+                url,
+            });
+        case Client.VsCode:
+            return {
+                args: ['--add-mcp', JSON.stringify({ name: 'mercator', type: 'http', url })],
+                command: 'code',
+                kind: 'command',
+                undo: 'Remove Mercator from the MCP: Open User Configuration command.',
+            };
+        case Client.Cursor:
+            return filePlan(join(home, '.cursor', 'mcp.json'), { mcpServers });
+        case Client.Windsurf:
+            return filePlan(join(home, '.codeium', 'windsurf', 'mcp_config.json'), {
+                mcpServers: { mercator: { serverUrl: url } },
+            });
+        case Client.Cline:
+            return filePlan(join(home, '.cline', 'mcp.json'), {
+                mcpServers: { mercator: { type: 'streamableHttp', url } },
+            });
+        case Client.Continue:
+            return filePlan(join(cwd, '.continue', 'mcpServers', 'mercator.json'), {
+                mcpServers: { mercator: { type: 'streamable-http', url } },
+            });
+    }
+}
+/** Builds a conservative removal plan that never includes wallet state. */
+export function removalPlan(client, options = {}) {
+    const home = options.home ?? homedir();
+    switch (client) {
+        case Client.Codex:
+            return { args: ['mcp', 'remove', 'mercator'], command: 'codex', kind: 'command' };
+        case Client.Claude:
+            return {
+                args: ['mcp', 'remove', '--scope', 'user', 'mercator'],
+                command: 'claude',
+                kind: 'command',
+            };
+        case Client.Gemini:
+            return { args: ['mcp', 'remove', 'mercator'], command: 'gemini', kind: 'command' };
+        case Client.OpenClaw:
+            return { args: ['mcp', 'unset', 'mercator'], command: 'openclaw', kind: 'command' };
+        case Client.Hermes:
+            return { args: ['mcp', 'remove', 'mercator'], command: 'hermes', kind: 'command' };
+        case Client.VsCode:
+            return vscodeRemovalPlan(home, options.platform ?? process.platform);
+        case Client.Cursor:
+        case Client.Windsurf:
+        case Client.Cline:
+        case Client.Continue: {
+            const plan = setupPlan(client, '', options);
+            if (plan.kind !== 'file')
+                throw new Error(`Expected a file plan for ${client}`);
+            return { kind: 'file', path: plan.path, serverContainer: 'mcpServers' };
+        }
+    }
+}
+export async function configurationState(plan, runCheck = runCommandCheck) {
+    if (plan.kind === 'file')
+        return fileConfigurationState(plan);
+    if (!plan.check)
+        return 'unknown';
+    const result = await runCheck(plan.check);
+    if (result.code !== 0)
+        return 'missing';
+    if (plan.check.serverName && !result.output.includes(plan.check.serverName))
+        return 'missing';
+    return result.output.includes(plan.check.url) ? 'current' : 'different';
+}
+export async function installedClients(isAvailable = commandAvailable) {
+    const commands = [
+        [Client.Codex, 'codex'],
+        [Client.Claude, 'claude'],
+        [Client.Cline, 'cline'],
+        [Client.Gemini, 'gemini'],
+        [Client.Hermes, 'hermes'],
+        [Client.OpenClaw, 'openclaw'],
+        [Client.VsCode, 'code'],
+    ];
+    const present = await Promise.all(commands.map(async ([client, command]) => ({
+        client,
+        present: await isAvailable(command),
+    })));
+    return present.filter(({ present }) => present).map(({ client }) => client);
+}
+export async function mergeConfigFile(plan) {
+    let existing = {};
+    try {
+        existing = JSON.parse(await readFile(plan.path, 'utf8'));
+    }
+    catch (error) {
+        if (!isMissingFile(error))
+            throw error;
+    }
+    const merged = deepMerge(existing, plan.config);
+    await writeJsonFile(plan.path, merged);
+}
+/** Removes only the Mercator server entry while preserving the rest of the file. */
+export async function removeConfigFile(plan, options = {}) {
+    let existing;
+    try {
+        existing = JSON.parse(await readFile(plan.path, 'utf8'));
+    }
+    catch (error) {
+        if (isMissingFile(error))
+            return 'missing';
+        throw error;
+    }
+    const servers = existing[plan.serverContainer];
+    if (!isRecord(servers) || !Object.hasOwn(servers, 'mercator'))
+        return 'missing';
+    if (options.dryRun)
+        return 'planned';
+    const { mercator: _mercator, ...remainingServers } = servers;
+    const updated = { ...existing, [plan.serverContainer]: remainingServers };
+    await writeJsonFile(plan.path, updated);
+    return 'removed';
+}
+function vscodeRemovalPlan(home, platform) {
+    if (platform === 'darwin') {
+        return {
+            kind: 'file',
+            path: join(home, 'Library', 'Application Support', 'Code', 'User', 'mcp.json'),
+            serverContainer: 'servers',
+        };
+    }
+    if (platform === 'linux') {
+        return {
+            kind: 'file',
+            path: join(home, '.config', 'Code', 'User', 'mcp.json'),
+            serverContainer: 'servers',
+        };
+    }
+    if (platform === 'win32') {
+        return {
+            kind: 'file',
+            path: join(home, 'AppData', 'Roaming', 'Code', 'User', 'mcp.json'),
+            serverContainer: 'servers',
+        };
+    }
+    return {
+        instructions: 'Run “MCP: Open User Configuration” and remove the mercator server.',
+        kind: 'manual',
+    };
+}
+function commandPlan(command, args, check, undo = `${command} mcp remove mercator`) {
+    return {
+        args,
+        ...(check ? { check } : {}),
+        command,
+        kind: 'command',
+        undo,
+    };
+}
+async function writeJsonFile(path, value) {
+    let target = path;
+    let mode = 0o600;
+    let pathExists = false;
+    try {
+        const pathStats = await lstat(path);
+        pathExists = true;
+        if (pathStats.isSymbolicLink())
+            target = await realpath(path);
+        const targetStats = await stat(target);
+        if (!targetStats.isFile())
+            throw new Error(`Configuration path is not a file: ${path}`);
+        mode = targetStats.mode & 0o777;
+    }
+    catch (error) {
+        if (!isMissingFile(error) || pathExists)
+            throw error;
+    }
+    await mkdir(dirname(target), { recursive: true });
+    const temporary = `${target}.${process.pid}.${randomUUID()}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, {
+        encoding: 'utf8',
+        mode,
+    });
+    await rename(temporary, target);
+}
+async function fileConfigurationState(plan) {
+    let existing;
+    try {
+        existing = JSON.parse(await readFile(plan.path, 'utf8'));
+    }
+    catch (error) {
+        if (isMissingFile(error))
+            return 'missing';
+        throw error;
+    }
+    const servers = existing.mcpServers;
+    if (!isRecord(servers) || !Object.hasOwn(servers, 'mercator'))
+        return 'missing';
+    return containsConfiguration(existing, plan.config) ? 'current' : 'different';
+}
+async function runCommandCheck(check) {
+    return runCapturedCommand(check.command, check.args, { includeStderr: true });
+}
+function containsConfiguration(existing, expected) {
+    return Object.entries(expected).every(([key, expectedValue]) => {
+        const existingValue = existing[key];
+        if (isRecord(expectedValue)) {
+            return (isRecord(existingValue) && containsConfiguration(existingValue, expectedValue));
+        }
+        return existingValue === expectedValue;
+    });
+}
+function filePlan(path, config) {
+    return {
+        config,
+        kind: 'file',
+        path,
+        undo: `Remove the mercator entry from ${path}`,
+    };
+}
+function deepMerge(left, right) {
+    const merged = { ...left };
+    for (const [key, value] of Object.entries(right)) {
+        const current = merged[key];
+        merged[key] = isRecord(current) && isRecord(value) ? deepMerge(current, value) : value;
+    }
+    return merged;
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function isMissingFile(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+//# sourceMappingURL=clients.js.map

package/dist/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../src/clients.ts"],"names":[],"mappings":"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"}

package/dist/codex-plugin.d.ts

@@ -0,0 +1,52 @@
+/** Installation state for the Mercator personal-marketplace plugin. */
+type CodexPluginInstallStatus = 'already_configured' | 'configured' | 'planned' | 'updated';
+/** Public result of installing the local Mercator plugin for Codex desktop surfaces. */
+export type CodexPluginInstallResult = {
+    marketplacePath: string;
+    pluginPath: string;
+    reloadRequired: boolean;
+    status: CodexPluginInstallStatus;
+};
+/** Diagnostic state of the CLI-managed local Mercator plugin. */
+export type CodexPluginInspection = {
+    error?: string;
+    expectedVersion: string;
+    installedVersion?: string;
+    marketplacePath: string;
+    pluginPath: string;
+    registered: boolean;
+    reloadRequired: boolean;
+    status: 'conflict' | 'missing' | 'outdated' | 'ready';
+};
+/** Public result of removing the CLI-managed local Mercator plugin. */
+export type CodexPluginRemoveResult = {
+    marketplacePath: string;
+    pluginPath: string;
+    reloadRequired: boolean;
+    status: 'missing' | 'planned' | 'removed';
+};
+/** User-local filesystem locations used by the Mercator desktop plugin. */
+export type CodexPluginPaths = {
+    lockPath: string;
+    marketplacePath: string;
+    pluginPath: string;
+};
+type InstallCodexPluginOptions = {
+    dryRun?: boolean;
+    home?: string;
+    packageVersion?: string;
+    pluginSource?: string;
+};
+type CodexPluginOptions = Omit<InstallCodexPluginOptions, 'dryRun'>;
+/** Resolves native or simulated platform paths for packaged-install verification. */
+export declare function resolveCodexPluginPaths(home: string, platform?: NodeJS.Platform): CodexPluginPaths;
+/** Installs Mercator into the personal marketplace without requiring the Codex CLI. */
+export declare function installCodexPlugin(options?: InstallCodexPluginOptions): Promise<CodexPluginInstallResult>;
+/** Inspects the installed bundle and local registration without changing either. */
+export declare function inspectCodexPlugin(options?: CodexPluginOptions): Promise<CodexPluginInspection>;
+/** Removes only the plugin bundle and marketplace entry owned by Mercator CLI. */
+export declare function removeCodexPlugin(options?: {
+    dryRun?: boolean;
+    home?: string;
+}): Promise<CodexPluginRemoveResult>;
+export {};