@maind-dev/mcp-bridge 0.1.0 → 0.3.0
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/README.md +19 -0
- package/build/client-detect.js +105 -0
- package/build/client-detect.js.map +1 -0
- package/build/forward.js +67 -0
- package/build/forward.js.map +1 -1
- package/build/index.js +47 -1
- package/build/index.js.map +1 -1
- package/build/install/atomic-write.js +115 -0
- package/build/install/atomic-write.js.map +1 -0
- package/build/install/browser-pair.js +139 -0
- package/build/install/browser-pair.js.map +1 -0
- package/build/install/client-targets.js +135 -0
- package/build/install/client-targets.js.map +1 -0
- package/build/install/flags.js +139 -0
- package/build/install/flags.js.map +1 -0
- package/build/install/hook-merge.js +195 -0
- package/build/install/hook-merge.js.map +1 -0
- package/build/install/index.js +187 -0
- package/build/install/index.js.map +1 -0
- package/build/install/json-merge.js +160 -0
- package/build/install/json-merge.js.map +1 -0
- package/build/install/preamble.js +119 -0
- package/build/install/preamble.js.map +1 -0
- package/build/install/project-root.js +120 -0
- package/build/install/project-root.js.map +1 -0
- package/build/install/report.js +89 -0
- package/build/install/report.js.map +1 -0
- package/build/install/telemetry.js +83 -0
- package/build/install/telemetry.js.map +1 -0
- package/build/install/toml-merge.js +148 -0
- package/build/install/toml-merge.js.map +1 -0
- package/build/version.js +1 -1
- package/package.json +13 -10
package/README.md
CHANGED
|
@@ -44,6 +44,23 @@ Add this to your MCP client's config (`.mcp.json` or equivalent):
|
|
|
44
44
|
}
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
+
If you want maind to attribute calls to the real upstream agent while still
|
|
48
|
+
using the bridge transport, add a client marker via env:
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"mcpServers": {
|
|
53
|
+
"maind": {
|
|
54
|
+
"command": "npx",
|
|
55
|
+
"args": ["-y", "@maind-dev/mcp-bridge"],
|
|
56
|
+
"env": {
|
|
57
|
+
"MAIND_CLIENT_FAMILY": "codex"
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
47
64
|
Restart the MCP client. The first invocation walks you through the device
|
|
48
65
|
flow; subsequent ones are silent (you should never see the verification code
|
|
49
66
|
again unless you re-pair).
|
|
@@ -95,6 +112,8 @@ Rarely useful outside maind's own development environments:
|
|
|
95
112
|
| Variable | Default | Purpose |
|
|
96
113
|
|---|---|---|
|
|
97
114
|
| `MAIND_MCP_URL` | `https://mcp.maind.dev/mcp` | Streamable-HTTP endpoint to forward to |
|
|
115
|
+
| `MAIND_CLIENT_FAMILY` | unset | Forwards `X-Maind-Client-Family` (`claude-code`, `codex`, `copilot`, `cursor`, `windsurf`, …) so telemetry tracks the real upstream agent instead of generic `mcp-bridge` |
|
|
116
|
+
| `MAIND_CLIENT_VERSION` | unset | Forwards optional `X-Maind-Client-Version` marker (max 64 chars) |
|
|
98
117
|
| `MAIND_FUNCTIONS_ORIGIN` | maind's Supabase Edge Functions URL | Device-flow base URL |
|
|
99
118
|
| `XDG_CONFIG_HOME` | `~/.config` (Linux/BSD) | Parent of the `maind/` config dir |
|
|
100
119
|
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
// MIRROR of packages/types/src/client-families.ts — DO NOT EDIT IN ISOLATION.
|
|
2
|
+
//
|
|
3
|
+
// This file lives in the bridge package so the published npm artifact stays
|
|
4
|
+
// self-contained (no workspace runtime imports). The mapping MUST match the
|
|
5
|
+
// canonical version at packages/types/src/client-families.ts byte-for-byte
|
|
6
|
+
// (or at least value-for-value) — apps/mcp-bridge/test/client-detect.test.ts
|
|
7
|
+
// asserts data-equivalence and will fail CI on drift.
|
|
8
|
+
//
|
|
9
|
+
// When adding a new client family or rename pattern: update BOTH files in the
|
|
10
|
+
// same commit. The pre-commit hook (Block 5) catches diffs that touch
|
|
11
|
+
// apps/mcp-bridge/src/ without a corresponding package.json version bump,
|
|
12
|
+
// which is the failure mode that caused the multi-day Codex-as-mcp-bridge
|
|
13
|
+
// mis-attribution incident on 2026-05-24..28.
|
|
14
|
+
export const CLIENT_FAMILIES = [
|
|
15
|
+
"claude-code",
|
|
16
|
+
"codex",
|
|
17
|
+
"copilot",
|
|
18
|
+
"cursor",
|
|
19
|
+
"windsurf",
|
|
20
|
+
"mcp-bridge",
|
|
21
|
+
"vscode-extension",
|
|
22
|
+
"claude-desktop",
|
|
23
|
+
"mcp-inspector",
|
|
24
|
+
"unknown",
|
|
25
|
+
];
|
|
26
|
+
export const CLIENT_INFO_NAME_PATTERNS = [
|
|
27
|
+
// Anthropic
|
|
28
|
+
["claude-code", "claude-code"],
|
|
29
|
+
["claude-cli", "claude-code"],
|
|
30
|
+
["claude-desktop", "claude-desktop"],
|
|
31
|
+
["claude.app", "claude-desktop"],
|
|
32
|
+
// OpenAI
|
|
33
|
+
["openai-codex", "codex"],
|
|
34
|
+
["codex-cli", "codex"],
|
|
35
|
+
["codex", "codex"],
|
|
36
|
+
// GitHub / Microsoft
|
|
37
|
+
["github-copilot", "copilot"],
|
|
38
|
+
["vscode-copilot", "copilot"],
|
|
39
|
+
["copilot", "copilot"],
|
|
40
|
+
// Editors / IDE clients
|
|
41
|
+
["cursor", "cursor"],
|
|
42
|
+
["windsurf", "windsurf"],
|
|
43
|
+
["codeium", "windsurf"],
|
|
44
|
+
["vscode-extension", "vscode-extension"],
|
|
45
|
+
["maind-vscode", "vscode-extension"],
|
|
46
|
+
// Tooling
|
|
47
|
+
["mcp-inspector", "mcp-inspector"],
|
|
48
|
+
// Bridge identifying itself explicitly (rare; usually we want the upstream client)
|
|
49
|
+
["maind-mcp-bridge", "mcp-bridge"],
|
|
50
|
+
];
|
|
51
|
+
export function mapClientInfoNameToFamily(rawName) {
|
|
52
|
+
if (typeof rawName !== "string")
|
|
53
|
+
return null;
|
|
54
|
+
const name = rawName.trim().toLowerCase();
|
|
55
|
+
if (name.length === 0)
|
|
56
|
+
return null;
|
|
57
|
+
for (const [pattern, family] of CLIENT_INFO_NAME_PATTERNS) {
|
|
58
|
+
if (name.includes(pattern))
|
|
59
|
+
return family;
|
|
60
|
+
}
|
|
61
|
+
return null;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Parses an arbitrary string that the bridge is forwarding as a JSON-RPC frame
|
|
65
|
+
* and, if it's an MCP `initialize` request with a usable clientInfo.name,
|
|
66
|
+
* returns the canonical family + version. Returns null for everything else.
|
|
67
|
+
*
|
|
68
|
+
* Used by Forwarder.forwardFrame() to auto-detect the client family from the
|
|
69
|
+
* very first frame without requiring per-user MAIND_CLIENT_FAMILY config.
|
|
70
|
+
*
|
|
71
|
+
* Defensively try/catch: a malformed frame is normal (clients send all sorts
|
|
72
|
+
* of garbage); we never throw here. Worst case = null = no auto-detection.
|
|
73
|
+
*/
|
|
74
|
+
export function tryExtractInitializeClient(frame) {
|
|
75
|
+
let parsed;
|
|
76
|
+
try {
|
|
77
|
+
parsed = JSON.parse(frame);
|
|
78
|
+
}
|
|
79
|
+
catch {
|
|
80
|
+
return null;
|
|
81
|
+
}
|
|
82
|
+
if (!isRecord(parsed))
|
|
83
|
+
return null;
|
|
84
|
+
if (parsed.method !== "initialize")
|
|
85
|
+
return null;
|
|
86
|
+
const params = parsed.params;
|
|
87
|
+
if (!isRecord(params))
|
|
88
|
+
return null;
|
|
89
|
+
const clientInfo = params.clientInfo;
|
|
90
|
+
if (!isRecord(clientInfo))
|
|
91
|
+
return null;
|
|
92
|
+
const rawName = clientInfo.name;
|
|
93
|
+
const family = mapClientInfoNameToFamily(typeof rawName === "string" ? rawName : null);
|
|
94
|
+
if (family === null)
|
|
95
|
+
return null;
|
|
96
|
+
const rawVersion = clientInfo.version;
|
|
97
|
+
const version = typeof rawVersion === "string" && rawVersion.length > 0
|
|
98
|
+
? rawVersion.slice(0, 64)
|
|
99
|
+
: null;
|
|
100
|
+
return { family, version };
|
|
101
|
+
}
|
|
102
|
+
function isRecord(v) {
|
|
103
|
+
return typeof v === "object" && v !== null && !Array.isArray(v);
|
|
104
|
+
}
|
|
105
|
+
//# sourceMappingURL=client-detect.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client-detect.js","sourceRoot":"","sources":["../src/client-detect.ts"],"names":[],"mappings":"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"}
|
package/build/forward.js
CHANGED
|
@@ -13,6 +13,7 @@
|
|
|
13
13
|
// unpacked to JSON-RPC frames on stdout.
|
|
14
14
|
import { createInterface } from "node:readline";
|
|
15
15
|
import { setTimeout as delay } from "node:timers/promises";
|
|
16
|
+
import { tryExtractInitializeClient } from "./client-detect.js";
|
|
16
17
|
/**
|
|
17
18
|
* Default Streamable-HTTP MCP endpoint for the production maind server.
|
|
18
19
|
* Override via env `MAIND_MCP_URL` for self-hosted/preview environments.
|
|
@@ -36,6 +37,20 @@ export class Forwarder {
|
|
|
36
37
|
apiKey;
|
|
37
38
|
deviceId;
|
|
38
39
|
bridgeVersion;
|
|
40
|
+
/**
|
|
41
|
+
* Mutable because auto-detection from the MCP `initialize` frame can fill it
|
|
42
|
+
* in for clients that didn't set MAIND_CLIENT_FAMILY. Constructor/ENV values
|
|
43
|
+
* remain authoritative — auto-detect only writes when both are absent.
|
|
44
|
+
*/
|
|
45
|
+
clientFamily;
|
|
46
|
+
clientVersion;
|
|
47
|
+
/**
|
|
48
|
+
* True once we've explicitly set clientFamily via constructor arg or ENV.
|
|
49
|
+
* Used to lock out auto-detect overwrites (priority chain documented in
|
|
50
|
+
* client-detect.ts).
|
|
51
|
+
*/
|
|
52
|
+
clientFamilyLocked;
|
|
53
|
+
clientVersionLocked;
|
|
39
54
|
/** Set by the first response that carries an Mcp-Session-Id header. */
|
|
40
55
|
sessionId = null;
|
|
41
56
|
/** Set true once an unrecoverable auth condition is detected. */
|
|
@@ -44,6 +59,12 @@ export class Forwarder {
|
|
|
44
59
|
this.apiKey = cfg.apiKey;
|
|
45
60
|
this.deviceId = cfg.deviceId;
|
|
46
61
|
this.bridgeVersion = cfg.bridgeVersion;
|
|
62
|
+
const rawFamily = cfg.clientFamily ?? process.env.MAIND_CLIENT_FAMILY ?? null;
|
|
63
|
+
this.clientFamily = normalizeClientFamily(rawFamily);
|
|
64
|
+
this.clientFamilyLocked = this.clientFamily !== null;
|
|
65
|
+
const rawVersion = cfg.clientVersion ?? process.env.MAIND_CLIENT_VERSION ?? null;
|
|
66
|
+
this.clientVersion = normalizeClientVersion(rawVersion);
|
|
67
|
+
this.clientVersionLocked = this.clientVersion !== null;
|
|
47
68
|
this.mcpUrl =
|
|
48
69
|
cfg.mcpUrl ??
|
|
49
70
|
process.env.MAIND_MCP_URL ??
|
|
@@ -74,6 +95,19 @@ export class Forwarder {
|
|
|
74
95
|
}
|
|
75
96
|
}
|
|
76
97
|
async forwardFrame(frame) {
|
|
98
|
+
// Auto-detect upstream client from the MCP `initialize` frame. Runs once
|
|
99
|
+
// per session — initialize is always the first JSON-RPC method. ENV /
|
|
100
|
+
// constructor values win (locked flags), so user overrides remain
|
|
101
|
+
// authoritative. See client-detect.ts for the full priority chain.
|
|
102
|
+
if (!this.clientFamilyLocked && this.clientFamily === null) {
|
|
103
|
+
const detected = tryExtractInitializeClient(frame);
|
|
104
|
+
if (detected !== null) {
|
|
105
|
+
this.clientFamily = detected.family;
|
|
106
|
+
if (!this.clientVersionLocked && this.clientVersion === null) {
|
|
107
|
+
this.clientVersion = detected.version;
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
77
111
|
const headers = {
|
|
78
112
|
"content-type": "application/json",
|
|
79
113
|
// Streamable HTTP allows either a one-shot JSON body or an SSE stream
|
|
@@ -83,6 +117,12 @@ export class Forwarder {
|
|
|
83
117
|
"x-maind-device-id": this.deviceId,
|
|
84
118
|
"x-maind-bridge-version": this.bridgeVersion,
|
|
85
119
|
};
|
|
120
|
+
if (this.clientFamily !== null) {
|
|
121
|
+
headers["x-maind-client-family"] = this.clientFamily;
|
|
122
|
+
}
|
|
123
|
+
if (this.clientVersion !== null) {
|
|
124
|
+
headers["x-maind-client-version"] = this.clientVersion;
|
|
125
|
+
}
|
|
86
126
|
if (this.sessionId !== null) {
|
|
87
127
|
headers["mcp-session-id"] = this.sessionId;
|
|
88
128
|
}
|
|
@@ -155,6 +195,33 @@ export class Forwarder {
|
|
|
155
195
|
emitJsonRpcError(id, -32001, `bridge auth error: ${body.slice(0, 200)}`);
|
|
156
196
|
}
|
|
157
197
|
}
|
|
198
|
+
function normalizeClientFamily(raw) {
|
|
199
|
+
if (raw === null)
|
|
200
|
+
return null;
|
|
201
|
+
const v = raw.trim().toLowerCase();
|
|
202
|
+
if (v.length === 0)
|
|
203
|
+
return null;
|
|
204
|
+
const allowed = new Set([
|
|
205
|
+
"claude-code",
|
|
206
|
+
"codex",
|
|
207
|
+
"copilot",
|
|
208
|
+
"cursor",
|
|
209
|
+
"windsurf",
|
|
210
|
+
"mcp-bridge",
|
|
211
|
+
"vscode-extension",
|
|
212
|
+
"claude-desktop",
|
|
213
|
+
"mcp-inspector",
|
|
214
|
+
]);
|
|
215
|
+
return allowed.has(v) ? v : null;
|
|
216
|
+
}
|
|
217
|
+
function normalizeClientVersion(raw) {
|
|
218
|
+
if (raw === null)
|
|
219
|
+
return null;
|
|
220
|
+
const v = raw.trim();
|
|
221
|
+
if (v.length === 0)
|
|
222
|
+
return null;
|
|
223
|
+
return v.slice(0, 64);
|
|
224
|
+
}
|
|
158
225
|
/**
|
|
159
226
|
* Streams an SSE response body and emits each `data:` payload as a single
|
|
160
227
|
* line-delimited JSON-RPC frame on stdout. Per the SSE spec, multiple `data:`
|
package/build/forward.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"forward.js","sourceRoot":"","sources":["../src/forward.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,yEAAyE;AACzE,0EAA0E;AAC1E,2CAA2C;AAC3C,EAAE;AACF,4BAA4B;AAC5B,mEAAmE;AACnE,uEAAuE;AACvE,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,yCAAyC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"forward.js","sourceRoot":"","sources":["../src/forward.ts"],"names":[],"mappings":"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"}
|
package/build/index.js
CHANGED
|
@@ -15,11 +15,38 @@
|
|
|
15
15
|
// STDERR. Anything that leaks to STDOUT will corrupt the stream and crash the
|
|
16
16
|
// upstream client (Claude Code, Cursor, etc.) with an opaque parser error.
|
|
17
17
|
import { BridgeReauthNeeded, Forwarder } from "./forward.js";
|
|
18
|
-
import { clearApiKey, ensureDeviceId, readApiKey, } from "./device-id.js";
|
|
18
|
+
import { clearApiKey, ensureDeviceId, readApiKey, writeApiKey, } from "./device-id.js";
|
|
19
19
|
import { runDeviceFlow } from "./auth.js";
|
|
20
20
|
import { BRIDGE_VERSION } from "./version.js";
|
|
21
|
+
import { runInstall } from "./install/index.js";
|
|
21
22
|
const MAX_REAUTH_ATTEMPTS = 1;
|
|
23
|
+
/**
|
|
24
|
+
* Resolves the API key to use for this run, in priority order:
|
|
25
|
+
*
|
|
26
|
+
* 1. `MAIND_API_KEY` env var. The user (or their MCP-client config) supplied
|
|
27
|
+
* an existing key explicitly — honor it. We also persist it to the local
|
|
28
|
+
* api-key file so subsequent runs without the env var stay silent. This
|
|
29
|
+
* is the typical path when the user creates a key in `/keys` first and
|
|
30
|
+
* pastes it into `.mcp.json` via the bridge-altVariant snippet.
|
|
31
|
+
* 2. Locally cached key from a previous successful run (read from
|
|
32
|
+
* `~/.config/maind/api-key` or platform equivalent).
|
|
33
|
+
* 3. Fresh device-authorization flow: opens browser, user approves, server
|
|
34
|
+
* issues a new key + binds it to the local device-id via
|
|
35
|
+
* `upsert_device_on_pair`. The new key is persisted to disk for future
|
|
36
|
+
* runs.
|
|
37
|
+
*
|
|
38
|
+
* Format validation against the maind key format (mnd_<8hex>_<56hex>) is
|
|
39
|
+
* done lightly here — a typo'd env var will surface as a 401 on the first
|
|
40
|
+
* MCP call, with the bridge's existing re-auth-loop kicking in.
|
|
41
|
+
*/
|
|
22
42
|
async function ensureApiKey() {
|
|
43
|
+
const fromEnv = (process.env.MAIND_API_KEY ?? "").trim();
|
|
44
|
+
if (fromEnv.length > 0) {
|
|
45
|
+
if (fromEnv !== readApiKey()) {
|
|
46
|
+
writeApiKey(fromEnv);
|
|
47
|
+
}
|
|
48
|
+
return fromEnv;
|
|
49
|
+
}
|
|
23
50
|
const cached = readApiKey();
|
|
24
51
|
if (cached !== null)
|
|
25
52
|
return cached;
|
|
@@ -40,6 +67,19 @@ async function reauth() {
|
|
|
40
67
|
return result.apiKey;
|
|
41
68
|
}
|
|
42
69
|
async function main() {
|
|
70
|
+
// Sub-command dispatch — the first non-flag positional argument selects a
|
|
71
|
+
// mode. With no sub-command we fall through to the original bridge-proxy
|
|
72
|
+
// behavior (stdin↔HTTP forwarding for MCP).
|
|
73
|
+
const firstPositional = process.argv
|
|
74
|
+
.slice(2)
|
|
75
|
+
.find((a) => !a.startsWith("-"));
|
|
76
|
+
if (firstPositional === "install") {
|
|
77
|
+
// Forward everything AFTER the "install" token to the install handler.
|
|
78
|
+
const installIndex = process.argv.indexOf("install");
|
|
79
|
+
const installArgs = process.argv.slice(installIndex + 1);
|
|
80
|
+
const code = await runInstall(installArgs);
|
|
81
|
+
process.exit(code);
|
|
82
|
+
}
|
|
43
83
|
if (process.argv.includes("--version") || process.argv.includes("-v")) {
|
|
44
84
|
process.stdout.write(BRIDGE_VERSION + "\n");
|
|
45
85
|
process.exit(0);
|
|
@@ -90,12 +130,18 @@ function printHelp() {
|
|
|
90
130
|
"",
|
|
91
131
|
"Usage:",
|
|
92
132
|
" npx -y @maind-dev/mcp-bridge # run as MCP server (stdio)",
|
|
133
|
+
" npx -y @maind-dev/mcp-bridge install # one-shot setup (configs, preamble, hook)",
|
|
93
134
|
" npx -y @maind-dev/mcp-bridge --reauth # discard local key and re-run device flow",
|
|
94
135
|
" npx -y @maind-dev/mcp-bridge --version",
|
|
95
136
|
" npx -y @maind-dev/mcp-bridge --help",
|
|
96
137
|
"",
|
|
138
|
+
"Run `install --help` for full setup flags:",
|
|
139
|
+
" npx -y @maind-dev/mcp-bridge install --help",
|
|
140
|
+
"",
|
|
97
141
|
"Environment overrides (rarely needed):",
|
|
98
142
|
" MAIND_MCP_URL Streamable-HTTP endpoint (default https://mcp.maind.dev/mcp)",
|
|
143
|
+
" MAIND_CLIENT_FAMILY Forward real client family (claude-code|codex|copilot|cursor|windsurf|...)",
|
|
144
|
+
" MAIND_CLIENT_VERSION Optional client version marker (max 64 chars)",
|
|
99
145
|
" MAIND_FUNCTIONS_ORIGIN Supabase Edge Functions base URL for device-auth",
|
|
100
146
|
" XDG_CONFIG_HOME Override config-dir parent on Linux/BSD",
|
|
101
147
|
"",
|
package/build/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,EAAE;AACF,uCAAuC;AACvC,EAAE;AACF,aAAa;AACb,2EAA2E;AAC3E,+EAA+E;AAC/E,iFAAiF;AACjF,gEAAgE;AAChE,gFAAgF;AAChF,iFAAiF;AACjF,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,2EAA2E;AAE3E,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EACL,WAAW,EACX,cAAc,EACd,UAAU,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
// Cross-platform atomic file write + small fs/path helpers used across the
|
|
2
|
+
// install sub-command. Centralized so platform quirks live in one place.
|
|
3
|
+
//
|
|
4
|
+
// Atomic-write strategy:
|
|
5
|
+
// 1. Write to a sibling tmp file in the same directory.
|
|
6
|
+
// 2. fs.rename() the tmp file into place — atomic on POSIX, mostly-atomic on
|
|
7
|
+
// Windows when the target doesn't exist.
|
|
8
|
+
// 3. Windows fallback: if rename fails with EEXIST/EPERM, copy + unlink.
|
|
9
|
+
//
|
|
10
|
+
// The "write to sibling" detail matters: rename across filesystems isn't
|
|
11
|
+
// atomic and may fail (EXDEV). Using $TMPDIR could land us on a tmpfs that's
|
|
12
|
+
// a different filesystem than the target.
|
|
13
|
+
import * as fs from "node:fs/promises";
|
|
14
|
+
import * as path from "node:path";
|
|
15
|
+
/**
|
|
16
|
+
* Reads a UTF-8 file. Returns `null` if the file does not exist. Re-throws
|
|
17
|
+
* any other error (permission denied, IO error, etc.) so the caller can
|
|
18
|
+
* record it as a failed step.
|
|
19
|
+
*/
|
|
20
|
+
export async function readFileSafe(filepath) {
|
|
21
|
+
try {
|
|
22
|
+
return await fs.readFile(filepath, "utf8");
|
|
23
|
+
}
|
|
24
|
+
catch (err) {
|
|
25
|
+
if (isNoEnt(err))
|
|
26
|
+
return null;
|
|
27
|
+
throw err;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
export async function fileExists(filepath) {
|
|
31
|
+
try {
|
|
32
|
+
await fs.access(filepath);
|
|
33
|
+
return true;
|
|
34
|
+
}
|
|
35
|
+
catch {
|
|
36
|
+
return false;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Idempotent `mkdir -p`. Creates the directory and any missing parents.
|
|
41
|
+
* Returns silently if the directory already exists.
|
|
42
|
+
*/
|
|
43
|
+
export async function ensureDir(dir) {
|
|
44
|
+
await fs.mkdir(dir, { recursive: true });
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Writes `content` to `filepath` atomically across macOS, Linux, and Windows.
|
|
48
|
+
*
|
|
49
|
+
* @param mode Optional POSIX file mode (e.g. 0o600 for user-private files).
|
|
50
|
+
* No-op on Windows where mode bits don't translate to ACLs.
|
|
51
|
+
*/
|
|
52
|
+
export async function atomicWriteFile(filepath, content, mode) {
|
|
53
|
+
const dir = path.dirname(filepath);
|
|
54
|
+
await ensureDir(dir);
|
|
55
|
+
// Sibling tmp file — same FS as the target, so rename is atomic.
|
|
56
|
+
const tmp = path.join(dir, `.maind-install-${process.pid}-${Date.now()}.tmp`);
|
|
57
|
+
await fs.writeFile(tmp, content, { encoding: "utf8", mode });
|
|
58
|
+
try {
|
|
59
|
+
await fs.rename(tmp, filepath);
|
|
60
|
+
}
|
|
61
|
+
catch (err) {
|
|
62
|
+
// Windows: rename can fail with EEXIST/EPERM when the target exists or is
|
|
63
|
+
// locked. Fallback: copy + unlink. This is NOT atomic — but the alternative
|
|
64
|
+
// (fail the whole install) is worse, and we minimize the window by doing
|
|
65
|
+
// it just for the one file.
|
|
66
|
+
if (isWindowsRenameFailure(err)) {
|
|
67
|
+
try {
|
|
68
|
+
await fs.copyFile(tmp, filepath);
|
|
69
|
+
await fs.unlink(tmp).catch(() => {
|
|
70
|
+
// tmp cleanup best-effort — leaking a tmp file is harmless
|
|
71
|
+
});
|
|
72
|
+
if (mode !== undefined) {
|
|
73
|
+
await fs.chmod(filepath, mode).catch(() => {
|
|
74
|
+
// chmod no-op on Windows is fine
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
catch (fallbackErr) {
|
|
80
|
+
await fs.unlink(tmp).catch(() => { });
|
|
81
|
+
throw fallbackErr;
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
await fs.unlink(tmp).catch(() => { });
|
|
85
|
+
throw err;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* Checks whether a file already contains a line that starts with the given
|
|
90
|
+
* marker (anchored to the start of a line). Used by the preamble-file logic
|
|
91
|
+
* to detect "## maind MCP integration" without false-matching nested headings.
|
|
92
|
+
*
|
|
93
|
+
* Returns `false` if the file does not exist.
|
|
94
|
+
*/
|
|
95
|
+
export async function hasLinePrefix(filepath, prefix) {
|
|
96
|
+
const content = await readFileSafe(filepath);
|
|
97
|
+
if (content === null)
|
|
98
|
+
return false;
|
|
99
|
+
const lines = content.split(/\r?\n/);
|
|
100
|
+
return lines.some((l) => l.startsWith(prefix));
|
|
101
|
+
}
|
|
102
|
+
function isNoEnt(err) {
|
|
103
|
+
return isNodeError(err) && err.code === "ENOENT";
|
|
104
|
+
}
|
|
105
|
+
function isWindowsRenameFailure(err) {
|
|
106
|
+
if (!isNodeError(err))
|
|
107
|
+
return false;
|
|
108
|
+
if (process.platform !== "win32")
|
|
109
|
+
return false;
|
|
110
|
+
return err.code === "EEXIST" || err.code === "EPERM" || err.code === "EACCES";
|
|
111
|
+
}
|
|
112
|
+
function isNodeError(err) {
|
|
113
|
+
return typeof err === "object" && err !== null && "code" in err;
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=atomic-write.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/install/atomic-write.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
// Browser pairing for the install sub-command.
|
|
2
|
+
//
|
|
3
|
+
// Two modes:
|
|
4
|
+
// 1. `--token <jwt>` — one-click flow from the dashboard. The token IS the
|
|
5
|
+
// api-key — we skip the device-authorization flow entirely and just
|
|
6
|
+
// persist the key locally.
|
|
7
|
+
// 2. Default — run the existing device-authorization flow (auth.ts).
|
|
8
|
+
//
|
|
9
|
+
// In install-mode we may write to STDOUT (unlike bridge-mode where STDOUT
|
|
10
|
+
// is the MCP framing channel). But the underlying auth.ts deliberately
|
|
11
|
+
// targets STDERR for its progress output, which is harmless here.
|
|
12
|
+
//
|
|
13
|
+
// Idempotency: if `~/.config/maind/api-key` is already populated AND the
|
|
14
|
+
// caller did not pass `--token`, we re-use the existing key — no need to
|
|
15
|
+
// pop a browser. The user can force a re-pair with `--reauth` (top-level
|
|
16
|
+
// bridge flag, not install-specific).
|
|
17
|
+
import { runDeviceFlow } from "../auth.js";
|
|
18
|
+
import { clearApiKey, readApiKey, writeApiKey } from "../device-id.js";
|
|
19
|
+
export async function pairOrUseToken(opts) {
|
|
20
|
+
const targetKey = "browser-pair";
|
|
21
|
+
if (opts.token !== null) {
|
|
22
|
+
try {
|
|
23
|
+
const validated = validateTokenShape(opts.token);
|
|
24
|
+
if (opts.dryRun) {
|
|
25
|
+
return {
|
|
26
|
+
apiKey: validated,
|
|
27
|
+
result: {
|
|
28
|
+
target: targetKey,
|
|
29
|
+
action: "token",
|
|
30
|
+
status: "would-pair",
|
|
31
|
+
detail: "would pair via --token (one-click flow)",
|
|
32
|
+
},
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
// Token-mode replaces any existing key for this device. The dashboard
|
|
36
|
+
// one-click flow has already minted the device-bound key on the server,
|
|
37
|
+
// so persisting it here completes the pair.
|
|
38
|
+
clearApiKey();
|
|
39
|
+
writeApiKey(validated);
|
|
40
|
+
return {
|
|
41
|
+
apiKey: validated,
|
|
42
|
+
result: {
|
|
43
|
+
target: targetKey,
|
|
44
|
+
action: "token",
|
|
45
|
+
status: "created",
|
|
46
|
+
detail: "paired via --token (one-click flow)",
|
|
47
|
+
},
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
catch (err) {
|
|
51
|
+
return {
|
|
52
|
+
apiKey: null,
|
|
53
|
+
result: {
|
|
54
|
+
target: targetKey,
|
|
55
|
+
action: "token",
|
|
56
|
+
status: "failed",
|
|
57
|
+
detail: errMessage(err),
|
|
58
|
+
},
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
const cached = readApiKey();
|
|
63
|
+
if (cached !== null) {
|
|
64
|
+
return {
|
|
65
|
+
apiKey: cached,
|
|
66
|
+
result: {
|
|
67
|
+
target: targetKey,
|
|
68
|
+
action: "skip",
|
|
69
|
+
status: "skipped",
|
|
70
|
+
detail: "device already paired — use --reauth to force a fresh pairing",
|
|
71
|
+
},
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
if (opts.dryRun) {
|
|
75
|
+
return {
|
|
76
|
+
apiKey: null,
|
|
77
|
+
result: {
|
|
78
|
+
target: targetKey,
|
|
79
|
+
action: "pair",
|
|
80
|
+
status: "would-pair",
|
|
81
|
+
detail: "would open browser for device-authorization flow",
|
|
82
|
+
},
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
try {
|
|
86
|
+
const flow = await runDeviceFlow(opts.bridgeVersion);
|
|
87
|
+
if (flow === null) {
|
|
88
|
+
return {
|
|
89
|
+
apiKey: null,
|
|
90
|
+
result: {
|
|
91
|
+
target: targetKey,
|
|
92
|
+
action: "pair",
|
|
93
|
+
status: "failed",
|
|
94
|
+
detail: "device-authorization flow did not complete (denied / expired / timeout)",
|
|
95
|
+
},
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
return {
|
|
99
|
+
apiKey: flow.apiKey,
|
|
100
|
+
result: {
|
|
101
|
+
target: targetKey,
|
|
102
|
+
action: "pair",
|
|
103
|
+
status: "created",
|
|
104
|
+
detail: `device-bound api-key written (plan: ${flow.plan})`,
|
|
105
|
+
},
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
catch (err) {
|
|
109
|
+
return {
|
|
110
|
+
apiKey: null,
|
|
111
|
+
result: {
|
|
112
|
+
target: targetKey,
|
|
113
|
+
action: "pair",
|
|
114
|
+
status: "failed",
|
|
115
|
+
detail: errMessage(err),
|
|
116
|
+
},
|
|
117
|
+
};
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* Light shape validation of the `--token` argument. Real cryptographic
|
|
122
|
+
* verification happens server-side on first MCP call — this just catches
|
|
123
|
+
* obviously malformed pasta (empty string, leading whitespace, accidental
|
|
124
|
+
* URL prefix).
|
|
125
|
+
*/
|
|
126
|
+
function validateTokenShape(token) {
|
|
127
|
+
const trimmed = token.trim();
|
|
128
|
+
if (trimmed.length === 0) {
|
|
129
|
+
throw new Error("--token is empty");
|
|
130
|
+
}
|
|
131
|
+
if (!/^mnd_[A-Za-z0-9_]+$/.test(trimmed)) {
|
|
132
|
+
throw new Error("--token does not match maind api-key shape (expected mnd_<…>) — did you paste a URL instead of the token?");
|
|
133
|
+
}
|
|
134
|
+
return trimmed;
|
|
135
|
+
}
|
|
136
|
+
function errMessage(err) {
|
|
137
|
+
return err instanceof Error ? err.message : String(err);
|
|
138
|
+
}
|
|
139
|
+
//# sourceMappingURL=browser-pair.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browser-pair.js","sourceRoot":"","sources":["../../src/install/browser-pair.ts"],"names":[],"mappings":"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"}
|