@tempoxyz/mercator 0.0.0

package/dist/native-payments.js

@@ -0,0 +1,191 @@
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { Client } from './clients.js';
+import { commandAvailable, runCapturedCommand, runInteractiveCommand, } from './command.js';
+/** Native payment integrations managed by their agent runtime. */
+const NativePayment = {
+    HermesMpp: 'hermes-mpp',
+    OpenClawMpp: 'openclaw-mpp',
+};
+const defaultDependencies = () => ({
+    commandAvailable,
+    env: process.env,
+    home: homedir(),
+    interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+    readTextFile: (path) => readFile(path, 'utf8'),
+    runCaptured: (command, args) => runCapturedCommand(command, args, {
+        includeStderr: false,
+        maxOutputBytes: 128 * 1024,
+        timeoutMs: 10_000,
+    }),
+    runInteractive: runInteractiveCommand,
+});
+/** Configures runtime-native payment integrations for selected clients. */
+export async function setupNativePayments(clients, options, overrides = {}) {
+    const dependencies = { ...defaultDependencies(), ...overrides };
+    const origin = new URL(options.endpoint).origin;
+    const reports = [];
+    if (clients.includes(Client.OpenClaw)) {
+        reports.push(await setupOpenClaw(options, dependencies));
+    }
+    if (clients.includes(Client.Hermes)) {
+        reports.push(await setupHermes(origin, options, dependencies));
+    }
+    return reports;
+}
+/** Reads only the Hermes MPP origin allowlist, never other environment values. */
+export function parseAllowedOrigins(content) {
+    const line = content
+        .split(/\r?\n/)
+        .find((candidate) => candidate.trimStart().startsWith('MPP_ALLOWED_ORIGINS='));
+    if (line === undefined)
+        return undefined;
+    const value = line
+        .slice(line.indexOf('=') + 1)
+        .trim()
+        .replace(/^(['"])(.*)\1$/, '$2');
+    return value
+        .split(',')
+        .map((origin) => origin.trim())
+        .filter(Boolean);
+}
+/** Adds one exact origin without removing or duplicating existing entries. */
+export function mergeAllowedOrigins(existing, origin) {
+    return [...new Set([...existing, origin])];
+}
+async function setupOpenClaw(options, dependencies) {
+    const base = {
+        client: Client.OpenClaw,
+        integration: NativePayment.OpenClawMpp,
+    };
+    const available = await dependencies.commandAvailable('openclaw');
+    const commands = [
+        'openclaw plugins install clawhub:openclaw-mpp',
+        'openclaw mpp setup',
+        'openclaw gateway restart',
+    ];
+    if (!available) {
+        return {
+            ...base,
+            guidance: commands,
+            status: options.dryRun ? 'planned' : 'action_required',
+        };
+    }
+    const [plugin, wallet] = await Promise.all([
+        dependencies.runCaptured('openclaw', [
+            'plugins',
+            'inspect',
+            'mpp',
+            '--runtime',
+            '--json',
+        ]),
+        dependencies.runCaptured('openclaw', ['mpp', 'status']),
+    ]);
+    if (plugin.code === 0 && wallet.code === 0) {
+        return {
+            ...base,
+            guidance: ['Use mpp_fetch to POST paid jobs to the Mercator REST endpoint.'],
+            status: 'ready',
+        };
+    }
+    if (options.dryRun)
+        return { ...base, guidance: commands, status: 'planned' };
+    if (!dependencies.interactive) {
+        return { ...base, guidance: commands, status: 'action_required' };
+    }
+    if (plugin.code !== 0) {
+        await dependencies.runInteractive('openclaw', [
+            'plugins',
+            'install',
+            'clawhub:openclaw-mpp',
+        ]);
+    }
+    if (wallet.code !== 0)
+        await dependencies.runInteractive('openclaw', ['mpp', 'setup']);
+    await dependencies.runInteractive('openclaw', ['gateway', 'restart']);
+    const [verifiedPlugin, verifiedWallet] = await Promise.all([
+        dependencies.runCaptured('openclaw', [
+            'plugins',
+            'inspect',
+            'mpp',
+            '--runtime',
+            '--json',
+        ]),
+        dependencies.runCaptured('openclaw', ['mpp', 'status']),
+    ]);
+    const ready = verifiedPlugin.code === 0 && verifiedWallet.code === 0;
+    return {
+        ...base,
+        guidance: ready
+            ? ['Use mpp_fetch to POST paid jobs to the Mercator REST endpoint.']
+            : commands,
+        status: ready ? 'ready' : 'action_required',
+    };
+}
+async function setupHermes(origin, options, dependencies) {
+    const base = {
+        client: Client.Hermes,
+        integration: NativePayment.HermesMpp,
+    };
+    const plugin = await dependencies.runCaptured('hermes', ['plugins', 'list']);
+    const installed = plugin.code === 0 && /\bmpp\b.*\benabled\b/im.test(plugin.output);
+    const envFile = join(dependencies.env.HERMES_HOME ?? join(dependencies.home, '.hermes'), '.env');
+    const configuredOrigins = await readAllowedOrigins(envFile, dependencies.readTextFile);
+    const unrestricted = installed && configuredOrigins === undefined;
+    const origins = mergeAllowedOrigins(configuredOrigins ?? [], origin);
+    if (installed && (unrestricted || origins.length === configuredOrigins?.length)) {
+        return {
+            ...base,
+            guidance: [
+                unrestricted
+                    ? 'hermes-mpp is enabled without an origin allowlist.'
+                    : 'Use mpp_fetch to POST paid jobs to the Mercator REST endpoint.',
+            ],
+            status: 'ready',
+        };
+    }
+    const args = [
+        'hermes-mpp',
+        'install',
+        ...origins.flatMap((allowedOrigin) => ['--allowed-origin', allowedOrigin]),
+    ];
+    const command = `uvx ${args.map(shellQuote).join(' ')}`;
+    if (options.dryRun)
+        return { ...base, guidance: [command], status: 'planned' };
+    const uvxAvailable = await dependencies.commandAvailable('uvx');
+    if (!uvxAvailable || !dependencies.interactive) {
+        return { ...base, guidance: [command], status: 'action_required' };
+    }
+    await dependencies.runInteractive('uvx', args);
+    const verified = await dependencies.runCaptured('hermes', ['plugins', 'list']);
+    return {
+        ...base,
+        guidance: verified.code === 0 && /\bmpp\b.*\benabled\b/im.test(verified.output)
+            ? ['Use mpp_fetch to POST paid jobs to the Mercator REST endpoint.']
+            : [command],
+        status: verified.code === 0 && /\bmpp\b.*\benabled\b/im.test(verified.output)
+            ? 'ready'
+            : 'action_required',
+    };
+}
+function shellQuote(value) {
+    return /^[A-Za-z0-9_./:@-]+$/.test(value)
+        ? value
+        : `'${value.replaceAll("'", `'\\''`)}'`;
+}
+async function readAllowedOrigins(path, readTextFile) {
+    try {
+        return parseAllowedOrigins(await readTextFile(path));
+    }
+    catch (error) {
+        if (typeof error === 'object' &&
+            error !== null &&
+            'code' in error &&
+            error.code === 'ENOENT') {
+            return undefined;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=native-payments.js.map

package/dist/native-payments.js.map

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

package/dist/plugin-bundle/.codex-plugin/plugin.json

@@ -0,0 +1,35 @@
+{
+	"name": "mercator",
+	"version": "0.1.0+codex.20260826165140",
+	"description": "Discover, live-price, and run current-data and API workflows through Mercator. Powered by MPP.",
+	"author": {
+		"name": "Tempo",
+		"url": "https://tempo.xyz/"
+	},
+	"homepage": "https://mercator.tempoxyz.dev/",
+	"repository": "https://github.com/tempoxyz/mercator",
+	"keywords": ["api", "current data", "mercator", "mcp", "paid services", "tempo"],
+	"mcpServers": "./.mcp.json",
+	"interface": {
+		"displayName": "Mercator",
+		"shortDescription": "Discover and run paid API workflows, powered by MPP",
+		"longDescription": "Find current-data and API services, get live quotes, and execute durable paid workflows through one MCP gateway. Powered by MPP.",
+		"developerName": "Tempo",
+		"category": "Productivity",
+		"capabilities": ["Interactive", "Read", "Write"],
+		"websiteURL": "https://mercator.tempoxyz.dev/",
+		"defaultPrompt": [
+			"Rescue my canceled Boston-to-London flight under $1,200; add a hotel and transfer if needed, then email the itinerary.",
+			"Find 15 overlooked Boston HVAC businesses, verify owner emails, flag outdated sites, and map a route from Back Bay.",
+			"Investigate unusual AAVE activity across smart-money flows, holders, price, news, and regulation; return a sourced chart."
+		],
+		"brandColor": "#1D4FFF",
+		"composerIcon": "./assets/favicon.svg",
+		"logo": "./assets/favicon.svg",
+		"screenshots": [
+			"./assets/mercator-overview.png",
+			"./assets/workflow-composition.png",
+			"./assets/service-network.png"
+		]
+	}
+}

package/dist/plugin-bundle/.mcp.json

@@ -0,0 +1,9 @@
+{
+	"mcpServers": {
+		"mercator": {
+			"type": "http",
+			"url": "https://mercator.tempoxyz.dev/mcp",
+			"note": "Mercator service discovery, live quotes, durable paid jobs, and product feedback."
+		}
+	}
+}

package/dist/plugin-bundle/README.md

@@ -0,0 +1,26 @@
+# Mercator plugin
+
+Use Mercator from Codex or ChatGPT without configuring an agent CLI MCP client. The plugin connects
+to the production Streamable HTTP server at `https://mercator.tempoxyz.dev/mcp`.
+
+## Test from this repository
+
+From the repository root:
+
+```sh
+codex plugin marketplace add "$PWD"
+codex plugin add mercator@personal
+```
+
+Refresh Codex or ChatGPT, enable Mercator in the Plugins directory, and start a new task. Local
+marketplace installation is for development; desktop-only distribution requires publishing this
+bundle to the universal plugin directory.
+
+## Package contents
+
+- `.codex-plugin/plugin.json`: plugin metadata and capability declaration.
+- `.mcp.json`: production Mercator remote MCP connection.
+- `assets/favicon.svg`: the exact Mercator globe used by the site favicon.
+
+The remote server provides activation and workflow instructions during MCP initialization, so this
+bundle intentionally does not duplicate the maintained server contract in a local skill.

package/dist/plugin-bundle/assets/favicon.svg

@@ -0,0 +1,7 @@
+<svg width="32" height="32" viewBox="0 0 782 782" fill="none" xmlns="http://www.w3.org/2000/svg">
+	<title>Mercator</title>
+	<circle cx="391" cy="391" r="386" stroke="#0B0B0B" stroke-width="10" />
+	<ellipse cx="391" cy="391" rx="262" ry="386" stroke="#0B0B0B" stroke-width="10" />
+	<ellipse cx="391" cy="391" rx="101" ry="386" stroke="#0B0B0B" stroke-width="10" />
+	<ellipse cx="391" cy="391" rx="386" ry="101" stroke="#0B0B0B" stroke-width="10" />
+</svg>

package/dist/setup-progress.d.ts

@@ -0,0 +1,13 @@
+import { type GlobeAnimation } from './globe.js';
+/** Terminal progress renderer shared by the complete setup lifecycle. */
+export type SetupProgress = {
+    readonly globe: GlobeAnimation;
+    readonly report: (message: string) => void;
+    readonly stop: () => Promise<void>;
+};
+/** Starts one globe and writes setup progress beneath it without disrupting redraws. */
+export declare function startSetupProgress(output: NodeJS.WritableStream, options: {
+    readonly animate: boolean;
+}): SetupProgress;
+/** Starts animated setup progress when stdout is an interactive terminal. */
+export declare function startTerminalSetupProgress(): SetupProgress | undefined;

package/dist/setup-progress.js

@@ -0,0 +1,22 @@
+import { startMercatorGlobe } from './globe.js';
+/** Starts one globe and writes setup progress beneath it without disrupting redraws. */
+export function startSetupProgress(output, options) {
+    const globe = startMercatorGlobe(output, options);
+    return {
+        globe,
+        report: (message) => {
+            output.write(`  ${message}\n`);
+            globe.addLinesBelow(1);
+        },
+        stop: globe.stop,
+    };
+}
+/** Starts animated setup progress when stdout is an interactive terminal. */
+export function startTerminalSetupProgress() {
+    if (!process.stdout.isTTY)
+        return undefined;
+    return startSetupProgress(process.stdout, {
+        animate: process.env.CI === undefined && process.env.TERM !== 'dumb',
+    });
+}
+//# sourceMappingURL=setup-progress.js.map

package/dist/setup-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-progress.js","sourceRoot":"","sources":["../src/setup-progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,kBAAkB,EAAE,MAAM,YAAY,CAAA;AASpE,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CACjC,MAA6B,EAC7B,OAAsC;IAEtC,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjD,OAAO;QACN,KAAK;QACL,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,IAAI,CAAC,CAAA;YAC9B,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;QACvB,CAAC;QACD,IAAI,EAAE,KAAK,CAAC,IAAI;KAChB,CAAA;AACF,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,0BAA0B;IACzC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAC3C,OAAO,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE;QACzC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM;KACpE,CAAC,CAAA;AACH,CAAC"}

package/dist/submit.d.ts

@@ -0,0 +1,15 @@
+import { createPaymentProvider } from './wallet.js';
+/** Inputs carried by the bounded paid-job handoff. */
+export type SubmitOptions = {
+    body: string;
+    maxSpend: string;
+    url: string;
+};
+type SubmitDependencies = {
+    createPaymentProvider: typeof createPaymentProvider;
+    fetch: typeof globalThis.fetch;
+    timeoutMs: number;
+};
+/** Executes the bounded direct-charge REST handoff returned by Mercator MCP. */
+export declare function submitPaidJob(options: SubmitOptions, overrides?: Partial<SubmitDependencies>): Promise<unknown>;
+export {};

package/dist/submit.js

@@ -0,0 +1,127 @@
+import { Challenge } from 'mppx';
+import { parseUnits } from 'viem';
+import { createPaymentProvider } from './wallet.js';
+/** Mercator's mainnet billing token (USDC.e). */
+const BILLING_CURRENCY = '0x20c000000000000000000000b9537d11c60e8b50';
+/** Tempo mainnet, the only chain accepted by the handoff. */
+const CHAIN_ID = 4217;
+/** Maximum wait for either Mercator jobs request. */
+const SUBMIT_TIMEOUT_MS = 30_000;
+/** Process-backed submission dependencies used outside tests. */
+const defaultDependencies = {
+    createPaymentProvider,
+    fetch: globalThis.fetch,
+    timeoutMs: SUBMIT_TIMEOUT_MS,
+};
+/** Executes the bounded direct-charge REST handoff returned by Mercator MCP. */
+export async function submitPaidJob(options, overrides = {}) {
+    const dependencies = { ...defaultDependencies, ...overrides };
+    const body = parseBody(options.body);
+    assertJobBody(body);
+    const challenge = await fetchJob(dependencies.fetch, options.url, options.body, dependencies.timeoutMs);
+    if (challenge.status !== 402)
+        return responseBody(challenge);
+    assertChallengeSpend(challenge, options.maxSpend);
+    const wallet = await dependencies.createPaymentProvider(replayChallenge(dependencies.fetch, options.url, challenge));
+    const response = await fetchJob(wallet.fetch, options.url, options.body, dependencies.timeoutMs);
+    return responseBody(response);
+}
+async function fetchJob(fetch, url, body, timeoutMs) {
+    const signal = AbortSignal.timeout(timeoutMs);
+    try {
+        return await fetch(url, {
+            body,
+            headers: {
+                Accept: 'application/json',
+                'Accept-Payment': 'tempo/charge',
+                'Content-Type': 'application/json',
+            },
+            method: 'POST',
+            signal,
+        });
+    }
+    catch (error) {
+        if (signal.aborted) {
+            throw new Error('Mercator submission timed out. Retry with the same idempotency key.');
+        }
+        throw error;
+    }
+}
+function replayChallenge(fetch, url, challenge) {
+    let pending = true;
+    return async (input, init) => {
+        const request = new Request(input, init);
+        if (pending && request.method === 'POST' && request.url === url) {
+            pending = false;
+            return challenge.clone();
+        }
+        return fetch(input, init);
+    };
+}
+function parseBody(json) {
+    try {
+        const body = JSON.parse(json);
+        if (body && typeof body === 'object' && !Array.isArray(body)) {
+            return body;
+        }
+    }
+    catch { }
+    throw new Error('--body must contain a JSON object.');
+}
+function assertJobBody(body) {
+    const plan = body.plan;
+    if (!plan || typeof plan !== 'object' || Array.isArray(plan)) {
+        throw new Error('The handoff JSON is missing its plan.');
+    }
+}
+function assertChallengeSpend(response, maxSpend) {
+    let request;
+    try {
+        request = Challenge.fromResponseList(response).find((challenge) => challenge.method === 'tempo' && challenge.intent === 'charge')?.request;
+    }
+    catch {
+        throw new Error('Mercator returned an invalid direct-charge challenge.');
+    }
+    if (!request)
+        throw new Error('Mercator did not offer the required direct charge.');
+    if (!request || typeof request !== 'object' || Array.isArray(request)) {
+        throw new Error('Mercator returned an invalid direct-charge challenge.');
+    }
+    const payment = request;
+    const details = payment.methodDetails;
+    if (typeof payment.amount !== 'string' ||
+        !/^\d+$/.test(payment.amount) ||
+        typeof payment.currency !== 'string' ||
+        payment.currency.toLowerCase() !== BILLING_CURRENCY ||
+        !details ||
+        typeof details !== 'object' ||
+        Array.isArray(details) ||
+        details.chainId !== CHAIN_ID) {
+        throw new Error('Mercator returned an unexpected direct-charge challenge.');
+    }
+    if (BigInt(payment.amount) > units(maxSpend)) {
+        throw new Error('Mercator direct charge exceeds --max-spend.');
+    }
+}
+function units(amount) {
+    try {
+        if (!/^\d+(?:\.\d{1,6})?$/.test(amount))
+            throw new Error('invalid amount');
+        return parseUnits(amount, 6);
+    }
+    catch {
+        throw new Error('Expected a non-negative decimal --max-spend with at most 6 decimals.');
+    }
+}
+async function responseBody(response) {
+    if (!response.ok)
+        throw new Error(`Mercator submission failed (${response.status}).`);
+    const text = await response.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=submit.js.map

package/dist/submit.js.map

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

package/dist/wallet.d.ts

@@ -0,0 +1,77 @@
+import { Provider } from 'accounts';
+import { type Address } from 'viem';
+/** Mercator-owned wallet implementations. */
+export declare const WalletProvider: {
+    readonly Local: "local";
+    readonly Tempo: "tempo";
+};
+/** Wallet implementation selected for Mercator payments. */
+export type WalletProvider = (typeof WalletProvider)[keyof typeof WalletProvider];
+/** Stable wallet readiness states exposed by setup and doctor. */
+type WalletStatus = 'needs_account' | 'needs_funding' | 'needs_login' | 'ready';
+/** Ordered payment-token balances shown only by explicit wallet commands. */
+type WalletBalances = {
+    machineUSD: string;
+    pathUSD: string;
+    'USDC.e': string;
+};
+/** Local wallet readiness report, including balances when an account is available. */
+export type WalletReport = {
+    address?: Address;
+    balances?: WalletBalances;
+    guidance: string[];
+    provider?: WalletProvider;
+    sessionClient: 'ready' | 'unavailable';
+    status: WalletStatus;
+};
+/** Signals that payment requires explicit wallet setup before retrying. */
+export declare class WalletRequiredError extends Error {
+    readonly code = "WALLET_REQUIRED";
+    constructor(message?: string);
+}
+type AccountState = {
+    address?: Address;
+    balances?: WalletBalances;
+    funded: boolean;
+    usable: boolean;
+};
+type PaymentAuthorizationProvider = {
+    getAccessKeyStatus: Provider.Provider['getAccessKeyStatus'];
+    store: unknown;
+};
+type WalletDependencies = {
+    activeProvider: () => Promise<WalletProvider | undefined>;
+    chooseProvider: () => Promise<WalletProvider>;
+    connectTempo: () => Promise<AccountState>;
+    createLocal: () => Promise<AccountState>;
+    inspect: (provider: WalletProvider) => Promise<AccountState>;
+    interactive: boolean;
+    openUrl: (url: string) => Promise<void>;
+    setActiveProvider: (provider: WalletProvider) => Promise<void>;
+};
+type WalletSetupOptions = {
+    action?: 'connect' | 'create';
+    dryRun?: boolean;
+};
+type FundingPageDependencies = Pick<WalletDependencies, 'openUrl'>;
+/** Result of attempting to open the Mercator funding page. */
+export type FundingPageResult = {
+    opened: boolean;
+    url: string;
+};
+/** Inspects Mercator wallet state without creating or reconnecting an account. */
+export declare function inspectWallet(overrides?: Partial<WalletDependencies>): Promise<WalletReport>;
+/** Creates a local disk wallet or connects Tempo Wallet through the Accounts SDK. */
+export declare function setupWallet(options?: WalletSetupOptions, overrides?: Partial<WalletDependencies>): Promise<WalletReport>;
+/** Creates an Accounts provider for the active Mercator payment wallet. */
+export declare function createPaymentProvider(baseFetch?: typeof globalThis.fetch): Promise<{
+    address: Address;
+    fetch: typeof globalThis.fetch;
+    provider: PaymentAuthorizationProvider;
+}>;
+/** Returns the Mercator funding page for a wallet address. */
+export declare function fundingUrl(address: Address, origin?: string): string;
+/** Checks whether a stored Tempo key can spend a supported Mercator payment token. */
+export declare function hasPaymentAuthorization(provider: PaymentAuthorizationProvider, address: Address): Promise<boolean>;
+export declare function openFundingPage(address: Address, overrides?: Partial<FundingPageDependencies>): Promise<FundingPageResult>;
+export {};