@hostafrica/connector-core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HostAfrica
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/clients/claudeCode.d.ts

@@ -0,0 +1,9 @@
+import { AuthMode, McpClient } from "../types";
+/** Pure builder for the `claude mcp add` argument list — unit-testable. */
+export declare function claudeAddArgs(auth: AuthMode): string[];
+/**
+ * Claude Code manages its own MCP config; drive it through `claude mcp`
+ * rather than editing files, so scope handling stays Claude Code's problem.
+ * Registration is user-scoped so it works across every project.
+ */
+export declare const claudeCode: McpClient;

package/dist/clients/claudeCode.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeCode = void 0;
+exports.claudeAddArgs = claudeAddArgs;
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const fsutil_1 = require("../fsutil");
+/** Pure builder for the `claude mcp add` argument list — unit-testable. */
+function claudeAddArgs(auth) {
+    const { url, headers } = (0, types_1.endpointFor)(auth);
+    const args = ["mcp", "add", "--scope", "user", "--transport", "http", constants_1.SERVER_KEY, url];
+    for (const [k, v] of Object.entries(headers ?? {})) {
+        args.push("--header", `${k}: ${v}`);
+    }
+    return args;
+}
+/**
+ * Claude Code manages its own MCP config; drive it through `claude mcp`
+ * rather than editing files, so scope handling stays Claude Code's problem.
+ * Registration is user-scoped so it works across every project.
+ */
+exports.claudeCode = {
+    id: "claude-code",
+    name: "Claude Code",
+    supportsOAuth: true,
+    describeTarget: () => "claude mcp (user scope)",
+    async detect() {
+        return (await (0, fsutil_1.whichBin)("claude")) !== undefined;
+    },
+    async isRegistered() {
+        try {
+            await (0, fsutil_1.execFileP)("claude", ["mcp", "get", constants_1.SERVER_KEY]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    async register(opts) {
+        // `claude mcp add` refuses duplicate names, so make register idempotent.
+        await this.unregister();
+        await (0, fsutil_1.execFileP)("claude", claudeAddArgs(opts.auth));
+    },
+    async unregister() {
+        try {
+            await (0, fsutil_1.execFileP)("claude", ["mcp", "remove", "--scope", "user", constants_1.SERVER_KEY]);
+        }
+        catch {
+            // already gone
+        }
+    },
+};
+//# sourceMappingURL=claudeCode.js.map

package/dist/clients/claudeCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeCode.js","sourceRoot":"","sources":["../../src/clients/claudeCode.ts"],"names":[],"mappings":";;;AAKA,sCAOC;AAZD,4CAA0C;AAC1C,oCAA6E;AAC7E,sCAAgD;AAEhD,2EAA2E;AAC3E,SAAgB,aAAa,CAAC,IAAc;IAC1C,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAA,mBAAW,EAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,sBAAU,EAAE,GAAG,CAAC,CAAC;IACvF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACU,QAAA,UAAU,GAAc;IACnC,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,aAAa;IACnB,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,GAAG,EAAE,CAAC,yBAAyB;IAE/C,KAAK,CAAC,MAAM;QACV,OAAO,CAAC,MAAM,IAAA,iBAAQ,EAAC,QAAQ,CAAC,CAAC,KAAK,SAAS,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,MAAM,IAAA,kBAAS,EAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,sBAAU,CAAC,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAqB;QAClC,yEAAyE;QACzE,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAA,kBAAS,EAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC;YACH,MAAM,IAAA,kBAAS,EAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,sBAAU,CAAC,CAAC,CAAC;QAC9E,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/clients/codex.d.ts

@@ -0,0 +1,12 @@
+import { McpClient } from "../types";
+/**
+ * OpenAI Codex CLI reads TOML at ~/.codex/config.toml with an `mcp_servers`
+ * table. Streamable-HTTP servers use `url` (no experimental flag needed since
+ * ~v0.44). OAuth is supported per the MCP authorization spec — `auth` defaults
+ * to "oauth" and `codex mcp login <name>` runs the browser flow — so a bare
+ * `url` entry is the OAuth-first registration. Token fallback writes
+ * `http_headers`; `bearer_token_env_var` is the secretless alternative when
+ * the user prefers env vars.
+ */
+export declare function makeCodex(home?: string): McpClient;
+export declare const codex: McpClient;

package/dist/clients/codex.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codex = void 0;
+exports.makeCodex = makeCodex;
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const smol_toml_1 = require("smol-toml");
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const fsutil_1 = require("../fsutil");
+/**
+ * OpenAI Codex CLI reads TOML at ~/.codex/config.toml with an `mcp_servers`
+ * table. Streamable-HTTP servers use `url` (no experimental flag needed since
+ * ~v0.44). OAuth is supported per the MCP authorization spec — `auth` defaults
+ * to "oauth" and `codex mcp login <name>` runs the browser flow — so a bare
+ * `url` entry is the OAuth-first registration. Token fallback writes
+ * `http_headers`; `bearer_token_env_var` is the secretless alternative when
+ * the user prefers env vars.
+ */
+function makeCodex(home = os.homedir()) {
+    const configPath = path.join(home, ".codex", "config.toml");
+    async function readConfig() {
+        const raw = await (0, fsutil_1.readTextIfPresent)(configPath);
+        if (raw === undefined || raw.trim() === "")
+            return {};
+        try {
+            return (0, smol_toml_1.parse)(raw);
+        }
+        catch (err) {
+            throw new Error(`Codex config at ${configPath} is not valid TOML — fix or remove it, then retry (${String(err)})`);
+        }
+    }
+    return {
+        id: "codex",
+        name: "OpenAI Codex CLI",
+        supportsOAuth: true, // `codex mcp login` — DCR and CIMD both supported
+        describeTarget: () => configPath,
+        async detect() {
+            return (0, fsutil_1.exists)(path.join(home, ".codex"));
+        },
+        async isRegistered() {
+            try {
+                const cfg = await readConfig();
+                return Boolean(cfg["mcp_servers"]?.[constants_1.SERVER_KEY]);
+            }
+            catch {
+                return false;
+            }
+        },
+        async register(opts) {
+            const cfg = await readConfig();
+            const { url, headers } = (0, types_1.endpointFor)(opts.auth);
+            const entry = { url };
+            if (headers)
+                entry["http_headers"] = headers;
+            cfg["mcp_servers"] = cfg["mcp_servers"] ?? {};
+            cfg["mcp_servers"][constants_1.SERVER_KEY] = entry;
+            await (0, fsutil_1.writePrivate)(configPath, (0, smol_toml_1.stringify)(cfg) + "\n");
+        },
+        async unregister() {
+            const raw = await (0, fsutil_1.readTextIfPresent)(configPath);
+            if (raw === undefined)
+                return;
+            const cfg = await readConfig();
+            if (cfg["mcp_servers"]?.[constants_1.SERVER_KEY]) {
+                delete cfg["mcp_servers"][constants_1.SERVER_KEY];
+                await (0, fsutil_1.writePrivate)(configPath, (0, smol_toml_1.stringify)(cfg) + "\n");
+            }
+        },
+    };
+}
+exports.codex = makeCodex();
+//# sourceMappingURL=codex.js.map

package/dist/clients/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/clients/codex.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBA,8BAsDC;AAtED,4CAA8B;AAC9B,gDAAkC;AAClC,yCAA2E;AAC3E,4CAA0C;AAC1C,oCAAmE;AACnE,sCAAoE;AAEpE;;;;;;;;GAQG;AACH,SAAgB,SAAS,CAAC,OAAe,EAAE,CAAC,OAAO,EAAE;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAE5D,KAAK,UAAU,UAAU;QACvB,MAAM,GAAG,GAAG,MAAM,IAAA,0BAAiB,EAAC,UAAU,CAAC,CAAC;QAChD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,OAAO,IAAA,iBAAS,EAAC,GAAG,CAAwB,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,mBAAmB,UAAU,sDAAsD,MAAM,CAAC,GAAG,CAAC,GAAG,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,kBAAkB;QACxB,aAAa,EAAE,IAAI,EAAE,kDAAkD;QACvE,cAAc,EAAE,GAAG,EAAE,CAAC,UAAU;QAEhC,KAAK,CAAC,MAAM;YACV,OAAO,IAAA,eAAM,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3C,CAAC;QAED,KAAK,CAAC,YAAY;YAChB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;gBAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,sBAAU,CAAC,CAAC,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,IAAqB;YAClC,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;YAC/B,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAA,mBAAW,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,KAAK,GAA4B,EAAE,GAAG,EAAE,CAAC;YAC/C,IAAI,OAAO;gBAAE,KAAK,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC;YAC7C,GAAG,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YAC9C,GAAG,CAAC,aAAa,CAAC,CAAC,sBAAU,CAAC,GAAG,KAAK,CAAC;YACvC,MAAM,IAAA,qBAAY,EAAC,UAAU,EAAE,IAAA,qBAAa,EAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5D,CAAC;QAED,KAAK,CAAC,UAAU;YACd,MAAM,GAAG,GAAG,MAAM,IAAA,0BAAiB,EAAC,UAAU,CAAC,CAAC;YAChD,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO;YAC9B,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;YAC/B,IAAI,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC,sBAAU,CAAC,EAAE,CAAC;gBACrC,OAAO,GAAG,CAAC,aAAa,CAAC,CAAC,sBAAU,CAAC,CAAC;gBACtC,MAAM,IAAA,qBAAY,EAAC,UAAU,EAAE,IAAA,qBAAa,EAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAEY,QAAA,KAAK,GAAc,SAAS,EAAE,CAAC"}

package/dist/clients/jsonClient.d.ts

@@ -0,0 +1,20 @@
+import { AuthMode, McpClient } from "../types";
+export interface JsonClientSpec {
+    id: string;
+    name: string;
+    supportsOAuth: boolean;
+    /** Absolute path of the MCP config file this client reads. */
+    configPath: string;
+    /** Paths whose existence indicates the client is installed. */
+    detectPaths: string[];
+    /** Top-level key holding the server map, e.g. "mcpServers". */
+    rootKey: string;
+    /** Build this client's server entry for the given auth mode. */
+    buildEntry(auth: AuthMode): Record<string, unknown>;
+}
+/**
+ * Most AI clients read a JSON file with a `{ [rootKey]: { [name]: entry } }`
+ * shape and differ only in path and entry fields. This factory covers them;
+ * merge is read–modify–write so entries for other servers are preserved.
+ */
+export declare function jsonClient(spec: JsonClientSpec): McpClient;

package/dist/clients/jsonClient.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonClient = jsonClient;
+const constants_1 = require("../constants");
+const fsutil_1 = require("../fsutil");
+/**
+ * Most AI clients read a JSON file with a `{ [rootKey]: { [name]: entry } }`
+ * shape and differ only in path and entry fields. This factory covers them;
+ * merge is read–modify–write so entries for other servers are preserved.
+ */
+function jsonClient(spec) {
+    async function readConfig() {
+        const raw = await (0, fsutil_1.readTextIfPresent)(spec.configPath);
+        if (raw === undefined || raw.trim() === "")
+            return {};
+        try {
+            return JSON.parse(raw);
+        }
+        catch (err) {
+            throw new Error(`${spec.name} config at ${spec.configPath} is not valid JSON — fix or remove it, then retry (${String(err)})`);
+        }
+    }
+    return {
+        id: spec.id,
+        name: spec.name,
+        supportsOAuth: spec.supportsOAuth,
+        describeTarget: () => spec.configPath,
+        async detect() {
+            for (const p of spec.detectPaths) {
+                if (await (0, fsutil_1.exists)(p))
+                    return true;
+            }
+            return false;
+        },
+        async isRegistered() {
+            try {
+                const cfg = await readConfig();
+                return Boolean(cfg[spec.rootKey]?.[constants_1.SERVER_KEY]);
+            }
+            catch {
+                return false;
+            }
+        },
+        async register(opts) {
+            const cfg = await readConfig();
+            cfg[spec.rootKey] = cfg[spec.rootKey] ?? {};
+            cfg[spec.rootKey][constants_1.SERVER_KEY] = spec.buildEntry(opts.auth);
+            await (0, fsutil_1.writePrivate)(spec.configPath, JSON.stringify(cfg, null, 2) + "\n");
+        },
+        async unregister() {
+            const raw = await (0, fsutil_1.readTextIfPresent)(spec.configPath);
+            if (raw === undefined)
+                return;
+            const cfg = await readConfig();
+            if (cfg[spec.rootKey]?.[constants_1.SERVER_KEY]) {
+                delete cfg[spec.rootKey][constants_1.SERVER_KEY];
+                await (0, fsutil_1.writePrivate)(spec.configPath, JSON.stringify(cfg, null, 2) + "\n");
+            }
+        },
+    };
+}
+//# sourceMappingURL=jsonClient.js.map

package/dist/clients/jsonClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonClient.js","sourceRoot":"","sources":["../../src/clients/jsonClient.ts"],"names":[],"mappings":";;AAuBA,gCAoDC;AA3ED,4CAA0C;AAE1C,sCAAoE;AAgBpE;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAoB;IAC7C,KAAK,UAAU,UAAU;QACvB,MAAM,GAAG,GAAG,MAAM,IAAA,0BAAiB,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,UAAU,sDAAsD,MAAM,CAAC,GAAG,CAAC,GAAG,CAC9G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU;QAErC,KAAK,CAAC,MAAM;YACV,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,IAAI,MAAM,IAAA,eAAM,EAAC,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAC;YACnC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,YAAY;YAChB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;gBAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,sBAAU,CAAC,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,IAAqB;YAClC,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;YAC/B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC5C,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,sBAAU,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3D,MAAM,IAAA,qBAAY,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3E,CAAC;QAED,KAAK,CAAC,UAAU;YACd,MAAM,GAAG,GAAG,MAAM,IAAA,0BAAiB,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACrD,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO;YAC9B,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;YAC/B,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,sBAAU,CAAC,EAAE,CAAC;gBACpC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,sBAAU,CAAC,CAAC;gBACrC,MAAM,IAAA,qBAAY,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/clients/registry.d.ts

@@ -0,0 +1,17 @@
+import { ClientStatus, McpClient } from "../types";
+/** Per-OS location of Claude Desktop's config file. */
+export declare function claudeDesktopConfigPath(home: string): string;
+/**
+ * Build the client set rooted at a given home directory. Production callers
+ * use the real home (the default); tests pass a temp dir.
+ */
+export declare function createClients(home?: string): McpClient[];
+/**
+ * All clients the registrar can configure directly. VS Code itself is not in
+ * this list: the extension registers the server natively through the
+ * McpServerDefinitionProvider API instead of writing config files.
+ */
+export declare function allClients(): McpClient[];
+export declare function clientById(id: string): McpClient | undefined;
+/** Installed/registered status for every known client. */
+export declare function clientStatuses(): Promise<ClientStatus[]>;

package/dist/clients/registry.js

@@ -0,0 +1,220 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudeDesktopConfigPath = claudeDesktopConfigPath;
+exports.createClients = createClients;
+exports.allClients = allClients;
+exports.clientById = clientById;
+exports.clientStatuses = clientStatuses;
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const constants_1 = require("../constants");
+const types_1 = require("../types");
+const jsonClient_1 = require("./jsonClient");
+const claudeCode_1 = require("./claudeCode");
+const codex_1 = require("./codex");
+/** Per-OS location of Claude Desktop's config file. */
+function claudeDesktopConfigPath(home) {
+    if (process.platform === "win32") {
+        return path.join(home, "AppData", "Roaming", "Claude", "claude_desktop_config.json");
+    }
+    if (process.platform === "darwin") {
+        return path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    }
+    return path.join(home, ".config", "Claude", "claude_desktop_config.json");
+}
+/**
+ * Build the client set rooted at a given home directory. Production callers
+ * use the real home (the default); tests pass a temp dir.
+ */
+function createClients(home = os.homedir()) {
+    /** Cursor: supports remote HTTP MCP + the MCP authorization spec. */
+    const cursor = (0, jsonClient_1.jsonClient)({
+        id: "cursor",
+        name: "Cursor",
+        supportsOAuth: true,
+        configPath: path.join(home, ".cursor", "mcp.json"),
+        detectPaths: [path.join(home, ".cursor")],
+        rootKey: "mcpServers",
+        buildEntry(auth) {
+            const { url, headers } = (0, types_1.endpointFor)(auth);
+            return headers ? { url, headers } : { url };
+        },
+    });
+    /**
+     * Windsurf (now Cognition/Devin Desktop): HTTP servers use `serverUrl`
+     * (also accepts `url`; serverUrl is the long-supported key). OAuth for
+     * URL-only entries confirmed in docs.devin.ai/desktop/cascade/mcp.
+     */
+    const windsurf = (0, jsonClient_1.jsonClient)({
+        id: "windsurf",
+        name: "Windsurf",
+        supportsOAuth: true,
+        configPath: path.join(home, ".codeium", "windsurf", "mcp_config.json"),
+        detectPaths: [path.join(home, ".codeium", "windsurf")],
+        rootKey: "mcpServers",
+        buildEntry(auth) {
+            const { url, headers } = (0, types_1.endpointFor)(auth);
+            return headers ? { serverUrl: url, headers } : { serverUrl: url };
+        },
+    });
+    /**
+     * Google Antigravity: `serverUrl` (legacy `url`/`httpUrl` are rejected),
+     * headers supported, OAuth automatic for DCR-capable servers.
+     * Global config: ~/.gemini/config/mcp_config.json.
+     */
+    const antigravity = (0, jsonClient_1.jsonClient)({
+        id: "antigravity",
+        name: "Google Antigravity",
+        supportsOAuth: true,
+        configPath: path.join(home, ".gemini", "config", "mcp_config.json"),
+        detectPaths: [
+            path.join(home, ".gemini", "antigravity"),
+            path.join(home, ".gemini", "config", "mcp_config.json"),
+        ],
+        rootKey: "mcpServers",
+        buildEntry(auth) {
+            const { url, headers } = (0, types_1.endpointFor)(auth);
+            return headers ? { serverUrl: url, headers } : { serverUrl: url };
+        },
+    });
+    /**
+     * Devin CLI / Devin for Terminal: ~/.config/devin/mcp_config.json,
+     * `url` + optional `transport: "http"` + headers; OAuth via
+     * `devin mcp login <name>` browser flow.
+     */
+    const devinCli = (0, jsonClient_1.jsonClient)({
+        id: "devin-cli",
+        name: "Devin CLI",
+        supportsOAuth: true,
+        configPath: path.join(home, ".config", "devin", "mcp_config.json"),
+        detectPaths: [path.join(home, ".config", "devin")],
+        rootKey: "mcpServers",
+        buildEntry(auth) {
+            const { url, headers } = (0, types_1.endpointFor)(auth);
+            return headers
+                ? { url, transport: "http", headers }
+                : { url, transport: "http" };
+        },
+    });
+    /**
+     * JetBrains Junie: user-level ~/.junie/mcp/mcp.json, `url` + headers,
+     * OAuth browser flow on "Authorization required". (JetBrains AI Assistant
+     * itself is UI-configured only — covered by docs, not the registrar.)
+     */
+    const junie = (0, jsonClient_1.jsonClient)({
+        id: "junie",
+        name: "JetBrains Junie",
+        supportsOAuth: true,
+        configPath: path.join(home, ".junie", "mcp", "mcp.json"),
+        detectPaths: [path.join(home, ".junie")],
+        rootKey: "mcpServers",
+        buildEntry(auth) {
+            const { url, headers } = (0, types_1.endpointFor)(auth);
+            return headers ? { url, headers } : { url };
+        },
+    });
+    /**
+     * Claude Desktop: its config file only supports stdio servers, so bridge to
+     * the remote endpoint with `mcp-remote` (npx). OAuth mode runs mcp-remote's
+     * own browser flow against the OAuth endpoint; token mode passes the bearer
+     * header via an env var (mcp-remote expands ${...} in --header, and this
+     * avoids the arg-splitting some stdio clients do on spaces). Requires Node on
+     * the user's machine — inherent to the bridge.
+     */
+    const claudeDesktop = (0, jsonClient_1.jsonClient)({
+        id: "claude-desktop",
+        name: "Claude Desktop",
+        supportsOAuth: true,
+        configPath: claudeDesktopConfigPath(home),
+        detectPaths: [path.dirname(claudeDesktopConfigPath(home))],
+        rootKey: "mcpServers",
+        buildEntry(auth) {
+            if (auth.kind === "oauth") {
+                return { command: "npx", args: ["-y", "mcp-remote", constants_1.MCP_OAUTH_URL] };
+            }
+            return {
+                command: "npx",
+                args: ["-y", "mcp-remote", constants_1.MCP_BEARER_URL, "--header", "Authorization:${HOSTAFRICA_AUTH}"],
+                env: { HOSTAFRICA_AUTH: `Bearer ${auth.token}` },
+            };
+        },
+    });
+    /** Gemini CLI: HTTP servers use `httpUrl` in ~/.gemini/settings.json. */
+    const geminiCli = (0, jsonClient_1.jsonClient)({
+        id: "gemini-cli",
+        name: "Gemini CLI",
+        supportsOAuth: true,
+        configPath: path.join(home, ".gemini", "settings.json"),
+        detectPaths: [path.join(home, ".gemini")],
+        rootKey: "mcpServers",
+        buildEntry(auth) {
+            const { url, headers } = (0, types_1.endpointFor)(auth);
+            return headers ? { httpUrl: url, headers } : { httpUrl: url };
+        },
+    });
+    // claudeCode drives the `claude` CLI, which resolves its own home.
+    return [
+        claudeCode_1.claudeCode,
+        cursor,
+        windsurf,
+        geminiCli,
+        (0, codex_1.makeCodex)(home),
+        antigravity,
+        devinCli,
+        junie,
+        claudeDesktop,
+    ];
+}
+/**
+ * All clients the registrar can configure directly. VS Code itself is not in
+ * this list: the extension registers the server natively through the
+ * McpServerDefinitionProvider API instead of writing config files.
+ */
+function allClients() {
+    return createClients();
+}
+function clientById(id) {
+    return allClients().find((c) => c.id === id);
+}
+/** Installed/registered status for every known client. */
+async function clientStatuses() {
+    return Promise.all(allClients().map(async (client) => {
+        const installed = await client.detect();
+        const registered = installed ? await client.isRegistered() : false;
+        return { client, installed, registered };
+    }));
+}
+//# sourceMappingURL=registry.js.map

package/dist/clients/registry.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,11 @@
+/** OAuth 2.0 MCP endpoint — clients implementing the MCP authorization spec
+ *  drive the browser flow themselves; no credentials are written anywhere. */
+export declare const MCP_OAUTH_URL = "https://mcp.hostafrica.com/mcp";
+/** Bearer-token MCP endpoint — fallback for clients without MCP OAuth support. */
+export declare const MCP_BEARER_URL = "https://api.hostafrica.com/mcp";
+/** Key under which the server is registered in every client's config. */
+export declare const SERVER_KEY = "hostafrica";
+/** Human-facing label for the server. */
+export declare const SERVER_LABEL = "HostAfrica";
+export declare const CLIENT_AREA_URL = "https://panel.hostafrica.com/";
+export declare const DEVELOPER_DOCS_URL = "https://www.hostafrica.com/developers/";

package/dist/constants.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEVELOPER_DOCS_URL = exports.CLIENT_AREA_URL = exports.SERVER_LABEL = exports.SERVER_KEY = exports.MCP_BEARER_URL = exports.MCP_OAUTH_URL = void 0;
+/** OAuth 2.0 MCP endpoint — clients implementing the MCP authorization spec
+ *  drive the browser flow themselves; no credentials are written anywhere. */
+exports.MCP_OAUTH_URL = "https://mcp.hostafrica.com/mcp";
+/** Bearer-token MCP endpoint — fallback for clients without MCP OAuth support. */
+exports.MCP_BEARER_URL = "https://api.hostafrica.com/mcp";
+/** Key under which the server is registered in every client's config. */
+exports.SERVER_KEY = "hostafrica";
+/** Human-facing label for the server. */
+exports.SERVER_LABEL = "HostAfrica";
+exports.CLIENT_AREA_URL = "https://panel.hostafrica.com/";
+exports.DEVELOPER_DOCS_URL = "https://www.hostafrica.com/developers/";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAA;8EAC8E;AACjE,QAAA,aAAa,GAAG,gCAAgC,CAAC;AAE9D,kFAAkF;AACrE,QAAA,cAAc,GAAG,gCAAgC,CAAC;AAE/D,yEAAyE;AAC5D,QAAA,UAAU,GAAG,YAAY,CAAC;AAEvC,yCAAyC;AAC5B,QAAA,YAAY,GAAG,YAAY,CAAC;AAE5B,QAAA,eAAe,GAAG,+BAA+B,CAAC;AAClD,QAAA,kBAAkB,GAAG,wCAAwC,CAAC"}

package/dist/deeplinks.d.ts

@@ -0,0 +1,6 @@
+/**
+ * One-click Cursor install link for the docs site / client panel — registers
+ * the OAuth endpoint with no extension involved. Format per
+ * cursor.com/docs/mcp/install-links: base64 of the server's config object.
+ */
+export declare function cursorInstallDeeplink(): string;

package/dist/deeplinks.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cursorInstallDeeplink = cursorInstallDeeplink;
+const constants_1 = require("./constants");
+/**
+ * One-click Cursor install link for the docs site / client panel — registers
+ * the OAuth endpoint with no extension involved. Format per
+ * cursor.com/docs/mcp/install-links: base64 of the server's config object.
+ */
+function cursorInstallDeeplink() {
+    const config = { type: "http", url: constants_1.MCP_OAUTH_URL };
+    const b64 = Buffer.from(JSON.stringify(config), "utf8").toString("base64");
+    return `cursor://anysphere.cursor-deeplink/mcp/install?name=${constants_1.SERVER_KEY}&config=${encodeURIComponent(b64)}`;
+}
+//# sourceMappingURL=deeplinks.js.map

package/dist/deeplinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deeplinks.js","sourceRoot":"","sources":["../src/deeplinks.ts"],"names":[],"mappings":";;AAOA,sDAIC;AAXD,2CAAwD;AAExD;;;;GAIG;AACH,SAAgB,qBAAqB;IACnC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,yBAAa,EAAE,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC3E,OAAO,uDAAuD,sBAAU,WAAW,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/G,CAAC"}

package/dist/fsutil.d.ts

@@ -0,0 +1,14 @@
+import { execFile } from "node:child_process";
+declare const execFileP: typeof execFile.__promisify__;
+export declare function exists(p: string): Promise<boolean>;
+/** Locate a binary on PATH (`which` on POSIX, `where` on Windows). */
+export declare function whichBin(bin: string): Promise<string | undefined>;
+export declare function readTextIfPresent(p: string): Promise<string | undefined>;
+/**
+ * Write a config file that may contain a bearer token: parent dirs created,
+ * mode 600 so other local users can't read it. The mode option on writeFile
+ * only applies to newly created files, so chmod explicitly for existing ones
+ * (no-op semantics on Windows, where fs permissions work differently).
+ */
+export declare function writePrivate(p: string, content: string): Promise<void>;
+export { execFileP };

package/dist/fsutil.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execFileP = void 0;
+exports.exists = exists;
+exports.whichBin = whichBin;
+exports.readTextIfPresent = readTextIfPresent;
+exports.writePrivate = writePrivate;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const execFileP = (0, node_util_1.promisify)(node_child_process_1.execFile);
+exports.execFileP = execFileP;
+async function exists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Locate a binary on PATH (`which` on POSIX, `where` on Windows). */
+async function whichBin(bin) {
+    const finder = process.platform === "win32" ? "where" : "which";
+    try {
+        const { stdout } = await execFileP(finder, [bin]);
+        const first = stdout.split(/\r?\n/).find((l) => l.trim().length > 0);
+        return first?.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readTextIfPresent(p) {
+    try {
+        return await fs.readFile(p, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Write a config file that may contain a bearer token: parent dirs created,
+ * mode 600 so other local users can't read it. The mode option on writeFile
+ * only applies to newly created files, so chmod explicitly for existing ones
+ * (no-op semantics on Windows, where fs permissions work differently).
+ */
+async function writePrivate(p, content) {
+    await fs.mkdir(path.dirname(p), { recursive: true });
+    await fs.writeFile(p, content, { encoding: "utf8", mode: 0o600 });
+    if (process.platform !== "win32") {
+        await fs.chmod(p, 0o600);
+    }
+}
+//# sourceMappingURL=fsutil.js.map

package/dist/fsutil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsutil.js","sourceRoot":"","sources":["../src/fsutil.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,wBAOC;AAGD,4BASC;AAED,8CAMC;AAQD,oCAMC;AAhDD,qDAAuC;AACvC,gDAAkC;AAClC,2DAA8C;AAC9C,yCAAsC;AAEtC,MAAM,SAAS,GAAG,IAAA,qBAAS,EAAC,6BAAQ,CAAC,CAAC;AA6C7B,8BAAS;AA3CX,KAAK,UAAU,MAAM,CAAC,CAAS;IACpC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,sEAAsE;AAC/D,KAAK,UAAU,QAAQ,CAAC,GAAW;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrE,OAAO,KAAK,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,iBAAiB,CAAC,CAAS;IAC/C,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,YAAY,CAAC,CAAS,EAAE,OAAe;IAC3D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./constants";
+export * from "./types";
+export { allClients, clientById, clientStatuses, createClients } from "./clients/registry";
+export { jsonClient } from "./clients/jsonClient";
+export type { JsonClientSpec } from "./clients/jsonClient";
+export { claudeAddArgs } from "./clients/claudeCode";
+export { makeCodex } from "./clients/codex";
+export { cursorInstallDeeplink } from "./deeplinks";

package/dist/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cursorInstallDeeplink = exports.makeCodex = exports.claudeAddArgs = exports.jsonClient = exports.createClients = exports.clientStatuses = exports.clientById = exports.allClients = void 0;
+__exportStar(require("./constants"), exports);
+__exportStar(require("./types"), exports);
+var registry_1 = require("./clients/registry");
+Object.defineProperty(exports, "allClients", { enumerable: true, get: function () { return registry_1.allClients; } });
+Object.defineProperty(exports, "clientById", { enumerable: true, get: function () { return registry_1.clientById; } });
+Object.defineProperty(exports, "clientStatuses", { enumerable: true, get: function () { return registry_1.clientStatuses; } });
+Object.defineProperty(exports, "createClients", { enumerable: true, get: function () { return registry_1.createClients; } });
+var jsonClient_1 = require("./clients/jsonClient");
+Object.defineProperty(exports, "jsonClient", { enumerable: true, get: function () { return jsonClient_1.jsonClient; } });
+var claudeCode_1 = require("./clients/claudeCode");
+Object.defineProperty(exports, "claudeAddArgs", { enumerable: true, get: function () { return claudeCode_1.claudeAddArgs; } });
+var codex_1 = require("./clients/codex");
+Object.defineProperty(exports, "makeCodex", { enumerable: true, get: function () { return codex_1.makeCodex; } });
+var deeplinks_1 = require("./deeplinks");
+Object.defineProperty(exports, "cursorInstallDeeplink", { enumerable: true, get: function () { return deeplinks_1.cursorInstallDeeplink; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB;AACxB,+CAA2F;AAAlF,sGAAA,UAAU,OAAA;AAAE,sGAAA,UAAU,OAAA;AAAE,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA;AAC9D,mDAAkD;AAAzC,wGAAA,UAAU,OAAA;AAEnB,mDAAqD;AAA5C,2GAAA,aAAa,OAAA;AACtB,yCAA4C;AAAnC,kGAAA,SAAS,OAAA;AAClB,yCAAoD;AAA3C,kHAAA,qBAAqB,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,40 @@
+export type AuthMode = {
+    kind: "oauth";
+} | {
+    kind: "token";
+    token: string;
+};
+export interface Endpoint {
+    url: string;
+    headers?: Record<string, string>;
+}
+/** Resolve the endpoint + headers a given auth mode maps to. */
+export declare function endpointFor(auth: AuthMode): Endpoint;
+export interface RegisterOptions {
+    auth: AuthMode;
+}
+export interface McpClient {
+    /** Stable id, e.g. "cursor". */
+    id: string;
+    /** Display name, e.g. "Cursor". */
+    name: string;
+    /**
+     * Whether this client currently implements the MCP authorization spec for
+     * remote HTTP servers. Flip per client as support lands — the registrar
+     * picks OAuth whenever this is true, token fallback otherwise.
+     */
+    supportsOAuth: boolean;
+    /** Whether the client appears to be installed on this machine. */
+    detect(): Promise<boolean>;
+    /** Whether the HostAfrica server is currently registered with this client. */
+    isRegistered(): Promise<boolean>;
+    register(opts: RegisterOptions): Promise<void>;
+    unregister(): Promise<void>;
+    /** Where the registration lives (config path or command), for display. */
+    describeTarget(): string;
+}
+export interface ClientStatus {
+    client: McpClient;
+    installed: boolean;
+    registered: boolean;
+}

package/dist/types.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endpointFor = endpointFor;
+const constants_1 = require("./constants");
+/** Resolve the endpoint + headers a given auth mode maps to. */
+function endpointFor(auth) {
+    if (auth.kind === "oauth") {
+        return { url: constants_1.MCP_OAUTH_URL };
+    }
+    return {
+        url: constants_1.MCP_BEARER_URL,
+        headers: { Authorization: `Bearer ${auth.token}` },
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;AAYA,kCAQC;AApBD,2CAA4D;AAW5D,gEAAgE;AAChE,SAAgB,WAAW,CAAC,IAAc;IACxC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,yBAAa,EAAE,CAAC;IAChC,CAAC;IACD,OAAO;QACL,GAAG,EAAE,0BAAc;QACnB,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE,EAAE;KACnD,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@hostafrica/connector-core",
+  "version": "1.0.0",
+  "description": "Registrar core for the HostAfrica Connector: detects AI clients and registers the HostAfrica MCP server with each, OAuth-first",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hostafrica-dev/ha-connector.git",
+    "directory": "packages/core"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p .",
+    "check": "tsc -p . --noEmit",
+    "test": "tsc -p tsconfig.test.json && node --test \"dist-test/test/*.test.js\""
+  },
+  "dependencies": {
+    "smol-toml": "^1.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.4"
+  }
+}