@sumeru/cli 0.1.0

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 shazhou
+
+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/.build-fingerprint

@@ -0,0 +1 @@
+1c87be7f6e3fc7a33efca7c66f512072454c46ebb199496e30241ae6134d2d0c

package/dist/build-adapters.d.ts

@@ -0,0 +1,18 @@
+import type { Adapter } from "@sumeru/core";
+import type { GatewayConfig } from "@sumeru/server";
+/**
+ * A factory function that constructs an `Adapter` from an opaque options
+ * blob. The blob's keys are validated by the adapter, not by the CLI.
+ */
+export type AdapterFactory = (opts: Record<string, unknown>) => Adapter;
+/** Registry of adapter factories keyed by adapter name. */
+export type AdapterFactoryMap = Record<string, AdapterFactory>;
+/** Default factories — wires in the built-in adapter packages. */
+export declare const DEFAULT_ADAPTER_FACTORIES: AdapterFactoryMap;
+/**
+ * Walk a parsed `gateways` map and produce the adapter registry the server
+ * needs. Per-gateway `config` blobs are forwarded verbatim; gateways whose
+ * `adapter` field does not match a known factory are silently omitted.
+ */
+export declare function buildAdapters(gateways: Record<string, GatewayConfig>, factories?: AdapterFactoryMap): Record<string, Adapter>;
+//# sourceMappingURL=build-adapters.d.ts.map

package/dist/build-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-adapters.d.ts","sourceRoot":"","sources":["../src/build-adapters.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;AAExE,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE/D,kEAAkE;AAClE,eAAO,MAAM,yBAAyB,EAAE,iBAKvC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACvC,SAAS,GAAE,iBAA6C,GACtD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB"}

package/dist/build-adapters.js

@@ -0,0 +1,48 @@
+/**
+ * Build the adapter registry for a Sumeru server from parsed gateway config.
+ *
+ * Walks the `gateways` map and dispatches on `gw.adapter` to the matching
+ * built-in factory (hermes, claude-code). Each gateway's `gw.config` blob is
+ * forwarded verbatim to the factory; absent / `null` blobs become `{}`.
+ *
+ * Unknown adapter names are silently skipped — the gateway then surfaces as
+ * `status: "unavailable"` via `GET /gateways`. The CLI MUST NOT crash on a
+ * gateway whose adapter package is not bundled.
+ *
+ * The factory map is injectable for tests; production code uses
+ * {@link DEFAULT_ADAPTER_FACTORIES} which wires in the real built-in packages.
+ *
+ * See `specs/cli-pass-gateway-config.md` (issue #32).
+ */
+import { createClaudeCodeAdapter } from "@sumeru/adapter-claude-code";
+import { createCodexAdapter } from "@sumeru/adapter-codex";
+import { createCursorAgentAdapter } from "@sumeru/adapter-cursor-agent";
+import { createHermesAdapter } from "@sumeru/adapter-hermes";
+/** Default factories — wires in the built-in adapter packages. */
+export const DEFAULT_ADAPTER_FACTORIES = {
+    hermes: (opts) => createHermesAdapter(opts),
+    "claude-code": (opts) => createClaudeCodeAdapter(opts),
+    codex: (opts) => createCodexAdapter(opts),
+    "cursor-agent": (opts) => createCursorAgentAdapter(opts),
+};
+/**
+ * Walk a parsed `gateways` map and produce the adapter registry the server
+ * needs. Per-gateway `config` blobs are forwarded verbatim; gateways whose
+ * `adapter` field does not match a known factory are silently omitted.
+ */
+export function buildAdapters(gateways, factories = DEFAULT_ADAPTER_FACTORIES) {
+    const adapters = {};
+    for (const [name, gw] of Object.entries(gateways)) {
+        const factory = factories[gw.adapter];
+        if (factory === undefined) {
+            // Adapter package not bundled by this CLI build — leave the
+            // gateway's adapter slot empty so the registry reports
+            // `status: "unavailable"`.
+            continue;
+        }
+        const opts = gw.config ?? {};
+        adapters[name] = factory(opts);
+    }
+    return adapters;
+}
+//# sourceMappingURL=build-adapters.js.map

package/dist/build-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-adapters.js","sourceRoot":"","sources":["../src/build-adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAa7D,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAsB;IAC3D,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC;IAC3C,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC;IACtD,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC;IACzC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC;CACxD,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC5B,QAAuC,EACvC,YAA+B,yBAAyB;IAExD,MAAM,QAAQ,GAA4B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,4DAA4D;YAC5D,uDAAuD;YACvD,2BAA2B;YAC3B,SAAS;QACV,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env -S node --disable-warning=ExperimentalWarning
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,251 @@
+#!/usr/bin/env -S node --disable-warning=ExperimentalWarning
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadConfig, startServer, } from "@sumeru/server";
+import { Command } from "commander";
+import { buildAdapters } from "./build-adapters.js";
+import { isProcessAlive, readPidFile, removePidFile, resolvePidFilePath, writePidFile, } from "./pid-file.js";
+import { formatPortInUse, killHolder, lookupPortHolder } from "./port-check.js";
+function findVersion() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 5; i++) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+            if (pkg.name === "@sumeru/cli")
+                return pkg.version ?? "0.0.0";
+        }
+        catch {
+            /* keep walking */
+        }
+        dir = dirname(dir);
+    }
+    return "0.0.0";
+}
+const program = new Command();
+program
+    .name("sumeru")
+    .description("Agent house — HTTP service for multi-agent management")
+    .version(findVersion());
+program
+    .command("run")
+    .description("[planned] Run a scene with a specified adapter and model")
+    .requiredOption("-s, --scene <path>", "Path to scene directory or YAML")
+    .requiredOption("-r, --runner <type>", "Adapter type (hermes, claude-code)")
+    .requiredOption("-m, --model <model>", "Model identifier")
+    .option("-t, --timeout <seconds>", "Timeout in seconds", "300")
+    .option("--network", "Allow network access", true)
+    .option("--no-network", "Disable network access")
+    .option("-i, --image <image>", "Docker image")
+    .option("-o, --output <path>", "Output path for recording")
+    .action(async (opts) => {
+    console.log("sumeru run — not yet implemented");
+    console.log("Options:", JSON.stringify(opts, null, 2));
+});
+program
+    .command("list")
+    .description("[planned] List available scenes")
+    .option("-d, --dir <path>", "Scenes directory", "scenes")
+    .action(async (opts) => {
+    console.log("sumeru list — not yet implemented");
+    console.log("Directory:", opts.dir);
+});
+program
+    .command("start")
+    .description("Start the Sumeru HTTP server")
+    .option("-p, --port <number>", "TCP port to bind (0 = ephemeral)", "7900")
+    .option("-h, --host <host>", "Bind address", "127.0.0.1")
+    .option("-c, --config <path>", "Path to sumeru.yaml configuration file")
+    .option("--ocas-dir <path>", "Directory for the ocas content-addressed store (default: $SUMERU_OCAS_DIR or ~/.sumeru/ocas)")
+    .option("--force", "Kill any process holding the chosen port before binding (sends SIGTERM, then SIGKILL after 2s)")
+    .action(async (opts) => {
+    const port = Number.parseInt(opts.port, 10);
+    if (Number.isNaN(port) || port < 0) {
+        console.error(`Invalid --port value: ${opts.port}`);
+        process.exit(1);
+    }
+    const host = String(opts.host);
+    const force = Boolean(opts.force);
+    const ocasDir = typeof opts.ocasDir === "string" && opts.ocasDir.length > 0
+        ? opts.ocasDir
+        : null;
+    // Load config (if any) BEFORE binding a port — we want to fail loudly
+    // on bad config without leaving a half-started listener around.
+    let name = "sumeru";
+    let gateways = {};
+    let workspaceRoot = null;
+    if (typeof opts.config === "string" && opts.config.length > 0) {
+        let cfg;
+        try {
+            cfg = await loadConfig(opts.config);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`Failed to load config from ${opts.config}: ${msg}`);
+            process.exit(1);
+        }
+        name = cfg.name;
+        gateways = cfg.gateways;
+        workspaceRoot = cfg.workspaceRoot;
+    }
+    // --- PID file lifecycle (issue #33) ---
+    const pidFilePath = resolvePidFilePath();
+    const existingPid = readPidFile(pidFilePath);
+    if (existingPid !== null) {
+        if (isProcessAlive(existingPid)) {
+            if (force) {
+                try {
+                    await killHolder(existingPid, port, host);
+                    console.error(`[sumeru] killed pid ${existingPid} from stale pid file`);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(`Failed to kill pid ${existingPid}: ${msg}`);
+                    process.exit(1);
+                }
+            }
+            else {
+                console.error(`Another sumeru appears to be running (pid ${existingPid}, recorded in ${pidFilePath}).\n  Stop it first, or run \`sumeru start … --force\` to terminate it.`);
+                process.exit(1);
+            }
+        }
+        else {
+            console.error(`[sumeru] removing stale pid file (pid ${existingPid} not running)`);
+            // fall through; writePidFile below will overwrite.
+        }
+    }
+    try {
+        writePidFile(pidFilePath, process.pid);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[sumeru] could not write pid file ${pidFilePath}: ${msg}`);
+        // Best-effort — continue startup.
+    }
+    try {
+        const server = await startServerWithRetry({
+            port,
+            host,
+            name,
+            version: findVersion(),
+            gateways,
+            workspaceRoot,
+            ocasDir,
+            force,
+        });
+        console.log(`Listening on http://${server.host}:${server.port}`);
+        let shuttingDown = false;
+        const shutdown = async (signal) => {
+            if (shuttingDown) {
+                // Second signal — escape hatch for a hung shutdown.
+                const code = signal === "SIGINT" ? 130 : 143;
+                process.exit(code);
+            }
+            shuttingDown = true;
+            console.error(`[sumeru] shutting down (${signal})...`);
+            try {
+                await server.stop();
+                try {
+                    removePidFile(pidFilePath);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(`[sumeru] could not remove pid file: ${msg}`);
+                }
+                process.exit(0);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[sumeru] failed to stop server: ${msg}`);
+                try {
+                    removePidFile(pidFilePath);
+                }
+                catch {
+                    /* ignore on the failure path */
+                }
+                process.exit(1);
+            }
+        };
+        process.on("SIGINT", () => {
+            void shutdown("SIGINT");
+        });
+        process.on("SIGTERM", () => {
+            void shutdown("SIGTERM");
+        });
+    }
+    catch (err) {
+        try {
+            removePidFile(pidFilePath);
+        }
+        catch {
+            /* best effort on the error path */
+        }
+        const code = err instanceof Error && "code" in err
+            ? err.code
+            : null;
+        if (code === "EADDRINUSE") {
+            const holder = await lookupPortHolder(host, port);
+            console.error(formatPortInUse({ host, port, holder }));
+        }
+        else {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`Failed to start server: ${msg}`);
+        }
+        process.exit(1);
+    }
+});
+async function startServerWithRetry(args) {
+    try {
+        return await startServer({
+            port: args.port,
+            host: args.host,
+            name: args.name,
+            version: args.version,
+            gateways: args.gateways,
+            workspaceRoot: args.workspaceRoot,
+            adapters: buildAdapters(args.gateways),
+            sseHeartbeatMs: null,
+            sseBufferSize: null,
+            sseRetentionMs: null,
+            ocasDir: args.ocasDir,
+        });
+    }
+    catch (err) {
+        const code = err instanceof Error && "code" in err
+            ? err.code
+            : null;
+        if (code !== "EADDRINUSE" || !args.force)
+            throw err;
+        const holder = await lookupPortHolder(args.host, args.port);
+        if (holder === null) {
+            // Cannot identify holder — propagate the original error so the
+            // generic diagnostic kicks in.
+            throw err;
+        }
+        try {
+            await killHolder(holder.pid, args.port, args.host);
+        }
+        catch (killErr) {
+            const msg = killErr instanceof Error ? killErr.message : String(killErr);
+            console.error(`Failed to kill pid ${holder.pid}: ${msg}`);
+            process.exit(1);
+        }
+        console.error(`[sumeru] killed pid ${holder.pid} holding port ${args.port}`);
+        // Retry the bind once.
+        return startServer({
+            port: args.port,
+            host: args.host,
+            name: args.name,
+            version: args.version,
+            gateways: args.gateways,
+            workspaceRoot: args.workspaceRoot,
+            adapters: buildAdapters(args.gateways),
+            sseHeartbeatMs: null,
+            sseBufferSize: null,
+            sseRetentionMs: null,
+            ocasDir: args.ocasDir,
+        });
+    }
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/pid-file.d.ts

@@ -0,0 +1,51 @@
+/**
+ * PID file management for `sumeru start` (issue #33).
+ *
+ * Best-effort pid file at `~/.sumeru/sumeru.pid` (or `$SUMERU_PID_FILE`).
+ *
+ * - `writePidFile(path, pid)` — creates parent dir with 0o700 if missing,
+ *   writes `<pid>\n` with mode 0o600. Throws on filesystem errors so the
+ *   caller can choose to degrade.
+ * - `readPidFile(path)` — returns the parsed pid, `null` if the file is
+ *   missing OR malformed (operators may have hand-edited it; we won't crash).
+ * - `removePidFile(path)` — silently succeeds if the file is already gone.
+ * - `isProcessAlive(pid)` — uses `process.kill(pid, 0)` (no signal sent) to
+ *   probe liveness. ESRCH → dead. EPERM → live but foreign (still treated
+ *   as live for safety — we don't want to overwrite someone else's pid file).
+ *
+ * See specs/cli-pid-file.md.
+ */
+/**
+ * Resolve the configured pid file path. Honors `SUMERU_PID_FILE` for tests;
+ * defaults to `~/.sumeru/sumeru.pid`. `~/` is expanded against `os.homedir()`.
+ */
+export declare function resolvePidFilePath(): string;
+/**
+ * Write `<pid>\n` to `path` with mode 0o600. Creates the parent dir
+ * (0o700) if missing. Throws on EACCES / EROFS / ENOSPC etc. — the caller
+ * is responsible for catching and degrading to a warning.
+ */
+export declare function writePidFile(path: string, pid: number): void;
+/**
+ * Read and parse the pid file. Returns `null` if the file is missing or
+ * the contents are not a positive integer.
+ */
+export declare function readPidFile(path: string): number | null;
+/**
+ * Remove the pid file. No-op if already absent. Other I/O errors propagate
+ * so the caller can decide whether to log.
+ */
+export declare function removePidFile(path: string): void;
+/**
+ * Probe whether `pid` is running. Sends signal 0 via `process.kill`, which
+ * performs the permission/existence check without actually delivering a
+ * signal.
+ *
+ * - Success → process exists and we can signal it → `true`.
+ * - `ESRCH` → no such process → `false`.
+ * - `EPERM` → process exists but belongs to another user → `true` (treat
+ *   as live; we don't want to overwrite a foreign pid file).
+ * - Any other error → `false` (defensive; surfaces as "stale" to the caller).
+ */
+export declare function isProcessAlive(pid: number): boolean;
+//# sourceMappingURL=pid-file.d.ts.map

package/dist/pid-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pid-file.d.ts","sourceRoot":"","sources":["../src/pid-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAgB5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqBvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA2BhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAanD"}

package/dist/pid-file.js

@@ -0,0 +1,143 @@
+/**
+ * PID file management for `sumeru start` (issue #33).
+ *
+ * Best-effort pid file at `~/.sumeru/sumeru.pid` (or `$SUMERU_PID_FILE`).
+ *
+ * - `writePidFile(path, pid)` — creates parent dir with 0o700 if missing,
+ *   writes `<pid>\n` with mode 0o600. Throws on filesystem errors so the
+ *   caller can choose to degrade.
+ * - `readPidFile(path)` — returns the parsed pid, `null` if the file is
+ *   missing OR malformed (operators may have hand-edited it; we won't crash).
+ * - `removePidFile(path)` — silently succeeds if the file is already gone.
+ * - `isProcessAlive(pid)` — uses `process.kill(pid, 0)` (no signal sent) to
+ *   probe liveness. ESRCH → dead. EPERM → live but foreign (still treated
+ *   as live for safety — we don't want to overwrite someone else's pid file).
+ *
+ * See specs/cli-pid-file.md.
+ */
+import { chmodSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+/**
+ * Resolve the configured pid file path. Honors `SUMERU_PID_FILE` for tests;
+ * defaults to `~/.sumeru/sumeru.pid`. `~/` is expanded against `os.homedir()`.
+ */
+export function resolvePidFilePath() {
+    const env = process.env.SUMERU_PID_FILE;
+    const raw = typeof env === "string" && env.length > 0
+        ? env
+        : join(homedir(), ".sumeru", "sumeru.pid");
+    const expanded = raw.startsWith("~/") ? join(homedir(), raw.slice(2)) : raw;
+    return resolve(expanded);
+}
+/**
+ * Write `<pid>\n` to `path` with mode 0o600. Creates the parent dir
+ * (0o700) if missing. Throws on EACCES / EROFS / ENOSPC etc. — the caller
+ * is responsible for catching and degrading to a warning.
+ */
+export function writePidFile(path, pid) {
+    const dir = dirname(path);
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    // `recursive: true` does not chmod an already-existing dir; nudge it.
+    try {
+        chmodSync(dir, 0o700);
+    }
+    catch {
+        /* best effort — operator may not own the dir */
+    }
+    writeFileSync(path, `${pid}\n`, { mode: 0o600 });
+    // `writeFileSync` honors mode only on create; force it for overwrite.
+    try {
+        chmodSync(path, 0o600);
+    }
+    catch {
+        /* best effort */
+    }
+}
+/**
+ * Read and parse the pid file. Returns `null` if the file is missing or
+ * the contents are not a positive integer.
+ */
+export function readPidFile(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf-8");
+    }
+    catch (err) {
+        if (err !== null &&
+            typeof err === "object" &&
+            "code" in err &&
+            err.code === "ENOENT") {
+            return null;
+        }
+        throw err;
+    }
+    const trimmed = raw.trim();
+    if (trimmed.length === 0)
+        return null;
+    if (!/^\d+$/.test(trimmed))
+        return null;
+    const pid = Number.parseInt(trimmed, 10);
+    if (!Number.isFinite(pid) || pid <= 0)
+        return null;
+    return pid;
+}
+/**
+ * Remove the pid file. No-op if already absent. Other I/O errors propagate
+ * so the caller can decide whether to log.
+ */
+export function removePidFile(path) {
+    try {
+        statSync(path);
+    }
+    catch (err) {
+        if (err !== null &&
+            typeof err === "object" &&
+            "code" in err &&
+            err.code === "ENOENT") {
+            return;
+        }
+        throw err;
+    }
+    try {
+        unlinkSync(path);
+    }
+    catch (err) {
+        if (err !== null &&
+            typeof err === "object" &&
+            "code" in err &&
+            err.code === "ENOENT") {
+            return;
+        }
+        throw err;
+    }
+}
+/**
+ * Probe whether `pid` is running. Sends signal 0 via `process.kill`, which
+ * performs the permission/existence check without actually delivering a
+ * signal.
+ *
+ * - Success → process exists and we can signal it → `true`.
+ * - `ESRCH` → no such process → `false`.
+ * - `EPERM` → process exists but belongs to another user → `true` (treat
+ *   as live; we don't want to overwrite a foreign pid file).
+ * - Any other error → `false` (defensive; surfaces as "stale" to the caller).
+ */
+export function isProcessAlive(pid) {
+    if (!Number.isFinite(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        if (err === null || typeof err !== "object" || !("code" in err)) {
+            return false;
+        }
+        const code = err.code;
+        if (code === "EPERM")
+            return true;
+        return false;
+    }
+}
+//# sourceMappingURL=pid-file.js.map

package/dist/pid-file.js.map

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

package/dist/port-check.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Port conflict detection + force-kill helpers for `sumeru start` (issue #33).
+ *
+ * - `lookupPortHolder(host, port)` shells out to `lsof -i :<port>
+ *   -sTCP:LISTEN -t -P -n` to identify the process bound to the port.
+ *   Returns `null` if lsof is missing OR no holder is found OR the helper
+ *   fails for any reason — the caller should fall back to a generic
+ *   diagnostic.
+ * - `formatPortInUse({ host, port, holder })` produces the operator-facing
+ *   error block.
+ * - `killHolder(pid, port, host)` sends SIGTERM, waits up to 2s for the port
+ *   to free, then SIGKILLs. Throws if the kill itself errors (e.g. EPERM).
+ *
+ * See specs/cli-startup-port-check.md.
+ */
+export type PortHolder = {
+    pid: number;
+    command: string;
+};
+export type FormatPortInUseOptions = {
+    host: string;
+    port: number;
+    holder: PortHolder | null;
+};
+/**
+ * Resolve the process listening on `host:port` via lsof. Returns null if:
+ *   - lsof is not on PATH (ENOENT spawn error),
+ *   - lsof exits non-zero (no holder found),
+ *   - the holder pid cannot be parsed,
+ *   - any other error — we never throw to the caller.
+ */
+export declare function lookupPortHolder(_host: string, port: number): Promise<PortHolder | null>;
+/**
+ * Render the diagnostic the CLI prints when `EADDRINUSE` is caught.
+ *
+ * - When the holder is identified (lsof present, pid resolved), emit the
+ *   multi-line block with `Held by pid …` and a `--force` hint.
+ * - When the holder is unknown (lsof missing OR could not identify), fall
+ *   back to the legacy single-line message — no `--force` hint, since
+ *   without a target pid `--force` cannot do anything anyway.
+ *
+ * See specs/cli-startup-port-check.md.
+ */
+export declare function formatPortInUse(opts: FormatPortInUseOptions): string;
+/**
+ * Send SIGTERM to `pid`. Wait up to `gracefulMs` for the port to free; if
+ * still bound, send SIGKILL. Resolves once the port is free or after
+ * `gracefulMs + killWaitMs` total.
+ *
+ * Throws if `process.kill` itself fails (e.g. EPERM or ESRCH at SIGTERM
+ * time — both are operator-actionable conditions).
+ */
+export declare function killHolder(pid: number, port: number, host: string, gracefulMs?: number): Promise<void>;
+//# sourceMappingURL=port-check.d.ts.map

package/dist/port-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-check.d.ts","sourceRoot":"","sources":["../src/port-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,MAAM,MAAM,UAAU,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACrC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAK5B;AA2DD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAUpE;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,SAAQ,GAChB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/port-check.js

@@ -0,0 +1,160 @@
+/**
+ * Port conflict detection + force-kill helpers for `sumeru start` (issue #33).
+ *
+ * - `lookupPortHolder(host, port)` shells out to `lsof -i :<port>
+ *   -sTCP:LISTEN -t -P -n` to identify the process bound to the port.
+ *   Returns `null` if lsof is missing OR no holder is found OR the helper
+ *   fails for any reason — the caller should fall back to a generic
+ *   diagnostic.
+ * - `formatPortInUse({ host, port, holder })` produces the operator-facing
+ *   error block.
+ * - `killHolder(pid, port, host)` sends SIGTERM, waits up to 2s for the port
+ *   to free, then SIGKILLs. Throws if the kill itself errors (e.g. EPERM).
+ *
+ * See specs/cli-startup-port-check.md.
+ */
+import { spawn } from "node:child_process";
+import { createConnection } from "node:net";
+/**
+ * Resolve the process listening on `host:port` via lsof. Returns null if:
+ *   - lsof is not on PATH (ENOENT spawn error),
+ *   - lsof exits non-zero (no holder found),
+ *   - the holder pid cannot be parsed,
+ *   - any other error — we never throw to the caller.
+ */
+export async function lookupPortHolder(_host, port) {
+    const pid = await runLsofForPid(port);
+    if (pid === null)
+        return null;
+    const command = await readCommandForPid(pid);
+    return { pid, command };
+}
+function runLsofForPid(port) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn("lsof", ["-i", `:${port}`, "-sTCP:LISTEN", "-t", "-P", "-n"], { stdio: ["ignore", "pipe", "ignore"] });
+        }
+        catch {
+            resolve(null);
+            return;
+        }
+        let out = "";
+        child.stdout?.on("data", (chunk) => {
+            out += chunk.toString("utf-8");
+        });
+        child.on("error", () => resolve(null));
+        child.on("close", () => {
+            const first = out.split("\n").find((line) => /^\d+$/.test(line.trim()));
+            if (first === undefined) {
+                resolve(null);
+                return;
+            }
+            const pid = Number.parseInt(first.trim(), 10);
+            if (!Number.isFinite(pid) || pid <= 0) {
+                resolve(null);
+                return;
+            }
+            resolve(pid);
+        });
+    });
+}
+function readCommandForPid(pid) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn("ps", ["-p", String(pid), "-o", "comm="], {
+                stdio: ["ignore", "pipe", "ignore"],
+            });
+        }
+        catch {
+            resolve("unknown");
+            return;
+        }
+        let out = "";
+        child.stdout?.on("data", (chunk) => {
+            out += chunk.toString("utf-8");
+        });
+        child.on("error", () => resolve("unknown"));
+        child.on("close", () => {
+            const trimmed = out.trim();
+            resolve(trimmed.length > 0 ? trimmed : "unknown");
+        });
+    });
+}
+/**
+ * Render the diagnostic the CLI prints when `EADDRINUSE` is caught.
+ *
+ * - When the holder is identified (lsof present, pid resolved), emit the
+ *   multi-line block with `Held by pid …` and a `--force` hint.
+ * - When the holder is unknown (lsof missing OR could not identify), fall
+ *   back to the legacy single-line message — no `--force` hint, since
+ *   without a target pid `--force` cannot do anything anyway.
+ *
+ * See specs/cli-startup-port-check.md.
+ */
+export function formatPortInUse(opts) {
+    const { host, port, holder } = opts;
+    if (holder === null) {
+        return `Port ${port} is already in use on ${host}. Choose a different --port or stop the conflicting process.`;
+    }
+    return [
+        `Port ${port} is already in use on ${host}.`,
+        `  Held by pid ${holder.pid} (${holder.command})`,
+        `  Run \`sumeru start --port ${port} --force\` to terminate it, or pick a different --port.`,
+    ].join("\n");
+}
+/**
+ * Send SIGTERM to `pid`. Wait up to `gracefulMs` for the port to free; if
+ * still bound, send SIGKILL. Resolves once the port is free or after
+ * `gracefulMs + killWaitMs` total.
+ *
+ * Throws if `process.kill` itself fails (e.g. EPERM or ESRCH at SIGTERM
+ * time — both are operator-actionable conditions).
+ */
+export async function killHolder(pid, port, host, gracefulMs = 2_000) {
+    process.kill(pid, "SIGTERM");
+    const start = Date.now();
+    while (Date.now() - start < gracefulMs) {
+        if (!(await isPortBound(host, port)))
+            return;
+        await sleep(100);
+    }
+    // Still bound — escalate.
+    try {
+        process.kill(pid, "SIGKILL");
+    }
+    catch (err) {
+        if (err !== null &&
+            typeof err === "object" &&
+            "code" in err &&
+            err.code === "ESRCH") {
+            // Already gone between SIGTERM and SIGKILL. That's fine.
+            return;
+        }
+        throw err;
+    }
+    // Best-effort wait for the kernel to release the socket.
+    const killStart = Date.now();
+    while (Date.now() - killStart < 1_000) {
+        if (!(await isPortBound(host, port)))
+            return;
+        await sleep(50);
+    }
+}
+function isPortBound(host, port) {
+    return new Promise((resolve) => {
+        const socket = createConnection({ host, port });
+        const done = (bound) => {
+            socket.removeAllListeners();
+            socket.destroy();
+            resolve(bound);
+        };
+        socket.once("connect", () => done(true));
+        socket.once("error", () => done(false));
+    });
+}
+function sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+//# sourceMappingURL=port-check.js.map

package/dist/port-check.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@sumeru/cli",
+  "description": "CLI for Sumeru agent house",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "sumeru": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "commander": "^14.0.0",
+    "yaml": "^2.7.0",
+    "@sumeru/adapter-claude-code": "^0.1.0",
+    "@sumeru/adapter-codex": "^0.1.0",
+    "@sumeru/adapter-cursor-agent": "^0.1.0",
+    "@sumeru/core": "^0.1.0",
+    "@sumeru/server": "^0.1.0",
+    "@sumeru/adapter-hermes": "^0.1.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "test:ci": "npx vitest run"
+  }
+}