@miraland-labs/conduit-bridge 0.1.0

package/dist/service.js

@@ -0,0 +1,153 @@
+import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { homedir, platform } from "node:os";
+import { dirname, join } from "node:path";
+import { realpathSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+export const SERVICE_LABEL = "io.miraland.conduit-runner";
+function configDir() {
+    return join(homedir(), ".config", "conduit");
+}
+function serviceStatePath() {
+    return join(configDir(), "service.json");
+}
+function logPath() {
+    return join(homedir(), "Library", "Logs", "conduit-runner.log");
+}
+function linuxLogDir() {
+    return join(homedir(), ".local", "state", "conduit");
+}
+/** Resolve node + cli.js (+ runner args) for the installed binary. */
+export function runnerProgramArguments(options = {}) {
+    const cli = process.argv[1] ? realpathSync(process.argv[1]) : "";
+    if (!cli)
+        throw new Error("Unable to resolve the conduit CLI path");
+    const args = [process.execPath, cli, "runner"];
+    if (options.agent)
+        args.push("--agent", options.agent);
+    if (options.workspace)
+        args.push("--workspace", options.workspace);
+    if (options.interval)
+        args.push("--interval", options.interval);
+    if (options.agentTimeoutMinutes)
+        args.push("--agent-timeout-minutes", options.agentTimeoutMinutes);
+    return args;
+}
+export function launchdPlist(programArguments, stdoutPath) {
+    const argsXml = programArguments.map((arg) => `    <string>${escapeXml(arg)}</string>`).join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${SERVICE_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${argsXml}
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${escapeXml(stdoutPath)}</string>
+  <key>StandardErrorPath</key>
+  <string>${escapeXml(stdoutPath)}</string>
+</dict>
+</plist>
+`;
+}
+export function systemdUserUnit(programArguments, workingDirectory) {
+    const execStart = programArguments.map(escapeSystemd).join(" ");
+    return `[Unit]
+Description=Conduit Bridge runner
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+WorkingDirectory=${workingDirectory}
+ExecStart=${execStart}
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=default.target
+`;
+}
+function escapeXml(value) {
+    return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+}
+function escapeSystemd(value) {
+    if (/[\s"'\\]/.test(value))
+        return `"${value.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+    return value;
+}
+function launchAgentsPath() {
+    return join(homedir(), "Library", "LaunchAgents", `${SERVICE_LABEL}.plist`);
+}
+function systemdUnitPath() {
+    return join(homedir(), ".config", "systemd", "user", "conduit-runner.service");
+}
+function run(command, args) {
+    const result = spawnSync(command, args, { encoding: "utf8" });
+    if (result.status !== 0) {
+        const detail = (result.stderr || result.stdout || `exit ${result.status}`).trim();
+        throw new Error(`${command} ${args.join(" ")} failed: ${detail}`);
+    }
+}
+export async function installRunnerService(options = {}) {
+    const host = platform();
+    if (host !== "darwin" && host !== "linux") {
+        throw new Error(`install-service is supported on macOS and Linux only (got ${host})`);
+    }
+    const programArguments = runnerProgramArguments(options);
+    if (host === "darwin") {
+        const plistPath = launchAgentsPath();
+        await mkdir(dirname(plistPath), { recursive: true });
+        await mkdir(dirname(logPath()), { recursive: true });
+        await writeFile(plistPath, launchdPlist(programArguments, logPath()), { mode: 0o644 });
+        // Prefer modern bootout/bootstrap; fall back to load for older macOS.
+        spawnSync("launchctl", ["bootout", `gui/${process.getuid?.() ?? 501}/${SERVICE_LABEL}`], { encoding: "utf8" });
+        const boot = spawnSync("launchctl", ["bootstrap", `gui/${process.getuid?.() ?? 501}`, plistPath], { encoding: "utf8" });
+        if (boot.status !== 0) {
+            run("launchctl", ["load", "-w", plistPath]);
+        }
+        await writeFile(serviceStatePath(), `${JSON.stringify({ platform: "darwin", programArguments, options, installed_at: new Date().toISOString() }, null, 2)}\n`, { mode: 0o600 });
+        return { path: plistPath, platform: "darwin" };
+    }
+    const unitPath = systemdUnitPath();
+    await mkdir(dirname(unitPath), { recursive: true });
+    await mkdir(linuxLogDir(), { recursive: true });
+    await writeFile(unitPath, systemdUserUnit(programArguments, configDir()), { mode: 0o644 });
+    run("systemctl", ["--user", "daemon-reload"]);
+    run("systemctl", ["--user", "enable", "--now", "conduit-runner.service"]);
+    await writeFile(serviceStatePath(), `${JSON.stringify({ platform: "linux", programArguments, options, installed_at: new Date().toISOString() }, null, 2)}\n`, { mode: 0o600 });
+    return { path: unitPath, platform: "linux" };
+}
+export async function uninstallRunnerService() {
+    const host = platform();
+    if (host !== "darwin" && host !== "linux") {
+        throw new Error(`uninstall-service is supported on macOS and Linux only (got ${host})`);
+    }
+    let stored = null;
+    try {
+        stored = JSON.parse(await readFile(serviceStatePath(), "utf8"));
+    }
+    catch {
+        stored = null;
+    }
+    if (host === "darwin") {
+        const plistPath = launchAgentsPath();
+        spawnSync("launchctl", ["bootout", `gui/${process.getuid?.() ?? 501}/${SERVICE_LABEL}`], { encoding: "utf8" });
+        spawnSync("launchctl", ["unload", "-w", plistPath], { encoding: "utf8" });
+        await unlink(plistPath).catch(() => undefined);
+        await unlink(serviceStatePath()).catch(() => undefined);
+        return { path: plistPath, platform: stored?.platform ?? "darwin" };
+    }
+    const unitPath = systemdUnitPath();
+    spawnSync("systemctl", ["--user", "disable", "--now", "conduit-runner.service"], { encoding: "utf8" });
+    await unlink(unitPath).catch(() => undefined);
+    spawnSync("systemctl", ["--user", "daemon-reload"], { encoding: "utf8" });
+    await unlink(serviceStatePath()).catch(() => undefined);
+    return { path: unitPath, platform: stored?.platform ?? "linux" };
+}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@miraland-labs/conduit-bridge",
+  "version": "0.1.0",
+  "description": "Conduit Bridge CLI — join, connect, and run local agent work for a Conduit organization",
+  "type": "module",
+  "bin": {
+    "conduit": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/miralandlabs/conduit.git",
+    "directory": "packages/conduit-bridge"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1"
+  }
+}