@tempoxyz/mercator 0.0.569 → 0.0.572
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/activation.generated.d.ts +1 -1
- package/dist/activation.generated.js +3 -0
- package/dist/activation.generated.js.map +1 -1
- package/dist/agents.d.ts +1 -1
- package/dist/binary.js +12 -0
- package/dist/binary.js.map +1 -1
- package/dist/plugin-bundle/skills/mercator/SKILL.md +4 -1
- package/dist/plugin-bundle/skills/mercator-setup/SKILL.md +69 -0
- package/dist/plugin-bundle/skills/mercator-setup/agents/openai.yaml +4 -0
- package/package.json +1 -1
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
/** Canonical activation guidance shared with the distributed Mercator skill. */
|
|
2
|
-
export declare const MERCATOR_ACTIVATION_GUIDANCE = "Mercator is the gateway for fresh third-party data and API actions. Start with Mercator when an\noutcome needs external capabilities, especially when it spans providers or domains. If an installed\ndirect tool clearly covers the complete outcome with less overhead, use it. Otherwise, carry the\nrequest through Mercator to a result instead of merely recommending a provider or API.\n\n### Decide quickly\n\nUse Mercator when all are true:\n\n- The outcome needs fresh external information or an API action.\n- Mercator can satisfy the outcome or combine the required capabilities.\n- The user has not forbidden external or paid services.\n\nCommon fits include multi-source research, web extraction, enrichment, social data, maps, travel,\ncommunications, media, financial data, and on-chain data. Do not use it for local or repository\nwork, or to reason over content the user already supplied.\n\nDo not skip Mercator merely because the provider or domain is unfamiliar. Search is free and is the\nfastest way to determine whether Mercator can complete the request.";
|
|
2
|
+
export declare const MERCATOR_ACTIVATION_GUIDANCE = "Mercator is the gateway for fresh third-party data and API actions. Start with Mercator when an\noutcome needs external capabilities, especially when it spans providers or domains. If an installed\ndirect tool clearly covers the complete outcome with less overhead, use it. Otherwise, carry the\nrequest through Mercator to a result instead of merely recommending a provider or API.\n\nFor installation, OAuth connection, missing tools, or readiness troubleshooting, use the\n`mercator-setup` skill when available. Setup uses free diagnostics; it does not require a paid job.\n\n### Decide quickly\n\nUse Mercator when all are true:\n\n- The outcome needs fresh external information or an API action.\n- Mercator can satisfy the outcome or combine the required capabilities.\n- The user has not forbidden external or paid services.\n\nCommon fits include multi-source research, web extraction, enrichment, social data, maps, travel,\ncommunications, media, financial data, and on-chain data. Do not use it for local or repository\nwork, or to reason over content the user already supplied.\n\nDo not skip Mercator merely because the provider or domain is unfamiliar. Search is free and is the\nfastest way to determine whether Mercator can complete the request.";
|
|
@@ -5,6 +5,9 @@ outcome needs external capabilities, especially when it spans providers or domai
|
|
|
5
5
|
direct tool clearly covers the complete outcome with less overhead, use it. Otherwise, carry the
|
|
6
6
|
request through Mercator to a result instead of merely recommending a provider or API.
|
|
7
7
|
|
|
8
|
+
For installation, OAuth connection, missing tools, or readiness troubleshooting, use the
|
|
9
|
+
\`mercator-setup\` skill when available. Setup uses free diagnostics; it does not require a paid job.
|
|
10
|
+
|
|
8
11
|
### Decide quickly
|
|
9
12
|
|
|
10
13
|
Use Mercator when all are true:
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"activation.generated.js","sourceRoot":"","sources":["../src/activation.generated.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,MAAM,CAAC,MAAM,4BAA4B,GAAG
|
|
1
|
+
{"version":3,"file":"activation.generated.js","sourceRoot":"","sources":["../src/activation.generated.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;oEAqBwB,CAAA"}
|
package/dist/agents.d.ts
CHANGED
|
@@ -3,7 +3,7 @@ export declare const MERCATOR_AGENTS_BEGIN = "<!-- mercator:begin \u2014 managed
|
|
|
3
3
|
/** Closing boundary for installer-managed Mercator guidance. */
|
|
4
4
|
export declare const MERCATOR_AGENTS_END = "<!-- mercator:end -->";
|
|
5
5
|
/** Durable, budget-aware activation guidance installed for Codex. */
|
|
6
|
-
export declare const MERCATOR_AGENTS_BLOCK = "<!-- mercator:begin \u2014 managed by mercator-cli; edits inside will be overwritten -->\n## Mercator\n\nMercator is the gateway for fresh third-party data and API actions. Start with Mercator when an\noutcome needs external capabilities, especially when it spans providers or domains. If an installed\ndirect tool clearly covers the complete outcome with less overhead, use it. Otherwise, carry the\nrequest through Mercator to a result instead of merely recommending a provider or API.\n\n### Decide quickly\n\nUse Mercator when all are true:\n\n- The outcome needs fresh external information or an API action.\n- Mercator can satisfy the outcome or combine the required capabilities.\n- The user has not forbidden external or paid services.\n\nCommon fits include multi-source research, web extraction, enrichment, social data, maps, travel,\ncommunications, media, financial data, and on-chain data. Do not use it for local or repository\nwork, or to reason over content the user already supplied.\n\nDo not skip Mercator merely because the provider or domain is unfamiliar. Search is free and is the\nfastest way to determine whether Mercator can complete the request.\n\n### Execution\n\n- Search with `search_services` using the user's complete intended outcome. Discovery and `quote_plan` are free.\n- With hosted OAuth, the connected access key authorizes spending within its signed limits; do not ask for per-job spend approval. Respect any explicit user budget. Legacy MCP challenge clients need quote approval or a sufficient explicit budget before paid execution or REST fallback, including after a price change.\n- After quoting, call `create_job` once with a stable idempotency key and poll `get_job`. If MCP submission and one retry both fail, a host with an already-ready local Mercator wallet may make the equivalent bounded REST submission. Never install or create a wallet for fallback.\n- Never request or expose private keys or provider credentials.\n<!-- mercator:end -->";
|
|
6
|
+
export declare const MERCATOR_AGENTS_BLOCK = "<!-- mercator:begin \u2014 managed by mercator-cli; edits inside will be overwritten -->\n## Mercator\n\nMercator is the gateway for fresh third-party data and API actions. Start with Mercator when an\noutcome needs external capabilities, especially when it spans providers or domains. If an installed\ndirect tool clearly covers the complete outcome with less overhead, use it. Otherwise, carry the\nrequest through Mercator to a result instead of merely recommending a provider or API.\n\nFor installation, OAuth connection, missing tools, or readiness troubleshooting, use the\n`mercator-setup` skill when available. Setup uses free diagnostics; it does not require a paid job.\n\n### Decide quickly\n\nUse Mercator when all are true:\n\n- The outcome needs fresh external information or an API action.\n- Mercator can satisfy the outcome or combine the required capabilities.\n- The user has not forbidden external or paid services.\n\nCommon fits include multi-source research, web extraction, enrichment, social data, maps, travel,\ncommunications, media, financial data, and on-chain data. Do not use it for local or repository\nwork, or to reason over content the user already supplied.\n\nDo not skip Mercator merely because the provider or domain is unfamiliar. Search is free and is the\nfastest way to determine whether Mercator can complete the request.\n\n### Execution\n\n- Search with `search_services` using the user's complete intended outcome. Discovery and `quote_plan` are free.\n- With hosted OAuth, the connected access key authorizes spending within its signed limits; do not ask for per-job spend approval. Respect any explicit user budget. Legacy MCP challenge clients need quote approval or a sufficient explicit budget before paid execution or REST fallback, including after a price change.\n- After quoting, call `create_job` once with a stable idempotency key and poll `get_job`. If MCP submission and one retry both fail, a host with an already-ready local Mercator wallet may make the equivalent bounded REST submission. Never install or create a wallet for fallback.\n- Never request or expose private keys or provider credentials.\n<!-- mercator:end -->";
|
|
7
7
|
/** Options controlling where and whether Codex guidance is written. */
|
|
8
8
|
export type CodexAgentsInstallOptions = {
|
|
9
9
|
codexHome?: string;
|
package/dist/binary.js
CHANGED
|
@@ -26,12 +26,21 @@ import portablePluginManifest from '../../../plugins/mercator/plugin.json' with
|
|
|
26
26
|
type: 'file'
|
|
27
27
|
};
|
|
28
28
|
import pluginReadme from '../../../plugins/mercator/README.md' with { type: 'file' };
|
|
29
|
+
import mercatorSkillMetadata from '../../../plugins/mercator/skills/mercator/agents/openai.yaml' with {
|
|
30
|
+
type: 'file'
|
|
31
|
+
};
|
|
29
32
|
import mercatorSkillExamples from '../../../plugins/mercator/skills/mercator/references/examples.md' with {
|
|
30
33
|
type: 'file'
|
|
31
34
|
};
|
|
32
35
|
import mercatorSkill from '../../../plugins/mercator/skills/mercator/SKILL.md' with {
|
|
33
36
|
type: 'file'
|
|
34
37
|
};
|
|
38
|
+
import setupSkillMetadata from '../../../plugins/mercator/skills/mercator-setup/agents/openai.yaml' with {
|
|
39
|
+
type: 'file'
|
|
40
|
+
};
|
|
41
|
+
import setupSkill from '../../../plugins/mercator/skills/mercator-setup/SKILL.md' with {
|
|
42
|
+
type: 'file'
|
|
43
|
+
};
|
|
35
44
|
import { inspectCodexPlugin, installCodexPlugin, run } from './index.js';
|
|
36
45
|
/** Complete plugin payload required by default Mercator setup. */
|
|
37
46
|
const embeddedPluginFiles = [
|
|
@@ -52,6 +61,7 @@ const embeddedPluginFiles = [
|
|
|
52
61
|
{ source: portablePluginManifest, target: 'plugin.json' },
|
|
53
62
|
{ source: pluginReadme, target: 'README.md' },
|
|
54
63
|
{ source: mercatorSkill, target: 'skills/mercator/SKILL.md' },
|
|
64
|
+
{ source: mercatorSkillMetadata, target: 'skills/mercator/agents/openai.yaml' },
|
|
55
65
|
{
|
|
56
66
|
source: mercatorSkillExamples,
|
|
57
67
|
target: 'skills/mercator/references/examples.md',
|
|
@@ -60,6 +70,8 @@ const embeddedPluginFiles = [
|
|
|
60
70
|
{ source: overview, target: 'assets/mercator-overview.png' },
|
|
61
71
|
{ source: serviceNetwork, target: 'assets/service-network.png' },
|
|
62
72
|
{ source: workflowComposition, target: 'assets/workflow-composition.png' },
|
|
73
|
+
{ source: setupSkill, target: 'skills/mercator-setup/SKILL.md' },
|
|
74
|
+
{ source: setupSkillMetadata, target: 'skills/mercator-setup/agents/openai.yaml' },
|
|
63
75
|
];
|
|
64
76
|
/** Materializes Bun-embedded plugin assets for the existing filesystem installer boundary. */
|
|
65
77
|
async function materializePluginBundle() {
|
package/dist/binary.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"binary.js","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,oBAAoB,MAAM,sDAAsD,CAAC;IACvF,IAAI,EAAE,MAAM;CACZ,CAAA;AACD,OAAO,mBAAmB,MAAM,qDAAqD,CAAC;IACrF,IAAI,EAAE,MAAM;CACZ,CAAA;AACD,OAAO,oBAAoB,MAAM,sDAAsD,CAAC;IACvF,IAAI,EAAE,MAAM;CACZ,CAAA;AACD,OAAO,cAAc,MAAM,qCAAqC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACtF,OAAO,OAAO,MAAM,8CAA8C,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACxF,OAAO,QAAQ,MAAM,wDAAwD,CAAC;IAC7E,IAAI,EAAE,MAAM;CACZ,CAAA;AACD,OAAO,cAAc,MAAM,sDAAsD,CAAC;IACjF,IAAI,EAAE,MAAM;CACZ,CAAA;AACD,OAAO,mBAAmB,MAAM,2DAA2D,CAAC;IAC3F,IAAI,EAAE,MAAM;CACZ,CAAA;AACD,OAAO,iBAAiB,MAAM,oCAAoC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACxF,OAAO,sBAAsB,MAAM,uCAAuC,CAAC;IAC1E,IAAI,EAAE,MAAM;CACZ,CAAA;AACD,OAAO,YAAY,MAAM,qCAAqC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACpF,OAAO,qBAAqB,MAAM,kEAAkE,CAAC;IACpG,IAAI,EAAE,MAAM;CACZ,CAAA;AACD,OAAO,aAAa,MAAM,oDAAoD,CAAC;IAC9E,IAAI,EAAE,MAAM;CACZ,CAAA;AACD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAQxE,kEAAkE;AAClE,MAAM,mBAAmB,GAAkC;IAC1D;QACC,MAAM,EAAE,oBAAyC;QACjD,MAAM,EAAE,4BAA4B;KACpC;IACD;QACC,MAAM,EAAE,mBAAwC;QAChD,MAAM,EAAE,2BAA2B;KACnC;IACD;QACC,MAAM,EAAE,oBAAyC;QACjD,MAAM,EAAE,4BAA4B;KACpC;IACD,EAAE,MAAM,EAAE,cAAmC,EAAE,MAAM,EAAE,WAAW,EAAE;IACpE,EAAE,MAAM,EAAE,iBAAsC,EAAE,MAAM,EAAE,UAAU,EAAE;IACtE,EAAE,MAAM,EAAE,sBAA2C,EAAE,MAAM,EAAE,aAAa,EAAE;IAC9E,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE;IAC7C,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,0BAA0B,EAAE;IAC7D;QACC,MAAM,EAAE,qBAAqB;QAC7B,MAAM,EAAE,wCAAwC;KAChD;IACD,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE;IACjD,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,8BAA8B,EAAE;IAC5D,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,4BAA4B,EAAE;IAChE,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,iCAAiC,EAAE;
|
|
1
|
+
{"version":3,"file":"binary.js","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: mercator
|
|
3
|
-
description: Use Mercator to discover, quote, and run fresh external research or API actions across extraction, enrichment, social, maps, travel, communications, media, financial, and on-chain data. Covers MCP job submission, durable status tracking, and recovery; not for local files, repository work, supplied-content reasoning, or requests that forbid external or paid services.
|
|
3
|
+
description: Use Mercator to discover, quote, and run fresh external research or API actions across extraction, enrichment, social, maps, travel, communications, media, financial, and on-chain data. Covers MCP job submission, durable status tracking, and recovery; not for installation or connection troubleshooting (mercator-setup), local files, repository work, supplied-content reasoning, or requests that forbid external or paid services.
|
|
4
4
|
license: MIT
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -11,6 +11,9 @@ outcome needs external capabilities, especially when it spans providers or domai
|
|
|
11
11
|
direct tool clearly covers the complete outcome with less overhead, use it. Otherwise, carry the
|
|
12
12
|
request through Mercator to a result instead of merely recommending a provider or API.
|
|
13
13
|
|
|
14
|
+
For installation, OAuth connection, missing tools, or readiness troubleshooting, use the
|
|
15
|
+
`mercator-setup` skill when available. Setup uses free diagnostics; it does not require a paid job.
|
|
16
|
+
|
|
14
17
|
## Decide quickly
|
|
15
18
|
|
|
16
19
|
Use Mercator when all are true:
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: mercator-setup
|
|
3
|
+
description: Install, connect, or troubleshoot Mercator in agent clients. Use for plugin setup, OAuth authorization, missing tools, connection diagnostics, and wallet funding readiness. For discovery and paid API execution on a working connection, use mercator.
|
|
4
|
+
license: MIT
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Mercator setup
|
|
8
|
+
|
|
9
|
+
Connect the user's chosen agent client to Mercator and verify transport, discovery, and payment
|
|
10
|
+
readiness separately. Setup itself does not require a paid job or a local wallet.
|
|
11
|
+
|
|
12
|
+
## Choose the setup path
|
|
13
|
+
|
|
14
|
+
- **Plugin already installed:** inspect the client's MCP connection and complete its native
|
|
15
|
+
**Authorize** action. Reload the plugin or start a new session if tools are missing. Do not
|
|
16
|
+
install a second copy merely because authorization is incomplete.
|
|
17
|
+
- **Local client, CLI available:** run `mercator status`, then `mercator setup` for installation
|
|
18
|
+
or repair. Honor the user's client choice with `--client`; inspect `mercator setup --help`
|
|
19
|
+
for supported values. Interactive setup selects detected clients; preserve unrelated clients.
|
|
20
|
+
- **Local client, CLI absent:** use the canonical standalone installer below. It installs the CLI
|
|
21
|
+
and starts setup without requiring Node.js. Pass `--client` when the user chose a client.
|
|
22
|
+
- **Managed or cloud host:** use its native plugin and OAuth controls. Installing a CLI in an
|
|
23
|
+
agent container does not configure the user's desktop client.
|
|
24
|
+
- **Other MCP client:** `mercator setup --manual` prints configuration guidance without modifying
|
|
25
|
+
integrations. Configure Streamable HTTP at `https://mercator.tempo.xyz/mcp/auth` and finish
|
|
26
|
+
OAuth in that client. If client registration is required, read
|
|
27
|
+
[Mercator authentication](https://mercator.tempo.xyz/auth.md).
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
curl -fsSL https://mercator.sh/install.sh | sh
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
For a selected client, append setup arguments with `sh -s -- --client <client>`.
|
|
34
|
+
Grok CLI authorization is handled by `mercator setup --client grok`; it uses browser OAuth with
|
|
35
|
+
loopback PKCE. Use `--force` only when the registration needs replacing. OpenClaw and Hermes use
|
|
36
|
+
runtime-native MPP wallets and the legacy `/mcp` endpoint; retain their setup-managed configuration.
|
|
37
|
+
|
|
38
|
+
## Verify without spending
|
|
39
|
+
|
|
40
|
+
1. Inspect native MCP status. If the CLI is available, run `mercator doctor`. A valid OAuth
|
|
41
|
+
challenge proves transport availability, not successful authorization or paid readiness.
|
|
42
|
+
2. Complete browser authorization if needed. The user chooses wallet access limits and expiry;
|
|
43
|
+
never request a wallet key or copy OAuth tokens into chat or commands.
|
|
44
|
+
3. On the connected server, call the free `search_services` tool with a simple data lookup to
|
|
45
|
+
verify discovery. Do not submit a job as a connection test.
|
|
46
|
+
4. Call `get_connection_status` to inspect hosted authorization, token balances, access-key
|
|
47
|
+
expiry/status, and remaining limits. Unavailable chain reads mean unknown, not zero. A `ready`
|
|
48
|
+
key can make its first payment using its signed grant ceiling before live limits activate.
|
|
49
|
+
`oauthAuthenticated: false` identifies the legacy payment-challenge path, not a hosted grant.
|
|
50
|
+
|
|
51
|
+
Report what was verified and what still needs user action. Zero funding or zero spending authority
|
|
52
|
+
can coexist with successful connection and discovery. Once connected, use the `mercator` skill for
|
|
53
|
+
requested research or API execution.
|
|
54
|
+
|
|
55
|
+
## Troubleshoot the failed layer
|
|
56
|
+
|
|
57
|
+
| Symptom | Next action |
|
|
58
|
+
| --- | --- |
|
|
59
|
+
| Plugin or server missing | Check the selected client's registration with native controls or `mercator status`; rerun targeted setup when absent. |
|
|
60
|
+
| Tools missing after install | Reload the plugin or start a fresh session; inspect the client's MCP status. |
|
|
61
|
+
| HTTP 401 or authorization pending | Complete native browser authorization; for Grok CLI, rerun its targeted setup. |
|
|
62
|
+
| Discovery not verified | Resolve transport or OAuth first, then retry the free search probe. |
|
|
63
|
+
| Search works, paid execution unavailable | Inspect connection status for funding, expiry, revocation, and token limits. |
|
|
64
|
+
| Unfunded authorized token | Open `https://mercator.tempo.xyz/account` or use `fund_wallet` when available; the user chooses the funding amount. |
|
|
65
|
+
| Expired/revoked key or insufficient authority | Manage the grant in Account and reconnect through OAuth for user-selected limits. |
|
|
66
|
+
| Setup failure persists | Run `mercator setup --client <client> --verbose` for the affected client and inspect its bounded diagnostics. |
|
|
67
|
+
|
|
68
|
+
Do not install or create a local payment wallet to repair hosted OAuth. Never include credentials,
|
|
69
|
+
OAuth codes, payment material, or raw provider data in diagnostics shared with others.
|