agenticros 0.0.1 → 0.1.1

package/dist/runners/sim.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Runners for the simulation modes.
+ *
+ * `agenticros up sim-amr` -> scripts/sim/run_sim.sh --robot amr
+ * `agenticros up sim-arm` -> scripts/sim/run_sim.sh --robot arm
+ *
+ * Phase 1 ships these as stubs that point the user at the Phase 2 work; once
+ * scripts/sim/run_sim.sh + the agenticros_sim ROS 2 package land, the two
+ * functions below become single-line execa invocations of run_sim.sh.
+ */
+export interface SimRunOptions {
+    namespace?: string;
+    useRviz?: boolean;
+    /** True = headless gz (-s --headless-rendering). Auto-detected from $DISPLAY upstream. */
+    headless?: boolean;
+}
+export declare function runSimAmr(opts: SimRunOptions): Promise<void>;
+export declare function runSimArm(opts: SimRunOptions): Promise<void>;
+//# sourceMappingURL=sim.d.ts.map

package/dist/runners/sim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim.d.ts","sourceRoot":"","sources":["../../src/runners/sim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAoCD,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE"}

package/dist/runners/sim.js

@@ -0,0 +1,53 @@
+/**
+ * Runners for the simulation modes.
+ *
+ * `agenticros up sim-amr` -> scripts/sim/run_sim.sh --robot amr
+ * `agenticros up sim-arm` -> scripts/sim/run_sim.sh --robot arm
+ *
+ * Phase 1 ships these as stubs that point the user at the Phase 2 work; once
+ * scripts/sim/run_sim.sh + the agenticros_sim ROS 2 package land, the two
+ * functions below become single-line execa invocations of run_sim.sh.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { execa } from "execa";
+import { getCliPaths } from "../util/paths.js";
+import { err, header, info, warn } from "../util/logger.js";
+import { writeState } from "../util/state.js";
+async function runSim(robot, opts) {
+    header(`AgenticROS - sim ${robot.toUpperCase()}`);
+    const paths = getCliPaths();
+    const script = join(paths.scriptsDir, "sim", "run_sim.sh");
+    if (!existsSync(script)) {
+        warn(`scripts/sim/run_sim.sh not found at ${script}.\n` +
+            "  Simulation support is delivered in Phase 2 of the CLI plan. Until then,\n" +
+            "  use `agenticros up real` against a real robot, or check back after the\n" +
+            "  agenticros_sim ROS 2 package is published.");
+        return;
+    }
+    const ns = opts.namespace ?? "sim_robot";
+    writeState({ lastNamespace: ns });
+    const args = ["--robot", robot, "--namespace", ns];
+    if (opts.useRviz)
+        args.push("--rviz");
+    if (opts.headless)
+        args.push("--no-gui");
+    info(`Invoking ${script} ${args.join(" ")}…`);
+    try {
+        await execa("bash", [script, ...args], {
+            env: { ...process.env, AGENTICROS_ROBOT_NAMESPACE: ns },
+            stdio: "inherit",
+        });
+    }
+    catch (e) {
+        err(`Sim launch failed: ${e instanceof Error ? e.message : String(e)}`);
+        process.exit(1);
+    }
+}
+export async function runSimAmr(opts) {
+    return runSim("amr", opts);
+}
+export async function runSimArm(opts) {
+    return runSim("arm", opts);
+}
+//# sourceMappingURL=sim.js.map

package/dist/runners/sim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim.js","sourceRoot":"","sources":["../../src/runners/sim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAS9C,KAAK,UAAU,MAAM,CAAC,KAAoB,EAAE,IAAmB;IAC7D,MAAM,CAAC,oBAAoB,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAElD,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAC3D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,IAAI,CACF,uCAAuC,MAAM,KAAK;YAChD,6EAA6E;YAC7E,4EAA4E;YAC5E,8CAA8C,CACjD,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,WAAW,CAAC;IACzC,UAAU,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;IAElC,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEzC,IAAI,CAAC,YAAY,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE;YACrC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,0BAA0B,EAAE,EAAE,EAAE;YACvD,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,sBAAsB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,OAAO,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB;IACjD,OAAO,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/util/env.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Environment + system detection helpers shared by doctor, init, and the runners.
+ */
+export interface RosInfo {
+    distro: string | undefined;
+    setupBash: string | undefined;
+}
+/** Look for /opt/ros/<distro>/setup.bash. Returns the first that exists, or undefined. */
+export declare function detectRosDistro(preferred?: string): RosInfo;
+/**
+ * Build the bash command prelude that sources ROS and the AgenticROS overlay
+ * before running a subsequent command. Used by runners that invoke shell scripts
+ * which expect `ros2`, `colcon`, etc. on PATH.
+ */
+export declare function buildRosSourcedShellCmd(body: string, opts?: {
+    distro?: string;
+    overlay?: string;
+}): string;
+/** True when Gazebo Harmonic (`gz sim`) is installed. */
+export declare function hasGazeboHarmonic(): boolean;
+export declare const isLinux: boolean;
+/** Whether we appear to be running on a Jetson (Tegra kernel). */
+export declare function isJetson(): boolean;
+//# sourceMappingURL=env.d.ts.map

package/dist/util/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/util/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/C,MAAM,CAOR;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,IAAI,OAAO,CAK3C;AAED,eAAO,MAAM,OAAO,SAA+B,CAAC;AAEpD,kEAAkE;AAClE,wBAAgB,QAAQ,IAAI,OAAO,CAMlC"}

package/dist/util/env.js

@@ -0,0 +1,53 @@
+/**
+ * Environment + system detection helpers shared by doctor, init, and the runners.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+/** Common ROS 2 install locations under /opt/ros/<distro>/setup.bash. */
+const KNOWN_DISTROS = ["humble", "iron", "jazzy", "rolling"];
+/** Look for /opt/ros/<distro>/setup.bash. Returns the first that exists, or undefined. */
+export function detectRosDistro(preferred) {
+    const candidates = preferred
+        ? [preferred, ...KNOWN_DISTROS.filter((d) => d !== preferred)]
+        : [...KNOWN_DISTROS];
+    for (const distro of candidates) {
+        const setupBash = `/opt/ros/${distro}/setup.bash`;
+        if (existsSync(setupBash))
+            return { distro, setupBash };
+    }
+    return { distro: undefined, setupBash: undefined };
+}
+/**
+ * Build the bash command prelude that sources ROS and the AgenticROS overlay
+ * before running a subsequent command. Used by runners that invoke shell scripts
+ * which expect `ros2`, `colcon`, etc. on PATH.
+ */
+export function buildRosSourcedShellCmd(body, opts = {}) {
+    const ros = detectRosDistro(opts.distro);
+    const parts = [];
+    if (ros.setupBash)
+        parts.push(`source "${ros.setupBash}"`);
+    if (opts.overlay && existsSync(opts.overlay))
+        parts.push(`source "${opts.overlay}"`);
+    parts.push(body);
+    return parts.join(" && ");
+}
+/** True when Gazebo Harmonic (`gz sim`) is installed. */
+export function hasGazeboHarmonic() {
+    for (const dir of ["/usr/bin", "/usr/local/bin"]) {
+        if (existsSync(join(dir, "gz")))
+            return true;
+    }
+    return false;
+}
+export const isLinux = process.platform === "linux";
+/** Whether we appear to be running on a Jetson (Tegra kernel). */
+export function isJetson() {
+    try {
+        return existsSync("/etc/nv_tegra_release");
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/util/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/util/env.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,yEAAyE;AACzE,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAOtE,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,SAAkB;IAChD,MAAM,UAAU,GAAG,SAAS;QAC1B,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;IACvB,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,YAAY,MAAM,aAAa,CAAC;QAClD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,OAA8C,EAAE;IAEhD,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,GAAG,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;IAC3D,IAAI,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACrF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,iBAAiB;IAC/B,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAEpD,kEAAkE;AAClE,MAAM,UAAU,QAAQ;IACtB,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/util/logger.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Logging primitives for the CLI: coloured headers, status lines, spinners.
+ *
+ * Wraps picocolors + ora behind a thin interface so the rest of the CLI imports
+ * a single module. Honours `--no-color` (picocolors respects FORCE_COLOR / NO_COLOR
+ * automatically) and degrades gracefully when stdout is not a TTY.
+ */
+/** Whether stdout is a TTY (used to suppress spinners in pipes / CI). */
+export declare const isTty: boolean;
+export declare const colors: import("picocolors/types.js").Colors & {
+    createColors: (enabled?: boolean) => import("picocolors/types.js").Colors;
+};
+export declare function header(title: string): void;
+export declare function info(message: string): void;
+export declare function ok(message: string): void;
+export declare function warn(message: string): void;
+export declare function err(message: string): void;
+export declare function dim(message: string): void;
+/**
+ * Spinner for a short async operation. Falls back to a plain "› message …" line
+ * when stdout is not a TTY.
+ */
+export declare function withSpinner<T>(message: string, task: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/util/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,yEAAyE;AACzE,eAAO,MAAM,KAAK,EAAE,OAAuC,CAAC;AAE5D,eAAO,MAAM,MAAM;0BAXV,CAAC;CAWc,CAAC;AAEzB,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK1C;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAExC;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAqBZ"}

package/dist/util/logger.js

@@ -0,0 +1,62 @@
+/**
+ * Logging primitives for the CLI: coloured headers, status lines, spinners.
+ *
+ * Wraps picocolors + ora behind a thin interface so the rest of the CLI imports
+ * a single module. Honours `--no-color` (picocolors respects FORCE_COLOR / NO_COLOR
+ * automatically) and degrades gracefully when stdout is not a TTY.
+ */
+import oraImport from "ora";
+import pc from "picocolors";
+/** Whether stdout is a TTY (used to suppress spinners in pipes / CI). */
+export const isTty = Boolean(process.stdout.isTTY);
+export const colors = pc;
+export function header(title) {
+    const line = "─".repeat(Math.min(title.length + 4, 60));
+    process.stdout.write(`\n${pc.bold(pc.cyan(`╔${line}╗`))}\n`);
+    process.stdout.write(`${pc.bold(pc.cyan(`║  ${title}  ║`))}\n`);
+    process.stdout.write(`${pc.bold(pc.cyan(`╚${line}╝`))}\n\n`);
+}
+export function info(message) {
+    process.stdout.write(`${pc.cyan("›")} ${message}\n`);
+}
+export function ok(message) {
+    process.stdout.write(`${pc.green("✓")} ${message}\n`);
+}
+export function warn(message) {
+    process.stdout.write(`${pc.yellow("!")} ${pc.yellow(message)}\n`);
+}
+export function err(message) {
+    process.stderr.write(`${pc.red("✗")} ${pc.red(message)}\n`);
+}
+export function dim(message) {
+    process.stdout.write(`  ${pc.dim(message)}\n`);
+}
+/**
+ * Spinner for a short async operation. Falls back to a plain "› message …" line
+ * when stdout is not a TTY.
+ */
+export async function withSpinner(message, task) {
+    if (!isTty) {
+        process.stdout.write(`${pc.cyan("›")} ${message} ...\n`);
+        try {
+            const value = await task();
+            process.stdout.write(`${pc.green("✓")} ${message}\n`);
+            return value;
+        }
+        catch (e) {
+            process.stdout.write(`${pc.red("✗")} ${message}\n`);
+            throw e;
+        }
+    }
+    const spinner = oraImport({ text: message, spinner: "dots" }).start();
+    try {
+        const value = await task();
+        spinner.succeed(message);
+        return value;
+    }
+    catch (e) {
+        spinner.fail(message);
+        throw e;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

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

package/dist/util/paths.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Path discovery for the AgenticROS CLI.
+ *
+ * The CLI can be invoked three ways:
+ *   1. Workspace mode  - from a cloned monorepo. Scripts live under
+ *      <repo-root>/scripts/, ros2 sources under <repo-root>/ros2_ws/src/, and
+ *      built MCP under <repo-root>/packages/agenticros-claude-code/dist/.
+ *   2. Installed mode  - after `npx agenticros init` has copied the bundled
+ *      snapshot into ~/agenticros (the install dir). Same layout as workspace
+ *      mode but rooted at the install dir. This is the "post-init" steady state.
+ *   3. Bundle mode  - first invocation of `npx agenticros` before init has run.
+ *      Paths point into the package's own runtime/ directory, populated at
+ *      publish time by scripts/pack-runtime.mjs. Only read-only tools (doctor,
+ *      version, --help) are guaranteed to work in bundle mode.
+ *
+ * Workspace mode is preferred when detected so contributors see their live edits.
+ * Installed mode is preferred over bundle mode so that init-time builds (which
+ * write dist artifacts into ~/agenticros) are honoured on subsequent invocations.
+ */
+export type CliMode = "workspace" | "installed" | "bundle";
+export interface CliPaths {
+    /** Discovered execution mode. */
+    mode: CliMode;
+    /** Backwards-compat alias for code that just wants the workspace/installed branch. */
+    workspaceMode: boolean;
+    /** Directory containing the agenticros CLI package (where runtime/ would live). */
+    pkgDir: string;
+    /**
+     * Active "repo root" the CLI is operating against. For workspace mode this is
+     * the cloned monorepo. For installed mode this is the install dir. For bundle
+     * mode this is undefined (no writable repo root yet).
+     */
+    repoRoot: string | undefined;
+    /** Directory where AgenticROS user data lives ($HOME/.agenticros). */
+    userDataDir: string;
+    /** Default install directory written by `agenticros init` (~/agenticros). */
+    installDir: string;
+    /** Path to the scripts/ directory (live workspace or bundled snapshot). */
+    scriptsDir: string;
+    /** Path to ros2_ws/src/ source root (live workspace or bundled snapshot). */
+    ros2WsSrcDir: string;
+    /** Path to the MCP server build directory (agenticros-claude-code/dist or runtime/mcp). */
+    mcpDistDir: string;
+    /** Path to bundled sample configs (only meaningful in npm mode; falls back to repo docs/). */
+    configsDir: string;
+    /**
+     * Path to the bundled snapshot of the monorepo (only set in bundle mode and
+     * for `agenticros init` in installed mode where it's the source-of-truth for
+     * the initial copy). Undefined in workspace mode.
+     */
+    bundleDir: string | undefined;
+}
+export declare function getCliPaths(): CliPaths;
+/** For tests / dev — reset cached path detection. */
+export declare function resetPathsCache(): void;
+export declare function resolveScriptPath(name: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/util/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/util/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,sFAAsF;IACtF,aAAa,EAAE,OAAO,CAAC;IACvB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,UAAU,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAkCD,wBAAgB,WAAW,IAAI,QAAQ,CAiFtC;AAED,qDAAqD;AACrD,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/util/paths.js

@@ -0,0 +1,132 @@
+/**
+ * Path discovery for the AgenticROS CLI.
+ *
+ * The CLI can be invoked three ways:
+ *   1. Workspace mode  - from a cloned monorepo. Scripts live under
+ *      <repo-root>/scripts/, ros2 sources under <repo-root>/ros2_ws/src/, and
+ *      built MCP under <repo-root>/packages/agenticros-claude-code/dist/.
+ *   2. Installed mode  - after `npx agenticros init` has copied the bundled
+ *      snapshot into ~/agenticros (the install dir). Same layout as workspace
+ *      mode but rooted at the install dir. This is the "post-init" steady state.
+ *   3. Bundle mode  - first invocation of `npx agenticros` before init has run.
+ *      Paths point into the package's own runtime/ directory, populated at
+ *      publish time by scripts/pack-runtime.mjs. Only read-only tools (doctor,
+ *      version, --help) are guaranteed to work in bundle mode.
+ *
+ * Workspace mode is preferred when detected so contributors see their live edits.
+ * Installed mode is preferred over bundle mode so that init-time builds (which
+ * write dist artifacts into ~/agenticros) are honoured on subsequent invocations.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+/**
+ * True when `dir` looks like an AgenticROS monorepo root (live or installed
+ * snapshot): its package.json is `agenticros-monorepo`.
+ */
+function isAgenticrosMonorepo(dir) {
+    const pkgPath = join(dir, "package.json");
+    if (!existsSync(pkgPath))
+        return false;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        return pkg.name === "agenticros-monorepo";
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Walk up from `startDir` looking for an agenticros-monorepo package.json.
+ * Returns the repo root or undefined.
+ */
+function findRepoRoot(startDir) {
+    let dir = startDir;
+    for (let i = 0; i < 8; i++) {
+        if (isAgenticrosMonorepo(dir))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return undefined;
+}
+let cached;
+export function getCliPaths() {
+    if (cached)
+        return cached;
+    // moduleDir is .../packages/agenticros-cli/dist/util in workspace, or
+    // .../node_modules/agenticros/dist/util in npm install. The published bundle
+    // is a single file dist/index.js, so moduleDir will be .../dist.
+    // Walk up to find the package dir (the one with our package.json).
+    let pkgDir = moduleDir;
+    for (let i = 0; i < 5; i++) {
+        if (existsSync(join(pkgDir, "package.json")))
+            break;
+        pkgDir = dirname(pkgDir);
+    }
+    const workspaceRoot = findRepoRoot(pkgDir);
+    const home = process.env["HOME"] ?? process.env["USERPROFILE"] ?? ".";
+    const userDataDir = join(home, ".agenticros");
+    const installDir = process.env["AGENTICROS_HOME"] ?? join(home, "agenticros");
+    const bundleDir = join(pkgDir, "runtime");
+    // Workspace mode wins outright: contributors get live edits.
+    if (workspaceRoot) {
+        cached = {
+            mode: "workspace",
+            workspaceMode: true,
+            pkgDir,
+            repoRoot: workspaceRoot,
+            userDataDir,
+            installDir,
+            scriptsDir: join(workspaceRoot, "scripts"),
+            ros2WsSrcDir: join(workspaceRoot, "ros2_ws", "src"),
+            mcpDistDir: join(workspaceRoot, "packages", "agenticros-claude-code", "dist"),
+            configsDir: join(workspaceRoot, "docs"),
+            bundleDir: existsSync(bundleDir) ? bundleDir : undefined,
+        };
+        return cached;
+    }
+    // Installed mode: ~/agenticros has been populated by a prior `agenticros init`.
+    if (isAgenticrosMonorepo(installDir)) {
+        cached = {
+            mode: "installed",
+            workspaceMode: true,
+            pkgDir,
+            repoRoot: installDir,
+            userDataDir,
+            installDir,
+            scriptsDir: join(installDir, "scripts"),
+            ros2WsSrcDir: join(installDir, "ros2_ws", "src"),
+            mcpDistDir: join(installDir, "packages", "agenticros-claude-code", "dist"),
+            configsDir: join(installDir, "docs"),
+            bundleDir: existsSync(bundleDir) ? bundleDir : undefined,
+        };
+        return cached;
+    }
+    // Bundle mode: first invocation of `npx agenticros` before init.
+    cached = {
+        mode: "bundle",
+        workspaceMode: false,
+        pkgDir,
+        repoRoot: undefined,
+        userDataDir,
+        installDir,
+        scriptsDir: join(bundleDir, "scripts"),
+        ros2WsSrcDir: join(bundleDir, "ros2_ws", "src"),
+        mcpDistDir: join(bundleDir, "packages", "agenticros-claude-code", "dist"),
+        configsDir: join(bundleDir, "docs"),
+        bundleDir,
+    };
+    return cached;
+}
+/** For tests / dev — reset cached path detection. */
+export function resetPathsCache() {
+    cached = undefined;
+}
+export function resolveScriptPath(name) {
+    return resolve(getCliPaths().scriptsDir, name);
+}
+//# sourceMappingURL=paths.js.map

package/dist/util/paths.js.map

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

package/dist/util/pidfile.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pidfile management for processes the CLI spawns into the background
+ * (RealSense camera, Gazebo, etc.). Same /tmp/agenticros-*.pid convention as
+ * the existing scripts/start_demo.sh.
+ */
+export type ManagedProcess = "camera" | "sim" | "mcp" | "rosbridge";
+export declare function writePid(name: ManagedProcess, pid: number): void;
+export declare function readPid(name: ManagedProcess): number | undefined;
+/** True if the recorded PID exists and is still alive. */
+export declare function isPidAlive(name: ManagedProcess): boolean;
+/** Kill the recorded process gently (SIGTERM). Returns the pid that was signalled. */
+export declare function killPid(name: ManagedProcess, signal?: NodeJS.Signals): number | undefined;
+export declare function clearPid(name: ManagedProcess): void;
+/** Log file path for a managed process, matching the start_demo.sh convention. */
+export declare function logPath(name: ManagedProcess): string;
+//# sourceMappingURL=pidfile.d.ts.map

package/dist/util/pidfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pidfile.d.ts","sourceRoot":"","sources":["../../src/util/pidfile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,KAAK,GACL,KAAK,GACL,WAAW,CAAC;AAMhB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAMhE;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CASxD;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,MAAM,GAAG,SAAS,CASpG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CASnD;AAED,kFAAkF;AAClF,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAEpD"}

package/dist/util/pidfile.js

@@ -0,0 +1,63 @@
+/**
+ * Pidfile management for processes the CLI spawns into the background
+ * (RealSense camera, Gazebo, etc.). Same /tmp/agenticros-*.pid convention as
+ * the existing scripts/start_demo.sh.
+ */
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+const PID_DIR = "/tmp";
+function pidPath(name) {
+    return `${PID_DIR}/agenticros-${name}.pid`;
+}
+export function writePid(name, pid) {
+    writeFileSync(pidPath(name), String(pid));
+}
+export function readPid(name) {
+    const p = pidPath(name);
+    if (!existsSync(p))
+        return undefined;
+    const raw = readFileSync(p, "utf8").trim();
+    const pid = Number(raw);
+    return Number.isFinite(pid) && pid > 0 ? pid : undefined;
+}
+/** True if the recorded PID exists and is still alive. */
+export function isPidAlive(name) {
+    const pid = readPid(name);
+    if (!pid)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Kill the recorded process gently (SIGTERM). Returns the pid that was signalled. */
+export function killPid(name, signal = "SIGTERM") {
+    const pid = readPid(name);
+    if (!pid)
+        return undefined;
+    try {
+        process.kill(pid, signal);
+        return pid;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function clearPid(name) {
+    const p = pidPath(name);
+    if (existsSync(p)) {
+        try {
+            unlinkSync(p);
+        }
+        catch {
+            // best effort
+        }
+    }
+}
+/** Log file path for a managed process, matching the start_demo.sh convention. */
+export function logPath(name) {
+    return `/tmp/agenticros-${name}.log`;
+}
+//# sourceMappingURL=pidfile.js.map

package/dist/util/pidfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pidfile.js","sourceRoot":"","sources":["../../src/util/pidfile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE9E,MAAM,OAAO,GAAG,MAAM,CAAC;AAQvB,SAAS,OAAO,CAAC,IAAoB;IACnC,OAAO,GAAG,OAAO,eAAe,IAAI,MAAM,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAoB,EAAE,GAAW;IACxD,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAoB;IAC1C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,IAAoB;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,OAAO,CAAC,IAAoB,EAAE,SAAyB,SAAS;IAC9E,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1B,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAoB;IAC3C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,UAAU,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,OAAO,CAAC,IAAoB;IAC1C,OAAO,mBAAmB,IAAI,MAAM,CAAC;AACvC,CAAC"}

package/dist/util/state.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Persistent CLI state stored in ~/.agenticros/cli-state.json.
+ *
+ * Used by the interactive menu to remember last-used choices so subsequent
+ * runs default sensibly. Intentionally tiny — anything bigger belongs in
+ * ~/.agenticros/config.json (the AgenticROS runtime config).
+ */
+export interface CliState {
+    /** "real" | "sim-amr" | "sim-arm" */
+    lastMode?: string;
+    /** Last AgenticROS robot namespace used (e.g. "sim_robot" or a UUID-derived id). */
+    lastNamespace?: string;
+    /** Last ROS distro choice for `up real` (e.g. "humble" / "jazzy"). */
+    lastRosDistro?: string;
+    /** Whether to show RViz by default for sim launches. */
+    lastUseRviz?: boolean;
+    /** ISO timestamp of the last `agenticros up` invocation, for "(yesterday)" hints. */
+    lastUpAt?: string;
+    /** Schema version — bump when we add migrations. */
+    v?: number;
+}
+export declare function readState(): CliState;
+export declare function writeState(patch: Partial<CliState>): CliState;
+/** Friendly age string for menu hints: "today", "yesterday", "3 days ago". */
+export declare function formatAge(iso: string | undefined): string | undefined;
+//# sourceMappingURL=state.d.ts.map

package/dist/util/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/util/state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAMD,wBAAgB,SAAS,IAAI,QAAQ,CAWpC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAO7D;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUrE"}

package/dist/util/state.js

@@ -0,0 +1,55 @@
+/**
+ * Persistent CLI state stored in ~/.agenticros/cli-state.json.
+ *
+ * Used by the interactive menu to remember last-used choices so subsequent
+ * runs default sensibly. Intentionally tiny — anything bigger belongs in
+ * ~/.agenticros/config.json (the AgenticROS runtime config).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getCliPaths } from "./paths.js";
+function statePath() {
+    return join(getCliPaths().userDataDir, "cli-state.json");
+}
+export function readState() {
+    const p = statePath();
+    if (!existsSync(p))
+        return {};
+    try {
+        const raw = readFileSync(p, "utf8");
+        const obj = JSON.parse(raw);
+        if (typeof obj === "object" && obj !== null)
+            return obj;
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+export function writeState(patch) {
+    const p = statePath();
+    mkdirSync(dirname(p), { recursive: true });
+    const current = readState();
+    const next = { v: 1, ...current, ...patch };
+    writeFileSync(p, JSON.stringify(next, null, 2));
+    return next;
+}
+/** Friendly age string for menu hints: "today", "yesterday", "3 days ago". */
+export function formatAge(iso) {
+    if (!iso)
+        return undefined;
+    const then = new Date(iso).getTime();
+    if (!Number.isFinite(then))
+        return undefined;
+    const days = Math.floor((Date.now() - then) / 86_400_000);
+    if (days <= 0)
+        return "today";
+    if (days === 1)
+        return "yesterday";
+    if (days < 30)
+        return `${days} days ago`;
+    if (days < 365)
+        return `${Math.floor(days / 30)} months ago`;
+    return `${Math.floor(days / 365)} years ago`;
+}
+//# sourceMappingURL=state.js.map