@0xmaxma/claude-gateway 1.7.9 → 1.8.0

package/dist/cli/commands/gateway.js.map

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

package/dist/cli/commands/service.d.ts

@@ -0,0 +1,33 @@
+import { CliConfigView } from '../http-client';
+export type ServiceManager = 'systemd' | 'pm2';
+export interface LaunchSpec {
+    node: string;
+    entry: string;
+    cwd: string;
+    config: string;
+    home: string;
+    pathEnv: string;
+}
+/**
+ * Build the PATH the service will run with.
+ *
+ * The inherited PATH is not usable: an interactive shell's PATH is full of
+ * session-scoped entries (editor servers, per-project node_modules/.bin) that
+ * may not exist when systemd starts the unit at boot. Instead, pin the
+ * directories the gateway actually needs — the node that will run it, the
+ * `claude` binary it spawns, and the standard system paths — keeping only
+ * those that exist.
+ */
+export declare function servicePath(): string;
+/** Resolve the absolute launch triple (node, entry, cwd) for a generated unit.
+ *  Returns null — with a message — when the entry point can't be located, so a
+ *  broken install never produces a unit that silently fails at boot. */
+export declare function resolveLaunchSpec(flags: Record<string, string | boolean>): LaunchSpec | null;
+/** Pure renderer — exported so `--print` and the tests see the exact bytes that
+ *  would be written to disk. */
+export declare function renderSystemdUnit(spec: LaunchSpec): string;
+/** The exact argv `service install --manager pm2` would run. Exported for
+ *  `--print` and tests so the preview can never drift from the real call. */
+export declare function pm2StartArgs(spec: LaunchSpec): string[];
+export declare function runService(positionals: string[], flags: Record<string, string | boolean>, config?: CliConfigView): Promise<number>;
+//# sourceMappingURL=service.d.ts.map

package/dist/cli/commands/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAmB,MAAM,gBAAgB,CAAC;AA0BhE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,KAAK,CAAC;AAG/C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAoBpC;AAYD;;wEAEwE;AACxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,UAAU,GAAG,IAAI,CAwB5F;AAQD;gCACgC;AAChC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAwB1D;AAED;6EAC6E;AAC7E,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,CAevD;AAgUD,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EACvC,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,CAiCjB"}

package/dist/cli/commands/service.js

@@ -0,0 +1,513 @@
+"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.servicePath = servicePath;
+exports.resolveLaunchSpec = resolveLaunchSpec;
+exports.renderSystemdUnit = renderSystemdUnit;
+exports.pm2StartArgs = pm2StartArgs;
+exports.runService = runService;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const http_client_1 = require("../http-client");
+const prompt_1 = require("../prompt");
+const health_1 = require("../health");
+const output_1 = require("../output");
+const paths_1 = require("../../utils/paths");
+const output_2 = require("../output");
+/**
+ * `service install|status|uninstall` — run the gateway under a process manager.
+ *
+ * systemd installs a *user* unit (`~/.config/systemd/user/`) so no privilege
+ * escalation is needed and the service runs as the same user that owns
+ * ~/.claude-gateway. PM2 is offered for hosts that already standardise on it.
+ *
+ * Everything the generated unit references is an absolute path resolved here
+ * (node binary, entry point, config, working directory) — a unit that inherits
+ * PATH or cwd from an interactive shell breaks the moment systemd starts it at
+ * boot. Secrets are never written into the unit: the gateway reads
+ * ~/.claude-gateway/.env itself.
+ */
+const UNIT_NAME = 'claude-gateway.service';
+const PM2_NAME = 'gateway';
+const HEALTH_ATTEMPTS = 20;
+const HEALTH_INTERVAL_MS = 500;
+function gatewayHome() {
+    return path.join(os.homedir(), '.claude-gateway');
+}
+function configPath(flags) {
+    const explicit = typeof flags.config === 'string' ? flags.config : process.env.GATEWAY_CONFIG;
+    return path.resolve((0, paths_1.expandHome)(explicit ?? path.join(gatewayHome(), 'config.json')));
+}
+/**
+ * Build the PATH the service will run with.
+ *
+ * The inherited PATH is not usable: an interactive shell's PATH is full of
+ * session-scoped entries (editor servers, per-project node_modules/.bin) that
+ * may not exist when systemd starts the unit at boot. Instead, pin the
+ * directories the gateway actually needs — the node that will run it, the
+ * `claude` binary it spawns, and the standard system paths — keeping only
+ * those that exist.
+ */
+function servicePath() {
+    const candidates = [
+        path.dirname(process.execPath),
+        claudeBinDir(),
+        path.join(os.homedir(), '.local', 'bin'),
+        path.join(os.homedir(), '.bun', 'bin'),
+        '/usr/local/sbin',
+        '/usr/local/bin',
+        '/usr/sbin',
+        '/usr/bin',
+        '/sbin',
+        '/bin',
+    ];
+    const seen = new Set();
+    const dirs = candidates.filter((dir) => {
+        if (!dir || seen.has(dir))
+            return false;
+        seen.add(dir);
+        return fs.existsSync(dir);
+    });
+    return dirs.join(':');
+}
+/** Where the `claude` binary the gateway spawns currently lives, if resolvable. */
+function claudeBinDir() {
+    try {
+        const resolved = capture('which', ['claude']).trim();
+        return resolved ? path.dirname(resolved) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Resolve the absolute launch triple (node, entry, cwd) for a generated unit.
+ *  Returns null — with a message — when the entry point can't be located, so a
+ *  broken install never produces a unit that silently fails at boot. */
+function resolveLaunchSpec(flags) {
+    // dist/cli/commands/service.js → dist/entry.js, the thin dispatcher that
+    // loads only the side it needs. index.js is still a working boot entry and is
+    // used when a partially-updated install predates the split, so a unit is
+    // never written pointing at a file that is not there.
+    const dir = path.resolve(__dirname, '..', '..');
+    const thin = path.join(dir, 'entry.js');
+    const entry = fs.existsSync(thin) ? thin : path.join(dir, 'index.js');
+    const node = process.execPath;
+    if (!path.isAbsolute(node) || !fs.existsSync(entry)) {
+        process.stderr.write(`Cannot resolve the installed claude-gateway entry point (looked for ${entry}). ` +
+            'Reinstall the package and try again.\n');
+        return null;
+    }
+    return {
+        node,
+        entry,
+        cwd: gatewayHome(),
+        config: configPath(flags),
+        home: os.homedir(),
+        pathEnv: servicePath(),
+    };
+}
+/** systemd unit values are double-quoted here, so backslashes and quotes must
+ *  be escaped or a path containing them would terminate the value early. */
+function systemdQuote(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/** Pure renderer — exported so `--print` and the tests see the exact bytes that
+ *  would be written to disk. */
+function renderSystemdUnit(spec) {
+    const q = systemdQuote;
+    return `[Unit]
+Description=Claude Gateway
+Documentation=https://github.com/0xMaxMa/claude-gateway
+Wants=network-online.target
+After=network-online.target
+
+[Service]
+Type=simple
+# WorkingDirectory is deliberately unquoted, unlike every other value here:
+# systemd takes the rest of the line as the path, and rejects a quoted one
+# ("path is not absolute"). Escaping is unnecessary for the same reason.
+WorkingDirectory=${spec.cwd}
+Environment="HOME=${q(spec.home)}"
+Environment="PATH=${q(spec.pathEnv)}"
+Environment="GATEWAY_CONFIG=${q(spec.config)}"
+ExecStart="${q(spec.node)}" "${q(spec.entry)}" gateway start --config "${q(spec.config)}"
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=default.target
+`;
+}
+/** The exact argv `service install --manager pm2` would run. Exported for
+ *  `--print` and tests so the preview can never drift from the real call. */
+function pm2StartArgs(spec) {
+    return [
+        'start',
+        spec.node,
+        '--name',
+        PM2_NAME,
+        '--cwd',
+        spec.cwd,
+        '--',
+        spec.entry,
+        'gateway',
+        'start',
+        '--config',
+        spec.config,
+    ];
+}
+function unitPath() {
+    return path.join(os.homedir(), '.config', 'systemd', 'user', UNIT_NAME);
+}
+function run(file, args) {
+    (0, child_process_1.execFileSync)(file, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+}
+function capture(file, args) {
+    return (0, child_process_1.execFileSync)(file, args, { stdio: ['ignore', 'pipe', 'ignore'] }).toString();
+}
+/** True when the failure was "no such binary" rather than the command itself
+ *  reporting a problem — so "PM2 is not installed" never gets reported as
+ *  "PM2 refused to save its process list". */
+function isMissingBinary(err) {
+    return err?.code === 'ENOENT';
+}
+/**
+ * Ask before changing service state — installing one, or stopping and removing
+ * one. `--yes` skips the prompt; a non-interactive stdin without `--yes`
+ * refuses rather than blocking forever, so this is safe in scripts and CI.
+ */
+async function confirm(flags, action, question) {
+    if (flags.yes === true)
+        return true;
+    if (!process.stdin.isTTY) {
+        process.stderr.write(`Refusing to ${action} non-interactively without --yes.\n`);
+        return false;
+    }
+    const rl = (0, prompt_1.createRl)();
+    try {
+        const answer = (await (0, prompt_1.ask)(rl, `${question} (y/N): `)).trim().toLowerCase();
+        return answer === 'y' || answer === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Poll /health so `service install` reports whether the service actually came
+ *  up, instead of only whether the manager accepted the unit.
+ *
+ *  Probes the local bind address, never config.publicUrl: a proxy in front of a
+ *  still-running old instance would answer for a service that never started. */
+async function waitForHealth(config, flags) {
+    const baseUrl = (0, http_client_1.resolveLocalUrl)({ flagUrl: typeof flags.url === 'string' ? flags.url : undefined, env: process.env, config });
+    for (let attempt = 0; attempt < HEALTH_ATTEMPTS; attempt++) {
+        if ((await (0, health_1.probeHealth)(baseUrl, 2000)).ok)
+            return true;
+        await new Promise((resolve) => setTimeout(resolve, HEALTH_INTERVAL_MS));
+    }
+    return false;
+}
+// ─── systemd (user scope) ─────────────────────────────────────────────────────
+function systemdState() {
+    let enabled = false;
+    let active = false;
+    try {
+        enabled = capture('systemctl', ['--user', 'is-enabled', UNIT_NAME]).trim() === 'enabled';
+    }
+    catch {
+        /* systemctl absent, or the unit is disabled/missing */
+    }
+    try {
+        active = capture('systemctl', ['--user', 'is-active', UNIT_NAME]).trim() === 'active';
+    }
+    catch {
+        /* systemctl absent, or the unit is inactive */
+    }
+    return { installed: fs.existsSync(unitPath()), enabled, active };
+}
+function systemdStatus(flags) {
+    const state = systemdState();
+    (0, output_1.printJson)({ manager: 'systemd-user', unit: unitPath(), ...state }, flags);
+    return state.active ? 0 : 1;
+}
+async function systemdInstall(flags, config) {
+    const spec = resolveLaunchSpec(flags);
+    if (!spec)
+        return 1;
+    const unit = renderSystemdUnit(spec);
+    const file = unitPath();
+    // stderr, not stdout: stdout carries the JSON result (see printJson).
+    (0, prompt_1.printFilePreview)(file, unit, (line) => process.stderr.write(line + '\n'));
+    if (flags.print === true)
+        return 0;
+    if (!(await confirm(flags, 'install', `Install and start ${UNIT_NAME} for user ${os.userInfo().username}?`))) {
+        process.stderr.write('Aborted — nothing was written.\n');
+        return 1;
+    }
+    try {
+        fs.mkdirSync(spec.cwd, { recursive: true });
+        fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+        fs.writeFileSync(file, unit, { encoding: 'utf8', mode: 0o600 });
+        run('systemctl', ['--user', 'daemon-reload']);
+        run('systemctl', ['--user', 'enable', '--now', UNIT_NAME]);
+    }
+    catch (err) {
+        process.stderr.write(`Could not install or start the user service: ${err.message}\n` +
+            `Inspect it with: systemctl --user status ${UNIT_NAME} --no-pager\n`);
+        return 1;
+    }
+    const healthy = await waitForHealth(config, flags);
+    (0, output_1.printJson)({ manager: 'systemd-user', unit: file, ...systemdState(), health: healthy ? 'up' : 'down' }, flags);
+    process.stderr.write(`Installed ${UNIT_NAME}.\n` +
+        `To keep it running after you log out: loginctl enable-linger ${os.userInfo().username}\n`);
+    if (!healthy) {
+        process.stderr.write(`Service did not answer /health yet — check: journalctl --user -u ${UNIT_NAME} -n 50 --no-pager\n`);
+        return 1;
+    }
+    return 0;
+}
+async function systemdUninstall(flags) {
+    const file = unitPath();
+    const before = systemdState();
+    if (!before.installed && !before.enabled && !before.active) {
+        // Nothing to stop — prompting to stop a service that isn't there only
+        // teaches people to answer these prompts without reading them.
+        (0, output_1.printJson)({ manager: 'systemd-user', unit: file, ...before }, flags);
+        process.stderr.write(`${UNIT_NAME} is not installed — nothing to remove.\n`);
+        return 0;
+    }
+    // `disable --now` stops a running gateway, so this asks like install does.
+    if (!(await confirm(flags, 'uninstall', `Stop and remove ${UNIT_NAME}?`))) {
+        process.stderr.write('Aborted — the service was left in place.\n');
+        return 1;
+    }
+    try {
+        run('systemctl', ['--user', 'disable', '--now', UNIT_NAME]);
+    }
+    catch {
+        /* already stopped, or never installed */
+    }
+    try {
+        fs.unlinkSync(file);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            process.stderr.write(`Could not remove ${file}: ${err.message}\n`);
+            return 1;
+        }
+    }
+    try {
+        run('systemctl', ['--user', 'daemon-reload']);
+    }
+    catch {
+        /* nothing to reload without systemd */
+    }
+    // Report what systemd actually says, not what was intended: the disable above
+    // is best-effort, and claiming a stopped service that is still running would
+    // be exactly the silent failure this codebase forbids.
+    const state = systemdState();
+    (0, output_1.printJson)({ manager: 'systemd-user', unit: file, ...state }, flags);
+    if (state.active || state.installed) {
+        process.stderr.write(`${UNIT_NAME} is still present — check: systemctl --user status ${UNIT_NAME} --no-pager\n`);
+        return 1;
+    }
+    return 0;
+}
+function pm2Entry() {
+    const list = JSON.parse(capture('pm2', ['jlist']));
+    return list.find((item) => item.name === PM2_NAME);
+}
+function pm2Status(flags) {
+    let entry;
+    try {
+        entry = pm2Entry();
+    }
+    catch (err) {
+        process.stderr.write(isMissingBinary(err)
+            ? 'PM2 is not installed or not on PATH.\n'
+            : 'Could not read the PM2 process list. Is PM2 running?\n');
+        return 1;
+    }
+    const status = entry?.pm2_env?.status ?? 'absent';
+    (0, output_1.printJson)({ manager: 'pm2', name: PM2_NAME, installed: !!entry, active: status === 'online', status }, flags);
+    return status === 'online' ? 0 : 1;
+}
+async function pm2Install(flags, config) {
+    const spec = resolveLaunchSpec(flags);
+    if (!spec)
+        return 1;
+    const args = pm2StartArgs(spec);
+    process.stderr.write(`\nWould run:\n  pm2 ${args.join(' ')}\n  pm2 save\n`);
+    if (flags.print === true)
+        return 0;
+    if (!(await confirm(flags, 'install', `Register and start the PM2 process "${PM2_NAME}"?`))) {
+        process.stderr.write('Aborted — nothing was registered.\n');
+        return 1;
+    }
+    try {
+        fs.mkdirSync(spec.cwd, { recursive: true });
+        // Replacing an existing entry is the documented way to change its argv.
+        try {
+            run('pm2', ['delete', PM2_NAME]);
+        }
+        catch {
+            /* first install — nothing to delete */
+        }
+        run('pm2', args);
+        run('pm2', ['save']);
+    }
+    catch (err) {
+        process.stderr.write(isMissingBinary(err)
+            ? 'PM2 is not installed. Install it first (`npm install -g pm2`), or use --manager systemd.\n'
+            : `Could not install or start the PM2 service: ${err.message}\nCheck: pm2 logs ${PM2_NAME}\n`);
+        return 1;
+    }
+    const healthy = await waitForHealth(config, flags);
+    (0, output_1.printJson)({ manager: 'pm2', name: PM2_NAME, installed: true, health: healthy ? 'up' : 'down' }, flags);
+    process.stderr.write('PM2 process list saved. Run `pm2 startup` once if you also want start-on-boot.\n');
+    if (!healthy) {
+        process.stderr.write(`Service did not answer /health yet — check: pm2 logs ${PM2_NAME}\n`);
+        return 1;
+    }
+    return 0;
+}
+async function pm2Uninstall(flags) {
+    let before;
+    try {
+        before = pm2Entry();
+    }
+    catch (err) {
+        if (isMissingBinary(err)) {
+            process.stderr.write('PM2 is not installed — nothing to remove.\n');
+            return 0;
+        }
+        process.stderr.write('Could not read the PM2 process list. Is PM2 running?\n');
+        return 1;
+    }
+    if (!before) {
+        (0, output_1.printJson)({ manager: 'pm2', name: PM2_NAME, installed: false, active: false }, flags);
+        process.stderr.write(`No PM2 process named "${PM2_NAME}" — nothing to remove.\n`);
+        return 0;
+    }
+    // `pm2 delete` stops a running gateway, so this asks like install does.
+    if (!(await confirm(flags, 'uninstall', `Stop and remove the PM2 process "${PM2_NAME}"?`))) {
+        process.stderr.write('Aborted — the process was left in place.\n');
+        return 1;
+    }
+    try {
+        run('pm2', ['delete', PM2_NAME]);
+    }
+    catch {
+        /* already absent */
+    }
+    try {
+        run('pm2', ['save']);
+    }
+    catch (err) {
+        process.stderr.write(isMissingBinary(err)
+            ? 'PM2 is not installed — nothing to remove.\n'
+            : 'Could not save the PM2 process list — the process may come back on the next PM2 resurrect.\n');
+        return isMissingBinary(err) ? 0 : 1;
+    }
+    // Same reason as the systemd path: report the observed state, not the intent.
+    let entry;
+    try {
+        entry = pm2Entry();
+    }
+    catch {
+        /* PM2 gone entirely — nothing left to report as running */
+    }
+    (0, output_1.printJson)({ manager: 'pm2', name: PM2_NAME, installed: !!entry, active: entry?.pm2_env?.status === 'online' }, flags);
+    return entry ? 1 : 0;
+}
+// ─── entry point ──────────────────────────────────────────────────────────────
+const USAGE_LINE = 'claude-gateway service <install|status|uninstall> [--manager systemd|pm2] [--config <path>] [--yes] [--print]';
+/** Pick the manager to act on when `--manager` is omitted. `status`/`uninstall`
+ *  act on whatever is actually installed; `install` always defaults to systemd
+ *  so it can't silently pick a different manager than the one documented. */
+function detectServiceManager(action) {
+    if (action === 'install')
+        return 'systemd';
+    if (fs.existsSync(unitPath()))
+        return 'systemd';
+    try {
+        if (pm2Entry())
+            return 'pm2';
+    }
+    catch {
+        /* PM2 not installed */
+    }
+    return 'systemd';
+}
+function parseManager(flags, action) {
+    const raw = flags.manager;
+    if (raw === undefined)
+        return detectServiceManager(action);
+    if (raw === 'systemd' || raw === 'pm2')
+        return raw;
+    process.stderr.write('Unknown --manager. Expected systemd or pm2.\n');
+    return null;
+}
+async function runService(positionals, flags, config = {}) {
+    const action = positionals[0];
+    if (!action) {
+        // `service --help` is a help request (0); a bare `service` is a usage error (1).
+        (0, output_2.writeCommandHelp)(flags.help === true, 'service', 'run the gateway as a systemd-user or PM2 service', USAGE_LINE, ['  systemd installs a user unit in ~/.config/systemd/user (no sudo).']);
+        return flags.help === true ? 0 : 1;
+    }
+    if (action !== 'install' && action !== 'status' && action !== 'uninstall') {
+        process.stderr.write(`Unknown: service ${action} (expected install|status|uninstall)\n`);
+        return 1;
+    }
+    if (flags.print === true && action !== 'install') {
+        // Rejected rather than ignored: silently accepting it would let someone
+        // believe `service uninstall --print` was a dry run.
+        process.stderr.write(`--print only applies to \`service install\` (it previews what would be written).\n`);
+        return 1;
+    }
+    const manager = parseManager(flags, action);
+    if (!manager)
+        return 1;
+    if (manager === 'systemd') {
+        if (action === 'install')
+            return systemdInstall(flags, config);
+        return action === 'status' ? systemdStatus(flags) : await systemdUninstall(flags);
+    }
+    if (action === 'install')
+        return pm2Install(flags, config);
+    return action === 'status' ? pm2Status(flags) : await pm2Uninstall(flags);
+}
+//# sourceMappingURL=service.js.map

package/dist/cli/commands/service.js.map

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

package/dist/cli/commands/update.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `update [check]` (the gateway itself) and `claude version|update [check]`
+ * (the Claude Code binary the gateway drives).
+ *
+ * Both delegate to src/packages/registry.ts — the same detect/install strategy
+ * the dashboard's Update button uses — so a package updated from the terminal
+ * and one updated from the UI end up in exactly the same place. `check` never
+ * writes anything; `update` always shows current → target and asks first.
+ */
+type PackageId = 'claude-gateway' | 'claude-code';
+/** `claude-gateway update [check]` — the gateway's own package. */
+export declare function runUpdate(id: PackageId, positionals: string[], flags: Record<string, string | boolean>): Promise<number>;
+/** `claude-gateway claude <version|update [check]>` — the Claude Code binary. */
+export declare function runClaude(positionals: string[], flags: Record<string, string | boolean>): Promise<number>;
+export {};
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/update.ts"],"names":[],"mappings":"AAeA;;;;;;;;GAQG;AAEH,KAAK,SAAS,GAAG,gBAAgB,GAAG,aAAa,CAAC;AA2HlD,mEAAmE;AACnE,wBAAsB,SAAS,CAC7B,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,iFAAiF;AACjF,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GACtC,OAAO,CAAC,MAAM,CAAC,CA4BjB"}