agim-cli 1.0.1

package/dist/cli-ui/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/cli-ui/prompts.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAK,KAAK,IAAI,EAAE,KAAK,GAAG,EAAE,MAAM,WAAW,CAAA;AAElD,eAAO,MAAM,IAAI,eAAiB,CAAA;AAClC,MAAM,MAAM,YAAY,GAAG,OAAO,IAAI,CAAA;AAEtC,qBAAa,cAAe,SAAQ,KAAK;;CAKxC;AASD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,iDAAiD;IACjD,KAAK,EAAE,CAAC,CAAA;IACR,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAC5B;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;IAClC,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,OAAO,CAAC,EAAE,CAAC,CAAA;CACZ,GAAG,OAAO,CAAC,CAAC,GAAG,YAAY,CAAC,CA0B5B;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE;IACxD,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CASf;AAED,yDAAyD;AACzD,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAA;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;AAED,0CAA0C;AAC1C,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,CAAA;CACxC,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;AAED,wCAAwC;AACxC,wBAAsB,KAAK,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAI1F"}

package/dist/cli-ui/prompts.js

@@ -0,0 +1,125 @@
+// cli-ui/prompts.ts — thin wrappers around @inquirer/prompts with two
+// conveniences the underlying library doesn't bake in:
+//
+//   1. A standardized "← Back" choice that callers can detect by the
+//      sentinel return value `BACK`. This lets loops at any level handle
+//      navigation without each call site reaching into the prompt API.
+//   2. Graceful exit on Ctrl-C — inquirer throws `ExitPromptError`; we
+//      catch + re-throw as our own `UserAbortError` so callers can decide
+//      whether to exit (top-level) or treat as Back (nested).
+import { select, checkbox, input, password, confirm, Separator, } from '@inquirer/prompts';
+import { t } from './i18n.js';
+export const BACK = Symbol('back');
+export class UserAbortError extends Error {
+    constructor() {
+        super('User pressed Ctrl-C');
+        this.name = 'UserAbortError';
+    }
+}
+function rethrowAbort(err) {
+    if (err && typeof err === 'object' && 'name' in err && err.name === 'ExitPromptError') {
+        throw new UserAbortError();
+    }
+    throw err;
+}
+/**
+ * Single-choice menu with arrow keys + Enter. If `back` is provided
+ * (a key from i18n.ts pointing at a `← Back`-style string), an extra
+ * back entry is appended; picking it returns the BACK sentinel.
+ */
+export async function menu(opts) {
+    const choices = [];
+    for (const c of opts.choices) {
+        if (c.separatorBefore) {
+            // Statically imported above. require() doesn't exist in ESM modules,
+            // so an earlier lazy-import attempt crashed at runtime.
+            choices.push(new Separator());
+        }
+        choices.push({
+            value: c.value,
+            name: c.name,
+            description: c.description,
+            disabled: c.disabled,
+        });
+    }
+    if (opts.back) {
+        choices.push({ value: BACK, name: t(opts.lang, opts.back) });
+    }
+    try {
+        return await select({
+            message: opts.message,
+            choices: choices,
+            default: opts.default,
+            loop: false,
+        });
+    }
+    catch (err) {
+        rethrowAbort(err);
+    }
+}
+/**
+ * Multi-select with Space to toggle. Always returns an array (possibly
+ * empty). No back option — typical usage is "pick which IMs to enable";
+ * cancel is via Ctrl-C → UserAbortError.
+ */
+export async function multiSelect(opts) {
+    try {
+        return await checkbox({
+            message: opts.message,
+            choices: opts.choices,
+            required: opts.required ?? false,
+            loop: false,
+        });
+    }
+    catch (err) {
+        rethrowAbort(err);
+    }
+}
+/** Free-text input with optional default + validator. */
+export async function inputText(opts) {
+    try {
+        return await input({
+            message: opts.message,
+            default: opts.default,
+            validate: (v) => {
+                if (opts.required && !v.trim())
+                    return 'Required';
+                if (opts.validate)
+                    return opts.validate(v);
+                return true;
+            },
+        });
+    }
+    catch (err) {
+        rethrowAbort(err);
+    }
+}
+/** Hidden input for secrets (no echo). */
+export async function inputSecret(opts) {
+    try {
+        return await password({
+            message: opts.message,
+            mask: '*',
+            validate: (v) => {
+                if (opts.required && !v)
+                    return 'Required';
+                if (opts.validate)
+                    return opts.validate(v);
+                return true;
+            },
+        });
+    }
+    catch (err) {
+        rethrowAbort(err);
+    }
+}
+/** Yes/no with arrow-key navigation. */
+export async function yesNo(opts) {
+    try {
+        return await confirm({ message: opts.message, default: opts.default ?? false });
+    }
+    catch (err) {
+        rethrowAbort(err);
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/cli-ui/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/cli-ui/prompts.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,uDAAuD;AACvD,EAAE;AACF,qEAAqE;AACrE,yEAAyE;AACzE,uEAAuE;AACvE,uEAAuE;AACvE,0EAA0E;AAC1E,8DAA8D;AAE9D,OAAO,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,OAAO,EACP,SAAS,GACV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,CAAC,EAAuB,MAAM,WAAW,CAAA;AAElD,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;AAGlC,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC;QACE,KAAK,CAAC,qBAAqB,CAAC,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,IAAK,GAAwB,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC5G,MAAM,IAAI,cAAc,EAAE,CAAA;IAC5B,CAAC;IACD,MAAM,GAAG,CAAA;AACX,CAAC;AAeD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAI,IAM7B;IACC,MAAM,OAAO,GAAoD,EAAE,CAAA;IACnE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;YACtB,qEAAqE;YACrE,wDAAwD;YACxD,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC,CAAA;QAC/B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,KAAK,EAAE,CAAC,CAAC,KAAyB;YAClC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAwB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClF,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAmB;YACpC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,OAAsD;YAC/D,OAAO,EAAE,IAAI,CAAC,OAAuC;YACrD,IAAI,EAAE,KAAK;SACZ,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAmB,IAKnD;IACC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAI;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;YAChC,IAAI,EAAE,KAAK;SACZ,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAAC,CAAC;AACrC,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAK/B;IACC,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAAC;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,CAAC,CAAS,EAAE,EAAE;gBACtB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;oBAAE,OAAO,UAAU,CAAA;gBACjD,IAAI,IAAI,CAAC,QAAQ;oBAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;gBAC1C,OAAO,IAAI,CAAA;YACb,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAAC,CAAC;AACrC,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAIjC;IACC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,CAAC,CAAS,EAAE,EAAE;gBACtB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;oBAAE,OAAO,UAAU,CAAA;gBAC1C,IAAI,IAAI,CAAC,QAAQ;oBAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;gBAC1C,OAAO,IAAI,CAAA;YACb,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAAC,CAAC;AACrC,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAA4C;IACtE,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAA;IACjF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QAAC,YAAY,CAAC,GAAG,CAAC,CAAA;IAAC,CAAC;AACrC,CAAC"}

package/dist/cli-ui/service.d.ts

@@ -0,0 +1,41 @@
+export declare const PID_FILE: string;
+export declare const LOG_FILE: string;
+export type ServiceMode = 'systemd' | 'background' | 'foreground' | 'none';
+export interface ServiceState {
+    mode: ServiceMode;
+    pid: number | null;
+    /** Approximate uptime in seconds — from systemd timestamp or proc start time. */
+    uptimeSec?: number;
+}
+/** Format seconds as e.g. "2h 15m" / "3d 4h" / "45s". */
+export declare function formatUptime(sec: number): string;
+/** Look up the running mode + pid. Order matters: systemd wins, then bg
+ *  pid-file, then a foreground pgrep match. Returns `{mode:'none', pid:null}`
+ *  when nothing is running. */
+export declare function detectService(): ServiceState;
+/**
+ * Spawn Agim detached with stdio redirected to ~/.im-hub/im-hub.log.
+ * Writes the pid to PID_FILE so subsequent `status` / `stop` find it.
+ *
+ * Cross-platform: setsid → new session, no controlling tty, parent can exit.
+ * On macOS where setsid isn't always reliable, fall through to a plain
+ * detached spawn (child still gets stdio: 'ignore' / 'pipe' redirected to
+ * the log file, which is enough to survive the parent).
+ */
+export declare function spawnBackground(executable: string, args?: string[]): {
+    pid: number;
+};
+/** Stop whichever instance is running. Returns the mode that was stopped
+ *  (or 'none' when there was nothing to do). */
+export declare function stopService(): Promise<{
+    mode: ServiceMode;
+    pid: number | null;
+}>;
+/** Get the configured web bind+port from `<AGIM_HOME>/config.json` —
+ *  used by `status` to print the URL. Returns null when config is
+ *  absent / unparseable. */
+export declare function readWebEndpoint(): {
+    bind: string;
+    port: number;
+} | null;
+//# sourceMappingURL=service.d.ts.map

package/dist/cli-ui/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/cli-ui/service.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,QAAQ,QAAgC,CAAA;AACrD,eAAO,MAAM,QAAQ,QAAgC,CAAA;AAqBrD,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAA;AAE1E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAA;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA2BD,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;+BAE+B;AAC/B,wBAAgB,aAAa,IAAI,YAAY,CAmD5C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAmB/F;AAED;gDACgD;AAChD,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAiCtF;AAED;;4BAE4B;AAC5B,wBAAgB,eAAe,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQvE"}

package/dist/cli-ui/service.js

@@ -0,0 +1,241 @@
+// cli-ui/service.ts — cross-platform service detection + lifecycle for
+// Agim (formerly im-hub-pro). Knows about three run modes:
+//
+//   1. systemd-managed   — Linux + root, either /etc/systemd/system/agim.service
+//                          (the v1.0+ unit) OR the legacy im-hub.service exists
+//                          and `systemctl is-active <unit>` returns "active".
+//                          New installs write agim.service; pre-v1.0 systems
+//                          continue to be detected via the legacy name.
+//   2. background daemon — `agim start --bg` writes ~/.im-hub/im-hub.pid
+//                          and ~/.im-hub/im-hub.log (paths kept under the
+//                          legacy ~/.im-hub/ for upgrade compatibility).
+//                          nohup + setsid; survives shell exit. Works on
+//                          Linux, macOS, WSL2.
+//   3. foreground        — a TTY-attached `agim start` (or the legacy
+//                          `im-hub-pro start`) somewhere. We detect it via
+//                          `pgrep -af` matching, but can't stop or restart
+//                          it from outside the owning TTY.
+//
+// The detection helpers are all best-effort: a missing systemctl, a stale
+// pid file, or a pgrep mismatch produces "not running" rather than an
+// error, so the caller can decide what to ack.
+import { execSync, spawn } from 'node:child_process';
+import { readFileSync, existsSync, writeFileSync, unlinkSync, mkdirSync, openSync, closeSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { AGIM_HOME } from '../core/agim-paths.js';
+// Pid + log files live inside whatever AGIM_HOME resolved to. Filenames
+// themselves stay `im-hub.*` for backwards compat with any external
+// monitoring / log-collection that's tailing them.
+export const PID_FILE = join(AGIM_HOME, 'im-hub.pid');
+export const LOG_FILE = join(AGIM_HOME, 'im-hub.log');
+/** Systemd unit candidates, checked in order. v1.0+ installers should
+ *  write `agim.service`; older installs use `im-hub.service`. We accept
+ *  either so users who upgraded across the rename don't lose detection.
+ *  `getSystemdUnit()` resolves which one exists. */
+const SYSTEMD_UNIT_CANDIDATES = [
+    '/etc/systemd/system/agim.service',
+    '/etc/systemd/system/im-hub.service',
+];
+function getSystemdUnit() {
+    for (const path of SYSTEMD_UNIT_CANDIDATES) {
+        if (existsSync(path)) {
+            // e.g. "/etc/systemd/system/agim.service" → "agim.service"
+            return { path, name: path.split('/').pop() ?? '' };
+        }
+    }
+    return null;
+}
+/** Check if a unix pid is alive. */
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Approximate uptime by reading /proc/<pid>/stat — Linux/WSL only.
+ *  On macOS we'd need `ps -o etime`; not bothering for status display. */
+function uptimeOfPid(pid) {
+    try {
+        const stat = readFileSync(`/proc/${pid}/stat`, 'utf-8');
+        // Field 22 (0-indexed 21) is start time in clock ticks since boot.
+        const fields = stat.slice(stat.lastIndexOf(')') + 2).split(' ');
+        const starttimeTicks = parseInt(fields[19], 10);
+        if (!Number.isFinite(starttimeTicks))
+            return undefined;
+        const ticksPerSec = parseInt(execSync('getconf CLK_TCK').toString().trim(), 10) || 100;
+        const bootTime = parseInt(execSync(`awk '/btime/ {print $2}' /proc/stat`).toString().trim(), 10);
+        if (!Number.isFinite(bootTime))
+            return undefined;
+        const startUnix = bootTime + starttimeTicks / ticksPerSec;
+        return Math.max(0, Math.floor(Date.now() / 1000 - startUnix));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Format seconds as e.g. "2h 15m" / "3d 4h" / "45s". */
+export function formatUptime(sec) {
+    if (sec < 60)
+        return `${sec}s`;
+    const m = Math.floor(sec / 60);
+    if (m < 60)
+        return `${m}m`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h ${m % 60}m`;
+    const d = Math.floor(h / 24);
+    return `${d}d ${h % 24}h`;
+}
+/** Look up the running mode + pid. Order matters: systemd wins, then bg
+ *  pid-file, then a foreground pgrep match. Returns `{mode:'none', pid:null}`
+ *  when nothing is running. */
+export function detectService() {
+    // 1. systemd — check whichever unit name exists (agim.service first,
+    //    im-hub.service fallback for pre-1.0 installs).
+    const unit = getSystemdUnit();
+    if (unit) {
+        try {
+            const active = execSync(`systemctl is-active ${unit.name} 2>&1`, { encoding: 'utf-8' }).trim();
+            if (active === 'active') {
+                let pid = null;
+                try {
+                    const out = execSync(`systemctl show -p MainPID --value ${unit.name}`, { encoding: 'utf-8' }).trim();
+                    const n = parseInt(out, 10);
+                    if (Number.isFinite(n) && n > 0)
+                        pid = n;
+                }
+                catch { /* keep null */ }
+                return {
+                    mode: 'systemd',
+                    pid,
+                    uptimeSec: pid ? uptimeOfPid(pid) : undefined,
+                };
+            }
+        }
+        catch { /* systemctl not on PATH, e.g. macOS — fall through */ }
+    }
+    // 2. background pid file
+    if (existsSync(PID_FILE)) {
+        try {
+            const pid = parseInt(readFileSync(PID_FILE, 'utf-8').trim(), 10);
+            if (Number.isFinite(pid) && pidAlive(pid)) {
+                return { mode: 'background', pid, uptimeSec: uptimeOfPid(pid) };
+            }
+        }
+        catch { /* fall through */ }
+    }
+    // 3. foreground — pgrep for our CLI. Match `agim start`, the legacy
+    //    `im-hub-pro start` (kept for users with old bin aliases), or
+    //    `dist/cli.js start`. Excludes the current process (the CLI that's
+    //    running this check).
+    try {
+        const out = execSync('pgrep -af "agim start|im-hub-pro start|dist/cli.js start"', {
+            encoding: 'utf-8',
+        }).trim();
+        const lines = out.split('\n').filter(Boolean);
+        for (const line of lines) {
+            const pid = parseInt(line.split(' ')[0], 10);
+            if (Number.isFinite(pid) && pid !== process.pid && pidAlive(pid)) {
+                return { mode: 'foreground', pid, uptimeSec: uptimeOfPid(pid) };
+            }
+        }
+    }
+    catch { /* pgrep found nothing — exit 1 */ }
+    return { mode: 'none', pid: null };
+}
+/**
+ * Spawn Agim detached with stdio redirected to ~/.im-hub/im-hub.log.
+ * Writes the pid to PID_FILE so subsequent `status` / `stop` find it.
+ *
+ * Cross-platform: setsid → new session, no controlling tty, parent can exit.
+ * On macOS where setsid isn't always reliable, fall through to a plain
+ * detached spawn (child still gets stdio: 'ignore' / 'pipe' redirected to
+ * the log file, which is enough to survive the parent).
+ */
+export function spawnBackground(executable, args = ['start']) {
+    mkdirSync(dirname(LOG_FILE), { recursive: true });
+    // Open the log file (append) and use its fd for child stdout/stderr.
+    // openSync + closeSync are statically imported at the top — require() doesn't
+    // exist in ESM modules (package.json has "type": "module").
+    const fd = openSync(LOG_FILE, 'a');
+    try {
+        const child = spawn(executable, args, {
+            detached: true,
+            stdio: ['ignore', fd, fd],
+            env: process.env,
+        });
+        child.unref();
+        if (!child.pid)
+            throw new Error('spawn returned no pid');
+        writeFileSync(PID_FILE, `${child.pid}\n`);
+        return { pid: child.pid };
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** Stop whichever instance is running. Returns the mode that was stopped
+ *  (or 'none' when there was nothing to do). */
+export async function stopService() {
+    const st = detectService();
+    if (st.mode === 'none')
+        return { mode: 'none', pid: null };
+    if (st.mode === 'systemd') {
+        const unit = getSystemdUnit();
+        if (unit) {
+            execSync(`systemctl stop ${unit.name}`, { stdio: 'inherit' });
+        }
+        return { mode: 'systemd', pid: st.pid };
+    }
+    if (st.mode === 'background' && st.pid) {
+        try {
+            process.kill(st.pid, 'SIGTERM');
+        }
+        catch { /* already gone */ }
+        // Wait up to 5s for clean exit, then SIGKILL.
+        for (let i = 0; i < 50; i++) {
+            if (!pidAlive(st.pid))
+                break;
+            await new Promise(r => setTimeout(r, 100));
+        }
+        if (pidAlive(st.pid)) {
+            try {
+                process.kill(st.pid, 'SIGKILL');
+            }
+            catch { /* ignore */ }
+        }
+        try {
+            unlinkSync(PID_FILE);
+        }
+        catch { /* ok if already gone */ }
+        return { mode: 'background', pid: st.pid };
+    }
+    if (st.mode === 'foreground' && st.pid) {
+        // Best-effort: try SIGTERM. The owning TTY may also see Ctrl-C.
+        try {
+            process.kill(st.pid, 'SIGTERM');
+        }
+        catch { /* ignore */ }
+        return { mode: 'foreground', pid: st.pid };
+    }
+    return { mode: 'none', pid: null };
+}
+/** Get the configured web bind+port from `<AGIM_HOME>/config.json` —
+ *  used by `status` to print the URL. Returns null when config is
+ *  absent / unparseable. */
+export function readWebEndpoint() {
+    try {
+        const raw = readFileSync(join(AGIM_HOME, 'config.json'), 'utf-8');
+        const cfg = JSON.parse(raw);
+        const bind = typeof cfg.web?.bind === 'string' ? cfg.web.bind : '127.0.0.1';
+        const port = typeof cfg.web?.port === 'number' ? cfg.web.port : 3000;
+        return { bind, port };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/cli-ui/service.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}