@0xmaxma/claude-gateway 1.7.9 → 1.8.0

package/dist/cli/index.js

@@ -0,0 +1,372 @@
+"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.CORE_HELP = exports.NOUN_NAME_W = exports.NAME_W = void 0;
+exports.runCli = runCli;
+exports.helpRow = helpRow;
+const path = __importStar(require("path"));
+const args_1 = require("./args");
+const commands_generated_1 = require("./commands.generated");
+const http_client_1 = require("./http-client");
+const output_1 = require("./output");
+const colors_1 = require("./colors");
+const gateway_1 = require("./commands/gateway");
+const service_1 = require("./commands/service");
+const update_1 = require("./commands/update");
+const doctor_1 = require("./commands/doctor");
+const debug_bundle_1 = require("./commands/debug-bundle");
+const agents_1 = require("./commands/agents");
+const channels_1 = require("./commands/channels");
+/** Flags that are always boolean regardless of command — never consume the next
+ *  token as a value (see parseCliArgs). */
+const GLOBAL_BOOLEAN_FLAGS = new Set(['help', 'json', 'yes', 'print']);
+/** Flags every command accepts, on top of whatever the generated manifest
+ *  declares for that command. Anything outside this set and the command's own
+ *  flags is a typo, and is reported rather than dropped: a resource command
+ *  builds its query/body from `cmd.flags` alone, so an unrecognised flag would
+ *  otherwise be parsed, ignored, and reported as success. */
+const GLOBAL_FLAG_NAMES = new Set([
+    ...GLOBAL_BOOLEAN_FLAGS,
+    'url',
+    'key',
+    'config',
+    'data',
+]);
+const HELP_ALIASES = new Set(['help', '--help', '-h']);
+const VERSION_ALIASES = new Set(['version', '--version', '-V']);
+/**
+ * CLI entry point. Returns a process exit code. Never boots the server — the
+ * boot entry (src/index.ts) only calls this when argv[2] is a CLI command.
+ *
+ * Convention: stdout carries the command's result (JSON, pretty by default or
+ * compact with `--json`); human-facing help and errors go to stderr, so result
+ * output is never polluted.
+ */
+async function runCli(argv) {
+    const [command, ...rest] = argv;
+    const { positionals, flags } = (0, args_1.parseCliArgs)(rest, GLOBAL_BOOLEAN_FLAGS);
+    const wantHelp = flags.help === true;
+    if (!command || HELP_ALIASES.has(command)) {
+        printGeneralHelp(true);
+        return 0;
+    }
+    if (VERSION_ALIASES.has(command)) {
+        process.stdout.write(readVersion() + '\n');
+        return 0;
+    }
+    // Flags with no command (`claude-gateway --config /etc/cg.json`) — the shape
+    // old service units used. There is nothing to run, so this is the same
+    // "here's what I can do" answer as a bare invocation, never a server boot.
+    if (command.startsWith('-')) {
+        printGeneralHelp(true);
+        return 0;
+    }
+    const config = (0, http_client_1.loadCliConfig)(typeof flags.config === 'string' ? flags.config : undefined);
+    try {
+        switch (command) {
+            case 'api':
+                return await runApiPassthrough(positionals, flags, config);
+            case 'gateway':
+                return await (0, gateway_1.runGatewayLifecycle)(positionals, flags, config);
+            case 'service':
+                return await (0, service_1.runService)(positionals, flags, config);
+            case 'update':
+                return await (0, update_1.runUpdate)('claude-gateway', positionals, flags);
+            case 'claude':
+                return await (0, update_1.runClaude)(positionals, flags);
+            case 'doctor':
+                return await (0, doctor_1.runDoctor)(flags, config);
+            case 'debug-bundle':
+                return await (0, debug_bundle_1.runDebugBundle)(flags);
+            case 'agents':
+                return await (0, agents_1.runAgents)(positionals, flags, config);
+            case 'channels':
+                return await (0, channels_1.runChannels)(positionals, flags, config);
+        }
+        // Resource nouns (generated).
+        if (!commands_generated_1.GENERATED_NOUNS.includes(command)) {
+            process.stderr.write(`Unknown command: ${command}\n\n`);
+            printGeneralHelp(false);
+            return 1;
+        }
+        return await runResourceCommand(command, rest, wantHelp, config);
+    }
+    catch (err) {
+        process.stderr.write(`Error: ${err.message}\n`);
+        return 1;
+    }
+}
+async function runResourceCommand(noun, rest, wantHelp, config) {
+    // First pass just to find the verb — a plain positional, so it parses the
+    // same regardless of which flags turn out to be boolean for this command.
+    const verb = (0, args_1.parseCliArgs)(rest, GLOBAL_BOOLEAN_FLAGS).positionals[0];
+    if (!verb) {
+        // `crons --help` is a help request (exit 0); a bare `crons` is a usage
+        // error (exit 1) even though both print the same listing.
+        printNounHelp(noun, wantHelp);
+        return wantHelp ? 0 : 1;
+    }
+    const cmd = commands_generated_1.GENERATED_COMMANDS.find((c) => c.noun === noun && c.verb === verb);
+    if (!cmd) {
+        process.stderr.write(`Unknown command: ${noun} ${verb}\n\n`);
+        printNounHelp(noun, false);
+        return 1;
+    }
+    if (wantHelp) {
+        printCommandHelp(cmd, true);
+        return 0;
+    }
+    // Re-parse now that the command's own boolean flags (e.g. `--force`) are
+    // known, so one placed right before a positional doesn't swallow it.
+    const booleanFlags = new Set([...GLOBAL_BOOLEAN_FLAGS, ...cmd.flags.filter((f) => f.boolean).map((f) => f.name)]);
+    const { positionals, flags } = (0, args_1.parseCliArgs)(rest, booleanFlags);
+    const restPositionals = positionals.slice(1);
+    // Positional path args
+    if (restPositionals.length < cmd.args.length) {
+        const missing = cmd.args.slice(restPositionals.length).map((a) => `<${a}>`).join(' ');
+        process.stderr.write(`Missing argument(s): ${missing}\n\n`);
+        printCommandHelp(cmd, false);
+        return 1;
+    }
+    let apiPath = cmd.path;
+    cmd.args.forEach((argName, idx) => {
+        apiPath = apiPath.replace(`:${argName}`, encodeURIComponent(restPositionals[idx]));
+    });
+    // Flags → query / body
+    const query = {};
+    let body;
+    if (typeof flags.data === 'string') {
+        let parsed;
+        try {
+            parsed = JSON.parse(flags.data);
+        }
+        catch {
+            process.stderr.write('Invalid --data: must be a JSON object.\n');
+            return 1;
+        }
+        // `JSON.parse` also accepts primitives and arrays. Merging flags into one
+        // of those throws further down (`'name' in 5`), surfacing a TypeError
+        // instead of the message above.
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            process.stderr.write('Invalid --data: must be a JSON object.\n');
+            return 1;
+        }
+        body = parsed;
+    }
+    const known = new Set([...GLOBAL_FLAG_NAMES, ...cmd.flags.map((f) => f.name)]);
+    const unknown = Object.keys(flags).filter((name) => !known.has(name));
+    if (unknown.length) {
+        // Same treatment as an unknown verb: refuse and show what is accepted. A
+        // mistyped flag used to reach the API as a missing field (`crons create
+        // --schedul ...` created a job with no schedule) or, on a command whose
+        // manifest declares no flags, as an empty body the server applied as a
+        // no-op — both exiting 0 as though they had worked.
+        process.stderr.write(`Unknown flag(s): ${unknown.map((f) => `--${f}`).join(' ')}\n\n`);
+        printCommandHelp(cmd, false);
+        return 1;
+    }
+    const missingRequired = [];
+    for (const f of cmd.flags) {
+        const val = flags[f.name];
+        if (val === undefined) {
+            if (f.required && !(body && f.name in body))
+                missingRequired.push(`--${f.name}`);
+            continue;
+        }
+        if (f.in === 'query') {
+            query[f.name] = String(val);
+        }
+        else {
+            body = body ?? {};
+            body[f.name] = f.boolean ? val === true || val === 'true' : val;
+        }
+    }
+    if (missingRequired.length) {
+        process.stderr.write(`Missing required flag(s): ${missingRequired.join(' ')}\n\n`);
+        printCommandHelp(cmd, false);
+        return 1;
+    }
+    const { baseUrl, fallbackUrl } = (0, http_client_1.resolveUrlPlan)({ flagUrl: strFlag(flags.url), env: process.env, config });
+    const key = (0, http_client_1.resolveKey)({ flagKey: strFlag(flags.key), env: process.env, config });
+    const result = await (0, http_client_1.request)({
+        method: cmd.method,
+        path: apiPath,
+        baseUrl,
+        fallbackBaseUrl: fallbackUrl,
+        key,
+        query,
+        body: cmd.method === 'GET' ? undefined : body,
+    });
+    (0, output_1.printResult)(result.data, flags.json === true);
+    return 0;
+}
+async function runApiPassthrough(positionals, flags, config) {
+    const method = (positionals[0] || '').toUpperCase();
+    const apiPath = positionals[1];
+    if (!method || !apiPath || flags.help === true) {
+        // An explicit `--help` succeeds; missing arguments are a usage error.
+        (0, output_1.writeCommandHelp)(flags.help === true, 'api', 'call any gateway endpoint directly (escape hatch)', 'claude-gateway api <METHOD> <path> [--data <json>] [--query k=v]');
+        return flags.help === true ? 0 : 1;
+    }
+    if (!apiPath.startsWith('/')) {
+        process.stderr.write('Path must start with "/" (e.g. /v1/agents)\n');
+        return 1;
+    }
+    let body;
+    if (typeof flags.data === 'string') {
+        try {
+            body = JSON.parse(flags.data);
+        }
+        catch {
+            process.stderr.write('Invalid --data: must be valid JSON.\n');
+            return 1;
+        }
+    }
+    const { baseUrl, fallbackUrl } = (0, http_client_1.resolveUrlPlan)({ flagUrl: strFlag(flags.url), env: process.env, config });
+    const key = (0, http_client_1.resolveKey)({ flagKey: strFlag(flags.key), env: process.env, config });
+    const result = await (0, http_client_1.request)({ method, path: apiPath, baseUrl, fallbackBaseUrl: fallbackUrl, key, body });
+    (0, output_1.printResult)(result.data, flags.json === true);
+    return 0;
+}
+// ─── helpers ──────────────────────────────────────────────────────────────────
+function strFlag(v) {
+    return typeof v === 'string' ? v : undefined;
+}
+function readVersion() {
+    try {
+        // dist/cli/index.js → package.json at the package root
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require(path.join(__dirname, '..', '..', 'package.json')).version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function usageFor(c) {
+    const positionals = c.args.map((a) => `<${a}>`).join(' ');
+    const flagStr = c.flags
+        .map((f) => (f.boolean ? `[--${f.name}]` : f.required ? `--${f.name} <v>` : `[--${f.name} <v>]`))
+        .join(' ');
+    return `${c.noun} ${c.verb}${positionals ? ' ' + positionals : ''}${flagStr ? ' ' + flagStr : ''}`.trim();
+}
+/** Two-column rows in the general help. The name column is padded to
+ *  NAME_W; a name wider than that puts its description on the next line.
+ *  Wide enough for the longest name (`service install|status|uninstall`, 32)
+ *  plus a readable gap, so no core command wraps. Exported for the test that
+ *  holds this table and the dispatcher to the same set of commands. */
+exports.NAME_W = 36;
+/** Usage strings in a resource noun's help (`crons list --limit <v>`) run much
+ *  longer than a core command name, so that listing gets its own width. */
+exports.NOUN_NAME_W = 48;
+exports.CORE_HELP = [
+    ['gateway status|restart|stop', 'Manage the gateway process (manager-aware)'],
+    ['service install|status|uninstall', 'Run the gateway as a systemd-user or PM2 service'],
+    ['update [check]', 'Check for / install a newer claude-gateway'],
+    ['claude version|update [check]', 'Inspect / update the Claude Code binary'],
+    ['doctor', 'Check config/env/connectivity'],
+    ['debug-bundle', 'Write a small redacted diagnostics bundle'],
+    ['agents list|create|update', 'Create/manage agents (interactive wizard)'],
+    ['channels pending|approve|deny', 'Approve/deny incoming Telegram/Discord pairing requests'],
+    ['api <METHOD> <path>', 'Call any endpoint directly (escape hatch)'],
+    ['version', 'Print the gateway version'],
+];
+/** Render one `  name   description` row, padding before colouring so ANSI
+ *  escapes never count toward the column width. A name at or past `width` puts
+ *  its description on the next line, aligned with the others, rather than
+ *  pushing it out of the column — which is what the two-line form is for.
+ *  Shared by every help listing so they cannot drift apart. */
+function helpRow(name, desc, paint, width = exports.NAME_W) {
+    if (name.length >= width)
+        return [`  ${paint(name)}`, `  ${' '.repeat(width)}${desc}`];
+    return [`  ${paint(name.padEnd(width))}${desc}`];
+}
+function printGeneralHelp(requested) {
+    const nouns = [...commands_generated_1.GENERATED_NOUNS].sort();
+    const stream = (0, output_1.helpStream)(requested);
+    const c = (0, colors_1.paletteFor)(stream);
+    // readVersion() falls back to 'unknown'; render that as a plain banner rather than "vunknown".
+    const version = readVersion();
+    // The brand tone is reserved for this banner — the one place the program
+    // introduces itself. Elsewhere the name is just bold, so colour stays a
+    // signal rather than decoration.
+    const name = c.brand('claude-gateway');
+    const banner = version === 'unknown'
+        ? `${name} — control a running gateway from the command line`
+        : `${name} ${c.dim(`v${version}`)} — control a running gateway from the command line`;
+    const lines = [
+        banner,
+        '',
+        `${c.bold('Usage:')} claude-gateway <command> [args] [--flags]`,
+        '',
+        c.bold('Start the gateway in the foreground:'),
+        ...helpRow('gateway start', 'Start the gateway server (the only command that boots it)', c.green),
+        '',
+        c.bold('Core commands:'),
+        ...exports.CORE_HELP.flatMap(([n, d]) => helpRow(n, d, c.cyan)),
+        '',
+        `${c.bold('Resource commands:')} ${nouns.map((n) => c.cyan(n)).join(', ')}`,
+        `  Run \`claude-gateway <resource> --help\` for its verbs.`,
+        '',
+        `${c.bold('Global flags:')} --url <url>  --key <key>  --json (compact/minified output)  --data <json>  --help`,
+    ];
+    stream.write(lines.join('\n') + '\n');
+}
+function printNounHelp(noun, requested) {
+    const cmds = commands_generated_1.GENERATED_COMMANDS.filter((c) => c.noun === noun);
+    const stream = (0, output_1.helpStream)(requested);
+    const p = (0, colors_1.paletteFor)(stream);
+    const lines = [`${p.bold('claude-gateway')} ${p.cyan(noun)} — commands:`, ''];
+    for (const c of cmds)
+        lines.push(...helpRow(usageFor(c), c.summary, p.cyan, exports.NOUN_NAME_W));
+    stream.write(lines.join('\n') + '\n');
+}
+function printCommandHelp(c, requested) {
+    const stream = (0, output_1.helpStream)(requested);
+    const p = (0, colors_1.paletteFor)(stream);
+    const lines = [
+        `${p.bold('claude-gateway')} ${p.cyan(usageFor(c))}`,
+        '',
+        `  ${c.summary}`,
+        `  ${p.dim(`${c.method} ${c.path}  (auth: ${c.auth})`)}`,
+    ];
+    if (c.flags.length) {
+        lines.push('', `  ${p.bold('Flags:')}`);
+        for (const f of c.flags) {
+            lines.push(`    --${f.name.padEnd(16)} ${f.in}${f.required ? ' (required)' : ''}  ${f.description ?? ''}`.trimEnd());
+        }
+    }
+    stream.write(lines.join('\n') + '\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/manager.d.ts

@@ -0,0 +1,64 @@
+/** Which process manager owns the running gateway. User systemd is preferred
+ * because `service systemd install` deliberately creates a user-scoped unit. */
+export type Manager = 'systemd-user' | 'systemd-system' | 'pm2' | 'foreground' | 'unknown';
+export declare function defaultPidfilePath(): string;
+export interface DetectDeps {
+    /** Run a trusted manager command and return stdout; injectable for tests. */
+    exec?: (args: string[]) => string;
+    pidfilePath?: string;
+    /** True if a process with this pid is alive; injectable for tests. */
+    isAlive?: (pid: number) => boolean;
+    readPidfile?: (p: string) => string | null;
+    /** The command line of a live process, or null when it cannot be read;
+     *  injectable for tests. See pidLooksLikeGateway(). */
+    readCmdline?: (pid: number) => string | null;
+}
+/**
+ * Best-effort check that `pid` is a gateway and not an unrelated process that
+ * inherited a recycled pid.
+ *
+ * readLocalGateway() deliberately stops at signal-0 — it runs on every CLI
+ * invocation and must stay cheap — but that only proves *something* holds the
+ * pid. A gateway lost to SIGKILL or the OOM killer leaves its pidfile behind,
+ * and once the kernel reuses that pid, anything reading the file would call a
+ * stranger "the gateway". Only callers about to act on the pid destructively
+ * (`gateway stop`, `gateway restart`) pay for this second check.
+ *
+ * Returns false when the command line cannot be read at all: an unverifiable
+ * pid is treated as not-a-gateway, because the cost of being wrong is
+ * terminating someone else's process.
+ */
+export declare function pidLooksLikeGateway(pid: number, deps?: Pick<DetectDeps, 'readCmdline'>): boolean;
+/**
+ * Detect the manager that currently owns the gateway, in priority order:
+ * user-systemd → system-systemd (legacy external install) → PM2 → foreground.
+ * Commands use fixed argument arrays, never user-controlled shell fragments.
+ */
+export declare function detectManager(deps?: DetectDeps): Manager;
+/** A gateway process running on this host, as recorded by its pidfile. */
+export interface LocalGateway {
+    pid: number;
+    /** The port it is listening on, when the pidfile records one. Absent for a
+     *  pidfile written by an older version (pid only). */
+    port?: number;
+}
+/**
+ * The gateway process alive on THIS host, per the pidfile the server writes on
+ * boot, or null when there is none. Every manager runs the same entry point, so
+ * the pidfile is present under systemd and PM2 too, not only in the foreground.
+ *
+ * Pidfile format is one field per line: pid, then the listening port. The port
+ * matters because the CLI cannot otherwise know it — `$PORT` is set in whatever
+ * shell launched the server, not necessarily in the one running the CLI, so
+ * deriving the port from the CLI's own environment can address a port nothing
+ * listens on. A pidfile from an older version has no second line; the port is
+ * then simply unknown and callers fall back to the environment.
+ *
+ * Deliberately cheap — one file read and one signal-0 — because `resolveUrl()`
+ * consults it on every CLI invocation. `detectManager()` is not usable there:
+ * it shells out to systemctl and pm2.
+ */
+export declare function readLocalGateway(deps?: Pick<DetectDeps, 'pidfilePath' | 'isAlive' | 'readPidfile'>): LocalGateway | null;
+/** True when a gateway process is alive on this host. See readLocalGateway(). */
+export declare function localGatewayIsLive(deps?: Pick<DetectDeps, 'pidfilePath' | 'isAlive' | 'readPidfile'>): boolean;
+//# sourceMappingURL=manager.d.ts.map

package/dist/cli/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/cli/manager.ts"],"names":[],"mappings":"AAKA;gFACgF;AAChF,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,gBAAgB,GAAG,KAAK,GAAG,YAAY,GAAG,SAAS,CAAC;AAE3F,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,MAAM,WAAW,UAAU;IACzB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC3C;2DACuD;IACvD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAC9C;AAiCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,CAAC,UAAU,EAAE,aAAa,CAAM,GAAG,OAAO,CAOpG;AAUD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CA2B5D;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ;0DACsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,CAAM,GAAG,YAAY,GAAG,IAAI,CAY5H;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,CAAM,GAAG,OAAO,CAElH"}

package/dist/cli/manager.js

@@ -0,0 +1,181 @@
+"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.defaultPidfilePath = defaultPidfilePath;
+exports.pidLooksLikeGateway = pidLooksLikeGateway;
+exports.detectManager = detectManager;
+exports.readLocalGateway = readLocalGateway;
+exports.localGatewayIsLive = localGatewayIsLive;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+function defaultPidfilePath() {
+    return path.join(os.homedir(), '.claude-gateway', 'gateway.pid');
+}
+function realExec(args) {
+    const [file, ...argv] = args;
+    return (0, child_process_1.execFileSync)(file, argv, { stdio: ['ignore', 'pipe', 'ignore'] }).toString();
+}
+function realIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Process command line, NUL-separated on Linux, space-joined elsewhere.
+ *  `/proc` first because it needs no subprocess; `ps` covers macOS/BSD. */
+function realReadCmdline(pid) {
+    try {
+        return fs.readFileSync(`/proc/${pid}/cmdline`, 'utf8').replace(/\0/g, ' ').trim();
+    }
+    catch {
+        /* not Linux, or the process is gone — fall through to ps */
+    }
+    try {
+        return (0, child_process_1.execFileSync)('ps', ['-o', 'command=', '-p', String(pid)], { stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Best-effort check that `pid` is a gateway and not an unrelated process that
+ * inherited a recycled pid.
+ *
+ * readLocalGateway() deliberately stops at signal-0 — it runs on every CLI
+ * invocation and must stay cheap — but that only proves *something* holds the
+ * pid. A gateway lost to SIGKILL or the OOM killer leaves its pidfile behind,
+ * and once the kernel reuses that pid, anything reading the file would call a
+ * stranger "the gateway". Only callers about to act on the pid destructively
+ * (`gateway stop`, `gateway restart`) pay for this second check.
+ *
+ * Returns false when the command line cannot be read at all: an unverifiable
+ * pid is treated as not-a-gateway, because the cost of being wrong is
+ * terminating someone else's process.
+ */
+function pidLooksLikeGateway(pid, deps = {}) {
+    const cmdline = (deps.readCmdline ?? realReadCmdline)(pid);
+    if (!cmdline)
+        return false;
+    // Either the installed binary/package path, or a checkout started straight
+    // from its entry point (`node /opt/gw/dist/index.js gateway start`), whose
+    // directory need not be named after the project.
+    return /claude-gateway/.test(cmdline) || /(^|[\\/])(dist|src)[\\/]index\.(js|ts)\b/.test(cmdline);
+}
+function realReadPidfile(p) {
+    try {
+        return fs.readFileSync(p, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect the manager that currently owns the gateway, in priority order:
+ * user-systemd → system-systemd (legacy external install) → PM2 → foreground.
+ * Commands use fixed argument arrays, never user-controlled shell fragments.
+ */
+function detectManager(deps = {}) {
+    const exec = deps.exec ?? realExec;
+    const isAlive = deps.isAlive ?? realIsAlive;
+    const readPidfile = deps.readPidfile ?? realReadPidfile;
+    try {
+        if (exec(['systemctl', '--user', 'is-active', 'claude-gateway.service']).trim() === 'active')
+            return 'systemd-user';
+    }
+    catch {
+        /* no reachable user manager or inactive unit */
+    }
+    try {
+        if (exec(['systemctl', 'is-active', 'claude-gateway.service']).trim() === 'active')
+            return 'systemd-system';
+    }
+    catch {
+        /* system service absent or inactive */
+    }
+    try {
+        const pid = exec(['pm2', 'pid', 'gateway']).trim();
+        if (/^\d+$/.test(pid) && Number(pid) > 0)
+            return 'pm2';
+    }
+    catch {
+        /* pm2 absent or process not found */
+    }
+    if (localGatewayIsLive({ pidfilePath: deps.pidfilePath, isAlive, readPidfile }))
+        return 'foreground';
+    return 'unknown';
+}
+/**
+ * The gateway process alive on THIS host, per the pidfile the server writes on
+ * boot, or null when there is none. Every manager runs the same entry point, so
+ * the pidfile is present under systemd and PM2 too, not only in the foreground.
+ *
+ * Pidfile format is one field per line: pid, then the listening port. The port
+ * matters because the CLI cannot otherwise know it — `$PORT` is set in whatever
+ * shell launched the server, not necessarily in the one running the CLI, so
+ * deriving the port from the CLI's own environment can address a port nothing
+ * listens on. A pidfile from an older version has no second line; the port is
+ * then simply unknown and callers fall back to the environment.
+ *
+ * Deliberately cheap — one file read and one signal-0 — because `resolveUrl()`
+ * consults it on every CLI invocation. `detectManager()` is not usable there:
+ * it shells out to systemctl and pm2.
+ */
+function readLocalGateway(deps = {}) {
+    const isAlive = deps.isAlive ?? realIsAlive;
+    const readPidfile = deps.readPidfile ?? realReadPidfile;
+    const raw = readPidfile(deps.pidfilePath ?? defaultPidfilePath());
+    if (!raw)
+        return null;
+    const [pidLine, portLine] = raw.split('\n');
+    const pid = parseInt((pidLine ?? '').trim(), 10);
+    if (!(pid > 0) || !isAlive(pid))
+        return null;
+    const port = parseInt((portLine ?? '').trim(), 10);
+    // Port 0 means "let the OS choose" and is never a dialable address, so it is
+    // treated as unrecorded rather than written into a URL.
+    return { pid, port: port > 0 && port < 65536 ? port : undefined };
+}
+/** True when a gateway process is alive on this host. See readLocalGateway(). */
+function localGatewayIsLive(deps = {}) {
+    return readLocalGateway(deps) !== null;
+}
+//# sourceMappingURL=manager.js.map

package/dist/cli/manager.js.map

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