agenticros 0.1.18 → 0.1.19

package/dist/util/robot-config.js

@@ -0,0 +1,375 @@
+/**
+ * Robot config R/W for the AgenticROS CLI.
+ *
+ * Lives in the CLI so the multi-robot persistence path does NOT pull
+ * `@agenticros/core` (and its transport deps) into the published
+ * `agenticros` tarball. The shape we read/write is intentionally a
+ * subset of `@agenticros/core`'s `AgenticROSConfig.robots`:
+ *
+ *   robots: Array<{
+ *     id: string;
+ *     name?: string;
+ *     namespace?: string;
+ *     cameraTopic?: string;
+ *     default?: boolean;
+ *   }>
+ *
+ * Backwards compat with the legacy single-robot config:
+ *   - If `config.robots` is absent/empty AND `config.robot` is set, we
+ *     "promote" `config.robot` into `robots[0]` on the next write. The
+ *     legacy `config.robot` field is LEFT in place (harmlessly — the
+ *     core resolver prefers the explicit array when non-empty) so older
+ *     adapters that only read `config.robot` keep working.
+ *   - When the file is missing or empty we treat it as `{}`. Writes
+ *     create both the file and its directory.
+ *
+ * All paths route through the CLI's own paths helper so workspace /
+ * installed / bundle modes pick up the same `~/.agenticros/config.json`.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getCliPaths } from "./paths.js";
+/** Default value carried over when the legacy `config.robot` is promoted. */
+const DEFAULT_ROBOT_NAME = "Robot";
+export function robotConfigPath() {
+    return join(getCliPaths().userDataDir, "config.json");
+}
+/** Parse `~/.agenticros/config.json` to a plain object, or `{}` when absent/bad. */
+export function readConfigObject(path = robotConfigPath()) {
+    if (!existsSync(path))
+        return {};
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        /* fallthrough — return {} on parse error */
+    }
+    return {};
+}
+/** Write the config object back, creating directories as needed. */
+export function writeConfigObject(obj, path = robotConfigPath()) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(obj, null, 2)}\n`);
+}
+/**
+ * Resolve the legacy `config.robot` to a RobotEntry, mirroring the core
+ * resolver. `id` falls back to namespace (or "default"), `name` to "Robot".
+ * Returns `null` if neither the legacy object nor a usable namespace exists.
+ */
+function legacyToEntry(legacy) {
+    if (!legacy || typeof legacy !== "object" || Array.isArray(legacy))
+        return null;
+    const r = legacy;
+    const namespace = typeof r["namespace"] === "string" ? r["namespace"] : "";
+    const name = typeof r["name"] === "string" && r["name"].trim() ? r["name"] : DEFAULT_ROBOT_NAME;
+    const cameraTopic = typeof r["cameraTopic"] === "string" ? r["cameraTopic"] : "";
+    // Synthesise id from namespace, falling back to "default" — same as
+    // @agenticros/core's `listRobots()` legacy fallback.
+    const id = namespace.trim() || "default";
+    return { id, name, namespace, cameraTopic };
+}
+/**
+ * Return the robots[] view the agent would see (explicit array when
+ * non-empty, otherwise a one-entry array synthesised from legacy
+ * `config.robot`). Read-only — the CLI uses this to render `robots list`
+ * without ever needing to import @agenticros/core.
+ */
+export function readRobots(obj = readConfigObject()) {
+    const explicit = Array.isArray(obj["robots"]) ? obj["robots"] : [];
+    if (explicit.length > 0) {
+        const robots = explicit
+            .filter((r) => !!r && typeof r === "object" && !Array.isArray(r))
+            .map((r) => ({
+            id: String(r["id"] ?? ""),
+            name: typeof r["name"] === "string" ? r["name"] : undefined,
+            namespace: typeof r["namespace"] === "string" ? r["namespace"] : undefined,
+            cameraTopic: typeof r["cameraTopic"] === "string" ? r["cameraTopic"] : undefined,
+            default: r["default"] === true ? true : undefined,
+            kind: typeof r["kind"] === "string" ? r["kind"] : undefined,
+            sensors: r["sensors"] && typeof r["sensors"] === "object" && !Array.isArray(r["sensors"])
+                ? r["sensors"]
+                : undefined,
+            capabilities: Array.isArray(r["capabilities"])
+                ? r["capabilities"].filter((c) => typeof c === "string")
+                : undefined,
+            transport: r["transport"] && typeof r["transport"] === "object" && !Array.isArray(r["transport"])
+                ? r["transport"]
+                : undefined,
+        }))
+            .filter((r) => r.id.length > 0);
+        return { robots, from: "explicit" };
+    }
+    const legacy = legacyToEntry(obj["robot"]);
+    if (legacy)
+        return { robots: [legacy], from: "legacy" };
+    return { robots: [], from: "none" };
+}
+/**
+ * Compute the active robot id using the same precedence the core
+ * resolver does:
+ *   1. explicit robots[] entry with `default: true`
+ *   2. first entry in robots[] (with legacy fallback)
+ *   3. undefined when there are no robots at all
+ */
+export function getActiveRobotId(obj = readConfigObject()) {
+    const explicit = Array.isArray(obj["robots"]) ? obj["robots"] : [];
+    if (explicit.length > 0) {
+        const flagged = explicit.find((r) => r != null &&
+            typeof r === "object" &&
+            !Array.isArray(r) &&
+            r["default"] === true);
+        if (flagged && typeof flagged["id"] === "string" && flagged["id"]) {
+            return flagged["id"];
+        }
+    }
+    const { robots } = readRobots(obj);
+    return robots[0]?.id;
+}
+/**
+ * Add a robot to `config.robots[]`.
+ *
+ * Promotes the legacy single-robot config on first multi-robot write —
+ * `config.robot` is copied as the first entry in the array, and any
+ * `default: true` flag we'd set on the new entry is held against that
+ * promoted incumbent (it stays the default unless the caller explicitly
+ * asks otherwise).
+ *
+ * Idempotent: re-adding an existing id updates name/namespace/cameraTopic
+ * in place but returns `added: false` so the CLI can render the right
+ * "already present" message.
+ */
+export function addRobot(entry, opts = {}) {
+    const obj = opts.obj ?? readConfigObject();
+    const explicit = Array.isArray(obj["robots"]) ? [...obj["robots"]] : [];
+    let promotedLegacy = false;
+    if (explicit.length === 0) {
+        const legacy = legacyToEntry(obj["robot"]);
+        if (legacy) {
+            // Promote: legacy becomes the (default) first entry. We mark it
+            // default so the existing behavior — "the single configured robot
+            // is the active one" — is preserved unless the caller of this
+            // add explicitly sets the new entry as default below.
+            explicit.push({ ...legacy, default: true });
+            promotedLegacy = true;
+        }
+    }
+    // De-dup by id. If the id already exists, update in place and return
+    // added=false. This is what makes `agenticros robots add <id>` a
+    // safe idempotent operation.
+    const existingIdx = explicit.findIndex((r) => r != null &&
+        typeof r === "object" &&
+        !Array.isArray(r) &&
+        String(r["id"] ?? "") === entry.id);
+    const next = {
+        id: entry.id,
+        name: entry.name ?? DEFAULT_ROBOT_NAME,
+        namespace: entry.namespace ?? "",
+        cameraTopic: entry.cameraTopic ?? "",
+    };
+    if (opts.setDefault)
+        next["default"] = true;
+    // Caller may carry an explicit per-robot transport override into the
+    // entry. When omitted on an in-place update we preserve the prior
+    // override (see below) so re-running `robots add` without --transport
+    // doesn't silently drop a previously-configured override.
+    if (entry.transport !== undefined)
+        next["transport"] = entry.transport;
+    // Same preserve-on-update story for kind / sensors / capabilities —
+    // these are sticky Phase 1.e fleet-metadata fields that survive a
+    // `robots add <id> --name=...`.
+    if (entry.kind !== undefined)
+        next["kind"] = entry.kind;
+    if (entry.sensors !== undefined)
+        next["sensors"] = entry.sensors;
+    if (entry.capabilities !== undefined)
+        next["capabilities"] = entry.capabilities;
+    let added;
+    if (existingIdx >= 0) {
+        // Update in place. Preserve any `default` already on the entry
+        // unless the caller is explicitly setting it.
+        const prev = explicit[existingIdx];
+        if (opts.setDefault === undefined && prev["default"] === true)
+            next["default"] = true;
+        if (entry.transport === undefined &&
+            prev["transport"] &&
+            typeof prev["transport"] === "object" &&
+            !Array.isArray(prev["transport"])) {
+            next["transport"] = prev["transport"];
+        }
+        if (entry.kind === undefined && typeof prev["kind"] === "string") {
+            next["kind"] = prev["kind"];
+        }
+        if (entry.sensors === undefined &&
+            prev["sensors"] &&
+            typeof prev["sensors"] === "object" &&
+            !Array.isArray(prev["sensors"])) {
+            next["sensors"] = prev["sensors"];
+        }
+        if (entry.capabilities === undefined && Array.isArray(prev["capabilities"])) {
+            next["capabilities"] = prev["capabilities"];
+        }
+        explicit[existingIdx] = next;
+        added = false;
+    }
+    else {
+        explicit.push(next);
+        added = true;
+    }
+    // If the caller is making this new entry the default, strip default
+    // off every other entry — only one robot is default at a time.
+    if (opts.setDefault) {
+        for (let i = 0; i < explicit.length; i++) {
+            const r = explicit[i];
+            if (i === (existingIdx >= 0 ? existingIdx : explicit.length - 1))
+                continue;
+            if (r && r["default"] === true) {
+                const { default: _drop, ...rest } = r;
+                void _drop;
+                explicit[i] = rest;
+            }
+        }
+    }
+    obj["robots"] = explicit;
+    return {
+        added,
+        promotedLegacy,
+        robots: explicit.map((r) => r),
+    };
+}
+/**
+ * Remove a robot from `config.robots[]` by id.
+ *
+ * Returns `removed: false` when the id isn't present. Removing the last
+ * entry leaves `robots: []` (which the core resolver then ignores in
+ * favour of the legacy `config.robot` fallback — so the deployment
+ * keeps working).
+ *
+ * Idempotent across re-runs.
+ */
+export function removeRobot(id, obj = readConfigObject()) {
+    const explicit = Array.isArray(obj["robots"]) ? [...obj["robots"]] : [];
+    const idx = explicit.findIndex((r) => r != null &&
+        typeof r === "object" &&
+        !Array.isArray(r) &&
+        String(r["id"] ?? "") === id);
+    if (idx < 0) {
+        return { removed: false, robots: explicit };
+    }
+    explicit.splice(idx, 1);
+    obj["robots"] = explicit;
+    return { removed: true, robots: explicit };
+}
+/**
+ * Set `default: true` on exactly one robot in `config.robots[]`.
+ *
+ * Auto-promotes the legacy single-robot config first if needed (so
+ * marking the first new robot as default doesn't lose the previous
+ * incumbent). Throws when the id isn't present after promotion.
+ */
+export function setDefaultRobot(id, obj = readConfigObject()) {
+    const explicit = Array.isArray(obj["robots"]) ? [...obj["robots"]] : [];
+    let promotedLegacy = false;
+    if (explicit.length === 0) {
+        const legacy = legacyToEntry(obj["robot"]);
+        if (legacy) {
+            explicit.push({ ...legacy, default: false });
+            promotedLegacy = true;
+        }
+    }
+    const idx = explicit.findIndex((r) => r != null &&
+        typeof r === "object" &&
+        !Array.isArray(r) &&
+        String(r["id"] ?? "") === id);
+    if (idx < 0) {
+        const known = explicit
+            .map((r) => String(r["id"] ?? ""))
+            .filter((s) => s.length > 0)
+            .join(", ");
+        throw new Error(`Unknown robot id "${id}". Known: ${known || "(none — add it first with `agenticros robots add`)"}.`);
+    }
+    for (let i = 0; i < explicit.length; i++) {
+        const r = { ...explicit[i] };
+        if (i === idx)
+            r["default"] = true;
+        else
+            delete r["default"];
+        explicit[i] = r;
+    }
+    obj["robots"] = explicit;
+    return { robots: explicit, promotedLegacy };
+}
+/**
+ * Apply a per-robot transport override to an existing robot.
+ *
+ * Auto-promotes legacy `config.robot` into `config.robots[]` so the
+ * caller can target the historical single-robot config by its derived
+ * id. Throws when the id can't be found after promotion — matching the
+ * UX of `setDefaultRobot`.
+ *
+ * The `override` argument is the plain JSON shape the core's
+ * `RobotTransportOverrideSchema` will validate at config-load time. The
+ * CLI doesn't validate field shapes — that lives in `@agenticros/core`.
+ */
+export function setTransportForRobot(id, override, obj = readConfigObject()) {
+    const explicit = Array.isArray(obj["robots"]) ? [...obj["robots"]] : [];
+    let promotedLegacy = false;
+    if (explicit.length === 0) {
+        const legacy = legacyToEntry(obj["robot"]);
+        if (legacy) {
+            explicit.push({ ...legacy, default: true });
+            promotedLegacy = true;
+        }
+    }
+    const idx = explicit.findIndex((r) => r != null &&
+        typeof r === "object" &&
+        !Array.isArray(r) &&
+        String(r["id"] ?? "") === id);
+    if (idx < 0) {
+        const known = explicit
+            .map((r) => String(r["id"] ?? ""))
+            .filter((s) => s.length > 0)
+            .join(", ");
+        throw new Error(`Unknown robot id "${id}". Known: ${known || "(none — add it first with `agenticros robots add`)"}.`);
+    }
+    explicit[idx] = { ...explicit[idx], transport: override };
+    obj["robots"] = explicit;
+    return { robots: explicit, promotedLegacy };
+}
+/**
+ * Remove a per-robot transport override (so the robot inherits the
+ * global transport config). Idempotent — returns `cleared: false` when
+ * the robot didn't have an override to begin with. Throws on unknown id
+ * (we'd rather complain loudly than silently no-op against a typo).
+ */
+export function clearTransportForRobot(id, obj = readConfigObject()) {
+    const explicit = Array.isArray(obj["robots"]) ? [...obj["robots"]] : [];
+    let promotedLegacy = false;
+    if (explicit.length === 0) {
+        const legacy = legacyToEntry(obj["robot"]);
+        if (legacy) {
+            explicit.push({ ...legacy, default: true });
+            promotedLegacy = true;
+        }
+    }
+    const idx = explicit.findIndex((r) => r != null &&
+        typeof r === "object" &&
+        !Array.isArray(r) &&
+        String(r["id"] ?? "") === id);
+    if (idx < 0) {
+        const known = explicit
+            .map((r) => String(r["id"] ?? ""))
+            .filter((s) => s.length > 0)
+            .join(", ");
+        throw new Error(`Unknown robot id "${id}". Known: ${known || "(none — add it first with `agenticros robots add`)"}.`);
+    }
+    const prev = { ...explicit[idx] };
+    const hadOverride = prev["transport"] !== undefined;
+    delete prev["transport"];
+    explicit[idx] = prev;
+    obj["robots"] = explicit;
+    return { cleared: hadOverride, robots: explicit, promotedLegacy };
+}
+//# sourceMappingURL=robot-config.js.map

package/dist/util/robot-config.js.map

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

package/dist/util/transport-shorthand.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Parse a `--transport=<shorthand>` flag into the JSON-shaped object the
+ * core resolver expects under `config.robots[i].transport`.
+ *
+ * Shorthand grammar (most-common-case-first):
+ *
+ *     <mode>[:<primary-value>]
+ *
+ *   - `zenoh`                              ⇒ inherit everything from global config.zenoh
+ *   - `zenoh:<routerEndpoint>`             ⇒ override the router endpoint only
+ *   - `rosbridge`                          ⇒ inherit global rosbridge config
+ *   - `rosbridge:<url>`                    ⇒ override rosbridge url
+ *   - `local`                              ⇒ inherit global local config
+ *   - `local:<domainId>`                   ⇒ override DDS domain id (integer ≥ 0)
+ *   - `webrtc`                             ⇒ inherit global webrtc config
+ *   - `webrtc:<signalingUrl>`              ⇒ override signaling url
+ *
+ * Anything more elaborate (multiple sub-fields, custom iceServers, etc.)
+ * should use `--transport-json=...` which is passed straight through to
+ * the core Zod schema. The CLI deliberately doesn't model the full set
+ * of sub-fields — that would couple this layer to every transport
+ * adapter's settings shape. The shorthand exists for the 95% of users
+ * who only want to point one robot at a different router.
+ *
+ * Errors are intentionally specific — they tell the user the exact
+ * accepted forms so they can recover without hunting through docs.
+ */
+export type TransportOverrideJson = {
+    mode: "zenoh";
+    zenoh?: {
+        routerEndpoint?: string;
+    };
+} | {
+    mode: "rosbridge";
+    rosbridge?: {
+        url?: string;
+    };
+} | {
+    mode: "local";
+    local?: {
+        domainId?: number;
+    };
+} | {
+    mode: "webrtc";
+    webrtc?: {
+        signalingUrl?: string;
+    };
+};
+/**
+ * Parse a `--transport=<shorthand>` value. Throws with an actionable
+ * message on malformed input. The returned object is a plain JSON
+ * structure that the core `RobotTransportOverrideSchema` will then
+ * validate at config-load time, so this parser doesn't have to repeat
+ * field-level validation — it only needs to produce well-shaped JSON.
+ */
+export declare function parseTransportShorthand(raw: string): TransportOverrideJson;
+/**
+ * Validate a raw JSON string passed via `--transport-json`. Returns the
+ * parsed object on success; throws a friendly error on parse failure or
+ * when the JSON doesn't look at all like a transport override (missing
+ * `mode`). Field-level validation is deferred to the core Zod schema at
+ * config-load time — this is just a smoke check so an obviously-wrong
+ * JSON string doesn't slip into the file.
+ */
+export declare function parseTransportJson(raw: string): Record<string, unknown>;
+//# sourceMappingURL=transport-shorthand.d.ts.map

package/dist/util/transport-shorthand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-shorthand.d.ts","sourceRoot":"","sources":["../../src/util/transport-shorthand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAS3D;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CA2C1E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBvE"}

package/dist/util/transport-shorthand.js

@@ -0,0 +1,102 @@
+/**
+ * Parse a `--transport=<shorthand>` flag into the JSON-shaped object the
+ * core resolver expects under `config.robots[i].transport`.
+ *
+ * Shorthand grammar (most-common-case-first):
+ *
+ *     <mode>[:<primary-value>]
+ *
+ *   - `zenoh`                              ⇒ inherit everything from global config.zenoh
+ *   - `zenoh:<routerEndpoint>`             ⇒ override the router endpoint only
+ *   - `rosbridge`                          ⇒ inherit global rosbridge config
+ *   - `rosbridge:<url>`                    ⇒ override rosbridge url
+ *   - `local`                              ⇒ inherit global local config
+ *   - `local:<domainId>`                   ⇒ override DDS domain id (integer ≥ 0)
+ *   - `webrtc`                             ⇒ inherit global webrtc config
+ *   - `webrtc:<signalingUrl>`              ⇒ override signaling url
+ *
+ * Anything more elaborate (multiple sub-fields, custom iceServers, etc.)
+ * should use `--transport-json=...` which is passed straight through to
+ * the core Zod schema. The CLI deliberately doesn't model the full set
+ * of sub-fields — that would couple this layer to every transport
+ * adapter's settings shape. The shorthand exists for the 95% of users
+ * who only want to point one robot at a different router.
+ *
+ * Errors are intentionally specific — they tell the user the exact
+ * accepted forms so they can recover without hunting through docs.
+ */
+const VALID_MODES = ["zenoh", "rosbridge", "local", "webrtc"];
+function isValidMode(s) {
+    return VALID_MODES.includes(s);
+}
+/**
+ * Parse a `--transport=<shorthand>` value. Throws with an actionable
+ * message on malformed input. The returned object is a plain JSON
+ * structure that the core `RobotTransportOverrideSchema` will then
+ * validate at config-load time, so this parser doesn't have to repeat
+ * field-level validation — it only needs to produce well-shaped JSON.
+ */
+export function parseTransportShorthand(raw) {
+    const input = raw.trim();
+    if (!input) {
+        throw new Error("--transport requires a value. Examples: --transport=zenoh, --transport=zenoh:ws://farm:10000, --transport=local:1");
+    }
+    const colon = input.indexOf(":");
+    const modeRaw = (colon < 0 ? input : input.slice(0, colon)).trim().toLowerCase();
+    const valueRaw = colon < 0 ? "" : input.slice(colon + 1).trim();
+    if (!isValidMode(modeRaw)) {
+        throw new Error(`Unknown transport mode "${modeRaw}". Accepted: ${VALID_MODES.join(", ")}. ` +
+            "Example: --transport=zenoh:ws://farm:10000");
+    }
+    switch (modeRaw) {
+        case "zenoh":
+            return valueRaw
+                ? { mode: "zenoh", zenoh: { routerEndpoint: valueRaw } }
+                : { mode: "zenoh" };
+        case "rosbridge":
+            return valueRaw
+                ? { mode: "rosbridge", rosbridge: { url: valueRaw } }
+                : { mode: "rosbridge" };
+        case "local": {
+            if (!valueRaw)
+                return { mode: "local" };
+            const n = Number(valueRaw);
+            if (!Number.isInteger(n) || n < 0) {
+                throw new Error(`--transport=local:<domainId> requires a non-negative integer (got "${valueRaw}"). ` +
+                    "Example: --transport=local:1");
+            }
+            return { mode: "local", local: { domainId: n } };
+        }
+        case "webrtc":
+            return valueRaw
+                ? { mode: "webrtc", webrtc: { signalingUrl: valueRaw } }
+                : { mode: "webrtc" };
+    }
+}
+/**
+ * Validate a raw JSON string passed via `--transport-json`. Returns the
+ * parsed object on success; throws a friendly error on parse failure or
+ * when the JSON doesn't look at all like a transport override (missing
+ * `mode`). Field-level validation is deferred to the core Zod schema at
+ * config-load time — this is just a smoke check so an obviously-wrong
+ * JSON string doesn't slip into the file.
+ */
+export function parseTransportJson(raw) {
+    let obj;
+    try {
+        obj = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`--transport-json: invalid JSON (${e instanceof Error ? e.message : String(e)}). ` +
+            'Example: --transport-json=\'{"mode":"zenoh","zenoh":{"routerEndpoint":"ws://farm:10000"}}\'');
+    }
+    if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
+        throw new Error("--transport-json: must be a JSON object, e.g. {\"mode\":\"zenoh\"}");
+    }
+    const mode = obj["mode"];
+    if (typeof mode !== "string" || !isValidMode(mode)) {
+        throw new Error(`--transport-json: missing or invalid "mode" (expected one of ${VALID_MODES.join(", ")}).`);
+    }
+    return obj;
+}
+//# sourceMappingURL=transport-shorthand.js.map

package/dist/util/transport-shorthand.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenticros",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "type": "module",
   "description": "AgenticROS - agentic AI for ROS-powered robots. Single CLI to launch real-robot or simulated demos, manage configuration, and inspect status.",
   "keywords": [
@@ -53,6 +53,7 @@
   "scripts": {
     "build": "tsc",
     "typecheck": "tsc --noEmit",
+    "test": "node --test --test-force-exit \"dist/__tests__/*.test.js\"",
     "clean": "rm -rf dist runtime tsconfig.tsbuildinfo",
     "pack:runtime": "node ../../scripts/pack-runtime.mjs",
     "size:check": "node ../../scripts/check-cli-tarball-size.mjs",

package/runtime/BUNDLE.json

@@ -1,5 +1,5 @@
 {
-  "packedAt": "2026-06-09T22:12:21.081Z",
+  "packedAt": "2026-06-10T22:14:39.896Z",
   "repo": "https://github.com/PlaiPin/agenticros",
   "note": "This directory is a snapshot of the agenticros monorepo source. `agenticros init` will copy it to ~/agenticros and run pnpm install + colcon build there.",
   "layout": {

package/runtime/README.md

@@ -384,6 +384,10 @@ Per-skill behaviour lives under `config.skills.<skillId>` (e.g. `config.skills.f
 
 A skill is a Node package with `"agenticrosSkill": true` in `package.json` and a `registerSkill(api, config, context)` export from `main`. See **[docs/skills.md](docs/skills.md)** for the full contract and **[agenticros-skill-followme](https://github.com/your-org/agenticros-skill-followme)** as a reference template.
 
+## Strategy & vision
+
+Where AgenticROS is going next — the four-phase roadmap covering capability registry + skill chaining + multi-robot fleet discovery, the `skills.agenticros.com` marketplace with declarative auto-fetch, spatial memory, and cross-vendor agent collaboration via ACP / A2A: **[docs/strategy-ai-agents-plus-ros.md](docs/strategy-ai-agents-plus-ros.md)**.
+
 ## License
 
 Apache-2.0

package/runtime/package.json

@@ -9,9 +9,14 @@
     "clean": "pnpm -r exec rm -rf dist tsconfig.tsbuildinfo",
     "lint": "pnpm -r lint",
     "typecheck": "pnpm -r typecheck",
+    "test": "pnpm test:scripts && pnpm -r --workspace-concurrency 1 --if-present test",
+    "test:scripts": "node --test scripts/__tests__/*.test.mjs",
     "mcp:kill": "pkill -f 'node packages/agenticros-claude-code/dist/index.js' || true",
     "sync-skill-tools": "node scripts/sync-skill-tools.mjs",
-    "sync-skill-tools:dry": "node scripts/sync-skill-tools.mjs --dry-run --verbose"
+    "sync-skill-tools:dry": "node scripts/sync-skill-tools.mjs --dry-run --verbose",
+    "refresh:skills": "node scripts/refresh-skill-deps.mjs",
+    "refresh:skills:dry": "node scripts/refresh-skill-deps.mjs --dry-run --verbose",
+    "deploy:plugin": "bash scripts/setup_gateway_plugin.sh --skip-build --no-systemd --no-restart"
   },
   "engines": {
     "node": ">=20.0.0",

package/runtime/packages/agenticros/openclaw.plugin.json

@@ -15,6 +15,12 @@
       "ros2_param_get",
       "ros2_param_set",
       "ros2_list_topics",
+      "ros2_list_capabilities",
+      "ros2_list_robots",
+      "ros2_discover_robots",
+      "ros2_find_robots_for",
+      "run_mission",
+      "mission_cancel",
       "ros2_camera_snapshot",
       "ros2_depth_distance",
       "memory_remember",

package/runtime/packages/agenticros/package.json

@@ -14,7 +14,8 @@
   },
   "scripts": {
     "build": "tsc",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "node --test --test-force-exit \"dist/__tests__/*.test.js\""
   },
   "openclaw": {
     "extensions": [